From owner-freebsd-questions@freebsd.org Fri Oct 2 03:55:37 2020 Return-Path: Delivered-To: freebsd-questions@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id AA1423F4D90 for ; Fri, 2 Oct 2020 03:55:37 +0000 (UTC) (envelope-from carlj@peak.org) Received: from smtp.email-protect.gosecure.net (smtp.email-protect.gosecure.net [208.80.203.3]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-SHA384 (256/256 bits)) (Client CN "*.email-protect.gosecure.net", Issuer "Thawte RSA CA 2018" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4C2bkJ40dtz45lM for ; Fri, 2 Oct 2020 03:55:35 +0000 (UTC) (envelope-from carlj@peak.org) Received: from envoy14.neonova.net ([137.118.58.100]) by smtp.email-protect.gosecure.net ({43ab891c-a20f-11ea-bfba-6b0f29799eed}) via TCP (outbound) with ESMTP id 20201002035526964_00001184 for ; Thu, 01 Oct 2020 20:55:26 -0700 X-RC-FROM: X-RC-RCPT: Received: from elm.localnet (unknown [199.58.99.76]) (Authenticated sender: carlj@peak.org) by envoy14.neonova.net (Postfix) with ESMTPA id 4C2bk31dhMz9tKY for ; Thu, 1 Oct 2020 23:55:22 -0400 (EDT) Received: from localhost.localnet ([127.0.0.1] helo=elm.localnet) by elm.localnet with esmtps (TLSv1.3:TLS_AES_256_GCM_SHA384:256) (Exim 4.92.3 (FreeBSD)) (envelope-from ) id 1kOCAC-000JKL-AT for freebsd-questions@freebsd.org; Thu, 01 Oct 2020 20:55:20 -0700 Received: (from carlj@localhost) by elm.localnet (8.15.2/8.15.2/Submit) id 0923tKSc074296; Thu, 1 Oct 2020 20:55:20 -0700 (PDT) (envelope-from carlj) From: Carl Johnson To: freebsd-questions@freebsd.org Subject: Re: usr/ports make readmes & description References: <20200930005948.GA82633@bastion.zyxst.net> <20200930142901.10e1bab2.freebsd@edvax.de> <20201002032115.GA3769@rpi4.zyxst.net> Date: Thu, 01 Oct 2020 20:55:19 -0700 In-Reply-To: <20201002032115.GA3769@rpi4.zyxst.net> (tech-lists@zyxst.net's message of "Fri, 2 Oct 2020 04:21:15 +0100") Message-ID: <86y2kp46zc.fsf@elm.localnet> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/26.3 (berkeley-unix) MIME-Version: 1.0 Content-Type: text/plain X-MAG-OUTBOUND: greymail.email-protect.gosecure.net@137.118.58.100/32 X-Rspamd-Queue-Id: 4C2bkJ40dtz45lM X-Spamd-Bar: --- Authentication-Results: mx1.freebsd.org; dkim=none; dmarc=pass (policy=none) header.from=peak.org; spf=pass (mx1.freebsd.org: domain of carlj@peak.org designates 208.80.203.3 as permitted sender) smtp.mailfrom=carlj@peak.org X-Spamd-Result: default: False [-3.05 / 15.00]; RCVD_VIA_SMTP_AUTH(0.00)[]; ARC_NA(0.00)[]; NEURAL_HAM_MEDIUM(-1.00)[-0.997]; FROM_HAS_DN(0.00)[]; RWL_MAILSPIKE_GOOD(0.00)[208.80.203.3:from]; TO_MATCH_ENVRCPT_ALL(0.00)[]; R_SPF_ALLOW(-0.20)[+ip4:208.80.200.0/21]; MIME_GOOD(-0.10)[text/plain]; TO_DN_NONE(0.00)[]; PREVIOUSLY_DELIVERED(0.00)[freebsd-questions@freebsd.org]; RCPT_COUNT_ONE(0.00)[1]; NEURAL_HAM_LONG(-0.96)[-0.960]; RCVD_COUNT_THREE(0.00)[4]; NEURAL_HAM_SHORT(-0.29)[-0.292]; DMARC_POLICY_ALLOW(-0.50)[peak.org,none]; FROM_EQ_ENVFROM(0.00)[]; R_DKIM_NA(0.00)[]; MIME_TRACE(0.00)[0:+]; ASN(0.00)[asn:14618, ipnet:208.80.202.0/23, country:US]; RCVD_TLS_LAST(0.00)[]; MAILMAN_DEST(0.00)[freebsd-questions] X-BeenThere: freebsd-questions@freebsd.org X-Mailman-Version: 2.1.33 Precedence: list List-Id: User questions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 02 Oct 2020 03:55:37 -0000 tech-lists writes: > On Wed, Sep 30, 2020 at 02:29:01PM +0200, Polytropon wrote: >>On Wed, 30 Sep 2020 01:59:48 +0100, tech-lists wrote: >>> Years ago one could go into /usr/ports and make readmes for every single port. >>> It'd take a while, but you'd end up with a ports tree browsable comfortably in >>> lynx. Nowadays, make readmes only works for the top level ie /usr/ports/category and >>> won't make the longer descriptions in HTML. >>> >>> How can I get the old behaviour back? >> >>According to "man 7 ports", this is still supported: >> >>readmes Create a port's README.html. This can be used from >> /usr/ports to create a browsable web of all ports on >> your system! >> >>See /usr/ports/Mk/bsd.port.subdir.mk for the target. > > Hi, this is my point. > > /usr/ports/Mk/bsd.port.subdir.mk seems to suggest that 'make readme' > builds the category (for example cd /usr/ports/archivers && make > readme) one gets a README.html with a one-line description of each port. > The port name is a link but if it's selected of course it goes nowhere. > > Now, if instead you 'make readmes', the end result is *identical* my point > is that make readmes used to (it was a long time ago but I'm sure of it > now) first make the top level readme and then go into each and every > port in that category and make the readme for all those ports. It'd take > a long while, but what you were left with is a README.html you could > click through right down to the port's long description. > > That's what it's missing. Maybe the ports tree got too big for this I > guess? The bit in that bsd.port.subdir.mk that's not getting run appears > to be this: > > [...] > readmes: readme ${SUBDIR:S/^/_/:S/$/.readmes/} > @${ECHO_MSG} "===> Creating README.html for all ports" > @perl ${PORTSDIR}/Tools/make_readmes < > ${INDEXDIR}/${INDEXFILE} > [...] > > I never see "Creating README.html for all ports" regardless of whether > i'm in /usr/ports or /usr/ports/category when I run "make readmes". Is > this a bug? I just did a 'make readmes' a few hours ago, and it ran without problems, as usual. In my case I had just done a portsnap and did that to update the README.html files. It took about 30 minutes this time using -j4. I am running 12.1-RELEASE and just do a quarterly portsnap to roughly match the quarterly pkg repository. -- Carl Johnson carlj@peak.org