Many doc directory improvements, including:
[asterisk/asterisk.git] / doc / tex / channelvariables.tex
index 77fcca4..1dfcfc2 100644 (file)
@@ -4,8 +4,8 @@ There are two levels of parameter evaluation done in the Asterisk
 dial plan in extensions.conf.
 \begin{enumerate}
 \item The first, and most frequently used, is the substitution of variable
-  references with their values. 
-\item Then there are the evaluations of expressions done in \$[ .. ]. 
+  references with their values.
+\item Then there are the evaluations of expressions done in \$[ .. ].
   This will be discussed below.
 \end{enumerate}
 Asterisk has user-defined variables and standard variables set
@@ -16,69 +16,69 @@ listed at the end of this document.
 \begin{verbatim}
 exten => s,5,BackGround,blabla
 \end{verbatim}
-The parameter (blabla) can be quoted ("blabla"). In this case, a 
+The parameter (blabla) can be quoted ("blabla"). In this case, a
 comma does not terminate the field. However, the double quotes
 will be passed down to the Background command, in this example.
 
 Also, characters special to variable substitution, expression evaluation, etc
-(see below), can be quoted. For example, to literally use a \$ on the 
-string "\$1231", quote it with a preceding \\. Special characters that must
-be quoted to be used, are [ ] \$ " \\. (to write \\ itself, use \\). 
+(see below), can be quoted. For example, to literally use a \$ on the
+string "\$1231", quote it with a preceding \textbackslash. Special characters that must
+be quoted to be used, are [ ] \$ " \textbackslash. (to write \textbackslash itself, use \textbackslash).
 
 These Double quotes and escapes are evaluated at the level of the
-asterisk config file parser. 
+asterisk config file parser.
 
 Double quotes can also be used inside expressions, as discussed below.
 
 \section{Variables}
 
-Parameter strings can include variables. Variable names are arbitrary strings. 
-They are stored in the respective channel structure. 
+Parameter strings can include variables. Variable names are arbitrary strings.
+They are stored in the respective channel structure.
 
-To set a variable to a particular value, do : 
+To set a variable to a particular value, do:
 \begin{verbatim}
     exten => 1,2,Set(varname=value)
 \end{verbatim}
 You can substitute the value of a variable everywhere using \${variablename}.
-For example, to stringwise append \$lala to \$blabla and store result in \$koko, 
-do: 
+For example, to stringwise append \$lala to \$blabla and store result in \$koko,
+do:
 \begin{verbatim}
    exten => 1,2,Set(koko=${blabla}${lala})
 \end{verbatim}
 
-There are two reference modes - reference by value and reference by name. 
-To refer to a variable with its name (as an argument to a function that 
-requires a variable), just write the name. To refer to the variable's value, 
-enclose it inside \${}. For example, Set takes as the first argument 
-(before the =) a variable name, so: 
+There are two reference modes - reference by value and reference by name.
+To refer to a variable with its name (as an argument to a function that
+requires a variable), just write the name. To refer to the variable's value,
+enclose it inside \${}. For example, Set takes as the first argument
+(before the =) a variable name, so:
 \begin{verbatim}
-       exten => 1,2,Set(koko=lala)
-       exten => 1,3,Set(${koko}=blabla)
+  exten => 1,2,Set(koko=lala)
+  exten => 1,3,Set(${koko}=blabla)
 \end{verbatim}
-stores to the variable "koko" the value "lala" and to variable "lala" the 
-value "blabla". 
+stores to the variable "koko" the value "lala" and to variable "lala" the
+value "blabla".
 
-In fact, everything contained \${here} is just replaced with the value of 
-the variable "here". 
+In fact, everything contained \${here} is just replaced with the value of
+the variable "here".
 
 \section{Variable Inheritance}
 
-Variable names which are prefixed by "\_" will be inherited to channels 
-that are created in the process of servicing the original channel in 
-which the variable was set.  When the inheritance takes place, the 
-prefix will be removed in the channel inheriting the variable.  If the 
-name is prefixed by "\_\_" in the channel, then the variable is 
+Variable names which are prefixed by "\_" will be inherited to channels
+that are created in the process of servicing the original channel in
+which the variable was set.  When the inheritance takes place, the
+prefix will be removed in the channel inheriting the variable.  If the
+name is prefixed by "\_\_" in the channel, then the variable is
 inherited and the "\_\_" will remain intact in the new channel.
 
-In the dialplan, all references to these variables refer to the same 
-variable, regardless of having a prefix or not.  Note that setting any 
-version of the variable removes any other version of the variable, 
+In the dialplan, all references to these variables refer to the same
+variable, regardless of having a prefix or not.  Note that setting any
+version of the variable removes any other version of the variable,
 regardless of prefix.
 
 \subsection{Example}
 \begin{verbatim}
-Set(__FOO=bar) ; Sets an inherited version of "FOO" variable 
-Set(FOO=bar)   ; Removes the inherited version and sets a local 
+Set(__FOO=bar) ; Sets an inherited version of "FOO" variable
+Set(FOO=bar)   ; Removes the inherited version and sets a local
                ; variable.
 
 However,
@@ -91,35 +91,35 @@ NoOp(${__FOO}) is identical to NoOp(${FOO})
 
 The format for selecting characters from a variable can be expressed as:
 \begin{verbatim}
-       ${variable_name[:offset[:length]]}
+  ${variable_name[:offset[:length]]}
 \end{verbatim}
 If you want to select the first N characters from the string assigned
 to a variable, simply append a colon and the number of characters to
 skip from the beginning of the string to the variable name.
 \begin{verbatim}
-       ;Remove the first character of extension, save in "number" variable
-       exten => _9X.,1,Set(number=${EXTEN:1})
+  ; Remove the first character of extension, save in "number" variable
+  exten => _9X.,1,Set(number=${EXTEN:1})
 \end{verbatim}
 Assuming we've dialed 918005551234, the value saved to the 'number' variable
-would be 18005551234. This is useful in situations when we require users to 
-dial a number to access an outside line, but do not wish to pass the first 
+would be 18005551234. This is useful in situations when we require users to
+dial a number to access an outside line, but do not wish to pass the first
 digit.
 
-If you use a negative offset number, Asterisk starts counting from the end 
+If you use a negative offset number, Asterisk starts counting from the end
 of the string and then selects everything after the new position. The following
 example will save the numbers 1234 to the 'number' variable, still assuming
 we've dialed 918005551234.
 \begin{verbatim}
-       ;Remove everything before the last four digits of the dialed string
-       exten => _9X.,1,Set(number=${EXTEN:-4})
+  ; Remove everything before the last four digits of the dialed string
+  exten => _9X.,1,Set(number=${EXTEN:-4})
 \end{verbatim}
 We can also limit the number of characters from our offset position that we
 wish to use. This is done by appending a second colon and length value to the
 variable name. The following example will save the numbers 555 to the 'number'
 variable.
 \begin{verbatim}
