vrana Tue Apr 27 07:31:05 2004 EDT
Modified files:
/phpdoc/en/reference/gettext/functions bind-textdomain-codeset.xml
dcgettext.xml dcngettext.xml
dgettext.xml dngettext.xml
ngettext.xml
Log:
Undocumented functions
http://cvs.php.net/diff.php/phpdoc/en/reference/gettext/functions/bind-textdomain-codeset.xml?r1=1.2&r2=1.3&ty=u
Index: phpdoc/en/reference/gettext/functions/bind-textdomain-codeset.xml
diff -u phpdoc/en/reference/gettext/functions/bind-textdomain-codeset.xml:1.2
phpdoc/en/reference/gettext/functions/bind-textdomain-codeset.xml:1.3
--- phpdoc/en/reference/gettext/functions/bind-textdomain-codeset.xml:1.2 Wed
Apr 17 02:38:20 2002
+++ phpdoc/en/reference/gettext/functions/bind-textdomain-codeset.xml Tue Apr 27
07:31:05 2004
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.2 $ -->
+<!-- $Revision: 1.3 $ -->
<!-- splitted from ./en/functions/gettext.xml, last change in rev 1.17 -->
<refentry id='function.bind-textdomain-codeset'>
<refnamediv>
@@ -17,7 +17,9 @@
<methodparam><type>string</type><parameter>codeset</parameter></methodparam>
</methodsynopsis>
<para>
- &warn.undocumented.func;
+ With <function>bind_textdomain_codeset</function>, you can set in which
+ encoding will be messages from <parameter>domain</parameter> returned by
+ <function>gettext</function> and similar functions.
</para>
</refsect1>
</refentry>
http://cvs.php.net/diff.php/phpdoc/en/reference/gettext/functions/dcgettext.xml?r1=1.2&r2=1.3&ty=u
Index: phpdoc/en/reference/gettext/functions/dcgettext.xml
diff -u phpdoc/en/reference/gettext/functions/dcgettext.xml:1.2
phpdoc/en/reference/gettext/functions/dcgettext.xml:1.3
--- phpdoc/en/reference/gettext/functions/dcgettext.xml:1.2 Wed Apr 17 02:38:20
2002
+++ phpdoc/en/reference/gettext/functions/dcgettext.xml Tue Apr 27 07:31:05 2004
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.2 $ -->
+<!-- $Revision: 1.3 $ -->
<!-- splitted from ./en/functions/gettext.xml, last change in rev 1.2 -->
<refentry id="function.dcgettext">
<refnamediv>
@@ -19,6 +19,9 @@
single message lookup. It also allows you to specify a
<parameter>category</parameter>.
</para>
+ <para>
+ See also <function>gettext</function>.
+ </para>
</refsect1>
</refentry>
http://cvs.php.net/diff.php/phpdoc/en/reference/gettext/functions/dcngettext.xml?r1=1.2&r2=1.3&ty=u
Index: phpdoc/en/reference/gettext/functions/dcngettext.xml
diff -u phpdoc/en/reference/gettext/functions/dcngettext.xml:1.2
phpdoc/en/reference/gettext/functions/dcngettext.xml:1.3
--- phpdoc/en/reference/gettext/functions/dcngettext.xml:1.2 Wed Apr 17 02:38:20
2002
+++ phpdoc/en/reference/gettext/functions/dcngettext.xml Tue Apr 27 07:31:05
2004
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.2 $ -->
+<!-- $Revision: 1.3 $ -->
<!-- splitted from ./en/functions/gettext.xml, last change in rev 1.16 -->
<refentry id='function.dcngettext'>
<refnamediv>
@@ -17,7 +17,12 @@
<methodparam><type>int</type><parameter>category</parameter></methodparam>
</methodsynopsis>
<para>
- &warn.undocumented.func;
+ This function allows you to override the current domain for a
+ single plural message lookup. It also allows you to specify a
+ <parameter>category</parameter>.
+ </para>
+ <para>
+ See also <function>ngettext</function>.
</para>
</refsect1>
</refentry>
http://cvs.php.net/diff.php/phpdoc/en/reference/gettext/functions/dgettext.xml?r1=1.2&r2=1.3&ty=u
Index: phpdoc/en/reference/gettext/functions/dgettext.xml
diff -u phpdoc/en/reference/gettext/functions/dgettext.xml:1.2
phpdoc/en/reference/gettext/functions/dgettext.xml:1.3
--- phpdoc/en/reference/gettext/functions/dgettext.xml:1.2 Wed Apr 17 02:38:21
2002
+++ phpdoc/en/reference/gettext/functions/dgettext.xml Tue Apr 27 07:31:05 2004
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.2 $ -->
+<!-- $Revision: 1.3 $ -->
<!-- splitted from ./en/functions/gettext.xml, last change in rev 1.2 -->
<refentry id="function.dgettext">
<refnamediv>
@@ -17,6 +17,9 @@
The <function>dgettext</function> function allows you to override
the current domain for a single message lookup.
</para>
+ <para>
+ See also <function>gettext</function>.
+ </para>
</refsect1>
</refentry>
http://cvs.php.net/diff.php/phpdoc/en/reference/gettext/functions/dngettext.xml?r1=1.2&r2=1.3&ty=u
Index: phpdoc/en/reference/gettext/functions/dngettext.xml
diff -u phpdoc/en/reference/gettext/functions/dngettext.xml:1.2
phpdoc/en/reference/gettext/functions/dngettext.xml:1.3
--- phpdoc/en/reference/gettext/functions/dngettext.xml:1.2 Wed Apr 17 02:38:21
2002
+++ phpdoc/en/reference/gettext/functions/dngettext.xml Tue Apr 27 07:31:05 2004
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.2 $ -->
+<!-- $Revision: 1.3 $ -->
<!-- splitted from ./en/functions/gettext.xml, last change in rev 1.16 -->
<refentry id='function.dngettext'>
<refnamediv>
@@ -16,7 +16,11 @@
<methodparam><type>int</type><parameter>n</parameter></methodparam>
</methodsynopsis>
<para>
- &warn.undocumented.func;
+ The <function>dngettext</function> function allows you to override
+ the current domain for a single plural message lookup.
+ </para>
+ <para>
+ See also <function>ngettext</function>.
</para>
</refsect1>
</refentry>
http://cvs.php.net/diff.php/phpdoc/en/reference/gettext/functions/ngettext.xml?r1=1.2&r2=1.3&ty=u
Index: phpdoc/en/reference/gettext/functions/ngettext.xml
diff -u phpdoc/en/reference/gettext/functions/ngettext.xml:1.2
phpdoc/en/reference/gettext/functions/ngettext.xml:1.3
--- phpdoc/en/reference/gettext/functions/ngettext.xml:1.2 Wed Apr 17 02:38:21
2002
+++ phpdoc/en/reference/gettext/functions/ngettext.xml Tue Apr 27 07:31:05 2004
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.2 $ -->
+<!-- $Revision: 1.3 $ -->
<!-- splitted from ./en/functions/gettext.xml, last change in rev 1.16 -->
<refentry id="function.ngettext">
<refnamediv>
@@ -15,7 +15,27 @@
<methodparam><type>int</type><parameter>n</parameter></methodparam>
</methodsynopsis>
<para>
- &warn.undocumented.func;
+ <function>ngettext</function> returns correct plural form of message
+ identified by <parameter>msgid1</parameter> and <parameter>msgid2</parameter>
+ for count <parameter>n</parameter>. Some languages have more than one form
+ for plural messages dependent on the count.
+ </para>
+ <para>
+ <example>
+ <title><function>ngettext</function> example</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+
+setlocale(LC_ALL, 'cs_CZ');
+printf(ngettext("%d window", "%d windows", 1), 1); // 1 okno
+printf(ngettext("%d window", "%d windows", 2), 2); // 2 okna
+printf(ngettext("%d window", "%d windows", 5), 5); // 5 oken
+
+?>
+]]>
+ </programlisting>
+ </example>
</para>
</refsect1>
</refentry>
