reference/intl/locale/get-display-language.xml
1976eae0d815797af97a1e16c5cd90ffc2868395
...
...
@@ -1,6 +1,6 @@
1
1
<?xml version="1.0" encoding="utf-8"?>
2
2
<!-- $Revision$ -->
3
-
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="locale.getdisplaylanguage">
3
+
<refentry xml:id="locale.getdisplaylanguage" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
4
4
<refnamediv>
5
5
<refname>Locale::getDisplayLanguage</refname>
6
6
<refname>locale_get_display_language</refname>
...
...
@@ -12,22 +12,18 @@
12
12
<para>
13
13
&style.oop;
14
14
</para>
15
-
<methodsynopsis>
16
-
<modifier>public</modifier>
17
-
<modifier>static</modifier>
18
-
<type>string</type>
19
-
<methodname>Locale::getDisplayLanguage</methodname>
15
+
<methodsynopsis role="Locale">
16
+
<modifier>public</modifier> <modifier>static</modifier> <type class="union"><type>string</type><type>false</type></type><methodname>Locale::getDisplayLanguage</methodname>
20
17
<methodparam><type>string</type><parameter>locale</parameter></methodparam>
21
-
<methodparam choice="opt"><type>string</type><parameter>in_locale</parameter></methodparam>
18
+
<methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>displayLocale</parameter><initializer>&null;</initializer></methodparam>
22
19
</methodsynopsis>
23
20
<para>
24
21
&style.procedural;
25
22
</para>
26
23
<methodsynopsis>
27
-
<type>string</type>
28
-
<methodname>locale_get_display_language</methodname>
24
+
<type class="union"><type>string</type><type>false</type></type><methodname>locale_get_display_language</methodname>
29
25
<methodparam><type>string</type><parameter>locale</parameter></methodparam>
30
-
<methodparam choice="opt"><type>string</type><parameter>in_locale</parameter></methodparam>
26
+
<methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>displayLocale</parameter><initializer>&null;</initializer></methodparam>
31
27
</methodsynopsis>
32
28
<para>
33
29
Returns an appropriately localized display name for language of the input
...
...
@@ -48,7 +44,7 @@
48
44
</listitem>
49
45
</varlistentry>
50
46
<varlistentry>
51
-
<term><parameter>in_locale</parameter></term>
47
+
<term><parameter>displayLocale</parameter></term>
52
48
<listitem>
53
49
<para>
54
50
Optional format locale to use to display the language name
...
...
@@ -59,15 +55,36 @@
59
55
</para>
60
56
</refsect1>
61
57

62
-

63
58
<refsect1 role="returnvalues">
64
59
&reftitle.returnvalues;
65
60
<para>
66
-
display name of the language for the $locale in the format appropriate for
67
-
$in_locale.
61
+
Display name of the language for the <parameter>locale</parameter> in the format appropriate for
62
+
<parameter>displayLocale</parameter>, &return.falseforfailure;.
68
63
</para>
69
64
</refsect1>
70
65

66
+
<refsect1 role="changelog">
67
+
&reftitle.changelog;
68
+
<informaltable>
69
+
<tgroup cols="2">
70
+
<thead>
71
+
<row>
72
+
<entry>&Version;</entry>
73
+
<entry>&Description;</entry>
74
+
</row>
75
+
</thead>
76
+
<tbody>
77
+
<row>
78
+
<entry>8.0.0</entry>
79
+
<entry>
80
+
<parameter>displayLocale</parameter> is nullable now.
81
+
</entry>
82
+
</row>
83
+
</tbody>
84
+
</tgroup>
85
+
</informaltable>
86
+
</refsect1>
87
+

71
88
<refsect1 role="examples">
72
89
&reftitle.examples;
73
90
<example>
74
91