php/archived-doc-en
1
0
Fork 0
mirror of https://github.com/php/doc-en.git synced 2026-03-23 23:32:18 +01:00
Code Issues Packages Projects Releases Wiki Activity

Display language constructs without parentheses

Browse Source 
Side effect of this change is that include, require and return are now properly linked. They weren't because they don't live inside <refentry> so PhD doesn't know about them.

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@324522 c90b9560-bf6c-de11-be94-00142212c4b1
This commit is contained in:
Jakub Vrana
2012-03-25 08:39:30 +00:00
parent 2168f6f379
commit a9b26c34e4
68 changed files with 186 additions and 186 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
appendices/aliases.xml
View File

@@ -123,7 +123,7 @@
</row>
<row>
<entry>die</entry>
<entry><function>exit</function></entry>
<entry><link linkend="function.exit"><literal>exit</literal></link></entry>
<entry><link linkend="ref.misc">Miscellaneous functions</link></entry>
</row>
<row>

8
appendices/ini.core.xml
View File

@@ -1011,7 +1011,7 @@
<para>
Specifies the name of a file that is automatically parsed
before the main file. The file is included as if it was
called with the <function>require</function> function, so
called with the <link linkend="function.require"><literal>require</literal></link> function, so
<link linkend="ini.include-path">include_path</link> is used.</para>
<para>
The special value <literal>none</literal>
@@ -1029,14 +1029,14 @@
<para>
Specifies the name of a file that is automatically parsed
after the main file. The file is included as if it was
called with the <function>require</function> function, so
called with the <link linkend="function.require"><literal>require</literal></link> function, so
<link linkend="ini.include-path">include_path</link> is used.</para>
<para>
The special value <literal>none</literal>
disables auto-appending.
<note>
<simpara>
If the script is terminated with <function>exit</function>,
If the script is terminated with <link linkend="function.exit"><literal>exit</literal></link>,
auto-append will <emphasis>not</emphasis> occur.</simpara>
</note>
</para>
@@ -1246,7 +1246,7 @@
<listitem>
<para>
Specifies a list of directories where the
<function>require</function>, <function>include</function>,
<link linkend="function.require"><literal>require</literal></link>, <link linkend="function.include"><literal>include</literal></link>,
<function>fopen</function>, <function>file</function>,
<function>readfile</function> and <function>file_get_contents</function>
functions look for files. The format is like the system's

6
appendices/migration5.xml
View File

@@ -137,17 +137,17 @@
<listitem>
<simpara>
If there are functions defined in the included file, they can be used in the
main file independent if they are before <function>return</function> or after.
main file independent if they are before <link linkend="function.return"><literal>return</literal></link> or after.
If the file is included twice, PHP 5 issues fatal error because functions
were already declared, while PHP 4 doesn't complain about it.
It is recommended to use <function>include_once</function> instead of
It is recommended to use <link linkend="function.include-once"><literal>include_once</literal></link> instead of
checking if the file was already included and conditionally return inside
the included file.
</simpara>
</listitem>
<listitem>
<simpara>
<function>include_once</function> and <function>require_once</function>
<link linkend="function.include-once"><literal>include_once</literal></link> and <link linkend="function.require-once"><literal>require_once</literal></link>
first normalize the path of included file on Windows so that including
A.php and a.php include the file just once.
</simpara>

2
appendices/migration53.xml
View File

@@ -149,7 +149,7 @@
<function>func_get_arg</function>, <function>func_get_args</function> and
<function>func_num_args</function> can no longer be called from the
outermost scope of a file that has been included by calling
<function>include</function> or <function>require</function> from within
<link linkend="function.include"><literal>include</literal></link> or <link linkend="function.require"><literal>require</literal></link> from within
a function in the calling file.
</simpara>
</listitem>

18
appendices/reserved.xml
View File

@@ -241,16 +241,16 @@
<tbody>
<row>
<entry>
<function>die</function>
<link linkend="function.die"><literal>die</literal></link>
</entry>
<entry>
<function>echo</function>
<link linkend="function.echo"><literal>echo</literal></link>
</entry>
<entry>
<function>empty</function>
</entry>
<entry>
<function>exit</function>
<link linkend="function.exit"><literal>exit</literal></link>
</entry>
<entry>
<function>eval</function>
@@ -258,10 +258,10 @@
</row>
<row>
<entry>
<function>include</function>
<link linkend="function.include"><literal>include</literal></link>
</entry>
<entry>
<function>include_once</function>
<link linkend="function.include-once"><literal>include_once</literal></link>
</entry>
<entry>
<function>isset</function>
@@ -270,18 +270,18 @@
<function>list</function>
</entry>
<entry>
<function>require</function>
<link linkend="function.require"><literal>require</literal></link>
</entry>
</row>
<row>
<entry>
<function>require_once</function>
<link linkend="function.require-once"><literal>require_once</literal></link>
</entry>
<entry>
<function>return</function>
<link linkend="function.return"><literal>return</literal></link>
</entry>
<entry>
<function>print</function>
<link linkend="function.print"><literal>print</literal></link>
</entry>
<entry>
<function>unset</function>

14
appendices/tokens.xml
View File

@@ -239,7 +239,7 @@
<row>
<entry><constant>T_ECHO</constant></entry>
<entry>echo</entry>
<entry><function>echo</function></entry>
<entry><link linkend="function.echo"><literal>echo</literal></link></entry>
</row>
<row>
<entry><constant>T_ELSE</constant></entry>
@@ -312,7 +312,7 @@
<row>
<entry><constant>T_EXIT</constant></entry>
<entry>exit or die</entry>
<entry><function>exit</function>, <function>die</function></entry>
<entry><link linkend="function.exit"><literal>exit</literal></link>, <link linkend="function.die"><literal>die</literal></link></entry>
</row>
<row>
<entry><constant>T_EXTENDS</constant></entry>
@@ -388,12 +388,12 @@
<row>
<entry><constant>T_INCLUDE</constant></entry>
<entry>include()</entry>
<entry><function>include</function></entry>
<entry><link linkend="function.include"><literal>include</literal></link></entry>
</row>
<row>
<entry><constant>T_INCLUDE_ONCE</constant></entry>
<entry>include_once()</entry>
<entry><function>include_once</function></entry>
<entry><link linkend="function.include-once"><literal>include_once</literal></link></entry>
</row>
<row>
<entry><constant>T_INLINE_HTML</constant></entry>
@@ -598,7 +598,7 @@
<row>
<entry><constant>T_PRINT</constant></entry>
<entry>print()</entry>
<entry><function>print</function></entry>
<entry><link linkend="function.print"><literal>print</literal></link></entry>
</row>
<row>
<entry><constant>T_PRIVATE</constant></entry>
@@ -627,12 +627,12 @@
<row>
<entry><constant>T_REQUIRE</constant></entry>
<entry>require()</entry>
<entry><function>require</function></entry>
<entry><link linkend="function.require"><literal>require</literal></link></entry>
</row>
<row>
<entry><constant>T_REQUIRE_ONCE</constant></entry>
<entry>require_once()</entry>
<entry><function>require_once</function></entry>
<entry><link linkend="function.require-once"><literal>require_once</literal></link></entry>
</row>
<row>
<entry><constant>T_RETURN</constant></entry>

