From nobody Mon May 31 07:07:22 2021 X-Original-To: freebsd-hackers@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 5CBE5D7DEE2; Mon, 31 May 2021 07:07:32 +0000 (UTC) (envelope-from jmg@gold.funkthat.com) Received: from gold.funkthat.com (gate2.funkthat.com [208.87.223.18]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client CN "gate2.funkthat.com", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4FtmZW0st0z3nkD; Mon, 31 May 2021 07:07:30 +0000 (UTC) (envelope-from jmg@gold.funkthat.com) Received: from gold.funkthat.com (localhost [127.0.0.1]) by gold.funkthat.com (8.15.2/8.15.2) with ESMTPS id 14V77Mj8084681 (version=TLSv1.2 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=NO); Mon, 31 May 2021 00:07:22 -0700 (PDT) (envelope-from jmg@gold.funkthat.com) Received: (from jmg@localhost) by gold.funkthat.com (8.15.2/8.15.2/Submit) id 14V77M4m084680; Mon, 31 May 2021 00:07:22 -0700 (PDT) (envelope-from jmg) Date: Mon, 31 May 2021 00:07:22 -0700 From: John-Mark Gurney To: Fernando =?iso-8859-1?Q?Apestegu=EDa?= Cc: Ian Lepore , FreeBSD Hackers , freebsd-arch@FreeBSD.org Subject: Re: Inclusion of all manual pages in all architecture releases Message-ID: <20210531070722.GR14975@funkthat.com> Mail-Followup-To: Fernando =?iso-8859-1?Q?Apestegu=EDa?= , Ian Lepore , FreeBSD Hackers , freebsd-arch@FreeBSD.org References: List-Id: Technical discussions relating to FreeBSD List-Archive: https://lists.freebsd.org/archives/freebsd-hackers List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-freebsd-hackers@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=iso-8859-1 Content-Disposition: inline Content-Transfer-Encoding: 8bit In-Reply-To: X-Operating-System: FreeBSD 11.3-STABLE amd64 X-PGP-Fingerprint: D87A 235F FB71 1F3F 55B7 ED9B D5FF 5A51 C0AC 3D65 X-Files: The truth is out there X-URL: https://www.funkthat.com/ X-Resume: https://www.funkthat.com/~jmg/resume.html X-TipJar: bitcoin:13Qmb6AeTgQecazTWph4XasEsP7nGRbAPE X-to-the-FBI-CIA-and-NSA: HI! HOW YA DOIN? can i haz chizburger? User-Agent: Mutt/1.6.1 (2016-04-27) X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.4.3 (gold.funkthat.com [127.0.0.1]); Mon, 31 May 2021 00:07:22 -0700 (PDT) X-Rspamd-Queue-Id: 4FtmZW0st0z3nkD X-Spamd-Bar: - Authentication-Results: mx1.freebsd.org; dkim=none; dmarc=none; spf=none (mx1.freebsd.org: domain of jmg@gold.funkthat.com has no SPF policy when checking 208.87.223.18) smtp.mailfrom=jmg@gold.funkthat.com X-Spamd-Result: default: False [-1.65 / 15.00]; RCVD_TLS_ALL(0.00)[]; ARC_NA(0.00)[]; FREEFALL_USER(0.00)[jmg]; FROM_HAS_DN(0.00)[]; RCPT_COUNT_THREE(0.00)[4]; TO_DN_SOME(0.00)[]; TO_MATCH_ENVRCPT_ALL(0.00)[]; MIME_GOOD(-0.10)[text/plain]; DMARC_NA(0.00)[funkthat.com]; RBL_DBL_DONT_QUERY_IPS(0.00)[208.87.223.18:from]; AUTH_NA(1.00)[]; MID_RHS_MATCH_FROM(0.00)[]; SPAMHAUS_ZRD(0.00)[208.87.223.18:from:127.0.2.255]; NEURAL_HAM_MEDIUM(-1.00)[-1.000]; NEURAL_HAM_LONG(-1.00)[-1.000]; NEURAL_HAM_SHORT(-0.85)[-0.847]; R_SPF_NA(0.00)[no SPF record]; FORGED_SENDER(0.30)[jmg@funkthat.com,jmg@gold.funkthat.com]; R_DKIM_NA(0.00)[]; MIME_TRACE(0.00)[0:+]; ASN(0.00)[asn:32354, ipnet:208.87.216.0/21, country:US]; FROM_NEQ_ENVFROM(0.00)[jmg@funkthat.com,jmg@gold.funkthat.com]; MAILMAN_DEST(0.00)[freebsd-hackers,freebsd-arch]; RCVD_COUNT_TWO(0.00)[2] X-ThisMailContainsUnwantedMimeParts: N Fernando Apestegua wrote this message on Thu, May 27, 2021 at 08:40 +0200: > On Wed, May 26, 2021 at 5:23 PM Ian Lepore wrote: > > > > On Wed, 2021-05-26 at 17:04 +0200, Fernando Apesteguía wrote: > > > I don't know what list this should be sent to, apologies if the > > > audience is too wide. > > > > > > For some time now, we have not included all manual pages in every > > > FreeBSD packaged release. For instance, i386 man pages are not > > > included in the FreeBSD amd64 distribution. > > > > > > This causes a number of problems: > > > > > > * The https://www.freebsd.org/cgi/man.cgi is incomplete. As an > > > example, it does not show results for pae(4). The reason for this is > > > that the cgi interface runs on FreeBSD amd64. > > > > > > * In FreeBSD amd64 some manual pages have broken X-refs. See hptrr(4) > > > for an example. > > > > > > * Also, we have broken links in our Release Notes. This is a > > > consequence of the first point. See > > > https://www.freebsd.org/releases/13.0R/hardware/#proc-i386. > > > > > > Is there a specific reason for this? > > > > > > Cheers. > > > > > > > I have tried multiple times to get the people who adminster > > freebsd.org's man.cgi to include all arches. I added the ability to > > generate and install all of them by setting MAN_ARCH=all (or to a list > > of arches) on the build command line years ago. But I haven't had any > > success in getting that used to install all the arches for the website > > and man.cgi updated to make the arch selection list on the webpage > > actually work. > > Hi Ian, > > Thanks for the explanation. That would fix the man.cgi and > consequently the Release Notes issues. > However, in order to fix the broken X-refs in the manual pages of the > release distributions, wouldn't we need to build them with > MAN_ARCH=all? > According to make.conf(5), MAN_ARCH defaults to MACHINE and > MACHINE_ARCH. Would it be possible to change the default value to > "all"? > > diff --git a/share/man/man4/Makefile b/share/man/man4/Makefile > index f7626c80eeb1..583c4a4b9bb9 100644 > --- a/share/man/man4/Makefile > +++ b/share/man/man4/Makefile > @@ -897,9 +897,7 @@ _cgem.4= cgem.4 > MLINKS+=cgem.4 if_cgem.4 > .endif > > -.if empty(MAN_ARCH) > -__arches= ${MACHINE} ${MACHINE_ARCH} ${MACHINE_CPUARCH} > -.elif ${MAN_ARCH} == "all" > +.if empty(MAN_ARCH) || ${MAN_ARCH} == "all" > __arches= ${:!/bin/sh -c "/bin/ls -d ${.CURDIR}/man4.*"!:E} > .else > __arches= ${MAN_ARCH} > > This way, the released distributions will have all the man pages (we > have some PRs related to this) and would also fix man.cgi regardless > of the FreeBSD version the service runs on. > > I am assuming here that we do not explicitly set MAN_ARCH to a > specific architecture when building the releases but we take the > default value. I would like to see this change made myself. It'd nice to be able to use your amd64 build box to be able to get information on other systems by default. The extra space is minimal. I have cc'd -arch to get a wider audience. -- John-Mark Gurney Voice: +1 415 225 5579 "All that I will do, has been done, All that I have, has not."