Clarify where tick events are generated, and delete the "equivalent
behavior" example which calls tick_handler() manually, because that
example isn't really suitable.
Co-authored-by: Christoph M. Becker <cmbecker69@gmx.de>
Closes GH-464.
- Rather than implying that parentheses are optional, make clear
that they are never part of the syntax for these keywords.
- Don't spend so many examples on different types of string.
- Do include examples of non-string arguments.
- Add a note with additional examples of how parentheses interact.
- Don't refer to either construct as "function-like", instead use
the term "expression" consistently.
- Additional tidying to make the pages more consistent with each
other.
- Add "print" to the list of language constructs which are
documented as functions.
- Remove mention of what PHP versions below 5.4 did with short
echo tags.
- The recommended use of a call-time pass-by-reference has been
impossible since PHP 5.4, making the examples unusable.
- The re-design of references in PHP 7.0 means that the refcount
no longer reflects these.
Closes GH-466.
We do not xi:include core INI settings, since we want to keep
alphabetic sort order (well, roughly at least).
We do add xi:fallback elements to all xi:includes, just in case.
Except for pecl_http, the related extensions are obsolete. pecl_http
has its documentation removed from the manual quite a while ago (it is
hosted elsewhere now), so we remove the INI options as well (there
likely outdated, anyway).
* Aligned examples. OO and procedural examples where using different
variable names. An example of iterator was using different style and
data
* Improved descriptions. Some words were confusing and even wrong.
* Aligned notes. All notes are in the same place and follow similar grammar
* Removed manual error checking from examples
* Removed unnecessary LIMIT 50,5
* Added .similar to the example results
Co-authored-by: Anna Filina <afilina@gmail.com>
Closes GH-207
For basename(), we declare the behavior regarding invalid characters in
the path as being undefined, since that depends on the availability of
mblen, and also on the position of the invalid characters prior to PHP
8.0.0[1].
dirname() is actually not local-aware, but relies on an ASCII
compatible character encoding regarding the directory separator. On
Windows, it is however, dependent on the currently set codepage
(although a fallback is still in place to use the Windows ANSI codepage
of the operating system[2], if the string is not valid for the current
codepage).
Again, we declared failure to comply to these assumptions as resulting
in undefined behavior. Users should make sure to pass valid strings.
[1] <http://git.php.net/?p=php-src.git;a=commitdiff;h=90705d44e3da1d0aa7b8b4fd921ec597391eccb2>
[2] <5e01542526/win32/codepage.h (L95-L106)>
Should be 'flags' instead of 'options' because argument `$options` was renamed to `$flags`.
Closes GH-455
Signed-off-by: George Peter Banyard <girgias@php.net>
