From mboxrd@z Thu Jan 1 00:00:00 1970 X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on inbox.vuxu.org X-Spam-Level: X-Spam-Status: No, score=0.2 required=5.0 tests=DKIM_INVALID,DKIM_SIGNED autolearn=no autolearn_force=no version=3.4.4 Received: (qmail 24602 invoked from network); 30 Aug 2021 19:35:26 -0000 Received: from bsd.lv (HELO mandoc.bsd.lv) (66.111.2.12) by inbox.vuxu.org with ESMTPUTF8; 30 Aug 2021 19:35:26 -0000 Received: from fantadrom.bsd.lv (localhost [127.0.0.1]) by mandoc.bsd.lv (OpenSMTPD) with ESMTP id 3a4f4f22 for ; Mon, 30 Aug 2021 14:35:23 -0500 (EST) Received: from magnesium.8pit.net (magnesium.8pit.net [45.76.88.171]) by mandoc.bsd.lv (OpenSMTPD) with ESMTP id c762f877 for ; Mon, 30 Aug 2021 14:35:22 -0500 (EST) DKIM-Signature: v=1; a=rsa-sha256; c=simple/simple; s=opensmtpd; bh=z3V/esbV6P FVrhNaZR5cdVFDkb71vJW2zk7hynzCHUE=; h=subject:from:to:date; d=soeren-tempel.net; b=R/4FA639hp0dGYolFbtUbGRJFbZ/fgB42XaJRsvgtvqtlB5 SC2QLtp9g9FUuaKgOFR/zr6UBkQBxEvIu+QWsED1zPwI4SlcCrVv280j8bhLMAAlkhcviP VjC9G3uWrt9aiFVxkDm937rsoReBhy83A8tIl0FeRq20SJISkP1VQU= Received: from localhost (p200300f5ff0025000c819e2f41baa33e.dip0.t-ipconnect.de [2003:f5:ff00:2500:c81:9e2f:41ba:a33e]) by magnesium.8pit.net (OpenSMTPD) with ESMTPSA id c8330aa6 (TLSv1.3:AEAD-AES256-GCM-SHA384:256:YES) for ; Mon, 30 Aug 2021 21:35:18 +0200 (CEST) Date: Mon, 30 Aug 2021 21:26:59 +0200 To: tech@mandoc.bsd.lv From: =?UTF-8?Q?S=C3=B6ren?= Tempel Subject: Discrepancy in mansearch and fs_lookup behavior Message-Id: <1ZRQZL79I0W2O.3ILLDNAL4JXUP@8pit.net> X-Mailinglist: mandoc-tech Reply-To: tech@mandoc.bsd.lv MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: quoted-printable Hello! I am currently working on rearranging the Alpine Linux POSIX and Perl man pages to make them work properly without mandoc. For some historic reason, Alpine presently install these as follows: /usr/share/man/man3/open.3pm.gz /usr/share/man/man3/open.3p.gz where 3pm is the perl open man page and 3p is the POSIX open man page. With this setup `man 3p open` will always open the Perl man page and there seems to be no way to open the POSIX man page. Looking at the fs_lookup implementation I believe this to be the case because mandoc expects each section to have its own subdirectory in MANDIR. I am also aware that OpenBSD uses the 3p section for Perl man pages which is a bit confusing but probably Alpine's fault. My present understanding is that this would have to be fixed on the Alpine side by moving these man pages to their own subdirectory. Please let me know if there is an alternative solution. While experimenting with moving these pages, I noticed a discrepancy in the man page lookup behavior of mansearch and fs_lookup. Assuming the above man pages are installed as follows: /usr/share/man/man3/open.3pm.gz /usr/share/man/man3p/open.3p.gz if a mandoc.db exists, `man 3p open` will display the Perl (open.3pm.gz) man page (mansearch). If it doesn't (fs_lookup), it will display the POSIX man page (open.3p.gz). I find this surprising as I would expect the two algorithms to be equivalent. I am reporting this here as I believe this to be a "minor bug" that doesn't interest the majority of mandoc users. See also: https://gitlab.alpinelinux.org/alpine/aports/-/issues/12958 Greetings, S=C3=B6ren -- To unsubscribe send an email to tech+unsubscribe@mandoc.bsd.lv