More asciidoc polishes and small sample file fixes.

git-svn-id: http://svn.digium.com/svn/zaptel/branches/1.2@3972 5390a7c7-147a-4af0-8ec9-7488f05a26cb

1 files changed, 29 insertions, 16 deletions

diff --git a/zaptel.conf.sample b/zaptel.conf.sample
index c677442..fefef9d 100644
--- a/zaptel.conf.sample
+++ b/zaptel.conf.sample
@@ -42,16 +42,15 @@
 #  6: -15db (CSU)
 #  7: -22.5db (CSU)
 #
-# The framing is one of "d4" or "esf" for T1 or "cas" or "ccs" for E1
+# framing:: 
+#   one of 'd4' or 'esf' for T1 or 'cas' or 'ccs' for E1 and BRI.
+#  'd4' could be referred to as 'sf' or 'superframe'
 #
-# Note: "d4" could be referred to as "sf" or "superframe" 
-#
-# The coding is one of "ami" or "b8zs" for T1 or "ami" or "hdb3" for E1
-#
-# E1's may have the additional keyword "crc4" to enable CRC4 checking
-#
-# If the keyword "yellow" follows, yellow alarm is transmitted when no
-# channels are open.
+# coding:: 
+#   one of 'ami' or 'b8zs' for T1 or 'ami' or 'hdb3' for E1 and BRI.
+#   * For E1 there is the optional keyword 'crc4' to enable CRC4 checking.
+#   * If the keyword 'yellow' follows, yellow alarm is transmitted when no
+#     channels are open.
 #
 #span=1,0,0,esf,b8zs
 #span=2,1,0,esf,b8zs
@@ -101,7 +100,7 @@
 #    
 #     channel# => sf:<rxfreq>,<rxbw>,<rxflag>,<txfreq>,<txlevel>,<txflag>
 #   
-#   rxfreq is rx tone freq in hz, rxbw is rx notch (and decode)
+#   rxfreq is rx tone freq in Hz, rxbw is rx notch (and decode)
 #   bandwith in hz (typically 10.0), rxflag is either 'normal' or
 #   'inverted', txfreq is tx tone freq in hz, txlevel is tx tone 
 #   level in dbm, txflag is either 'normal' or 'inverted'. Set 
@@ -240,14 +239,28 @@ defaultzone=us
 # valid values are {3125,6250,9375,12500,15625,18750,21875,25000}
 #corthresh=12500
 # Invert COR signal {y,n}
-# invertcor=y
-# # set the external tone mode; yes, no, internal {y,n,i}
+#invertcor=y
+# Set the external tone mode; yes, no, internal {y,n,i}
 #exttone=y
 #
 # Now apply the configuration to the specified channels:
 #
-# # We are all done with our channel parameters, so now we specify what
-# # channels they apply to
+# We are all done with our channel parameters, so now we specify what
+# channels they apply to
 #channels=1-4
-
-
+#
+# Overiding PCM encoding
+# ~~~~~~~~~~~~~~~~~~~~~~
+# Usually the channel driver sets the encoding of the PCM for the
+# channel (mulaw / alaw. That is: g711u or g711a). However there are
+# some cases where you would like to override that. 'mulaw' and 'alaw'
+# set different such encoding. Use them for channels you have already
+# defined with e.g. 'bchan' or 'fxoks'.
+#mulaw=1-4
+#alaw=1-4
+#
+# 'deflaw' is similar, but resets the encoding to the channel driver's
+# default. It must be useful for something, I guess.
+#mulaw=1-10
+#deflaw=5
+#