4-SUFFIXES-doc-update.patch

[Alexandre Duret-Lutz]

Index: ChangeLog
--- ChangeLog
+++ ChangeLog
@@ -1,1 +1,6 @@
+2001-11-13  Alexandre Duret-Lutz  <address@hidden>
+
+       * automake.texi (Suffixes): Don't require SUFFIXES, but document
+       its use for the "extreme" cases.
+

Index: NEWS
===================================================================
RCS file: /home/adl/CVSROOT/automake-20011109-2037/NEWS,v
retrieving revision 1.1
diff -u -r1.1 NEWS
--- NEWS        9 Nov 2001 19:38:05 -0000       1.1
+++ NEWS        13 Nov 2001 20:50:21 -0000
@@ -9,6 +9,7 @@
   and AC_).
 * `#line' of Lex and Yacc files are properly set.
 * EXTRA_DIST can contain generated directories.
+* Support for dot-less extensions in suffix rules.
 * Fixed CDPATH portability problems, in particular for MacOS X.
 * Fixed handling of nobase_ targets.
 * Fixed support of implicit rules leading to .lo objects.
Index: automake.texi
===================================================================
RCS file: /home/adl/CVSROOT/automake-20011109-2037/automake.texi,v
retrieving revision 1.1
diff -u -r1.1 automake.texi
--- automake.texi       9 Nov 2001 19:38:05 -0000       1.1
+++ automake.texi       13 Nov 2001 20:59:39 -0000
@@ -3988,19 +3988,18 @@
 
 @cindex Adding new SUFFIXES
 @cindex SUFFIXES, adding
address@hidden SUFFIXES
 
 It is sometimes useful to introduce a new implicit rule to handle a file
-type that Automake does not know about.  If this is done, you must
-notify GNU Make of the new suffixes.  This can be done by putting a list
-of new suffixes in the @code{SUFFIXES} variable.
address@hidden SUFFIXES
+type that Automake does not know about.
 
 For instance, suppose you had a compiler which could compile @samp{.foo}
-files to @samp{.o} files.  Then you would add @samp{.foo} to your suffix
-list:
+files to @samp{.o} files.  You would simply define an suffix rule for
+your language:
 
 @example
-SUFFIXES = .foo
+.foo.o:
+        foocc -c -o $@@ $<
 @end example
 
 Then you could directly use a @samp{.foo} file in a @samp{_SOURCES}
@@ -4011,9 +4010,29 @@
 doit_SOURCES = doit.foo
 @end example
 
-Any given @code{SUFFIXES} go at the start of the generated suffixes
-list, followed by automake generated suffixes not already in the list.
+This was the simpler and more common case.  In other cases, you will
+have to help Automake to figure which extensions you are defining your
+suffix rule for.  This usually happens when your extensions does not
+start with a dot.  Then, all you have to do is to put a list of new
+suffixes in the @code{SUFFIXES} variable @strong{before} you define your
+implicit rule.
+
+For instance the following definition prevents Automake to misinterpret
address@hidden:} as an attemp to transform @samp{.idlC} into
address@hidden
+
address@hidden
+SUFFIXES = .idl C.cpp
+.idlC.cpp:
+        # whatever
address@hidden example
 
+As you may have noted, the @code{SUFFIXES} macro behaves like the
address@hidden special target of @code{make}.  You should not touch
address@hidden yourself, but use @code{SUFFIXES} instead and let
+Automake generate the suffix list for @code{.SUFFIXES}.  Any given
address@hidden go at the start of the generated suffixes list, followed
+by Automake generated suffixes not already in the list.
 
 @node Multilibs, , Suffixes, Miscellaneous
 @section Support for Multilibs
Index: stamp-vti
===================================================================
RCS file: /home/adl/CVSROOT/automake-20011109-2037/stamp-vti,v
retrieving revision 1.1
diff -u -r1.1 stamp-vti
--- stamp-vti   9 Nov 2001 19:38:06 -0000       1.1
+++ stamp-vti   13 Nov 2001 20:59:42 -0000
@@ -1,4 +1,4 @@
address@hidden UPDATED 9 November 2001
address@hidden UPDATED 13 November 2001
 @set UPDATED-MONTH November 2001
 @set EDITION 1.5a
 @set VERSION 1.5a
Index: version.texi
===================================================================
RCS file: /home/adl/CVSROOT/automake-20011109-2037/version.texi,v
retrieving revision 1.1
diff -u -r1.1 version.texi
--- version.texi        9 Nov 2001 19:38:06 -0000       1.1
+++ version.texi        13 Nov 2001 20:50:29 -0000
@@ -1,4 +1,4 @@
address@hidden UPDATED 9 November 2001
address@hidden UPDATED 13 November 2001
 @set UPDATED-MONTH November 2001
 @set EDITION 1.5a
 @set VERSION 1.5a