Bug#279685: gencat: manual page fixup
Package: libc6-dev
Version: 2.3.2.ds1-18
Severity: minor
The manual page for gencat has a "\fT" instead of a "\fR" which causes
all of the first paragraph to be boldface rather than just the word
"gencat". I think it makes sense to mark "catgets" as boldface as well,
and it might be good to add a "(3)" afterwards.
Options are better shown with .TP paragraphs. They are more visually
distinctive this way, when the explanations are indented.
I am attaching a patch to make these changes. Only the first change is a
real bug, the others are more a matter of opinion.
--- gencat.1 2004-11-04 18:32:32.000000000 +0200
+++ gencat.1.new 2004-11-04 18:32:47.000000000 +0200
@@ -207,21 +207,19 @@
.SH "SYNOPSIS"
gencat [OPTION...] -o OUTPUT-FILE [INPUT-FILE]...
.SH "DESCRIPTION"
-The \fBgencat\fT program is specified in the X/Open standard and the
+The \fBgencat\fR program is specified in the X/Open standard and the
GNU implementation follows this specification and so processes all
correctly formed input files. Additionally some extension are implemented
-which help to work in a more reasonable way with the catgets functions.
+which help to work in a more reasonable way with the \fBcatgets\fR(3) functions.
.PP
+.TP
\fB-H\fR, \fB--header\fR \fINAME\fR
-.PP
Create C header file NAME containing symbol definitions
-.PP
+.TP
\fB--new\fR
-.PP
Do not use existing catalog, force new output file
-.PP
+.TP
\fB-o\fR, \fB--output\fR \fINAME\fR
-.PP
Write output to file NAME
.SH "AUTHOR"
\fIgencat\fR was written by Ulrich Drepper as part of the GNU C Library.
Reply to: