* Move LaTeX docs into a tex/ subdirectory of the doc/ dir

* Add a Makefile in doc/tex/ for generating PDF and HTML
* Add a README.txt file to doc/tex/ to document which tools are used and what
  web sites to visit for getting them.
* Update build_tools/prep_tarball to put the proper Asterisk version string
  in the automatically generated PDF for release tarballs


git-svn-id: http://svn.digium.com/svn/asterisk/trunk@72982 f38db490-d61c-443f-a65b-d21fe96a405b

38 files changed, 61 insertions, 2 deletions

diff --git a/doc/tex/Makefile b/doc/tex/Makefile
new file mode 100644
index 000000000..2ccf892d3
--- /dev/null
+++ b/doc/tex/Makefile
@@ -0,0 +1,35 @@
+include ../../makeopts
+
+pdf: asterisk.pdf
+
+asterisk.pdf: $(wildcard *.tex)
+ifeq ($(findstring rubber,$(RUBBER)),)
+	@echo "**********************************************"
+	@echo "** You must install the \"rubber\" tool      ***"
+	@echo "** to generate the Asterisk reference PDF. ***"
+	@echo "**********************************************"
+else
+	@echo "**********************************************"
+	@echo "** The Asterisk reference PDF will now be  ***"
+	@echo "** generated.  When complete, it will be   ***"
+	@echo "** located at asterisk.pdf.                ***"	
+	@echo "**********************************************"
+	@cp asterisk.tex asterisk.tex.orig
+	@sed -i -e 's/ASTERISKVERSION/$(ASTERISKVERSION)/' asterisk.tex
+	@$(RUBBER) --pdf asterisk.tex
+	@mv asterisk.tex.orig asterisk.tex
+endif
+
+html:
+	@echo "**********************************************"
+	@echo "** The Asterisk reference HTML will now be ***"
+	@echo "** generated.  When complete, it will be   ***"
+	@echo "** located in the asterisk/ directory.     ***"	
+	@echo "** Note that the latex2html tool is        ***"	
+	@echo "** required for this to work.              ***"	
+	@echo "**********************************************"
+	@cp asterisk.tex asterisk.tex.orig
+	@sed -i -e 's/ASTERISKVERSION/$(ASTERISKVERSION)/' asterisk.tex
+	@latex2html asterisk.tex
+	@mv asterisk.tex.orig asterisk.tex
+
diff --git a/doc/tex/README.txt b/doc/tex/README.txt
new file mode 100644
index 000000000..460d330a0
--- /dev/null
+++ b/doc/tex/README.txt
@@ -0,0 +1,24 @@
+Asterisk Reference Documentation
+--------------------------------
+
+1) To generate a PDF from this documentation, you will need the rubber tool,
+   and all of its dependencies.  The web site for this tool is:
+
+      http://www.pps.jussieu.fr/~beffara/soft/rubber/
+
+   Then, once this tool is installed, running "make pdf" will generate
+   the PDF automatically using this tool.  The result will be asterisk.pdf.
+
+   NOTE:  After installing rubber, you will need to re-run the top level
+   configure script.  It checks to see if rubber is installed, so that the
+   asterisk.pdf Makefile target can produce a useful error message when it is
+   not installed.
+
+2) To generate HTML from this documentation, you will need the latex2html tool,
+   and all of its dependencies.  The web site for this tool is:
+
+      http://www.latex2html.org/
+
+   Then, once this tool is installed, running "make html" will generate the
+   HTML documentation.  The result will be an asterisk directory full of
+   HTML files.
diff --git a/doc/ael.tex b/doc/tex/ael.tex
index 416b67e34..416b67e34 100644
--- a/doc/ael.tex
+++ b/doc/tex/ael.tex
diff --git a/doc/ajam.tex b/doc/tex/ajam.tex
index b5e184931..b5e184931 100644
--- a/doc/ajam.tex
+++ b/doc/tex/ajam.tex
diff --git a/doc/app-sms.tex b/doc/tex/app-sms.tex
index b588761d8..b588761d8 100644
--- a/doc/app-sms.tex
+++ b/doc/tex/app-sms.tex
diff --git a/doc/ast_agi_commands.tex b/doc/tex/ast_agi_commands.tex
index 5a63d3a3e..5a63d3a3e 100644
--- a/doc/ast_agi_commands.tex
+++ b/doc/tex/ast_agi_commands.tex
diff --git a/doc/ast_appdocs.tex b/doc/tex/ast_appdocs.tex
index d4f36d4ce..d4f36d4ce 100644
--- a/doc/ast_appdocs.tex
+++ b/doc/tex/ast_appdocs.tex
diff --git a/doc/ast_cli_commands.tex b/doc/tex/ast_cli_commands.tex
index e7e58b4e4..e7e58b4e4 100644
--- a/doc/ast_cli_commands.tex
+++ b/doc/tex/ast_cli_commands.tex
diff --git a/doc/ast_funcdocs.tex b/doc/tex/ast_funcdocs.tex
index 280308b25..280308b25 100644
--- a/doc/ast_funcdocs.tex
+++ b/doc/tex/ast_funcdocs.tex
diff --git a/doc/ast_manager_actiondocs.tex b/doc/tex/ast_manager_actiondocs.tex
index 4c08c2055..4c08c2055 100644
--- a/doc/ast_manager_actiondocs.tex
+++ b/doc/tex/ast_manager_actiondocs.tex
diff --git a/doc/asterisk-conf.tex b/doc/tex/asterisk-conf.tex
index 119a1cc24..119a1cc24 100644
--- a/doc/asterisk-conf.tex
+++ b/doc/tex/asterisk-conf.tex
diff --git a/doc/asterisk.tex b/doc/tex/asterisk.tex
index 10ad7f039..e6bbf3820 100644
--- a/doc/asterisk.tex
+++ b/doc/tex/asterisk.tex
@@ -22,7 +22,7 @@ This document contains various pieces of information that are useful for
 reference purposes.
 
   \section{License Information}
