man pages

[Panu Matilainen]

On Sat, 2006-05-27 at 11:07 -0600, Vincent Danen wrote:
> * Panu Matilainen <pmatilai at laiskiainen.org> [2006-05-27 11:29:21 +0300]:
> 
> > > The manpages are currently extremely debian-centric and a lot of the
> > > options that would be pertinent to apt-rpm are missing, the like the "-o
> > > rpm::rootdir=" option.
> > > 
> > > Are there any plans to clean these manpages up?  It seems to me, based
> > > on some conversation that I've watched, that apt-rpm is sufficiently
> > > diverged from debian's apt to warrant a manpage overhaul.
> > > 
> > > Thoughts?  Note, I'm not asking the developers to do it... =)  I'd be
> > > more than willing to put some time into the effort as well (it's
> > > important to me to have accurate manpages, especially if I look at
> > > replacing urpmi with apt).
> > 
> > I know, the manuals totally suck at the moment. Improved documentation
> > is on the todo-list and patches/wholly rewritten man pages would be
> > very, very welcome.
> 
> =)
> 
> Well, as soon as I finish converting my installer from using urpmi to
> using apt, I'll give this a gander.
> 
> Note that I'm going to change it so that the manpages don't have to be
> "compiled" because I think that sucks.

I guess I didn't reply to the manpage thread...

Please use the sgml/xml documentation format. It's nice for creating
non-manpage documentation, but I certainly agree having to "compile" man
pages is silly. I wouldn't be against somebody submitting a patch to
make "make dist" build the documentation as well for inclusion in
distribution tarballs, hint hint :)

	- Panu -