Index: build_tools/prep_tarball =================================================================== --- build_tools/prep_tarball (revision 258343) +++ build_tools/prep_tarball (working copy) @@ -15,6 +15,8 @@ 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 } Index: configure.ac =================================================================== --- configure.ac (revision 258343) +++ configure.ac (working copy) @@ -197,6 +197,7 @@ AC_PATH_PROG([WGET], [wget], :) AC_PATH_PROG([CURL], [curl], :) AC_PATH_PROG([RUBBER], [rubber], :) +AC_PATH_PROG([CATDVI], [catdvi], :) AC_PATH_PROG([KPATHSEA], [kpsewhich], :) AC_PATH_PROG([XMLSTARLET], [xmlstarlet], :) if test "${WGET}" != ":" ; then Index: doc/tex/localchannel.tex =================================================================== --- doc/tex/localchannel.tex (revision 258343) +++ doc/tex/localchannel.tex (working copy) @@ -383,11 +383,13 @@ This following dialplan will not perform as expected. +\begin{verbatim} [services] exten => 2,1,Dial(SIP/PHONE\_B,,L(60000:45000:15000)) [internal] -exten => 4,1,Dial(Local/2@services); +exten => 4,1,Dial(Local/2@services) +\end{verbatim} By default, the Local channel will try to optimize itself out of the call path. This means that once the Local channel has established the call between the Index: doc/tex/enum.tex =================================================================== --- doc/tex/enum.tex (revision 258343) +++ doc/tex/enum.tex (working copy) @@ -53,7 +53,7 @@ ALL. Default type is "sip". Special name of "ALL" will create a list of method types across all NAPTR records for the search number, and then put the results - in an ordinal list starting with 1. The position + in an ordinal list starting with 1. The position $<$number$>$ specified will then be returned, starting with 1 as the first record (lowest value) in the list. The service types are not hardcoded in Asterisk except for the default (sip) if no other @@ -75,11 +75,11 @@ \item record\# \begin{itemize} \item which record to present if multiple answers are returned - = The record in priority/order sequence based on the + $<$integer$>$ = The record in priority/order sequence based on the total count of records passed back by the query. If a service\_type is specified, all entries of that type will be sorted into an ordinal list starting with 1 (by order first, then priority). - The default of is "1" + The default of $<$options$>$ is "1" \end{itemize} \item zone\_suffix Index: doc/tex/cel-doc.tex =================================================================== --- doc/tex/cel-doc.tex (revision 258343) +++ doc/tex/cel-doc.tex (working copy) @@ -141,7 +141,7 @@ "EV\_CHAN\_END","2007-05-09 12:49:26","","151","152","","","","extension","Zap/51-1","Bridged Call","Zap/50-1","DOCUMENTATION","","1178736378.4","","" ;;; 151 channel ends -"EV\_CHAN\_END","2007-05-09 12:49:26","fxs.51","151","151","","","h","extension","Zap/51-2","","","DOCUMENTATION","","1178736428.5","","" ;;; 152-2 channel ends (zombie) +"EV\_CHAN\_END","2007-05-09 12:49:26","fxs.51","151","151","","","h","extension","Zap/51-2$<$ZOMBIE$>$","","","DOCUMENTATION","","1178736428.5","","" ;;; 152-2 channel ends (zombie) {\it (just 150 and 152 now)} @@ -820,9 +820,9 @@ correspond to the following two CDR records (at the moment!): \begin{astlisting} -""fxs.52" <152>","152","h","extension","Zap/52-1","Zap/51-1","NoOp","More Hangup message after hopping around"","2007-05-09 17:35:56","2007-05-09 17:36:20","2007-05-09 17:36:36","40","16","ANSWERED","DOCUMENTATION","","1178753756.0","" +""fxs.52" $<$152$>$","152","h","extension","Zap/52-1","Zap/51-1","NoOp","More Hangup message after hopping around"","2007-05-09 17:35:56","2007-05-09 17:36:20","2007-05-09 17:36:36","40","16","ANSWERED","DOCUMENTATION","","1178753756.0","" -""fxs.50" <150>","150","152","extension","Zap/50-1","Zap/51-1","NoOp","More Hangup message after hopping around"","2007-05-09 17:37:59","2007-05-09 17:38:06","2007-05-09 17:39:11","72","65","ANSWERED","DOCUMENTATION","","1178753871.3","" +""fxs.50" $<$150$>$","150","152","extension","Zap/50-1","Zap/51-1","NoOp","More Hangup message after hopping around"","2007-05-09 17:37:59","2007-05-09 17:38:06","2007-05-09 17:39:11","72","65","ANSWERED","DOCUMENTATION","","1178753871.3","" \end{astlisting} Index: doc/tex/security-events.tex =================================================================== --- doc/tex/security-events.tex (revision 258343) +++ doc/tex/security-events.tex (working copy) @@ -147,7 +147,7 @@ [Feb 11 07:57:03] SECURITY[23736] res_security_log.c: <...> \end{verbatim} - The part of the log entry identified by <...> is where the security event + The part of the log entry identified by $<$...$>$ is where the security event content resides. The security event content is a comma separated list of key value pairs. The key is the information element type, and the value is a quoted string that contains the associated meta data for that information Index: doc/tex/Makefile =================================================================== --- doc/tex/Makefile (revision 258343) +++ doc/tex/Makefile (working copy) @@ -44,3 +44,32 @@ @latex2html asterisk.tex @mv asterisk.tex.orig asterisk.tex +txt: asterisk.txt + +asterisk.txt: $(wildcard *.tex) +ifeq ($(findstring catdvi,$(CATDVI)),) + @echo "**********************************************" + @echo "** You must install the \"catdvi\" tool ***" + @echo "** to generate the Asterisk reference TXT. ***" + @echo "**********************************************" +else + @echo "**********************************************" + @echo "** The Asterisk reference TXT will now be ***" + @echo "** generated. When complete, it will be ***" + @echo "** located at asterisk.txt. ***" + @echo "**********************************************" +ifneq ($(findstring kpsewhich,$(KPATHSEA)),) +ifeq ($(findstring fncychap.sty,$(shell find `$(KPATHSEA) --expand-braces='$${TEXMF}'| tr -d \! | sed 's/:/ /g'` -name fncychap.sty -print)),) + @echo + @echo "WARNING: The fncychap.sty document was not found" + @echo "On Ubuntu, install the texlive-latex-extra package." + @echo + @exit +endif + @cp asterisk.tex asterisk.tex.orig + @sed -e 's/ASTERISKVERSION/$(ASTERISKVERSION)/' asterisk.tex > asterisk_local.tex + @mv asterisk_local.tex 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 + @mv asterisk.tex.orig asterisk.tex +endif Index: doc/tex/phoneprov.tex =================================================================== --- doc/tex/phoneprov.tex (revision 258343) +++ doc/tex/phoneprov.tex (working copy) @@ -79,7 +79,7 @@ Since phone-specific config files generally have file names based on phone-specifc data, dynamic filenames in res\_phoneprov can be defined with Asterisk dialplan function and -variable substitution. In the above example, \$\{TOLOWER(\$\{MAC\})\}.cfg $\Rightarrow$ +variable substitution. In the above example, \$\{TOLOWER(\$\{MAC\})\}.cfg =$>$ 000000000000.cfg would define a relative URI to be served that matches the format of MACADDRESS.cfg, all lower case. A request for that file would then point to the template found at AST\_DATA\_DIR/phoneprov/000000000000.cfg. The template can be followed by a @@ -96,8 +96,8 @@ dynamic filename. NOTE: Any dialplan function that is used for generation of dynamic file names MUST be -loaded before res\_phoneprov. Add "preload $\Rightarrow$ modulename.so" to -\path{modules.conf} for required functions. In the example above, "preload $\Rightarrow$ +loaded before res\_phoneprov. Add "preload =$>$ modulename.so" to +\path{modules.conf} for required functions. In the example above, "preload =$>$ func\_strings.so" would be required. \section{Configuration of users.conf} Index: doc/tex/ael.tex =================================================================== --- doc/tex/ael.tex (revision 258343) +++ doc/tex/ael.tex (working copy) @@ -128,7 +128,7 @@ To reload extensions.ael, the following command can be issued at the CLI: - *CLI> ael reload + *CLI$>$ ael reload \section{Debugging} @@ -735,7 +735,7 @@ NOTE: These things are wrapped up in a \$[ ] expression: The while() test; the if() test; the middle expression in the for( x; y; z) statement -(the y expression); Assignments - the right hand side, so a = b -> Set(a=\$[b]) +(the y expression); Assignments - the right hand side, so a = b -$>$ Set(a=\$[b]) Writing to a dialplan function is treated the same as writing to a variable. Index: Makefile =================================================================== --- Makefile (revision 258343) +++ Makefile (working copy) @@ -987,6 +987,10 @@ 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 Index: makeopts.in =================================================================== --- makeopts.in (revision 258343) +++ makeopts.in (working copy) @@ -25,6 +25,7 @@ FETCH=@FETCH@ DOWNLOAD=@DOWNLOAD@ RUBBER=@RUBBER@ +CATDVI=@CATDVI@ KPATHSEA=@KPATHSEA@ XMLSTARLET=@XMLSTARLET@ MD5=@MD5@