com doc/tr: update for sync with English doc.: language-snippets.ent
[email protected] (Nilgün Belma Bugüner) Wed, 06 Jan 2021 02:37:40 +0000
| Newsgroups | php.doc.tr |
|---|---|
| Message-ID | <[email protected]> |
Commit: d0cdee77d704e2482c431e75b339c5cb2b0e24e6 Author: Nilgün Belma Bugüner <[email protected]> Wed, 6 Jan 2021 05:37:40 +0300 Parents: f9d6f2e41758e55123882fb6ae93767b285b0c77 Branches: master Link: http://git.php.net/?p=doc/tr.git;a=commitdiff;h=d0cdee77d704e2482c431e75b339c5cb2b0e24e6 Log: update for sync with English doc. Changed paths: M language-snippets.ent
diff_d0cdee77d704e2482c431e75b339c5cb2b0e24e6.txt
(text/plain, 48.1 KB)
diff --git a/language-snippets.ent b/language-snippets.ent
index dc4735cf..4739bbe9 100644
--- a/language-snippets.ent
+++ b/language-snippets.ent
@@ -1,14 +1,25 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: ca35bb0ee60fdbf44956427c44c4eee7b1ea0fdb Maintainer: nilgun Status: wip -->
+<!-- EN-Revision: e2f50c240bebc502a3d990d73633a6141f3bd9fd Maintainer: nilgun Status: wip -->
<!-- CREDITS: cumhuronat, tpug, antimon, flarecaster -->
+<!ENTITY installation.enabled.disable 'This extension is enabled by default.
+It may be disabled by using the following option at compile time: '>
+
+<!-- Not used in EN anymore -->
<!ENTITY changelog.randomseed '<row xmlns="http://docbook.org/ns/docbook">
<entry>4.2.0</entry><entry>Rasgele sayı üreteci özdevinimli
tohumlanır.</entry></row>'>
-<!ENTITY installation.enabled.disable 'Bu eklenti öntanımlı olarak etkindir.
-Derleme sırasında şu seçenekleri kullanarak bunu iptal edebilirsiniz: '>
+<!ENTITY warn.deprecated.feature-5-3-0.removed-6-0-0 '<warning
+xmlns="http://docbook.org/ns/docbook"><simpara>This feature has been
+<emphasis>DEPRECATED</emphasis> as of PHP 5.3.0. Relying on this feature is
+highly discouraged.</simpara></warning>'>
+
+<!ENTITY warn.deprecated.function-5-3-0.removed-6-0-0 '<warning
+xmlns="http://docbook.org/ns/docbook"><simpara>This function has been
+<emphasis>DEPRECATED</emphasis> as of PHP 5.3.0. Relying on this feature is
+highly discouraged.</simpara></warning>'>
<!-- Cautions -->
@@ -26,6 +37,11 @@ deneyebilirsiniz.</para></caution>'>
<simpara>Bu işlev ikil dosyalarla çalışırken
dosya içeriğini değiştirmez.</simpara></note>'>
+<!ENTITY note.locale-single-byte '<note xmlns="http://docbook.org/ns/docbook"><simpara>This function is locale-aware
+and will handle input according to the currently set locale. However, it only works on single-byte character sets.
+If you need to use multibyte characters (most non-western-European languages) look at the
+<link linkend="book.mbstring">multibyte</link> or <link linkend="book.intl">intl</link> extensions instead.</simpara></note>'>
+
<!ENTITY note.clearstatcache '<note xmlns="http://docbook.org/ns/docbook">
<simpara>Bu işlevin sonuçları önbelleğe kaydedilir. Daha ayrıntılı bilgi
edinmek için <function>clearstatcache</function> işlevine
@@ -94,6 +110,9 @@ düzenlemek yerine evvelce atanmış anahtarları silecektir.</simpara></note>'>
<!ENTITY note.no-windows.extension '<note xmlns="http://docbook.org/ns/docbook">
<simpara>Bu eklenti Windows sistemlerinde çalışmaz.</simpara></note>'>
+<!ENTITY note.no-zts '<note xmlns="http://docbook.org/ns/docbook"><simpara>This function is not
+available in PHP interpreters built with ZTS (Zend Thread Safety) enabled. To check whether your copy of PHP was built with ZTS enabled, use <command>php -i</command> or test the built-in constant <constant>PHP_ZTS</constant>.</simpara></note>'>
+
<!ENTITY note.randomseed '<note xmlns="http://docbook.org/ns/docbook">
<simpara>Özdevinimli olarak yapıldığından <function>srand</function> veya
<function>mt_srand</function> işleviyle rasgele sayı üretecini tohumlamaya
@@ -208,18 +227,6 @@ xmlns="http://docbook.org/ns/docbook"><simpara>Bu özelliğin kullanımı PHP
5.3.0'dan beri <emphasis>ÖNERİLMEMEKTEDİR</emphasis>. Bu özelliğe
kesinlikle güvenmemelisiniz.</simpara></warning>'>
-<!ENTITY warn.deprecated.feature-5-3-0.removed-6-0-0 '<warning
-xmlns="http://docbook.org/ns/docbook"><simpara>Bu özelliğin kullanımı PHP
-5.3.0'dan beri <emphasis>ÖNERİLMEMEKTEDİR</emphasis> ve PHP
-6.0.0'da tamamen <emphasis>KALDIRILMIŞTIR</emphasis>. Bu özelliğe
-kesinlikle güvenmemelisiniz.</simpara></warning>'>
-
-<!ENTITY warn.deprecated.function-5-3-0.removed-6-0-0 '<warning
-xmlns="http://docbook.org/ns/docbook"><simpara>Bu işlevin kullanımı PHP
-5.3.0'dan beri <emphasis>ÖNERİLMEMEKTEDİR</emphasis> ve PHP
-6.0.0'da tamamen <emphasis>KALDIRILMIŞTIR</emphasis>. Bu işleve
-kesinlikle güvenmemelisiniz.</simpara></warning>'>
-
<!ENTITY warn.deprecated.function.removed-5-3-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Bu işlevin kullanımı artık
<emphasis>ÖNERİLMEMEKTEDİR</emphasis> ve PHP 5.3.0'da tamamen
@@ -275,6 +282,36 @@ xmlns="http://docbook.org/ns/docbook"><simpara>Bu işlevin kullanımı PHP 7.2.0
itibariyle <emphasis>ÖNERİLMEMEKTEDİR</emphasis>.
Bu işleve kesinlikle güvenmemelisiniz.</simpara></warning>'>
+<!ENTITY warn.deprecated.function-7-2-0.removed-8-0-0 '<warning
+xmlns="http://docbook.org/ns/docbook"><simpara>This function has been
+<emphasis>DEPRECATED</emphasis> as of PHP 7.2.0, and <emphasis>REMOVED</emphasis> as of PHP 8.0.0. Relying on this function
+is highly discouraged.</simpara></warning>'>
+
+<!ENTITY warn.deprecated.feature-7-3-0 '<warning
+xmlns="http://docbook.org/ns/docbook"><simpara>This feature has been
+<emphasis>DEPRECATED</emphasis> as of PHP 7.3.0. Relying on this feature
+is highly discouraged.</simpara></warning>'>
+
+<!ENTITY warn.deprecated.function-7-3-0 '<warning
+xmlns="http://docbook.org/ns/docbook"><simpara>This function has been
+<emphasis>DEPRECATED</emphasis> as of PHP 7.3.0. Relying on this function
+is highly discouraged.</simpara></warning>'>
+
+<!ENTITY warn.deprecated.feature-7-4-0 '<warning
+xmlns="http://docbook.org/ns/docbook"><simpara>This feature has been
+<emphasis>DEPRECATED</emphasis> as of PHP 7.4.0. Relying on this feature
+is highly discouraged.</simpara></warning>'>
+
+<!ENTITY warn.deprecated.function-7-4-0 '<warning
+xmlns="http://docbook.org/ns/docbook"><simpara>This function has been
+<emphasis>DEPRECATED</emphasis> as of PHP 7.4.0. Relying on this function
+is highly discouraged.</simpara></warning>'>
+
+<!ENTITY warn.deprecated.function-8-0-0 '<warning
+xmlns="http://docbook.org/ns/docbook"><simpara>This function has been
+<emphasis>DEPRECATED</emphasis> as of PHP 8.0.0. Relying on this function
+is highly discouraged.</simpara></warning>'>
+
<!ENTITY removed.php.future 'Bu kullanımı önerilmeyen özellik gelecekte
<emphasis xmlns="http://docbook.org/ns/docbook">kesinlikle
KALDIRILACAKTIR</emphasis>.'>
@@ -338,6 +375,19 @@ itibariyle <emphasis>ÖNERİLMEMEKTE</emphasis> olup PHP 7.0.0'da tamamen
xmlns="http://docbook.org/ns/docbook"><simpara>Bu işlev PHP 7.0.0'da
tamamen <emphasis>KALDIRILMIŞTIR</emphasis>.</simpara></warning>'>
+<!ENTITY warn.removed.function-7-4-0 '<warning
+xmlns="http://docbook.org/ns/docbook"><simpara>This function was
+<emphasis>REMOVED</emphasis> in PHP 7.4.0.</simpara></warning>'>
+
+<!ENTITY warn.deprecated.alias-7-4-0.removed-8-0-0 '<warning xmlns="http://docbook.org/ns/docbook"><simpara>This alias was
+<emphasis>DEPRECATED</emphasis> in PHP 7.4.0, and <emphasis>REMOVED</emphasis> as of PHP 8.0.0.</simpara></warning>'>
+
+<!ENTITY warn.deprecated.alias-8-0-0 '<warning xmlns="http://docbook.org/ns/docbook"><simpara>This alias is
+<emphasis>DEPRECATED</emphasis> as of PHP 8.0.0.</simpara></warning>'>
+
+<!ENTITY warn.removed.alias-8-0-0 '<warning xmlns="http://docbook.org/ns/docbook"><simpara>This alias is
+<emphasis>REMOVED</emphasis> as of PHP 8.0.0.</simpara></warning>'>
+
<!ENTITY warn.experimental.func '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Bu işlev
<emphasis>DENEYSELDİR</emphasis>. Bu işlevin davranışı, ismi
@@ -348,7 +398,7 @@ kullanmayın.</simpara></warning>'>
<!ENTITY warn.imaprecodeyaz '<warning xmlns="http://docbook.org/ns/docbook">
<simpara><link linkend="book.imap">IMAP</link>,
<link linkend="book.recode">recode</link> ve
-<link linkend="book.yaz">YAZ</link>
+<link linkend="book.yaz">YAZ</link>
eklentileri, aynı dahili simgeleri paylaştıklarından birlikte
kullanılamazlar. Bilgi: Yaz 2.0 ve sonrası bu sorundan etkilenmemektedir.</simpara></warning>'>
@@ -499,11 +549,6 @@ mevcuttur.</simpara></warning>'>
<!ENTITY version.exists.asof 'This exists as of PHP '>
-<!ENTITY version.trunk.after.53 '<emphasis
-xmlns="http://docbook.org/ns/docbook">Bu değişiklik PHP'nin <link
-linkend="about.phpversions">geliştirilmekte olan sürümünde</link> mevcuttur.
-Muhtemelen 5.3 sürümünden sonra asıl sürümde de olacaktır.</emphasis>'>
-
<!ENTITY version.trunk.changelog 'Future'>
<!ENTITY no.function.parameters '<para
@@ -536,6 +581,15 @@ Yukarıdaki örneğin PHP 7.0 çıktısı:</para>'>
<!ENTITY example.outputs.71 '<para xmlns="http://docbook.org/ns/docbook">
Yukarıdaki örneğin PHP 7.1 çıktısı:</para>'>
+<!ENTITY example.outputs.73 '<para xmlns="http://docbook.org/ns/docbook">
+Yukarıdaki örneğin PHP 7.3 çıktısı:</para>'>
+
+<!ENTITY example.outputs.8 '<para xmlns="http://docbook.org/ns/docbook">
+Yukarıdaki örneğin PHP 8 çıktısı:</para>'>
+
+<!ENTITY example.outputs.80 '<para xmlns="http://docbook.org/ns/docbook">
+Yukarıdaki örneğin PHP 8.0 çıktısı:</para>'>
+
<!ENTITY example.outputs.32bit '<para xmlns="http://docbook.org/ns/docbook">
Yukarıdaki örneğin 32 bitlik makinelerdeki çıktısı:</para>'>
@@ -563,6 +617,53 @@ linkend="function.reset">ilk elemana konumlandırır</link>.</simpara></note>'>
<!ENTITY seealso.array.sorting '<link xmlns="http://docbook.org/ns/docbook"
linkend="array.sorting">Dizilerde Sıralama</link>'>
+<!ENTITY sort.flags.parameter '<varlistentry xmlns="http://docbook.org/ns/docbook">
+ <term><parameter>flags</parameter></term>
+ <listitem>
+ <para>
+ The optional second parameter <parameter>flags</parameter>
+ may be used to modify the sorting behavior using these values:
+ </para>
+ <para>
+ Sorting type flags:
+ <itemizedlist>
+ <listitem>
+ <simpara><constant>SORT_REGULAR</constant> - compare items normally;
+ the details are described in the <link linkend="language.operators.comparison">comparison operators</link> section</simpara>
+ </listitem>
+ <listitem>
+ <simpara><constant>SORT_NUMERIC</constant> - compare items numerically</simpara>
+ </listitem>
+ <listitem>
+ <simpara><constant>SORT_STRING</constant> - compare items as strings</simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ <constant>SORT_LOCALE_STRING</constant> - compare items as
+ strings, based on the current locale. It uses the locale,
+ which can be changed using <function>setlocale</function>
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ <constant>SORT_NATURAL</constant> - compare items as strings
+ using "natural ordering" like <function>natsort</function>
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ <constant>SORT_FLAG_CASE</constant> - can be combined
+ (bitwise OR) with
+ <constant>SORT_STRING</constant> or
+ <constant>SORT_NATURAL</constant> to sort strings case-insensitively
+ </simpara>
+ </listitem>
+ </itemizedlist>
+ </para>
+ </listitem>
+ </varlistentry>
+'>
+
<!ENTITY avail.register-long-arrays 'PHP 5.0.0'dan itibaren
<link xmlns="http://docbook.org/ns/docbook"
linkend="language.variables.predefined">öntanımlı değişken</link> dizileri
@@ -571,7 +672,7 @@ linkend="ini.register-long-arrays">register_long_arrays</link> yönergesi ile
iptal edilebilmektedir.'>
<!ENTITY ini.shorthandbytes '<simpara xmlns="http://docbook.org/ns/docbook">
-<type>integer</type> türünde bir değer kullanıldığında değer baytların
+<type>int</type> türünde bir değer kullanıldığında değer baytların
sayısıdır. Büyük bayt değerleri için kullanılabilecek birimlerin gösterimleri
hakkında bilgiyi <link linkend="faq.using.shorthandbytes">bu SSS</link>
altında bulabilirsiniz.</simpara>'>
@@ -642,9 +743,8 @@ başarısızlık durumunda &false; döndürür.'>
<!ENTITY return.void 'Hiçbir değer dönmez.'>
<!ENTITY return.callbacksort 'Karşılaştırma işlevinin, ilk bileşeninin ikinci
-bileşenden küçük, eşit veya büyük olması durumunda sıfırdan küçük, eşit veya büyük
-bir tamsayı döndürmesi gerekir. Dikkat: PHP 7.0.0 öncesinde bu tamsayı -2147483648
-ile 2147483647 arasında olmalıdır.'>
+bileşenden küçük, eşit veya büyük olması durumunda sıfırdan küçük, eşit veya
+büyük bir tamsayı döndürmesi gerekir.'>
<!ENTITY return.falseproblem '<warning xmlns="http://docbook.org/ns/docbook">
<simpara>Bu işlev mantıksal &false;
@@ -749,7 +849,7 @@ font_index</parameter></term><listitem><para>A font resource, returned by <funct
<programlisting role='php'>
<![CDATA[
<?php
-// Set the enviroment variable for GD
+// Set the environment variable for GD
putenv('GDFONTPATH=' . realpath('.'));
// Name the font to be used (note the lack of the .ttf extension)
@@ -795,9 +895,9 @@ atanmazsa doğrudan ham resim akımı çıktılanır.'>
<!ENTITY gd.image.new 'Bir dosya veya URL'den yeni bir resim oluşturur.'>
-<!ENTITY gd.image.source 'Resmin alındığı bağlantı.'>
+<!ENTITY gd.image.source 'Resmin alındığı özkaynak.'>
-<!ENTITY gd.image.destination 'Resmin gönderileceği bağlantı.'>
+<!ENTITY gd.image.destination 'Resmin gönderileceği özkaynak.'>
<!ENTITY gd.image.output 'Resmi tarayıcıya veya dosyaya yazar.'>
@@ -858,6 +958,11 @@ by çözümleme yapılmaz.'>
<entry>7.0.0</entry><entry>T1Lib support was removed from PHP, thus this function was removed.</entry>
</row>'>
+<!ENTITY gd.deprecated.gd-formats '<warning xmlns="http://docbook.org/ns/docbook"><simpara>The GD
+and GD2 image formats are proprietary image formats of libgd. They have to be regarded
+<emphasis>obsolete</emphasis>, and should only be used for development and testing
+purposes.</simpara></warning>'>
+
<!-- DBM notes -->
<!ENTITY dbm.dbm-identifier.description '<varlistentry xmlns="http://docbook.org/ns/docbook">
@@ -886,6 +991,34 @@ cURL tanıtıcısı.</para></listitem></varlistentry>'>
</term><listitem><para><function>curl_multi_init</function> işlevinden dönen
çoklu cURL tanıtıcısı.</para></listitem></varlistentry>'>
+<!ENTITY curl.sh.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>share_handle</parameter>
+</term><listitem><para>A cURL share handle returned by
+<function>curl_share_init</function>.</para></listitem></varlistentry>'>
+
+<!ENTITY curl.changelog.handle-param '<row xmlns="http://docbook.org/ns/docbook">
+ <entry>8.0.0</entry>
+ <entry>
+ <parameter>handle</parameter> expects a <classname>CurlHandle</classname>
+ instance now; previously, a <type>resource</type> was expected.
+ </entry>
+</row>'>
+
+<!ENTITY curl.changelog.multi-handle-param '<row xmlns="http://docbook.org/ns/docbook">
+ <entry>8.0.0</entry>
+ <entry>
+ <parameter>multi_handle</parameter> expects a <classname>CurlMultiHandle</classname>
+ instance now; previously, a <type>resource</type> was expected.
+ </entry>
+</row>'>
+
+<!ENTITY curl.changelog.share-handle-param '<row xmlns="http://docbook.org/ns/docbook">
+ <entry>8.0.0</entry>
+ <entry>
+ <parameter>share_handle</parameter> expects a <classname>CurlShareHandle</classname>
+ instance now; previously, a <type>resource</type> was expected.
+ </entry>
+</row>'>
+
<!-- dbase notes -->
<!ENTITY dbase.type-conversion '<para xmlns="http://docbook.org/ns/docbook">
@@ -917,6 +1050,43 @@ cURL tanıtıcısı.</para></listitem></varlistentry>'>
</itemizedlist>
</para>'>
+<!-- enchant entities -->
+
+<!ENTITY enchant.param.broker '<varlistentry xmlns="http://docbook.org/ns/docbook">
+ <term><parameter>broker</parameter></term>
+ <listitem>
+ <para>
+ An Enchant broker returned by <function>enchant_broker_init</function>.
+ </para>
+ </listitem>
+ </varlistentry>'>
+
+<!ENTITY enchant.param.dictionary '<varlistentry xmlns="http://docbook.org/ns/docbook">
+ <term><parameter>dictionary</parameter></term>
+ <listitem>
+ <para>
+ An Enchant dictionary returned by <function>enchant_broker_request_dict</function>
+ or <function>enchant_broker_request_pwl_dict</function>.
+ </para>
+ </listitem>
+ </varlistentry>'>
+
+<!ENTITY enchant.changelog.broker-param '<row xmlns="http://docbook.org/ns/docbook">
+ <entry>8.0.0</entry>
+ <entry>
+ <parameter>broker</parameter> expects an <classname>EnchantBroker</classname> instance now;
+ previoulsy, a &resource; was expected.
+ </entry>
+</row>'>
+
+<!ENTITY enchant.changelog.dictionary-param '<row xmlns="http://docbook.org/ns/docbook">
+ <entry>8.0.0</entry>
+ <entry>
+ <parameter>dictionary</parameter> expects an <classname>EnchantDictionary</classname> instance now;
+ previoulsy, a &resource; was expected.
+ </entry>
+</row>'>
+
<!-- IMAP notes -->
<!ENTITY imap.imap-stream.description '<varlistentry xmlns="http://docbook.org/ns/docbook">
@@ -945,9 +1115,9 @@ iptal edilmedikçe bu değiştirgeye güvenilir olmayan verinin aktarılması
<!-- intl notes -->
-<!ENTITY intl.codepoint.parameter '<para xmlns="http://docbook.org/ns/docbook">The <type>integer</type> codepoint value (e.g. <literal>0x2603</literal> for <emphasis>U+2603 SNOWMAN</emphasis>), or the character encoded as a UTF-8 <type>string</type> (e.g. <literal>"\u{2603}"</literal>)</para>'>
+<!ENTITY intl.codepoint.parameter '<para xmlns="http://docbook.org/ns/docbook">The <type>int</type> codepoint value (e.g. <literal>0x2603</literal> for <emphasis>U+2603 SNOWMAN</emphasis>), or the character encoded as a UTF-8 <type>string</type> (e.g. <literal>"\u{2603}"</literal>)</para>'>
-<!ENTITY intl.codepoint.return '<para xmlns="http://docbook.org/ns/docbook">The return type will be <type>integer</type> unless the code point was passed as a UTF-8 <type>string</type>, in which case a <type>string</type> will be returned.</para>'>
+<!ENTITY intl.codepoint.return '<para xmlns="http://docbook.org/ns/docbook">The return type will be <type>int</type> unless the code point was passed as a UTF-8 <type>string</type>, in which case a <type>string</type> will be returned.</para>'>
<!ENTITY intl.codepoint.example 'Testing different code points'>
@@ -955,6 +1125,23 @@ iptal edilmedikçe bu değiştirgeye güvenilir olmayan verinin aktarılması
<!ENTITY intl.property.example 'Testing different properties'>
+<!-- LDAP notes -->
+
+<!ENTITY ldap.warn.control-paged '<warning xmlns="http://docbook.org/ns/docbook">
+ <simpara>
+ This function has been <emphasis>DEPRECATED</emphasis> as of PHP 7.4.0, and <emphasis>REMOVED</emphasis> as of PHP 8.0.0.
+ Instead the <parameter>controls</parameter> parameter of <function>ldap_search</function> should be used.
+ See also <link linkend="ldap.controls">LDAP Controls</link> for details.
+ </simpara>
+</warning>'>
+
+<!ENTITY ldap.changelog.controls-nullable '<row xmlns="http://docbook.org/ns/docbook">
+ <entry>8.0.0</entry>
+ <entry>
+ <parameter>controls</parameter> is nullable now; previously, it defaulted to <literal>[]</literal>.
+ </entry>
+</row>'>
+
<!-- mbstring notes -->
<!ENTITY note.mbstring.encoding.internal '<note xmlns="http://docbook.org/ns/docbook"><para>Bu işlev karakter
@@ -968,8 +1155,8 @@ bu işlev için öntanımlı karakter kodlaması olarak kullanılır.</para></no
<!ENTITY mbstring.encoding.parameter '<para
xmlns="http://docbook.org/ns/docbook"><parameter>kodlama</parameter>
-değiştirgesinde karakter kodlaması belirtilir. Belirtilmediği takdirde
-<link linkend="ini.mbstring.internal-encoding">dahili karakter
+değiştirgesinde karakter kodlaması belirtilir. Belirtilmediği takdirde veya
+&null; ise <link linkend="ini.mbstring.internal-encoding">dahili karakter
kodlaması</link> kullanılır.</para>'>
<!ENTITY mbstring.warning.e-modifier '<warning
@@ -980,6 +1167,13 @@ kullanmayın. Özdevinimli önceleme yapılmayacaktır
almazsanız, büyük olasılıkla uygulamanızda uzaktan kod çalıştırma açıkları
oluşacaktır.</para></warning>'>
+<!ENTITY mbstring.changelog.encoding-nullable '<row xmlns="http://docbook.org/ns/docbook">
+ <entry>8.0.0</entry>
+ <entry>
+ <parameter>encoding</parameter> is nullable now.
+ </entry>
+</row>'>
+
<!-- mcrypt notes -->
<!ENTITY mcrypt.parameter.cipher '<para xmlns="http://docbook.org/ns/docbook">One of the <constant>MCRYPT_ciphername</constant> constants, or the name of the algorithm as string.</para>'>
@@ -1103,9 +1297,10 @@ xmlns="http://docbook.org/ns/docbook"><entry>5.1.0</entry><entry>
<!ENTITY date.timestamp.description '<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>zaman_damgası</parameter></term><listitem><para>
Seçimlik <parameter>zaman_damgası</parameter> değiştirgesi
-<type>integer</type> türünde bir Unix zaman damgası olup belirtilmediği
-takdirde yerel zaman kullanılır. Başka bir deyişle, <function>time</function>
-işlevinden dönen değer öntanımlıdır.</para></listitem></varlistentry>'>
+<type>int</type> türünde bir Unix zaman damgası olup belirtilmediği
+takdirde veya &null; ise yerel zaman kullanılır. Başka bir deyişle,
+<function>time</function> işlevinden dönen değer öntanımlıdır.</para>
+</listitem></varlistentry>'>
<!ENTITY date.datetime.description '<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>nesne</parameter></term><listitem><para>Sadece yordamsal
@@ -1124,10 +1319,6 @@ biçem: <function>timezone_open</function> işlevinden dönen bir
<classname>DateTimeZone</classname> nesnesi.</para></listitem>
</varlistentry>'>
-<!ENTITY date.datetime.retval.changelog '<row xmlns="http://docbook.org/ns/docbook">
-<entry>5.3.0</entry><entry>Başarı durumunda dönen değer artık &null; değil,
-<classname>DateTime</classname> oldu.</entry></row>'>
-
<!ENTITY date.datetime.return.modifiedobjectorfalseforfailure 'Değişmiş
<classname xmlns="http://docbook.org/ns/docbook">DateTime</classname>
nesnesinden &return.falseforfailure;.'>
@@ -1173,6 +1364,10 @@ bir durumu atlatabilmek için
<link linkend="function.libxml-use-internal-errors">libxml'in hata
işleme işlevleri</link> kullanılabilir.</para>'>
+<!ENTITY dom.note.utf8 '<note xmlns="http://docbook.org/ns/docbook"><para>The DOM extension uses UTF-8 encoding. Use <function>utf8_encode</function> and <function>utf8_decode</function> to work with texts in ISO-8859-1 encoding or <link linkend="ref.iconv">iconv</link> for other encodings.</para></note>'>
+
+<!ENTITY dom.note.json '<note xmlns="http://docbook.org/ns/docbook"><para>When using <function>json_encode</function> on a <classname>DOMDocument</classname> object the result will be that of encoding an empty object.</para></note>'>
+
<!-- Dom Examples -->
<!ENTITY dom.book.example '<para xmlns="http://docbook.org/ns/docbook">The following examples use <filename>book.xml</filename> which contains the following:</para>
@@ -1257,6 +1452,10 @@ durumunda bir <classname>HaruException</classname> istisnası oluşur.</para>'>
bağlantı tanıtıcısı; ayrıntılar için <function>odbc_connect</function>
işlevine bakınız.</para>'>
+<!ENTITY odbc.parameter.catalog 'The catalog ('qualifier' in ODBC 2 parlance).'>
+
+<!ENTITY odbc.parameter.schema 'The schema ('owner' in ODBC 2 parlance).'>
+
<!ENTITY odbc.parameter.search 'Arama şablonları belirtilebilir (sıfır veya
daha fazla karakterle eşleşmek üzere "%" ve tek bir karakterle eşleşmek
üzere "_".'>
@@ -1290,18 +1489,18 @@ To use the Easy Connect naming method, PHP must be linked with Oracle
<emphasis>[//]host_name[:port][/service_name]</emphasis>. With Oracle <emphasis>[//]host_name[:port][/service_name]</emphasis>. From Oracle
11g, the syntax is: 11<emphasis>g</emphasis>, the syntax is:<emphasis>[//]host_name[:port][/service_name][:server_type][/instance_name]
</emphasis>.
-Service names can be found by running the Oracle
-utility <literal>lsnrctl status</literal> on the database server
+Futher options were introduced with Oracle 19c, including timeout and keep-alive
+settings. Refer to Oracle documentation. Service names can be found by running
+the Oracle utility <literal>lsnrctl status</literal> on the database server
machine.
</para>
<para xmlns='http://docbook.org/ns/docbook'>
-The <filename>tnsnames.ora</filename> file can be in the Oracle Net
-search path, which
-includes <filename>$ORACLE_HOME/network/admin</filename>
-and <filename>/etc</filename>. Alternatively
-set <literal>TNS_ADMIN</literal> so
-that <filename>$TNS_ADMIN/tnsnames.ora</filename> is read. Make sure
-the web daemon has read access to the file.
+The <filename>tnsnames.ora</filename> file can be in the Oracle Net search path,
+which
+includes <filename>/your/path/to/instantclient/network/admin</filename>, <filename>$ORACLE_HOME/network/admin</filename>
+and <filename>/etc</filename>. Alternatively set <literal>TNS_ADMIN</literal>
+so that <filename>$TNS_ADMIN/tnsnames.ora</filename> is read. Make sure the web
+daemon has read access to the file.
</para>">
<!ENTITY oci.charset '<para xmlns="http://docbook.org/ns/docbook">Oracle
@@ -1370,10 +1569,10 @@ OCI8 or the Oracle Database, the client information can be set using the Oracle
<literal>DBMS_APPLICATION_INFO</literal> package. This is less efficient than
using <function>oci_set_client_info</function>.</para></tip>'>
-<!ENTITY oci.roundtrip.caution '<caution xmlns="http://docbook.org/ns/docbook">
-<title>Roundtrip Gotcha</title><para>Some but not all OCI8 functions cause
-roundtrips. Roundtrips to the database may not occur with queries when result
-caching is enabled. </para></caution>'>
+<!ENTITY oci.roundtrip.caution '<caution xmlns="http://docbook.org/ns/docbook"><title>Round-trip Gotcha</title>
+<para>Some but not all OCI8 functions cause round-trips. Round-trips to the
+database may not occur with queries when result caching is enabled.
+</para></caution>'>
<!ENTITY oci.use.setprefetch '<para xmlns="http://docbook.org/ns/docbook">For
queries returning a large number of rows, performance can be
@@ -1430,6 +1629,7 @@ işlevler</link> kullanılarak çağrılamaz.</simpara></note>'>
<!-- Common pieces in features/safe-mode.xml
Jade doesn't allow in-line entities, so I put them here... Though they
should have been inline in safe-mode.xml -->
+
<!-- Not used in EN anymore -->
<!ENTITY sm.uidcheck 'Üzerinde işlem yapılan dosya ve dizinlerin sahibinin
betiği çalıştıran kullanıcı ile aynı olup olmadığı sınanır.'>
@@ -1568,16 +1768,8 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&url.pecl;">PECL</link>
deposuna taşınmış olup şu sürümden itibaren PHP kaynak paketinde
dağıtılmamaktatır: PHP '>
-<!-- kept for BC -->
-<!ENTITY note.pecl-php5 '<note xmlns="http://docbook.org/ns/docbook">
-<simpara>Bu eklenti PHP 5 itibariyle kaynak
-paketinden çıkarılıp <link xmlns:xlink="http://www.w3.org/1999/xlink"
-xlink:href="&url.pecl;">PECL</link> deposuna taşınmıştır.
-</simpara></note>'>
-
<!-- Common pieces for reference part END -->
-
<!ENTITY windows.builtin '<simpara xmlns="http://docbook.org/ns/docbook">
PHP'nin Windows sürümünde bu eklenti
yerleşik olarak gelmektedir. Bu işlevleri Windows'ta kullanmak için
@@ -1636,9 +1828,8 @@ işlevi değiştirgesiz çağrılmışçasına bir bağlantı oluşturmaya çal
işlevinden dönen bir sonuç tanıtıcısı.</para></listitem></varlistentry>'>
<!-- GMP Notes -->
-<!ENTITY gmp.return 'A GMP number <type xmlns="http://docbook.org/ns/docbook">resource</type> in PHP 5.5 and earlier, or a <classname xmlns="http://docbook.org/ns/docbook">GMP</classname> object in PHP 5.6 and later.'>
-
-<!ENTITY gmp.parameter '<para xmlns="http://docbook.org/ns/docbook">Either a GMP number <type>resource</type> in PHP 5.5 and earlier, a <classname>GMP</classname> object in PHP 5.6 and later, or a numeric string provided that it is possible to convert the latter to a number.</para>'>
+<!ENTITY gmp.return 'A <classname xmlns="http://docbook.org/ns/docbook">GMP</classname> object.'>
+<!ENTITY gmp.parameter '<para xmlns="http://docbook.org/ns/docbook">A <classname>GMP</classname> object, an &integer; or a numeric &string;.</para>'>
<!-- MySQLi Notes -->
<!ENTITY mysqli.result.description '<varlistentry xmlns="http://docbook.org/ns/docbook">
@@ -1950,11 +2141,16 @@ kullanın.</simpara></note>'>
<!-- XMLWriter Notes -->
<!ENTITY xmlwriter.xmlwriter.description '<varlistentry
xmlns="http://docbook.org/ns/docbook"><term><parameter>
-xmlwriter</parameter></term><listitem><para>Sadece yordamsal kullanım için.
-<link linkend="function.xmlwriter-open-uri">xmlwriter_open_uri()</link> veya
-<link linkend="function.xmlwriter-open-memory">xmlwriter_open_memory()</link>
-çağrılarıyla elde edilen, üzerinde işlem yapılacak
-<classname>XMLWriter</classname> özkaynağı.</para></listitem></varlistentry>'>
+writer</parameter></term><listitem><para>Only for procedural calls.
+The <classname>XMLWriter</classname> instance that is being modified. This object is returned from a call to <function>xmlwriter_open_uri</function> or <function>xmlwriter_open_memory</function>.</para></listitem></varlistentry>'>
+
+<!ENTITY xmlwriter.changelog.writer-param '<row xmlns="http://docbook.org/ns/docbook">
+ <entry>8.0.0</entry>
+ <entry>
+ <parameter>writer</parameter> expects an <classname>XMLWriter</classname>
+ instance now; previously, a <type>resource</type> was expected.
+ </entry>
+</row>'>
<!-- SOAP notes -->
<!ENTITY soap.wsdl.mode.only '<note xmlns="http://docbook.org/ns/docbook">
@@ -1982,6 +2178,8 @@ constants</link> for possible values.'>
<!ENTITY fann.return.ann '<para xmlns="http://docbook.org/ns/docbook"> Returns a neural network <type>resource</type> on success, or &false; on error.</para>'>
<!ENTITY fann.return.train '<para xmlns="http://docbook.org/ns/docbook"> Returns a train data <type>resource</type> on success, or &false; on error.</para>'>
+<!ENTITY fann.note.function.fann-2.2 '<note xmlns="http://docbook.org/ns/docbook"><para>This function is only available if the fann extension has been build against libfann >= 2.2.</para></note>'>
+
<!-- Imagick generic return types -->
<!ENTITY imagick.return.success 'Başarı durumunda &true; döner.'>
@@ -2073,6 +2271,8 @@ kullanılabilir.'>
<!ENTITY imagick.constant.available 'Bu sabitini kullanılabilmesi için gerekli
ImageMagick kütüphanesinin sürüm numarası: '>
+<!ENTITY imagick.deprecated.function-3-4-4 '<warning xmlns="http://docbook.org/ns/docbook"><simpara>This function has been <emphasis>DEPRECATED</emphasis> as of Imagick 3.4.4. Relying on this function is highly discouraged.</simpara></warning>'>
+
<!-- Imagick default channel information -->
<!ENTITY imagick.default.channel.info '<constant
xmlns="http://docbook.org/ns/docbook">Imagick::CHANNEL_DEFAULT</constant>
@@ -2167,11 +2367,30 @@ sürümünde kaldırıldı. Yerine <function>PharFileInfo::isCompressed</functio
<function>PharFileInfo::decompress</function> ve
<function>PharFileInfo::compress</function> kullanılabilir.</para></note>'>
+<!ENTITY phar.note.performance '<note xmlns="http://docbook.org/ns/docbook">
+ <simpara>
+ <function>Phar::addFile</function>, <function>Phar::addFromString</function> and <function>Phar::offsetSet</function>
+ save a new phar archive each time they are called. If performance is a concern,
+ <function>Phar::buildFromDirectory</function> or <function>Phar::buildFromIterator</function>
+ should be used instead.
+ </simpara>
+</note>'>
+
+<!ENTITY phardata.note.performance '<note xmlns="http://docbook.org/ns/docbook">
+ <simpara>
+ <function>PharData::addFile</function>, <function>PharData::addFromString</function> and <function>PharData::offsetSet</function>
+ save a new phar archive each time they are called. If performance is a concern,
+ <function>PharData::buildFromDirectory</function> or <function>PharData::buildFromIterator</function>
+ should be used instead.
+ </simpara>
+</note>'>
+
<!-- XML -->
<!ENTITY libxml.required '<para xmlns="http://docbook.org/ns/docbook">Bu eklenti
PHP'nin <link linkend="book.libxml">libxml</link> eklentsini gerektirir. Bu,
libxml öntanımlı olarak etkin olduğundan bu örtük olarak sağlansa da derlemme
-sırasında ayrıca bir <option role="configure">--enable-libxml</option> gerektiği
+sırasında ayrıca bir <option role="configure">--with-libxml</option> veya
+PHP 7.4 öncesinde <option role="configure">--enable-libxml</option> gerektiği
anlamına gelir.</para>'>
<!-- XMLReader -->
@@ -2270,6 +2489,7 @@ linkend="win32service.constants.errors">Win32 Hata Kodu</link> sözkonusuysa
&false; döner.'>
<!ENTITY win32service.success.false.error 'Başarı durumunda
&true;&win32service.false.error;'>
+
<!ENTITY win32service.noerror.false.error 'Başarı durumunda <constant
xmlns="http://docbook.org/ns/docbook">WIN32_NO_ERROR</constant>&win32service.false.error;'>
@@ -2526,7 +2746,7 @@ used.</para>'>
<!ENTITY mongodb.option.collation '
<row xmlns="http://docbook.org/ns/docbook">
<entry>collation</entry>
- <entry><type>array|object</type></entry>
+ <entry><type class="union"><type>array</type><type>object</type></type></entry>
<entry>
<para>
<link xlink:href="&url.mongodb.docs.collation;" xmlns:xlink="http://www.w3.org/1999/xlink">Collation</link> allows users to specify language-specific rules for string comparison, such as rules for lettercase and accent marks. When specifying collation, the <literal>"locale"</literal> field is mandatory; all other collation fields are optional. For descriptions of the fields, see <link xlink:href="&url.mongodb.docs.collation;#collation-document" xmlns:xlink="http://www.w3.org/1999/xlink">Collation Document</link>.
@@ -2540,6 +2760,74 @@ used.</para>'>
</entry>
</row>
'>
+
+<!ENTITY mongodb.option.encryption.keyVaultClient '
+ <row xmlns="http://docbook.org/ns/docbook">
+ <entry>keyVaultClient</entry>
+ <entry><classname>MongoDB\Driver\Manager</classname></entry>
+ <entry>The Manager used to route data key queries to a separate MongoDB cluster. By default, the current Manager and c
+uster is used.</entry>
+ </row>
+'>
+<!ENTITY mongodb.option.encryption.keyVaultNamespace '
+ <row xmlns="http://docbook.org/ns/docbook">
+ <entry>keyVaultNamespace</entry>
+ <entry><type>string</type></entry>
+ <entry>A fully qualified namespace (e.g. <literal>"databaseName.collectionName"</literal>) denoting the collection tha
+ contains all data keys used for encryption and decryption.</entry>
+ </row>
+'>
+<!ENTITY mongodb.option.encryption.kmsProviders '
+ <row xmlns="http://docbook.org/ns/docbook">
+ <entry>kmsProviders</entry>
+ <entry><type>array</type></entry>
+ <entry>
+ <para>
+ A document containing the configuration for one or more KMS providers, which are used to encrypt data keys. Currentl
+ <literal>aws</literal> or <literal>local</literal>are supported and at least one must be specified.
+ </para>
+ <para>
+ The format for <literal>aws</literal> is as follows:
+ </para>
+ <programlisting role="javascript">
+<![CDATA[
+aws: {
+ accessKeyId: <string>,
+ secretAccessKey: <string>
+}
+]]>
+ </programlisting>
+ <para>
+ The format for <literal>local</literal> is as follows:
+ </para>
+ <programlisting role="javascript">
+<![CDATA[
+local: {
+ // The master key used to encrypt/decrypt data keys
+ key: <96-byte MongoDB\BSON\Binary with subtype 0>
+}
+]]>
+ </programlisting>
+ </entry>
+ </row>
+'>
+<!ENTITY mongodb.option.maxCommitTimeMS '
+ <row xmlns="http://docbook.org/ns/docbook">
+ <entry>maxCommitTimeMS</entry>
+ <entry>integer</entry>
+ <entry>
+ <para>
+ The maximum amount of time in milliseconds to allow a single
+ <literal>commitTransaction</literal> command to run.
+ </para>
+ <para>
+ If specified, <literal>maxCommitTimeMS</literal> must be a signed
+ 32-bit integer greater than or equal to zero.
+ </para>
+ </entry>
+ </row>
+'>
+
<!ENTITY mongodb.option.readConcern '
<row xmlns="http://docbook.org/ns/docbook">
<entry>readConcern</entry>
@@ -2669,7 +2957,7 @@ used.</para>'>
<!ENTITY mongodb.parameter.filter '
<varlistentry xmlns="http://docbook.org/ns/docbook">
- <term><parameter>filter</parameter> (<type>array|object</type>)</term>
+ <term><parameter>filter</parameter> (<type class="union"><type>array</type><type>object</type></type>)</term>
<listitem>
<para>
The <link xlink:href="&url.mongodb.docs;tutorial/query-documents/" xmlns:xlink="http://www.w3.org/1999/xlink">query predicate</link>.
@@ -2785,7 +3073,7 @@ used.</para>'>
<listitem>
<para>
The file descriptor, which is expected to be either a file
- <type>resource</type> or an <type>integer</type>. An <type>integer</type>
+ <type>resource</type> or an <type>int</type>. An <type>int</type>
will be assumed to be a file descriptor that can be passed directly to
the underlying system call.
</para>
@@ -2813,22 +3101,363 @@ used.</para>'>
</para>
<para xmlns="http://docbook.org/ns/docbook">
- If omitted, the default value of the <parameter>encoding</parameter> varies
- depending on the PHP version in use. In PHP 5.6 and later, the
+ If omitted, <parameter>encoding</parameter> defaults to the value of the
<link linkend="ini.default-charset">default_charset</link> configuration
- option is used as the default value. PHP 5.4 and 5.5 will use
- <literal>UTF-8</literal> as the default. Earlier versions of PHP use
- <literal>ISO-8859-1</literal>.
+ option.
</para>
<para xmlns="http://docbook.org/ns/docbook">
Although this argument is technically optional, you are highly encouraged to
- specify the correct value for your code if you are using PHP 5.5 or earlier,
- or if your <link linkend="ini.default-charset">default_charset</link>
+ specify the correct value for your code
+ if the <link linkend="ini.default-charset">default_charset</link>
configuration option may be set incorrectly for the given input.
</para>
'>
+<!ENTITY strings.parameter.format '
+<varlistentry xmlns="http://docbook.org/ns/docbook">
+ <term><parameter>format</parameter></term>
+ <listitem>
+ <para>
+ The format string is composed of zero or more directives:
+ ordinary characters (excluding <literal>%</literal>) that are
+ copied directly to the result and <emphasis>conversion
+ specifications</emphasis>, each of which results in fetching its
+ own parameter.
+ </para>
+
+ <para>
+ A conversion specification follows this prototype:
+ <literal>%[argnum$][flags][width][.precision]specifier</literal>.
+ </para>
+
+ <formalpara>
+ <title>Argnum</title>
+ <para>
+ An integer followed by a dollar sign <literal>$</literal>,
+ to specify which number argument to treat in the conversion.
+ </para>
+ </formalpara>
+
+ <para>
+ <table>
+ <title>Flags</title>
+ <tgroup cols="2">
+ <thead>
+ <row>
+ <entry>Flag</entry>
+ <entry>&Description;</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry><literal>-</literal></entry>
+ <entry>
+ Left-justify within the given field width;
+ Right justification is the default
+ </entry>
+ </row>
+ <row>
+ <entry><literal>+</literal></entry>
+ <entry>
+ Prefix positive numbers with a plus sign
+ <literal>+</literal>; Default only negative
+ are prefixed with a negative sign.
+ </entry>
+ </row>
+ <row>
+ <entry><literal> </literal>(space)</entry>
+ <entry>
+ Pads the result with spaces.
+ This is the default.
+ </entry>
+ </row>
+ <row>
+ <entry><literal>0</literal></entry>
+ <entry>
+ Only left-pads numbers with zeros.
+ With <literal>s</literal> specifiers this can
+ also right-pad with zeros.
+ </entry>
+ </row>
+ <row>
+ <entry><literal>'</literal>(char)</entry>
+ <entry>
+ Pads the result with the character (char).
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+ </para>
+
+ <formalpara>
+ <title>Width</title>
+ <para>
+ An integer that says how many characters (minimum)
+ this conversion should result in.
+ </para>
+ </formalpara>
+
+ <formalpara>
+ <title>Precision</title>
+ <para>
+ A period <literal>.</literal> followed by an integer
+ who's meaning depends on the specifier:
+ <itemizedlist>
+ <listitem>
+ <simpara>
+ For <literal>e</literal>, <literal>E</literal>,
+ <literal>f</literal> and <literal>F</literal>
+ specifiers: this is the number of digits to be printed
+ after the decimal point (by default, this is 6).
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ For <literal>g</literal> and <literal>G</literal>
+ specifiers: this is the maximum number of significant
+ digits to be printed.
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ For <literal>s</literal> specifier: it acts as a cutoff point,
+ setting a maximum character limit to the string.
+ </simpara>
+ </listitem>
+ </itemizedlist>
+ <note>
+ <simpara>
+ If the period is specified without an explicit value for precision,
+ 0 is assumed.
+ </simpara>
+ </note>
+ </para>
+ </formalpara>
+
+ <note>
+ <simpara>
+ Attempting to use a position specifier greater than
+ <constant>PHP_INT_MAX</constant> will generate warnings.
+ </simpara>
+ </note>
+
+ <para>
+ <table>
+ <title>Specifiers</title>
+ <tgroup cols="2">
+ <thead>
+ <row>
+ <entry>Specifier</entry>
+ <entry>&Description;</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry><literal>%</literal></entry>
+ <entry>
+ A literal percent character. No argument is required.
+ </entry>
+ </row>
+ <row>
+ <entry><literal>b</literal></entry>
+ <entry>
+ The argument is treated as an integer and presented
+ as a binary number.
+ </entry>
+ </row>
+ <row>
+ <entry><literal>c</literal></entry>
+ <entry>
+ The argument is treated as an integer and presented
+ as the character with that ASCII.
+ </entry>
+ </row>
+ <row>
+ <entry><literal>d</literal></entry>
+ <entry>
+ The argument is treated as an integer and presented
+ as a (signed) decimal number.
+ </entry>
+ </row>
+ <row>
+ <entry><literal>e</literal></entry>
+ <entry>
+ The argument is treated as scientific notation (e.g. 1.2e+2).
+ The precision specifier stands for the number of digits after the
+ decimal point since PHP 5.2.1. In earlier versions, it was taken as
+ number of significant digits (one less).
+ </entry>
+ </row>
+ <row>
+ <entry><literal>E</literal></entry>
+ <entry>
+ Like the <literal>e</literal> specifier but uses
+ uppercase letter (e.g. 1.2E+2).
+ </entry>
+ </row>
+ <row>
+ <entry><literal>f</literal></entry>
+ <entry>
+ The argument is treated as a float and presented
+ as a floating-point number (locale aware).
+ </entry>
+ </row>
+ <row>
+ <entry><literal>F</literal></entry>
+ <entry>
+ The argument is treated as a float and presented
+ as a floating-point number (non-locale aware).
+ Available as of PHP 5.0.3.
+ </entry>
+ </row>
+ <row>
+ <entry><literal>g</literal></entry>
+ <entry>
+ <para>
+ General format.
+ </para>
+ <para>
+ Let P equal the precision if nonzero, 6 if the precision is omitted,
+ or 1 if the precision is zero.
+ Then, if a conversion with style E would have an exponent of X:
+ </para>
+ <para>
+ If P > X ≥ −4, the conversion is with style f and precision P − (X + 1).
+ Otherwise, the conversion is with style e and precision P − 1.
+ </para>
+ </entry>
+ </row>
+ <row>
+ <entry><literal>G</literal></entry>
+ <entry>
+ Like the <literal>g</literal> specifier but uses
+ <literal>E</literal> and <literal>f</literal>.
+ </entry>
+ </row>
+ <row>
+ <entry><literal>h</literal></entry>
+ <entry>
+ Like the <literal>g</literal> specifier but uses <literal>F</literal>.
+ Available as of PHP 8.0.0.
+ </entry>
+ </row>
+ <row>
+ <entry><literal>H</literal></entry>
+ <entry>
+ Like the <literal>g</literal> specifier but uses
+ <literal>E</literal> and <literal>F</literal>. Available as of PHP 8.0.0.
+ </entry>
+ </row>
+ <row>
+ <entry><literal>o</literal></entry>
+ <entry>
+ The argument is treated as an integer and presented
+ as an octal number.
+ </entry>
+ </row>
+ <row>
+ <entry><literal>s</literal></entry>
+ <entry>
+ The argument is treated and presented as a string.
+ </entry>
+ </row>
+ <row>
+ <entry><literal>u</literal></entry>
+ <entry>
+ The argument is treated as an integer and presented
+ as an unsigned decimal number.
+ </entry>
+ </row>
+ <row>
+ <entry><literal>x</literal></entry>
+ <entry>
+ The argument is treated as an integer and presented
+ as a hexadecimal number (with lowercase letters).
+ </entry>
+ </row>
+ <row>
+ <entry><literal>X</literal></entry>
+ <entry>
+ The argument is treated as an integer and presented
+ as a hexadecimal number (with uppercase letters).
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+ </para>
+ <warning>
+ <para>
+ The <literal>c</literal> type specifier ignores padding and width
+ </para>
+ </warning>
+
+ <warning>
+ <para>
+ Attempting to use a combination of the string and width specifiers with character sets that require more than one byte per character may result in unexpected results
+ </para>
+ </warning>
+
+ <para>
+ Variables will be co-erced to a suitable type for the specifier:
+ <table>
+ <title>Type Handling</title>
+ <tgroup cols="2">
+ <thead>
+ <row>
+ <entry>Type</entry>
+ <entry>Specifiers</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry><literal>string</literal></entry>
+ <entry><literal>s</literal></entry>
+ </row>
+ <row>
+ <entry><literal>integer</literal></entry>
+ <entry>
+ <literal>d</literal>,
+ <literal>u</literal>,
+ <literal>c</literal>,
+ <literal>o</literal>,
+ <literal>x</literal>,
+ <literal>X</literal>,
+ <literal>b</literal>
+ </entry>
+ </row>
+ <row>
+ <entry><literal>double</literal></entry>
+ <entry>
+ <literal>g</literal>,
+ <literal>G</literal>,
+ <literal>e</literal>,
+ <literal>E</literal>,
+ <literal>f</literal>,
+ <literal>F</literal>
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+ </para>
+ </listitem>
+</varlistentry>
+'>
+
+<!ENTITY strings.parameter.needle.non-string '
+ <para xmlns="http://docbook.org/ns/docbook">
+ Prior to PHP 8.0.0, if <parameter>needle</parameter> is not a string, it is converted
+ to an integer and applied as the ordinal value of a character.
+ This behavior is deprecated as of PHP 7.3.0, and relying on it is highly
+ discouraged. Depending on the intended behavior, the
+ <parameter>needle</parameter> should either be explicitly cast to string,
+ or an explicit call to <function>chr</function> should be performed.
+ </para>
+'>
+
<!ENTITY strings.changelog.encoding '
<row xmlns="http://docbook.org/ns/docbook">
<entry>5.6.0</entry>
@@ -2930,6 +3559,16 @@ used.</para>'>
xmlns="http://docbook.org/ns/docbook"><simpara>This function has been
<emphasis>REMOVED</emphasis> in PECL uopz 5.0.0.</simpara></warning>'>
+<!-- XML snippets -->
+
+<!ENTITY xml.changelog.parser-param '<row xmlns="http://docbook.org/ns/docbook">
+ <entry>8.0.0</entry>
+ <entry>
+ <parameter>parser</parameter> expects an <classname>XMLParser</classname>
+ instance now; previously, a <type>resource</type> was expected.
+ </entry>
+</row>'>
+
<!-- Migration Guide snippets -->
<!ENTITY migration56.openssl.peer-verification '