diff options
author | Bruno Haible <bruno@clisp.org> | 2003-02-17 20:57:07 +0000 |
---|---|---|
committer | Bruno Haible <bruno@clisp.org> | 2009-06-23 12:10:08 +0200 |
commit | e2365a8fa92547f21e3c1ab43b970ee7c0e5a506 (patch) | |
tree | ff174c64c797a62161d514efd3e0aba6316051e1 /gettext-tools/man | |
parent | d8b1ca2f5e8e59ff51f33fd931789bc42dc17ece (diff) | |
download | external_gettext-e2365a8fa92547f21e3c1ab43b970ee7c0e5a506.zip external_gettext-e2365a8fa92547f21e3c1ab43b970ee7c0e5a506.tar.gz external_gettext-e2365a8fa92547f21e3c1ab43b970ee7c0e5a506.tar.bz2 |
Move gettext-tools/man/bindtextdomain.3.in to gettext-runtime/man/bindtextdomain.3.in.
Diffstat (limited to 'gettext-tools/man')
-rw-r--r-- | gettext-tools/man/bindtextdomain.3.in | 69 |
1 files changed, 0 insertions, 69 deletions
diff --git a/gettext-tools/man/bindtextdomain.3.in b/gettext-tools/man/bindtextdomain.3.in deleted file mode 100644 index d027872..0000000 --- a/gettext-tools/man/bindtextdomain.3.in +++ /dev/null @@ -1,69 +0,0 @@ -.\" Copyright (c) Bruno Haible <haible@clisp.cons.org> -.\" -.\" This is free documentation; you can redistribute it and/or -.\" modify it under the terms of the GNU General Public License as -.\" published by the Free Software Foundation; either version 2 of -.\" the License, or (at your option) any later version. -.\" -.\" References consulted: -.\" GNU glibc-2 source code and manual -.\" GNU gettext source code and manual -.\" LI18NUX 2000 Globalization Specification -.\" -.TH BINDTEXTDOMAIN 3 "May 2001" "GNU gettext @VERSION@" -.SH NAME -bindtextdomain \- set directory containing message catalogs -.SH SYNOPSIS -.nf -.B #include <libintl.h> -.sp -.BI "char * bindtextdomain (const char * " domainname ", const char * " dirname ); -.fi -.SH DESCRIPTION -The \fBbindtextdomain\fP function sets the base directory of the hierarchy -containing message catalogs for a given message domain. -.PP -A message domain is a set of translatable \fImsgid\fP messages. Usually, -every software package has its own message domain. The need for calling -\fBbindtextdomain\fP arises because packages are not always installed with -the same prefix as the <libintl.h> header and the libc/libintl libraries. -.PP -Message catalogs will be expected at the pathnames -\fIdirname\fP/\fIlocale\fP/\fIcategory\fP/\fIdomainname\fP.mo, -where \fIlocale\fP is a locale name and \fIcategory\fP is a locale facet such -as \fBLC_MESSAGES\fP. -.PP -\fIdomainname\fP must be a non-empty string. -.PP -If \fIdirname\fP is not NULL, the base directory for message catalogs belonging -to domain \fIdomainname\fP is set to \fIdirname\fP. The function makes copies -of the argument strings as needed. If the program wishes to call the -\fBchdir\fP function, it is important that \fIdirname\fP be an absolute -pathname; otherwise it cannot be guaranteed that the message catalogs will -be found. -.PP -If \fIdirname\fP is NULL, the function returns the previously set base -directory for domain \fIdomainname\fP. -.SH "RETURN VALUE" -If successful, the \fBbindtextdomain\fP function returns the current base -directory for domain \fIdomainname\fP, after possibly changing it. The -resulting string is valid until the next \fBbindtextdomain\fP call for the -same \fIdomainname\fP and must not be modified or freed. If a memory allocation -failure occurs, it sets \fBerrno\fP to \fBENOMEM\fP and returns NULL. -.SH ERRORS -The following error can occur, among others: -.TP -.B ENOMEM -Not enough memory available. -.SH BUGS -The return type ought to be \fBconst char *\fP, but is \fBchar *\fP to avoid -warnings in C code predating ANSI C. -.SH "SEE ALSO" -.BR gettext (3), -.BR dgettext (3), -.BR dcgettext (3), -.BR ngettext (3), -.BR dngettext (3), -.BR dcngettext (3), -.BR textdomain (3), -.BR realpath (3) |