-       ;Only save the middle numbers 555 from the string 918005551234
-       exten => _9X.,1,Set(number=${EXTEN:5:3})
+  ; Only save the middle numbers 555 from the string 918005551234
+  exten => _9X.,1,Set(number=${EXTEN:5:3})
 \end{verbatim}
 The length value can also be used in conjunction with a negative offset. This
 may be useful if the length of the string is unknown, but the trailing digits
@@ -127,23 +127,23 @@ are. The following example will save the numbers 555 to the 'number' variable,
 even if the string starts with more characters than expected (unlike the
 previous example).
 \begin{verbatim}
-       ;Save the numbers 555 to the 'number' variable
-       exten => _9X.,1,Set(number=${EXTEN:-7:3})
+  ; Save the numbers 555 to the 'number' variable
+  exten => _9X.,1,Set(number=${EXTEN:-7:3})
 \end{verbatim}
 If a negative length value is entered, Asterisk will remove that many characters
 from the end of the string.
 \begin{verbatim}
-       ;Set pin to everything but the trailing #.
-       exten => _XXXX#,1,Set(pin=${EXTEN:0:-1})
+  ; Set pin to everything but the trailing #.
+  exten => _XXXX#,1,Set(pin=${EXTEN:0:-1})
 \end{verbatim}
 
-\section{Expressions} 
+\section{Expressions}
 
-Everything contained inside a bracket pair prefixed by a \$ (like \$[this]) is 
-considered as an expression and it is evaluated. Evaluation works similar to 
-(but is done on a later stage than) variable substitution: the expression 
-(including the square brackets) is replaced by the result of the expression 
-evaluation. 
+Everything contained inside a bracket pair prefixed by a \$ (like \$[this]) is
+considered as an expression and it is evaluated. Evaluation works similar to
+(but is done on a later stage than) variable substitution: the expression
+(including the square brackets) is replaced by the result of the expression
+evaluation.
 
 For example, after the sequence:
 \begin{verbatim}
@@ -170,10 +170,10 @@ The double quotes will be counted as part of that lexical token.
 As an example:
 
 \begin{verbatim}
-exten => s,6,GotoIf($[ "${CALLERIDNAME}" : "Privacy Manager" ]?callerid-liar|s|1:s|7)
+exten => s,6,GotoIf($[ "${CALLERID(name)}" : "Privacy Manager" ]?callerid-liar,s,1:s,7)
 \end{verbatim}
 
-The variable CALLERIDNAME could evaluate to "DELOREAN MOTORS" (with a space)
+The variable CALLERID(name) could evaluate to "DELOREAN MOTORS" (with a space)
 but the above will evaluate to:
 
 \begin{verbatim}
@@ -189,7 +189,7 @@ DELOREAN MOTORS : Privacy Manager
 \end{verbatim}
 
 and will result in syntax errors, because token DELOREAN is immediately
-followed by token MOTORS and the expression parser will not know how to 
+followed by token MOTORS and the expression parser will not know how to
 evaluate this expression, because it does not match its grammar.
 
 \subsection{Operators}
@@ -197,109 +197,119 @@ evaluate this expression, because it does not match its grammar.
 Operators are listed below in order of increasing precedence.  Operators
 with equal precedence are grouped within { } symbols.
 
-\begin{verbatim}
-     expr1 | expr2
-             Return the evaluation of expr1 if it is neither an empty string
-             nor zero; otherwise, returns the evaluation of expr2.
-
-     expr1 & expr2
-             Return the evaluation of expr1 if neither expression evaluates to
-             an empty string or zero; otherwise, returns zero.
-
-     expr1 {=, >, >=, <, <=, !=} expr2
-             Return the results of floating point comparison if both arguments are
-             numbers; otherwise, returns the results of string comparison
-             using the locale-specific collation sequence.  The result of each
-             comparison is 1 if the specified relation is true, or 0 if the
-             relation is false.
-
-     expr1 {+, -} expr2
-             Return the results of addition or subtraction of floating point-valued
-             arguments.
-
-     expr1 {*, /, %} expr2
-             Return the results of multiplication, floating point division, or
-             remainder of arguments.
-
-     - expr1
-            Return the result of subtracting expr1 from 0.
-            This, the unary minus operator, is right associative, and
-            has the same precedence as the ! operator.
-
-     ! expr1
-            Return the result of a logical complement of expr1.
-            In other words, if expr1 is null, 0, an empty string,
-            or the string "0", return a 1. Otherwise, return a 0.
-            It has the same precedence as the unary minus operator, and
-            is also right associative.
-
-     expr1 : expr2
-             The `:' operator matches expr1 against expr2, which must be a
-             regular expression.  The regular expression is anchored to the
-             beginning of  the string with an implicit `^'.
-
-             If the match succeeds and the pattern contains at least one regu-
-             lar expression subexpression `\(...\)', the string correspond-
-             ing to `\1' is returned; otherwise the matching operator
-             returns the number of characters matched.  If the match fails and
-             the pattern contains a regular expression subexpression the null
-             string is returned; otherwise 0.
-
-             Normally, the double quotes wrapping a string are left as part
-             of the string. This is disastrous to the : operator. Therefore,
-             before the regex match is made, beginning and ending double quote
-             characters are stripped from both the pattern and the string.
-
-      expr1 =~ expr2
-             Exactly the same as the ':' operator, except that the match is
-             not anchored to the beginning of the string. Pardon any similarity
-             to seemingly similar operators in other programming languages!
-             The ":" and "=~" operators share the same precedence.
-
-      expr1 ? expr2 :: expr3
-             Traditional Conditional operator. If expr1 is a number
-            that evaluates to 0 (false), expr3 is result of the this
-            expression evaluation.  Otherwise, expr2 is the result.
-            If expr1 is a string, and evaluates to an empty string,
-            or the two characters (""), then expr3 is the
-            result. Otherwise, expr2 is the result.  In Asterisk, all
-            3 exprs will be "evaluated"; if expr1 is "true", expr2
-            will be the result of the "evaluation" of this
-            expression.  expr3 will be the result otherwise. This
-            operator has the lowest precedence.
-\end{verbatim}
+\begin{itemize}
+  \item \verb!expr1 | expr2!
+
+       Return the evaluation of expr1 if it is neither an empty string
+       nor zero; otherwise, returns the evaluation of expr2.
+
+  \item \verb!expr1 & expr2!
+
+       Return the evaluation of expr1 if neither expression evaluates to
+       an empty string or zero; otherwise, returns zero.
+
+  \item \verb+expr1 {=, >, >=, <, <=, !=} expr2+
+
+       Return the results of floating point comparison if both arguments are
+       numbers; otherwise, returns the results of string comparison
+       using the locale-specific collation sequence.  The result of each
+       comparison is 1 if the specified relation is true, or 0 if the
+       relation is false.
+
+  \item \verb!expr1 {+, -} expr2!
+
+       Return the results of addition or subtraction of floating point-valued
+       arguments.
+
+  \item \verb!expr1 {*, /, %} expr2!
+
+       Return the results of multiplication, floating point division, or
+       remainder of arguments.
+
+  \item \verb!- expr1!
+
+       Return the result of subtracting expr1 from 0.
+       This, the unary minus operator, is right associative, and
+       has the same precedence as the ! operator.
+
+  \item \verb+! expr1+
+
+       Return the result of a logical complement of expr1.
+       In other words, if expr1 is null, 0, an empty string,
+       or the string "0", return a 1. Otherwise, return a 0.
+       It has the same precedence as the unary minus operator, and
+       is also right associative.
+
+  \item \verb!expr1 : expr2!
+
+       The `:' operator matches expr1 against expr2, which must be a
+       regular expression.  The regular expression is anchored to the
+       beginning of  the string with an implicit `\^'.
+
+       If the match succeeds and the pattern contains at least one regular
+       expression subexpression `\(...\)', the string corresponing
+       to `\textbackslash1' is returned; otherwise the matching operator
+       returns the number of characters matched.  If the match fails and
+       the pattern contains a regular expression subexpression the null
+       string is returned; otherwise 0.
+
+       Normally, the double quotes wrapping a string are left as part
+       of the string. This is disastrous to the : operator. Therefore,
+       before the regex match is made, beginning and ending double quote
+       characters are stripped from both the pattern and the string.
+
+   \item \verb!expr1 =~ expr2!
+
+       Exactly the same as the ':' operator, except that the match is
+       not anchored to the beginning of the string. Pardon any similarity
+       to seemingly similar operators in other programming languages!
+       The ":" and "=\~" operators share the same precedence.
+
+   \item \verb!expr1 ? expr2 :: expr3!
+
+       Traditional Conditional operator. If expr1 is a number
+       that evaluates to 0 (false), expr3 is result of the this
+       expression evaluation.  Otherwise, expr2 is the result.
+       If expr1 is a string, and evaluates to an empty string,
+       or the two characters (""), then expr3 is the
+       result. Otherwise, expr2 is the result.  In Asterisk, all
+       3 exprs will be "evaluated"; if expr1 is "true", expr2
+       will be the result of the "evaluation" of this
+       expression.  expr3 will be the result otherwise. This
+       operator has the lowest precedence.
+\end{itemize}
 
 Parentheses are used for grouping in the usual manner.
 
 Operator precedence is applied as one would expect in any of the C
 or C derived languages.
 
