This is the mail archive of the
binutils@sources.redhat.com
mailing list for the binutils project.
Re: Should we remove those man pages from CVS?
- To: "H . J . Lu" <hjl at lucon dot org>
- Subject: Re: Should we remove those man pages from CVS?
- From: "David O'Brien" <obrien at FreeBSD dot org>
- Date: Mon, 25 Jun 2001 11:14:26 -0700
- Cc: Nick Clifton <nickc at cambridge dot redhat dot com>, binutils at sourceware dot cygnus dot com
- Organization: The NUXI BSD group
- References: <20010616093504.B2742@lucon.org> <m3ae371mas.fsf@north-pole.nickc.cambridge.redhat.com> <20010617120315.A2587@lucon.org>
- Reply-To: obrien at FreeBSD dot org
On Sun, Jun 17, 2001 at 12:03:16PM -0700, H . J . Lu wrote:
> # make binutils.tar.bz2 -f Makefile.in
>
> All the man pages are generated along with the info pages and included
> in the tarball.
The resulting manpages have a nit in them:
OBJCOPY.1(1) GNU OBJCOPY.1(1)
the ".1" should not be there. They also product a fully blank last page
on BSD.
Also the SYNOPSIS is much, much uglier with the generated versions. This
is because it is now:
.SH "SYNOPSIS"
objcopy [ \-F \fIbfdname\fR | --target=\fIbfdname\fR ]
[ \-I \fIbfdname\fR | --input-target=\fIbfdname\fR ]
vs 2.11.0's:
.SH SYNOPSIS
.hy 0
.na
.TP
.B objcopy
.RB "[\|" \-F\ \fIbfdname\fR\ |\ \fB\-\-target=\fIbfdname\fR "\|]"
.RB "[\|" \-I\ \fIbfdname\fR\ |\ \fB\-\-input\-target=\fIbfdname\fR "\|]"
The BSD man system displays this with lot of surrounding blanks around the
['s and ]'s.
Is anyone working on making the manpage generating script better to get
the same quality of manpage formatting as before?
--
-- David (obrien@FreeBSD.org)