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

[Sumit Bose]

Simo Sorce schrieb:
> 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.
> 

+1

bye,
Sumit