[prev in list] [next in list] [prev in thread] [next in thread]
List: pecl-cvs
Subject: [PECL-CVS] cvs: pecl /intl/doc/intl collator-constants.xml collator.xml configure.xml constants.xml
From: "Stanislav Malyshev" <stas () php ! net>
Date: 2007-11-30 0:54:04
Message-ID: cvsstas1196384044 () cvsserver
[Download RAW message or body]
stas Fri Nov 30 00:54:04 2007 UTC
Modified files:
/pecl/intl/doc/intl collator-constants.xml collator.xml
configure.xml constants.xml
locale-constants.xml locale.xml
messageformatter.xml normalizer-constants.xml
normalizer.xml numberformatter-constants.xml
numberformatter.xml reference.xml
Log:
improve formatting
["stas-20071130005404.txt" (text/plain)]
http://cvs.php.net/viewvc.cgi/pecl/intl/doc/intl/collator-constants.xml?r1=1.2&r2=1.3&diff_format=u
Index: pecl/intl/doc/intl/collator-constants.xml
diff -u pecl/intl/doc/intl/collator-constants.xml:1.2 \
pecl/intl/doc/intl/collator-constants.xml:1.3
--- pecl/intl/doc/intl/collator-constants.xml:1.2 Wed Nov 28 22:26:10 2007
+++ pecl/intl/doc/intl/collator-constants.xml Fri Nov 30 00:54:03 2007
@@ -1,158 +1,192 @@
<?xml version="1.0" encoding="UTF-8"?>
-<!-- $Revision: 1.2 $ -->
-<section xml:id="intl.collator-constants" xmlns="http://docbook.org/ns/docbook" \
xmlns:xlink="http://www.w3.org/1999/xlink"> +<!-- $Revision: 1.3 $ -->
+<section xml:id="intl.collator-constants"
+ xmlns="http://docbook.org/ns/docbook"
+ xmlns:xlink="http://www.w3.org/1999/xlink">
&reftitle.constants;
<para>
<variablelist>
<varlistentry>
<term>
- <constant>Collator::FRENCH_COLLATION</constant>
- (<type>integer</type>)
+ <constant>Collator::FRENCH_COLLATION</constant>
+ (<type>integer</type>)
</term>
<listitem>
<simpara>
- Sort strings with different accents from the back of the string. This \
attribute
- is automatically set to <emphasis>On</emphasis> for the French locales and a \
few others. Users normally would
- not need to explicitly set this attribute. There is a string comparison \
performance cost when
- it is set <emphasis>On</emphasis>, but sort key length is unaffected.
- Possible values are:
+ Sort strings with different accents from the back of the string. This
+ attribute is automatically set to
+ <emphasis>On</emphasis>
+ for the French locales and a few others. Users normally would not need
+ to explicitly set this attribute. There is a string comparison
+ performance cost when it is set
+ <emphasis>On</emphasis>
+ , but sort key length is unaffected. Possible values are:
<constant>Collator::ON</constant>
- <constant>Collator::OFF</constant> (default)
+ <constant>Collator::OFF</constant>
+ (default)
<constant>Collator::DEFAULT</constant>
</simpara>
- <para>
- <example><title>FRENCH_COLLATION rules</title>
+ <para>
+ <example>
+ <title>FRENCH_COLLATION rules</title>
<para>
- F=OFF cote < coté < côte < côté
- F=ON cote < côte < coté < côté
+ F=OFF cote < coté < côte < côté F=ON cote < côte < coté
+ < côté
</para>
</example>
- </para>
+ </para>
</listitem>
</varlistentry>
-
+
<varlistentry>
<term>
- <constant>Collator::ALTERNATE_HANDLING</constant>
- (<type>integer</type>)
+ <constant>Collator::ALTERNATE_HANDLING</constant>
+ (<type>integer</type>)
</term>
<listitem>
<para>
The Alternate attribute is used to control the handling of the socalled
- variable characters in the UCA: whitespace, punctuation and symbols. If \
Alternate is set to
- <emphasis>NonIgnorable</emphasis>(N), then differences among these characters \
are of the same importance as
- differences among letters. If Alternate is set to \
<emphasis>Shifted</emphasis>(S), then these characters are of only
- minor importance. The <emphasis>Shifted</emphasis> value is often used in \
combination with <emphasis>Strength</emphasis>
- set to Quaternary. In such a case, whitespace, punctuation, and symbols are \
considered when comparing strings,
- but only if all other aspects of the strings (base letters, accents, and case) \
are identical. If Alternate
- is not set to Shifted, then there is no difference between a Strength of 3 and \
a Strength of 4.
- For more information and examples, see Variable_Weighting in the <link \
xlink:href="&url.icu.uca;">UCA</link>.
- The reason the Alternate values are not simply <emphasis>On</emphasis> and \
<emphasis>Off</emphasis> is that additional Alternate values
- may be added in the future. The UCA option Blanked is expressed with Strength \
set to 3, and Alternate set to Shifted.
- The default for most locales is NonIgnorable. If Shifted is selected,
- it may be slower if there are many strings that are the same except for \
punctuation;
- sort key length will not be affected unless the strength level is also \
increased. + variable characters in the UCA: whitespace, punctuation and \
symbols. If + Alternate is set to <emphasis>NonIgnorable</emphasis>
+ (N), then differences among these characters are of the same importance
+ as differences among letters. If Alternate is set to
+ <emphasis>Shifted</emphasis>
+ (S), then these characters are of only minor importance. The
+ <emphasis>Shifted</emphasis> value is often used in combination with
+ <emphasis>Strength</emphasis>
+ set to Quaternary. In such a case, whitespace, punctuation, and symbols
+ are considered when comparing strings, but only if all other aspects of
+ the strings (base letters, accents, and case) are identical. If
+ Alternate is not set to Shifted, then there is no difference between a
+ Strength of 3 and a Strength of 4. For more information and examples,
+ see Variable_Weighting in the
+ <link xlink:href="&url.icu.uca;">UCA</link>
+ . The reason the Alternate values are not simply
+ <emphasis>On</emphasis> and <emphasis>Off</emphasis>
+ is that additional Alternate values may be added in the future. The UCA
+ option Blanked is expressed with Strength set to 3, and Alternate set to
+ Shifted. The default for most locales is NonIgnorable. If Shifted is
+ selected, it may be slower if there are many strings that are the same
+ except for punctuation; sort key length will not be affected unless the
+ strength level is also increased.
</para>
<para>
Possible values are:
- <constant>Collator::NON_IGNORABLE</constant> (default)
+ <constant>Collator::NON_IGNORABLE</constant>
+ (default)
<constant>Collator::SHIFTED</constant>
<constant>Collator::DEFAULT</constant>
</para>
- <para>
- <example><title>ALTERNATE_HANDLING rules</title>
+ <para>
+ <example>
+ <title>ALTERNATE_HANDLING rules</title>
<para>
- S=3, A=N di Silva < Di Silva < diSilva < U.S.A. < USA
- S=3, A=S di Silva = diSilva < Di Silva < U.S.A. = USA
- S=4, A=S di Silva < diSilva < Di Silva < U.S.A. < USA
+ S=3, A=N di Silva < Di Silva < diSilva < U.S.A. < USA S=3,
+ A=S di Silva = diSilva < Di Silva < U.S.A. = USA S=4, A=S di
+ Silva < diSilva < Di Silva < U.S.A. < USA
</para>
</example>
- </para>
+ </para>
</listitem>
</varlistentry>
<varlistentry>
<term>
- <constant>Collator::CASE_FIRST</constant>
- (<type>integer</type>)
+ <constant>Collator::CASE_FIRST</constant>
+ (<type>integer</type>)
</term>
<listitem>
- <para>
- The Case_First attribute is used to control whether uppercase letters come \
before
- lowercase letters or vice versa, in the absence of other differences in the \
strings. The possible
- values are <emphasis>Uppercase_First</emphasis> (U) and \
<emphasis>Lowercase_First</emphasis> (L),
- plus the standard <emphasis>Default</emphasis> and <emphasis>Off</emphasis>.
- There is almost no difference between the Off and Lowercase_First options in \
terms of results,
- so typically users will not use Lowercase_First: only Off or Uppercase_First. \
(People interested
- in the detailed differences between X and L should consult the Collation \
Customization).
- Specifying either L or U won't affect string comparison performance, but will \
affect the sort key
- length.
- </para>
- <para>
- Possible values are:
- <constant>Collator::OFF</constant> (default)
- <constant>Collator::LOWER_FIRST</constant>
- <constant>Collator::UPPER_FIRST</constant>
- <constant>Collator:DEFAULT</constant>
- </para>
<para>
- <example><title>CASE_FIRST rules</title>
+ The Case_First attribute is used to control whether uppercase letters
+ come before lowercase letters or vice versa, in the absence of other
+ differences in the strings. The possible values are
+ <emphasis>Uppercase_First</emphasis>
+ (U) and <emphasis>Lowercase_First</emphasis>
+ (L), plus the standard <emphasis>Default</emphasis>
+ and <emphasis>Off</emphasis>.
+ There is almost no difference between the Off and Lowercase_First
+ options in terms of results, so typically users will not use
+ Lowercase_First: only Off or Uppercase_First. (People interested in the
+ detailed differences between X and L should consult the Collation
+ Customization). Specifying either L or U won't affect string comparison
+ performance, but will affect the sort key length.
+ </para>
+ <para>
+ Possible values are:
+ <constant>Collator::OFF</constant>
+ (default)
+ <constant>Collator::LOWER_FIRST</constant>
+ <constant>Collator::UPPER_FIRST</constant>
+ <constant>Collator:DEFAULT</constant>
+ </para>
+ <para>
+ <example>
+ <title>CASE_FIRST rules</title>
<para>
- C=X or C=L "china" < "China" < "denmark" < "Denmark"
- C=U "China" < "china" < "Denmark" < "denmark"
+ C=X or C=L "china" < "China" < "denmark" < "Denmark" C=U
+ "China" < "china" < "Denmark" < "denmark"
</para>
</example>
- </para>
+ </para>
</listitem>
</varlistentry>
<varlistentry>
<term>
- <constant>Collator::CASE_LEVEL</constant>
- (<type>integer</type>)
+ <constant>Collator::CASE_LEVEL</constant>
+ (<type>integer</type>)
</term>
<listitem>
<para>
- The Case_Level attribute is used when ignoring accents but not case. In such a \
situation,
- set Strength to be <emphasis>Primary</emphasis>, and Case_Level to be \
<emphasis>On</emphasis>. In most locales, this setting is Off by \
default.
- There is a small string comparison performance and sort key impact if this \
attribute is set to be <emphasis>On</emphasis>. + The Case_Level attribute is \
used when ignoring accents but not case. In + such a situation, set Strength to \
be <emphasis>Primary</emphasis>, + and Case_Level to be <emphasis>On</emphasis>.
+ In most locales, this setting is Off by default. There is a small
+ string comparison performance and sort key impact if this attribute is
+ set to be <emphasis>On</emphasis>.
</para>
<para>
Possible values are:
- <constant>Collator::OFF</constant> (default)
+ <constant>Collator::OFF</constant>
+ (default)
<constant>Collator::ON</constant>
<constant>Collator::DEFAULT</constant>
</para>
- <para>
- <example><title>CASE_LEVEL rules</title>
- <para>
- S=1, E=X role = Role = rôle
- S=1, E=O role = rôle < Role
- </para>
+ <para>
+ <example>
+ <title>CASE_LEVEL rules</title>
+ <para>S=1, E=X role = Role = rôle S=1, E=O role = rôle < Role</para>
</example>
- </para>
+ </para>
</listitem>
</varlistentry>
<varlistentry>
<term>
- <constant>Collator::NORMALIZATION_MODE</constant>
- (<type>integer</type>)
+ <constant>Collator::NORMALIZATION_MODE</constant>
+ (<type>integer</type>)
</term>
<listitem>
<para>
- The Normalization setting determines whether text is thoroughly normalized
- or not in comparison. Even if the setting is off (which is the default for \
many locales), text as
- represented in common usage will compare correctly (for details, see UTN #5). \
Only if the accent
- marks are in noncanonical order will there be a problem. If the setting is \
<emphasis>On</emphasis>, then the best
- results are guaranteed for all possible text input. There is a medium string \
comparison performance
- cost if this attribute is <emphasis>On</emphasis>, depending on the frequency \
of sequences that require normalization.
- There is no significant effect on sort key length. If the input text is known \
to be in NFD or NFKD
- normalization forms, there is no need to enable this Normalization option.
+ The Normalization setting determines whether text is thoroughly
+ normalized or not in comparison. Even if the setting is off (which is
+ the default for many locales), text as represented in common usage will
+ compare correctly (for details, see UTN #5). Only if the accent marks
+ are in noncanonical order will there be a problem. If the setting is
+ <emphasis>On</emphasis>
+ , then the best results are guaranteed for all possible text input.
+ There is a medium string comparison performance cost if this attribute
+ is
+ <emphasis>On</emphasis>
+ , depending on the frequency of sequences that require normalization.
+ There is no significant effect on sort key length. If the input text is
+ known to be in NFD or NFKD normalization forms, there is no need to
+ enable this Normalization option.
</para>
<para>
Possible values are:
- <constant>Collator::OFF</constant> (default)
+ <constant>Collator::OFF</constant>
+ (default)
<constant>Collator::ON</constant>
<constant>Collator::DEFAULT</constant>
</para>
@@ -161,23 +195,26 @@
<varlistentry>
<term>
- <constant>Collator::STRENGTH</constant>
- (<type>integer</type>)
+ <constant>Collator::STRENGTH</constant>
+ (<type>integer</type>)
</term>
<listitem>
<para>
- The ICU Collation Service supports many levels of comparison (named "Levels", \
but also
- known as "Strengths"). Having these categories enables ICU to sort strings \
precisely
- according to local conventions. However, by allowing the levels to be \
selectively
- employed, searching for a string in text can be performed with various \
matching
- conditions.
- For more detailed information, see <function>collator-setStrength</function> \
chapter. + The ICU Collation Service supports many levels of comparison (named
+ "Levels", but also known as "Strengths"). Having these categories
+ enables ICU to sort strings precisely according to local conventions.
+ However, by allowing the levels to be selectively employed, searching
+ for a string in text can be performed with various matching conditions.
+ For more detailed information, see
+ <function>collator-setStrength</function> chapter.
</para>
<para>
Possible values are:
<constant>Collator::PRIMARY</constant>
- <constant>Collator::SECONDARY</constant>,
- <constant>Collator::TERTIARY</constant> (default)
+ <constant>Collator::SECONDARY</constant>
+ ,
+ <constant>Collator::TERTIARY</constant>
+ (default)
<constant>Collator::QUATERNARY</constant>
<constant>Collator::IDENTICAL</constant>
<constant>Collator::DEFAULT</constant>
@@ -187,38 +224,43 @@
<varlistentry>
<term>
- <constant>Collator::HIRAGANA_QUATERNARY_MODE</constant>
- (<type>integer</type>)
+ <constant>Collator::HIRAGANA_QUATERNARY_MODE</constant>
+ (<type>integer</type>)
</term>
<listitem>
<para>
Compatibility with JIS x 4061 requires the introduction of an additional
- level to distinguish Hiragana and Katakana characters. If compatibility with \
that standard is required,
- then this attribute should be set <emphasis>On</emphasis>, and the strength \
set to Quaternary. This will affect sort key
- length and string comparison string comparison performance.
+ level to distinguish Hiragana and Katakana characters. If compatibility
+ with that standard is required, then this attribute should be set
+ <emphasis>On</emphasis>
+ , and the strength set to Quaternary. This will affect sort key length
+ and string comparison string comparison performance.
</para>
<para>
Possible values are:
- <constant>Collator::OFF</constant> (default)
+ <constant>Collator::OFF</constant>
+ (default)
<constant>Collator::ON</constant>
<constant>Collator::DEFAULT</constant>
- </para>
+ </para>
</listitem>
</varlistentry>
<varlistentry>
<term>
- <constant>Collator::NUMERIC_COLLATION</constant>
- (<type>integer</type>)
+ <constant>Collator::NUMERIC_COLLATION</constant>
+ (<type>integer</type>)
</term>
<listitem>
<para>
- When turned on, this attribute generates a collation key for the numeric value \
of substrings of digits.
- This is a way to get '100' to sort AFTER '2'.
+ When turned on, this attribute generates a collation key for the numeric
+ value of substrings of digits. This is a way to get '100' to sort AFTER
+ '2'.
</para>
<para>
Possible values are:
- <constant>Collator::OFF</constant> (default)
+ <constant>Collator::OFF</constant>
+ (default)
<constant>Collator::ON</constant>
<constant>Collator::DEFAULT</constant>
</para>
@@ -227,8 +269,8 @@
<varlistentry>
<term>
- <constant>Collator::DEFAULT_VALUE</constant>
- (<type>integer</type>)
+ <constant>Collator::DEFAULT_VALUE</constant>
+ (<type>integer</type>)
</term>
<listitem>
<simpara>
@@ -239,8 +281,8 @@
<varlistentry>
<term>
- <constant>Collator::PRIMARY</constant>
- (<type>integer</type>)
+ <constant>Collator::PRIMARY</constant>
+ (<type>integer</type>)
</term>
<listitem>
<simpara>
@@ -251,8 +293,8 @@
<varlistentry>
<term>
- <constant>Collator::SECONDARY</constant>
- (<type>integer</type>)
+ <constant>Collator::SECONDARY</constant>
+ (<type>integer</type>)
</term>
<listitem>
<simpara>
@@ -263,8 +305,8 @@
<varlistentry>
<term>
- <constant>Collator::TERTIARY</constant>
- (<type>integer</type>)
+ <constant>Collator::TERTIARY</constant>
+ (<type>integer</type>)
</term>
<listitem>
<simpara>
@@ -275,8 +317,8 @@
<varlistentry>
<term>
- <constant>Collator::DEFAULT_STRENGTH</constant>
- (<type>integer</type>)
+ <constant>Collator::DEFAULT_STRENGTH</constant>
+ (<type>integer</type>)
</term>
<listitem>
<simpara>
@@ -287,8 +329,8 @@
<varlistentry>
<term>
- <constant>Collator::QUATERNARY</constant>
- (<type>integer</type>)
+ <constant>Collator::QUATERNARY</constant>
+ (<type>integer</type>)
</term>
<listitem>
<simpara>
@@ -299,8 +341,8 @@
<varlistentry>
<term>
- <constant>Collator::IDENTICAL</constant>
- (<type>integer</type>)
+ <constant>Collator::IDENTICAL</constant>
+ (<type>integer</type>)
</term>
<listitem>
<simpara>
@@ -311,8 +353,8 @@
<varlistentry>
<term>
- <constant>Collator::OFF</constant>
- (<type>integer</type>)
+ <constant>Collator::OFF</constant>
+ (<type>integer</type>)
</term>
<listitem>
<simpara>
@@ -323,8 +365,8 @@
<varlistentry>
<term>
- <constant>Collator::ON</constant>
- (<type>integer</type>)
+ <constant>Collator::ON</constant>
+ (<type>integer</type>)
</term>
<listitem>
<simpara>
@@ -335,8 +377,8 @@
<varlistentry>
<term>
- <constant>Collator::SHIFTED</constant>
- (<type>integer</type>)
+ <constant>Collator::SHIFTED</constant>
+ (<type>integer</type>)
</term>
<listitem>
<simpara>
@@ -347,8 +389,8 @@
<varlistentry>
<term>
- <constant>Collator::NON_IGNORABLE</constant>
- (<type>integer</type>)
+ <constant>Collator::NON_IGNORABLE</constant>
+ (<type>integer</type>)
</term>
<listitem>
<simpara>
@@ -359,8 +401,8 @@
<varlistentry>
<term>
- <constant>Collator::LOWER_FIRST</constant>
- (<type>integer</type>)
+ <constant>Collator::LOWER_FIRST</constant>
+ (<type>integer</type>)
</term>
<listitem>
<simpara>
@@ -371,8 +413,8 @@
<varlistentry>
<term>
- <constant>Collator::UPPER_FIRST</constant>
- (<type>integer</type>)
+ <constant>Collator::UPPER_FIRST</constant>
+ (<type>integer</type>)
</term>
<listitem>
<simpara>
http://cvs.php.net/viewvc.cgi/pecl/intl/doc/intl/collator.xml?r1=1.1&r2=1.2&diff_format=u
Index: pecl/intl/doc/intl/collator.xml
diff -u pecl/intl/doc/intl/collator.xml:1.1 pecl/intl/doc/intl/collator.xml:1.2
--- pecl/intl/doc/intl/collator.xml:1.1 Mon Nov 26 22:32:36 2007
+++ pecl/intl/doc/intl/collator.xml Fri Nov 30 00:54:03 2007
@@ -1,13 +1,15 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision: 1.1 $ -->
+<!-- $Revision: 1.2 $ -->
-<reference xml:id="class.collator" xmlns="http://docbook.org/ns/docbook" \
xmlns:xlink="http://www.w3.org/1999/xlink" \
xmlns:xi="http://www.w3.org/2001/XInclude"> +<reference xml:id="class.collator" \
xmlns="http://docbook.org/ns/docbook" + xmlns:xlink="http://www.w3.org/1999/xlink"
+ xmlns:xi="http://www.w3.org/2001/XInclude">
<title>The Collator class</title>
<titleabbrev>Collator</titleabbrev>
-
+
<partintro>
-
-<!-- {{{ Collator intro -->
+
+ <!-- {{{ Collator intro -->
<section xml:id="collator.intro">
&reftitle.intro;
<para>
@@ -15,82 +17,86 @@
locale-sensitive sort orderings.
</para>
</section>
-<!-- }}} -->
-
+ <!-- }}} -->
+
<section xml:id="collator.synopsis">
<title>Class synopsis</title>
-
-<!-- {{{ Synopsis -->
+
+ <!-- {{{ Synopsis -->
<classsynopsis>
- <ooclass><classname>Collator</classname></ooclass>
-
-<!-- {{{ Class synopsis -->
-<!--
- <classsynopsisinfo>
+ <ooclass>
+ <classname>Collator</classname>
+ </ooclass>
+
+ <!-- {{{ Class synopsis -->
+ <!--
+ <classsynopsisinfo>
<ooclass>
- <classname>Collator</classname>
+ <classname>Collator</classname>
</ooclass>
- </classsynopsisinfo>
--->
-<!-- }}} -->
-
-<!--
- <classsynopsisinfo role="comment">Properties</classsynopsisinfo>
- <fieldsynopsis>
+ </classsynopsisinfo>
+ -->
+ <!-- }}} -->
+
+ <!--
+ <classsynopsisinfo role="comment">Properties</classsynopsisinfo>
+ <fieldsynopsis>
<modifier>public</modifier>
<type>string</type>
<varname linkend="collator.props.name">name</varname>
- </fieldsynopsis>
-
- <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) \
xpointer(id('class.collator')/db:refentry/db:refsect1[@role='description']/descendant::db:fieldsynopsis[1])" \
/>
--->
-
+ </fieldsynopsis>
+
+ <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) \
xpointer(id('class.collator')/db:refentry/db:refsect1[@role='description']/descendant::db:fieldsynopsis[1])" \
/> + -->
+
<classsynopsisinfo role="comment">Methods</classsynopsisinfo>
- <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) \
xpointer(id('class.collator')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis[1])" \
/>
- <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) \
xpointer(id('class.collator')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[1])" \
/> + <xi:include
+ xpointer="xmlns(db=http://docbook.org/ns/docbook) \
xpointer(id('class.collator')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis[1])" \
/> + <xi:include
+ xpointer="xmlns(db=http://docbook.org/ns/docbook) \
xpointer(id('class.collator')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[1])" \
/> </classsynopsis>
-<!-- }}} -->
-
+ <!-- }}} -->
+
</section>
-
-<!-- {{{ Collator properties
- <section xml:id="collator.props">
+
+ <!-- {{{ Collator properties
+ <section xml:id="collator.props">
&reftitle.properties;
<variablelist>
- <varlistentry xml:id="collator.props.name">
- <term><varname>name</varname></term>
- <listitem>
- <para>Prop description</para>
- </listitem>
- </varlistentry>
+ <varlistentry xml:id="collator.props.name">
+ <term><varname>name</varname></term>
+ <listitem>
+ <para>Prop description</para>
+ </listitem>
+ </varlistentry>
</variablelist>
- </section>
-}}} -->
-
+ </section>
+ }}} -->
+
&reference.intl.collator-constants;
</partintro>
-
+
&reference.intl.collator.entities;
-
+
</reference>
-
+
<!-- Keep this comment at the end of the file
-Local variables:
-mode: sgml
-sgml-omittag:t
-sgml-shorttag:t
-sgml-minimize-attributes:nil
-sgml-always-quote-attributes:t
-sgml-indent-step:1
-sgml-indent-data:t
-indent-tabs-mode:nil
-sgml-parent-document:nil
-sgml-default-dtd-file:"../../../../manual.ced"
-sgml-exposed-tags:nil
-sgml-local-catalogs:nil
-sgml-local-ecat-files:nil
-End:
-vim600: syn=xml fen fdm=syntax fdl=2 si
-vim: et tw=78 syn=sgml
-vi: ts=1 sw=1
+ Local variables:
+ mode: sgml
+ sgml-omittag:t
+ sgml-shorttag:t
+ sgml-minimize-attributes:nil
+ sgml-always-quote-attributes:t
+ sgml-indent-step:1
+ sgml-indent-data:t
+ indent-tabs-mode:nil
+ sgml-parent-document:nil
+ sgml-default-dtd-file:"../../../../manual.ced"
+ sgml-exposed-tags:nil
+ sgml-local-catalogs:nil
+ sgml-local-ecat-files:nil
+ End:
+ vim600: syn=xml fen fdm=syntax fdl=2 si
+ vim: et tw=78 syn=sgml
+ vi: ts=1 sw=1
-->
http://cvs.php.net/viewvc.cgi/pecl/intl/doc/intl/configure.xml?r1=1.1&r2=1.2&diff_format=u
Index: pecl/intl/doc/intl/configure.xml
diff -u pecl/intl/doc/intl/configure.xml:1.1 pecl/intl/doc/intl/configure.xml:1.2
--- pecl/intl/doc/intl/configure.xml:1.1 Thu Aug 2 00:21:47 2007
+++ pecl/intl/doc/intl/configure.xml Fri Nov 30 00:54:03 2007
@@ -1,48 +1,48 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision: 1.1 $ -->
+<!-- $Revision: 1.2 $ -->
<section xml:id="intl.building" xmlns="http://docbook.org/ns/docbook">
<title>Building</title>
<para>
- Let's assume that you have installed PHP to <emphasis>/opt/php5/</emphasis> and \
ICU is
- installed to <emphasis>/opt/icu/</emphasis>. Run the following commands:
+ Let's assume that you have installed PHP to
+ <emphasis>/opt/php5/</emphasis>
+ and ICU is installed to
+ <emphasis>/opt/icu/</emphasis>. Run the following commands:
</para>
<screen>
-$ /opt/php5/bin/phpize
-$ ./configure --with-php-config=/opt/php5/bin/php-config \
- --with-icu-dir=/opt/icu
-$ make
+ $ /opt/php5/bin/phpize $ ./configure
+ --with-php-config=/opt/php5/bin/php-config \ --with-icu-dir=/opt/icu $ make
</screen>
<para>
- If your ICU is installed to a non-standard directory then you might want to \
specify its location
- in <constant>LD_LIBRARY_PATH</constant> environment variable so that dynamic \
linker can find it: + If your ICU is installed to a non-standard directory then you \
might want to + specify its location in
+ <constant>LD_LIBRARY_PATH</constant>
+ environment variable so that dynamic linker can find it:
</para>
- <screen>
- $ export LD_LIBRARY_PATH=/opt/icu/lib
- </screen>
+ <screen>$ export LD_LIBRARY_PATH=/opt/icu/lib</screen>
<para>
- Otherwise, if PHP and ICU are installed to their default locations, then
- the additional options to `configure' are not needed.
+ Otherwise, if PHP and ICU are installed to their default locations, then the
+ additional options to `configure' are not needed.
</para>
</section>
<!-- Keep this comment at the end of the file
-Local variables:
-mode: sgml
-sgml-omittag:t
-sgml-shorttag:t
-sgml-minimize-attributes:nil
-sgml-always-quote-attributes:t
-sgml-indent-step:1
-sgml-indent-data:t
-indent-tabs-mode:nil
-sgml-parent-document:nil
-sgml-default-dtd-file:"../../../manual.ced"
-sgml-exposed-tags:nil
-sgml-local-catalogs:nil
-sgml-local-ecat-files:nil
-End:
-vim600: syn=xml fen fdm=syntax fdl=2 si
-vim: et tw=78 syn=sgml
-vi: ts=1 sw=1
+ Local variables:
+ mode: sgml
+ sgml-omittag:t
+ sgml-shorttag:t
+ sgml-minimize-attributes:nil
+ sgml-always-quote-attributes:t
+ sgml-indent-step:1
+ sgml-indent-data:t
+ indent-tabs-mode:nil
+ sgml-parent-document:nil
+ sgml-default-dtd-file:"../../../manual.ced"
+ sgml-exposed-tags:nil
+ sgml-local-catalogs:nil
+ sgml-local-ecat-files:nil
+ End:
+ vim600: syn=xml fen fdm=syntax fdl=2 si
+ vim: et tw=78 syn=sgml
+ vi: ts=1 sw=1
-->
http://cvs.php.net/viewvc.cgi/pecl/intl/doc/intl/constants.xml?r1=1.5&r2=1.6&diff_format=u
Index: pecl/intl/doc/intl/constants.xml
diff -u pecl/intl/doc/intl/constants.xml:1.5 pecl/intl/doc/intl/constants.xml:1.6
--- pecl/intl/doc/intl/constants.xml:1.5 Mon Nov 26 22:32:36 2007
+++ pecl/intl/doc/intl/constants.xml Fri Nov 30 00:54:03 2007
@@ -1,27 +1,28 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision: 1.5 $ -->
-<appendix xml:id="intl.constants" xmlns="http://docbook.org/ns/docbook" \
xmlns:xlink="http://www.w3.org/1999/xlink"> +<!-- $Revision: 1.6 $ -->
+<appendix xml:id="intl.constants" xmlns="http://docbook.org/ns/docbook"
+ xmlns:xlink="http://www.w3.org/1999/xlink">
&reftitle.constants;
&no.constants;
</appendix>
<!-- Keep this comment at the end of the file
-Local variables:
-mode: sgml
-sgml-omittag:t
-sgml-shorttag:t
-sgml-minimize-attributes:nil
-sgml-always-quote-attributes:t
-sgml-indent-step:1
-sgml-indent-data:t
-indent-tabs-mode:nil
-sgml-parent-document:nil
-sgml-default-dtd-file:"../../../manual.ced"
-sgml-exposed-tags:nil
-sgml-local-catalogs:nil
-sgml-local-ecat-files:nil
-End:
-vim600: syn=xml fen fdm=syntax fdl=2 si
-vim: et tw=78 syn=sgml
-vi: ts=1 sw=1
+ Local variables:
+ mode: sgml
+ sgml-omittag:t
+ sgml-shorttag:t
+ sgml-minimize-attributes:nil
+ sgml-always-quote-attributes:t
+ sgml-indent-step:1
+ sgml-indent-data:t
+ indent-tabs-mode:nil
+ sgml-parent-document:nil
+ sgml-default-dtd-file:"../../../manual.ced"
+ sgml-exposed-tags:nil
+ sgml-local-catalogs:nil
+ sgml-local-ecat-files:nil
+ End:
+ vim600: syn=xml fen fdm=syntax fdl=2 si
+ vim: et tw=78 syn=sgml
+ vi: ts=1 sw=1
-->
http://cvs.php.net/viewvc.cgi/pecl/intl/doc/intl/locale-constants.xml?r1=1.2&r2=1.3&diff_format=u
Index: pecl/intl/doc/intl/locale-constants.xml
diff -u pecl/intl/doc/intl/locale-constants.xml:1.2 \
pecl/intl/doc/intl/locale-constants.xml:1.3
--- pecl/intl/doc/intl/locale-constants.xml:1.2 Wed Nov 28 22:26:10 2007
+++ pecl/intl/doc/intl/locale-constants.xml Fri Nov 30 00:54:03 2007
@@ -1,156 +1,143 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision: 1.2 $ -->
-<section xml:id="intl.locale-constants" xmlns="http://docbook.org/ns/docbook" \
xmlns:xlink="http://www.w3.org/1999/xlink"> +<!-- $Revision: 1.3 $ -->
+<section xml:id="intl.locale-constants" xmlns="http://docbook.org/ns/docbook"
+ xmlns:xlink="http://www.w3.org/1999/xlink">
&reftitle.constants;
<para>
- These constants define how the Locale
- <variablelist>
- <varlistentry>
+ These constants define how the Locale
+ <variablelist>
+ <varlistentry>
<term>
- <constant>Locale::DEFAULT_LOCALE</constant>
- (<type>string</type>)
+ <constant>Locale::DEFAULT_LOCALE</constant>
+ (<type>string</type>)
</term>
<listitem>
- <simpara>
- Used with the getLocale methods of the various locale affected classes, such \
as numfmt.
- </simpara>
+ <simpara>
+ Used with the getLocale methods of the various locale affected classes,
+ such as numfmt.
+ </simpara>
</listitem>
- </varlistentry>
+ </varlistentry>
- <varlistentry>
+ <varlistentry>
<term>
- <constant>Locale::ACTUAL_LOCALE</constant>
- (<type>string</type>)
+ <constant>Locale::ACTUAL_LOCALE</constant>
+ (<type>string</type>)
</term>
<listitem>
- <simpara>
- This is locale the data actually comes from.
- </simpara>
+ <simpara>This is locale the data actually comes from.</simpara>
</listitem>
- </varlistentry>
+ </varlistentry>
- <varlistentry>
+ <varlistentry>
<term>
- <constant>Locale::VALID_LOCALE</constant>
- (<type>string</type>)
+ <constant>Locale::VALID_LOCALE</constant>
+ (<type>string</type>)
</term>
<listitem>
- <simpara>
- This is the most specific locale supported by ICU.
- </simpara>
+ <simpara>This is the most specific locale supported by ICU.</simpara>
</listitem>
- </varlistentry>
- </variablelist>
- </para>
+ </varlistentry>
+ </variablelist>
+ </para>
- <section xml:id="intl.locale-constants.subtags">
- <para>
- These constants define how the Locales are parsed or composed. They should be used \
as keys in the argument array to <function>locale_compose</function> and are returned \
from <function>locale_parse</function> as keys of the returned \
asoociative array.
- <variablelist>
- <varlistentry>
- <term>
+ <section xml:id="intl.locale-constants.subtags">
+ <para>
+ These constants define how the Locales are parsed or composed. They should
+ be used as keys in the argument array to <function>locale_compose</function>
+ and are returned from <function>locale_parse</function>
+ as keys of the returned asoociative array.
+ <variablelist>
+ <varlistentry>
+ <term>
<constant>Locale::LANG_TAG</constant>
(<type>string</type>)
- </term>
- <listitem>
- <simpara>
- Language subtag
- </simpara>
- </listitem>
- </varlistentry>
+ </term>
+ <listitem>
+ <simpara>Language subtag</simpara>
+ </listitem>
+ </varlistentry>
- <varlistentry>
- <term>
+ <varlistentry>
+ <term>
<constant>Locale::EXTLANG_TAG</constant>
(<type>string</type>)
- </term>
- <listitem>
- <simpara>
- Extended language subtag
- </simpara>
- </listitem>
- </varlistentry>
+ </term>
+ <listitem>
+ <simpara>Extended language subtag</simpara>
+ </listitem>
+ </varlistentry>
- <varlistentry>
- <term>
+ <varlistentry>
+ <term>
<constant>Locale::SCRIPT_TAG</constant>
(<type>string</type>)
- </term>
- <listitem>
- <simpara>
- Script subtag
- </simpara>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>
+ </term>
+ <listitem>
+ <simpara>Script subtag</simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
<constant>Locale::REGION_TAG</constant>
(<type>string</type>)
- </term>
- <listitem>
- <simpara>
- Region subtag
- </simpara>
- </listitem>
- </varlistentry>
+ </term>
+ <listitem>
+ <simpara>Region subtag</simpara>
+ </listitem>
+ </varlistentry>
- <varlistentry>
- <term>
+ <varlistentry>
+ <term>
<constant>Locale::VARIANT_TAG</constant>
(<type>string</type>)
- </term>
- <listitem>
- <simpara>
- Variant subtag
- </simpara>
- </listitem>
- </varlistentry>
+ </term>
+ <listitem>
+ <simpara>Variant subtag</simpara>
+ </listitem>
+ </varlistentry>
- <varlistentry>
- <term>
+ <varlistentry>
+ <term>
<constant>Locale::GRANDFATHERED_LANG_TAG</constant>
(<type>string</type>)
- </term>
- <listitem>
- <simpara>
- Grandfatherd Language subtag
- </simpara>
- </listitem>
- </varlistentry>
+ </term>
+ <listitem>
+ <simpara>Grandfatherd Language subtag</simpara>
+ </listitem>
+ </varlistentry>
- <varlistentry>
- <term>
+ <varlistentry>
+ <term>
<constant>Locale::PRIVATE_TAG</constant>
(<type>string</type>)
- </term>
- <listitem>
- <simpara>
- Private subtag
- </simpara>
- </listitem>
- </varlistentry>
- </variablelist>
- </para>
+ </term>
+ <listitem>
+ <simpara>Private subtag</simpara>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
</section>
</section>
-
+
<!-- Keep this comment at the end of the file
-Local variables:
-mode: sgml
-sgml-omittag:t
-sgml-shorttag:t
-sgml-minimize-attributes:nil
-sgml-always-quote-attributes:t
-sgml-indent-step:1
-sgml-indent-data:t
-indent-tabs-mode:nil
-sgml-parent-document:nil
-sgml-default-dtd-file:"../../../../manual.ced"
-sgml-exposed-tags:nil
-sgml-local-catalogs:nil
-sgml-local-ecat-files:nil
-End:
-vim600: syn=xml fen fdm=syntax fdl=2 si
-vim: et tw=78 syn=sgml
-vi: ts=1 sw=1
+ Local variables:
+ mode: sgml
+ sgml-omittag:t
+ sgml-shorttag:t
+ sgml-minimize-attributes:nil
+ sgml-always-quote-attributes:t
+ sgml-indent-step:1
+ sgml-indent-data:t
+ indent-tabs-mode:nil
+ sgml-parent-document:nil
+ sgml-default-dtd-file:"../../../../manual.ced"
+ sgml-exposed-tags:nil
+ sgml-local-catalogs:nil
+ sgml-local-ecat-files:nil
+ End:
+ vim600: syn=xml fen fdm=syntax fdl=2 si
+ vim: et tw=78 syn=sgml
+ vi: ts=1 sw=1
-->
http://cvs.php.net/viewvc.cgi/pecl/intl/doc/intl/locale.xml?r1=1.2&r2=1.3&diff_format=u
Index: pecl/intl/doc/intl/locale.xml
diff -u pecl/intl/doc/intl/locale.xml:1.2 pecl/intl/doc/intl/locale.xml:1.3
--- pecl/intl/doc/intl/locale.xml:1.2 Wed Nov 28 22:26:10 2007
+++ pecl/intl/doc/intl/locale.xml Fri Nov 30 00:54:03 2007
@@ -1,136 +1,162 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision: 1.2 $ -->
-<reference xml:id="class.locale" xmlns="http://docbook.org/ns/docbook" \
xmlns:xlink="http://www.w3.org/1999/xlink" \
xmlns:xi="http://www.w3.org/2001/XInclude"> +<!-- $Revision: 1.3 $ -->
+<reference xml:id="class.locale" xmlns="http://docbook.org/ns/docbook"
+ xmlns:xlink="http://www.w3.org/1999/xlink"
+ xmlns:xi="http://www.w3.org/2001/XInclude">
<title>The Locale class</title>
<titleabbrev>Locale</titleabbrev>
-
+
<partintro>
-
-<!-- {{{ Locale intro -->
+
+ <!-- {{{ Locale intro -->
<section xml:id="locale.intro">
&reftitle.intro;
- <simpara>
- A "Locale" is an identifier used to get language, culture, or regionally-specific
- behavior from an API. PHP locales are organized and identified the same
- way that the CLDR locales used by ICU (and many vendors of Unix-like operating
- systems, the Mac, Java, and so forth) use.
- Locales are identified using RFC 4646 language tags
- (which use hyphen, not underscore) in addition to the
- more traditional underscore-using identifiers. Unless otherwise noted
- the functions in this class are tolerant of both formats.
- </simpara>
- <simpara>
- Examples of identifiers include:
-
- en-US (English, United States)
- zh-Hant-TW (Chinese, Traditional Script, Taiwan)
- fr-CA, fr-FR (French for Canada and France respectively)
- </simpara>
- <simpara>
- The Locale class (and related procedural functions) are used to interact
- with locale identifiers--to verify that an ID is well-formed, valid,
- etc. The extensions used by CLDR in UAX #35 (and inherited by ICU) are
- valid and used wherever they would be in ICU normally.
- </simpara>
- <simpara>
- Locales cannot be instantiated as objects. All of the functions/methods
- provided are static.
- </simpara>
- <simpara>
- The null or empty string obtains the "root" locale.
- The "root" locale is equivalent to "en_US_POSIX" in CLDR.
- Language tags (and thus locale identifiers) are case insensitive. There
- exists a canonicalization function to make case match the specification.
- </simpara>
+ <simpara>
+ A "Locale" is an identifier used to get language, culture, or
+ regionally-specific behavior from an API. PHP locales are organized and
+ identified the same way that the CLDR locales used by ICU (and many
+ vendors of Unix-like operating systems, the Mac, Java, and so forth) use.
+ Locales are identified using RFC 4646 language tags (which use hyphen, not
+ underscore) in addition to the more traditional underscore-using
+ identifiers. Unless otherwise noted the functions in this class are
+ tolerant of both formats.
+ </simpara>
+ <para>
+ Examples of identifiers include:
+ <simplelist>
+ <member>en-US (English, United States)</member>
+ <member>zh-Hant-TW (Chinese, Traditional Script, Taiwan)</member>
+ <member>fr-CA, fr-FR (French for Canada and France respectively)</member>
+ </simplelist>
+ </para>
+ <simpara>
+ The Locale class (and related procedural functions) are used to interact
+ with locale identifiers--to verify that an ID is well-formed, valid, etc.
+ The extensions used by CLDR in UAX #35 (and inherited by ICU) are valid
+ and used wherever they would be in ICU normally.
+ </simpara>
+ <simpara>
+ Locales cannot be instantiated as objects. All of the functions/methods
+ provided are static.
+ </simpara>
+ <simpara>
+ The null or empty string obtains the "root" locale. The "root" locale is
+ equivalent to "en_US_POSIX" in CLDR. Language tags (and thus locale
+ identifiers) are case insensitive. There exists a canonicalization
+ function to make case match the specification.
+ </simpara>
</section>
-<!-- }}} -->
-
+ <!-- }}} -->
+
<section xml:id="locale.synopsis">
<title>Class synopsis</title>
-
-<!-- {{{ Synopsis -->
+
+ <!-- {{{ Synopsis -->
<classsynopsis>
- <ooclass><classname>Locale</classname></ooclass>
-
-<!-- {{{ Class synopsis -->
-<!--
- <classsynopsisinfo>
+ <ooclass>
+ <classname>Locale</classname>
+ </ooclass>
+
+ <!-- {{{ Class synopsis -->
+ <!--
+ <classsynopsisinfo>
<ooclass>
- <classname>Locale</classname>
+ <classname>Locale</classname>
</ooclass>
- </classsynopsisinfo>
--->
-<!-- }}} -->
-
-<!--
- <classsynopsisinfo role="comment">Properties</classsynopsisinfo>
- <fieldsynopsis>
+ </classsynopsisinfo>
+ -->
+ <!-- }}} -->
+
+ <!--
+ <classsynopsisinfo role="comment">Properties</classsynopsisinfo>
+ <fieldsynopsis>
<modifier>public</modifier>
<type>string</type>
<varname linkend="locale.props.name">name</varname>
- </fieldsynopsis>
-
- <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) \
xpointer(id('class.Locale')/db:refentry/db:refsect1[@role='description']/descendant::db:fieldsynopsis[1])" \
/>
--->
-
+ </fieldsynopsis>
+
+ <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) \
xpointer(id('class.Locale')/db:refentry/db:refsect1[@role='description']/descendant::db:fieldsynopsis[1])" \
/> + -->
+
<classsynopsisinfo role="comment">Methods</classsynopsisinfo>
- <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) \
xpointer(id('class.locale')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[1])" \
/> + <xi:include
+ xpointer="xmlns(db=http://docbook.org/ns/docbook) \
xpointer(id('class.locale')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[1])" \
/> </classsynopsis>
-<!-- }}} -->
-
+ <!-- }}} -->
+
</section>
-
-<!-- {{{ Locale properties
- <section xml:id="Locale.props">
+
+ <!-- {{{ Locale properties
+ <section xml:id="Locale.props">
&reftitle.properties;
<variablelist>
- <varlistentry xml:id="locale.props.name">
- <term><varname>name</varname></term>
- <listitem>
- <para>Prop description</para>
- </listitem>
- </varlistentry>
+ <varlistentry xml:id="locale.props.name">
+ <term><varname>name</varname></term>
+ <listitem>
+ <para>Prop description</para>
+ </listitem>
+ </varlistentry>
</variablelist>
- </section>
-}}} -->
-
+ </section>
+ }}} -->
+
&reference.intl.locale-constants;
<section xml:id="locale.seealso">
&reftitle.seealso;
<para>
<simplelist>
- <member><link xlink:href="&url.rfc;4646">RFC 4646 - Tags for Identifying \
Languages</link></member>
- <member><link xlink:href="&url.rfc;4647">RFC 4647 - Matching of Language \
Tags</link></member>
- <member><link xlink:href="&url.cldr.locale;">Unicode CLDR Project:Common Locale \
Data Repository</link></member>
- <member><link xlink:href="&url.iana.locale.subtags;">IANA Language Subtags \
Registry</link></member>
- <member><link xlink:href="&url.icu.locale.guide;">ICU User Guide - Locale \
</link></member>
- <member><link xlink:href="&url.icu.locale.api;">ICU Locale api</link></member>
+ <member>
+ <link xlink:href="&url.rfc;4646">
+ RFC 4646 - Tags for Identifying Languages
+ </link>
+ </member>
+ <member>
+ <link xlink:href="&url.rfc;4647">
+ RFC 4647 - Matching of Language Tags
+ </link>
+ </member>
+ <member>
+ <link xlink:href="&url.cldr.locale;">
+ Unicode CLDR Project:Common Locale Data Repository
+ </link>
+ </member>
+ <member>
+ <link xlink:href="&url.iana.locale.subtags;">
+ IANA Language Subtags Registry
+ </link>
+ </member>
+ <member>
+ <link xlink:href="&url.icu.locale.guide;">ICU User Guide - Locale</link>
+ </member>
+ <member>
+ <link xlink:href="&url.icu.locale.api;">ICU Locale api</link>
+ </member>
</simplelist>
</para>
</section>
</partintro>
&reference.intl.locale.entities;
-
+
</reference>
-
+
<!-- Keep this comment at the end of the file
-Local variables:
-mode: sgml
-sgml-omittag:t
-sgml-shorttag:t
-sgml-minimize-attributes:nil
-sgml-always-quote-attributes:t
-sgml-indent-step:1
-sgml-indent-data:t
-indent-tabs-mode:nil
-sgml-parent-document:nil
-sgml-default-dtd-file:"../../../../manual.ced"
-sgml-exposed-tags:nil
-sgml-local-catalogs:nil
-sgml-local-ecat-files:nil
-End:
-vim600: syn=xml fen fdm=syntax fdl=2 si
-vim: et tw=78 syn=sgml
-vi: ts=1 sw=1
+ Local variables:
+ mode: sgml
+ sgml-omittag:t
+ sgml-shorttag:t
+ sgml-minimize-attributes:nil
+ sgml-always-quote-attributes:t
+ sgml-indent-step:1
+ sgml-indent-data:t
+ indent-tabs-mode:nil
+ sgml-parent-document:nil
+ sgml-default-dtd-file:"../../../../manual.ced"
+ sgml-exposed-tags:nil
+ sgml-local-catalogs:nil
+ sgml-local-ecat-files:nil
+ End:
+ vim600: syn=xml fen fdm=syntax fdl=2 si
+ vim: et tw=78 syn=sgml
+ vi: ts=1 sw=1
-->
http://cvs.php.net/viewvc.cgi/pecl/intl/doc/intl/messageformatter.xml?r1=1.2&r2=1.3&diff_format=u
Index: pecl/intl/doc/intl/messageformatter.xml
diff -u pecl/intl/doc/intl/messageformatter.xml:1.2 \
pecl/intl/doc/intl/messageformatter.xml:1.3
--- pecl/intl/doc/intl/messageformatter.xml:1.2 Wed Nov 28 22:26:10 2007
+++ pecl/intl/doc/intl/messageformatter.xml Fri Nov 30 00:54:03 2007
@@ -1,100 +1,121 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision: 1.2 $ -->
-<reference xml:id="class.messageformatter" xmlns="http://docbook.org/ns/docbook" \
xmlns:xlink="http://www.w3.org/1999/xlink" \
xmlns:xi="http://www.w3.org/2001/XInclude">
- <title>The MessageFormatter class</title>
- <titleabbrev>MessageFormatter</titleabbrev>
+<!-- $Revision: 1.3 $ -->
+<reference xml:id="class.messageformatter"
+ xmlns="http://docbook.org/ns/docbook"
+ xmlns:xlink="http://www.w3.org/1999/xlink"
+ xmlns:xi="http://www.w3.org/2001/XInclude">
+ <title>The MessageFormatter class</title>
+ <titleabbrev>MessageFormatter</titleabbrev>
<partintro>
-
-<!-- {{{ MessageFormatter intro -->
+
+ <!-- {{{ MessageFormatter intro -->
<section xml:id="messageformatter.intro">
&reftitle.intro;
- <simpara>
+ <simpara>
MessageFormatter is a concrete class that enables users to produce
- concatenated, language-neutral messages. The methods supplied in this class
- are used to build all the messages that are seen by end users.
- </simpara>
- <simpara>
- The MessageFormatter class assembles messages from various fragments (such as
- text fragments, numbers, and dates) supplied by the program.
- Because of the MessageFormatter class, the program does not need to know the
- order of the fragments. The class uses the formatting specifications for the
+ concatenated, language-neutral messages. The methods supplied in this
+ class are used to build all the messages that are seen by end users.
+ </simpara>
+ <simpara>
+ The MessageFormatter class assembles messages from various fragments (such
+ as text fragments, numbers, and dates) supplied by the program. Because of
+ the MessageFormatter class, the program does not need to know the order of
+ the fragments. The class uses the formatting specifications for the
fragments to assemble them into a message that is contained in a single
- string within a resource bundle. For example, MessageFormatter enables you to
- print the phrase "Finished printing x out of y files..." in a manner that
- still allows for flexibility in translation.
- </simpara>
- <simpara>
+ string within a resource bundle. For example, MessageFormatter enables you
+ to print the phrase "Finished printing x out of y files..." in a manner
+ that still allows for flexibility in translation.
+ </simpara>
+ <simpara>
Previously, an end user message was created as a sentence and handled as a
- string. This procedure created problems for localizers because the sentence
- structure, word order, number format and so on are very different from
- language to language. The language-neutral way to create messages keeps each
- part of the message separate and provides keys to the data. Using these keys,
- the MessageFormatter class can concatenate the parts of the message, localize \
them,
- and display a well-formed string to the end user.
- </simpara>
- <simpara>
- MessageFormatter takes a set of objects, formats them, and then inserts the
- formatted strings into the pattern at the appropriate places. Choice formats can
- be used in conjunction with MessageFormatter to handle plurals, match numbers,
- and select from an array of items. Typically, the message format will come
- from resources and the arguments will be dynamically set at runtime.
- </simpara>
- </section>
-<!-- }}} -->
-
+ string. This procedure created problems for localizers because the
+ sentence structure, word order, number format and so on are very different
+ from language to language. The language-neutral way to create messages
+ keeps each part of the message separate and provides keys to the data.
+ Using these keys, the MessageFormatter class can concatenate the parts of
+ the message, localize them, and display a well-formed string to the end
+ user.
+ </simpara>
+ <simpara>
+ MessageFormatter takes a set of objects, formats them, and then inserts
+ the formatted strings into the pattern at the appropriate places. Choice
+ formats can be used in conjunction with MessageFormatter to handle
+ plurals, match numbers, and select from an array of items. Typically, the
+ message format will come from resources and the arguments will be
+ dynamically set at runtime.
+ </simpara>
+ </section>
+ <!-- }}} -->
+
<section xml:id="messageformatter.synopsis">
<title>Class synopsis</title>
-
-<!-- {{{ Synopsis -->
+
+ <!-- {{{ Synopsis -->
<classsynopsis>
- <ooclass><classname>MessageFormatter</classname></ooclass>
-
-<!-- {{{ Class synopsis -->
-<!-- }}} -->
-
+ <ooclass>
+ <classname>MessageFormatter</classname>
+ </ooclass>
+
+ <!-- {{{ Class synopsis -->
+ <!-- }}} -->
+
<classsynopsisinfo role="comment">Methods</classsynopsisinfo>
- <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) \
xpointer(id('class.messageformatter')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis[1])" \
/>
- <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) \
xpointer(id('class.messageformatter')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[1])" \
/> + <xi:include
+ xpointer="xmlns(db=http://docbook.org/ns/docbook) \
xpointer(id('class.messageformatter')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis[1])" \
/> + <xi:include
+ xpointer="xmlns(db=http://docbook.org/ns/docbook) \
xpointer(id('class.messageformatter')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[1])" \
/> </classsynopsis>
-<!-- }}} -->
-
+ <!-- }}} -->
+
</section>
-
+
<section xml:id="messageformatter.seealso">
&reftitle.seealso;
<para>
<simplelist>
- <member><link xlink:href="&url.icu.formatparse;">ICU formatting \
documentation</link></member>
- <member><link xlink:href="&url.icu.formatmsg;">ICU message formatting \
description</link></member>
- <member><link xlink:href="&url.icu.msgformat;">ICU message \
formatters</link></member>
- <member><link xlink:href="&url.icu.choiceformat;">ICU choice \
formatters</link></member> + <member>
+ <link xlink:href="&url.icu.formatparse;">
+ ICU formatting documentation
+ </link>
+ </member>
+ <member>
+ <link xlink:href="&url.icu.formatmsg;">
+ ICU message formatting description
+ </link>
+ </member>
+ <member>
+ <link xlink:href="&url.icu.msgformat;">ICU message formatters</link>
+ </member>
+ <member>
+ <link xlink:href="&url.icu.choiceformat;">ICU choice formatters</link>
+ </member>
</simplelist>
</para>
</section>
</partintro>
-
+
&reference.intl.messageformatter.entities;
-
+
</reference>
-
+
<!-- Keep this comment at the end of the file
-Local variables:
-mode: sgml
-sgml-omittag:t
-sgml-shorttag:t
-sgml-minimize-attributes:nil
-sgml-always-quote-attributes:t
-sgml-indent-step:1
-sgml-indent-data:t
-indent-tabs-mode:nil
-sgml-parent-document:nil
-sgml-default-dtd-file:"../../../../manual.ced"
-sgml-exposed-tags:nil
-sgml-local-catalogs:nil
-sgml-local-ecat-files:nil
-End:
-vim600: syn=xml fen fdm=syntax fdl=2 si
-vim: et tw=78 syn=sgml
-vi: ts=1 sw=1
+ Local variables:
+ mode: sgml
+ sgml-omittag:t
+ sgml-shorttag:t
+ sgml-minimize-attributes:nil
+ sgml-always-quote-attributes:t
+ sgml-indent-step:1
+ sgml-indent-data:t
+ indent-tabs-mode:nil
+ sgml-parent-document:nil
+ sgml-default-dtd-file:"../../../../manual.ced"
+ sgml-exposed-tags:nil
+ sgml-local-catalogs:nil
+ sgml-local-ecat-files:nil
+ End:
+ vim600: syn=xml fen fdm=syntax fdl=2 si
+ vim: et tw=78 syn=sgml
+ vi: ts=1 sw=1
-->
http://cvs.php.net/viewvc.cgi/pecl/intl/doc/intl/normalizer-constants.xml?r1=1.2&r2=1.3&diff_format=u
Index: pecl/intl/doc/intl/normalizer-constants.xml
diff -u pecl/intl/doc/intl/normalizer-constants.xml:1.2 \
pecl/intl/doc/intl/normalizer-constants.xml:1.3
--- pecl/intl/doc/intl/normalizer-constants.xml:1.2 Wed Nov 28 22:26:10 2007
+++ pecl/intl/doc/intl/normalizer-constants.xml Fri Nov 30 00:54:03 2007
@@ -1,104 +1,103 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision: 1.2 $ -->
-<section xml:id="intl.normalizer-constants" xmlns="http://docbook.org/ns/docbook" \
xmlns:xlink="http://www.w3.org/1999/xlink"> +<!-- $Revision: 1.3 $ -->
+<section xml:id="intl.normalizer-constants"
+ xmlns="http://docbook.org/ns/docbook"
+ xmlns:xlink="http://www.w3.org/1999/xlink">
&reftitle.constants;
-
+
<para>
- The following constants define the normalization form used by the normalizer:
-<variablelist>
- <varlistentry>
+ The following constants define the normalization form used by the
+ normalizer:
+ <variablelist>
+ <varlistentry>
<term>
- <constant>Normalizer::FORM_C</constant>
- (<type>string</type>)
+ <constant>Normalizer::FORM_C</constant>
+ (<type>string</type>)
</term>
<listitem>
- <simpara>
- Normalization Form C (NFC) - Canonical Decomposition followed by Canonical \
Composition
- </simpara>
+ <simpara>
+ Normalization Form C (NFC) - Canonical Decomposition followed by
+ Canonical Composition
+ </simpara>
</listitem>
- </varlistentry>
+ </varlistentry>
- <varlistentry>
+ <varlistentry>
<term>
- <constant>Normalizer::FORM_D</constant>
- (<type>string</type>)
+ <constant>Normalizer::FORM_D</constant>
+ (<type>string</type>)
</term>
<listitem>
- <simpara>
- Normalization Form D (NFD) - Canonical Decomposition
- </simpara>
+ <simpara>Normalization Form D (NFD) - Canonical Decomposition</simpara>
</listitem>
- </varlistentry>
+ </varlistentry>
- <varlistentry>
+ <varlistentry>
<term>
- <constant>Normalizer::FORM_KC</constant>
- (<type>string</type>)
+ <constant>Normalizer::FORM_KC</constant>
+ (<type>string</type>)
</term>
<listitem>
- <simpara>
- Normalization Form KC (NFKC) - Compatibility Decomposition, followed by \
Canonical Composition
- </simpara>
+ <simpara>
+ Normalization Form KC (NFKC) - Compatibility Decomposition, followed by
+ Canonical Composition
+ </simpara>
</listitem>
- </varlistentry>
+ </varlistentry>
- <varlistentry>
+ <varlistentry>
<term>
- <constant>Normalizer::FORM_KD</constant>
- (<type>string</type>)
+ <constant>Normalizer::FORM_KD</constant>
+ (<type>string</type>)
</term>
<listitem>
- <simpara>
- Normalization Form KD (NFKD) - Compatibility Decomposition
- </simpara>
+ <simpara>
+ Normalization Form KD (NFKD) - Compatibility Decomposition
+ </simpara>
</listitem>
- </varlistentry>
+ </varlistentry>
- <varlistentry>
+ <varlistentry>
<term>
- <constant>Normalizer::NONE</constant>
- (<type>string</type>)
+ <constant>Normalizer::NONE</constant>
+ (<type>string</type>)
</term>
<listitem>
- <simpara>
- No decomposition/composition
- </simpara>
+ <simpara>No decomposition/composition</simpara>
</listitem>
- </varlistentry>
+ </varlistentry>
- <varlistentry>
+ <varlistentry>
<term>
- <constant>Normalizer::OPTION_DEFAULT</constant>
- (<type>string</type>)
+ <constant>Normalizer::OPTION_DEFAULT</constant>
+ (<type>string</type>)
</term>
<listitem>
- <simpara>
- Default normalization options
- </simpara>
+ <simpara>Default normalization options</simpara>
</listitem>
- </varlistentry>
-</variablelist>
+ </varlistentry>
+ </variablelist>
</para>
- </section>
-
+</section>
+
<!-- Keep this comment at the end of the file
-Local variables:
-mode: sgml
-sgml-omittag:t
-sgml-shorttag:t
-sgml-minimize-attributes:nil
-sgml-always-quote-attributes:t
-sgml-indent-step:1
-sgml-indent-data:t
-indent-tabs-mode:nil
-sgml-parent-document:nil
-sgml-default-dtd-file:"../../../manual.ced"
-sgml-exposed-tags:nil
-sgml-local-catalogs:nil
-sgml-local-ecat-files:nil
-End:
-vim600: syn=xml fen fdm=syntax fdl=2 si
-vim: et tw=78 syn=sgml
-vi: ts=1 sw=1
--->
-
+ Local variables:
+ mode: sgml
+ sgml-omittag:t
+ sgml-shorttag:t
+ sgml-minimize-attributes:nil
+ sgml-always-quote-attributes:t
+ sgml-indent-step:1
+ sgml-indent-data:t
+ indent-tabs-mode:nil
+ sgml-parent-document:nil
+ sgml-default-dtd-file:"../../../manual.ced"
+ sgml-exposed-tags:nil
+ sgml-local-catalogs:nil
+ sgml-local-ecat-files:nil
+ End:
+ vim600: syn=xml fen fdm=syntax fdl=2 si
+ vim: et tw=78 syn=sgml
+ vi: ts=1 sw=1
+-->
+
http://cvs.php.net/viewvc.cgi/pecl/intl/doc/intl/normalizer.xml?r1=1.2&r2=1.3&diff_format=u
Index: pecl/intl/doc/intl/normalizer.xml
diff -u pecl/intl/doc/intl/normalizer.xml:1.2 pecl/intl/doc/intl/normalizer.xml:1.3
--- pecl/intl/doc/intl/normalizer.xml:1.2 Wed Nov 28 22:26:10 2007
+++ pecl/intl/doc/intl/normalizer.xml Fri Nov 30 00:54:03 2007
@@ -1,118 +1,151 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision: 1.2 $ -->
-<reference xml:id="class.normalizer" xmlns="http://docbook.org/ns/docbook" \
xmlns:xlink="http://www.w3.org/1999/xlink" \
xmlns:xi="http://www.w3.org/2001/XInclude"> +<!-- $Revision: 1.3 $ -->
+<reference xml:id="class.normalizer" xmlns="http://docbook.org/ns/docbook"
+ xmlns:xlink="http://www.w3.org/1999/xlink"
+ xmlns:xi="http://www.w3.org/2001/XInclude">
<title>The Normalizer class</title>
<titleabbrev>Normalizer</titleabbrev>
-
+
<partintro>
-
-<!-- {{{ Normalizer intro -->
+
+ <!-- {{{ Normalizer intro -->
<section xml:id="normalizer.intro">
&reftitle.intro;
- <simpara>
- Normalization is a process that involves transforming characters and sequences \
of characters into a formally-defined
- underlying representation. This process is most important when text needs to be \
compared for sorting and searching,
- but it is also used when storing text to ensure that the text is stored in a \
consistent representation.
- </simpara>
- <para>
- The Unicode Consortium has defined a number of normalization forms reflecting \
the various needs of applications: + <simpara>
+ Normalization is a process that involves transforming characters and
+ sequences of characters into a formally-defined underlying representation.
+ This process is most important when text needs to be compared for sorting
+ and searching, but it is also used when storing text to ensure that the
+ text is stored in a consistent representation.
+ </simpara>
+ <para>
+ The Unicode Consortium has defined a number of normalization forms
+ reflecting the various needs of applications:
<simplelist>
- <member>Normalization Form D (NFD) - Canonical Decomposition</member>
- <member>Normalization Form C (NFC) - Canonical Decomposition followed by \
Canonical Composition</member>
- <member>Normalization Form KD (NFKD) - Compatibility Decomposition</member>
- <member>Normalization Form KC (NFKC) - Compatibility Decomposition followed by \
Canonical Composition</member> + <member>Normalization Form D (NFD) - Canonical \
Decomposition</member> + <member>
+ Normalization Form C (NFC) - Canonical Decomposition followed by
+ Canonical Composition
+ </member>
+ <member>
+ Normalization Form KD (NFKD) - Compatibility Decomposition
+ </member>
+ <member>
+ Normalization Form KC (NFKC) - Compatibility Decomposition followed by
+ Canonical Composition
+ </member>
</simplelist>
- The different forms are defined in terms of a set of transformations on the \
text, transformations that are expressed
- by both an algorithm and a set of data files.
- </para>
+ The different forms are defined in terms of a set of transformations on
+ the text, transformations that are expressed by both an algorithm and a
+ set of data files.
+ </para>
</section>
-<!-- }}} -->
-
+ <!-- }}} -->
+
<section xml:id="normalizer.synopsis">
<title>Class synopsis</title>
-
-<!-- {{{ Synopsis -->
+
+ <!-- {{{ Synopsis -->
<classsynopsis>
- <ooclass><classname>Normalizer</classname></ooclass>
-
-<!-- {{{ Class synopsis -->
-<!--
- <classsynopsisinfo>
+ <ooclass>
+ <classname>Normalizer</classname>
+ </ooclass>
+
+ <!-- {{{ Class synopsis -->
+ <!--
+ <classsynopsisinfo>
<ooclass>
- <classname>Normalizer</classname>
+ <classname>Normalizer</classname>
</ooclass>
- </classsynopsisinfo>
--->
-<!-- }}} -->
-
-<!--
- <classsynopsisinfo role="comment">Properties</classsynopsisinfo>
- <fieldsynopsis>
+ </classsynopsisinfo>
+ -->
+ <!-- }}} -->
+
+ <!--
+ <classsynopsisinfo role="comment">Properties</classsynopsisinfo>
+ <fieldsynopsis>
<modifier>public</modifier>
<type>string</type>
<varname linkend="normalizer.props.name">name</varname>
- </fieldsynopsis>
-
- <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) \
xpointer(id('class.normalizer')/db:refentry/db:refsect1[@role='description']/descendant::db:fieldsynopsis[1])" \
/>
--->
-
+ </fieldsynopsis>
+
+ <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) \
xpointer(id('class.normalizer')/db:refentry/db:refsect1[@role='description']/descendant::db:fieldsynopsis[1])" \
/> + -->
+
<classsynopsisinfo role="comment">Methods</classsynopsisinfo>
- <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) \
xpointer(id('class.normalizer')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[1])" \
/> + <xi:include
+ xpointer="xmlns(db=http://docbook.org/ns/docbook) \
xpointer(id('class.normalizer')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[1])" \
/> </classsynopsis>
-<!-- }}} -->
-
+ <!-- }}} -->
+
</section>
-
-<!-- {{{ Normalizer properties
- <section xml:id="Normalizer.props">
+
+ <!-- {{{ Normalizer properties
+ <section xml:id="Normalizer.props">
&reftitle.properties;
<variablelist>
- <varlistentry xml:id="normalizer.props.name">
- <term><varname>name</varname></term>
- <listitem>
- <para>Prop description</para>
- </listitem>
- </varlistentry>
+ <varlistentry xml:id="normalizer.props.name">
+ <term><varname>name</varname></term>
+ <listitem>
+ <para>Prop description</para>
+ </listitem>
+ </varlistentry>
</variablelist>
- </section>
-}}} -->
-
+ </section>
+ }}} -->
+
&reference.intl.normalizer-constants;
-
+
<section xml:id="normalizer.seealso">
&reftitle.seealso;
<para>
<simplelist>
- <member><link xlink:href="&url.unicode.normalization;">Unicode \
Normalization</link></member>
- <member><link xlink:href="&url.unicode.normalization.faq;">Unicode \
Normalization FAQ</link></member>
- <member><link xlink:href="&url.icu.normalization.guide;">ICU User Guide - \
Normalization</link></member>
- <member><link xlink:href="&url.icu.normalization.api;">ICU API Reference - \
Normalization</link></member> + <member>
+ <link xlink:href="&url.unicode.normalization;">
+ Unicode Normalization
+ </link>
+ </member>
+ <member>
+ <link xlink:href="&url.unicode.normalization.faq;">
+ Unicode Normalization FAQ
+ </link>
+ </member>
+ <member>
+ <link xlink:href="&url.icu.normalization.guide;">
+ ICU User Guide - Normalization
+ </link>
+ </member>
+ <member>
+ <link xlink:href="&url.icu.normalization.api;">
+ ICU API Reference - Normalization
+ </link>
+ </member>
</simplelist>
</para>
</section>
</partintro>
&reference.intl.normalizer.entities;
-
+
</reference>
-
+
<!-- Keep this comment at the end of the file
-Local variables:
-mode: sgml
-sgml-omittag:t
-sgml-shorttag:t
-sgml-minimize-attributes:nil
-sgml-always-quote-attributes:t
-sgml-indent-step:1
-sgml-indent-data:t
-indent-tabs-mode:nil
-sgml-parent-document:nil
-sgml-default-dtd-file:"../../../../manual.ced"
-sgml-exposed-tags:nil
-sgml-local-catalogs:nil
-sgml-local-ecat-files:nil
-End:
-vim600: syn=xml fen fdm=syntax fdl=2 si
-vim: et tw=78 syn=sgml
-vi: ts=1 sw=1
+ Local variables:
+ mode: sgml
+ sgml-omittag:t
+ sgml-shorttag:t
+ sgml-minimize-attributes:nil
+ sgml-always-quote-attributes:t
+ sgml-indent-step:1
+ sgml-indent-data:t
+ indent-tabs-mode:nil
+ sgml-parent-document:nil
+ sgml-default-dtd-file:"../../../../manual.ced"
+ sgml-exposed-tags:nil
+ sgml-local-catalogs:nil
+ sgml-local-ecat-files:nil
+ End:
+ vim600: syn=xml fen fdm=syntax fdl=2 si
+ vim: et tw=78 syn=sgml
+ vi: ts=1 sw=1
-->
http://cvs.php.net/viewvc.cgi/pecl/intl/doc/intl/numberformatter-constants.xml?r1=1.2&r2=1.3&diff_format=u
Index: pecl/intl/doc/intl/numberformatter-constants.xml
diff -u pecl/intl/doc/intl/numberformatter-constants.xml:1.2 \
pecl/intl/doc/intl/numberformatter-constants.xml:1.3
--- pecl/intl/doc/intl/numberformatter-constants.xml:1.2 Wed Nov 28 22:26:10 2007
+++ pecl/intl/doc/intl/numberformatter-constants.xml Fri Nov 30 00:54:04 2007
@@ -1,960 +1,850 @@
<?xml version="1.0" encoding="UTF-8"?>
-<!-- $Revision: 1.2 $ -->
-<section xml:id="intl.numberformatter-constants" \
xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> \
+<!-- $Revision: 1.3 $ --> +<section xml:id="intl.numberformatter-constants"
+ xmlns="http://docbook.org/ns/docbook"
+ xmlns:xlink="http://www.w3.org/1999/xlink">
&reftitle.constants;
-
+
<section xml:id="intl.numberformatter-constants.UNumberFormatStyle">
- <para>
- These styles are used by the <function>numfmt_create</function> to define the type \
of the formatter.
-<variablelist>
- <varlistentry>
- <term>
+ <para>
+ These styles are used by the <function>numfmt_create</function>
+ to define the type of the formatter.
+ <variablelist>
+ <varlistentry>
+ <term>
<constant>NumberFormatter::PATTERN_DECIMAL</constant>
(<type>integer</type>)
- </term>
- <listitem>
- <simpara>
- Decimal format defined by pattern
- </simpara>
- </listitem>
- </varlistentry>
+ </term>
+ <listitem>
+ <simpara>Decimal format defined by pattern</simpara>
+ </listitem>
+ </varlistentry>
- <varlistentry>
- <term>
+ <varlistentry>
+ <term>
<constant>NumberFormatter::DECIMAL</constant>
(<type>integer</type>)
- </term>
- <listitem>
- <simpara>
- Decimal format
- </simpara>
- </listitem>
- </varlistentry>
+ </term>
+ <listitem>
+ <simpara>Decimal format</simpara>
+ </listitem>
+ </varlistentry>
- <varlistentry>
- <term>
+ <varlistentry>
+ <term>
<constant>NumberFormatter::CURRENCY</constant>
(<type>integer</type>)
- </term>
- <listitem>
- <simpara>
- Currency format
- </simpara>
- </listitem>
- </varlistentry>
+ </term>
+ <listitem>
+ <simpara>Currency format</simpara>
+ </listitem>
+ </varlistentry>
- <varlistentry>
- <term>
+ <varlistentry>
+ <term>
<constant>NumberFormatter::PERCENT</constant>
(<type>integer</type>)
- </term>
- <listitem>
- <simpara>
- Percent format
- </simpara>
- </listitem>
- </varlistentry>
+ </term>
+ <listitem>
+ <simpara>Percent format</simpara>
+ </listitem>
+ </varlistentry>
- <varlistentry>
- <term>
+ <varlistentry>
+ <term>
<constant>NumberFormatter::SCIENTIFIC</constant>
(<type>integer</type>)
- </term>
- <listitem>
- <simpara>
- Scientific format
- </simpara>
- </listitem>
- </varlistentry>
+ </term>
+ <listitem>
+ <simpara>Scientific format</simpara>
+ </listitem>
+ </varlistentry>
- <varlistentry>
- <term>
+ <varlistentry>
+ <term>
<constant>NumberFormatter::SPELLOUT</constant>
(<type>integer</type>)
- </term>
- <listitem>
- <simpara>
- Spellout rule-based format
- </simpara>
- </listitem>
- </varlistentry>
+ </term>
+ <listitem>
+ <simpara>Spellout rule-based format</simpara>
+ </listitem>
+ </varlistentry>
- <varlistentry>
- <term>
+ <varlistentry>
+ <term>
<constant>NumberFormatter::ORDINAL</constant>
(<type>integer</type>)
- </term>
- <listitem>
- <simpara>
- Ordinal rule-based format
- </simpara>
- </listitem>
- </varlistentry>
+ </term>
+ <listitem>
+ <simpara>Ordinal rule-based format</simpara>
+ </listitem>
+ </varlistentry>
- <varlistentry>
- <term>
+ <varlistentry>
+ <term>
<constant>NumberFormatter::DURATION</constant>
(<type>integer</type>)
- </term>
- <listitem>
- <simpara>
- Duration rule-based format
- </simpara>
- </listitem>
- </varlistentry>
+ </term>
+ <listitem>
+ <simpara>Duration rule-based format</simpara>
+ </listitem>
+ </varlistentry>
- <varlistentry>
- <term>
+ <varlistentry>
+ <term>
<constant>NumberFormatter::PATTERN_RULEBASED</constant>
(<type>integer</type>)
- </term>
- <listitem>
- <simpara>
- Rule-based format defined by pattern
- </simpara>
- </listitem>
- </varlistentry>
+ </term>
+ <listitem>
+ <simpara>Rule-based format defined by pattern</simpara>
+ </listitem>
+ </varlistentry>
- <varlistentry>
- <term>
+ <varlistentry>
+ <term>
<constant>NumberFormatter::DEFAULT</constant>
(<type>integer</type>)
- </term>
- <listitem>
- <simpara>
- Default format for the locale
- </simpara>
- </listitem>
- </varlistentry>
+ </term>
+ <listitem>
+ <simpara>Default format for the locale</simpara>
+ </listitem>
+ </varlistentry>
- <varlistentry>
- <term>
+ <varlistentry>
+ <term>
<constant>NumberFormatter::IGNORE</constant>
(<type>integer</type>)
- </term>
- <listitem>
- <simpara>
- Alias for PATTERN_DECIMAL
- </simpara>
- </listitem>
- </varlistentry>
-</variablelist>
+ </term>
+ <listitem>
+ <simpara>Alias for PATTERN_DECIMAL</simpara>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+
-
-
-
- </para>
+
+
+ </para>
</section>
<section xml:id="intl.numberformatter-constants.types">
- <para>
- These constants define how the numbers are parsed or formatted. They should be used \
as arguments to
- <function>numfmt_format</function> and <function>numfmt_parse</function>.
- <variablelist>
- <varlistentry>
- <term>
+ <para>
+ These constants define how the numbers are parsed or formatted. They should
+ be used as arguments to <function>numfmt_format</function>
+ and <function>numfmt_parse</function>.
+ <variablelist>
+ <varlistentry>
+ <term>
<constant>NumberFormatter::TYPE_DEFAULT</constant>
(<type>integer</type>)
- </term>
- <listitem>
- <simpara>
- Derive the type from variable type
- </simpara>
- </listitem>
- </varlistentry>
+ </term>
+ <listitem>
+ <simpara>Derive the type from variable type</simpara>
+ </listitem>
+ </varlistentry>
- <varlistentry>
- <term>
+ <varlistentry>
+ <term>
<constant>NumberFormatter::TYPE_INT32</constant>
(<type>integer</type>)
- </term>
- <listitem>
- <simpara>
- Format/parse as 32-bit integer
- </simpara>
- </listitem>
- </varlistentry>
+ </term>
+ <listitem>
+ <simpara>Format/parse as 32-bit integer</simpara>
+ </listitem>
+ </varlistentry>
- <varlistentry>
- <term>
+ <varlistentry>
+ <term>
<constant>NumberFormatter::TYPE_INT64</constant>
(<type>integer</type>)
- </term>
- <listitem>
- <simpara>
- Format/parse as 64-bit integer
- </simpara>
- </listitem>
- </varlistentry>
+ </term>
+ <listitem>
+ <simpara>Format/parse as 64-bit integer</simpara>
+ </listitem>
+ </varlistentry>
- <varlistentry>
- <term>
+ <varlistentry>
+ <term>
<constant>NumberFormatter::TYPE_DOUBLE</constant>
(<type>integer</type>)
- </term>
- <listitem>
- <simpara>
- Format/parse as floating point value
- </simpara>
- </listitem>
- </varlistentry>
+ </term>
+ <listitem>
+ <simpara>Format/parse as floating point value</simpara>
+ </listitem>
+ </varlistentry>
- <varlistentry>
- <term>
+ <varlistentry>
+ <term>
<constant>NumberFormatter::TYPE_CURRENCY</constant>
(<type>integer</type>)
- </term>
- <listitem>
- <simpara>
- Format/parse as currency value
- </simpara>
- </listitem>
- </varlistentry>
-</variablelist>
- </para>
- </section>
+ </term>
+ <listitem>
+ <simpara>Format/parse as currency value</simpara>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ </section>
<section xml:id="intl.numberformatter-constants.UNumberFormatAttribute">
- <para>
- Number format attribute used by <function>numfmt_get_attribute</function> and \
<function>numfmt_set_attribute</function>.
- <variablelist>
- <varlistentry>
- <term>
+ <para>
+ Number format attribute used by
+ <function>numfmt_get_attribute</function>
+ and
+ <function>numfmt_set_attribute</function>
+ .
+ <variablelist>
+ <varlistentry>
+ <term>
<constant>NumberFormatter::PARSE_INT_ONLY</constant>
(<type>integer</type>)
- </term>
- <listitem>
- <simpara>
- Parse integers only.
- </simpara>
- </listitem>
- </varlistentry>
+ </term>
+ <listitem>
+ <simpara>Parse integers only.</simpara>
+ </listitem>
+ </varlistentry>
- <varlistentry>
- <term>
+ <varlistentry>
+ <term>
<constant>NumberFormatter::GROUPING_USED</constant>
(<type>integer</type>)
- </term>
- <listitem>
- <simpara>
- Use grouping separator.
- </simpara>
- </listitem>
- </varlistentry>
+ </term>
+ <listitem>
+ <simpara>Use grouping separator.</simpara>
+ </listitem>
+ </varlistentry>
- <varlistentry>
- <term>
+ <varlistentry>
+ <term>
<constant>NumberFormatter::DECIMAL_ALWAYS_SHOWN</constant>
(<type>integer</type>)
- </term>
- <listitem>
- <simpara>
- Always show decimal point.
- </simpara>
- </listitem>
- </varlistentry>
+ </term>
+ <listitem>
+ <simpara>Always show decimal point.</simpara>
+ </listitem>
+ </varlistentry>
- <varlistentry>
- <term>
+ <varlistentry>
+ <term>
<constant>NumberFormatter::MAX_INTEGER_DIGITS</constant>
(<type>integer</type>)
- </term>
- <listitem>
- <simpara>
- Maximum integer digits.
- </simpara>
- </listitem>
- </varlistentry>
+ </term>
+ <listitem>
+ <simpara>Maximum integer digits.</simpara>
+ </listitem>
+ </varlistentry>
- <varlistentry>
- <term>
+ <varlistentry>
+ <term>
<constant>NumberFormatter::MIN_INTEGER_DIGITS</constant>
(<type>integer</type>)
- </term>
- <listitem>
- <simpara>
- Minimum integer digits.
- </simpara>
- </listitem>
- </varlistentry>
+ </term>
+ <listitem>
+ <simpara>Minimum integer digits.</simpara>
+ </listitem>
+ </varlistentry>
- <varlistentry>
- <term>
+ <varlistentry>
+ <term>
<constant>NumberFormatter::INTEGER_DIGITS</constant>
(<type>integer</type>)
- </term>
- <listitem>
- <simpara>
- Integer digits.
- </simpara>
- </listitem>
- </varlistentry>
+ </term>
+ <listitem>
+ <simpara>Integer digits.</simpara>
+ </listitem>
+ </varlistentry>
- <varlistentry>
- <term>
+ <varlistentry>
+ <term>
<constant>NumberFormatter::MAX_FRACTION_DIGITS</constant>
(<type>integer</type>)
- </term>
- <listitem>
- <simpara>
- Maximum fraction digits.
- </simpara>
- </listitem>
- </varlistentry>
+ </term>
+ <listitem>
+ <simpara>Maximum fraction digits.</simpara>
+ </listitem>
+ </varlistentry>
- <varlistentry>
- <term>
+ <varlistentry>
+ <term>
<constant>NumberFormatter::MIN_FRACTION_DIGITS</constant>
(<type>integer</type>)
- </term>
- <listitem>
- <simpara>
- Minimum fraction digits.
- </simpara>
- </listitem>
- </varlistentry>
+ </term>
+ <listitem>
+ <simpara>Minimum fraction digits.</simpara>
+ </listitem>
+ </varlistentry>
- <varlistentry>
- <term>
+ <varlistentry>
+ <term>
<constant>NumberFormatter::FRACTION_DIGITS</constant>
(<type>integer</type>)
- </term>
- <listitem>
- <simpara>
- Fraction digits.
- </simpara>
- </listitem>
- </varlistentry>
+ </term>
+ <listitem>
+ <simpara>Fraction digits.</simpara>
+ </listitem>
+ </varlistentry>
- <varlistentry>
- <term>
+ <varlistentry>
+ <term>
<constant>NumberFormatter::MULTIPLIER</constant>
(<type>integer</type>)
- </term>
- <listitem>
- <simpara>
- Multiplier.
- </simpara>
- </listitem>
- </varlistentry>
+ </term>
+ <listitem>
+ <simpara>Multiplier.</simpara>
+ </listitem>
+ </varlistentry>
- <varlistentry>
- <term>
+ <varlistentry>
+ <term>
<constant>NumberFormatter::GROUPING_SIZE</constant>
(<type>integer</type>)
- </term>
- <listitem>
- <simpara>
- Grouping size.
- </simpara>
- </listitem>
- </varlistentry>
+ </term>
+ <listitem>
+ <simpara>Grouping size.</simpara>
+ </listitem>
+ </varlistentry>
- <varlistentry>
- <term>
+ <varlistentry>
+ <term>
<constant>NumberFormatter::ROUNDING_MODE</constant>
(<type>integer</type>)
- </term>
- <listitem>
- <simpara>
- Rounding Mode.
- </simpara>
- </listitem>
- </varlistentry>
+ </term>
+ <listitem>
+ <simpara>Rounding Mode.</simpara>
+ </listitem>
+ </varlistentry>
- <varlistentry>
- <term>
+ <varlistentry>
+ <term>
<constant>NumberFormatter::ROUNDING_INCREMENT</constant>
(<type>integer</type>)
- </term>
- <listitem>
- <simpara>
- Rounding increment.
- </simpara>
- </listitem>
- </varlistentry>
+ </term>
+ <listitem>
+ <simpara>Rounding increment.</simpara>
+ </listitem>
+ </varlistentry>
- <varlistentry>
- <term>
+ <varlistentry>
+ <term>
<constant>NumberFormatter::FORMAT_WIDTH</constant>
(<type>integer</type>)
- </term>
- <listitem>
- <simpara>
- The width to which the output of format() is padded.
- </simpara>
- </listitem>
- </varlistentry>
+ </term>
+ <listitem>
+ <simpara>The width to which the output of format() is padded.</simpara>
+ </listitem>
+ </varlistentry>
- <varlistentry>
- <term>
+ <varlistentry>
+ <term>
<constant>NumberFormatter::PADDING_POSITION</constant>
(<type>integer</type>)
- </term>
- <listitem>
+ </term>
+ <listitem>
<simpara>
- The position at which padding will take place. See pad position constants \
for possible argument values. + The position at which padding will take place. \
See pad position + constants for possible argument values.
</simpara>
- </listitem>
- </varlistentry>
+ </listitem>
+ </varlistentry>
- <varlistentry>
- <term>
+ <varlistentry>
+ <term>
<constant>NumberFormatter::SECONDARY_GROUPING_SIZE</constant>
(<type>integer</type>)
- </term>
- <listitem>
- <simpara>
- Secondary grouping size.
- </simpara>
- </listitem>
- </varlistentry>
+ </term>
+ <listitem>
+ <simpara>Secondary grouping size.</simpara>
+ </listitem>
+ </varlistentry>
- <varlistentry>
- <term>
+ <varlistentry>
+ <term>
<constant>NumberFormatter::SIGNIFICANT_DIGITS_USED</constant>
(<type>integer</type>)
- </term>
- <listitem>
- <simpara>
- Use significant digits.
- </simpara>
- </listitem>
- </varlistentry>
+ </term>
+ <listitem>
+ <simpara>Use significant digits.</simpara>
+ </listitem>
+ </varlistentry>
- <varlistentry>
- <term>
+ <varlistentry>
+ <term>
<constant>NumberFormatter::MIN_SIGNIFICANT_DIGITS</constant>
(<type>integer</type>)
- </term>
- <listitem>
- <simpara>
- Minimum significant digits.
- </simpara>
- </listitem>
- </varlistentry>
+ </term>
+ <listitem>
+ <simpara>Minimum significant digits.</simpara>
+ </listitem>
+ </varlistentry>
- <varlistentry>
- <term>
+ <varlistentry>
+ <term>
<constant>NumberFormatter::MAX_SIGNIFICANT_DIGITS</constant>
(<type>integer</type>)
- </term>
- <listitem>
- <simpara>
- Maximum significant digits.
- </simpara>
- </listitem>
- </varlistentry>
+ </term>
+ <listitem>
+ <simpara>Maximum significant digits.</simpara>
+ </listitem>
+ </varlistentry>
- <varlistentry>
- <term>
+ <varlistentry>
+ <term>
<constant>NumberFormatter::LENIENT_PARSE</constant>
(<type>integer</type>)
- </term>
- <listitem>
- <simpara>
- Lenient parse mode used by rule-based formats.
- </simpara>
- </listitem>
- </varlistentry>
-</variablelist>
- </para>
+ </term>
+ <listitem>
+ <simpara>Lenient parse mode used by rule-based formats.</simpara>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
</section>
-
- <section xml:id="intl.numberformatter-constants.UNumberFormatTextAttribute">
- <para>
- Number format text attribute used by <function>numfmt_get_text_attribute</function> \
and <function>numfmt_set_text_attribute</function>.
- <variablelist>
- <varlistentry>
- <term>
+
+ <section
+ xml:id="intl.numberformatter-constants.UNumberFormatTextAttribute">
+ <para>
+ Number format text attribute used by
+ <function>numfmt_get_text_attribute</function> and
+ <function>numfmt_set_text_attribute</function>.
+ <variablelist>
+ <varlistentry>
+ <term>
<constant>NumberFormatter::POSITIVE_PREFIX</constant>
(<type>integer</type>)
- </term>
- <listitem>
- <simpara>
- Positive prefix.
- </simpara>
- </listitem>
- </varlistentry>
+ </term>
+ <listitem>
+ <simpara>Positive prefix.</simpara>
+ </listitem>
+ </varlistentry>
- <varlistentry>
- <term>
+ <varlistentry>
+ <term>
<constant>NumberFormatter::POSITIVE_SUFFIX</constant>
(<type>integer</type>)
- </term>
- <listitem>
- <simpara>
- Positive suffix.
- </simpara>
- </listitem>
- </varlistentry>
+ </term>
+ <listitem>
+ <simpara>Positive suffix.</simpara>
+ </listitem>
+ </varlistentry>
- <varlistentry>
- <term>
+ <varlistentry>
+ <term>
<constant>NumberFormatter::NEGATIVE_PREFIX</constant>
(<type>integer</type>)
- </term>
- <listitem>
- <simpara>
- Negative prefix.
- </simpara>
- </listitem>
- </varlistentry>
+ </term>
+ <listitem>
+ <simpara>Negative prefix.</simpara>
+ </listitem>
+ </varlistentry>
- <varlistentry>
- <term>
+ <varlistentry>
+ <term>
<constant>NumberFormatter::NEGATIVE_SUFFIX</constant>
(<type>integer</type>)
- </term>
- <listitem>
- <simpara>
- Negative suffix.
- </simpara>
- </listitem>
- </varlistentry>
+ </term>
+ <listitem>
+ <simpara>Negative suffix.</simpara>
+ </listitem>
+ </varlistentry>
- <varlistentry>
- <term>
+ <varlistentry>
+ <term>
<constant>NumberFormatter::PADDING_CHARACTER</constant>
(<type>integer</type>)
- </term>
- <listitem>
- <simpara>
- The character used to pad to the format width.
- </simpara>
- </listitem>
- </varlistentry>
+ </term>
+ <listitem>
+ <simpara>The character used to pad to the format width.</simpara>
+ </listitem>
+ </varlistentry>
- <varlistentry>
- <term>
+ <varlistentry>
+ <term>
<constant>NumberFormatter::CURRENCY_CODE</constant>
(<type>integer</type>)
- </term>
- <listitem>
- <simpara>
- The ISO currency code.
- </simpara>
- </listitem>
- </varlistentry>
+ </term>
+ <listitem>
+ <simpara>The ISO currency code.</simpara>
+ </listitem>
+ </varlistentry>
- <varlistentry>
- <term>
+ <varlistentry>
+ <term>
<constant>NumberFormatter::DEFAULT_RULESET</constant>
(<type>integer</type>)
- </term>
- <listitem>
+ </term>
+ <listitem>
<simpara>
- The default rule set. This is only available with rule-based formatters.
+ The default rule set. This is only available with rule-based
+ formatters.
</simpara>
- </listitem>
- </varlistentry>
+ </listitem>
+ </varlistentry>
- <varlistentry>
- <term>
+ <varlistentry>
+ <term>
<constant>NumberFormatter::PUBLIC_RULESETS</constant>
(<type>integer</type>)
- </term>
- <listitem>
+ </term>
+ <listitem>
<simpara>
- The public rule sets. This is only available with rule-based formatters. \
This is a read-only attribute.
-The public rulesets are returned as a single string, with each ruleset name \
delimited by ';' (semicolon).
- </simpara>
- </listitem>
- </varlistentry>
-</variablelist>
- </para>
+ The public rule sets. This is only available with rule-based
+ formatters. This is a read-only attribute. The public rulesets are
+ returned as a single string, with each ruleset name delimited by ';'
+ (semicolon).
+ </simpara>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
</section>
-
+
<section xml:id="intl.numberformatter-constants.UNumberFormatSymbol">
- <para>
- Number format symbols used by <function>numfmt_get_symbol</function> and \
<function>numfmt_set_symbol</function>.
- <variablelist>
- <varlistentry>
- <term>
+ <para>
+ Number format symbols used by <function>numfmt_get_symbol</function>
+ and <function>numfmt_set_symbol</function>.
+ <variablelist>
+ <varlistentry>
+ <term>
<constant>NumberFormatter::DECIMAL_SEPARATOR_SYMBOL</constant>
(<type>integer</type>)
- </term>
- <listitem>
- <simpara>
- The decimal separator.
- </simpara>
- </listitem>
- </varlistentry>
+ </term>
+ <listitem>
+ <simpara>The decimal separator.</simpara>
+ </listitem>
+ </varlistentry>
- <varlistentry>
- <term>
+ <varlistentry>
+ <term>
<constant>NumberFormatter::GROUPING_SEPARATOR_SYMBOL</constant>
(<type>integer</type>)
- </term>
- <listitem>
- <simpara>
- The grouping separator.
- </simpara>
- </listitem>
- </varlistentry>
+ </term>
+ <listitem>
+ <simpara>The grouping separator.</simpara>
+ </listitem>
+ </varlistentry>
- <varlistentry>
- <term>
+ <varlistentry>
+ <term>
<constant>NumberFormatter::PATTERN_SEPARATOR_SYMBOL</constant>
(<type>integer</type>)
- </term>
- <listitem>
- <simpara>
- The pattern separator.
- </simpara>
- </listitem>
- </varlistentry>
+ </term>
+ <listitem>
+ <simpara>The pattern separator.</simpara>
+ </listitem>
+ </varlistentry>
- <varlistentry>
- <term>
+ <varlistentry>
+ <term>
<constant>NumberFormatter::PERCENT_SYMBOL</constant>
(<type>integer</type>)
- </term>
- <listitem>
- <simpara>
- The percent sign.
- </simpara>
- </listitem>
- </varlistentry>
+ </term>
+ <listitem>
+ <simpara>The percent sign.</simpara>
+ </listitem>
+ </varlistentry>
- <varlistentry>
- <term>
+ <varlistentry>
+ <term>
<constant>NumberFormatter::ZERO_DIGIT_SYMBOL</constant>
(<type>integer</type>)
- </term>
- <listitem>
- <simpara>
- Zero.
- </simpara>
- </listitem>
- </varlistentry>
+ </term>
+ <listitem>
+ <simpara>Zero.</simpara>
+ </listitem>
+ </varlistentry>
- <varlistentry>
- <term>
+ <varlistentry>
+ <term>
<constant>NumberFormatter::DIGIT_SYMBOL</constant>
(<type>integer</type>)
- </term>
- <listitem>
- <simpara>
- Character representing a digit in the pattern.
- </simpara>
- </listitem>
- </varlistentry>
+ </term>
+ <listitem>
+ <simpara>Character representing a digit in the pattern.</simpara>
+ </listitem>
+ </varlistentry>
- <varlistentry>
- <term>
+ <varlistentry>
+ <term>
<constant>NumberFormatter::MINUS_SIGN_SYMBOL</constant>
(<type>integer</type>)
- </term>
- <listitem>
- <simpara>
- The minus sign.
- </simpara>
- </listitem>
- </varlistentry>
+ </term>
+ <listitem>
+ <simpara>The minus sign.</simpara>
+ </listitem>
+ </varlistentry>
- <varlistentry>
- <term>
+ <varlistentry>
+ <term>
<constant>NumberFormatter::PLUS_SIGN_SYMBOL</constant>
(<type>integer</type>)
- </term>
- <listitem>
- <simpara>
- The plus sign.
- </simpara>
- </listitem>
- </varlistentry>
+ </term>
+ <listitem>
+ <simpara>The plus sign.</simpara>
+ </listitem>
+ </varlistentry>
- <varlistentry>
- <term>
+ <varlistentry>
+ <term>
<constant>NumberFormatter::CURRENCY_SYMBOL</constant>
(<type>integer</type>)
- </term>
- <listitem>
- <simpara>
- The currency symbol.
- </simpara>
- </listitem>
- </varlistentry>
+ </term>
+ <listitem>
+ <simpara>The currency symbol.</simpara>
+ </listitem>
+ </varlistentry>
- <varlistentry>
- <term>
+ <varlistentry>
+ <term>
<constant>NumberFormatter::INTL_CURRENCY_SYMBOL</constant>
(<type>integer</type>)
- </term>
- <listitem>
- <simpara>
- The international currency symbol.
- </simpara>
- </listitem>
- </varlistentry>
+ </term>
+ <listitem>
+ <simpara>The international currency symbol.</simpara>
+ </listitem>
+ </varlistentry>
- <varlistentry>
- <term>
+ <varlistentry>
+ <term>
<constant>NumberFormatter::MONETARY_SEPARATOR_SYMBOL</constant>
(<type>integer</type>)
- </term>
- <listitem>
- <simpara>
- The monetary separator.
- </simpara>
- </listitem>
- </varlistentry>
+ </term>
+ <listitem>
+ <simpara>The monetary separator.</simpara>
+ </listitem>
+ </varlistentry>
- <varlistentry>
- <term>
+ <varlistentry>
+ <term>
<constant>NumberFormatter::EXPONENTIAL_SYMBOL</constant>
(<type>integer</type>)
- </term>
- <listitem>
- <simpara>
- The exponential symbol.
- </simpara>
- </listitem>
- </varlistentry>
+ </term>
+ <listitem>
+ <simpara>The exponential symbol.</simpara>
+ </listitem>
+ </varlistentry>
- <varlistentry>
- <term>
+ <varlistentry>
+ <term>
<constant>NumberFormatter::PERMILL_SYMBOL</constant>
(<type>integer</type>)
- </term>
- <listitem>
- <simpara>
- Per mill symbol.
- </simpara>
- </listitem>
- </varlistentry>
+ </term>
+ <listitem>
+ <simpara>Per mill symbol.</simpara>
+ </listitem>
+ </varlistentry>
- <varlistentry>
- <term>
+ <varlistentry>
+ <term>
<constant>NumberFormatter::PAD_ESCAPE_SYMBOL</constant>
(<type>integer</type>)
- </term>
- <listitem>
- <simpara>
- Escape padding character.
- </simpara>
- </listitem>
- </varlistentry>
+ </term>
+ <listitem>
+ <simpara>Escape padding character.</simpara>
+ </listitem>
+ </varlistentry>
- <varlistentry>
- <term>
+ <varlistentry>
+ <term>
<constant>NumberFormatter::INFINITY_SYMBOL</constant>
(<type>integer</type>)
- </term>
- <listitem>
- <simpara>
- Infinity symbol.
- </simpara>
- </listitem>
- </varlistentry>
+ </term>
+ <listitem>
+ <simpara>Infinity symbol.</simpara>
+ </listitem>
+ </varlistentry>
- <varlistentry>
- <term>
+ <varlistentry>
+ <term>
<constant>NumberFormatter::NAN_SYMBOL</constant>
(<type>integer</type>)
- </term>
- <listitem>
- <simpara>
- Not-a-number symbol.
- </simpara>
- </listitem>
- </varlistentry>
+ </term>
+ <listitem>
+ <simpara>Not-a-number symbol.</simpara>
+ </listitem>
+ </varlistentry>
- <varlistentry>
- <term>
+ <varlistentry>
+ <term>
<constant>NumberFormatter::SIGNIFICANT_DIGIT_SYMBOL</constant>
(<type>integer</type>)
- </term>
- <listitem>
- <simpara>
- Significant digit symbol.
- </simpara>
- </listitem>
- </varlistentry>
+ </term>
+ <listitem>
+ <simpara>Significant digit symbol.</simpara>
+ </listitem>
+ </varlistentry>
- <varlistentry>
- <term>
+ <varlistentry>
+ <term>
<constant>NumberFormatter::MONETARY_GROUPING_SEPARATOR_SYMBOL</constant>
(<type>integer</type>)
- </term>
- <listitem>
- <simpara>
- The monetary grouping separator.
- </simpara>
- </listitem>
- </varlistentry>
-</variablelist>
- </para>
+ </term>
+ <listitem>
+ <simpara>The monetary grouping separator.</simpara>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
</section>
-
+
<section xml:id="intl.numberformatter-constants.UNumberFormatRoundingMode">
- <para>
- Rounding mode values used by <function>numfmt_get_attribute</function> and \
<function>numfmt_set_attribute</function> with \
<constant>NumberFormatter::ROUNDING_MODE</constant> attribute.
- <variablelist>
- <varlistentry>
- <term>
+ <para>
+ Rounding mode values used by <function>numfmt_get_attribute</function>
+ and <function>numfmt_set_attribute</function> with
+ <constant>NumberFormatter::ROUNDING_MODE</constant> attribute.
+ <variablelist>
+ <varlistentry>
+ <term>
<constant>NumberFormatter::ROUND_CEILING</constant>
(<type>integer</type>)
- </term>
- <listitem>
- <simpara>
- Rounding mode to round towards positive infinity.
- </simpara>
- </listitem>
- </varlistentry>
+ </term>
+ <listitem>
+ <simpara>Rounding mode to round towards positive infinity.</simpara>
+ </listitem>
+ </varlistentry>
- <varlistentry>
- <term>
+ <varlistentry>
+ <term>
<constant>NumberFormatter::ROUND_DOWN</constant>
(<type>integer</type>)
- </term>
- <listitem>
- <simpara>
- Rounding mode to round towards zero.
- </simpara>
- </listitem>
- </varlistentry>
+ </term>
+ <listitem>
+ <simpara>Rounding mode to round towards zero.</simpara>
+ </listitem>
+ </varlistentry>
- <varlistentry>
- <term>
+ <varlistentry>
+ <term>
<constant>NumberFormatter::ROUND_FLOOR</constant>
(<type>integer</type>)
- </term>
- <listitem>
- <simpara>
- Rounding mode to round towards negative infinity.
- </simpara>
- </listitem>
- </varlistentry>
+ </term>
+ <listitem>
+ <simpara>Rounding mode to round towards negative infinity.</simpara>
+ </listitem>
+ </varlistentry>
- <varlistentry>
- <term>
+ <varlistentry>
+ <term>
<constant>NumberFormatter::ROUND_HALFDOWN</constant>
(<type>integer</type>)
- </term>
- <listitem>
+ </term>
+ <listitem>
<simpara>
- Rounding mode to round towards "nearest neighbor" unless both neighbors are \
equidistant, in which case round down. + Rounding mode to round towards \
"nearest neighbor" unless both neighbors + are equidistant, in which case round \
down. </simpara>
- </listitem>
- </varlistentry>
+ </listitem>
+ </varlistentry>
- <varlistentry>
- <term>
+ <varlistentry>
+ <term>
<constant>NumberFormatter::ROUND_HALFEVEN</constant>
(<type>integer</type>)
- </term>
- <listitem>
+ </term>
+ <listitem>
<simpara>
- Rounding mode to round towards the "nearest neighbor" unless both neighbors \
are equidistant, in which case, round towards the even neighbor. + Rounding \
mode to round towards the "nearest neighbor" unless both + neighbors are \
equidistant, in which case, round towards the even + neighbor.
</simpara>
- </listitem>
- </varlistentry>
+ </listitem>
+ </varlistentry>
- <varlistentry>
- <term>
+ <varlistentry>
+ <term>
<constant>NumberFormatter::ROUND_HALFUP</constant>
(<type>integer</type>)
- </term>
- <listitem>
+ </term>
+ <listitem>
<simpara>
- Rounding mode to round towards "nearest neighbor" unless both neighbors are \
equidistant, in which case round up. + Rounding mode to round towards "nearest \
neighbor" unless both neighbors + are equidistant, in which case round up.
</simpara>
- </listitem>
- </varlistentry>
+ </listitem>
+ </varlistentry>
- <varlistentry>
- <term>
+ <varlistentry>
+ <term>
<constant>NumberFormatter::ROUND_UP</constant>
(<type>integer</type>)
- </term>
- <listitem>
- <simpara>
- Rounding mode to round away from zero.
- </simpara>
- </listitem>
- </varlistentry>
-</variablelist>
- </para>
+ </term>
+ <listitem>
+ <simpara>Rounding mode to round away from zero.</simpara>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
</section>
-
+
<section xml:id="intl.numberformatter-constants.UNumberFormatPadPosition">
- <para>
- Pad position values used by <function>numfmt_get_attribute</function> and \
<function>numfmt_set_attribute</function> with \
<constant>NumberFormatter::PADDING_POSITION</constant> attribute.
- <variablelist>
- <varlistentry>
- <term>
+ <para>
+ Pad position values used by <function>numfmt_get_attribute</function>
+ and <function>numfmt_set_attribute</function> with
+ <constant>NumberFormatter::PADDING_POSITION</constant> attribute.
+ <variablelist>
+ <varlistentry>
+ <term>
<constant>NumberFormatter::PAD_AFTER_PREFIX</constant>
(<type>integer</type>)
- </term>
- <listitem>
- <simpara>
- Pad characters inserted after the prefix.
- </simpara>
- </listitem>
- </varlistentry>
+ </term>
+ <listitem>
+ <simpara>Pad characters inserted after the prefix.</simpara>
+ </listitem>
+ </varlistentry>
- <varlistentry>
- <term>
+ <varlistentry>
+ <term>
<constant>NumberFormatter::PAD_AFTER_SUFFIX</constant>
(<type>integer</type>)
- </term>
- <listitem>
- <simpara>
- Pad characters inserted after the suffix.
- </simpara>
- </listitem>
- </varlistentry>
+ </term>
+ <listitem>
+ <simpara>Pad characters inserted after the suffix.</simpara>
+ </listitem>
+ </varlistentry>
- <varlistentry>
- <term>
+ <varlistentry>
+ <term>
<constant>NumberFormatter::PAD_BEFORE_PREFIX</constant>
(<type>integer</type>)
- </term>
- <listitem>
- <simpara>
- Pad characters inserted before the prefix.
- </simpara>
- </listitem>
- </varlistentry>
+ </term>
+ <listitem>
+ <simpara>Pad characters inserted before the prefix.</simpara>
+ </listitem>
+ </varlistentry>
- <varlistentry>
- <term>
+ <varlistentry>
+ <term>
<constant>NumberFormatter::PAD_BEFORE_SUFFIX</constant>
(<type>integer</type>)
- </term>
- <listitem>
- <simpara>
- Pad characters inserted before the suffix.
- </simpara>
- </listitem>
- </varlistentry>
-</variablelist>
- </para>
+ </term>
+ <listitem>
+ <simpara>Pad characters inserted before the suffix.</simpara>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
</section>
-
- </section>
-
+
+</section>
+
<!-- Keep this comment at the end of the file
-Local variables:
-mode: sgml
-sgml-omittag:t
-sgml-shorttag:t
-sgml-minimize-attributes:nil
-sgml-always-quote-attributes:t
-sgml-indent-step:1
-sgml-indent-data:t
-indent-tabs-mode:nil
-sgml-parent-document:nil
-sgml-default-dtd-file:"../../../manual.ced"
-sgml-exposed-tags:nil
-sgml-local-catalogs:nil
-sgml-local-ecat-files:nil
-End:
-vim600: syn=xml fen fdm=syntax fdl=2 si
-vim: et tw=78 syn=sgml
-vi: ts=1 sw=1
--->
-
+ Local variables:
+ mode: sgml
+ sgml-omittag:t
+ sgml-shorttag:t
+ sgml-minimize-attributes:nil
+ sgml-always-quote-attributes:t
+ sgml-indent-step:1
+ sgml-indent-data:t
+ indent-tabs-mode:nil
+ sgml-parent-document:nil
+ sgml-default-dtd-file:"../../../manual.ced"
+ sgml-exposed-tags:nil
+ sgml-local-catalogs:nil
+ sgml-local-ecat-files:nil
+ End:
+ vim600: syn=xml fen fdm=syntax fdl=2 si
+ vim: et tw=78 syn=sgml
+ vi: ts=1 sw=1
+-->
+
http://cvs.php.net/viewvc.cgi/pecl/intl/doc/intl/numberformatter.xml?r1=1.2&r2=1.3&diff_format=u
Index: pecl/intl/doc/intl/numberformatter.xml
diff -u pecl/intl/doc/intl/numberformatter.xml:1.2 \
pecl/intl/doc/intl/numberformatter.xml:1.3
--- pecl/intl/doc/intl/numberformatter.xml:1.2 Wed Nov 28 22:26:10 2007
+++ pecl/intl/doc/intl/numberformatter.xml Fri Nov 30 00:54:04 2007
@@ -1,12 +1,15 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision: 1.2 $ -->
-<reference xml:id="class.numberformatter" xmlns="http://docbook.org/ns/docbook" \
xmlns:xlink="http://www.w3.org/1999/xlink" \
xmlns:xi="http://www.w3.org/2001/XInclude">
- <title>The NumberFormatter class</title>
- <titleabbrev>NumberFormatter</titleabbrev>
+<!-- $Revision: 1.3 $ -->
+<reference xml:id="class.numberformatter"
+ xmlns="http://docbook.org/ns/docbook"
+ xmlns:xlink="http://www.w3.org/1999/xlink"
+ xmlns:xi="http://www.w3.org/2001/XInclude">
+ <title>The NumberFormatter class</title>
+ <titleabbrev>NumberFormatter</titleabbrev>
<partintro>
-
-<!-- {{{ NumberFormatter intro -->
+
+ <!-- {{{ NumberFormatter intro -->
<section xml:id="numberformatter.intro">
&reftitle.intro;
<simpara>
@@ -14,124 +17,140 @@
representation. When displaying or printing a number it is converted to a
locale-specific string. For example, the number 12345.67 is "12,345.67" in
the US, "12 345,67" in France and "12.345,67" in Germany.
- </simpara>
- <simpara>
+ </simpara>
+ <simpara>
By invoking the methods provided by the NumberFormatter class, you can
format numbers, currencies, and percentages according to the specified or
- default locale. NumberFormatter is locale-sensitive so you need to create a
- new NumberFormatter for each locale. NumberFormatter methods format
+ default locale. NumberFormatter is locale-sensitive so you need to create
+ a new NumberFormatter for each locale. NumberFormatter methods format
primitive-type numbers, such as double and output the number as a
locale-specific string.
- </simpara>
- <para>
+ </simpara>
+ <para>
For currencies you can use currency format type to create a formatter that
returns a string with the formatted number and the appropriate currency
- sign. Of course, the NumberFormatter class is unaware of exchange rates so, the
- number output is the same regardless of the specified currency. This means
- that the same number has different monetary values depending on the currency
- locale. If the number is 9988776.65 the results will be:
+ sign. Of course, the NumberFormatter class is unaware of exchange rates
+ so, the number output is the same regardless of the specified currency.
+ This means that the same number has different monetary values depending on
+ the currency locale. If the number is 9988776.65 the results will be:
<simplelist>
- <member>9 988 776,65 € in France</member>
- <member>9.988.776,65 € in Germany</member>
- <member>$9,988,776.65 in the United States</member>
+ <member>9 988 776,65 € in France</member>
+ <member>9.988.776,65 € in Germany</member>
+ <member>$9,988,776.65 in the United States</member>
</simplelist>
- </para>
- <simpara>
- In order to format percentages, create a locale-specific formatter with \
percentage
- format type. With this formatter, a decimal fraction such
- as 0.75 is displayed as 75%.
- </simpara>
- <simpara>
- For more complex formatting, like spelled-out numbers, the rule-based number \
formatters are used.
- </simpara>
- </section>
-<!-- }}} -->
-
+ </para>
+ <simpara>
+ In order to format percentages, create a locale-specific formatter with
+ percentage format type. With this formatter, a decimal fraction such as
+ 0.75 is displayed as 75%.
+ </simpara>
+ <simpara>
+ For more complex formatting, like spelled-out numbers, the rule-based
+ number formatters are used.
+ </simpara>
+ </section>
+ <!-- }}} -->
+
<section xml:id="NumberFormatter.synopsis">
<title>Class synopsis</title>
-
-<!-- {{{ Synopsis -->
+
+ <!-- {{{ Synopsis -->
<classsynopsis>
- <ooclass><classname>NumberFormatter</classname></ooclass>
-
-<!-- {{{ Class synopsis -->
-<!--
- <classsynopsisinfo>
+ <ooclass>
+ <classname>NumberFormatter</classname>
+ </ooclass>
+
+ <!-- {{{ Class synopsis -->
+ <!--
+ <classsynopsisinfo>
<ooclass>
- <classname>NumberFormatter</classname>
+ <classname>NumberFormatter</classname>
</ooclass>
- </classsynopsisinfo>
--->
-<!-- }}} -->
-
-<!--
- <classsynopsisinfo role="comment">Properties</classsynopsisinfo>
- <fieldsynopsis>
+ </classsynopsisinfo>
+ -->
+ <!-- }}} -->
+
+ <!--
+ <classsynopsisinfo role="comment">Properties</classsynopsisinfo>
+ <fieldsynopsis>
<modifier>public</modifier>
<type>string</type>
<varname linkend="NumberFormatter.props.name">name</varname>
- </fieldsynopsis>
-
- <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) \
xpointer(id('class.NumberFormatter')/db:refentry/db:refsect1[@role='description']/descendant::db:fieldsynopsis[1])" \
/>
--->
-
+ </fieldsynopsis>
+
+ <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) \
xpointer(id('class.NumberFormatter')/db:refentry/db:refsect1[@role='description']/descendant::db:fieldsynopsis[1])" \
/> + -->
+
<classsynopsisinfo role="comment">Methods</classsynopsisinfo>
- <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) \
xpointer(id('class.numberformatter')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[1])" \
/> + <xi:include
+ xpointer="xmlns(db=http://docbook.org/ns/docbook) \
xpointer(id('class.numberformatter')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[1])" \
/> </classsynopsis>
-<!-- }}} -->
-
+ <!-- }}} -->
+
</section>
-
-<!-- {{{ NumberFormatter properties
- <section xml:id="NumberFormatter.props">
+
+ <!-- {{{ NumberFormatter properties
+ <section xml:id="NumberFormatter.props">
&reftitle.properties;
<variablelist>
- <varlistentry xml:id="NumberFormatter.props.name">
- <term><varname>name</varname></term>
- <listitem>
- <para>Prop description</para>
- </listitem>
- </varlistentry>
+ <varlistentry xml:id="NumberFormatter.props.name">
+ <term><varname>name</varname></term>
+ <listitem>
+ <para>Prop description</para>
+ </listitem>
+ </varlistentry>
</variablelist>
- </section>
-}}} -->
-
+ </section>
+ }}} -->
+
&reference.intl.numberformatter-constants;
<section xml:id="numberformatter.seealso">
&reftitle.seealso;
<para>
<simplelist>
- <member><link xlink:href="&url.icu.formatparse;">ICU formatting \
documentation</link></member>
- <member><link xlink:href="&url.icu.formatnumbers;">ICU number \
formatters</link></member>
- <member><link xlink:href="&url.icu.decimalformat;">ICU decimal \
formatters</link></member>
- <member><link xlink:href="&url.icu.ruleformat;">ICU rule-based number \
formatters</link></member> + <member>
+ <link xlink:href="&url.icu.formatparse;">
+ ICU formatting documentation
+ </link>
+ </member>
+ <member>
+ <link xlink:href="&url.icu.formatnumbers;">ICU number formatters</link>
+ </member>
+ <member>
+ <link xlink:href="&url.icu.decimalformat;">ICU decimal formatters</link>
+ </member>
+ <member>
+ <link xlink:href="&url.icu.ruleformat;">
+ ICU rule-based number formatters
+ </link>
+ </member>
</simplelist>
</para>
</section>
</partintro>
-
+
&reference.intl.numberformatter.entities;
-
+
</reference>
-
+
<!-- Keep this comment at the end of the file
-Local variables:
-mode: sgml
-sgml-omittag:t
-sgml-shorttag:t
-sgml-minimize-attributes:nil
-sgml-always-quote-attributes:t
-sgml-indent-step:1
-sgml-indent-data:t
-indent-tabs-mode:nil
-sgml-parent-document:nil
-sgml-default-dtd-file:"../../../../manual.ced"
-sgml-exposed-tags:nil
-sgml-local-catalogs:nil
-sgml-local-ecat-files:nil
-End:
-vim600: syn=xml fen fdm=syntax fdl=2 si
-vim: et tw=78 syn=sgml
-vi: ts=1 sw=1
+ Local variables:
+ mode: sgml
+ sgml-omittag:t
+ sgml-shorttag:t
+ sgml-minimize-attributes:nil
+ sgml-always-quote-attributes:t
+ sgml-indent-step:1
+ sgml-indent-data:t
+ indent-tabs-mode:nil
+ sgml-parent-document:nil
+ sgml-default-dtd-file:"../../../../manual.ced"
+ sgml-exposed-tags:nil
+ sgml-local-catalogs:nil
+ sgml-local-ecat-files:nil
+ End:
+ vim600: syn=xml fen fdm=syntax fdl=2 si
+ vim: et tw=78 syn=sgml
+ vi: ts=1 sw=1
-->
http://cvs.php.net/viewvc.cgi/pecl/intl/doc/intl/reference.xml?r1=1.10&r2=1.11&diff_format=u
Index: pecl/intl/doc/intl/reference.xml
diff -u pecl/intl/doc/intl/reference.xml:1.10 pecl/intl/doc/intl/reference.xml:1.11
--- pecl/intl/doc/intl/reference.xml:1.10 Wed Nov 28 22:26:10 2007
+++ pecl/intl/doc/intl/reference.xml Fri Nov 30 00:54:04 2007
@@ -1,7 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision: 1.10 $ -->
+<!-- $Revision: 1.11 $ -->
-<book xml:id="ref.intl" xmlns="http://docbook.org/ns/docbook" \
xmlns:xlink="http://www.w3.org/1999/xlink"> +<book xml:id="ref.intl" \
xmlns="http://docbook.org/ns/docbook" + xmlns:xlink="http://www.w3.org/1999/xlink">
<title>Internationalization Functions</title>
<titleabbrev>intl</titleabbrev>
@@ -9,46 +10,50 @@
<preface xml:id="intl.intro">
&reftitle.intro;
<para>
- Internationalization extension (further is referred as Intl) is a wrapper for
- <link xlink:href="&url.icu.home;">ICU</link> library,
- enabling PHP programmers to perform UCA-conformant collation and
+ Internationalization extension (further is referred as Intl) is a wrapper
+ for <link xlink:href="&url.icu.home;">ICU</link>
+ library, enabling PHP programmers to perform UCA-conformant collation and
date/time/number/currency formatting in their scripts.
</para>
<para>
- It tends to closely follow ICU APIs, so that people having
- experience working with ICU in either C/C++ or Java could easily use
- the PHP API. Also, this way ICU documentation would be useful to
- understand various ICU functions.
+ It tends to closely follow ICU APIs, so that people having experience
+ working with ICU in either C/C++ or Java could easily use the PHP API.
+ Also, this way ICU documentation would be useful to understand various ICU
+ functions.
</para>
<para>
- Intl consists of several modules, each of them exposes the corresponding ICU API:
+ Intl consists of several modules, each of them exposes the corresponding
+ ICU API:
</para>
<itemizedlist>
<listitem>
<simpara>
- Collator: provides string comparison capability with
- support for appropriate locale-sensitive sort orderings.
+ Collator: provides string comparison capability with support for
+ appropriate locale-sensitive sort orderings.
</simpara>
</listitem>
<listitem>
<simpara>
- Number Formatter: allows to display number according to the localized format or
- given pattern or set of rules, and to parse strings into numbers.
+ Number Formatter: allows to display number according to the localized
+ format or given pattern or set of rules, and to parse strings into
+ numbers.
</simpara>
</listitem>
<listitem>
<simpara>
- Normalizer: provides a function to transform text into one of the Unicode \
normalization
- forms, and provides a routine to test if a given string is already normalized.
+ Normalizer: provides a function to transform text into one of the Unicode
+ normalization forms, and provides a routine to test if a given string is
+ already normalized.
</simpara>
</listitem>
<listitem>
<simpara>
- Locale: provides interaction with locale identifiers in the form of functions
- to get subtags from locale identifier; parse ,compose ,match(lookup and filter) \
locale identifiers. + Locale: provides interaction with locale identifiers in the \
form of + functions to get subtags from locale identifier; parse, compose,
+ match(lookup and filter) locale identifiers.
</simpara>
</listitem>
</itemizedlist>
@@ -58,19 +63,13 @@
<title>Links</title>
<itemizedlist>
<listitem>
- <para>
- <link xlink:href="&url.icu.docs;">Miscellaneous ICU docs</link>
- </para>
+ <para><link xlink:href="&url.icu.docs;">Miscellaneous ICU docs</link></para>
</listitem>
<listitem>
- <para>
- <link xlink:href="&url.icu.userguide;">ICU Userguide</link>
- </para>
+ <para><link xlink:href="&url.icu.userguide;">ICU Userguide</link></para>
</listitem>
<listitem>
- <para>
- <link xlink:href="&url.icu.uca;">Unicode Collation Algorithm</link>
- </para>
+ <para><link xlink:href="&url.icu.uca;">Unicode Collation \
Algorithm</link></para> </listitem>
</itemizedlist>
</section>
@@ -80,144 +79,141 @@
<!-- }}} -->
<!-- {{{ Setup -->
- <chapter xml:id="intl.setup" xmlns="http://docbook.org/ns/docbook" \
xmlns:xlink="http://www.w3.org/1999/xlink"> + <chapter xml:id="intl.setup" \
xmlns="http://docbook.org/ns/docbook" + xmlns:xlink="http://www.w3.org/1999/xlink">
<title>Installing/Configuring</title>
-
+
<!-- {{{ Requirements -->
<section xml:id="intl.requirements">
&reftitle.required;
<para>
- To build the extension you need to install the <link \
xlink:href="&url.icu.home;">ICU</link> library of version 3.6+. + To build the \
extension you need to install the + <link xlink:href="&url.icu.home;">ICU</link>
+ library of version 3.6+.
</para>
<para>
- You will also need the latest version of PHP.
- Collator is known to work well on PHP 5.1.3+ and 5.2.0+.
+ You will also need the latest version of PHP. Collator is known to work
+ well on PHP 5.1.3+ and 5.2.0+.
</para>
</section>
<!-- }}} -->
-
+
<!-- {{{ Installation -->
<section xml:id="intl.installation">
&reftitle.install;
<para>
Run:
<screen>
-<![CDATA[
+ <![CDATA[
$ make install
]]>
</screen>
</para>
<para>
- Then enable the extension by adding the following line to [PHP] section
- of your php.ini:
+ Then enable the extension by adding the following line to [PHP] section of
+ your php.ini:
<screen>
-<![CDATA[
+ <![CDATA[
extension=intl.so
]]>
</screen>
</para>
</section>
<!-- }}} -->
-
+
<!-- {{{ Testing -->
<section xml:id="intl.testing">
<title>Testing</title>
<para>
Run:
<screen>
-<![CDATA[
+ <![CDATA[
$ make test
]]>
- </screen>
- </para>
- <para>
- Note that the tests may fail if:
+ </screen>
</para>
-
+ <para>Note that the tests may fail if:</para>
+
<itemizedlist>
<listitem>
<para>
- The Collator exetnsion is already enabled in &php.ini;
+ The Collator exetnsion is already enabled in
+ &php.ini;
</para>
</listitem>
<listitem>
<para>
- LD_LIBRARY_PATH is used to load ICU libraries and value of the
- 'variables_order' setting in php.ini doesn't contain letter 'E'
- (missing 'E' means "do not register Environment variables");
+ LD_LIBRARY_PATH is used to load ICU libraries and value of the
+ 'variables_order' setting in php.ini doesn't contain letter 'E' (missing
+ 'E' means "do not register Environment variables");
</para>
</listitem>
</itemizedlist>
</section>
<!-- }}} -->
- &reference.intl.configure;
-
+ &reference.intl.configure;
+
<!-- {{{ Resources -->
<section xml:id="intl.resources">
&reftitle.resources;
&no.resource;
</section>
<!-- }}} -->
-
+
</chapter>
<!-- }}} -->
&reference.intl.constants;
-<!-- {{{ Examples -->
-<appendix xml:id="intl.examples" xmlns="http://docbook.org/ns/docbook" \
xmlns:xlink="http://www.w3.org/1999/xlink">
- &reftitle.examples;
- <section xml:id="intl.examples.basic">
- <title>Basic usage of this extension</title>
- <para>
- Each module provides two kind of APIs: a procedural one and an object oriented
- one. Both are actually identical and described in the corresponding document.
- </para>
- <note>
- <para>
- Note: All input strings must be in UTF-8 encoding. All output strings are also \
in UTF-8.
- </para>
- </note>
-<!-- This manual should now be the primary documentation source.
- <para>
- For more information about 'Collator' module API see doc/collator_api.php,
- </para>
- <para>
- For more information about 'Formatter' module API see doc/formatter_api.php
- </para>
--->
- <example>
- <title>Example of using the procedural API</title>
- <programlisting role="php">
-<![CDATA[
+ <!-- {{{ Examples -->
+ <appendix xml:id="intl.examples" xmlns="http://docbook.org/ns/docbook"
+ xmlns:xlink="http://www.w3.org/1999/xlink">
+ &reftitle.examples;
+ <section xml:id="intl.examples.basic">
+ <title>Basic usage of this extension</title>
+ <para>
+ Each module provides two kind of APIs: a procedural one and an object
+ oriented one. Both are actually identical and described in the
+ corresponding document.
+ </para>
+ <note>
+ <para>
+ Note: All input strings must be in UTF-8 encoding. All output strings are
+ also in UTF-8.
+ </para>
+ </note>
+ <example>
+ <title>Example of using the procedural API</title>
+ <programlisting role="php">
+ <![CDATA[
<?php
-$coll = collator_create( 'en_US' );
-$result = collator_compare( $coll, "string#1", "string#2" );
+$coll = collator_create('en_US');
+$result = collator_compare($coll, "string#1", "string#2");
?>
]]>
- </programlisting>
- </example>
+ </programlisting>
+ </example>
- <example>
- <title>Example of using the object-oriented API</title>
- <programlisting role="php">
-<![CDATA[
+ <example>
+ <title>Example of using the object-oriented API</title>
+ <programlisting role="php">
+ <![CDATA[
<?php
-$coll = new Collator( 'en_US' );
-$al = $coll->getLocaleByType( ULOC_ACTUAL_LOCALE );
+$coll = new Collator('en_US');
+$al = $coll->getLocaleByType(Locale::ACTUAL_LOCALE);
echo "Actual locale: $al\n";
-$formatter = new NumberFormatter( 'en_US', NumberFormatter::DECIMAL );
-echo $formatter->format( 1234567 );
+$formatter = new NumberFormatter('en_US', NumberFormatter::DECIMAL);
+echo $formatter->format(1234567);
?>
]]>
- </programlisting>
- </example>
- </section>
-</appendix>
-<!-- }}} -->
+ </programlisting>
+ </example>
+ </section>
+ </appendix>
+ <!-- }}} -->
&reference.intl.collator;
&reference.intl.numberformatter;
@@ -225,31 +221,31 @@
&reference.intl.normalizer;
&reference.intl.messageformatter;
- <reference xml:id="functions.intl" xmlns="http://docbook.org/ns/docbook" \
xmlns:xlink="http://www.w3.org/1999/xlink"> + <reference xml:id="functions.intl" \
xmlns="http://docbook.org/ns/docbook" + xmlns:xlink="http://www.w3.org/1999/xlink">
<title>intl &Functions;</title>
-
&reference.intl.functions.entities;
</reference>
</book>
<!-- Keep this comment at the end of the file
-Local variables:
-mode: sgml
-sgml-omittag:t
-sgml-shorttag:t
-sgml-minimize-attributes:nil
-sgml-always-quote-attributes:t
-sgml-indent-step:1
-sgml-indent-data:t
-indent-tabs-mode:nil
-sgml-parent-document:nil
-sgml-default-dtd-file:"../../../manual.ced"
-sgml-exposed-tags:nil
-sgml-local-catalogs:nil
-sgml-local-ecat-files:nil
-End:
-vim600: syn=xml fen fdm=syntax fdl=2 si
-vim: et tw=78 syn=sgml
-vi: ts=1 sw=1
--->
+ Local variables:
+ mode: sgml
+ sgml-omittag:t
+ sgml-shorttag:t
+ sgml-minimize-attributes:nil
+ sgml-always-quote-attributes:t
+ sgml-indent-step:1
+ sgml-indent-data:t
+ indent-tabs-mode:nil
+ sgml-parent-document:nil
+ sgml-default-dtd-file:"../../../manual.ced"
+ sgml-exposed-tags:nil
+ sgml-local-catalogs:nil
+ sgml-local-ecat-files:nil
+ End:
+ vim600: syn=xml fen fdm=syntax fdl=2 si
+ vim: et tw=78 syn=sgml
+ vi: ts=1 sw=1
+-->
--
PECL CVS Mailing List
To unsubscribe, visit: http://www.php.net/unsub.php
[prev in list] [next in list] [prev in thread] [next in thread]
Configure |
About |
News |
Add a list |
Sponsored by KoreLogic