On Fri, Feb 25, 2011 at 19:13, Bernard Li <bern...@vanhpc.org> wrote:
> Currently maintaining the manpages in mans/ is a manual process.  One
> would need to know the exact options necessary to generate the
> manpages to have the same format as the one currently in the mans/
> directory.

Really?  That's...crazy.

> What do people think about adding Makefile targets to generate these
> during build time, now that the COPYING, BUGS, AUTHORS file are
> relatively in current state which can then be used as manpage
> templates.

Yes:  absolutely.

> help2man seems to be readily available in most Linux distributions.
> My main concern is other OSes.  I guess we could potentially continue
> to ship 'stock' man pages in the distribution tarball, however I
> noticed that they all have /etc/ganglia hardcoded as the sysconfdir,
> so if one were to use a different prefix, the manpages will be
> misleading.
>
> Thoughts?

A simple search/replace using your templating program of choice will
fix any hard-coded paths.

-- 
Jesse Becker

------------------------------------------------------------------------------
Free Software Download: Index, Search & Analyze Logs and other IT data in 
Real-Time with Splunk. Collect, index and harness all the fast moving IT data 
generated by your applications, servers and devices whether physical, virtual
or in the cloud. Deliver compliance at lower cost and gain new business 
insights. http://p.sf.net/sfu/splunk-dev2dev 
_______________________________________________
Ganglia-developers mailing list
Ganglia-developers@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/ganglia-developers

Reply via email to