utils man pages depend on executables

[ompiteam]

As mentioned in http://www.open-mpi.org/community/lists/hwloc-devel/2009/09/0060.php, there's a causality issue in "make dist": the man pages depend on the executables (because the man pages are generated via help2man).

This causes a problem with the following (e.g., nightly tarball generation):

{{{
svn co ...
cd ...
./autogen.sh
./configure
make dist
}}}

because the executables will try to build, but fail when there is no libhwloc.la.

A workaround, of course, is to "make all" first and then "make dist". But this is somewhat icky; it would be nice to have a better solution.

[ompiteam]

Imported from trac issue 3. Created by jsquyres on 2009-09-21T09:51:10, last modified: 2009-09-25T11:44:09

[ompiteam]

Trac comment by bgoglin on 2009-09-25 02:03:16:

Is "writing manpages manually" considered a better solution ? Given that these utils have few command-line options, the manpages won't be very hard to write/maintain manually.

By the way, currently we get the "lt-" prefix in the toolname in the auto-generated manpages. We'll have to fix this if we keep using help2man.

[ompiteam]

Trac comment by jsquyres on 2009-09-25 09:43:45:

Yes, it certainly would. Tell you what, I'll generate them with help2man and then commit the final pages. Then we'll just manually update from there.

[ompiteam]

Trac comment by jsquyres on 2009-09-25 11:44:09:

(In [1001]) Fixes #3.

Have fixed versions of the man pages for the executables in svn under
the .1in filename pattern. These files are processed during "make
all" to make the corresponding .1 files. The changes that are added
in are the project name, date, and release version. This gives
nice/proper headers and footers on the man pages that are specific to
the version that they came from.

This also fixes the issue of having the man pages depend on the
executables, which was causing problems for making nightly tarballs.