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
- Moved from reference.xml to setup.xml:
  - The rest: configuration, and added requirements, installation, and resources
- Changed the intro ID from <extname>.intro to intro.<extname>


git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@248642 c90b9560-bf6c-de11-be94-00142212c4b1
This commit is contained in:
Philip Olson 2007-12-21 03:45:56 +00:00
parent 62133fc8d6
commit 89cce25642
4 changed files with 126 additions and 41 deletions

51
reference/svn/book.xml Normal file
View file

@ -0,0 +1,51 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision: 1.2 $ -->
<!-- Purpose: remote.other -->
<!-- Membership: bundled, pecl -->
<!-- State: new -->
<book xml:id="book.svn" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>Subversion</title>
<!-- {{{ preface -->
<preface xml:id="intro.svn">
&reftitle.intro;
<para>
This extension implements PHP bindings for
<link xlink:href="&url.svn;">Subversion</link> (SVN), a version
control system, allowing PHP scripts to communicate with SVN repositories
and working copies without direct command line calls to the
<filename>svn</filename>
executable.
</para>
&warn.experimental;
</preface>
<!-- }}} -->
&reference.svn.setup;
&reference.svn.constants;
&reference.svn.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

@ -1,6 +1,6 @@
<?xml version='1.0' encoding='iso-8859-1'?>
<!-- $Revision: 1.3 $ -->
<section xml:id="svn.constants" xmlns="http://docbook.org/ns/docbook">
<!-- $Revision: 1.4 $ -->
<appendix xml:id="svn.constants" xmlns="http://docbook.org/ns/docbook">
&reftitle.constants;
&extension.constants;
<variablelist>
@ -395,7 +395,7 @@
</listitem>
</varlistentry>
</variablelist>
</section>
</appendix>
<!-- Keep this comment at the end of the file
Local variables:

View file

@ -1,46 +1,11 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.3 $ -->
<!-- Purpose: remote.other -->
<!-- Membership: bundled, pecl -->
<!-- State: new -->
<!-- $Revision: 1.4 $ -->
<reference xml:id="ref.svn" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>Subversion &Functions;</title>
<titleabbrev>SVN</titleabbrev>
<partintro>
<section xml:id="svn.intro">
&reftitle.intro;
&warn.experimental;
<para>
This extension implements PHP bindings for
<link xlink:href="&url.svn;">Subversion</link> (SVN), a version
control system, allowing PHP scripts to communicate with SVN repositories
and working copies without direct command line calls to the
<filename>svn</filename>
executable.
</para>
</section>
<section xml:id="svn.requirements">
&reftitle.required;
<para>
The Subversion binaries are not necessary to use this
extension. However, when compiling the extension, libsvn
(the Subversion headers) must be available.
</para>
</section>
&reference.svn.configure;
<section xml:id="svn.resources">
&reftitle.resources;
<para>
Subversion's lower-level svn_fs_* functions make use of resources
that reference local file-system repositories. They can probably be
created using <function>svn_repos_fs</function> and
<function>svn_fs_revision_root</function>. (verify?)
</para>
&no.resource;
</section>
&reference.svn.constants;
</partintro>
&reference.svn.entities.functions;
</reference>
<!-- Keep this comment at the end of the file

69
reference/svn/setup.xml Normal file
View file

@ -0,0 +1,69 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision: 1.2 $ -->
<chapter xml:id="svn.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
&reftitle.setup;
<!-- {{{ Requirements -->
<section xml:id="svn.requirements">
&reftitle.required;
<para>
The Subversion binaries are not necessary to use this
extension. However, when compiling the extension, libsvn
(the Subversion headers) must be available.
</para>
</section>
<!-- }}} -->
<!-- {{{ Installation -->
<section xml:id="svn.installation">
&reftitle.install;
&no.install;
</section>
<!-- }}} -->
<!-- {{{ Configuration -->
<section xml:id="svn.configuration">
&reftitle.runtime;
&no.config;
</section>
<!-- }}} -->
<!-- {{{ Resources -->
<section xml:id="svn.resources">
&reftitle.resources;
<!-- FIXME: Wtf?
<para>
Subversion's lower-level svn_fs_* functions make use of resources
that reference local file-system repositories. They can probably be
created using <function>svn_repos_fs</function> and
<function>svn_fs_revision_root</function>. (verify?)
</para>
-->
&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
-->