Hi,

On Wed, 2007-03-14 at 18:57 +0000, Julian Gilbey wrote:
> On Wed, Mar 14, 2007 at 11:10:18AM -0700, Josh Triplett wrote:
> > Please include Branden's missing_manpage_finder script, from his Write the
> > Fine Manual presentation.  I have attached an updated version that Branden
> > mailed me; it includes GPL headers.
[...]
> Nice idea, but it doesn't work as is.  The two major problems are:
> 
> (1) man -w /usr/bin/bashbug outputs /usr/bin/bashbug, whereas man -w
>     bashbug shows that bashbug is missing a manpage
> 
> (2) It doesn't exclude /usr/bin/X11, which is a symlink to /usr/bin.
> 
> Attached is a better version which fixes these problems, displays the
> missing manual pages and doesn't keep telling the user to look at 'man
> 7 undocumented'.

I wondered if anyone would beat me to it ;-) Josh mentioned on irc
earlier today that he was planning on submitting the script, so I'd been
having a look at it also.

I've attached my current revision of the script, which
steals^Wincorporates some of the changes from your revision. My version
adds a dependency on find, although that's not a huge problem given that
findutils is Essential: yes. It also has the advantages (imho) of only
checking executable files in the given paths and avoiding the need to
special-case /usr/bin/X11.

I was planning on committing an updated version of the attached later on
this evening or tomorrow, once I'd finished tidying it up, but I have no
wish to start a "my update's better than your update" battle ;-)

Cheers,

Adam

Attachment: manpage-alert.sh
Description: application/shellscript

Reply via email to