[asterisk-bugs] [Asterisk 0017220]: [patch] Add ability to generate an ASCII document from the TeX files

[Asterisk Bug Tracker]

The following issue has been ASSIGNED. 
====================================================================== 
https://issues.asterisk.org/view.php?id=17220 
====================================================================== 
Reported By:                lmadsen
Assigned To:                lmadsen
====================================================================== 
Project:                    Asterisk
Issue ID:                   17220
Category:                   Documentation
Reproducibility:            N/A
Severity:                   text
Priority:                   normal
Status:                     assigned
Asterisk Version:           SVN 
JIRA:                       SWP-1318 
Regression:                 No 
Reviewboard Link:            
SVN Branch (only for SVN checkouts, not tarball releases): N/A 
SVN Revision (number only!): 258146 
Request Review:              
====================================================================== 
Date Submitted:             2010-04-21 10:55 CDT
Last Modified:              2010-04-21 14:18 CDT
====================================================================== 
Summary:                    [patch] Add ability to generate an ASCII document
from the TeX files
Description: 
I've added the ability to run 'make asterisk.txt' (or 'make txt') just like
the current 'make asterisk.pdf' stuff.

Included in the patch is:

* fixed up several .tex files that weren't escaping characters correctly.
This would lead to Unicode characters in the text file. I've fixed all of
them (there are a few U+0000 and U+00FF stuff in the app_sms.tex file, but
those are on purpose)

* updated the configure script to check for catdvi (used to convert the
latex to text)

* updated the Makefiles

* updated the build_tools/prep_tarball script so that when we build new
releases going forward we'll generate the asterisk.txt file as well.
====================================================================== 

---------------------------------------------------------------------- 
 (0120710) svnbot (reporter) - 2010-04-21 14:18
 https://issues.asterisk.org/view.php?id=17220#c120710 
---------------------------------------------------------------------- 
Repository: asterisk
Revision: 258351

U   trunk/Makefile
U   trunk/build_tools/prep_tarball
U   trunk/configure
U   trunk/configure.ac
_U  trunk/doc/tex/
U   trunk/doc/tex/Makefile
U   trunk/doc/tex/ael.tex
U   trunk/doc/tex/asterisk.tex
U   trunk/doc/tex/cel-doc.tex
U   trunk/doc/tex/enum.tex
U   trunk/doc/tex/localchannel.tex
U   trunk/doc/tex/phoneprov.tex
U   trunk/doc/tex/security-events.tex
U   trunk/include/asterisk/autoconfig.h.in
U   trunk/makeopts.in

------------------------------------------------------------------------
r258351 | lmadsen | 2010-04-21 14:18:36 -0500 (Wed, 21 Apr 2010) | 20
lines

Add ability to generate ASCII documentation from the TeX files.

These changes add the ability to run 'make asterisk.txt' just like the
existing
'make asterisk.pdf' commands to generate a text document from the TeX
files we
have in the doc/tex/ directory. I've also updated a few of the .tex files
because
they weren't properly escaping certain characters so they would show up as
Unicode
characters (like [U+021C]). Made changes to the configure scripts so it
would
detect the catdvi program which is required to convert the .dvi file
generated
by latex.

I've also added a few lines to the build_tools/prep_tarball script so that
the
text documentation gets generated and added to future tarballs of Asterisk
releases.

(closes issue https://issues.asterisk.org/view.php?id=17220)
Reported by: lmadsen
Patches: 
      asterisk.txt.patch uploaded by lmadsen (license 10)
      asterisk.txt.patch-v4 uploaded by pabelanger (license 224)
Tested by: lmadsen, pabelanger
------------------------------------------------------------------------

http://svn.digium.com/view/asterisk?view=rev&revision=258351 

Issue History 
Date Modified    Username       Field                    Change               
====================================================================== 
2010-04-21 14:18 svnbot         Note Added: 0120710                          
2010-04-21 14:18 svnbot         Status                   ready for testing =>
assigned
2010-04-21 14:18 svnbot         Assigned To               => lmadsen         
======================================================================