-subsection{Floating Point Numbers}
+\subsection{Floating Point Numbers}
 
-In 1.6 and above, we shifted the \$\[...\] expressions to be calculated
+In 1.6 and above, we shifted the \$[...] expressions to be calculated
 via floating point numbers instead of integers. We use 'long double' numbers
-when possible, which provide around 16 digits of precision with 12 byte numbers. 
+when possible, which provide around 16 digits of precision with 12 byte numbers.
 
-To specify a floating point constant, the number has to have this format: D.D, where D is 
+To specify a floating point constant, the number has to have this format: D.D, where D is
 a string of base 10 digits. So, you can say 0.10, but you can't say .10 or 20.-- we hope
 this is not an excessive restriction!
 
-Floating point numbers are turned into strings via the '%g'/'%Lg' format of the printf
+Floating point numbers are turned into strings via the '\%g'/'\%Lg' format of the printf
 function set. This allows numbers to still 'look' like integers to those counting
 on integer behavior. If you were counting on 1/4 evaluating to 0, you need to now say
 TRUNC(1/4). For a list of all the truncation/rounding capabilities, see the next section.
 
 
-subsection{Functions}
+\subsection{Functions}
 
-In 1.6 and above, we upgraded the $[] expressions to handle floating point numbers.
+In 1.6 and above, we upgraded the \$[] expressions to handle floating point numbers.
 Because of this, folks counting on integer behavior would be disrupted. To make
 the same results possible, some rounding and integer truncation functions have been
 added to the core of the Expr2 parser. Indeed, dialplan functions can be called from
-$[..] expressions without the ${...} operators. The only trouble might be in the fact that
+\$[..] expressions without the \$\{...\} operators. The only trouble might be in the fact that
 the arguments to these functions must be specified with a comma. If you try to call
 the MATH function, for example, and try to say 3 + MATH(7*8), the expression parser will
-evaluate 7*8 for you into 56, and the MATH function will most likely complain that its 
+evaluate 7*8 for you into 56, and the MATH function will most likely complain that its
 input doesn't make any sense.
 
 We also provide access to most of the floating point functions in the C library. (but not all of them).
@@ -309,11 +319,11 @@ don't want to preclude it, either.
 
 Here is a list of the 'builtin' functions in Expr2. All other dialplan functions
 are available by simply calling them (read-only). In other words, you don't need to
-surround function calls in \$\[...\] expressions with \$\{...\}. Don't jump to conclusions,
+surround function calls in \$[...] expressions with \$\{...\}. Don't jump to conclusions,
 though! -- you still need to wrap variable names in curly braces!
 
-\begin{Enumerate}
-\item COS(x) x is in radians. Results vary from -1 to 1. 
+\begin{enumerate}
+\item COS(x) x is in radians. Results vary from -1 to 1.
 \item SIN(x) x is in radians. Results vary from -1 to 1.
 \item TAN(x) x is in radians.
 \item ACOS(x) x should be a value between -1 and 1.
@@ -334,98 +344,99 @@ If this quotient is 1/2, it is rounded to the nearest even number.
 \item LOG(x) returns the natural logarithm of x.
 \item LOG2(x) returns the base 2 log of x.
 \item LOG10(x) returns the base 10 log of x.
-\end{Enumerate}
+\end{enumerate}
 
-subsection{Examples}
+\subsection{Examples}
 
+\begin{astlisting}
 \begin{verbatim}
  "One Thousand Five Hundred" =~ "(T[^ ]+)"
-       returns: Thousand
+   returns: Thousand
 
  "One Thousand Five Hundred" =~ "T[^ ]+"
-       returns: 8
+   returns: 8
 
  "One Thousand Five Hundred" : "T[^ ]+"
-       returns: 0
+   returns: 0
 
  "8015551212" : "(...)"
-       returns: 801
+   returns: 801
 
  "3075551212":"...(...)"
-       returns: 555
+   returns: 555
 
  ! "One Thousand Five Hundred" =~ "T[^ ]+"
