appendices/about.xml
fc7fe7faecea431a37e1f809b2ba3056e4ef2e1b
...
...
@@ -18,9 +18,8 @@
18
18
</para>
19
19
</note>
20
20
<para>
21
-
The manual can be read online at the <link xlink:href="&url.php;">PHP.net website</link>,
22
-
and on the numerous mirror sites. For best performance, choose
23
-
the closest mirror. The online version of the PHP manual has currently two
21
+
The manual can be read online at the <link xlink:href="&url.php;">PHP.net website</link>.
22
+
The online version of the PHP manual has currently two
24
23
<acronym>CSS</acronym> stylesheets, web friendly and a printer-friendly stylesheet.
25
24
</para>
26
25
<para>
...
...
@@ -137,7 +136,7 @@
137
136
<![CDATA[
138
137
strlen
139
138

140
-
(PHP 4, PHP 5)
139
+
(PHP 4, PHP 5, PHP 7)
141
140
strlen -- Get string length
142
141

143
142
Description
...
...
@@ -168,10 +167,10 @@ Returns the length of given string.
168
167
</row>
169
168
<row>
170
169
<entry>
171
-
(PHP 4, PHP 5)
170
+
(PHP 4, PHP 5, PHP 7)
172
171
</entry>
173
172
<entry>
174
-
strlen() has been around in all versions of PHP 4 and PHP 5
173
+
strlen() has been around in all versions of PHP 4, 5 and 7
175
174
</entry>
176
175
</row>
177
176
<row>
...
...
@@ -190,7 +189,7 @@ Returns the length of given string.
190
189
</entry>
191
190
<entry>
192
191
Type of value this function returns, which is an
193
-
<type>integer</type> (i.e. the length of a string is measured in
192
+
<type>int</type> (i.e. the length of a string is measured in
194
193
numbers).
195
194
</entry>
196
195
</row>
...
...
@@ -215,7 +214,7 @@ Returns the length of given string.
215
214
<para>
216
215
<screen>
217
216
<![CDATA[
218
-
in_array ( mixed $needle, array $haystack [, bool $strict = FALSE ] ) : bool
217
+
in_array ( mixed $needle, array $haystack , bool $strict = false ) : bool
219
218
]]>
220
219
</screen>
221
220
</para>
...
...
@@ -234,8 +233,8 @@ Returns the length of given string.
234
233
<link linkend="language.types.array">array</link>.
235
234
<parameter>haystack</parameter> (the array we're searching in) is the
236
235
second parameter. The third <emphasis>optional</emphasis> parameter is
237
-
named <parameter>strict</parameter>. All optional parameters are seen
238
-
in <emphasis>[</emphasis> brackets <emphasis>]</emphasis>. The manual
236
+
named <parameter>strict</parameter>. All optional parameters have default
237
+
values; if the default value is unknown, it is shown as <literal>?</literal>. The manual
239
238
states that the <parameter>strict</parameter> parameter defaults to
240
239
boolean &false;. See the manual page on each function for details on
241
240
how they work.
...
...
@@ -247,8 +246,8 @@ Returns the length of given string.
247
246
<para>
248
247
<screen>
249
248
<![CDATA[
250
-
preg_match ( string $pattern , string $subject [, array &$matches
251
-
[, int $flags = 0 [, int $offset = 0 ]]] ) : int
249
+
preg_match ( string $pattern , string $subject , array &$matches = null,
250
+
int $flags = 0 , int $offset = 0 ) : int|false
252
251
]]>
253
252
</screen>
254
253
</para>
...
...
@@ -263,7 +262,7 @@ Returns the length of given string.
263
262
<para>
264
263
<screen>
265
264
<![CDATA[
266
-
(PHP 4 >= 4.3.0, PHP 5)
265
+
(PHP 4 >= 4.3.0, PHP 5, PHP 7)
267
266
]]>
268
267
</screen>
269
268
</para>
...
...
@@ -279,7 +278,7 @@ Returns the length of given string.
279
278
The manual contains information about past, current, and future versions
280
279
of PHP. Changes in behaviour are documented as notes, changelogs, and
281
280
inline text within the manual pages.
282
-
The earliest documented version is PHP 5.0.0.
281
+
The earliest documented version is PHP 7.0.0.
283
282
</para>
284
283
<para>
285
284
When documentation exists for the latest (unreleased) developmental versions
...
...
@@ -294,7 +293,7 @@ Returns the length of given string.
294
293
</para>
295
294
<para>
296
295
And to clarify, the manual will refer to major, minor and point PHP releases.
297
-
Using PHP <literal>5.3.1</literal> as an example, the <emphasis>5</emphasis>
296
+
Using PHP <literal>7.3.1</literal> as an example, the <emphasis>7</emphasis>
298
297
refers to the major version, <emphasis>3</emphasis> to minor, and
299
298
<emphasis>1</emphasis> is the point release. Typically PHP only adds new features
300
299
to major and minor releases, and fixes bugs in point releases. However, this
...
...
@@ -337,18 +336,20 @@ Returns the length of given string.
337
336
<sect1 xml:id="about.howtohelp">
338
337
<title>How to help improve the documentation</title>
339
338
<para>
340
-
There are three ways everyone can help improve this documentation.
339
+
There are several ways everyone can help improve this documentation.
341
340
</para>
342
341
<para>
343
342
If an error is found in this manual, in any language, please report them
344
-
using the bug system at <link xlink:href="&url.php.bugs;">&url.php.bugs;</link>.
345
-
Classify the bug as <literal>"Documentation Problem"</literal>. All documentation related
343
+
using the issue tracker of the respective language repository at <link xlink:href="https://github.com/php/?q=doc">https://github.com/php</link>;
344
+
for instance, errors in the English manual should be reported at
345
+
<link xlink:href="https://github.com/php/doc-en/issues">https://github.com/php/doc-en/issues</link>.
346
+
All documentation related
346
347
problems, including those about manual formats, should be submitted as bug
347
348
reports.
348
349
</para>
349
350
<note>
350
351
<para>
351
-
Please don't abuse the bug system by submitting requests for help.
352
+
Please don't abuse the issue trackers by submitting requests for help.
352
353
Instead, use one of the many
353
354
<link xlink:href="&url.php.support;">support options</link>.
354
355
</para>
...
...
@@ -360,6 +361,10 @@ Returns the length of given string.
360
361
linkend="about.notes">'About user notes'</link>.
361
362
</para>
362
363
<para>
364
+
It is also possible to submit pull requests to the
365
+
<link xlink:href="&url.php.git.mirror;doc-en">Github mirror of the documentation repository</link>.
366
+
</para>
367
+
<para>
363
368
The PHP manual is translated into many languages. Knowing English and a
364
369
foreign language allows for another way to help improve the PHP manual by
365
370
working with a translation team. For information about starting a new
...
...
@@ -396,9 +401,8 @@ Returns the length of given string.
396
401
<para>
397
402
The PHP manual is generated in various languages and formats, see
398
403
<link xlink:href="&url.php.docs;">&url.php.docs;</link> for additional details.
399
-
The <acronym>XML</acronym> source code may be downloaded from SVN and
400
-
viewed at <link xlink:href="&url.php.svn;">&url.php.svn;</link>. The
401
-
documentation is stored in the <literal>phpdoc</literal> module.
404
+
The <acronym>XML</acronym> source code may be downloaded from git and
405
+
viewed at <link xlink:href="&url.php.git.mirror;doc-en">&url.php.git.mirror;doc-en</link>.
402
406
</para>
403
407
</sect1>
404
408

...
...
@@ -415,7 +419,7 @@ Returns the length of given string.
415
419
</para>
416
420
<para>
417
421
People involved in the translations start from the <acronym>XML</acronym>
418
-
source code available from <link xlink:href="&url.php.svn;">&url.php.svn;</link>
422
+
source code available from <link xlink:href="&url.php.git.mirror;doc-en">&url.php.git.mirror;doc-en</link>
419
423
and from it they translate to their mother language. They do
420
424
<emphasis>not use</emphasis> the generated versions (like
421
425
<acronym>HTML</acronym> or plain text) as it's the build system that takes
422
426