[PATCH] manpages for everything

2008-02-08 Thread Robert Millan
Hey, I just wrote manpages for everything! Well, actually I wrote this patch that makes our build system probe for help2man, and use it to generate a manpage automatically for each utility. :-) They can be a good substitute for the info manual we don't have yet, or (in the future) a complement t

Re: [PATCH] manpages for everything

2008-02-08 Thread Robert Millan
On Fri, Feb 08, 2008 at 10:29:00PM +0100, Robert Millan wrote: > + $(HELP2MAN) --no-info $(builddir)/$$file > > $(DESTDIR)$(mandir)/$$dest.1; \ I think I missed --section here. Possibly other options as well. --source=FSF ? -- Robert Millan I know my rights; I want my phone call! What

Re: [PATCH] manpages for everything

2008-02-08 Thread Jordi Mallach
On Sat, Feb 09, 2008 at 01:17:16AM +0100, Robert Millan wrote: > I think I missed --section here. Possibly other options as well. > --source=FSF ? Yes. For reference, I use this for GNU mailutils. #!/bin/sh ## mangen.sh ## Copyright (C) 2004 Free Software Foundation, Inc. ## ## GNU Mailutils i

Re: [PATCH] manpages for everything

2008-02-09 Thread Robert Millan
On Sat, Feb 09, 2008 at 04:02:06AM +0100, Jordi Mallach wrote: > desc=`$prefix/bin/$program --help | sed -n '2s/.*-- //p'` > $help2man -N -i debian/mangen.inc -s 1 -S FSF -n "$desc" > $prefix/bin/$program >$program.1 Do we need $desc/-n ? It looks like a workaround for a limitation in help2m

Re: [PATCH] manpages for everything

2008-02-09 Thread Robert Millan
On Fri, Feb 08, 2008 at 10:29:00PM +0100, Robert Millan wrote: > 2008-02-08 Robert Millan <[EMAIL PROTECTED]> > > * configure.ac: Probe for `help2man'. > * Makefile.in (builddir): New variable. > (HELP2MAN): Likewise. Set to `true' when @HELP2MAN@ doesn't provide it. >

Re: [PATCH] manpages for everything

2008-02-09 Thread Jordi Mallach
On Sat, Feb 09, 2008 at 11:30:42AM +0100, Robert Millan wrote: > > desc=`$prefix/bin/$program --help | sed -n '2s/.*-- //p'` > > $help2man -N -i debian/mangen.inc -s 1 -S FSF -n "$desc" > > $prefix/bin/$program >$program.1 > Do we need $desc/-n ? It looks like a workaround for a limitation in

Re: [PATCH] manpages for everything

2008-02-09 Thread Robert Millan
On Sat, Feb 09, 2008 at 02:16:10PM +0100, Jordi Mallach wrote: > On Sat, Feb 09, 2008 at 11:30:42AM +0100, Robert Millan wrote: > > > desc=`$prefix/bin/$program --help | sed -n '2s/.*-- //p'` > > > $help2man -N -i debian/mangen.inc -s 1 -S FSF -n "$desc" > > > $prefix/bin/$program >$program.1