#22 Building the user manuals from CTAN sources fail

[Markus Kohm]

Trying to make the user manuals from the KOMA-Script package downloaded from CTAN does fail.

Try the following steps:

• Download the whole KOMA-Script from CTAN.
• Extract koma-script.zip from the previous step.
• Go into the folder koma-script/source-doc.
• Run make.

This results in a failure:

Makefile:71: BASEDIR/koma-script/source-doc/../Makefile.baseinit: No such file or directory
make: *** No rule to make target 'BASEDIR/koma-script/source-doc/../Makefile.baseinit'.  Stop.

(BASEDIR is the directory I've unpacked koma-script.zip).

Going to koma-script/doc/english or koma-script/doc/ngerman and running make there does also not work but results in almost the same error. Running LaTeX for any of the files in koma-script/doc/english or koma-script/doc/ngerman does also not work So building one of the user manuals from the source at koma-script/source-doc does not work. source-doc is more or less useless or only a kind of alibi to make scrguide.pdf and scrguien.pdf free in sense of some distributors.

[Markus Kohm]

This is true and currently intended. The structure of the CTAN package has to be different from the original structure of the KOMA-Script sources to fulfill the CTAN rules. More or less this is not really a KOMA-Script issue but a CTAN issue.

If you want to make the user manuals on your own, please download the sources of the corresponding release from the repository. With this source, you can use make from within every (sub-)directory you want. But even in this case, it is sometimes necessary to add a file Makefile.cfg:

# Use this for local changes

# If the following line is activated pdflatex-dev instead of
# pdflatex will be used to generate several documentation files.
# See https://ctan.org/pkg/latex-base-dev for more information.
# Note: Sometimes using pdflatex instead of pdflatex-dev does fail,
#       but sometimes pdflatex-dev instead of pdflatex does fail.
#       However, the developers usually use pdflatex-dev.
LATEX = pdflatex-dev

I do not know, when this will change.

[Markus Kohm]

This issue has been solved by a complete reorganization of the sources of the manuals and the build process. However, if you want to make the user manuals on your own, please download the sources of the corresponding release from the repository. With this you can use l3build doc to build not only the user manuals but also the implementation documentations.

Note: The user manuals are renamed now. The English manual is scrguide-en.pdf. The German manual is scrguide-de.pdf. The old names scrguien.pdf and scrguide.pdf has been 8+3 anachronisms.