Re: All caps .TH page title

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

 



Hi,

On 7/22/22 12:35, Alejandro Colomar (man-pages) wrote:
BTW, I think I didn't reply (or if I did was very short) to your comment that other languages may find it difficult to mirror our use of subsections, since their main section is already a subsection (e.g., 3pl).  I'd say that since C is the native Unix language, and others are just... others?, I'd optimize for C, and let other languages find a way to document their things.  It would be easy to say just go away, the man pages are for C, but I won't dare to say that, since I like man pages, and I'd like to see more documentation for languages that I sometimes have to use be in the form of man pages, so I'll try to come up with a more imaginative answer:  how about using subsubsections of the form 3pl_type?  At least it's a possibility.  man(1) would handle them as any other subsection, but that's not a big problem.  Maybe man(1) could develop a way to provide subsubsections...  Colin, any ideas in this regard?

Or, maybe it's the time to write a whole new volume? I think there's a comparable difference between 3type and 3 than between 2 and 3 or 1 and 8, so it would be merited. I didn't do it before for two reasons: it might break software that assumes than Unix manuals use a single number followed by an optional string (I'd say it's not a fair assumption to say that man9 would be the last one ever used; if there's 9, there might be a 10 some day), and because other projects had already used 3type.

But, that would start a clean namespace.  Maybe it's worth it.

How would you feel if I inaugurate man10 for types, and later man11 for non-function-like macros? :D


Cheers,

Alex

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

Attachment: OpenPGP_signature
Description: OpenPGP digital signature


[Index of Archives]     [Kernel Documentation]     [Netdev]     [Linux Ethernet Bridging]     [Linux Wireless]     [Kernel Newbies]     [Security]     [Linux for Hams]     [Netfilter]     [Bugtraq]     [Yosemite News]     [MIPS Linux]     [ARM Linux]     [Linux RAID]     [Linux Admin]     [Samba]

  Powered by Linux