Remove "second form" of extensions, as it no longer applies. Also, cleanup

the grammar, formatting, and introduce several clarifications to the text.
(Closes issue #13654)


git-svn-id: https://origsvn.digium.com/svn/asterisk/trunk@147896 65c4cc65-6c06-0410-ace0-fbb531ad65f3

configs/extensions.conf.sample

@@ -156,27 +156,29 @@ TRUNKMSD=1					; MSD digits to strip (usually 1 or 0)
 ;   ! - wildcard, causes the matching process to complete as soon as
 ;       it can unambiguously determine that no other matches are possible
 ;
-; For example the extension _NXXXXXX would match normal 7 digit dialings, 
+; For example, the extension _NXXXXXX would match normal 7 digit dialings, 
 ; while _1NXXNXXXXXX would represent an area code plus phone number
 ; preceded by a one.
 ;
-; Each step of an extension is ordered by priority, which must
+; Each step of an extension is ordered by priority, which must always start
-; always start with 1 to be considered a valid extension.  The priority
+; with 1 to be considered a valid extension.  The priority "next" or "n" means
-; "next" or "n" means the previous priority plus one, regardless of whether
+; the previous priority plus one, regardless of whether the previous priority
-; the previous priority was associated with the current extension or not.
+; was associated with the current extension or not.  The priority "same" or "s"
-; The priority "same" or "s" means the same as the previously specified
+; means the same as the previously specified priority, again regardless of
-; priority, again regardless of whether the previous entry was for the
+; whether the previous entry was for the same extension.  Priorities may be
-; same extension.  Priorities may be immediately followed by a plus sign
+; immediately followed by a plus sign and another integer to add that amount
-; and another integer to add that amount (most useful with 's' or 'n').  
+; (most useful with 's' or 'n').  Priorities may then also have an alias, or
-; Priorities may then also have an alias, or label, in 
+; label, in parentheses after their name which can be used in goto situations.
-; parenthesis after their name which can be used in goto situations
+;
-;
+; Contexts contain several lines, one for each step of each extension.  One may
-; Contexts contain several lines, one for each step of each
+; include another context in the current one as well, optionally with a date
-; extension, which can take one of two forms as listed below,
+; and time.  Included contexts are included in the order they are listed.
-; with the first form being preferred.  One may include another
+; Switches may also be included within a context.  The order of matching within
-; context in the current one as well, optionally with a
+; a context is always exact extensions, pattern match extensions, includes, and
-; date and time.  Included contexts are included in the order
+; switches.  Includes are always processed depth-first.  So for example, if you
-; they are listed.
+; would like a switch "A" to match before context "B", simply put switch "A" in
+; an included context "C", where "C" is included in your original context
+; before "B".
 ;
 ;[context]
 ;exten => someexten,{priority|label{+|-}offset}[(alias)],application(arg1,arg2,...)
@@ -192,13 +194,18 @@ TRUNKMSD=1					; MSD digits to strip (usually 1 or 0)
 ;include => weekend,*,sat-sun,*,*
 ;include => weeknights,17:02-8:58,mon-fri,*,*
 ;
-; ignorepat can be used to instruct drivers to not cancel dialtone upon
+; ignorepat can be used to instruct drivers to not cancel dialtone upon receipt
-; receipt of a particular pattern.  The most commonly used example is
+; of a particular pattern.  The most commonly used example is of course '9'
-; of course '9' like this:
+; like this:
 ;
 ;ignorepat => 9
 ;
-; so that dialtone remains even after dialing a 9.
+; so that dialtone remains even after dialing a 9.  Please note that ignorepat
+; only works with channels which receive dialtone from the PBX, such as DAHDI,
+; Phone, and VPB.  Other channels, such as SIP and MGCP, which generate their
+; own dialtone and converse with the PBX only after a number is complete, are
+; generally unaffected by ignorepat (unless DISA or another method is used to
+; generate a dialtone after answering the channel).
 ;
 
 ;