improve generated manpages #147038 by Benno Schulenberg/TGL

17 files changed, 68 insertions, 66 deletions

diff --git a/man/mkman.sh b/man/mkman.sh
index 8a76e58..f4cda09 100755
--- a/man/mkman.sh
+++ b/man/mkman.sh
@@ -6,10 +6,12 @@ APPLETS=$(../q | grep -e ' : ' | awk '{print $1}' | grep ^q$1)
 for applet in $APPLETS; do
 	help2man -N -S "Gentoo Foundation" -m ${applet} -s 1 \
 		$(for incl in include/${applet}-*.include; do echo "-I ${incl}"; done) \
+		-n "$(../q $applet | sed -n '/^Usage/{s|^.* : ||p;q;}')" \
 		-o ${applet}.1 "../q $applet"
 	[[ $? == 0 ]] || continue;
 	sed  -i -e s/'PORTAGE-UTILS-CVS:'/${applet}/g \
 		-e s/'portage-utils-cvs:'/${applet}/g \
+		-e '/\.SH SYNOPSIS/,/\.SH/'s/' : .*\\fR$'/'\\fR'/ \
 		-e s/'> \*'/'>@\.BR@ \*'/g ${applet}.1
 	head -n $(($(cat ${applet}.1 | wc -l)-1)) ${applet}.1 \
 		| tr '@' '\n' > ${applet}.1~ && mv ${applet}.1~ ${applet}.1
diff --git a/man/q.1 b/man/q.1
index 27b6e47..098d313 100644
--- a/man/q.1
+++ b/man/q.1
@@ -1,10 +1,10 @@
-.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
-.TH q "1" "August 2006" "Gentoo Foundation" "q"
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.36.
+.TH q "1" "September 2006" "Gentoo Foundation" "q"
 .SH NAME
-q \- manual page for q 
+q \- invoke a portage utility applet
 .SH SYNOPSIS
 .B q
-\fI<applet> \fR[\fIarguments\fR]...
+\fI<applet> <args>  : invoke a portage utility applet\fR
 .SH DESCRIPTION
 .SS "Currently defined applets:"
 .IP
@@ -79,4 +79,4 @@ Options: \fB\-[irmvqChV]\fR
 \fB\-V\fR, \fB\-\-version\fR
 * Print version and exit
 .PP
-$Id: q.1,v 1.19 2006/08/21 00:11:54 solar Exp $
+$Id: q.1,v 1.20 2006/09/11 05:54:12 vapier Exp $
diff --git a/man/qatom.1 b/man/qatom.1
index fea1db6..9d0801b 100644
--- a/man/qatom.1
+++ b/man/qatom.1
@@ -1,7 +1,7 @@
-.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
-.TH qatom "1" "August 2006" "Gentoo Foundation" "qatom"
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.36.
+.TH qatom "1" "September 2006" "Gentoo Foundation" "qatom"
 .SH NAME
-qatom \- manual page for qatom 
+qatom \- split atom strings
 .SH SYNOPSIS
 .B qatom
 \fI<pkg> : split atom strings\fR
@@ -26,4 +26,4 @@ Options: \fB\-[cvqChV]\fR
 \fB\-V\fR, \fB\-\-version\fR
 * Print version and exit
 .PP
-$Id: qatom.1,v 1.11 2006/08/21 00:11:54 solar Exp $
+$Id: qatom.1,v 1.12 2006/09/11 05:54:12 vapier Exp $
diff --git a/man/qcache.1 b/man/qcache.1
index 9886e4b..a36177b 100644
--- a/man/qcache.1
+++ b/man/qcache.1
@@ -1,7 +1,7 @@
-.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
-.TH qcache "1" "August 2006" "Gentoo Foundation" "qcache"
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.36.
+.TH qcache "1" "September 2006" "Gentoo Foundation" "qcache"
 .SH NAME
-qcache \- manual page for qcache 
+qcache \- search the metadata cache
 .SH SYNOPSIS
 .B qcache
 \fI<action> <args> : search the metadata cache\fR
@@ -49,4 +49,4 @@ Options: \fB\-[p\fR:c:idtansvqChV]
 \fB\-V\fR, \fB\-\-version\fR
 * Print version and exit
 .PP
