[asterisk-commits] russell: branch 1.8 r294740 - in /branches/1.8: ./ build_tools/ doc/ doc/tex/

[SVN commits to the Asterisk project]

Author: russell
Date: Thu Nov 11 16:13:38 2010
New Revision: 294740

URL: http://svnview.digium.com/svn/asterisk?view=rev&rev=294740
Log:
Remove most of the contents of the doc dir in favor of the wiki content.

This merge does the following things:

 * Removes most of the contents from the doc/ directory in favor
   of the wiki - http://wiki.asterisk.org/

 * Updates the build_tools/prep_tarball script to know how to export
   the contents of the wiki in both PDF and plain text formats so that
   the documentation is still included in Asterisk release tarballs.

Added:
    branches/1.8/doc/README.txt
      - copied unchanged from r294738, team/russell/1.8-docdir/doc/README.txt
Removed:
    branches/1.8/doc/CODING-GUIDELINES
    branches/1.8/doc/HOWTO_collect_debug_information.txt
    branches/1.8/doc/India-CID.txt
    branches/1.8/doc/PEERING
    branches/1.8/doc/advice_of_charge.txt
    branches/1.8/doc/asterisk-mib.txt
    branches/1.8/doc/backtrace.txt
    branches/1.8/doc/building_queues.txt
    branches/1.8/doc/callfiles.txt
    branches/1.8/doc/chan_sip-perf-testing.txt
    branches/1.8/doc/cli.txt
    branches/1.8/doc/codec-64bit.txt
    branches/1.8/doc/database_transactions.txt
    branches/1.8/doc/datastores.txt
    branches/1.8/doc/digium-mib.txt
    branches/1.8/doc/distributed_devstate-XMPP.txt
    branches/1.8/doc/distributed_devstate.txt
    branches/1.8/doc/externalivr.txt
    branches/1.8/doc/followme.txt
    branches/1.8/doc/google-soc2009-ideas.txt
    branches/1.8/doc/hoard.txt
    branches/1.8/doc/jabber.txt
    branches/1.8/doc/janitor-projects.txt
    branches/1.8/doc/jingle.txt
    branches/1.8/doc/ldap.txt
    branches/1.8/doc/macroexclusive.txt
    branches/1.8/doc/manager_1_1.txt
    branches/1.8/doc/modules.txt
    branches/1.8/doc/osp.txt
    branches/1.8/doc/queue.txt
    branches/1.8/doc/realtimetext.txt
    branches/1.8/doc/res_config_sqlite.txt
    branches/1.8/doc/rtp-packetization.txt
    branches/1.8/doc/sip-retransmit.txt
    branches/1.8/doc/siptls.txt
    branches/1.8/doc/smdi.txt
    branches/1.8/doc/sms.txt
    branches/1.8/doc/snmp.txt
    branches/1.8/doc/speechrec.txt
    branches/1.8/doc/ss7.txt
    branches/1.8/doc/tex/
    branches/1.8/doc/timing.txt
    branches/1.8/doc/unistim.txt
    branches/1.8/doc/valgrind.txt
    branches/1.8/doc/video.txt
    branches/1.8/doc/video_console.txt
    branches/1.8/doc/voicemail_odbc_postgresql.txt
Modified:
    branches/1.8/Makefile
    branches/1.8/build_tools/prep_tarball

Modified: branches/1.8/Makefile
URL: http://svnview.digium.com/svn/asterisk/branches/1.8/Makefile?view=diff&rev=294740&r1=294739&r2=294740
==============================================================================
--- branches/1.8/Makefile (original)
+++ branches/1.8/Makefile Thu Nov 11 16:13:38 2010
@@ -922,14 +922,6 @@
 	@cat sounds/sounds.xml >> $@
 	@echo "</menu>" >> $@
 
-pdf: asterisk.pdf
-asterisk.pdf:
-	$(MAKE) -C doc/tex asterisk.pdf
-
-txt: asterisk.txt
-asterisk.txt:
-	$(MAKE) -C doc/tex asterisk.txt
-
 .PHONY: menuselect
 .PHONY: main
 .PHONY: sounds
@@ -942,7 +934,6 @@
 .PHONY: uninstall
 .PHONY: _uninstall
 .PHONY: uninstall-all
-.PHONY: pdf
 .PHONY: dont-optimize
 .PHONY: badshell
 .PHONY: installdirs

Modified: branches/1.8/build_tools/prep_tarball
URL: http://svnview.digium.com/svn/asterisk/branches/1.8/build_tools/prep_tarball?view=diff&rev=294740&r1=294739&r2=294740
==============================================================================
--- branches/1.8/build_tools/prep_tarball (original)
+++ branches/1.8/build_tools/prep_tarball Thu Nov 11 16:13:38 2010
@@ -8,18 +8,8 @@
 make -C sounds MENUSELECT_CORE_SOUNDS=CORE-SOUNDS-EN-GSM MENUSELECT_MOH=MOH-OPSOUND-WAV WGET=wget DOWNLOAD=wget all
 make AWK=awk GREP=grep menuselect-tree
 
-make_tex_docs() {
-    # make backup of asterisk.tex because we are going to alter it
-    cp asterisk.tex asterisk.tex.orig
-    sed -e "s/ASTERISKVERSION/${VERSION}/" asterisk.tex > asterisk_local.tex
-    mv asterisk_local.tex asterisk.tex
-    rubber --pdf asterisk.tex
-    latex2html asterisk.tex
-    latex asterisk.tex
-    catdvi -e 1 -U asterisk.dvi | sed -re "s/\[U\+2022\]/*/g" | sed -re "s/\[U\+02C6\]/^/g" | sed -re "s/([^^[:space:]])\s+/\1 /g" > asterisk.txt
-    # restore backup of asterisk.tex
-    mv asterisk.tex.orig asterisk.tex
-}
-
-VERSION=`cat .version`
-cd doc/tex && make_tex_docs
+cd doc
+echo "Exporting Asterisk wiki to a PDF (this will take a minute) ..."
+wikiexport.py
+echo "Converting wiki export PDF to plain text ..."
+pdftotext AST.pdf