From 24091111fd92372352387f5313233aef014845c4 Mon Sep 17 00:00:00 2001 From: Mike Swanson Date: Thu, 12 Sep 2019 15:44:49 -0700 Subject: [PATCH] COMPILING: ASCIIDOC make variables, note asciidoctor-pdf --- COMPILING.adoc | 11 ++++++++--- 1 file changed, 8 insertions(+), 3 deletions(-) diff --git a/COMPILING.adoc b/COMPILING.adoc index fd93d16d..853a2144 100644 --- a/COMPILING.adoc +++ b/COMPILING.adoc @@ -71,9 +71,14 @@ Optional software the latest developments can be tracked with it. * _AsciiDoc_: The `*.adoc` files are all written in AsciiDoc markup, and it can be used to generate HTML versions of all these - documents. This is used as part of the `make dist` target, to - generate the `README.html` file for inclusion with official Zip - files. + documents. This is used as part of the `make dist` and `make + install` targets, to generate the `NEWS.html` and `README.html` + files for inclusion with official Zip files. Different + implementations (eg, AsciiDoctor) may be selected by passing + `ASCIIDOC` and `ASCIIDOC_MAN` environment variables to `make`. + * _AsciiDoctor PDF_: Our manual, maintained in `manual/manual.adoc`, + has a hard dependency on this implementation of AsciiDoc for its + superior-looking PDF output. * _Zip_: The `make dist` target uses Zip to create release archives for FreeDM, Phase 1, and Phase 2. This can also provide an easy way to automate generating in-development versions for other