-$Id: qcache.1,v 1.2 2006/08/21 00:11:54 solar Exp $
+$Id: qcache.1,v 1.3 2006/09/11 05:54:12 vapier Exp $
diff --git a/man/qcheck.1 b/man/qcheck.1
index 9a34eee..b0f05f8 100644
--- a/man/qcheck.1
+++ b/man/qcheck.1
@@ -1,7 +1,7 @@
-.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
-.TH qcheck "1" "August 2006" "Gentoo Foundation" "qcheck"
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.36.
+.TH qcheck "1" "September 2006" "Gentoo Foundation" "qcheck"
 .SH NAME
-qcheck \- manual page for qcheck 
+qcheck \- verify mtimes/digests
 .SH SYNOPSIS
 .B qcheck
 \fI<pkgname> : verify mtimes/digests\fR
@@ -29,4 +29,4 @@ Options: \fB\-[auvqChV]\fR
 \fB\-V\fR, \fB\-\-version\fR
 * Print version and exit
 .PP
-$Id: qcheck.1,v 1.17 2006/08/21 00:11:54 solar Exp $
+$Id: qcheck.1,v 1.18 2006/09/11 05:54:12 vapier Exp $
diff --git a/man/qdepends.1 b/man/qdepends.1
index 6c5c3a0..e20e1bb 100644
--- a/man/qdepends.1
+++ b/man/qdepends.1
@@ -1,7 +1,7 @@
-.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
-.TH qdepends "1" "August 2006" "Gentoo Foundation" "qdepends"
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.36.
+.TH qdepends "1" "September 2006" "Gentoo Foundation" "qdepends"
 .SH NAME
-qdepends \- manual page for qdepends 
+qdepends \- show dependency info
 .SH SYNOPSIS
 .B qdepends
 \fI<pkgname> : show dependency info\fR
@@ -48,4 +48,4 @@ Options: \fB\-[drpaNk\fR:Q:vqChV]
 \fB\-V\fR, \fB\-\-version\fR
 * Print version and exit
 .PP
-$Id: qdepends.1,v 1.18 2006/08/21 00:11:54 solar Exp $
+$Id: qdepends.1,v 1.19 2006/09/11 05:54:12 vapier Exp $
diff --git a/man/qfile.1 b/man/qfile.1
index 38a4326..a9da250 100644
--- a/man/qfile.1
+++ b/man/qfile.1
@@ -1,7 +1,7 @@
-.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
-.TH qfile "1" "August 2006" "Gentoo Foundation" "qfile"
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.36.
+.TH qfile "1" "September 2006" "Gentoo Foundation" "qfile"
 .SH NAME
-qfile \- manual page for qfile 
+qfile \- list all pkgs owning files
 .SH SYNOPSIS
 .B qfile
 \fI<filename> : list all pkgs owning files\fR
@@ -32,7 +32,7 @@ Options: \fB\-[eoRvqChV]\fR
 \fB\-V\fR, \fB\-\-version\fR
 * Print version and exit
 .PP
-$Id: qfile.1,v 1.18 2006/08/21 00:11:54 solar Exp $
+$Id: qfile.1,v 1.19 2006/09/11 05:54:12 vapier Exp $
 file written for Gentoo by <solar and vapier 
  gentoo.org>
 .SH "FINDING FILES OWNERS"
diff --git a/man/qgrep.1 b/man/qgrep.1
index d00120a..b988d7a 100644
--- a/man/qgrep.1
+++ b/man/qgrep.1
@@ -1,7 +1,7 @@
-.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
-.TH qgrep "1" "August 2006" "Gentoo Foundation" "qgrep"
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.36.
+.TH qgrep "1" "September 2006" "Gentoo Foundation" "qgrep"
 .SH NAME
-qgrep \- manual page for qgrep 
+qgrep \- grep in ebuilds
 .SH SYNOPSIS
 .B qgrep
 \fI<misc args> : grep in ebuilds\fR
@@ -9,7 +9,7 @@ qgrep \- manual page for qgrep
 Options: \fB\-[IiHcevqChV]\fR
 .TP
 \fB\-I\fR, \fB\-\-invert\-match\fR
-* Select non-matching lines
+* Select non\-matching lines
 .TP
 \fB\-i\fR, \fB\-\-ignore\-case\fR
 * Ignore case distinctions
@@ -38,4 +38,4 @@ Options: \fB\-[IiHcevqChV]\fR
 \fB\-V\fR, \fB\-\-version\fR
 * Print version and exit
 .PP