2
chapters/tutorial.xml
View File

@@ -108,7 +108,7 @@
<para>
This program is extremely simple and you really did not need to use
PHP to create a page like this. All it does is display:
<literal>Hello World</literal> using the PHP <function>echo</function>
<literal>Hello World</literal> using the PHP <link linkend="function.echo"><literal>echo</literal></link>
statement. Note that the file <emphasis>does not need to be executable</emphasis>
or special in any way. The server finds out that this file needs to be interpreted
by PHP because you used the ".php" extension, which the server is configured

4
faq/using.xml
View File

@@ -212,8 +212,8 @@ echo "myfunc($variable) = " . myfunc($variable);
<para>
To be able to use the results of your function in an expression (such
as concatenating it with other strings in the example above), you need
to <function>return</function> the value,
not <function>echo</function> it.
to <link linkend="function.return"><literal>return</literal></link> the value,
not <link linkend="function.echo"><literal>echo</literal></link> it.
</para>
</answer>
</qandaentry>

2
features/commandline.xml
View File

@@ -148,7 +148,7 @@
<entry>&true;</entry>
<entry>
In a shell environment, it is usually desirable for output, such as
from <function>print</function>, <function>echo</function> and
from <link linkend="function.print"><literal>print</literal></link>, <link linkend="function.echo"><literal>echo</literal></link> and
friends, to be displayed immediately, and not held in a buffer.
Nonetheless, it is still possible to use
<link linkend="ref.outcontrol">output buffering</link> to

10
features/remote-files.xml
View File

