[rrd-developers] RFC: Introducing (optional) 'make doc'?

[Sebastian Harl]

Hi,

Currently, 'make; make install' unconditionally build and install the
documentation in all of the following formats: pod, txt, man, html.
Imho, usually, people only want 'man' and possibly 'html' (which is
what's currently included in the Debian package). 'txt' might be
interesting, if man / roff are unusable - which should be a really rare
case nowadays ;-) And, quite frankly, I cannot think of why some user
should be interested in the 'pod' documentation.

What do you think about the following:

 * Do not build the documentation by default (or: build man pages only).

 * Introduce 'doc' and 'install-doc' targets to build and install _all_
   documentation.

 * Introduce 'install-<type>' targets to install a specific format only
   ('<type>' targets to build a specific format are available already
   but not yet accessible from the top-level source directory).

My motivation to request that change is to avoid building and installing
(and then removing again) unneeded documentation.

What do others think? Any comments / suggestions?

Cheers,
Sebastian

-- 
Sebastian "tokkee" Harl +++ GnuPG-ID: 0x8501C7FC +++ http://tokkee.org/

Those who would give up Essential Liberty to purchase a little Temporary
Safety, deserve neither Liberty nor Safety.         -- Benjamin Franklin

-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 197 bytes
Desc: Digital signature
Url : http://lists.oetiker.ch/pipermail/rrd-developers/attachments/20090925/b7d025d9/attachment.pgp