[Python-checkins] CVS: python/dist/src/Doc/lib liblocale.tex,1.27,1.28

[Martin v. L?wis]

Update of /cvsroot/python/python/dist/src/Doc/lib
In directory usw-pr-cvs1:/tmp/cvs-serv3702/Doc/lib

Modified Files:
	liblocale.tex 
Log Message:
Expose C library's gettext. Fixes #516412.


Index: liblocale.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/lib/liblocale.tex,v
retrieving revision 1.27
retrieving revision 1.28
diff -C2 -d -r1.27 -r1.28
*** liblocale.tex	20 Oct 2001 04:24:09 -0000	1.27
--- liblocale.tex	27 Mar 2002 18:49:02 -0000	1.28
***************
*** 468,469 ****
--- 468,487 ----
  table of built-in modules in the \file{config.c} file, and make sure
  that the \module{_locale} module is not accessible as a shared library.
+ 
+ \subsection{Access to message catalogs}
+ 
+ The locale module exposes the C library's gettext interface on systems
+ that provide this interface. It consists of the functions
+ \function{gettext}, \function{dgettext}, \function{dcgettext},
+ \function{textdomain}, and \function{bindtextdomain}. These are
+ similar to the same functions in the \module{gettext} module, but use
+ the C library's binary format for message catalogs, and the C
+ library's search algorithms for locating message catalogs. 
+ 
+ Python applications should normally find no need to invoke these
+ functions, and should use \module{gettext} instead. A known exception
+ to this rule are applications that link use additional C libraries
+ which internally invoke \function{gettext} or \function{dgettext}. For
+ these applications, it may be necessary to bind the text domain, so
+ that the libraries can properly locate their message catalogs.
+