-$Id: qgrep.1,v 1.13 2006/08/21 00:11:54 solar Exp $
+$Id: qgrep.1,v 1.14 2006/09/11 05:54:12 vapier Exp $
diff --git a/man/qlist.1 b/man/qlist.1
index 991c267..f895996 100644
--- a/man/qlist.1
+++ b/man/qlist.1
@@ -1,7 +1,7 @@
-.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
-.TH qlist "1" "August 2006" "Gentoo Foundation" "qlist"
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.36.
+.TH qlist "1" "September 2006" "Gentoo Foundation" "qlist"
 .SH NAME
-qlist \- manual page for qlist 
+qlist \- list files owned by pkgname
 .SH SYNOPSIS
 .B qlist
 \fI<pkgname> : list files owned by pkgname\fR
@@ -50,4 +50,4 @@ Options: \fB\-[ISUDeadosvqChV]\fR
 \fB\-V\fR, \fB\-\-version\fR
 * Print version and exit
 .PP
-$Id: qlist.1,v 1.19 2006/08/21 00:14:27 solar Exp $
+$Id: qlist.1,v 1.20 2006/09/11 05:54:12 vapier Exp $
diff --git a/man/qlop.1 b/man/qlop.1
index dda4e78..f0815fe 100644
--- a/man/qlop.1
+++ b/man/qlop.1
@@ -1,7 +1,7 @@
-.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
-.TH qlop "1" "August 2006" "Gentoo Foundation" "qlop"
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.36.
+.TH qlop "1" "September 2006" "Gentoo Foundation" "qlop"
 .SH NAME
-qlop \- manual page for qlop 
+qlop \- emerge log analyzer
 .SH SYNOPSIS
 .B qlop
 \fI<pkgname> : emerge log analyzer\fR
@@ -49,4 +49,4 @@ Options: \fB\-[gtluscf\fR:F:HvqChV]
 \fB\-V\fR, \fB\-\-version\fR
 * Print version and exit
 .PP
-$Id: qlop.1,v 1.16 2006/08/21 00:11:54 solar Exp $
+$Id: qlop.1,v 1.17 2006/09/11 05:54:12 vapier Exp $
diff --git a/man/qmerge.1 b/man/qmerge.1
index 7b9cb0c..8998799 100644
--- a/man/qmerge.1
+++ b/man/qmerge.1
@@ -1,7 +1,7 @@
-.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
-.TH qmerge "1" "August 2006" "Gentoo Foundation" "qmerge"
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.36.
+.TH qmerge "1" "September 2006" "Gentoo Foundation" "qmerge"
 .SH NAME
-qmerge \- manual page for qmerge 
+qmerge \- fetch and merge binary package
 .SH SYNOPSIS
 .B qmerge
 \fI<pkgnames> : fetch and merge binary package\fR
@@ -53,4 +53,4 @@ Options: \fB\-[fFsKUpuyO5vqChV]\fR
 \fB\-V\fR, \fB\-\-version\fR
 * Print version and exit
 .PP
-$Id: qmerge.1,v 1.10 2006/08/21 00:11:54 solar Exp $
+$Id: qmerge.1,v 1.11 2006/09/11 05:54:12 vapier Exp $
diff --git a/man/qpkg.1 b/man/qpkg.1
index 239247d..2c04383 100644
--- a/man/qpkg.1
+++ b/man/qpkg.1
@@ -1,7 +1,7 @@
-.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
-.TH qpkg "1" "August 2006" "Gentoo Foundation" "qpkg"
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.36.
+.TH qpkg "1" "September 2006" "Gentoo Foundation" "qpkg"
 .SH NAME
-qpkg \- manual page for qpkg 
+qpkg \- manipulate Gentoo binpkgs
 .SH SYNOPSIS
 .B qpkg
 \fI<misc args> : manipulate Gentoo binpkgs\fR
@@ -31,4 +31,4 @@ Options: \fB\-[pP\fR:vqChV]
 \fB\-V\fR, \fB\-\-version\fR
 * Print version and exit
 .PP
-$Id: qpkg.1,v 1.14 2006/08/21 00:11:54 solar Exp $
+$Id: qpkg.1,v 1.15 2006/09/11 05:54:12 vapier Exp $
diff --git a/man/qsearch.1 b/man/qsearch.1
index 84908ad..61359db 100644
--- a/man/qsearch.1
+++ b/man/qsearch.1
@@ -1,7 +1,7 @@
-.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
-.TH qsearch "1" "August 2006" "Gentoo Foundation" "qsearch"
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.36.
+.TH qsearch "1" "September 2006" "Gentoo Foundation" "qsearch"
 .SH NAME
