summaryrefslogtreecommitdiff
path: root/INSTALL.REPO
diff options
context:
space:
mode:
authorG. Branden Robinson <g.branden.robinson@gmail.com>2022-06-09 16:45:42 -0500
committerG. Branden Robinson <g.branden.robinson@gmail.com>2022-06-09 19:33:52 -0500
commit31f64af693b077b846ac2540f4ea2baf95c4ef10 (patch)
tree4310ecab007e8ba25e94fd71a9f60c04190be45f /INSTALL.REPO
parent04195f7e5d60c79bb6bf1a40b929a66aa8885ace (diff)
downloadgroff-git-31f64af693b077b846ac2540f4ea2baf95c4ef10.tar.gz
Weaken build dependency on TeX.
[build]: Weaken dependency on TeX, instead using it (to generate the DVI and PDF forms of our Texinfo manual) only if it is available. * m4/groff.m4 (GROFF_USE_TEX_CHECK): Check for presence of 'tex' executable in path. Set shell variable `groff_use_tex` to "yes" if present, and "no" otherwise. This check runs only if the 'makeinfo' and 'texi2dvi' version checks have already passed. * configure.ac: Run the new check. Set Automake conditional `USE_TEX` only if shell variable `groff_use_tex` is "yes". Report whether "groff.dvi" and "groff.pdf" are (re-)buildable. * doc/doc.am: Parameterize names of groff.{dvi,pdf} targets as Make macros `GROFF_DVI` and `GROFF_PDF`. Define them only if `USE_TEX`. Do _not_ update `EXTRA_DIST` macro; leave the literal file names there because we require that distribution archives contain these files. (.texi.dvi, .texi.pdf): Update suffix rules to check `USE_TEX` and fail, complaining of missing 'tex' program, if these targets are attempted without it being true. Only manually specifying the file names as targets to 'make' or attempting to generate a distribution archive without TeX present should cause these errors. * INSTALL.REPO: Update dependency information. Fixes <https://savannah.gnu.org/bugs/?62592>. Thanks to Deri James for the report.
Diffstat (limited to 'INSTALL.REPO')
-rw-r--r--INSTALL.REPO6
1 files changed, 5 insertions, 1 deletions
diff --git a/INSTALL.REPO b/INSTALL.REPO
index 066cb77d7..e6cf192ce 100644
--- a/INSTALL.REPO
+++ b/INSTALL.REPO
@@ -35,7 +35,11 @@ are several others.
* groff's Texinfo manual is generated in several formats: GNU Info,
HTML, plain text, TeX DVI, and PDF. The former three require
'makeinfo' from GNU Texinfo 5.0 or later. The latter two additionally
- require a TeX installation, such as TeX Live.
+ require a TeX installation, such as TeX Live. If TeX is not
+ installed, the DVI and PDF formats of the manual cannot be generated.
+ This will cause a build failure only if the Texinfo source file
+ "groff.texi" is updated and the make(1) "dist" or relevant file
+ targets are manually specified.
* You will need the 'xpmtoppm', 'pnmdepth', and 'pnmtops' programs from
the Netpbm distribution.