Note that readframes() returns data in linear format, even if the original

is encoded in u-LAW format.  Based on suggestion from Anthony Baxter
<anthony_baxter@users.sourceforge.net>.

This closes bug #122273.

2 files changed, 37 insertions, 1 deletions

diff --git a/Doc/lib/liblocale.tex b/Doc/lib/liblocale.tex
index 7f40f06..4cb726b 100644
--- a/Doc/lib/liblocale.tex
+++ b/Doc/lib/liblocale.tex
@@ -61,6 +61,40 @@ locale.setlocale(locale.LC_ALL,"")
   Returns the database of of the local conventions as a dictionary.
   This dictionary has the following strings as keys:
 
+  \begin{tableiii}{l|l|l}{code}{Key}{Category}{Meaning}
+    \lineiii{'decimal_point'}{\constant{LC_NUMERIC}}
+            {Decimal point character.}
+    \lineiii{'grouping'}{\constant{LC_NUMERIC}}
+            {Sequence of numbers specifying which relative positions
+             the \code{'thousands_sep'} is expected.  If the sequence is
+             terminated with \constant{CHAR_MAX}, no further grouping
+             is performed. If the sequence terminates with a \code{0}, 
+             the last group size is repeatedly used.}
+    \lineiii{'thousands_sep'}{\constant{LC_NUMERIC}}
+            {Character used between groups.}\hline
+    \lineiii{'int_curr_symbol'}{\constant{LC_MONETARY}}
+            {International currency symbol.}
+    \lineiii{'currency_symbol'}{\constant{LC_MONETARY}}
+            {Local currency symbol.}
+    \lineiii{'mon_decimal_point'}{\constant{LC_MONETARY}}
+            {Decimal point used for monetary values.}
+    \lineiii{'mon_thousands_sep'}{\constant{LC_MONETARY}}
+            {Group separator used for monetary values.}
+    \lineiii{'mon_grouping'}{\constant{LC_MONETARY}}
+            {Equivalent to \code{'grouping'}, used for monetary
+             values.}
+    \lineiii{'positive_sign'}{\constant{LC_MONETARY}}
+            {Symbol used to annotate a positive monetary value.}
+    \lineiii{'negative_sign'}{\constant{LC_MONETARY}}
+            {Symbol used to annotate a nnegative monetary value.}
+    \lineiii{'frac_digits'}{\constant{LC_MONETARY}}
+            {Number of fractional digits used in local formatting
+             of monetary values.}
+    \lineiii{'int_frac_digits'}{\constant{LC_MONETARY}}
+            {Number of fractional digits used in international
+             formatting of monetary values.}
+  \end{tableiii}
+
   \begin{itemize}
     \item
     \code{'decimal_point'} specifies the decimal point used in floating
diff --git a/Doc/lib/libsunau.tex b/Doc/lib/libsunau.tex
index e0db04d..58aa460 100644
--- a/Doc/lib/libsunau.tex
+++ b/Doc/lib/libsunau.tex
@@ -127,7 +127,9 @@ equivalent to output of the \method{get*()} methods.
 \end{methoddesc}
 
 \begin{methoddesc}[AU_read]{readframes}{n}
-Reads and returns at most \var{n} frames of audio, as a string of bytes.
+Reads and returns at most \var{n} frames of audio, as a string of
+bytes.  The data will be returned in linear format.  If the original
+data is in u-LAW format, it will be converted.
 \end{methoddesc}
 
 \begin{methoddesc}[AU_read]{rewind}{}