-qsearch \- manual page for qsearch 
+qsearch \- search pkgname/desc
 .SH SYNOPSIS
 .B qsearch
 \fI<regex> : search pkgname/desc\fR
@@ -43,4 +43,4 @@ Options: \fB\-[acsSNHvqChV]\fR
 \fB\-V\fR, \fB\-\-version\fR
 * Print version and exit
 .PP
-$Id: qsearch.1,v 1.17 2006/08/21 00:11:54 solar Exp $
+$Id: qsearch.1,v 1.18 2006/09/11 05:54:12 vapier Exp $
diff --git a/man/qsize.1 b/man/qsize.1
index b4e0174..3867654 100644
--- a/man/qsize.1
+++ b/man/qsize.1
@@ -1,7 +1,7 @@
-.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
-.TH qsize "1" "August 2006" "Gentoo Foundation" "qsize"
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.36.
+.TH qsize "1" "September 2006" "Gentoo Foundation" "qsize"
 .SH NAME
-qsize \- manual page for qsize 
+qsize \- calculate size usage
 .SH SYNOPSIS
 .B qsize
 \fI<pkgname> : calculate size usage\fR
@@ -44,4 +44,4 @@ Options: \fB\-[fasSmkbvqChV]\fR
 \fB\-V\fR, \fB\-\-version\fR
 * Print version and exit
 .PP
-$Id: qsize.1,v 1.17 2006/08/21 00:11:54 solar Exp $
+$Id: qsize.1,v 1.18 2006/09/11 05:54:12 vapier Exp $
diff --git a/man/qtbz2.1 b/man/qtbz2.1
index fa769f6..3ff02e1 100644
--- a/man/qtbz2.1
+++ b/man/qtbz2.1
@@ -1,7 +1,7 @@
-.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
-.TH qtbz2 "1" "August 2006" "Gentoo Foundation" "qtbz2"
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.36.
+.TH qtbz2 "1" "September 2006" "Gentoo Foundation" "qtbz2"
 .SH NAME
-qtbz2 \- manual page for qtbz2 
+qtbz2 \- manipulate tbz2 packages
 .SH SYNOPSIS
 .B qtbz2
 \fI<misc args> : manipulate tbz2 packages\fR
@@ -38,4 +38,4 @@ Options: \fB\-[jstxOvqChV]\fR
 \fB\-V\fR, \fB\-\-version\fR
 * Print version and exit
 .PP
-$Id: qtbz2.1,v 1.15 2006/08/21 00:11:54 solar Exp $
+$Id: qtbz2.1,v 1.16 2006/09/11 05:54:12 vapier Exp $
diff --git a/man/quse.1 b/man/quse.1
index 1a1c890..9a21f9b 100644
--- a/man/quse.1
+++ b/man/quse.1
@@ -1,7 +1,7 @@
-.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
-.TH quse "1" "August 2006" "Gentoo Foundation" "quse"
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.36.
+.TH quse "1" "September 2006" "Gentoo Foundation" "quse"
 .SH NAME
-quse \- manual page for quse 
+quse \- find pkgs using useflags
 .SH SYNOPSIS
 .B quse
 \fI<useflag> : find pkgs using useflags\fR
@@ -46,4 +46,4 @@ Options: \fB\-[eavKLDF\fR:NvqChV]
 \fB\-V\fR, \fB\-\-version\fR
 * Print version and exit
 .PP
-$Id: quse.1,v 1.18 2006/08/21 00:11:54 solar Exp $
+$Id: quse.1,v 1.19 2006/09/11 05:54:12 vapier Exp $
diff --git a/man/qxpak.1 b/man/qxpak.1
index 559bf7d..948a5ce 100644
--- a/man/qxpak.1
+++ b/man/qxpak.1
@@ -1,7 +1,7 @@
-.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
-.TH qxpak "1" "August 2006" "Gentoo Foundation" "qxpak"
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.36.
+.TH qxpak "1" "September 2006" "Gentoo Foundation" "qxpak"
 .SH NAME
-qxpak \- manual page for qxpak 
+qxpak \- manipulate xpak archives
 .SH SYNOPSIS
 .B qxpak
 \fI<misc args> : manipulate xpak archives\fR
@@ -40,4 +40,4 @@ Options: \fB\-[lxcd\fR:OvqChV]
 \fB\-V\fR, \fB\-\-version\fR
 * Print version and exit
 .PP
-$Id: qxpak.1,v 1.15 2006/08/21 00:11:54 solar Exp $
+$Id: qxpak.1,v 1.16 2006/09/11 05:54:12 vapier Exp $