Hello Marcos, On 1/6/23 19:35, Marcos Fouces wrote:
Hello Alejandro,Debian policy is clear on this point: manual pages should be assigned to man[1..9]/ dirs [1]. Lintian also issues error tags when this behavior is not observed [2]. The desired section expressed through the file extension and the .TH field is not modified. All .so links are corrected to point to the corresponding man page. From dh_installman(1) manual page: " ...you tell dh_installman what man pages go in your packages, and it figures out where to install them based on the section field in their .TH or .Dt line. If you have a properly formatted .TH or .Dt line, your man page will be installed into the right directory, with the right name (this includes proper handling of pages with a subsection, like 3perl, which are placed in man3, and given an extension of .3perl). If your .TH or .Dt line is incorrect or missing, the program may guess wrong based on the file extension." What is the precise drawback of this solution?
There are two (not huge drawbacks, but they exist):- mandoc(1) (and possibly other software) understands that if a page is in directory manX, it is in section X, so it will for example appear in searches of pages in that section.
- 3 is for functions and 3const is for constants, so having them separate makes it easier to list all functions and all constants in a system (or at least those that are documented in manual pages.
Greetings, Marcos
Cheers, Alex
[1] https://www.debian.org/doc/debian-policy/ch-docs.html#manual-pages [2] https://lintian.debian.org/tags/odd-place-for-manual-page
-- <http://www.alejandro-colomar.es/>
OpenPGP_signature
Description: OpenPGP digital signature
