groff
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: Subdirs of man*/ (was: [PATCH] ascii.7: chase down History to earlie


From: Alex Colomar
Subject: Re: Subdirs of man*/ (was: [PATCH] ascii.7: chase down History to earliest) (refers: man -M tcl)
Date: Mon, 17 Oct 2022 13:17:05 +0200
User-agent: Mozilla/5.0 (X11; Linux x86_64; rv:102.0) Gecko/20100101 Thunderbird/102.3.2

On 10/17/22 13:10, Alex Colomar wrote:
[CC += groff@, since it was CCd in the old conversation referred to here]

Hi Ingo,

On 7/27/22 17:32, Ingo Schwarze wrote:
 > Alejandro Colomar wrote on Sun, Jul 24, 2022 at 06:17:40PM +0200:
 >> I wondered for a long time what happens if you create subdirs within a
>> man? section.  How do man(1)s handle </usr/share/man/man3/python/foo.3>?
 > On *BSD systems, that typically means:
 >
 >    The architecture-specific library function foo(3)
 >    for the "python" hardware architecture.
 >
 > Here are a few examples from OpenBSD:
 >
 >    /usr/share/man/man1/sparc64/mksuncd.1
 >    /usr/share/man/man2/armv7/arm_sync_icache.2
 >    /usr/share/man/man2/i386/i386_iopl.2
 >    /usr/share/man/man3/octeon/cacheflush.3
 >    /usr/share/man/man3/sgi/get_fpc_csr.3
 >    /usr/share/man/man4/alpha/irongate.4
 >    /usr/share/man/man4/amd64/mpbios.4
 >    /usr/share/man/man4/luna88k/cbus.4
 >    /usr/share/man/man4/macppc/openpic.4
 >    /usr/share/man/man4/powerpc64/opalcons.4
 >    /usr/share/man/man4/riscv64/sfgpio.4
 >    /usr/share/man/man5/sparc64/ldom.conf.5
 >    /usr/share/man/man8/hppa/boot.8
 >    /usr/share/man/man8/macppc/pdisk.8
 >    /usr/share/man/man8/sgi/sgivol.8
 >    /usr/share/man/man8/sparc64/ldomctl.8


On 10/17/22 03:22, наб wrote:
Cf., well, the UNIX Programmer's Manual:
https://www.tuhs.org/Archive/Distributions/Research/Dennis_v1/UNIX_ProgrammersManual_Nov71.pdf
PDF page 191; yes, the typographical convention here is insane, and
the contemprary-correct way to refer to this page from within the manual
would be /just/ "/etc/ascii", but, given the context, "/etc/ascii (VII)"
makes the most sense to me

I just saw this and wondered if the subdirs in the past were used as just part of the manual page name...

I have been remembering every now and then the discussion we had about a hypothetical -M, and think we need it or something like that.  I guess subdirs are not possible nowadays because of the translation usage, but
s/translation/arch/
I'm curious about if that was different in the past or what.

Does anyone know?

Cheers,

Alex


--
<http://www.alejandro-colomar.es/>

Attachment: OpenPGP_signature
Description: OpenPGP digital signature


reply via email to

[Prev in Thread] Current Thread [Next in Thread]