[Gpg4win-devel] How to build a manual separately from svn (was: Tex/LaTex Viewers?)

[Bernhard Reiter]

On Wednesday 31 January 2007 11:00, Bernhard Reiter wrote:
> On Monday 29 January 2007 16:37, Michael W. Lewis wrote:
> > Now that I have downloaded all of: gpg4win: trunk/doc/manual,

Note: The svn command is the best way of getting a working copy. :)

> > what must I 
> > do to turn "version.tex.in" into "version.tex" and "Makefile.am" into
> > "Makefile"? (On Windows? On Linux?).

> This is a toolchain prepared to work on a full SVN checkout,
> see README.SVN on the top level.
>
> autogen.sh will call autoconf,
> which does Makefile.am -> Makefile.in
> Running configure will then do Makefile.in -> Makefile,
> version.tex.in -> version.tex.
>
> In you case I suggest to do this manually which probably is easier
> if you only want to build the manual.

I have done a test and here are my results which complete the 
raw instruction how to build a pdf from svn if you only have the
"manual" subdirectory checked out and not the full toolchain
to build everything in place.

> cp version.tex.in version.tex
> and then - if you want - replace some of the
> @MANUALVERSION_NOVICES@ things in version.tex with you editor.

I did
cat version.tex.in | sed 's/@.*@/svn-r373/' >version.tex
        (use something suitable instead of 'r373')


> cp Makefile.am Makefile
> I have not tried it and you might need to
> replace set some of the macros there as well.
> E.g. add lines to the beginning like
>
> ZCAT=zcat
> CONVERT=convert
> TEXI2DVI=texi2dvi
> DVIPDF=dvipdf

        I needed to make sure that the eps and bounding information
        was there when latex is run to build the .dvi, thus I have changed
        the Makefile.am:

--- Makefile.am (Revision 373)
+++ Makefile.am (Arbeitskopie)
@@ -79,7 +79,7 @@
 all-local: einsteiger.pdf durchblicker.pdf novices.pdf advanced.pdf

 einsteiger.pdf : $(eps_files_bb) $(png_files_eps) $(eps_files_png)
-einsteiger.dvi : version.tex macros.tex
+einsteiger.dvi : version.tex macros.tex $(eps_files_bb) $(png_files_eps)
 einsteiger.html : version.tex macros.tex
 durchblicker.pdf : $(eps_files_bb) $(png_files_eps) $(eps_files_png)
 durchblicker.dvi : version.tex macros.tex


        Now we can call the Makefile.am directly,
        but given default for needed commands
CONVERT=convert ZCAT=zcat TEXI2DVI=texi2dvi DVIPDF=dvipdf \
        make -f Makefile.am einsteiger.pdf

Hint:
        If you want to fully clean up after some experiments in a svn working
        copy, you can use "svn status" to find out which files are changed.

Bernhard



-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 189 bytes
Desc: not available
Url : http://lists.wald.intevation.org/pipermail/gpg4win-devel/attachments/20070211/a9be6491/attachment.pgp