How can I compile TikZ pgf manuals 1.01; 1.18; 2.10 and 3.0.1a?

Question

My request to archive old TikZ manuals was closed on the grounds that it is sufficient to compile these manuals with the corresponding version of pgf.

Archive old manuals? #903

It is specified that to do this, it is necessary to compile with the corresponding version of pgf.

How do you go about compiling an old manual on MikTeX in practice? On TeX Live?

The pgf tikz repository only keeps the sources.

this seems a very strange thing to want to do. If you just want to look at the old pdfs they are available in texlive svn, but what is the use of an old manual anyway? — David Carlisle, Aug 02 '20 at 22:05
@DavidCarlisle The problem is specific to TikZ. There are some macros which have been documented in old TikZ manuals and which are no longer documented since version 3.0.0. These macros are still used and to understand their syntax it is necessary to read the old manuals. See for example this question: What do "-to" and "pre = moveto" do in TikZ arrows? and the comment dated Feb 1 '16 at 9:14 from Ulrike here Specifying the point via “intersection of” in TikZ - a problem — AndréC, Aug 03 '20 at 05:07

score 8 · Answer 1 · answered Aug 02 '20 at 09:50

To compile a previous version of the pgf manual as a whole you can perform the following steps:

Clone the git repository: git clone https://github.com/pgf-tikz/pgf
Checkout the tag you want to compile the manual for (you can list the tags using git tag). I'll do that for 3.0.1 by running git checkout 3.0.1.
Configure an RCS provider script like https://github.com/kimmormh/git-rcs-keywords or replace the $Header$ by $Header: x.y,v z 2020/01/01 a$ with something along the lines of find ./ -exec sed -i 's=\$Header\$=\$Header: x.y,v z 2020/01/01 a\$=g' {} \;.
Create a texmf directory mkdir -p texmf/tex and cp -r {context,generic,latex,plain} texmf/tex.
Create an auxiliary tree using sudo tlmgr conf auxtrees add "$(pwd)/texmf"
Change into the engine's folder you want to compile the manual with. I will use pdftex, so I do cd doc/generic/pgf/version-for-pdftex/en.
Run make in this folder.
Open the generated PDF.

@AndréC I only have Linux so I can't test. But probably also on Mac OS and on Windows you can use the WSL (Windows Subsystem for Linux), I guess. — TeXnician, Aug 02 '20 at 09:52

How can I compile TikZ pgf manuals 1.01; 1.18; 2.10 and 3.0.1a?

1 Answers1