[Gnash-commit] gnash/doc/C/usermanual/installation sources.xml

[Ann Barcomb]

CVSROOT:        /sources/gnash
Module name:    gnash
Changes by:     Ann Barcomb <ann>       07/05/26 10:40:42

Modified files:
        doc/C/usermanual/installation: sources.xml 

Log message:
        Development snapshots are now reliable and can be listed as a way to 
get 
        the source; also added an explanation of when to go with each option for
        getting the source.

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/gnash/doc/C/usermanual/installation/sources.xml?cvsroot=gnash&r1=1.1&r2=1.2

Patches:
Index: sources.xml
===================================================================
RCS file: /sources/gnash/gnash/doc/C/usermanual/installation/sources.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -b -r1.1 -r1.2
--- sources.xml 22 May 2007 13:48:09 -0000      1.1
+++ sources.xml 26 May 2007 10:40:42 -0000      1.2
@@ -17,15 +17,20 @@
   make install
   </programlisting>
 </para>
+<para>
+  Continue reading for detailed step-by-step instructions 
+  of the entire procedure.
+</para>  
+
 
 <sect3 id="gettingsource">
   <title>Getting the Source</title>
 
   <para>
-    <!-- NOTE: mention daily snapshots when they are available. -->
     &app; is available as a <link linkend="sourcereleases">release
-    tarball</link> or a <link linkend="sourcerepo">development 
-    checkout</link>.
+    tarball</link>, a <link linkend="sourcerepo">development 
+    checkout</link>, or a <link linkend="sourcesnapshot">development
+    snapshot</link>.
   </para>
 
   <sect4 id="sourcereleases">
@@ -35,8 +40,16 @@
       The source can be acquired from a
       <ulink type="http" 
       url="http://www.gnu.org/prep/ftp.html";>GNU FTP
-      Mirror</ulink>.  First, choose a mirror near you, then
-      select the <filename>gnash</filename> directory.
+      Mirror</ulink>.  The release version is intended to be
+      stable, and is probably your best choice if the release took
+      place recently.  If you need features or fixes which were
+      introduced after the release, consider a 
+      <link linkend="sourcerepo">CVS checkout</link> or the
+      <link linkend="sourcesnapshot">daily snapshot</link>.
+    </para>
+    <para>
+      To download, select a mirror near you, then choose the
+      <filename>gnash</filename> directory.
     </para>
   </sect4>
 
@@ -45,7 +58,14 @@
 
     <para>
       The latest development sources are available via
-      anonymous CVS (leave the password blank).  First set the
+      anonymous CVS (leave the password blank).  This is recommended
+      if you need features or bug fixes which were introduced after
+      the <link linkend="sourcereleases">last release</link>.  Look at
+      the <link linkend="sourcesnapshot">daily snapshot</link> if you
+      experience difficulty accessing the repository.
+    </para>
+    <para>
+      First set the
       environment variable <emphasis>CVS_RSH</emphasis> to 'ssh', as shown
       in this example, which uses the GNU Bourne-Again shell (bash):
       <programlisting>
@@ -57,4 +77,19 @@
       type="http">browse the repository</ulink> on the web.
     </para>
   </sect4>
+
+  <sect4 id="sourcesnapshot">
+    <title>Snapshot</title>
+
+    <para>
+      The daily development snapshot can be downloaded from
+      <ulink url="http://www.gnashdev.org/dev_snapshots/";
+      type="http">http://www.gnashdev.org/dev_snapshots/</ulink>.
+      This is the best option if you need changes which were introduced
+      after the <link linkend="sourcereleases">last release</link> of
+      &app;, but are unable to <link linkend="sourcerepo">download
+      directly from the repository.</link>
+    </para>
+  </sect4>
+
 </sect3>