Add a comment explaining the doc build system

Updated a little by Sebastian
This commit is contained in:
Nick Mathewson 2010-01-20 23:28:32 -05:00 committed by Sebastian Hahn
parent 0c81d4c62b
commit e407c1adab

View File

@ -1,3 +1,18 @@
# We use a two-step process to generate documentation from asciidoc files.
#
# First, we use asciidoc/a2x to process the asciidoc files into .1.in and
# .html.in files (see the asciidoc-helper.sh script). These are the same as
# the regular .1 and .html files, except that they still have some autoconf
# variables set in them.
#
# Second, we use config.status to turn .1.in files into .1 files and
# .html.in files into .html files.
#
# We do the steps in this order so that we can ship the .*.in files as
# part of the source distribution, so that people without asciidoc can
# just use the .1 and .html files.
asciidoc_files = tor tor-gencert tor-resolve torify
html_in = $(asciidoc_files:=.html.in)