man pages

[Panu Matilainen]

On Sat, 2006-06-03 at 13:43 -0600, Vincent Danen wrote:
> * Vincent Danen <vdanen at annvix.org> [2006-06-03 09:34:59 -0600]:
> 
> > > >> apt-get(8) is done and attached.  Please let me know what you think.
> > > >
> > > > Forget that one... made some more changes to it.  Attached is a tarball
> > > > containing an updated apt-get(8) as well as apt-cdrom(8), apt-config(8),
> > > > apt(8), source.list(5), and vendors.list(5).
> > > >
> > > > That leaves me with 3 more manpages to update.
> > > 
> > > Based on a quick glance over the diffs, looks good to me. Just one thing - 
> > > the commands section in apt-get is different from all the others, probably 
> > > comes from the asciidoc experimentations, it originally looked like the 
> > > others as well. So perhaps that should be changed to match the style in 
> > > others.
> > 
> > I was thinking that, but because the sections in apt-get are bigger, I
> > thought it made for too much scrolling to have them indented the same
> > way.  I can easily change it so that it does indent and fits the same
> > style as the rest, however.
> 
> I changed this to work the rest, so the look is more consistent and also
> cleaned up a few other things so you can scrap the ones I gave you
> before and use the attached instead.
> 
> All the manpages are done now.  =)

Hmm, I'm curious why did you remove the bolding on the command names in
all manuals but then made the arguments bold? Eg in apt-get.8:
install [pkg(s)]
..where "install" is normal text and "[pkg(s)]" bold, the traditional
way is the other way around looking at similar cases from other programs
manuals.

Btw, "source" and "build-dep" commands always require an argument, and
additionally "update" can take arguments (what source lists to update). 
Oh well, we'll need to comb through the content with some extra care
anyway, there are quite a few things that are simply wrong (for apt-rpm)
in the Debian originals and then varying degrees of nonsensibility,
unclearness and whatnot. 

So, I'd be happier if you could "fix" the boldness in commands eg 
.TP
upgrade

-->
.TP
\fBupgrade\fR

	- Panu -