source/doc/Makefile.am

   1 ## Makefile.am for the TeX Live subdirectory ./doc/
   2 ##
   3 ## Copyright 2013-2015 Peter Breitenlohner <tex-live@tug.org>
   4 ## You may freely use, modify and/or distribute this file.
   5 ##
   6 ## The info files
   7 info_TEXINFOS = tlbuild.texi
   8 tlbuild_TEXINFOS = build-tools.txt \
   9   tlbuild-incl/install-tl.texi tlbuild-incl/tlmgr.texi
  10
  11 EXTRA_DIST = \
  12         README.solaris \
  13         splitinfo.gawk
  14
  15 # no reasonable way to avoid it with the pod doc.
  16 MAKEINFOFLAGS = --set INFO_SPECIAL_CHARS_WARNING=0
  17
  18 # \f autogenerate the top-level README files.
  19 readme-files: tlbuild.info
  20         rm -f README.*
  21         $(MAKEINFO) $(MAKEINFOFLAGS) --plaintext -o - $(srcdir)/tlbuild.texi \
  22         | tee /tmp/a \
  23         | gawk -f $(srcdir)/splitinfo.gawk
  24         ls -l README.*
  25 #       head -8 README.*
  26 readme-install: readme-files
  27         cp -p README.* $(top_srcdir)/
  28         svn diff $(top_srcdir)/README.* >/tmp/sd
  29         svn status $(top_srcdir)/README.*
  30 #
  31 .PHONY: readme-files readme-install
  32
  33 # \f autogenerate texinfo from install-tl and tlmgr pod.
  34 # none of this is intended to be executed except manually.
  35 mydoc = tlbuild
  36
  37 # until the next texinfo release, need development texinfo
  38 # for --appendix-sections.
  39 texinfo_dir = $(HOME)/gnu/src/texinfo
  40 pod2texi = perl $(texinfo_dir)/Pod-Simple-Texinfo/pod2texi.pl
  41 pod2texi_args = \
  42   --appendix-sections \
  43   --base-level=section \
  44   --no-fill-section-gaps \
  45   --preamble=''
  46
  47 # We use a complicated L<> section reference in the tlmgr pod,
  48 # schematically like this:
  49 #   L<whatever|/mysec I<myital>>
  50 # Unfortunately, the Pod module does not pass the necessary information
  51 # in the callbacks to allow pod2texi to preserve the I<>.  It seems
  52 # better to kludge in some substitutions here than reimplement a whole
  53 # pod parser.  Sigh.
  54 #
  55 update_node_bad  = ref{tlmgr update [option]... [pkg]...
  56 update_node_good = ref{tlmgr update [\@emph{option}]... [\@emph{pkg}]...
  57 install_node_bad = ref{tlmgr install [option]... pkg...
  58 install_node_good = ref{tlmgr install [\@emph{option}]... \@emph{pkg}...
  59
  60 # we don't actually use the (autogenerated) -incl.texi file,
  61 # but it makes for a convenient target.
  62 $(mydoc)-incl.texi: install-tl tlmgr.pl
  63         $(pod2texi) -o $@ --subdir=$(mydoc)-incl $(pod2texi_args) $^
  64         perl -pi \
  65           -e 's/\Q$(update_node_bad)\E/$(update_node_good)/' \
  66           -e ';' \
  67           -e 's/\Q$(install_node_bad)\E/$(install_node_good)/' \
  68           $(mydoc)-incl/tlmgr.texi
  69 .PHONY: $(mydoc)-incl.texi