1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
|
<?xml version="1.0" encoding="iso-8859-1"?>
<preface xml:id="preface" xmlns:xlink="http://www.w3.org/1999/xlink">
<info>
<title>About This Document</title>
<abstract>
<para>
<acronym>PHP</acronym> is well known for having excellent documentation,
documentation that is created by volunteers who collectively make changes
every day. This HOWTO is designed for people who work on the official PHP
documentation. See also <link xlink:href="&url.php.docs;">&url.php.docs;</link>
for viewable and downloadable versions of the PHP manual.
</para>
<para>
This HOWTO contains information about every aspect of the documentation
process, which includes editing the DocBook <acronym>XML</acronym>
sources, validating changes made to these sources, using the build system
to generate documentation into other formats, and general tips like how to
use <acronym>SVN</acronym>.
</para>
<para>
Related to this HOWTO is the simple <filename>README</filename> file that
lives within the phpdoc SVN module. It's a quick guide for those already
familiar with the basics of XML and SVN.
</para>
<para>
The latest copy of this HOWTO is available here:
<link xlink:href="&url.php.howto.online;">&url.php.howto.online;</link>,
and it may be downloaded from here:
<link xlink:href="&url.php.howto;">&url.php.howto;</link>.
</para>
</abstract>
</info>
<sect1 xml:id="disclaimer">
<title>Disclaimer</title>
<para>
No liability for the contents of this documents can be
accepted. Use the concepts, examples and other content at your own
risk. There may be errors and inaccuracies in this document, that may
of course be damaging to your system. Proceed with caution, and
although this is highly unlikely, the author(s) do not take any
responsibility for that.
</para>
<para>
All copyrights are held by their respective owners,
unless specifically noted otherwise. Use of a term in this
document should not be regarded as affecting the validity of any
trademark or service mark.
</para>
<para>
Naming of particular products or brands should not be seen as
endorsements.
</para>
<para>
You are strongly recommended to take a backup of your system
before major installation and backups at regular intervals.
</para>
</sect1>
<sect1 xml:id="credits">
<title>Credits</title>
<para>
This document is based on many files, previously hosted
in the phpdoc module at cvs.php.net, containing information
about several distinct subjects, ranging from generating
the HTML files from XML sources to starting a new translation.
This is a central place for all these things. We tried to
include the original authors in the authors list of this file.
</para>
</sect1>
<sect1 xml:id="feedback">
<title>Feedback</title>
<para>
Feedback is most certainly welcome on this document. Without your
submissions and input, this document wouldn't exist. Please send
your additions, comments and criticisms to the following email
address: <email>&email.phpdoc;</email>.
</para>
</sect1>
</preface>
<!-- 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:"howto.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
-->
|
