From owner-freebsd-doc@freebsd.org Thu Mar 4 12:38:49 2021 Return-Path: Delivered-To: freebsd-doc@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 DDFBB5482F4 for ; Thu, 4 Mar 2021 12:38:49 +0000 (UTC) (envelope-from debdrup@freebsd.org) Received: from freefall.freebsd.org (freefall.freebsd.org [96.47.72.132]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "freefall.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4Drr5P5yG8z3hPc for ; Thu, 4 Mar 2021 12:38:49 +0000 (UTC) (envelope-from debdrup@freebsd.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1614861529; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: in-reply-to:in-reply-to:references:references; bh=WK12ZSvCheM8V2f6/6Txa40I4CgfS1McaVbw9jggEmI=; b=wZyr/xKalN6QVRcJvoEkTcxcqfKeFxgRF40fcj6/pI1yqBlcssGIWVEwCBPyMaUg8Xz2F+ WIi3tR1Gdhw/IbhXcUqXRPPNfa/yg4P528+7zHdCY8dvA30N3fHw1xOFcMigedMiouom6Z uQTkJHevl6j/N/0cuyXOaLQsa/MmMYrGMT1nGAamdlkCXT9/jicaZz5PQ9+WhzMUSUmPSv D1ewh9g5sk9VprzBSETmZfMSbvV9GDVFCmczd6+QCUzDqaLH/r4olYnywspv6UJywL6Gbe /SGLp3Tcv2r5QQsDIUN/oGKc0zShqXUVxuf1Av2axg0r0G499hZ7C56cvU/uGw== Received: by freefall.freebsd.org (Postfix, from userid 1471) id BE996CBCE; Thu, 4 Mar 2021 12:38:49 +0000 (UTC) Date: Thu, 4 Mar 2021 13:38:47 +0100 From: Daniel Ebdrup Jensen To: freebsd-doc@freebsd.org Subject: Re: Find architecture specific man pages in man.cgi Message-ID: <20210304123847.ztqr2xf3uqkcc5k5@nerd-thinkpad.local> Mail-Followup-To: Daniel Ebdrup Jensen , freebsd-doc@freebsd.org References: MIME-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha512; protocol="application/pgp-signature"; boundary="6dsyjmmxewlmurm6" Content-Disposition: inline In-Reply-To: ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1614861529; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: in-reply-to:in-reply-to:references:references; bh=WK12ZSvCheM8V2f6/6Txa40I4CgfS1McaVbw9jggEmI=; b=m7vWBB66AjmEtZNEi09S9Huuc4eSDDxAjfVExMulrJhRzHukMW92R79VkgvyepLeZ4tWuG 8sUsbHHnVu0fKYmLEHNdVOYYLgADCpFWZ/ZA+Q0WhxYzP3dfttGWLD4/bMBbT8cktZjjn7 QNg+uwBDD9StdA19DAtmhMmbBk1RbtJw7xltPb96JMp9tqHhQYqmRspkD1c7Yh/c87uZuF kjDmu4nmLPxTP2Cd91dMrtgVz6SvNh3cJm9vfzYaTnx9svIhcRrNHrV984nvy7C4QkAJ+T 4QFCEUp8CdVWEr0RQdM+khJyViJmOdGt40g3Fp1ImJgFRa//7RwSasxEL6JhLQ== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1614861529; a=rsa-sha256; cv=none; b=dCkw4/FSXrKTrAtH4ZIC0UiVyehZnFvBuaM3nQXb8Ng0XDb/JI+sygOcVtKB3dNojjaRSY 6C3FVFLmBquHQnbMgKH5DTZOvfMnFGm+8l5DiKYSUrpriiZvS0KJ5SRXGmE+TqpQE7W1a/ T2V5y/ZKoGTunfMVhhSiilTFTwv949Rgul3HDwq4hTTHJJPDR5fFlMX2ZsoBldvAjtPQN2 0zE/yWbL/UxPRXl+y0F0XlKd/7nEfvp25kJpfjv5itfyMUuJSDRWJzHG+DzeqRUcPoL+rr 4sZaq36nk1YedtWZ8PUiA8Vu0AKOIBEuzd58JeLEYayTGYQuUbtxbzYCpr3DWQ== ARC-Authentication-Results: i=1; mx1.freebsd.org; none X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 04 Mar 2021 12:38:49 -0000 --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 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 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--