-  \input{../LICENSE}
+  \input{../../LICENSE}
      \subsection{Hold Music}
        Digium has licensed the music included with
        the Asterisk distribution From FreePlayMusic
@@ -81,7 +81,7 @@ reference purposes.
   \section{Introduction}
   \input{dundi.tex}
   \section{Peering Agreement}
-  \input{PEERING}
+  \input{../PEERING}
 
 \chapter{ENUM}
 \input{enum.tex}
diff --git a/doc/billing.tex b/doc/tex/billing.tex
index e1d3131fa..e1d3131fa 100644
--- a/doc/billing.tex
+++ b/doc/tex/billing.tex
diff --git a/doc/cdrdriver.tex b/doc/tex/cdrdriver.tex
index 00c99daea..00c99daea 100644
--- a/doc/cdrdriver.tex
+++ b/doc/tex/cdrdriver.tex
diff --git a/doc/chaniax.tex b/doc/tex/chaniax.tex
index 954e068b0..954e068b0 100644
--- a/doc/chaniax.tex
+++ b/doc/tex/chaniax.tex
diff --git a/doc/channelvariables.tex b/doc/tex/channelvariables.tex
index 8b50d0459..8b50d0459 100644
--- a/doc/channelvariables.tex
+++ b/doc/tex/channelvariables.tex
diff --git a/doc/cliprompt.tex b/doc/tex/cliprompt.tex
index 859943120..859943120 100644
--- a/doc/cliprompt.tex
+++ b/doc/tex/cliprompt.tex
diff --git a/doc/configuration.tex b/doc/tex/configuration.tex
index a501928bb..a501928bb 100644
--- a/doc/configuration.tex
+++ b/doc/tex/configuration.tex
diff --git a/doc/dundi.tex b/doc/tex/dundi.tex
index c932da48c..c932da48c 100644
--- a/doc/dundi.tex
+++ b/doc/tex/dundi.tex
diff --git a/doc/enum.tex b/doc/tex/enum.tex
index 699042d18..699042d18 100644
--- a/doc/enum.tex
+++ b/doc/tex/enum.tex
diff --git a/doc/extensions.tex b/doc/tex/extensions.tex
index 28a49f092..28a49f092 100644
--- a/doc/extensions.tex
+++ b/doc/tex/extensions.tex
diff --git a/doc/freetds.tex b/doc/tex/freetds.tex
index 8dcbec29a..8dcbec29a 100644
--- a/doc/freetds.tex
+++ b/doc/tex/freetds.tex
diff --git a/doc/hardware.tex b/doc/tex/hardware.tex
index 3d7cabd82..3d7cabd82 100644
--- a/doc/hardware.tex
+++ b/doc/tex/hardware.tex
diff --git a/doc/ices.tex b/doc/tex/ices.tex
index 77267b506..77267b506 100644
--- a/doc/ices.tex
+++ b/doc/tex/ices.tex
diff --git a/doc/imapstorage.tex b/doc/tex/imapstorage.tex
index fccdc43bb..fccdc43bb 100644
--- a/doc/imapstorage.tex
+++ b/doc/tex/imapstorage.tex
diff --git a/doc/jitterbuffer.tex b/doc/tex/jitterbuffer.tex
index 5122f1286..5122f1286 100644
--- a/doc/jitterbuffer.tex
+++ b/doc/tex/jitterbuffer.tex
diff --git a/doc/localchannel.tex b/doc/tex/localchannel.tex
index 76cf44566..76cf44566 100644
--- a/doc/localchannel.tex
+++ b/doc/tex/localchannel.tex
diff --git a/doc/manager.tex b/doc/tex/manager.tex
index 4c505ce5e..4c505ce5e 100644
--- a/doc/manager.tex
+++ b/doc/tex/manager.tex
diff --git a/doc/misdn.tex b/doc/tex/misdn.tex
index 3b1ca17ae..3b1ca17ae 100644
--- a/doc/misdn.tex
+++ b/doc/tex/misdn.tex
diff --git a/doc/mp3.tex b/doc/tex/mp3.tex
index b1713fc1d..b1713fc1d 100644
--- a/doc/mp3.tex
+++ b/doc/tex/mp3.tex
diff --git a/doc/odbcstorage.tex b/doc/tex/odbcstorage.tex
index 97d1c94f1..97d1c94f1 100644
--- a/doc/odbcstorage.tex
+++ b/doc/tex/odbcstorage.tex
diff --git a/doc/privacy.tex b/doc/tex/privacy.tex
index eed47644d..eed47644d 100644
--- a/doc/privacy.tex
+++ b/doc/tex/privacy.tex
diff --git a/doc/qos.tex b/doc/tex/qos.tex
index b86107fe5..b86107fe5 100644
--- a/doc/qos.tex
+++ b/doc/tex/qos.tex
diff --git a/doc/queuelog.tex b/doc/tex/queuelog.tex
index dd2047af6..dd2047af6 100644
--- a/doc/queuelog.tex
+++ b/doc/tex/queuelog.tex
diff --git a/doc/queues-with-callback-members.tex b/doc/tex/queues-with-callback-members.tex
index b1a7d8fd2..b1a7d8fd2 100644
--- a/doc/queues-with-callback-members.tex
+++ b/doc/tex/queues-with-callback-members.tex
diff --git a/doc/realtime.tex b/doc/tex/realtime.tex
index c08dbc8a5..c08dbc8a5 100644
--- a/doc/realtime.tex
+++ b/doc/tex/realtime.tex
diff --git a/doc/security.tex b/doc/tex/security.tex
index 188f42cab..188f42cab 100644
--- a/doc/security.tex
+++ b/doc/tex/security.tex
diff --git a/doc/sla.tex b/doc/tex/sla.tex
index efcd6b43f..efcd6b43f 100644
--- a/doc/sla.tex
+++ b/doc/tex/sla.tex