[Freeipa-devel] [PATCH] Clean-up patches

[Simo Sorce]

On Tue, 2009-03-10 at 15:09 +0100, Jakub Hrozek wrote:
> On Tue, 2009-03-10 at 09:45 -0400, Simo Sorce wrote:
> > > Ack to both patches, but I would like to recommend that we make sure
> > > to
> > > include the MPG constraints in any documentation we might write for
> > > SSSD. Notably, we should probably have some manpages for the
> > > commandline
> > > tools that spell this out explicitly.
> > 
> > pushed
> > 
> > and yes we need to prominently doc it, who wants to volunteer to write
> > manpages ?
> 
> I will certainly write manpages for the cmdline tools. I might as well
> write manpages for other parts of sssd, if needed.
> 
> But the question is - what format? Pure troff? XML/Docbook? I'm in favor
> of XML as it gives as much more flexibility when it comes to output to
> various formats, etc.

I tend to favor XML but it had also been a pain in the past within the
samba project at times. If we do that I would also vote to pre-build the
man pages in the official tarballs, so that people don't have to get
crazy just to build them.

Simo.

-- 
Simo Sorce * Red Hat, Inc * New York