Re: New documentation targets (pdf & txt)

[Derek R. Price]

Akim Demaille wrote:

> But the documentation and NEWS bits are lacking.

Attached:

2001-10-22  Derek Price  <address@hidden>

        * NEWS: Note new documentation targets.
        * automake.texi (Texinfo): Ditto.


>  Also, I confess I
> don't understand why, if on the one hand, you define
> am_info_CLEANstuff, then, on the other hand, mostlyclean-aminfo is not
> simplified.  AFAICS, it still contains hard coded things, right?

I didn't finish.  I was thinking about simplifying all the clean targets, or at
least all the info-clean targets, this way, but, as I mentioned, when I 
attempted
to generalize, I got stuck.  For some reason I couldn't get a `+=' generated 
macro
into the Makefile.in from the handle_clean function.  I tried both
&variable_output_pretty and passing in the data to &file_contents and got 
nothing
for it.  IIRC, &variable_output_pretty was actually generating variable 
undefined
warnings.  I don't know why this happened but I still haven't found time to look
into it.

Derek

--
Derek Price                      CVS Solutions Architect ( http://CVSHome.org )
mailto:address@hidden         CollabNet ( http://collab.net )
--
89. A day without sunshine is like, you know, night.


Index: NEWS
===================================================================
RCS file: /cvs/automake/automake/NEWS,v
retrieving revision 1.155
diff -u -r1.155 NEWS
--- NEWS        2001/10/20 11:14:36     1.155
+++ NEWS        2001/10/23 12:11:36
@@ -2,6 +2,7 @@
 * Autoconf 2.52 is required.
 * `dist' generates all the archive flavors, as did `dist-all'.
 * `dist-gzip' generates the Gzip tar file only.
+* New texinfo documentation targets are available, pdf, ps, and txt.
 * Combining Automake Makefile conditionals no longer lead to a combinatorial
   explosion.  Makefile.in's keep a reasonable size.
 * AM_FUNC_ERROR_AT_LINE, AM_FUNC_STRTOD, AM_FUNC_OBSTACK, AM_PTRDIFF_T
Index: automake.texi
===================================================================
RCS file: /cvs/automake/automake/automake.texi,v
retrieving revision 1.244
diff -u -r1.244 automake.texi
--- automake.texi       2001/10/21 18:04:15     1.244
+++ automake.texi       2001/10/23 12:11:36
@@ -3220,13 +3220,21 @@
 @cindex _TEXINFOS primary, defined
 @cindex TEXINFOS primary, defined
 @cindex Primary variable, TEXINFOS
address@hidden Documentation targets
address@hidden info, documentation target
address@hidden dvi, documentation target
address@hidden ps, documentation target
address@hidden pdf, documentation target
address@hidden text, documentation target
 
 If the current directory contains Texinfo source, you must declare it
 with the @samp{TEXINFOS} primary.  Generally Texinfo files are converted
 into info, and thus the @code{info_TEXINFOS} macro is most commonly used
-here.  Any Texinfo source file must end in the @file{.texi},
address@hidden, or @file{.texinfo} extension.  We recommend @file{.texi}
-for new manuals.
+here.  The @samp{TEXINFO} primary also causes dvi, pdf, ps (PostScript),
+and txt Makefile targets to be created, though these file types are not
+built and installed by default.  Any Texinfo source file must end in the
address@hidden, @file{.txi}, or @file{.texinfo} extension.  We recommend
address@hidden for new manuals.
 @vindex TEXINFOS
 @vindex info_TEXINFOS