include.am 2.9 KB

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