Re: [PATCH] manpages for everything

[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 is free software; you can redistribute it and/or
## modify it under the terms of the GNU General Public License as
## published by the Free Software Foundation; either version 2, or (at
## your option) any later version.
##
## This program is distributed in the hope that it will be useful, but
## WITHOUT ANY WARRANTY; without even the implied warranty of
## MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
## General Public License for more details.
##
## You should have received a copy of the GNU General Public License
## along with this program; if not, write to the Free Software
## Foundation, Inc. 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
##
## All mail utilities must be already installed!
## Requires `help2man'. Assume standard `/usr/local' by default.

set -e

if test -z "$1"; then
  prefix="/usr/local"
else
  prefix=$1
fi

export LD_LIBRARY_PATH="$prefix/lib"

help2man="help2man"

bin1="dotlock.mailutils frm.mailutils from.mailutils guimb mail 
mailutils-config messages.mailutils mimeview movemail.mailutils popauth 
readmsg.mailutils sieve"
sbin8="comsatd imap4d pop3d"
libexec8="mail.local mail.remote"

for program in $bin1; do
  echo "Creating $program.1..."
  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
done

for program in $sbin8; do
  desc=`$prefix/sbin/$program --help | sed -n '2s/.*-- //p'`
  echo "Creating $program.8..."
  $help2man -N -i debian/mangen.inc -s 8 -S FSF -n "$desc" 
$prefix/sbin/$program >$program.8
done

for program in $libexec8; do
  desc=`$prefix/lib/mailutils/$program --help | sed -n '2s/.*-- //p'`
  echo "Creating $program.8..."
  $help2man -N -i debian/mangen.inc -s 8mailutils -S FSF -n "$desc" 
$prefix/lib/mailutils/$program >$program.8
done

exit 0

mangen.inc just includes the following, which doesn't apply to GRUB2:

[see also]
The complete GNU mailutils manual is not available in Debian systems
due to licensing reasons. You can find this manual online in the
GNU mailutils webpage:
.br
http://www.gnu.org/software/mailutils/manual/index.html.

Jordi
-- 
Jordi Mallach Pérez  --  Debian developer     http://www.debian.org/
address@hidden     address@hidden     http://www.sindominio.net/
GnuPG public key information available at http://oskuro.net/