gwynne Fri Jul 27 22:28:36 2007 UTC
Modified files:
/phd/RFC Buildsystem-proposal.rtf
Log:
The "no external libs" rule can have exceptions.
http://cvs.php.net/viewvc.cgi/phd/RFC/Buildsystem-proposal.rtf?r1=1.1&r2=1.2&diff_format=u
Index: phd/RFC/Buildsystem-proposal.rtf
diff -u phd/RFC/Buildsystem-proposal.rtf:1.1
phd/RFC/Buildsystem-proposal.rtf:1.2
--- phd/RFC/Buildsystem-proposal.rtf:1.1 Wed Jul 25 05:07:19 2007
+++ phd/RFC/Buildsystem-proposal.rtf Fri Jul 27 22:28:36 2007
@@ -133,7 +133,7 @@
{\listtext \'a5 }The build system MUST be able to successfully process
the entire DocBook 5 content model by whatever means available to it, including
if necessary a fallback mechanism to contend with unrecognized elements.\
{\listtext \'a5 }The output model of the build system SHOULD be as
flexible as possible, with the ability to select various presentation formats,
including but not limited to, XML, HTML, WML, PDF, and plain text. For an
initial implementation, HTML output only will suffice, but the system MUST be
designed with this requirement in mind.\
{\listtext \'a5 }The build system MUST present a simple usage paradigm
to those not already familiar with its workings.\
-{\listtext \'a5 }The build system MUST NOT rely upon any tool or
library present on the target system save PHP, unless another tool is deemed
absolutely necessary in the fulfillment of the other requirements. It MAY
depend on the presence of various PHP extensions, limited to those distributed
with PHP 5.2 or later. The system MUST NOT rely upon PHP 6, but SHOULD be
prepared for its presence, even if only by exiting with an error in that case.\
+{\listtext \'a5 }The build system MUST NOT rely upon any tool or
library present on the target system save PHP, unless another tool is deemed
absolutely necessary in the fulfillment of the other requirements. It MAY
depend on the presence of various PHP extensions, limited to those distributed
with PHP 5.2 or later. The system MUST NOT rely upon PHP 6, but SHOULD be
prepared for its presence, even if only by exiting with an error in that case.
Exceptions to this rule will be determined on a case-by-case basis by the
authors.\
{\listtext \'a5 }The build system MUST be as Unicode-aware as is
reasonably possible. This includes but is not limited to respecting the
encoding parameter of <?xml?> prologs, providing a heuristic for guessing the
encoding of an undeclared file, handling UTF-8 validation failures gracefully,
and dynamically presenting all output in either UTF-8 or an encoding of the
target system's choice.\
{\listtext \'a5 }The build system MUST NOT attempt to fulfill roles
outside its intended scope. Examples of this are management of the main PHP Web
site, the presentation of small documents such as this proposal, and versioning
of documentation.\
{\listtext \'a5 }The build system SHOULD be aware of any version
control system in use, such as CVS or Subversion, and SHOULD make reasonable
efforts to require that documents it processes have been successfully submitted
to that system. The build system MAY place this validation under control of the
target system.\
@@ -683,8 +683,7 @@
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\ql\qnatural\pardirnatural
\cf0 \
At the time of this writing, the most popular option for the system
name is "PhD". It is considered likely that this will be the final name of the
project.\
-\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\ql\qnatural\pardirnatural
-\cf0 \
+\
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\ql\qnatural\pardirnatural
\f0\b\fs32 \cf0 \page XI. System licensing proposals\
@@ -707,7 +706,7 @@
\f5\fs24 \cf0 \
-\f4\fs20 \cf0
-------------------------------------------------------------------- \
+\f4\fs20 -------------------------------------------------------------------- \
The PhD License, version 1.0\
Based on the PHP license, version 3.01\
Copyright (c) 2007 The PHP Documentation Group. All Rights Reserved.\
@@ -775,7 +774,7 @@
For more information on the PHP Documentation Group and the PhD\
project, please see <http://phd.php.net>.\
-\f5\fs24 \cf0 \
+\f5\fs24 \
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\ql\qnatural\pardirnatural
\f1\fs28 \cf0 \
