doc/Makefile.am

   1
   2 # We use a two-step process to generate documentation from asciidoc files.
   3 #
   4 # First, we use asciidoc/a2x to process the asciidoc files into .1.in and
   5 # .html.in files (see the asciidoc-helper.sh script). These are the same as
   6 # the regular .1 and .html files, except that they still have some autoconf
   7 # variables set in them.
   8 #
   9 # Second, we use config.status to turn .1.in files into .1 files and
  10 # .html.in files into .html files.
  11 #
  12 # We do the steps in this order so that we can ship the .*.in files as
  13 # part of the source distribution, so that people without asciidoc can
  14 # just use the .1 and .html files.
  15
  16 asciidoc_files = tor tor-gencert tor-resolve torify
  17
  18 html_in = $(asciidoc_files:=.html.in)
  19
  20 man_in = $(asciidoc_files:=.1.in)
  21
  22 EXTRA_DIST = HACKING                                         \
  23              $(html_in) $(man_in) $(asciidoc_files:=.1.txt)  \
  24              tor-osx-dmg-creation.txt tor-rpm-creation.txt   \
  25              tor-win32-mingw-creation.txt
  26
  27 nodist_man_MANS = $(asciidoc_files:=.1)
  28
  29 docdir = @docdir@
  30
  31 doc_DATA = $(asciidoc_files:=.html)
  32
  33 asciidoc_product = $(nodist_man_MANS) $(doc_DATA)
  34
  35 SUBDIRS = spec
  36
  37 DIST_SUBDIRS = spec
  38
  39 # Generate the html documentation from asciidoc, but don't do
  40 # machine-specific replacements yet
  41 $(html_in) :
  42         $(top_srcdir)/doc/asciidoc-helper.sh html @ASCIIDOC@ @SED@ $(top_srcdir)/doc/$@
  43
  44 tor.html.in : tor.1.txt
  45 torify.html.in : torify.1.txt
  46 tor-gencert.html.in : tor-gencert.1.txt
  47 tor-resolve.html.in : tor-resolve.1.txt
  48
  49 # Generate the manpage from asciidoc, but don't do
  50 # machine-specific replacements yet
  51 $(man_in) :
  52         $(top_srcdir)/doc/asciidoc-helper.sh man @A2X@ @SED@ $(top_srcdir)/doc/$@
  53
  54 tor.1.in : tor.1.txt
  55 torify.1.in : torify.1.txt
  56 tor-gencert.1.in : tor-gencert.1.txt
  57 tor-resolve.1.in : tor-resolve.1.txt
  58
  59 # use ../config.status to swap all machine-specific magic strings
  60 # in the asciidoc with their replacements.
  61 $(asciidoc_product) :
  62         if test -e $(top_srcdir)/doc/$@.in && ! test -e ./$@.in ; then \
  63                 cp $(top_srcdir)/doc/$@.in .; \
  64         fi
  65         ../config.status --file=$@;
  66
  67 tor.1 : tor.1.in
  68 torify.1 : torify.1.in
  69 tor-gencert.1 : tor-gencert.1.in
  70 tor-resolve.1 : tor-resolve.1.in
  71 tor.html : tor.html.in
  72 torify.html : torify.html.in
  73 tor-gencert.html : tor-gencert.html.in
  74 tor-resolve.html : tor-resolve.html.in
  75
  76 CLEANFILES = $(asciidoc_product)
  77 DISTCLEANFILES = $(html_in) $(man_in)