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

Re: manpage for GNU utilities?



Hi,
>>"Oliver" == Oliver Elphick <olly@lfix.co.uk> writes:

Oliver> The first candidate for writing manpages should be the
Oliver> maintainer. Perhaps Christian could produce a list of the
Oliver> packages that need updated manpages so that the maintainer can
Oliver> say whether or not he can do them for 2.0 and so that other
Oliver> people can claim them if the maintainer hasn't the time.

	Would anyone other than Christian do? Here is a list of man
 pages, generated by
	% find /usr/man -type f | xargs zgrep Texinfo /dev/null
 and manually deleting the handful of false hits. This was then
 further parsed as:
	%   (for i in  chroot cp dd mv df mknod rm rmdir touch du
 	               ln chgrp chmod chown dircolors install ls mkdir
	               mkfifo false tty users who nice yes printf pwd
	               sleep stty test true tee date echo env expr
	               groups id basename dirname logname nohup
	               pathchk printenv uname whoami nl tr cat
	               unexpand uniq wc pr split sum tac tail comm
	               csplit cut expand fmt fold join cksum head od
	               paste sort gnu-su a2ps dvips octave scm; do
                  export PATH='/bin:/sbin:/usr/bin:/usr/sbin:/usr/X11R6/bin';
	          j=$(type -p $i); 
                  if [ "X$j" != "X" ] ; then 
                      dpkg -S $j;
	          fi; 
            done) | sort | tee package_list 

	The resulting list is appended below. Please not the small
 number of packages here
	% cat package_list | sed 's/:.*$//' | uniq -c | sort -n
      1 a2ps
      1 octave
      1 scm
      1 tetex-bin
     15 fileutils
     23 shellutils
     23 textutils

	I would hate to be the maintainer of the packages fileutils,
 shellutils, and textutils (Galen Hazelwood <galenh@micron.net>), who
 has a whopping 61 man pages to write. 

	manoj

 The list of binaries requiring manual pages to be rewritten are:
a2ps: /usr/bin/a2ps
fileutils: /bin/chgrp
fileutils: /bin/chmod
fileutils: /bin/chown
fileutils: /bin/dd
fileutils: /bin/df
fileutils: /bin/ln
fileutils: /bin/ls
fileutils: /bin/mkdir
fileutils: /bin/mknod
fileutils: /bin/rmdir
fileutils: /usr/bin/dircolors
fileutils: /usr/bin/du
fileutils: /usr/bin/install
fileutils: /usr/bin/mkfifo
fileutils: /usr/bin/touch
octave: /usr/bin/octave
scm: /usr/bin/scm
shellutils: /bin/date
shellutils: /bin/sleep
shellutils: /bin/stty
shellutils: /bin/uname
shellutils: /usr/bin/basename
shellutils: /usr/bin/dirname
shellutils: /usr/bin/env
shellutils: /usr/bin/expr
shellutils: /usr/bin/groups
shellutils: /usr/bin/id
shellutils: /usr/bin/logname
shellutils: /usr/bin/nice
shellutils: /usr/bin/nohup
shellutils: /usr/bin/pathchk
shellutils: /usr/bin/printenv
shellutils: /usr/bin/printf
shellutils: /usr/bin/tee
shellutils: /usr/bin/tty
shellutils: /usr/bin/users
shellutils: /usr/bin/who
shellutils: /usr/bin/whoami
shellutils: /usr/bin/yes
shellutils: /usr/sbin/chroot
tetex-bin: /usr/bin/dvips
textutils: /bin/cat
textutils: /usr/bin/cksum
textutils: /usr/bin/comm
textutils: /usr/bin/csplit
textutils: /usr/bin/cut
textutils: /usr/bin/expand
textutils: /usr/bin/fmt
textutils: /usr/bin/fold
textutils: /usr/bin/head
textutils: /usr/bin/join
textutils: /usr/bin/nl
textutils: /usr/bin/od
textutils: /usr/bin/paste
textutils: /usr/bin/pr
textutils: /usr/bin/sort
textutils: /usr/bin/split
textutils: /usr/bin/sum
textutils: /usr/bin/tac
textutils: /usr/bin/tail
textutils: /usr/bin/tr
textutils: /usr/bin/unexpand
textutils: /usr/bin/uniq
textutils: /usr/bin/wc

-- 
 Good is good behaviour up to old age, good is firmly established
 faith, good is the acquisition of understanding, and abstention from
 evil is good. 333
Manoj Srivastava  <srivasta@acm.org> <http://www.datasync.com/%7Esrivasta/>
Key C7261095 fingerprint = CB D9 F4 12 68 07 E4 05  CC 2D 27 12 1D F5 E8 6E


Reply to: