From owner-freebsd-doc@freebsd.org Thu Mar 4 09:38:19 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 5A68756A070 for ; Thu, 4 Mar 2021 09:38:19 +0000 (UTC) (envelope-from fernando.apesteguia@gmail.com) Received: from mail-qt1-f181.google.com (mail-qt1-f181.google.com [209.85.160.181]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (2048 bits) client-digest SHA256) (Client CN "smtp.gmail.com", Issuer "GTS CA 1O1" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4Drm571x7Tz3CLS; Thu, 4 Mar 2021 09:38:18 +0000 (UTC) (envelope-from fernando.apesteguia@gmail.com) Received: by mail-qt1-f181.google.com with SMTP id 2so10808946qtw.1; Thu, 04 Mar 2021 01:38:18 -0800 (PST) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc; bh=gN8dy5/sdsiy+NjSvfWI4CbVmC/mptbaX/Kn3b8BPSQ=; b=PxslWbHEw9NDcrtlxxMm74zseI4mw8a+yzWXPZT5+1ivYM6FgUCAQvy74lerydW38c sn9Ex2bwIClxoZizM/VLc56kkiNysfJ9a0501+y79WeqYuvHn0YCOBCHCzhIATmQEDqU EInzaK9Ok4H4KJ75aM8hrR8I+2X093OYiUK6yz/0exSrWVXP2qB0yaZ+cBc8xYVT/b/5 2twxAeZTKP1hR2o0MAx5E0a4TDHwfIFXXDAdmDi6TmJnaSCLJaAObU6ILHc9RPEyANll A+EPmVj2lzdmjZ/2FtM5pF4zWRu0dFrYuY96257qvVrhSHxKKlChu8aIay+0sciFmjpF SKNA== X-Gm-Message-State: AOAM533LEkgr3Yw0hHQZG2FdZPaZtw0HtCPXOBozkcF5BM+L8e03d4Kp rnTLyi5qEpg96VknMh2OXMaXcWG1YE7K/g== X-Google-Smtp-Source: ABdhPJzNpDB1hnGIVdUmjK+LmIjlypJZn5FMQjh2jsgVpna83Q6VXTw0pJ6ZcFFQvpto4Wu2A3qh7w== X-Received: by 2002:ac8:6988:: with SMTP id o8mr3223863qtq.24.1614850698124; Thu, 04 Mar 2021 01:38:18 -0800 (PST) Received: from mail-yb1-f174.google.com (mail-yb1-f174.google.com. [209.85.219.174]) by smtp.gmail.com with ESMTPSA id q186sm19164780qka.56.2021.03.04.01.38.17 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Thu, 04 Mar 2021 01:38:17 -0800 (PST) Received: by mail-yb1-f174.google.com with SMTP id d9so27827102ybq.1; Thu, 04 Mar 2021 01:38:17 -0800 (PST) X-Received: by 2002:a5b:147:: with SMTP id c7mr5309226ybp.332.1614850697551; Thu, 04 Mar 2021 01:38:17 -0800 (PST) MIME-Version: 1.0 References: In-Reply-To: From: =?UTF-8?Q?Fernando_Apestegu=C3=ADa?= Date: Thu, 4 Mar 2021 10:35:12 +0100 X-Gmail-Original-Message-ID: Message-ID: Subject: Re: Find architecture specific man pages in man.cgi To: Wolfram Schneider Cc: freebsd-doc@freebsd.org X-Rspamd-Queue-Id: 4Drm571x7Tz3CLS X-Spamd-Bar: ---- Authentication-Results: mx1.freebsd.org; none X-Spamd-Result: default: False [-4.00 / 15.00]; REPLY(-4.00)[]; TAGGED_FROM(0.00)[] Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable X-Content-Filtered-By: Mailman/MimeDel 2.1.34 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 09:38:19 -0000 On Wed, Mar 3, 2021 at 5:52 PM Wolfram Schneider wrote: > On Wed, 3 Mar 2021 at 16:04, Fernando Apestegu=C3=ADa > wrote: > > > > 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&m= anpath=3DFreeBSD+12.2-RELEASE+and+Ports&arch=3Ddefault&format=3Dhtml > > > > The Architecture drop list only shows "All architectures". pae(4) is i3= 86 > > specific (src/share/man/man4/man4.i386/pae.4) and I understand it shoul= d > be > > shown somehow. > > > > After tinkering with the combos, I got this URL for a query and I notic= ed > > 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-REL= EASE&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. > Hi Wolfram, Thank you for looking into this. I was having a look at this PR: https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=3D212290 While that specific PR refers to 10.3 that is not a supported release, I found that we still reference pae(4) in the hardware notes for currently supported releases: https://www.freebsd.org/releases/11.4R/hardware/#proc-i386 https://www.freebsd.org/releases/12.2R/hardware/ All those pages will have a broken link to pae(4) via our main.cgi interface. I suspect that the hardware notes for 13.0-RELEASE will suffer the same problem. It seems to me that at least for the man.cgi interface we should have all the man pages available. In -CURRENT, building manpages with: make MAN_ARCH=3Dall install generates a 24 Mb /usr/share/man directory. Exactly the same as if I build only for amd64, so the difference in disk space is negligible: $ du -ch /usr/share/man/ [snip] ... 24M /usr/share/man/ 24M total In addition, man pages like hptnr.4 which are installed in a am64 installation reference a non-existent pae(4) man page. Cheers. > > -Wolfram > > -- > Wolfram Schneider https://wolfram.schneider.org >