cvs: peardoc /en/guide/developers package2.xml /en/guide/developers/package2 version.xml

cellog Thu Mar 3 21:17:26 2005 EDT Added files: /peardoc/en/guide/developers/package2 version.xml Modified files: /peardoc/en/guide/developers package2.xml Log: add docs for <version> http://cvs.php.net/diff.php/peardoc/en/guide/developers/package2.xml?r1=1.1&r2=1.2&ty=u Index: peardoc/en/guide/developers/package2.xml diff -u peardoc/en/guide/developers/package2.xml:1.1 peardoc/en/guide/developers/package2.xml:1.2 --- peardoc/en/guide/developers/package2.xml:1.1 Thu Mar 3 20:45:53 2005 +++ peardoc/en/guide/developers/package2.xml Thu Mar 3 21:17:25 2005 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1" ?> -<!-- $Revision: 1.1 $ --> +<!-- $Revision: 1.2 $ --> <chapter id="guide.developers.package2"> <title>The package definition file <filename>package.xml</filename>, version 2.0</title> <titleabbrev><filename>package.xml 2.0</filename></titleabbrev> @@ -76,7 +76,7 @@ &lt;/lead&gt; &lt;date&gt;2005-02-26&lt;/date&gt; &lt;time&gt;20:30:13&lt;/time&gt; &lt;-- note: &lt;time&gt; is optional --&gt; - &lt;version&gt; + <link linkend="guide.developers.package2.version">&lt;version&gt;</link> &lt;release&gt;1.4.0a2&lt;/release&gt; &lt;api&gt;1.4.0&lt;/api&gt; &lt;/version&gt; @@ -310,6 +310,7 @@ &guide.developers.package2.channel; &guide.developers.package2.uri; &guide.developers.package2.developers; + &guide.developers.package2.version; </sect1> </chapter> http://cvs.php.net/co.php/peardoc/en/guide/developers/package2/version.xml?r=1.1&p=1 Index: peardoc/en/guide/developers/package2/version.xml +++ peardoc/en/guide/developers/package2/version.xml <!-- $Revision: 1.1 $ --> <refentry id="guide.developers.package2.version"> <refnamediv> <refname>&lt;version&gt;</refname> <refpurpose>versioning in package.xml 2.0</refpurpose> </refnamediv> <refsect1 id="guide.developers.package2.version.purpose"> <title>Documenting release version and API version</title> <para> In package.xml 1.0, the version was simply the version. package.xml 2.0 splits the concept of versioning into two components, release and api. </para> <para> The release version is the same familiar versioning concept from package.xml 1.0. This version is validated very carefully by the packager. </para> <para> The API version is informational only - the installer does not use it. It can be used for a package-time replacement by the installer. This can be very useful when implementing a reflective method such as <function>getApiVersion</function>. In addition, the API version is very loosely validated, and only requires a version_compare()-compatible version number. </para> </refsect1> </refentry> <!-- 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 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 -->