cvs: peardoc /en/chapters installation.xml

alexmerz Fri Feb 6 11:07:16 2004 EDT Modified files: /peardoc/en/chapters installation.xml Log: add cvs installation http://cvs.php.net/diff.php/peardoc/en/chapters/installation.xml?r1=1.14&r2=1.15&ty=u Index: peardoc/en/chapters/installation.xml diff -u peardoc/en/chapters/installation.xml:1.14 peardoc/en/chapters/installation.xml:1.15 --- peardoc/en/chapters/installation.xml:1.14 Fri Jan 2 18:27:21 2004 +++ peardoc/en/chapters/installation.xml Fri Feb 6 11:07:16 2004 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1" ?> -<!-- $Revision: 1.14 $ --> +<!-- $Revision: 1.15 $ --> <!-- WORK IN PROGRESS, THERE IS PROBABLY LITTLE POINT IN TRANSLATING THIS DOCUMENT YET. @@ -32,7 +32,7 @@ <literal>--without-pear</literal>. </para> <para> - The packages that are not part of the + The packages that are not part of the <link linkend="about-pfc">PFC</link> can be installed with the PEAR package manager. The manager is comparable to Debian's <quote><ulink url="&url.debian.apt;">apt-get</ulink></quote>. Again: @@ -382,7 +382,7 @@ </para> <para> If you more questions concerning manual installation, you can ask - on the + on the <ulink url="&email.pear.general;">user mailing list</ulink>. </para> @@ -395,6 +395,82 @@ This passage will describe how you install the latest development version of a PEAR package from CVS. </para> + <para> + It is NOT recommended to run a package from CVS in working enviroments! + Because CVS versions are no regulare releases, this means: + <itemizedlist> + <listitem> + <simpara>You could get no kind of help from the maintainer or anybody other.</simpara> + </listitem> + <listitem> + <simpara>Versions in CVS may break the upgrade mechanismen of the PEAR Installer.</simpara> + </listitem> + </itemizedlist> + </para> + <para> + You should use a package from CVS only, if: + <itemizedlist> + <listitem> + <simpara>The maintainer recommended it for you.</simpara> + </listitem> + <listitem> + <simpara>You want to help in development of a package.</simpara> + </listitem> + <listitem> + <simpara>You really need a special patch or function, which is not currently released.</simpara> + </listitem> + </itemizedlist> + </para> + <para> + If you still want to install a package from CVS, you have to do the same steps + like a package maintainer creating a new release of a package. If you have problems + following the next steps, take a look into the + <link linkend="guide-developers">Developers Section</link> of the manual. + </para> + <orderedlist> + <listitem> + <para> + Get the package files from CVS like described in <ulink url="http://www.php.net/anoncvs.php">http://www.php.net/anoncvs.php</ulink> + </para> + <para> + The name of the module to checkout is <filename>pear/&lt;packagename&gt;</filename>, + i.e. <command> cvs -d :pserver:cvsread@cvs.php.net:/repository checkout pear/HTTP_Client</command>. + </para> + </listitem> + <listitem> + <para> + Check the <filename>package.xml</filename> file, especially the the fileset entries. + They must match the existing files and directory structure. If they differ, contact + the maintainer and ask for an update of <filename>package.xml</filename>. + </para> + </listitem> + <listitem> + <para> + Create a valid package using the PEAR Installer + <command>pear package &lt;path to package.xml&gt;</command> + </para> + </listitem> + <listitem> + <para> + If you have already the package installed: remove it to avoid versions problems: + <command>pear uninstall &lt;package&gt;</command> + </para> + </listitem> + <listitem> + <para> + Install your package archive: + <command>pear install &lt;package-file&gt;</command> + </para> + <para> + Now, you have an CVS version installed! + </para> + </listitem> + </orderedlist> + <para> + You should upgrade to a official release of the package as early as possible. + Before you install the official release, uninstall the CVS version to avoid + version problems. + </para> </sect1> </chapter>