>>> "BR" == Bob Rossi <[EMAIL PROTECTED]> writes:

 BR> My doc directory is built after all others. I was thinking I could have
 BR> a rule in the doc directory that would run help2man if usage.c has
 BR> changed. However, if usage.c was changed, by this point, the usage.o has
 BR> already been built, so I don't know how I would be able to determine I
 BR> need to run this command.

I don't understand your problem with usage.o; why would we care
about usage.o?  You need to rebuild cgdb.1 whenever usage.c is
newer than cgdb.1.  And since the version can probably be
changed without modifying usage.c, e.g., by changing
configure.ac, you also need to rebuild cgdb.1 whenever
configure.ac is newer.

 BR> Also, I did read this:
 BR> http://www.gnu.org/software/automake/manual/html_mono/automake.html
 BR> section: "Files left in build directory after distclean"

I think this shows all you need.  Adjusted to you case it would
probably give

     dist_man_MANS = cgdb.1

     cgdb.1: $(top_srcdir)/src/usage.c $(top_srcdir)/configure.ac
             cd $(top_builddir)/src && $(MAKE) $(AM_MAKEFLAGS) cgdb$(EXEEXT)
             help2man --output=$@ $(top_builddir)/src/foo$(EXEEXT)

 BR> And finally, at the bottom of that section I may have found an error in
 BR> the documentation. 

Thanks, I'm installing this.

2006-02-05  Alexandre Duret-Lutz  <[EMAIL PROTECTED]>

        * doc/automake.texi (distcleancheck): Fix bad wording.  Report
        from Bob Rossi.
        (Man pages): Show dist_man_MANS, not EXTRA_DIST = $(man_MANS).

Index: THANKS
===================================================================
RCS file: /cvs/automake/automake/THANKS,v
retrieving revision 1.275
diff -u -r1.275 THANKS
--- THANKS      7 Aug 2005 09:56:09 -0000       1.275
+++ THANKS      5 Feb 2006 05:50:13 -0000
@@ -31,6 +31,7 @@
 Bill Fenner            [EMAIL PROTECTED]
 Bob Friesenhahn                [EMAIL PROTECTED]
 Bob Proulx             [EMAIL PROTECTED]
+Bob Rossi              [EMAIL PROTECTED]
 Braden N. McDaniel     [EMAIL PROTECTED]
 Brendan O'Dea          [email protected]
 Brian Ford             [EMAIL PROTECTED]
Index: doc/automake.texi
===================================================================
RCS file: /cvs/automake/automake/doc/automake.texi,v
retrieving revision 1.126
diff -u -r1.126 automake.texi
--- doc/automake.texi   29 Jan 2006 17:35:12 -0000      1.126
+++ doc/automake.texi   5 Feb 2006 05:50:15 -0000
@@ -6200,18 +6200,16 @@
 installed by default.  The user can still explicitly install them via
 @samp{make install-man}.
 
-Here is how the man pages are handled in GNU @command{cpio} (which
-includes both Texinfo documentation and man pages):
-
[EMAIL PROTECTED]
-man_MANS = cpio.1 mt.1
-EXTRA_DIST = $(man_MANS)
[EMAIL PROTECTED] example
-
 Man pages are not currently considered to be source, because it is not
 uncommon for man pages to be automatically generated.  Therefore they
 are not automatically included in the distribution.  However, this can
-be changed by use of the @code{dist_} prefix.
+be changed by use of the @code{dist_} prefix.  For instance here is
+how to distribute and install the two man pages of GNU @command{cpio}
+(which includes both Texinfo documentation and man pages):
+
[EMAIL PROTECTED]
+dist_man_MANS = cpio.1 mt.1
[EMAIL PROTECTED] example
 
 The @code{nobase_} prefix is meaningless for man pages and is
 disallowed.
@@ -8606,10 +8604,10 @@
 Distributed files should never depend upon non-distributed built
 files.
 @item
-Distributed files should be distributed will all their dependencies.
+Distributed files should be distributed with all their dependencies.
 @item
-If a file is @emph{intended} be rebuilt by users, there is no point in
-distributing it.
+If a file is @emph{intended} to be rebuilt by users, then there is no point
+in distributing it.
 @end itemize
 @end cartouche
 
-- 
Alexandre Duret-Lutz

Shared books are happy books.     http://www.bookcrossing.com/friend/gadl



Reply via email to