[Cluster-devel] Fix fence-agents manpages

[Arnaud Quette]

Hi Fabio,

2011/12/6 Fabio M. Di Nitto <fabbione at 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.

cheers,
Arnaud
-- 
Linux / Unix Expert R&D - Eaton - http://powerquality.eaton.com
Network UPS Tools (NUT) Project Leader - http://www.networkupstools.org/
Debian Developer - http://www.debian.org
Free Software Developer - http://arnaud.quette.free.fr/