Date: Thu, 4 Mar 2021 13:38:47 +0100 From: Daniel Ebdrup Jensen <debdrup@FreeBSD.org> To: freebsd-doc@freebsd.org Subject: Re: Find architecture specific man pages in man.cgi Message-ID: <20210304123847.ztqr2xf3uqkcc5k5@nerd-thinkpad.local> In-Reply-To: <CAMWY7CAKoV3LodPXpR5xn7yhC_1BaHgy0tz_iKQb-paxu2yPhw@mail.gmail.com> References: <CAGwOe2a9KSqzL6CdbWx8%2B6pfHekVpkZOHcSGJVi-iszaPPXfXw@mail.gmail.com> <CAMWY7CAKoV3LodPXpR5xn7yhC_1BaHgy0tz_iKQb-paxu2yPhw@mail.gmail.com>
next in thread | previous in thread | raw e-mail | index | archive | help
--6dsyjmmxewlmurm6 Content-Type: text/plain; charset=iso-8859-1; format=flowed Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Wed, Mar 03, 2021 at 05:52:44PM +0100, Wolfram Schneider wrote: >On Wed, 3 Mar 2021 at 16:04, Fernando Apestegu=EDa <fernape@freebsd.org> w= rote: >> >> Hi all, >> >> I'm trying to access the pae(4) man page from the man.cgi interface at >> https://www.freebsd.org/cgi/man.cgi. Looking just for "pae" with the >> default search does not show any results: >> >> https://www.freebsd.org/cgi/man.cgi?query=3Dpae&apropos=3D0&sektion=3D0&= manpath=3DFreeBSD+12.2-RELEASE+and+Ports&arch=3Ddefault&format=3Dhtml >> >> The Architecture drop list only shows "All architectures". pae(4) is i386 >> specific (src/share/man/man4/man4.i386/pae.4) and I understand it should= be >> shown somehow. >> >> After tinkering with the combos, I got this URL for a query and I noticed >> the arch=3Ddefault parameter. I changed that to arch=3Di386 but still I = can not >> get it to show the page. >> >> https://www.freebsd.org/cgi/man.cgi?query=3Dpae&apropos=3D0&sektion=3D4&; >> manpath=3DFreeBSD+12.2-RELEASE+and+Ports&arch=3Ddefault&format=3Dhtml >> >> Similar problems occur with other architecture specific man pages like >> imx_wdog(4) for arm. >> >> What am I missing? > >Hi Fernando, > >The FreeBSD man pages are based on the released packages, e.g. >http://ftp.freebsd.org/pub/FreeBSD/releases/amd64/12.2-RELEASE/ > >We are using amd64 because this is the main platform today (tier1). > >Unfortunately, the packages contain only the man pages for the given >architecture. This wasn't always the case, up to FreeBSD 9.3 we >delivered all man pages for all architectures. > >you can read the old pae(4) man page here: >https://www.freebsd.org/cgi/man.cgi?query=3Dpae&manpath=3DFreeBSD+9.3-RELE= ASE&arch=3Di386 > >I don't know why we made this change to our build system, and if this >was intentionally. I think it is a mistake. I want to read i386 man >pages on an amd64 machine. > >-Wolfram > >--=20 >Wolfram Schneider <wosch@FreeBSD.org> https://wolfram.schneider.org > Hi folks, I'm hoping this is one of the things we'll be able to address, when we move from having man.freebsd.org transition from man.cgi over to using mandoc -Thtml. There are also a bunch of minor nits where man.cgi does not behave like mandoc (I was hoping the user who mentioned it would file a bug, but I don't think this has happened yet), and mandoc also renders html anchors for Sh macros (man.cgi does this too), as well as Ss macros, Fl macros, and many others, which make it possible to deep link to individual options on the website. The transistion from man.cgi to mandoc -Thtml isn't really started yet, as it's part of a bigger project to rewamp the project website (don't know about the visuals) - a lot of it is back-end stuff in order to improve URIs to make them easier for us humans to remember. Once everything is in place, I believe the plan is to move from HTTP 302 redirectino to HTTP 301, so that every search engine and web crawler will pick up on the changed URIs. Part of the issue is that FreeBSDs manual page archive takes up over 10GB when compressed, so working with it in any aspect isn't necessarily easy. ;) Yours, Daniel Ebdrup Jensen --6dsyjmmxewlmurm6 Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iQGTBAABCgB9FiEEDonNJPbg/JLIMoS6Ps5hSHzN87oFAmBA1NdfFIAAAAAALgAo aXNzdWVyLWZwckBub3RhdGlvbnMub3BlbnBncC5maWZ0aGhvcnNlbWFuLm5ldDBF ODlDRDI0RjZFMEZDOTJDODMyODRCQTNFQ0U2MTQ4N0NDREYzQkEACgkQPs5hSHzN 87rqgwf+KeVmDWrZ6PlLdGULCncOyaRzotYyjyXEUxxc04XEDsiH5p/aDB3GFELZ dl/nScKrtGr/EFzsCETMFqXDFmRz8+qdzq4AzJrIQP0q0EX8y8rtRPGaVGs+S9eR AltDYF+hPOpfkM7wkwnNrFlIbxn/RMh8aai6t1qh4WZC35R/Q9JbPvn0vDZSuABv g2ChuJwIRvqjDMPdOkSKz6BGqXrL23PTUluL8YjmkrXFaSf8y5hZioZDPt4p8bI/ pQbtG6Dd5t0nuCUSJdf8P95D3Hh/0/R80BkukCU6i5HdwUdWWmIdZZI58k/xFYvK y8jv22JpLoeJ9edU1s+X+MVXoA4t7A== =PdTN -----END PGP SIGNATURE----- --6dsyjmmxewlmurm6--
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20210304123847.ztqr2xf3uqkcc5k5>