MFB: Upgrade to the new-reference-structure

- Split reference.xml into book.xml and setup.xml
- Moved from reference.xml to book.xml:
  - The intro text (partintro), and link to constants and the new examples page
- Moved from reference.xml to setup.xml:
  - The rest: requirements, installation, configuration, and resources
- Changed the constants section to be an <appendix>
- Changed the intro ID from <extname>.intro to intro.<extname>


git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@248210 c90b9560-bf6c-de11-be94-00142212c4b1
This commit is contained in:
Philip Olson 2007-12-14 03:17:40 +00:00
parent 6df619ad95
commit 8291e70e21
5 changed files with 255 additions and 116 deletions

View file

@ -0,0 +1,46 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision: 1.2 $ -->
<!-- Purpose: utilspec.windows -->
<!-- Membership: pecl -->
<book xml:id="book.win32ps" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>win32ps</title>
<!-- {{{ preface -->
<preface xml:id="intro.win32ps">
&reftitle.intro;
<para>
The win32ps extension is a Windows specific extension that allows PHP
retrieve statistics about process and memory utilization.
</para>
</preface>
<!-- }}} -->
&reference.win32ps.setup;
&reference.win32ps.constants;
&reference.win32ps.examples;
&reference.win32ps.reference;
</book>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View file

@ -0,0 +1,29 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision: 1.2 $ -->
<appendix xml:id="win32ps.constants" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
&reftitle.constants;
&no.constants;
</appendix>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View file

@ -0,0 +1,94 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision: 1.2 $ -->
<chapter xml:id="win32ps.examples" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
&reftitle.examples;
<section xml:id="win32ps.examples-process">
<para>
<example>
<title>Statistics about the current PHP process</title>
<programlisting role='php'>
<![CDATA[
<?php
print_r(win32_ps_stat_proc());
/*
Array
(
[pid] => 936
[exe] => D:\Daten\Source\php-5.1\Debug_TS\php.exe
[mem] => Array
(
[page_fault_count] => 2062
[peak_working_set_size] => 8396800
[working_set_size] => 8396800
[quota_peak_paged_pool_usage] => 32080
[quota_paged_pool_usage] => 31876
[quota_peak_non_paged_pool_usage] => 4240
[quota_non_paged_pool_usage] => 3888
[pagefile_usage] => 5865472
[peak_pagefile_usage] => 5865472
)
[tms] => Array
(
[created] => 0.093
[kernel] => 0.015
[user] => 0.062
)
)
*/
?>
]]>
</programlisting>
</example>
</para>
<para>
<example>
<title>Statistics about global memory utilization</title>
<programlisting role='php'>
<![CDATA[
<?php
print_r(win32_ps_stat_mem());
/*
Array
(
[load] => 37
[unit] => 1024
[total_phys] => 1048096
[avail_phys] => 649960
[total_pagefile] => 2521368
[avail_pagefile] => 2237940
[total_virtual] => 2097024
[avail_virtual] => 2057848
)
*/
?>
]]>
</programlisting>
</example>
</para>
</section>
</chapter>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View file

@ -1,124 +1,11 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.4 $ -->
<!-- Purpose: utilspec.windows -->
<!-- Membership: pecl -->
<!-- $Revision: 1.5 $ -->
<reference xml:id="ref.win32ps" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>win32ps Functions</title>
<titleabbrev>win32ps</titleabbrev>
<title>win32ps &Functions;</title>
<partintro>
<section xml:id="win32ps.intro">
&reftitle.intro;
<para>
The win32ps extension is a Windows specific extension that allows PHP
retrieve statistics about process and memory utilization.
</para>
</section>
<section xml:id="win32ps.requirements">
&reftitle.required;
<para>
Windows NT, Windows 2000, Windows XP or Windows Server 2003.
Any version of Windows derived from Windows NT should be compatible.
</para>
</section>
<section xml:id="win32ps.install">
&reftitle.install;
<procedure xml:id="win32ps.install-from-pecl">
<title>Installing from PECL</title>
<step>
<para>
You can download php_win32ps.dll from <link xlink:href="&url.pecl.win;">pecl4win.php.net</link>.
</para>
</step>
<step>
<para>
Copy the php_win32ps.dll into your <link
linkend="ini.extension-dir">extension_dir</link>.
</para>
</step>
<step>
<para>
Load the extension from your &php.ini;
<screen>
<![CDATA[
extension=php_win32ps.dll
]]>
</screen>
</para>
</step>
</procedure>
</section>
<section xml:id="win32ps.examples">
&reftitle.examples;
<para>
<example>
<title>Statistics about the current PHP process</title>
<programlisting role='php'>
<![CDATA[
<?php
print_r(win32_ps_stat_proc());
/*
Array
(
[pid] => 936
[exe] => D:\Daten\Source\php-5.1\Debug_TS\php.exe
[mem] => Array
(
[page_fault_count] => 2062
[peak_working_set_size] => 8396800
[working_set_size] => 8396800
[quota_peak_paged_pool_usage] => 32080
[quota_paged_pool_usage] => 31876
[quota_peak_non_paged_pool_usage] => 4240
[quota_non_paged_pool_usage] => 3888
[pagefile_usage] => 5865472
[peak_pagefile_usage] => 5865472
)
[tms] => Array
(
[created] => 0.093
[kernel] => 0.015
[user] => 0.062
)
)
*/
?>
]]>
</programlisting>
</example>
</para>
<para>
<example>
<title>Statistics about global memory utilization</title>
<programlisting role='php'>
<![CDATA[
<?php
print_r(win32_ps_stat_mem());
/*
Array
(
[load] => 37
[unit] => 1024
[total_phys] => 1048096
[avail_phys] => 649960
[total_pagefile] => 2521368
[avail_pagefile] => 2237940
[total_virtual] => 2097024
[avail_virtual] => 2057848
)
*/
?>
]]>
</programlisting>
</example>
</para>
</section>
</partintro>
&reference.win32ps.entities.functions;
</reference>
<!-- Keep this comment at the end of the file

View file

@ -0,0 +1,83 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision: 1.2 $ -->
<chapter xml:id="win32ps.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
&reftitle.setup;
<!-- {{{ Requirements -->
<section xml:id="win32ps.requirements">
&reftitle.required;
<para>
Windows NT, Windows 2000, Windows XP or Windows Server 2003.
Any version of Windows derived from Windows NT should be compatible.
</para>
</section>
<!-- }}} -->
<!-- {{{ Installation -->
<section xml:id="win32ps.installation">
&reftitle.install;
<procedure xml:id="win32ps.install-from-pecl">
<title>Installing from PECL</title>
<step>
<para>
You can download php_win32ps.dll from <link xlink:href="&url.pecl.win;">pecl4win.php.net</link>.
</para>
</step>
<step>
<para>
Copy the php_win32ps.dll into your <link
linkend="ini.extension-dir">extension_dir</link>.
</para>
</step>
<step>
<para>
Load the extension from your &php.ini;
<screen>
<![CDATA[
extension=php_win32ps.dll
]]>
</screen>
</para>
</step>
</procedure>
</section>
<!-- }}} -->
<!-- {{{ Configuration -->
<section xml:id="win32ps.configuration">
&reftitle.runtime;
&no.config;
</section>
<!-- }}} -->
<!-- {{{ Resources -->
<section xml:id="win32ps.resources">
&reftitle.resources;
&no.resource;
</section>
<!-- }}} -->
</chapter>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->