[DOC-CVS] [doc-en] master: fileinfo: fix XML to get remove of useless wrapping para tags (#5112)
[email protected] (Gina Peter Banyard via GitHub)
| Newsgroups | php.doc.cvs |
|---|---|
| Message-ID | <[email protected]> |
Author: Gina Peter Banyard (Girgias)
Committer: GitHub (web-flow)
Pusher: Girgias
Date: 2026-01-15T20:42:18Z
Commit: https://github.com/php/doc-en/commit/b2bc114aa1737deb5e04d05b0df5cc286e8a63df
Raw diff: https://github.com/php/doc-en/commit/b2bc114aa1737deb5e04d05b0df5cc286e8a63df.diff
fileinfo: fix XML to get remove of useless wrapping para tags (#5112)
Changed paths:
M reference/fileinfo/functions/finfo-buffer.xml
M reference/fileinfo/functions/finfo-close.xml
M reference/fileinfo/functions/finfo-file.xml
M reference/fileinfo/functions/finfo-open.xml
M reference/fileinfo/functions/finfo-set-flags.xml
M reference/fileinfo/functions/mime-content-type.xml
Diff:
diff --git a/reference/fileinfo/functions/finfo-buffer.xml b/reference/fileinfo/functions/finfo-buffer.xml
index 45e7cdb00d73..d099e61a40c9 100644
--- a/reference/fileinfo/functions/finfo-buffer.xml
+++ b/reference/fileinfo/functions/finfo-buffer.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- Generated by xml_proto.php v2.3. Found in /scripts directory of phpdoc. -->
-<refentry xml:id="function.finfo-buffer" xmlns="http://docbook.org/ns/docbook">
+<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.finfo-buffer">
<refnamediv>
<refname>finfo_buffer</refname>
<refname>finfo::buffer</refname>
@@ -32,40 +32,38 @@
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
- <para>
- <variablelist>
- <varlistentry>
- <term><parameter>finfo</parameter></term>
- <listitem>
- &fileinfo.parameters.finfo;
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><parameter>string</parameter></term>
- <listitem>
- <para>
- Content of a file to be checked.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><parameter>flags</parameter></term>
- <listitem>
- <para>
- One or disjunction of more <link linkend="fileinfo.constants">Fileinfo
- constants</link>.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><parameter>context</parameter></term>
- <listitem>
- <para>
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </para>
+ <variablelist>
+ <varlistentry>
+ <term><parameter>finfo</parameter></term>
+ <listitem>
+ &fileinfo.parameters.finfo;
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><parameter>string</parameter></term>
+ <listitem>
+ <para>
+ Content of a file to be checked.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><parameter>flags</parameter></term>
+ <listitem>
+ <para>
+ One or disjunction of more <link linkend="fileinfo.constants">Fileinfo
+ constants</link>.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><parameter>context</parameter></term>
+ <listitem>
+ <para>
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
@@ -100,25 +98,23 @@
<refsect1 role="examples">
&reftitle.examples;
- <para>
- <example>
- <title>A <function>finfo_buffer</function> example</title>
- <programlisting role="php">
+ <example>
+ <title>A <function>finfo_buffer</function> example</title>
+ <programlisting role="php">
<![CDATA[
<?php
$finfo = new finfo(FILEINFO_MIME);
echo $finfo->buffer($_POST["script"]) . "\n";
?>
]]>
- </programlisting>
- &example.outputs.similar;
- <screen>
+ </programlisting>
+ &example.outputs.similar;
+ <screen>
<![CDATA[
application/x-sh; charset=us-ascii
]]>
- </screen>
- </example>
- </para>
+ </screen>
+ </example>
</refsect1>
<refsect1 role="seealso">
diff --git a/reference/fileinfo/functions/finfo-close.xml b/reference/fileinfo/functions/finfo-close.xml
index e70a5f75b9a1..c2fbdf766e94 100644
--- a/reference/fileinfo/functions/finfo-close.xml
+++ b/reference/fileinfo/functions/finfo-close.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- Generated by xml_proto.php v2.3. Found in /scripts directory of phpdoc. -->
-<refentry xml:id="function.finfo-close" xmlns="http://docbook.org/ns/docbook">
+<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.finfo-close">
<refnamediv>
<refname>finfo_close</refname>
<refpurpose>Close finfo instance</refpurpose>
@@ -24,16 +24,14 @@
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
- <para>
- <variablelist>
- <varlistentry>
- <term><parameter>finfo</parameter></term>
- <listitem>
- &fileinfo.parameters.finfo;
- </listitem>
- </varlistentry>
- </variablelist>
- </para>
+ <variablelist>
+ <varlistentry>
+ <term><parameter>finfo</parameter></term>
+ <listitem>
+ &fileinfo.parameters.finfo;
+ </listitem>
+ </varlistentry>
+ </variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
diff --git a/reference/fileinfo/functions/finfo-file.xml b/reference/fileinfo/functions/finfo-file.xml
index b5347e1d1157..18e5d4268d62 100644
--- a/reference/fileinfo/functions/finfo-file.xml
+++ b/reference/fileinfo/functions/finfo-file.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- Generated by xml_proto.php v2.3. Found in /scripts directory of phpdoc. -->
-<refentry xml:id="function.finfo-file" xmlns="http://docbook.org/ns/docbook">
+<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.finfo-file">
<refnamediv>
<refname>finfo_file</refname>
<refname>finfo::file</refname>
@@ -32,41 +32,39 @@
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
- <para>
- <variablelist>
- <varlistentry>
- <term><parameter>finfo</parameter></term>
- <listitem>
- &fileinfo.parameters.finfo;
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><parameter>filename</parameter></term>
- <listitem>
- <para>
- Name of a file to be checked.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><parameter>flags</parameter></term>
- <listitem>
- <para>
- One or disjunction of more <link linkend="fileinfo.constants">Fileinfo
- constants</link>.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><parameter>context</parameter></term>
- <listitem>
- <para>
- For a description of <literal>contexts</literal>, refer to <xref linkend="ref.stream"/>.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </para>
+ <variablelist>
+ <varlistentry>
+ <term><parameter>finfo</parameter></term>
+ <listitem>
+ &fileinfo.parameters.finfo;
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><parameter>filename</parameter></term>
+ <listitem>
+ <para>
+ Name of a file to be checked.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><parameter>flags</parameter></term>
+ <listitem>
+ <para>
+ One or disjunction of more <link linkend="fileinfo.constants">Fileinfo
+ constants</link>.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><parameter>context</parameter></term>
+ <listitem>
+ <para>
+ For a description of <literal>contexts</literal>, refer to <xref linkend="ref.stream"/>.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
@@ -101,10 +99,9 @@
<refsect1 role="examples">
&reftitle.examples;
- <para>
- <example>
- <title>A <function>finfo_file</function> example</title>
- <programlisting role="php">
+ <example>
+ <title>A <function>finfo_file</function> example</title>
+ <programlisting role="php">
<![CDATA[
<?php
$finfo = finfo_open(FILEINFO_MIME_TYPE); // return mime type aka mimetype extension
@@ -114,17 +111,16 @@ foreach (glob("*") as $filename) {
finfo_close($finfo);
?>
]]>
- </programlisting>
- &example.outputs.similar;
- <screen>
+ </programlisting>
+ &example.outputs.similar;
+ <screen>
<![CDATA[
text/html
image/gif
application/vnd.ms-excel
]]>
- </screen>
- </example>
- </para>
+ </screen>
+ </example>
</refsect1>
<refsect1 role="seealso">
diff --git a/reference/fileinfo/functions/finfo-open.xml b/reference/fileinfo/functions/finfo-open.xml
index b3214416adec..5d72a585f86e 100644
--- a/reference/fileinfo/functions/finfo-open.xml
+++ b/reference/fileinfo/functions/finfo-open.xml
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<refentry xml:id="function.finfo-open" xmlns="http://docbook.org/ns/docbook">
+<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.finfo-open">
<refnamediv>
<refname>finfo_open</refname>
<refname>finfo::__construct</refname>
@@ -28,35 +28,33 @@
<refsect1 role="parameters">
&reftitle.parameters;
- <para>
- <variablelist>
- <varlistentry>
- <term><parameter>flags</parameter></term>
- <listitem>
- <para>
- One or disjunction of more <link linkend="fileinfo.constants">Fileinfo
- constants</link>.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><parameter>magic_database</parameter></term>
- <listitem>
- <para>
- Name of a magic database file, usually something like
- <filename>/path/to/magic.mime</filename>. If not specified, the
- <literal>MAGIC</literal> environment variable is used. If the
- environment variable isn't set, then PHP's bundled magic database will
- be used.
- </para>
- <para>
- Passing &null; or an empty string will be equivalent to the default
- value.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </para>
+ <variablelist>
+ <varlistentry>
+ <term><parameter>flags</parameter></term>
+ <listitem>
+ <para>
+ One or disjunction of more <link linkend="fileinfo.constants">Fileinfo
+ constants</link>.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><parameter>magic_database</parameter></term>
+ <listitem>
+ <para>
+ Name of a magic database file, usually something like
+ <filename>/path/to/magic.mime</filename>. If not specified, the
+ <literal>MAGIC</literal> environment variable is used. If the
+ environment variable isn't set, then PHP's bundled magic database will
+ be used.
+ </para>
+ <para>
+ Passing &null; or an empty string will be equivalent to the default
+ value.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
</refsect1>
<refsect1 role="returnvalues">
@@ -157,11 +155,9 @@ text/plain; charset=us-ascii
<refsect1 role="seealso">
&reftitle.seealso;
- <para>
- <simplelist>
- <member><function>finfo_close</function></member>
- </simplelist>
- </para>
+ <simplelist>
+ <member><function>finfo_close</function></member>
+ </simplelist>
</refsect1>
</refentry>
diff --git a/reference/fileinfo/functions/finfo-set-flags.xml b/reference/fileinfo/functions/finfo-set-flags.xml
index 8243eb9e9c00..13424f30f729 100644
--- a/reference/fileinfo/functions/finfo-set-flags.xml
+++ b/reference/fileinfo/functions/finfo-set-flags.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- Generated by xml_proto.php v2.3. Found in /scripts directory of phpdoc. -->
-<refentry xml:id="function.finfo-set-flags" xmlns="http://docbook.org/ns/docbook">
+<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.finfo-set-flags">
<refnamediv>
<refname>finfo_set_flags</refname>
<refname>finfo::set_flags</refname>
@@ -29,25 +29,23 @@
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
- <para>
- <variablelist>
- <varlistentry>
- <term><parameter>finfo</parameter></term>
- <listitem>
- &fileinfo.parameters.finfo;
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><parameter>flags</parameter></term>
- <listitem>
- <para>
- One or disjunction of more <link linkend="fileinfo.constants">Fileinfo
- constants</link>.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </para>
+ <variablelist>
+ <varlistentry>
+ <term><parameter>finfo</parameter></term>
+ <listitem>
+ &fileinfo.parameters.finfo;
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><parameter>flags</parameter></term>
+ <listitem>
+ <para>
+ One or disjunction of more <link linkend="fileinfo.constants">Fileinfo
+ constants</link>.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
@@ -72,7 +70,7 @@
</tgroup>
</informaltable>
</refsect1>
-
+
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
diff --git a/reference/fileinfo/functions/mime-content-type.xml b/reference/fileinfo/functions/mime-content-type.xml
index d6b07cf0c628..00f8b6d8a83d 100644
--- a/reference/fileinfo/functions/mime-content-type.xml
+++ b/reference/fileinfo/functions/mime-content-type.xml
@@ -1,11 +1,11 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<refentry xml:id="function.mime-content-type" xmlns="http://docbook.org/ns/docbook">
+<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mime-content-type">
<refnamediv>
<refname>mime_content_type</refname>
<refpurpose>Detect MIME Content-type for a file</refpurpose>
</refnamediv>
-
+
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
@@ -14,30 +14,28 @@
</methodsynopsis>
<para>
Returns the MIME content type for a file as determined by using
- information from the <filename>magic.mime</filename> file.
+ information from the <filename>magic.mime</filename> file.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
- <para>
- <variablelist>
- <varlistentry>
- <term><parameter>filename</parameter></term>
- <listitem>
- <para>
- Path to the tested file.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </para>
+ <variablelist>
+ <varlistentry>
+ <term><parameter>filename</parameter></term>
+ <listitem>
+ <para>
+ Path to the tested file.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
- Returns the content type in MIME format, like
+ Returns the content type in MIME format, like
<literal>text/plain</literal> or <literal>application/octet-stream</literal>,
&return.falseforfailure;.
</para>
@@ -50,28 +48,26 @@
<refsect1 role="examples">
&reftitle.examples;
- <para>
- <example>
- <title><function>mime_content_type</function> Example</title>
- <programlisting role="php">
+ <example>
+ <title><function>mime_content_type</function> Example</title>
+ <programlisting role="php">
<![CDATA[
<?php
echo mime_content_type('php.gif') . "\n";
echo mime_content_type('test.php');
?>
]]>
- </programlisting>
- &example.outputs;
- <screen>
+ </programlisting>
+ &example.outputs;
+ <screen>
<![CDATA[
image/gif
text/plain
]]>
- </screen>
- </example>
- </para>
+ </screen>
+ </example>
</refsect1>
-
+
<refsect1 role="seealso">
&reftitle.seealso;
<para>