From Fedora Project Wiki
No edit summary |
No edit summary |
||
| Line 4: | Line 4: | ||
From this numbers there could be generated some recommendations like: all binaries in ... directories should have man page. | From this numbers there could be generated some recommendations like: all binaries in ... directories should have man page. | ||
Statistic about man-pages (generated from fc12 installation DVD content - 2400 rpms ) : | Statistic about man-pages (generated from '''fc12''' installation DVD content - 2400 rpms ) : | ||
{| | {| | ||
!directory !! number of binaries !! number of missing man-pages !! percentage of missing man pages | !directory !! number of binaries !! number of missing man-pages !! percentage of missing man pages | ||
| Line 15: | Line 15: | ||
|- | |- | ||
| /usr/bin || 2814 || 1270 || 45% | | /usr/bin || 2814 || 1270 || 45% | ||
|} | |||
Statistic about man-pages (generated from '''fc11''' installation DVD content - 2252 rpms ) : | |||
{| | |||
!directory !! number of binaries !! number of missing man-pages !! percentage of missing man pages | |||
|- | |||
| /bin || 108 || 14 || 13% | |||
|- | |||
| /sbin || || || % | |||
|- | |||
| /usr/sbin || || || % | |||
|- | |||
| /usr/bin || || || % | |||
|} | |} | ||
Revision as of 10:22, 19 November 2009
I'm man-pages and man package maintainer and I want to start to somehow add some rules to man-pages to package guildelines (they are the most common documentation so it could be nice to have some rules for them too).
- At first I want to find out the number of binaries from directories /bin, /sbin, /usr/sbin and /usr/bin which have no man-page.
From this numbers there could be generated some recommendations like: all binaries in ... directories should have man page.
Statistic about man-pages (generated from fc12 installation DVD content - 2400 rpms ) :
| directory | number of binaries | number of missing man-pages | percentage of missing man pages |
|---|---|---|---|
| /bin | 110 | 12 | 11% |
| /sbin | 326 | 50 | 15% |
| /usr/sbin | 431 | 125 | 29% |
| /usr/bin | 2814 | 1270 | 45% |
Statistic about man-pages (generated from fc11 installation DVD content - 2252 rpms ) :
| directory | number of binaries | number of missing man-pages | percentage of missing man pages |
|---|---|---|---|
| /bin | 108 | 14 | 13% |
| /sbin | % | ||
| /usr/sbin | % | ||
| /usr/bin | % |
- for me /bin and /sbin are good candidates for directories in which the binaries and scripts should have man page.
- there could be done some other activities - add test for missing man-pages to rpmlint, add there some tool which will check options man-page declare and options which the tool accept or some spellchecker. There could be also do a test which check whether the man-pages are in good path.
Links: https://fedoraproject.org/wiki/MAN_pages_which_exists_in_other_places(draft)