+* `DEFS += foo' won't work.
+ That's because DEFS is defined in header-vars.am, which is read
+ after the user's Makefile.am.
+ This will be a problem for any macro defined internally
+
* document user namespace for macro/target names
adopt some conventions and use uniformly
pages are declared using the @samp{MANS} primary. Generally the
@code{man_MANS} macro is used. Man pages are automatically installed in
the correct subdirectory of @code{mandir}, based on the file extension.
+They are not automatically included in the distribution.
@vindex MANS
@vindex man_MANS
@example
info_TEXINFOS = cpio.texi
man_MANS = cpio.1 mt.1
+EXTRA_DIST = $(man_MANS)
@end example
Texinfo source and info pages are all considered to be source for the
purposes of making a distribution.
Man pages are not currently considered to be source, because it is not
-uncommon for man pages to be automatically generated.
+uncommon for man pages to be automatically generated. For the same
+reason, they are not automatically included in the distribution.
@node Install, Clean, Documentation, Top