[Pkg-voip-commits] r8224 - /asterisk/trunk/debian/README.Debian

[tzafrir-guest at alioth.debian.org]

Author: tzafrir-guest
Date: Fri Mar 19 23:08:42 2010
New Revision: 8224

URL: http://svn.debian.org/wsvn/pkg-voip/?sc=1&rev=8224
Log:
Document the new layout of sound files.

Still needs rephrasing

Modified:
    asterisk/trunk/debian/README.Debian

Modified: asterisk/trunk/debian/README.Debian
URL: http://svn.debian.org/wsvn/pkg-voip/asterisk/trunk/debian/README.Debian?rev=8224&op=diff
==============================================================================
--- asterisk/trunk/debian/README.Debian (original)
+++ asterisk/trunk/debian/README.Debian Fri Mar 19 23:08:42 2010
@@ -10,6 +10,7 @@
 
 Sounds reside at /usr/share/asterisk/sounds. Voicemail mailboxes are below
 /var/spool/asterisk/voicemail using symlinks.
+
 
 User, Groups, Permissions
 =========================
@@ -65,6 +66,53 @@
 of 1024 file handles, and get the error: "Too man open files".
 
 To enlarge that limit, set: MAXFILES in /etc/default/asterisk .
+As all settings from there, apply it with:
+
+  /etc/init.d/asterisk restart
+
+
+International Sound Files
+=========================
+This section is for those who use an alternative set of sound files
+rather than the default English ones recorded by Allison Smith. If you
+use those, and never needed to set LANGUAGE/language and such - all
+should work just fine.
+
+When Asterisk is asked to play 'some/file' it will search in the the
+following places on a Debian system (in whish the datadir is set to
+/usr/share/asterisk)
+
+  /usr/share/sounds/${LANG_FULL}/some/file.TYPE
+  /usr/share/sounds/${LANG}/some/file.TYPE
+  /usr/share/sounds/some/file.TYPE
+  /usr/share/sounds/en/some/file.TYPE
+
+TYPE is "the best available type" - the one that will take least
+encoding/decoding effort. This is why you normally don't specify the
+type of file to play.
+
+FULL_LANG is a complete name of a language. For instance, "fr", "de_CH"
+or "en_US_f_Allison".
+
+LANG is just the "major language" part of FULL_LANG - only up to the
+first "_", if any. So in the above examples we would get "fr", "de" and
+"en".
+
+If the language is not set, only the last two are searched.
+
+Thus various sound file packages place their files under
+/usr/share/sounds/asterisk/xx_YY_Foobar
+(for sound files set Foobar of language 'xx' and country 'YY') and will
+normally create a symlink:
+/usr/share/sounds/asterisk/xx -> xx_YY_Foobar
+
+If you install your own set of files or otherwise unhappy with the
+current default sound set for the language, just set the symlink
+manually for the language. The following will use the files from the set
+'Baz' instead:
+
+  rm /usr/share/asterisk/sounds/xx
+  ln -s xx_YY_Baz /usr/share/asterisk/sounds/xx
 
 
 Missing Modules