[Cluster-devel] Fix fence-agents manpages

[Fabio M. Di Nitto <fabbione@fabbione.net>]

On 12/6/2011 4:05 PM, Arnaud Quette wrote:
> Hi Fabio,
> 
> 2011/12/6 Fabio M. Di Nitto <fabbione@fabbione.net>:
>> On 12/6/2011 2:27 PM, Arnaud Quette wrote:
>>> Hi Cluster-devel list,
>>>
>>> You will find attached a patch originating from Ubuntu (Andres
>>> Rodriguez), that fixes a few issues in manpages (namely fence_drac and
>>> fence_scsi).
>>
>>
>> I wonder why the ubuntu/canonical maintainers can?t post patches
>> directly for upstream inclusion.
> 
> they obviously can Fabio.
> But I proposed to do this on my side, since I still have some things
> to do around fence_eaton...
> That way, they can focus on other things.
> 
> After all, it's just posting an email. The actual and important work
> is to catch bugs and fix this ;-)
> 
>>> Please consider applying it.
>>>
>>> As a side note, you may want to consider Asciidoc [1] to handle
>>> generation of manpages, in groff and html format.
>>> This already takes care of the groff formating, and would avoid the
>>> above kind of issues.
>>> That said, iirc you're also doing some POD style extraction, so it may
>>> not be fully relevant.
>>
>> goal is to have all manpages generated at build time via fence_agent -o
>> metadata output. Most of patches already exists for those few agents
>> that don?t it.
> 
> ok, that confirms the "POD" style approach.
> I wasn't sure if you were standardizing on this, or going away from.

The patch will be "obsoleted" in the fence-agents release or max two.

Fabio