@@ -8,9 +8,9 @@
&php.ini;, you can use <acronym>HTTP</acronym> and <acronym>FTP</acronym>
URLs with most of the functions
that take a filename as a parameter. In addition, URLs can be
used with the <function>include</function>,
<function>include_once</function>, <function>require</function> and
<function>require_once</function> statements (since PHP 5.2.0,
used with the <link linkend="function.include"><literal>include</literal></link>,
<link linkend="function.include-once"><literal>include_once</literal></link>, <link linkend="function.require"><literal>require</literal></link> and
<link linkend="function.require-once"><literal>require_once</literal></link> statements (since PHP 5.2.0,
<option>allow_url_include</option> must be enabled for these).
See <xref linkend="wrappers"/> for more information about the protocols
supported by PHP.
@@ -27,8 +27,8 @@
<para>
The Windows versions of PHP earlier than PHP 4.3
did not support remote file accessing for the following functions:
<function>include</function>, <function>include_once</function>,
<function>require</function>, <function>require_once</function>,
<link linkend="function.include"><literal>include</literal></link>, <link linkend="function.include-once"><literal>include_once</literal></link>,
<link linkend="function.require"><literal>require</literal></link>, <link linkend="function.require-once"><literal>require_once</literal></link>,
and the imagecreatefromXXX functions in the <xref linkend="ref.image"/>
extension.
</para>

2
internals2/ze1/zendapi/printing.xml
View File

@@ -4,7 +4,7 @@
<title>Printing Information</title>
<para>
Often it's necessary to print messages to the output stream from
your module, just as <function>print</function> would be used
your module, just as <link linkend="function.print"><literal>print</literal></link> would be used
within a script. PHP offers functions for most generic tasks, such
as printing warning messages, generating output for
<function>phpinfo</function>, and so on. The following sections

6
language/basic-syntax.xml
View File

@@ -87,7 +87,7 @@ echo "Last statement";
<para>
For outputting large blocks of text, dropping out of PHP parsing mode is
generally more efficient than sending all of the text through
<function>echo</function> or <function>print</function>.
<link linkend="function.echo"><literal>echo</literal></link> or <link linkend="function.print"><literal>print</literal></link>.
</para>
<para>
There are four different pairs of opening and closing tags
@@ -193,8 +193,8 @@ echo "Last statement";
<note>
<para>
The closing tag of a PHP block at the end of a file is optional,
and in some cases omitting it is helpful when using <function>include</function>
or <function>require</function>, so unwanted whitespace will
and in some cases omitting it is helpful when using <link linkend="function.include"><literal>include</literal></link>
or <link linkend="function.require"><literal>require</literal></link>, so unwanted whitespace will
not occur at the end of files, and you will still be able to add
headers to the response later. It is also handy if you use output
buffering, and would not like to see added unwanted whitespace

2
language/control-structures/continue.xml
View File

@@ -96,7 +96,7 @@ for ($i = 0; $i < 5; ++$i) {
</screen>
<para>
because the entire <literal>continue print "$i\n";</literal> is evaluated
as a single expression, and so <function>print</function> is called only
as a single expression, and so <link linkend="function.print"><literal>print</literal></link> is called only
when <literal>$i == 2</literal> is true. (The return value of
<literal>print</literal> is passed to <literal>continue</literal> as the
numeric argument.)

12
language/control-structures/include-once.xml
View File

@@ -2,24 +2,24 @@
<!-- $Revision$ -->
<sect1 xml:id="function.include-once" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title><function>include_once</function></title>
<title>include_once</title>
<?phpdoc print-version-for="include_once"?>
<para>
The <function>include_once</function> statement includes and evaluates
The <literal>include_once</literal> statement includes and evaluates
the specified file during the execution of the script.
This is a behavior similar to the <function>include</function> statement,
This is a behavior similar to the <link linkend="function.include"><literal>include</literal></link> statement,
with the only difference being that if the code from a file has already
been included, it will not be included again. As the name suggests,
it will be included just once.
</para>
<para>
<function>include_once</function> may be used in cases where
<literal>include_once</literal> may be used in cases where
the same file might be included and evaluated more than once during a
particular execution of a script, so in this case it may help avoid
problems such as function redefinitions, variable value reassignments, etc.
</para>
<para>
See the <function>include</function> documentation for information about
See the <link linkend="function.include"><literal>include</literal></link> documentation for information about
how this function works.
</para>
<para>
@@ -28,7 +28,7 @@
With PHP 4, <literal>_once</literal> functionality differs with case-insensitive
operating systems (like Windows) so for example:
<example>
<title><function>include_once</function> with a case insensitive OS in PHP 4</title>
<title><literal>include_once</literal> with a case insensitive OS in PHP 4</title>
<programlisting role="php">
<![CDATA[
<?php

36
language/control-structures/include.xml
View File

@@ -2,25 +2,25 @@
<!-- $Revision$ -->
<sect1 xml:id="function.include" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title><function>include</function></title>
<title>include</title>
<?phpdoc print-version-for="include"?>
<simpara>
The <function>include</function> statement includes and evaluates
The <literal>include</literal> statement includes and evaluates
the specified file.
</simpara>
<simpara>
The documentation below also applies to <function>require</function>.
The documentation below also applies to <link linkend="function.require"><literal>require</literal></link>.
</simpara>
<simpara>
Files are included based on the file path given or, if none is given, the
<link linkend="ini.include-path">include_path</link> specified. If the file
isn't found in the <link linkend="ini.include-path">include_path</link>,
<function>include</function> will finally check in the calling script's own
<literal>include</literal> will finally check in the calling script's own
directory and the current working directory before failing. The
<function>include</function> construct will emit a
<literal>include</literal> construct will emit a
<link linkend="errorfunc.constants.errorlevels.e-warning">warning</link> if
it cannot find a file; this is different behavior from
<function>require</function>, which will emit a
<link linkend="function.require"><literal>require</literal></link>, which will emit a
<link linkend="errorfunc.constants.errorlevels.e-error">fatal error</link>.
</simpara>
<simpara>
@@ -47,7 +47,7 @@
</simpara>
<para>
<example>
<title>Basic <function>include</function> example</title>
<title>Basic <literal>include</literal> example</title>
<programlisting role="php">
<![CDATA[
vars.php
@@ -134,7 +134,7 @@ echo "A $color $fruit"; // A green
&warn.no-win32-fopen-wrapper;
<para>
<example>
<title><function>include</function> through HTTP</title>
<title><literal>include</literal> through HTTP</title>
<programlisting role="php">
<![CDATA[
<?php
@@ -181,7 +181,7 @@ include 'file.php'; // Works.
information.
</para>
<simpara>
Handling Returns: It is possible to execute a <function>return</function>
Handling Returns: It is possible to execute a <link linkend="function.return"><literal>return</literal></link>
statement inside an included file in order to terminate processing in that
file and return to the script which called it. Also, it's possible to return
values from included files. You can take the value of the include call as
@@ -193,7 +193,7 @@ include 'file.php'; // Works.
the file was included.
</simpara>
<para>
Because <function>include</function> is a special language construct,
Because <literal>include</literal> is a special language construct,
parentheses are not needed around its argument. Take care when comparing
return value.
<example>
@@ -217,7 +217,7 @@ if ((include 'vars.php') == 'OK') {
</para>
<para>
<example>
<title><function>include</function> and the <function>return</function> statement</title>
<title><literal>include</literal> and the <link linkend="function.return"><literal>return</literal></link> statement</title>
<programlisting role="php">
<![CDATA[
return.php
@@ -255,24 +255,24 @@ echo $bar; // prints 1
<simpara>
<literal>$bar</literal> is the value <literal>1</literal> because the include
was successful. Notice the difference between the above examples. The first uses
<function>return</function> within the included file while the other does not.
<link linkend="function.return"><literal>return</literal></link> within the included file while the other does not.
If the file can't be included, &false; is returned and
<constant>E_WARNING</constant> is issued.
</simpara>
<para>
If there are functions defined in the included file, they can be used in the
main file independent if they are before <function>return</function> or after.
main file independent if they are before <link linkend="function.return"><literal>return</literal></link> or after.
If the file is included twice, PHP 5 issues fatal error because functions
were already declared, while PHP 4 doesn't complain about functions
defined after <function>return</function>.
It is recommended to use <function>include_once</function> instead of
defined after <link linkend="function.return"><literal>return</literal></link>.
It is recommended to use <link linkend="function.include-once"><literal>include_once</literal></link> instead of
checking if the file was already included and conditionally return inside
the included file.
</para>
<simpara>
Another way to "include" a PHP file into a variable is to capture the
output by using the <link linkend="ref.outcontrol">Output Control
Functions</link> with <function>include</function>. For example:
Functions</link> with <literal>include</literal>. For example:
</simpara>
<para>
<example>
@@ -306,8 +306,8 @@ function get_include_contents($filename) {
&note.language-construct;
<simpara>
See also <function>require</function>, <function>require_once</function>,
<function>include_once</function>, <function>get_included_files</function>,
See also <link linkend="function.require"><literal>require</literal></link>, <link linkend="function.require-once"><literal>require_once</literal></link>,
<link linkend="function.include-once"><literal>include_once</literal></link>, <function>get_included_files</function>,
<function>readfile</function>, <function>virtual</function>, and
<link linkend="ini.include-path">include_path</link>.
</simpara>

8
language/control-structures/require-once.xml
View File

@@ -2,15 +2,15 @@
<!-- $Revision$ -->
<sect1 xml:id="function.require-once" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title><function>require_once</function></title>
<title>require_once</title>
<?phpdoc print-version-for="require_once"?>
<para>
The <function>require_once</function> statement is identical to
<function>require</function> except PHP will check if the file has
The <literal>require_once</literal> statement is identical to
<link linkend="function.require"><literal>require</literal></link> except PHP will check if the file has
already been included, and if so, not include (require) it again.
</para>
<para>
See the <function>include_once</function> documentation for information
See the <link linkend="function.include-once"><literal>include_once</literal></link> documentation for information
about the <literal>_once</literal> behaviour, and how it differs from
its non <literal>_once</literal> siblings.
</para>

8
language/control-structures/require.xml
View File

@@ -2,18 +2,18 @@
<!-- $Revision$ -->
<sect1 xml:id="function.require" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title><function>require</function></title>
<title>require</title>
<?phpdoc print-version-for="require"?>
<para>
<function>require</function> is identical to <function>include</function>
<literal>require</literal> is identical to <link linkend="function.include"><literal>include</literal></link>
except upon failure it will also produce a fatal <constant>E_COMPILE_ERROR</constant>
level error. In other words, it will halt the script whereas
<function>include</function> only emits a warning
<link linkend="function.include"><literal>include</literal></link> only emits a warning
(<constant>E_WARNING</constant>) which allows the script to continue.
</para>
<para>
See the <function>include</function> documentation for how this works.
See the <link linkend="function.include"><literal>include</literal></link> documentation for how this works.
</para>
</sect1>

18
language/control-structures/return.xml
View File

@@ -5,21 +5,21 @@
<title>return</title>
<?phpdoc print-version-for="return"?>
<simpara>
If called from within a function, the <function>return</function>
If called from within a function, the <literal>return</literal>
statement immediately ends execution of the current function, and
returns its argument as the value of the function
call. <function>return</function> will also end the execution of
call. <literal>return</literal> will also end the execution of
an <function>eval</function> statement or script file.
</simpara>
<simpara>
If called from the global scope, then execution of the current
script file is ended. If the current script file was
<function>include</function>ed or <function>require</function>ed,
<link linkend="function.include"><literal>include</literal></link>d or <link linkend="function.require"><literal>require</literal></link>d,
then control is passed back to the calling file. Furthermore, if
the current script file was <function>include</function>ed, then
the value given to <function>return</function> will be returned as
the value of the <function>include</function> call. If
<function>return</function> is called from within the main script
the current script file was <link linkend="function.include"><literal>include</literal></link>d, then
the value given to <literal>return</literal> will be returned as
the value of the <link linkend="function.include"><literal>include</literal></link> call. If
<literal>return</literal> is called from within the main script
file, then script execution ends. If the current script file was
named by the <link
linkend="ini.auto-prepend-file">auto_prepend_file</link> or <link
@@ -33,7 +33,7 @@
<para>
<note>
<simpara>
Note that since <function>return</function> is a language
Note that since <literal>return</literal> is a language
construct and not a function, the parentheses surrounding its
arguments are not required. It is common to leave them out, and you
actually should do so as PHP has less work to do in this case.
@@ -43,7 +43,7 @@
<simpara>
If no parameter is supplied, then the parentheses must be omitted
and &null; will be
returned. Calling <function>return</function> with parentheses but
returned. Calling <literal>return</literal> with parentheses but
with no arguments will result in a parse error.
</simpara>
</note>

12
language/functions.xml
View File

@@ -385,18 +385,18 @@ Making a bowl of acidophilus raspberry.
Values are returned by using the optional return statement. Any
type may be returned, including arrays and objects. This causes the
function to end its execution immediately and pass control back to
the line from which it was called. See <function>return</function>
the line from which it was called. See <link linkend="function.return"><literal>return</literal></link>
for more information.
</para>
<note>
<para>
If the <function>return</function> is omitted the value &null; will be
If the <link linkend="function.return"><literal>return</literal></link> is omitted the value &null; will be
returned.
</para>
</note>
<para>
<example>
<title>Use of <function>return</function></title>
<title>Use of <link linkend="function.return"><literal>return</literal></link></title>
<programlisting role="php">
<![CDATA[
<?php
@@ -471,10 +471,10 @@ $newref =& returns_reference();
</para>
<para>
Variable functions won't work with language constructs such
as <function>echo</function>, <function>print</function>,
as <link linkend="function.echo"><literal>echo</literal></link>, <link linkend="function.print"><literal>print</literal></link>,
<function>unset</function>, <function>isset</function>,
<function>empty</function>, <function>include</function>,
<function>require</function> and the like. Utilize wrapper functions to make
<function>empty</function>, <link linkend="function.include"><literal>include</literal></link>,
<link linkend="function.require"><literal>require</literal></link> and the like. Utilize wrapper functions to make
use of any of these constructs as variable functions.
</para>
<para>

2
language/oop5/changelog.xml
View File

@@ -105,7 +105,7 @@
<entry>
Changed: The <link linkend="object.tostring">__toString()</link>
method was only called when it was directly combined with
<function>echo</function> or <function>print</function>.
<link linkend="function.echo"><literal>echo</literal></link> or <link linkend="function.print"><literal>print</literal></link>.
But now, it is called in any string context (e.g. in
<function>printf</function> with <literal>%s</literal> modifier) but not
in other types contexts (e.g. with <literal>%d</literal> modifier).

2
language/oop5/decon.xml
View File

@@ -126,7 +126,7 @@ $obj = new MyDestructableClass();
</para>
<para>
The destructor will be called even if script execution is stopped using
<function>exit</function>. Calling <function>exit</function> in a destructor
<link linkend="function.exit"><literal>exit</literal></link>. Calling <link linkend="function.exit"><literal>exit</literal></link> in a destructor
will prevent the remaining shutdown routines from executing.
</para>
<note>

2
language/oop5/magic.xml
View File

@@ -172,7 +172,7 @@ Hello
<para>
It is worth noting that before PHP 5.2.0 the <link linkend="object.tostring">__toString()</link>
method was only called when it was directly combined with
<function>echo</function> or <function>print</function>.
<link linkend="function.echo"><literal>echo</literal></link> or <link linkend="function.print"><literal>print</literal></link>.
Since PHP 5.2.0, it is called in any string context (e.g. in
<function>printf</function> with <literal>%s</literal> modifier) but not
in other types contexts (e.g. with <literal>%d</literal> modifier).

2
language/operators.xml
View File

@@ -1451,7 +1451,7 @@ $value = @$cache[$key];
<link linkend="language.expressions">expressions</link>. A simple rule
of thumb is: if you can take the value of something, you can prepend
the @ operator to it. For instance, you can prepend it to variables,
function and <function>include</function> calls, constants, and
function and <link linkend="function.include"><literal>include</literal></link> calls, constants, and
so forth. You cannot prepend it to function or class definitions,
or conditional structures such as <literal>if</literal> and
&foreach;, and so forth.

6
language/types/callable.xml
View File

@@ -22,10 +22,10 @@
<para>
A PHP function is passed by its name as a <type>string</type>. Any built-in
or user-defined function can be used, except language constructs such as:
<function>array</function>, <function>echo</function>,
<function>array</function>, <link linkend="function.echo"><literal>echo</literal></link>,
<function>empty</function>, <function>eval</function>,
<function>exit</function>, <function>isset</function>,
<function>list</function>, <function>print</function> or
<link linkend="function.exit"><literal>exit</literal></link>, <function>isset</function>,
<function>list</function>, <link linkend="function.print"><literal>print</literal></link> or
<function>unset</function>.
</para>

6
language/types/string.xml
View File

@@ -843,7 +843,7 @@ $str[strlen($str)-1] = 'e';
<literal>(string)</literal> cast or the <function>strval</function> function.
<type>String</type> conversion is automatically done in the scope of an
expression where a <type>string</type> is needed. This happens when using the
<function>echo</function> or <function>print</function> functions, or when a
<link linkend="function.echo"><literal>echo</literal></link> or <link linkend="function.print"><literal>print</literal></link> functions, or when a
variable is compared to a <type>string</type>. The sections on
<link linkend="language.types">Types</link> and
<link linkend="language.types.type-juggling">Type Juggling</link> will make
@@ -873,8 +873,8 @@ $str[strlen($str)-1] = 'e';
<para>
<type>Array</type>s are always converted to the <type>string</type>
<literal>"Array"</literal>; because of this, <function>echo</function> and
<function>print</function> can not by themselves show the contents of an
<literal>"Array"</literal>; because of this, <link linkend="function.echo"><literal>echo</literal></link> and
<link linkend="function.print"><literal>print</literal></link> can not by themselves show the contents of an
<type>array</type>. To view a single element, use a construction such as
<literal>echo $arr['foo']</literal>. See below for tips on viewing the entire
contents.

2
language/variables.xml
View File

@@ -122,7 +122,7 @@ $bar = &test(); // Invalid.
<para>
It is not necessary to initialize variables in PHP however it is a very
good practice. Uninitialized variables have a default value of their type depending on the context in which they are used
- booleans default to &false;, integers and floats default to zero, strings (e.g. used in <function>echo</function>) are
- booleans default to &false;, integers and floats default to zero, strings (e.g. used in <link linkend="function.echo"><literal>echo</literal></link>) are
set as an empty string and arrays become to an empty array.
</para>
<para>

2
language/wrappers/php.xml
View File

@@ -69,7 +69,7 @@
<para>
<filename>php://output</filename> is a write-only stream that allows you to
write to the output buffer mechanism in the same way as
<function>print</function> and <function>echo</function>.
<link linkend="function.print"><literal>print</literal></link> and <link linkend="function.echo"><literal>echo</literal></link>.
</para>
</refsect2>

2
reference/apache/functions/apache-child-terminate.xml
View File

@@ -68,7 +68,7 @@
&reftitle.seealso;
<para>
<simplelist>
<member><function>exit</function></member>
<member><link linkend="function.exit"><literal>exit</literal></link></member>
</simplelist>
</para>
</refsect1>

4
reference/apache/functions/virtual.xml
View File

@@ -75,8 +75,8 @@
<entry>4.0.6</entry>
<entry>
This function may be used on PHP files. However, it is typically
better to use <function>include</function> or
<function>require</function> for PHP files.
better to use <link linkend="function.include"><literal>include</literal></link> or
<link linkend="function.require"><literal>require</literal></link> for PHP files.
</entry>
</row>
</tbody>

2
reference/apc/ini.xml
View File

@@ -618,7 +618,7 @@
</term>
<listitem>
<para>
Optimize <function>include_once</function> and <function>require_once</function>
Optimize <link linkend="function.include-once"><literal>include_once</literal></link> and <link linkend="function.require-once"><literal>require_once</literal></link>
calls and avoid the expensive system calls used.
</para>
<warning>

2
reference/com/variant.xml
View File

@@ -117,7 +117,7 @@ print "The value is " . $v . "<br/>";
returned as an instance of the VARIANT class. You can force PHP to
convert or evaluate the variant as a PHP native type by using a casting
operator explicitly, or implicitly casting to a string by
<function>print</function>ing it. You may use the wide range of variant
<link linkend="function.print"><literal>print</literal></link>ing it. You may use the wide range of variant
functions to perform arithmetic operations on variants without forcing a
conversion or risking a loss of data.
</para>

2
reference/errorfunc/functions/set-error-handler.xml
View File

@@ -38,7 +38,7 @@
operator</link>.
</para>
<para>
Also note that it is your responsibility to <function>die</function> if
Also note that it is your responsibility to <link linkend="function.die"><literal>die</literal></link> if
necessary. If the error-handler function returns, script execution
will continue with the next statement after the one that caused an error.
</para>

2
reference/filesystem/functions/file.xml
View File

@@ -235,7 +235,7 @@ $trimmed = file('somefile.txt', FILE_IGNORE_NEW_LINES | FILE_SKIP_EMPTY_LINES);
<member><function>fsockopen</function></member>
<member><function>popen</function></member>
<member><function>file_get_contents</function></member>
<member><function>include</function></member>
<member><link linkend="function.include"><literal>include</literal></link></member>
<member><function>stream_context_create</function></member>
</simplelist>
</para>

4
reference/filesystem/functions/readfile.xml
View File

@@ -114,8 +114,8 @@ if (file_exists($file)) {
<member><function>fpassthru</function></member>
<member><function>file</function></member>
<member><function>fopen</function></member>
<member><function>include</function></member>
<member><function>require</function></member>
<member><link linkend="function.include"><literal>include</literal></link></member>
<member><link linkend="function.require"><literal>require</literal></link></member>
<member><function>virtual</function></member>
<member><function>file_get_contents</function></member>
<member><xref linkend="wrappers"/></member>

10
reference/filesystem/ini.xml
View File

@@ -91,9 +91,9 @@
<warning>
<para>
On Windows versions prior to PHP 4.3.0, the following functions do not
support remote file accessing: <function>include</function>,
<function>include_once</function>, <function>require</function>,
<function>require_once</function> and the imagecreatefromXXX
support remote file accessing: <link linkend="function.include"><literal>include</literal></link>,
<link linkend="function.include-once"><literal>include_once</literal></link>, <link linkend="function.require"><literal>require</literal></link>,
<link linkend="function.require-once"><literal>require_once</literal></link> and the imagecreatefromXXX
functions in the <xref linkend="ref.image"/> extension.
</para>
</warning>
@@ -108,8 +108,8 @@
<listitem>
<para>
This option allows the use of URL-aware fopen wrappers with the following
functions: <function>include</function>, <function>include_once</function>,
<function>require</function>, <function>require_once</function>.
functions: <link linkend="function.include"><literal>include</literal></link>, <link linkend="function.include-once"><literal>include_once</literal></link>,
<link linkend="function.require"><literal>require</literal></link>, <link linkend="function.require-once"><literal>require_once</literal></link>.
</para>
<note>
<para>

4
reference/funchand/functions/func-get-arg.xml
View File

@@ -68,8 +68,8 @@
<entry>5.3.0</entry>
<entry>
If this function is called from the outermost scope of a file
which has been included by calling <function>include</function>
or <function>require</function> from within a function in the
which has been included by calling <link linkend="function.include"><literal>include</literal></link>
or <link linkend="function.require"><literal>require</literal></link> from within a function in the
calling file, it now generates a warning and returns &false;.
</entry>
</row>

4
reference/funchand/functions/func-get-args.xml
View File

@@ -52,8 +52,8 @@
<entry>5.3.0</entry>
<entry>
If this function is called from the outermost scope of a file
which has been included by calling <function>include</function>
or <function>require</function> from within a function in the
which has been included by calling <link linkend="function.include"><literal>include</literal></link>
or <link linkend="function.require"><literal>require</literal></link> from within a function in the
calling file, it now generates a warning and returns &false;.
</entry>
</row>

4
reference/funchand/functions/func-num-args.xml
View File

@@ -52,8 +52,8 @@
<entry>5.3.0</entry>
<entry>
If this function is called from the outermost scope of a file
which has been included by calling <function>include</function>
or <function>require</function> from within a function in the
which has been included by calling <link linkend="function.include"><literal>include</literal></link>
or <link linkend="function.require"><literal>require</literal></link> from within a function in the
calling file, it now generates a warning and returns -1.
</entry>
</row>

2
reference/funchand/functions/function-exists.xml
View File

@@ -43,7 +43,7 @@
<note>
<para>
This function will return &false; for constructs, such as
<function>include_once</function> and <function>echo</function>.
<link linkend="function.include-once"><literal>include_once</literal></link> and <link linkend="function.echo"><literal>echo</literal></link>.
</para>
</note>
</refsect1>

10
reference/funchand/functions/register-shutdown-function.xml
View File

@@ -16,12 +16,12 @@
</methodsynopsis>
<para>
Registers a <parameter>callback</parameter> to be executed after script
execution finishes or <function>exit</function> is called.
execution finishes or <link linkend="function.exit"><literal>exit</literal></link> is called.
</para>
<para>
Multiple calls to <function>register_shutdown_function</function> can be
made, and each will be called in the same order as they were registered.
If you call <function>exit</function> within one registered shutdown
If you call <link linkend="function.exit"><literal>exit</literal></link> within one registered shutdown
function, processing will stop completely and no other registered
shutdown functions will be called.
</para>
@@ -97,8 +97,8 @@
In earlier versions under Apache, the registered shutdown functions
were called after the request has been completed (including sending
any output buffers), so it was not possible to send output to the
browser using <function>echo</function> or
<function>print</function>, or retrieve the contents of any output
browser using <link linkend="function.echo"><literal>echo</literal></link> or
<link linkend="function.print"><literal>print</literal></link>, or retrieve the contents of any output
buffers using <function>ob_get_contents</function>.
Headers were also always already sent.
</entry>
@@ -149,7 +149,7 @@ register_shutdown_function('shutdown');
<para>
<simplelist>
<member><link linkend="ini.auto-append-file">auto_append_file</link></member>
<member><function>exit</function></member>
<member><link linkend="function.exit"><literal>exit</literal></link></member>
<member>The section on <link
linkend="features.connection-handling">connection handling</link></member>
</simplelist>

4
reference/inclued/book.xml
View File

@@ -13,8 +13,8 @@
</para>
<para>
The files may have been included using
<function>include</function>, <function>include_once</function>,
<function>require</function>, or <function>require_once</function>.
<link linkend="function.include"><literal>include</literal></link>, <link linkend="function.include-once"><literal>include_once</literal></link>,
<link linkend="function.require"><literal>require</literal></link>, or <link linkend="function.require-once"><literal>require_once</literal></link>.
</para>
<para>
Class inheritance dependencies are also reported.

2
reference/inclued/functions/inclued-get-data.xml
View File

@@ -79,7 +79,7 @@ Array
<simplelist>
<member><link linkend="inclued.examples-implementation">inclued examples</link></member>
<member><function>debug_backtrace</function></member>
<member><function>include</function></member>
<member><link linkend="function.include"><literal>include</literal></link></member>
</simplelist>
</para>
</refsect1>

2
reference/info/functions/get-include-path.xml
View File

@@ -52,7 +52,7 @@ echo ini_get('include_path');
<member><function>ini_get</function></member>
<member><function>restore_include_path</function></member>
<member><function>set_include_path</function></member>
<member><function>include</function></member>
<member><link linkend="function.include"><literal>include</literal></link></member>
</simplelist>
</para>
</refsect1>

18
reference/info/functions/get-included-files.xml
View File

@@ -14,8 +14,8 @@
</methodsynopsis>
<para>
Gets the names of all files that have been included using
<function>include</function>, <function>include_once</function>,
<function>require</function> or <function>require_once</function>.
<link linkend="function.include"><literal>include</literal></link>, <link linkend="function.include-once"><literal>include_once</literal></link>,
<link linkend="function.require"><literal>require</literal></link> or <link linkend="function.require-once"><literal>require_once</literal></link>.
</para>
</refsect1>
@@ -27,7 +27,7 @@
<para>
The script originally called is considered an "included file," so it will
be listed together with the files referenced by
<function>include</function> and family.
<link linkend="function.include"><literal>include</literal></link> and family.
</para>
<para>
Files that are included or required multiple times only show up once in
@@ -54,8 +54,8 @@
required files ended in the extension <literal>.php</literal>; other
extensions would not be returned. The array returned by
<function>get_included_files</function> was an associative array and
only listed files included by <function>include</function> and
<function>include_once</function>.
only listed files included by <link linkend="function.include"><literal>include</literal></link> and
<link linkend="function.include-once"><literal>include_once</literal></link>.
</entry>
</row>
</tbody>
@@ -116,10 +116,10 @@ test4.php
&reftitle.seealso;
<para>
<simplelist>
<member><function>include</function></member>
<member><function>include_once</function></member>
<member><function>require</function></member>
<member><function>require_once</function></member>
<member><link linkend="function.include"><literal>include</literal></link></member>
<member><link linkend="function.include-once"><literal>include_once</literal></link></member>
<member><link linkend="function.require"><literal>require</literal></link></member>
<member><link linkend="function.require-once"><literal>require_once</literal></link></member>
<member><function>get_required_files</function></member>
</simplelist>
</para>

8
reference/info/functions/main.xml
View File

@@ -37,19 +37,19 @@
</thead>
<tbody>
<row>
<entry><function>include</function></entry>
<entry><link linkend="function.include"><literal>include</literal></link></entry>
<entry>5.1.0</entry>
</row>
<row>
<entry><function>include_once</function></entry>
<entry><link linkend="function.include-once"><literal>include_once</literal></link></entry>
<entry>5.1.0</entry>
</row>
<row>
<entry><function>require</function></entry>
<entry><link linkend="function.require"><literal>require</literal></link></entry>
<entry>5.1.0</entry>
</row>
<row>
<entry><function>require_once</function></entry>
<entry><link linkend="function.require-once"><literal>require_once</literal></link></entry>
<entry>5.1.0</entry>
</row>
</tbody>

2
reference/info/functions/restore-include-path.xml
View File

@@ -63,7 +63,7 @@ echo get_include_path(); // .:/usr/local/lib/php
<member><function>ini_restore</function></member>
<member><function>get_include_path</function></member>
<member><function>set_include_path</function></member>
<member><function>include</function></member>
<member><link linkend="function.include"><literal>include</literal></link></member>
</simplelist>
</para>
</refsect1>

2
reference/info/functions/set-include-path.xml
View File

@@ -91,7 +91,7 @@ set_include_path(get_include_path() . PATH_SEPARATOR . $path);
<member><function>ini_set</function></member>
<member><function>get_include_path</function></member>
<member><function>restore_include_path</function></member>
<member><function>include</function></member>
<member><link linkend="function.include"><literal>include</literal></link></member>
</simplelist>
</para>
</refsect1>

4
reference/misc/functions/die.xml
View File

@@ -3,13 +3,13 @@
<refentry xml:id="function.die" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>die</refname>
<refpurpose>Equivalent to <function>exit</function></refpurpose>
<refpurpose>Equivalent to <literal>exit</literal></refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<para>
This language construct is equivalent to <function>exit</function>.
This language construct is equivalent to <link linkend="function.exit"><literal>exit</literal></link>.
</para>
</refsect1>

10
reference/misc/functions/exit.xml
View File

@@ -20,10 +20,10 @@
Terminates execution of the script.
<link linkend="function.register-shutdown-function">Shutdown functions</link>
and <link linkend="language.oop5.decon.destructor">object destructors</link>
will always be executed even if <function>exit</function> is called.
will always be executed even if <literal>exit</literal> is called.
</para>
<para>
<function>exit</function> is a language construct and it can be called
<literal>exit</literal> is a language construct and it can be called
without parentheses if no <parameter>status</parameter> is passed.
</para>
</refsect1>
@@ -69,7 +69,7 @@
&reftitle.examples;
<para>
<example>
<title><function>exit</function> example</title>
<title><literal>exit</literal> example</title>
<programlisting role="php">
<![CDATA[
<?php
@@ -85,7 +85,7 @@ $file = fopen($filename, 'r')
</para>
<para>
<example>
<title><function>exit</function> status example</title>
<title><literal>exit</literal> status example</title>
<programlisting role="php">
<![CDATA[
<?php
@@ -149,7 +149,7 @@ echo 'This will not be output.';
<note>
<para>
This language construct is equivalent to <function>die</function>.
This language construct is equivalent to <link linkend="function.die"><literal>die</literal></link>.
</para>
</note>
</refsect1>

4
reference/misc/functions/php-check-syntax.xml
View File

@@ -96,7 +96,7 @@
<row>
<entry>5.0.3</entry>
<entry>
Calling <function>exit</function> after
Calling <link linkend="function.exit"><literal>exit</literal></link> after
<function>php_check_syntax</function> resulted in a Segfault.
</entry>
</row>
@@ -135,7 +135,7 @@ PHP Parse error: unexpected T_STRING in /tmp/somefile.php on line 81
&reftitle.seealso;
<para>
<simplelist>
<member><function>include</function></member>
<member><link linkend="function.include"><literal>include</literal></link></member>
<member><function>is_readable</function></member>
</simplelist>
</para>

2
reference/network/functions/header.xml
View File

@@ -23,7 +23,7 @@
Remember that <function>header</function> must be called before any
actual output is sent, either by normal HTML tags, blank lines in a
file, or from PHP. It is a very common error to read code with
<function>include</function>, or <function>require</function>,
<link linkend="function.include"><literal>include</literal></link>, or <link linkend="function.require"><literal>require</literal></link>,
functions, or another file access function, and have spaces or empty
lines that are output before <function>header</function> is called.
The same problem exists when using a single PHP/HTML file.

4
reference/nsapi/functions/nsapi-virtual.xml
View File

@@ -25,8 +25,8 @@
</para>
<para>
You cannot make recursive requests with this function to other PHP scripts.
If you want to include PHP scripts, use <function>include</function> or
<function>require</function>.
If you want to include PHP scripts, use <link linkend="function.include"><literal>include</literal></link> or
<link linkend="function.require"><literal>require</literal></link>.
</para>
<note>
<para>

2
reference/outcontrol/book.xml
View File

@@ -15,7 +15,7 @@
after your script has began outputting data. The Output Control
functions do not affect headers sent using
<function>header</function> or <function>setcookie</function>,
only functions such as <function>echo</function> and data between
only functions such as <link linkend="function.echo"><literal>echo</literal></link> and data between
blocks of PHP code.
</para>
<note>

2
reference/outcontrol/examples.xml
View File

@@ -24,7 +24,7 @@ ob_end_flush();
</example>
</para>
<para>
In the above example, the output from <function>echo</function>
In the above example, the output from <link linkend="function.echo"><literal>echo</literal></link>
would be stored in the output buffer until
<function>ob_end_flush</function> was called. In the mean time,
the call to <function>setcookie</function> successfully stored a

2
reference/outcontrol/ini.xml
View File

@@ -101,7 +101,7 @@
output layer to flush itself automatically after every output block.
This is equivalent to calling the PHP function
<function>flush</function> after each and every call to
<function>print</function> or <function>echo</function> and each and
<link linkend="function.print"><literal>print</literal></link> or <link linkend="function.echo"><literal>echo</literal></link> and each and
every <literal>HTML</literal> block.
</para>
<para>

2
reference/parsekit/functions/parsekit-compile-file.xml
View File

@@ -24,7 +24,7 @@
<listitem>
<para>
A string containing the name of the file to compile.
Similar to the argument to <function>include</function>.
Similar to the argument to <link linkend="function.include"><literal>include</literal></link>.
</para>
</listitem>
</varlistentry>

2
reference/pdo/pdo/exec.xml
View File

@@ -60,7 +60,7 @@
<para>
The following example incorrectly relies on the return value of
<function>PDO::exec</function>, wherein a statement that affected 0 rows
results in a call to <function>die</function>:
results in a call to <link linkend="function.die"><literal>die</literal></link>:
<programlisting role="php">
<![CDATA[
<?php

2
reference/phar/Phar/setAlias.xml
View File

@@ -20,7 +20,7 @@
ensure that use of the <literal>phar</literal> stream wrapper to access internal
files always works regardless of the location of the phar archive on the
filesystem. Another alternative is to rely upon Phar's interception of
<function>include</function> or to use <function>Phar::interceptFileFuncs</function>
<link linkend="function.include"><literal>include</literal></link> or to use <function>Phar::interceptFileFuncs</function>
and use relative paths.
</para>
</refsect1>

2
reference/phar/book.xml
View File

@@ -30,7 +30,7 @@
<para>
Phar implements this functionality through a <link linkend="book.stream">Stream
Wrapper</link>. Normally, to use an external file within a PHP script, you
would use <function>include</function>
would use <link linkend="function.include"><literal>include</literal></link>
</para>
<para>
<example>

2
reference/runkit/functions/runkit-import.xml
View File

@@ -16,7 +16,7 @@
<methodparam choice="opt"><type>int</type><parameter>flags</parameter><initializer>RUNKIT_IMPORT_CLASS_METHODS</initializer></methodparam>
</methodsynopsis>
<para>
Similar to <function>include</function> however any code residing outside
Similar to <link linkend="function.include"><literal>include</literal></link> however any code residing outside
of a function or class is simply ignored.
Additionally, depending on the value of <parameter>flags</parameter>,
any functions or classes which already exist in the currently running environment

4
reference/runkit/functions/runkit-sandbox-output-handler.xml
View File

@@ -15,8 +15,8 @@
<methodparam choice="opt"><type>mixed</type><parameter>callback</parameter></methodparam>
</methodsynopsis>
<para>
Ordinarily, anything output (such as with <function>echo</function>
or <function>print</function>) will be output as though it were printed
Ordinarily, anything output (such as with <link linkend="function.echo"><literal>echo</literal></link>
or <link linkend="function.print"><literal>print</literal></link>) will be output as though it were printed
from the parent's scope. Using <function>runkit_sandbox_output_handler</function>
however, output generated by the sandbox (including errors), can be captured
by a function outside of the sandbox.

8
reference/runkit/sandbox-parent.xml
View File

@@ -143,13 +143,13 @@ string(6) "Global"
Enabling <literal>parent_call</literal> will allow the sandbox
to call all functions available to the parent scope. Language
constructs are each controlled by their own setting:
<function>print</function> and <function>echo</function> are
<link linkend="function.print"><literal>print</literal></link> and <link linkend="function.echo"><literal>echo</literal></link> are
enabled with <literal>parent_echo</literal>.
<function>die</function> and <function>exit</function> are
<link linkend="function.die"><literal>die</literal></link> and <link linkend="function.exit"><literal>exit</literal></link> are
enabled with <literal>parent_die</literal>.
<function>eval</function> is enabled with <literal>parent_eval</literal>
while <function>include</function>, <function>include_once</function>,
<function>require</function>, and <function>require_once</function>
while <link linkend="function.include"><literal>include</literal></link>, <link linkend="function.include-once"><literal>include_once</literal></link>,
<link linkend="function.require"><literal>require</literal></link>, and <link linkend="function.require-once"><literal>require_once</literal></link>
are enabled through <literal>parent_include</literal>.
</para>

8
reference/runkit/sandbox.xml
View File

@@ -205,10 +205,10 @@ bool(false)
Any function defined within the sandbox may be called as
a method on the sandbox object. This also includes a few
pseudo-function language constructs: <function>eval</function>,
<function>include</function>, <function>include_once</function>,
<function>require</function>, <function>require_once</function>,
<function>echo</function>, <function>print</function>,
<function>die</function>, and <function>exit</function>.
<link linkend="function.include"><literal>include</literal></link>, <link linkend="function.include-once"><literal>include_once</literal></link>,
<link linkend="function.require"><literal>require</literal></link>, <link linkend="function.require-once"><literal>require_once</literal></link>,
<link linkend="function.echo"><literal>echo</literal></link>, <link linkend="function.print"><literal>print</literal></link>,
<link linkend="function.die"><literal>die</literal></link>, and <link linkend="function.exit"><literal>exit</literal></link>.
</para>
<example>

4
reference/sam/setup.xml
View File

@@ -52,8 +52,8 @@
<para>
If you only intend to use the built-in MQTT support then you can build and
configure SAM as an extension or simply refer to
<filename>php_sam.php</filename> with a <function>require</function> or
<function>require_once</function> clause in your PHP script. In this case
<filename>php_sam.php</filename> with a <link linkend="function.require"><literal>require</literal></link> or
<link linkend="function.require-once"><literal>require_once</literal></link> clause in your PHP script. In this case
you need only install the code without building the extension using the pear
installer:
<screen>

2
reference/stream/functions/stream-resolve-include-path.xml
View File

@@ -16,7 +16,7 @@
<!-- <methodparam choice="opt"><type>resource</type><parameter>context</parameter></methodparam> -->
</methodsynopsis>
<para>
Resolve <parameter>filename</parameter> against the include path according to the same rules as <function>fopen</function>/<function>include</function>.
Resolve <parameter>filename</parameter> against the include path according to the same rules as <function>fopen</function>/<link linkend="function.include"><literal>include</literal></link>.
</para>
</refsect1>

12
reference/strings/functions/echo.xml
View File

@@ -17,16 +17,16 @@
Outputs all parameters.
</simpara>
<para>
<function>echo</function> is not actually a function (it is a
<literal>echo</literal> is not actually a function (it is a
language construct), so you are not required to use parentheses
with it. <function>echo</function> (unlike some other language
with it. <literal>echo</literal> (unlike some other language
constructs) does not behave like a function, so it cannot
always be used in the context of a function. Additionally, if you want to
pass more than one parameter to <function>echo</function>, the parameters
pass more than one parameter to <literal>echo</literal>, the parameters
must not be enclosed within parentheses.
</para>
<para>
<function>echo</function> also has a shortcut syntax, where you can
<literal>echo</literal> also has a shortcut syntax, where you can
immediately follow the opening tag with an equals sign. This short syntax
only works with the <link
linkend="ini.short-open-tag">short_open_tag</link> configuration setting
@@ -75,7 +75,7 @@ I have <?=$foo?> foo.
&reftitle.examples;
<para>
<example>
<title><function>echo</function> examples</title>
<title><literal>echo</literal> examples</title>
<programlisting role="php">
<![CDATA[
<?php
@@ -142,7 +142,7 @@ echo $some_var ? 'true': 'false'; // changing the statement around
&reftitle.seealso;
<para>
<simplelist>
<member><function>print</function></member>
<member><link linkend="function.print"><literal>print</literal></link></member>
<member><function>printf</function></member>
<member><function>flush</function></member>
<member><link linkend="language.types.string.syntax.heredoc">Heredoc syntax</link></member>

6
reference/strings/functions/print.xml
View File

@@ -16,7 +16,7 @@
Outputs <parameter>arg</parameter>.
</para>
<para>
<function>print</function> is not actually a real function (it is a
<literal>print</literal> is not actually a real function (it is a
language construct) so you are not required to use parentheses
with its argument list.
</para>
@@ -49,7 +49,7 @@
&reftitle.examples;
<para>
<example>
<title><function>print</function> examples</title>
<title><literal>print</literal> examples</title>
<programlisting role="php">
<![CDATA[
<?php
@@ -104,7 +104,7 @@ END;
&reftitle.seealso;
<para>
<simplelist>
<member><function>echo</function></member>
<member><link linkend="function.echo"><literal>echo</literal></link></member>
<member><function>printf</function></member>
<member><function>flush</function></member>
<member><link linkend="language.types.string.syntax.heredoc">Heredoc syntax</link></member>

2
reference/strings/functions/printf.xml
View File

@@ -61,7 +61,7 @@
&reftitle.seealso;
<para>
<simplelist>
<member><function>print</function></member>
<member><link linkend="function.print"><literal>print</literal></link></member>
<member><function>sprintf</function></member>
<member><function>vprintf</function></member>
<member><function>sscanf</function></member>