-       returns: 0 (because it applies to the string, which is non-null,
+   returns: 0 (because it applies to the string, which is non-null,
                     which it turns to "0", and then looks for the pattern
                     in the "0", and doesn't find it)
 
  !( "One Thousand Five Hundred" : "T[^ ]+" )
-       returns: 1  (because the string doesn't start with a word starting
+   returns: 1  (because the string doesn't start with a word starting
                      with T, so the match evals to 0, and the ! operator
                      inverts it to 1 ).
 
  2 + 8 / 2
-       returns 6. (because of operator precedence; the division is done first, then the addition).
+   returns 6. (because of operator precedence; the division is done first, then the addition).
 
  2+8/2
-       returns 6. Spaces aren't necessary.
+   returns 6. Spaces aren't necessary.
 
 (2+8)/2
-       returns 5, of course.
+   returns 5, of course.
 
 (3+8)/2
-       returns 5.5 now.
+   returns 5.5 now.
 
 TRUNC((3+8)/2)
-       returns 5.
+   returns 5.
 
 FLOOR(2.5)
-       returns 2
+   returns 2
 
 FLOOR(-2.5)
-       returns -3
+   returns -3
 
 CEIL(2.5)
-       returns 3.
+   returns 3.
 
 CEIL(-2.5)
-       returns -2.
+   returns -2.
 
 ROUND(2.5)
-       returns 3.
+   returns 3.
 
 ROUND(3.5)
-       returns 4.
+   returns 4.
 
 ROUND(-2.5)
-       returns -3
+   returns -3
 
 RINT(2.5)
-       returns 2.
+   returns 2.
 
 RINT(3.5)
-       returns 4.
+   returns 4.
 
 RINT(-2.5)
-       returns -2.
+   returns -2.
 
 RINT(-3.5)
-       returns -4.
+   returns -4.
 
 TRUNC(2.5)
-       returns 2.
+   returns 2.
 
 TRUNC(3.5)
-       returns 3.
+   returns 3.
 
 TRUNC(-3.5)
-       returns -3.
-
-\begin{verbatim}
+   returns -3.
+\end{verbatim}
+\end{astlisting}
 
 Of course, all of the above examples use constants, but would work the
 same if any of the numeric or string constants were replaced with a
-variable reference \${CALLERIDNUM}, for instance.
+variable reference \${CALLERID(num)}, for instance.
 
 
 \subsection{Numbers Vs. Strings}
@@ -438,31 +449,31 @@ case.
 
 \subsection{Conditionals}
 
-There is one conditional application - the conditional goto : 
+There is one conditional application - the conditional goto :
 
 \begin{verbatim}
-       exten => 1,2,gotoif(condition?label1:label2)
+  exten => 1,2,GotoIf(condition?label1:label2)
 \end{verbatim}
 
 If condition is true go to label1, else go to label2. Labels are interpreted
 exactly as in the normal goto command.
 
 "condition" is just a string. If the string is empty or "0", the condition
-is considered to be false, if it's anything else, the condition is true. 
-This is designed to be used together with the expression syntax described 
-above, eg : 
+is considered to be false, if it's anything else, the condition is true.
+This is designed to be used together with the expression syntax described
+above, eg :
 
 \begin{verbatim}
-       exten => 1,2,gotoif($[${CALLERID} = 123456]?2|1:3|1)
+  exten => 1,2,GotoIf($[${CALLERID(all)} = 123456]?2,1:3,1)
 \end{verbatim}
 
-Example of use : 
+Example of use :
 
 \begin{verbatim}
 exten => s,2,Set(vara=1)
 exten => s,3,Set(varb=$[${vara} + 2])
 exten => s,4,Set(varc=$[${varb} * 2])
-exten => s,5,GotoIf($[${varc} = 6]?99|1:s|6)
+exten => s,5,GotoIf($[${varc} = 6]?99,1:s,6)
 \end{verbatim}
 
 \subsection{Parse Errors}
@@ -471,16 +482,20 @@ Syntax errors are now output with 3 lines.
 
 If the extensions.conf file contains a line like:
 
+\begin{astlisting}
 \begin{verbatim}
-exten => s,6,GotoIf($[ "${CALLERIDNUM}"  = "3071234567" & &  "${CALLERIDNAME}" : "Privacy Manager" ]?callerid-liar|s|1:s|7)
+exten => s,6,GotoIf($[ "${CALLERID(num)}"  = "3071234567" & &  "${CALLERID(name)}" : "Privacy Manager" ]?callerid-liar,s,1:s,7)
 \end{verbatim}
+\end{astlisting}
 
 You may see an error in /var/log/asterisk/messages like this:
+\begin{astlisting}
 \begin{verbatim}
 Jul 15 21:27:49 WARNING[1251240752]: ast_yyerror(): syntax error: parse error, unexpected TOK_AND, expecting TOK_MINUS or TOK_LP or TOKEN; Input:
-"3072312154"  = "3071234567" & & "Steves Extension" : "Privacy Manager" 
-                               ^
+"3072312154"  = "3071234567" & & "Steves Extension" : "Privacy Manager"
+               ^
 \end{verbatim}
+\end{astlisting}
 
 The log line tells you that a syntax error was encountered. It now
 also tells you (in grand standard bison format) that it hit an "AND"
@@ -494,12 +509,12 @@ marked with the "\^" character.
 \subsection{NULL Strings}
 Testing to see if a string is null can be done in one of two different ways:
 \begin{verbatim}
-       exten => _XX.,1,GotoIf($["${calledid}" != ""]?3) 
+  exten => _XX.,1,GotoIf($["${calledid}" != ""]?3)
 
-       exten => _XX.,1,GotoIf($[foo${calledid} != foo]?3) 
+  exten => _XX.,1,GotoIf($[foo${calledid} != foo]?3)
 \end{verbatim}
 
-The second example above is the way suggested by the WIKI. It will 
+The second example above is the way suggested by the WIKI. It will
 work as long as there are no spaces in the evaluated value.
 
 The first way should work in all cases, and indeed, might now
@@ -517,7 +532,7 @@ Pascal, APL, assembler, etc.
 \subsection{Incompatabilities}
 
 The asterisk expression parser has undergone some evolution. It is hoped
-that the changes will be viewed as positive. 
+that the changes will be viewed as positive.
 
 The "original" expression parser had a simple, hand-written scanner,
 and a simple bison grammar. This was upgraded to a more involved bison
@@ -533,7 +548,7 @@ allow it.
 
 If you have not touched your extensions.conf files in a year or so, the
 above upgrades may cause you some heartburn in certain circumstances, as
-several changes have been made, and these will affect asterisk's behavior on 
+several changes have been made, and these will affect asterisk's behavior on
 legacy extension.conf constructs.  The changes have been engineered
 to minimize these conflicts, but there are bound to be problems.
 
@@ -546,21 +561,21 @@ of possible concern with "legacy" extension.conf files:
    to the value '2', but '1+1' would evaluate to the string '1+1'. If this
    behavior was depended on, then the expression evaluation will break. '1+1'
    will now evaluate to '2', and something is not going to work right.
-   To keep such strings from being evaluated, simply wrap them in double 
+   To keep such strings from being evaluated, simply wrap them in double
    quotes: '  "1+1" '
 
 \item The colon operator. In versions previous to double quoting, the
-   colon operator takes the right hand string, and using it as a 
+   colon operator takes the right hand string, and using it as a
    regex pattern, looks for it in the left hand string. It is given
-   an implicit \^ operator at the beginning, meaning the pattern 
-   will match only at the beginning of the left hand string. 
+   an implicit \^ operator at the beginning, meaning the pattern
+   will match only at the beginning of the left hand string.
    If the pattern or the matching string had double quotes around
    them, these could get in the way of the pattern match. Now,
-   the wrapping double quotes are stripped from both the pattern 
+   the wrapping double quotes are stripped from both the pattern
    and the left hand string before applying the pattern. This
    was done because it recognized that the new way of
    scanning the expression doesn't use spaces to separate tokens,
-   and the average regex expression is full of operators that 
+   and the average regex expression is full of operators that
    the scanner will recognize as expression operators. Thus, unless
    the pattern is wrapped in double quotes, there will be trouble.
    For instance,      \${VAR1} : (Who|What*)+
@@ -574,7 +589,7 @@ of possible concern with "legacy" extension.conf files:
    quotes, it was no reason for concern. It is now!
 
 \item LE, GE, NE operators removed. The code supported these operators,
-   but they were not documented. The symbolic operators, <=, >=, and !=
+   but they were not documented. The symbolic operators, $<$=, $>$=, and !=
    should be used instead.
 
 \item  Added the unary '-' operator. So you can 3+ -4 and get -1.
@@ -589,7 +604,7 @@ of possible concern with "legacy" extension.conf files:
 
 \item  Added the conditional operator  'expr1 ? true\_expr :: false\_expr'
     First, all 3 exprs are evaluated, and if expr1 is false, the 'false\_expr'
-    is returned as the result. See above for details. 
+    is returned as the result. See above for details.
 
 \item  Unary operators '-' and '!' were made right associative.
 \end{enumerate}
@@ -635,7 +650,7 @@ references with '555'. You can override the 555 for variable values,
 by entering in var=val arguments after the filename on the command
 line.  So...
 
- check\_expr /etc/asterisk/extensions.conf CALLERIDNUM=3075551212 DIALSTATUS=TORTURE EXTEN=121
+ check\_expr /etc/asterisk/extensions.conf CALLERID(num)=3075551212 DIALSTATUS=TORTURE EXTEN=121
 
 will substitute any \${CALLERIDNUM} variable references with
 3075551212, any \${DIALSTATUS} variable references with 'TORTURE', and
@@ -644,15 +659,19 @@ going on in the reference, like \${EXTEN:2}, then the override will
 not work. Everything in the \${...} has to match. So, to substitute
 \${EXTEN:2} references, you'd best say:
 
- check\_expr /etc/asterisk/extensions.conf CALLERIDNUM=3075551212 DIALSTATUS=TORTURE EXTEN:2=121
+ check\_expr /etc/asterisk/extensions.conf CALLERID(num)=3075551212 DIALSTATUS=TORTURE EXTEN:2=121
 
 on stdout, you will see something like:
 
- OK -- \$[ "\${DIALSTATUS}"  = "TORTURE" | "\${DIALSTATUS}" = "DONTCALL" ] at line 416
+\begin{verbatim}
+ OK -- $[ "${DIALSTATUS}"  = "TORTURE" | "${DIALSTATUS}" = "DONTCALL" ] at line 416
+\end{verbatim}
 
 In the expr2\_log file that is generated, you will see:
 
- line 416, evaluation of \$[  "TORTURE"  = "TORTURE" | "TORTURE" = "DONTCALL"  ] result: 1
+\begin{verbatim}
+ line 416, evaluation of $[  "TORTURE"  = "TORTURE" | "TORTURE" = "DONTCALL"  ] result: 1
+\end{verbatim}
 
 check\_expr is a very simplistic algorithm, and it is far from being
 guaranteed to work in all cases, but it is hoped that it will be
@@ -666,238 +685,240 @@ available in each application's help text. All these variables
 are in UPPER CASE only.
 
 Variables marked with a * are builtin functions and can't be set,
-only read in the dialplan.  Writes to such variables are silently 
+only read in the dialplan.  Writes to such variables are silently
 ignored.
 
 \begin{verbatim}
-${ACCOUNTCODE}                 * Account code (if specified) (Deprecated; use ${CDR(accountcode)})
-${BLINDTRANSFER}       The name of the channel on the other side of a blind transfer
-${BRIDGEPEER}          Bridged peer
-${CALLERANI}           * Caller ANI (PRI channels) (Deprecated; use ${CALLERID(ani)})
-${CALLERID}            * Caller ID (Deprecated; use ${CALLERID(all)})
-${CALLERIDNAME}                * Caller ID Name only (Deprecated; use ${CALLERID(name)})
-${CALLERIDNUM}         * Caller ID Number only (Deprecated; use ${CALLERID(num)})
-${CALLINGANI2}         * Caller ANI2 (PRI channels)
-${CALLINGPRES}         * Caller ID presentation for incoming calls (PRI channels)
-${CALLINGTNS}          * Transit Network Selector (PRI channels)
-${CALLINGTON}          * Caller Type of Number (PRI channels)
-${CHANNEL}             * Current channel name
-${CONTEXT}             * Current context
-${DATETIME}            * Current date time in the format: DDMMYYYY-HH:MM:SS (Deprecated; use ${STRFTIME(${EPOCH},,%d%m%Y-%H:%M:%S)})
-${DB_RESULT}           Result value of DB_EXISTS() dial plan function
-${DNID}                * Dialed Number Identifier (Deprecated; use ${CALLERID(dnid)})
-${EPOCH}               * Current unix style epoch
-${EXTEN}               * Current extension
-${ENV(VAR)}            Environmental variable VAR
-${GOTO_ON_BLINDXFR}    Transfer to the specified context/extension/priority
-                       after a blind transfer (use ^ characters in place of
-                       | to separate context/extension/priority when setting
-                       this variable from the dialplan)
-${HANGUPCAUSE}         * Asterisk cause of hangup (inbound/outbound)
-${HINT}                * Channel hints for this extension
-${HINTNAME}            * Suggested Caller*ID name for this extension
-${INVALID_EXTEN}       The invalid called extension (used in the "i" extension)
-${LANGUAGE}            * Current language (Deprecated; use ${LANGUAGE()})
-${LEN(VAR)}            * String length of VAR (integer)
-${PRIORITY}            * Current priority in the dialplan
-${PRIREDIRECTREASON}   Reason for redirect on PRI, if a call was directed
-${RDNIS}               * Redirected Dial Number ID Service (Deprecated; use ${CALLERID(rdnis)})
-${TIMESTAMP}           * Current date time in the format: YYYYMMDD-HHMMSS (Deprecated; use ${STRFTIME(${EPOCH},,%Y%m%d-%H%M%S)})
-${TRANSFER_CONTEXT}    Context for transferred calls
-${FORWARD_CONTEXT}     Context for forwarded calls
-${UNIQUEID}            * Current call unique identifier
-${SYSTEMNAME}          * value of the systemname option of asterisk.conf
+${CDR(accountcode)}    * Account code (if specified)
+${BLINDTRANSFER}         The name of the channel on the other side of a blind transfer
+${BRIDGEPEER}            Bridged peer
+${CALLERID(ani)}       * Caller ANI (PRI channels)
+${CALLERID(all)}       * Caller ID
+${CALLERID(dnid)}      * Dialed Number Identifier
+${CALLERID(name)}      * Caller ID Name only
+${CALLERID(num)}       * Caller ID Number only
+${CALLERID(rdnis)}     * Redirected Dial Number ID Service
+${CALLINGANI2}         * Caller ANI2 (PRI channels)
+${CALLINGPRES}         * Caller ID presentation for incoming calls (PRI channels)
+${CALLINGTNS}          * Transit Network Selector (PRI channels)
+${CALLINGTON}          * Caller Type of Number (PRI channels)
+${CHANNEL}             * Current channel name
+${CONTEXT}             * Current context
+${DATETIME}            * Current date time in the format: DDMMYYYY-HH:MM:SS
+                         (Deprecated; use ${STRFTIME(${EPOCH},,%d%m%Y-%H:%M:%S)})
+${DB_RESULT}             Result value of DB_EXISTS() dial plan function
+${EPOCH}               * Current unix style epoch
+${EXTEN}               * Current extension
+${ENV(VAR)}              Environmental variable VAR
+${GOTO_ON_BLINDXFR}      Transfer to the specified context/extension/priority
+                         after a blind transfer (use ^ characters in place of
+                         | to separate context/extension/priority when setting
+                         this variable from the dialplan)
+${HANGUPCAUSE}         * Asterisk cause of hangup (inbound/outbound)
+${HINT}                * Channel hints for this extension
+${HINTNAME}            * Suggested Caller*ID name for this extension
+${INVALID_EXTEN}         The invalid called extension (used in the "i" extension)
+${LANGUAGE}            * Current language (Deprecated; use ${LANGUAGE()})
+${LEN(VAR)}            * String length of VAR (integer)
+${PRIORITY}            * Current priority in the dialplan
+${PRIREDIRECTREASON}     Reason for redirect on PRI, if a call was directed
+${TIMESTAMP}           * Current date time in the format: YYYYMMDD-HHMMSS
+                         (Deprecated; use ${STRFTIME(${EPOCH},,%Y%m%d-%H%M%S)})
+${TRANSFER_CONTEXT}      Context for transferred calls
+${FORWARD_CONTEXT}       Context for forwarded calls
+${UNIQUEID}            * Current call unique identifier
+${SYSTEMNAME}          * value of the systemname option of asterisk.conf
 \end{verbatim}
 
 \subsection{Application return values}
--------------------------
+
 In Asterisk 1.2, many applications return the result in a variable
 instead of, as in Asterisk 1.0, changing the dial plan priority (+101).
 For the various status values, see each application's help text.
 \begin{verbatim}
-${AGISTATUS}                   * agi()
-${AQMSTATUS}                   * addqueuemember()
-${AVAILSTATUS}                 * chanisavail()
-${CHECKGROUPSTATUS}            * checkgroup()
-${CHECKMD5STATUS}              * checkmd5()
-${CPLAYBACKSTATUS}             * controlplayback()
-${DIALSTATUS}                  * dial()
-${DBGETSTATUS}                 * dbget()
-${ENUMSTATUS}                  * enumlookup()
-${HASVMSTATUS}                 * hasnewvoicemail()
-${LOOKUPBLSTATUS}              * lookupblacklist()
-${OSPAUTHSTATUS}               * ospauth()
-${OSPLOOKUPSTATUS}             * osplookup()
-${OSPNEXTSTATUS}               * ospnext()
-${OSPFINISHSTATUS}             * ospfinish()
-${PARKEDAT}                    * parkandannounce()
-${PLAYBACKSTATUS}              * playback()
-${PQMSTATUS}                   * pausequeuemember()
-${PRIVACYMGRSTATUS}            * privacymanager()
-${QUEUESTATUS}                 * queue()
-${RQMSTATUS}                   * removequeuemember()
-${SENDIMAGESTATUS}             * sendimage()
-${SENDTEXTSTATUS}              * sendtext()
-${SENDURLSTATUS}               * sendurl()
-${SYSTEMSTATUS}                        * system()
-${TRANSFERSTATUS}              * transfer()
-${TXTCIDNAMESTATUS}            * txtcidname()
-${UPQMSTATUS}                  * unpausequeuemember()
-${VMSTATUS}                    * voicmail()
-${VMBOXEXISTSSTATUS}           * vmboxexists()
-${WAITSTATUS}                  * waitforsilence()
+${AGISTATUS}         * agi()
+${AQMSTATUS}         * addqueuemember()
+${AVAILSTATUS}       * chanisavail()
+${CHECKGROUPSTATUS}  * checkgroup()
+${CHECKMD5STATUS}    * checkmd5()
+${CPLAYBACKSTATUS}   * controlplayback()
+${DIALSTATUS}        * dial()
+${DBGETSTATUS}       * dbget()
+${ENUMSTATUS}        * enumlookup()
+${HASVMSTATUS}       * hasnewvoicemail()
+${LOOKUPBLSTATUS}    * lookupblacklist()
+${OSPAUTHSTATUS}     * ospauth()
+${OSPLOOKUPSTATUS}   * osplookup()
+${OSPNEXTSTATUS}     * ospnext()
+${OSPFINISHSTATUS}   * ospfinish()
+${PARKEDAT}          * parkandannounce()
+${PLAYBACKSTATUS}    * playback()
+${PQMSTATUS}         * pausequeuemember()
+${PRIVACYMGRSTATUS}  * privacymanager()
+${QUEUESTATUS}       * queue()
+${RQMSTATUS}         * removequeuemember()
+${SENDIMAGESTATUS}   * sendimage()
+${SENDTEXTSTATUS}    * sendtext()
+${SENDURLSTATUS}     * sendurl()
+${SYSTEMSTATUS}      * system()
+${TRANSFERSTATUS}    * transfer()
+${TXTCIDNAMESTATUS}  * txtcidname()
+${UPQMSTATUS}        * unpausequeuemember()
+${VMSTATUS}          * voicmail()
+${VMBOXEXISTSSTATUS} * vmboxexists()
+${WAITSTATUS}        * waitforsilence()
 \end{verbatim}
 
 \subsection{Various application variables}
 \begin{verbatim}
-${CURL}                        * Resulting page content for curl()
-${ENUM}                        * Result of application EnumLookup
-${EXITCONTEXT}         Context to exit to in IVR menu (app background())
-                       or in the RetryDial() application
-${MONITOR}             * Set to "TRUE" if the channel is/has been monitored (app monitor())
-${MONITOR_EXEC}                Application to execute after monitoring a call
-${MONITOR_EXEC_ARGS}   Arguments to application
-${MONITOR_FILENAME}    File for monitoring (recording) calls in queue
-${QUEUE_PRIO}          Queue priority
-${QUEUE_MAX_PENALTY}   Maximum member penalty allowed to answer caller
-${QUEUESTATUS}                 Status of the call, one of:
-                       (TIMEOUT | FULL | JOINEMPTY | LEAVEEMPTY | JOINUNAVAIL | LEAVEUNAVAIL)
-${RECORDED_FILE}       * Recorded file in record()
-${TALK_DETECTED}       * Result from talkdetect()
-${TOUCH_MONITOR}       The filename base to use with Touch Monitor (auto record)
-${TOUCH_MONITOR_FORMAT} The audio format to use with Touch Monitor (auto record)
+${CURL}                 * Resulting page content for curl()
+${ENUM}                 * Result of application EnumLookup
+${EXITCONTEXT}            Context to exit to in IVR menu (app background())
+                          or in the RetryDial() application
+${MONITOR}              * Set to "TRUE" if the channel is/has been monitored (app monitor())
+${MONITOR_EXEC}           Application to execute after monitoring a call
+${MONITOR_EXEC_ARGS}      Arguments to application
+${MONITOR_FILENAME}       File for monitoring (recording) calls in queue
+${QUEUE_PRIO}             Queue priority
+${QUEUE_MAX_PENALTY}      Maximum member penalty allowed to answer caller
+${QUEUESTATUS}            Status of the call, one of:
+                          (TIMEOUT | FULL | JOINEMPTY | LEAVEEMPTY | JOINUNAVAIL | LEAVEUNAVAIL)
+${RECORDED_FILE}        * Recorded file in record()
+${TALK_DETECTED}        * Result from talkdetect()
+${TOUCH_MONITOR}          The filename base to use with Touch Monitor (auto record)
+${TOUCH_MONITOR_FORMAT}   The audio format to use with Touch Monitor (auto record)
 ${TOUCH_MONITOR_OUTPUT} * Recorded file from Touch Monitor (auto record)
-${TXTCIDNAME}          * Result of application TXTCIDName
-${VPB_GETDTMF}         chan_vpb
+${TXTCIDNAME}           * Result of application TXTCIDName
+${VPB_GETDTMF}            chan_vpb
 \end{verbatim}
 
 \subsection{The MeetMe Conference Bridge}
 \begin{verbatim}
-${MEETME_RECORDINGFILE}        Name of file for recording a conference with 
-                               the "r" option
-${MEETME_RECORDINGFORMAT}      Format of file to be recorded
-${MEETME_EXIT_CONTEXT}                 Context for exit out of meetme meeting
-${MEETME_AGI_BACKGROUND}       AGI script for Meetme (zap only)
-${MEETMESECS}                  * Number of seconds a user participated in a MeetMe conference
+${MEETME_RECORDINGFILE}     Name of file for recording a conference with
+                            the "r" option
+${MEETME_RECORDINGFORMAT}   Format of file to be recorded
+${MEETME_EXIT_CONTEXT}      Context for exit out of meetme meeting
+${MEETME_AGI_BACKGROUND}    AGI script for Meetme (zap only)
+${MEETMESECS}             * Number of seconds a user participated in a MeetMe conference
 \end{verbatim}
 
 \subsection{The VoiceMail() application}
 \begin{verbatim}
-${VM_CATEGORY}         Sets voicemail category
-${VM_NAME}             * Full name in voicemail
-${VM_DUR}              * Voicemail duration
-${VM_MSGNUM}           * Number of voicemail message in mailbox
-${VM_CALLERID}         * Voicemail Caller ID (Person leaving vm)
-${VM_CIDNAME}          * Voicemail Caller ID Name
-${VM_CIDNUM}           * Voicemail Caller ID Number
-${VM_DATE}             * Voicemail Date
-${VM_MESSAGEFILE}      * Path to message left by caller
+${VM_CATEGORY}      Sets voicemail category
+${VM_NAME}        * Full name in voicemail
+${VM_DUR}         * Voicemail duration
+${VM_MSGNUM}      * Number of voicemail message in mailbox
+${VM_CALLERID}    * Voicemail Caller ID (Person leaving vm)
+${VM_CIDNAME}     * Voicemail Caller ID Name
+${VM_CIDNUM}      * Voicemail Caller ID Number
+${VM_DATE}        * Voicemail Date
+${VM_MESSAGEFILE} * Path to message left by caller
 \end{verbatim}
 
 \subsection{The VMAuthenticate() application}
 \begin{verbatim}
-${AUTH_MAILBOX}        * Authenticated mailbox
-${AUTH_CONTEXT}        * Authenticated mailbox context
+${AUTH_MAILBOX}   * Authenticated mailbox
+${AUTH_CONTEXT}   * Authenticated mailbox context
 \end{verbatim}
 
 \subsection{DUNDiLookup()}
 \begin{verbatim}
-${DUNDTECH}    * The Technology of the result from a call to DUNDiLookup()
-${DUNDDEST}    * The Destination of the result from a call to DUNDiLookup()
+${DUNDTECH}       * The Technology of the result from a call to DUNDiLookup()
+${DUNDDEST}       * The Destination of the result from a call to DUNDiLookup()
 \end{verbatim}
 
 \subsection{chan\_zap}
 \begin{verbatim}
-${ANI2}                        * The ANI2 Code provided by the network on the incoming call. 
-                       (ie, Code 29 identifies call as a Prison/Inmate Call)
-${CALLTYPE}            * Type of call (Speech, Digital, etc)
-${CALLEDTON}           * Type of number for incoming PRI extension
-                       i.e. 0=unknown, 1=international, 2=domestic, 3=net_specific, 
-                       4=subscriber, 6=abbreviated, 7=reserved 
-${CALLINGSUBADDR}      * Called PRI Subaddress
-${FAXEXTEN}            * The extension called before being redirected to "fax" 
-${PRIREDIRECTREASON}   * Reason for redirect, if a call was directed
-${SMDI_VM_TYPE}                * When an call is received with an SMDI message, the 'type'
-                       of message 'b' or 'u'
+${ANI2}               * The ANI2 Code provided by the network on the incoming call.
+                        (ie, Code 29 identifies call as a Prison/Inmate Call)
+${CALLTYPE}           * Type of call (Speech, Digital, etc)
+${CALLEDTON}          * Type of number for incoming PRI extension
+                        i.e. 0=unknown, 1=international, 2=domestic, 3=net_specific,
+                        4=subscriber, 6=abbreviated, 7=reserved
+${CALLINGSUBADDR}     * Called PRI Subaddress
+${FAXEXTEN}           * The extension called before being redirected to "fax"
+${PRIREDIRECTREASON}  * Reason for redirect, if a call was directed
+${SMDI_VM_TYPE}       * When an call is received with an SMDI message, the 'type'
+                        of message 'b' or 'u'
 \end{verbatim}
 
 \subsection{chan\_sip}
 \begin{verbatim}
-${SIPCALLID}           * SIP Call-ID: header verbatim (for logging or CDR matching)
-${SIPDOMAIN}           * SIP destination domain of an inbound call (if appropriate)
-${SIPUSERAGENT}        * SIP user agent (deprecated)
-${SIPURI}              * SIP uri
-${SIP_CODEC}           Set the SIP codec for a call    
-${SIP_URI_OPTIONS}     * additional options to add to the URI for an outgoing call
-${RTPAUDIOQOS}         RTCP QoS report for the audio of this call
-${RTPVIDEOQOS}         RTCP QoS report for the video of this call
+${SIPCALLID}         * SIP Call-ID: header verbatim (for logging or CDR matching)
+${SIPDOMAIN}         * SIP destination domain of an inbound call (if appropriate)
+${SIPUSERAGENT}      * SIP user agent (deprecated)
+${SIPURI}            * SIP uri
+${SIP_CODEC}           Set the SIP codec for a call
+${SIP_URI_OPTIONS}   * additional options to add to the URI for an outgoing call
+${RTPAUDIOQOS}         RTCP QoS report for the audio of this call
+${RTPVIDEOQOS}         RTCP QoS report for the video of this call
 \end{verbatim}
 
 \subsection{chan\_agent}
 \begin{verbatim}
-${AGENTMAXLOGINTRIES}  Set the maximum number of failed logins
-${AGENTUPDATECDR}      Whether to update the CDR record with Agent channel data
-${AGENTGOODBYE}                Sound file to use for "Good Bye" when agent logs out
-${AGENTACKCALL}        Whether the agent should acknowledge the incoming call
-${AGENTAUTOLOGOFF}     Auto logging off for an agent
-${AGENTWRAPUPTIME}     Setting the time for wrapup between incoming calls
-${AGENTNUMBER}         * Agent number (username) set at login
-${AGENTSTATUS}         * Status of login       ( fail | on | off )
-${AGENTEXTEN}          * Extension for logged in agent
+${AGENTMAXLOGINTRIES}  Set the maximum number of failed logins
+${AGENTUPDATECDR}      Whether to update the CDR record with Agent channel data
+${AGENTGOODBYE}        Sound file to use for "Good Bye" when agent logs out
+${AGENTACKCALL}        Whether the agent should acknowledge the incoming call
+${AGENTAUTOLOGOFF}     Auto logging off for an agent
+${AGENTWRAPUPTIME}     Setting the time for wrapup between incoming calls
+${AGENTNUMBER}       * Agent number (username) set at login
+${AGENTSTATUS}       * Status of login ( fail | on | off )
+${AGENTEXTEN}        * Extension for logged in agent
 \end{verbatim}
 
 
 \subsection{The Dial() application}
 \begin{verbatim}
-${DIALEDPEERNAME}              * Dialed peer name
-${DIALEDPEERNUMBER}            * Dialed peer number
-${DIALEDTIME}                  * Time for the call (seconds)
-${ANSWEREDTIME}                * Time from dial to answer (seconds)
-${DIALSTATUS}                  * Status of the call, one of:
-                               (CHANUNAVAIL | CONGESTION | BUSY | NOANSWER 
-                                       | ANSWER | CANCEL | DONTCALL | TORTURE)
-${DYNAMIC_FEATURES}            * The list of features (from the [applicationmap] section of
-                                 features.conf) to activate during the call, with feature
-                                 names separated by '#' characters
-${LIMIT_PLAYAUDIO_CALLER}      Soundfile for call limits
-${LIMIT_PLAYAUDIO_CALLEE}      Soundfile for call limits
-${LIMIT_WARNING_FILE}          Soundfile for call limits
-${LIMIT_TIMEOUT_FILE}          Soundfile for call limits
-${LIMIT_CONNECT_FILE}          Soundfile for call limits
-${OUTBOUND_GROUP}              Default groups for peer channels (as in SetGroup)
-* See "show application dial" for more information
+${DIALEDPEERNAME}     * Dialed peer name
+${DIALEDPEERNUMBER}   * Dialed peer number
+${DIALEDTIME}         * Time for the call (seconds)
+${ANSWEREDTIME}       * Time from dial to answer (seconds)
+${DIALSTATUS}         * Status of the call, one of:
+                        (CHANUNAVAIL | CONGESTION | BUSY | NOANSWER
+                        | ANSWER | CANCEL | DONTCALL | TORTURE)
+${DYNAMIC_FEATURES}   * The list of features (from the [applicationmap] section of
+                        features.conf) to activate during the call, with feature
+                        names separated by '#' characters
+${LIMIT_PLAYAUDIO_CALLER}  Soundfile for call limits
+${LIMIT_PLAYAUDIO_CALLEE}  Soundfile for call limits
+${LIMIT_WARNING_FILE}      Soundfile for call limits
+${LIMIT_TIMEOUT_FILE}      Soundfile for call limits
+${LIMIT_CONNECT_FILE}      Soundfile for call limits
+${OUTBOUND_GROUP}          Default groups for peer channels (as in SetGroup)
+                           * See "show application dial" for more information
 \end{verbatim}
 
 \subsection{The chanisavail() application}
 \begin{verbatim}
-${AVAILCHAN}           * the name of the available channel if one was found    
-${AVAILORIGCHAN}       * the canonical channel name that was used to create the channel
-${AVAILSTATUS}         * Status of requested channel
+${AVAILCHAN}          * the name of the available channel if one was found
+${AVAILORIGCHAN}      * the canonical channel name that was used to create the channel
+${AVAILSTATUS}        * Status of requested channel
 \end{verbatim}
 
 \subsection{Dialplan Macros}
 \begin{verbatim}
-${MACRO_EXTEN}         * The calling extensions
-${MACRO_CONTEXT}       * The calling context
-${MACRO_PRIORITY}      * The calling priority
-${MACRO_OFFSET}                Offset to add to priority at return from macro
+${MACRO_EXTEN}        * The calling extensions
+${MACRO_CONTEXT}      * The calling context
+${MACRO_PRIORITY}     * The calling priority
+${MACRO_OFFSET}         Offset to add to priority at return from macro
 \end{verbatim}
 
 \subsection{The ChanSpy() application}
 \begin{verbatim}
-${SPYGROUP}            * A ':' (colon) separated list of group names.
-                         (To be set on spied on channel and matched against the g(grp) option)
+${SPYGROUP}           * A ':' (colon) separated list of group names.
+                        (To be set on spied on channel and matched against the g(grp) option)
 \end{verbatim}
 
 \subsection{OSP}
 \begin{verbatim}
-${OSPINHANDLE}         OSP handle of in_bound call
-${OSPINTIMELIMIT}      Duration limit for in_bound call
-${OSPOUTHANDLE}                OSP handle of out_bound call
-${OSPTECH}             OSP technology 
-${OSPDEST}             OSP destination
-${OSPCALLING}          OSP calling number
-${OSPOUTTOKEN}         OSP token to use for out_bound call
-${OSPOUTTIMELIMIT}     Duration limit for out_bound call
-${OSPRESULTS}          Number of remained destinations
+${OSPINHANDLE}          OSP handle of in_bound call
+${OSPINTIMELIMIT}       Duration limit for in_bound call
+${OSPOUTHANDLE}         OSP handle of out_bound call
+${OSPTECH}              OSP technology
+${OSPDEST}              OSP destination
+${OSPCALLING}           OSP calling number
+${OSPOUTTOKEN}          OSP token to use for out_bound call
+${OSPOUTTIMELIMIT}      Duration limit for out_bound call
+${OSPRESULTS}           Number of remained destinations
 \end{verbatim}