[gnome-continuous-yocto/gnomeostree-3.28-rocko: 4791/8267] bitbake: bitbake-user-manual: Added "path_spec" parameter to SVN Fetcher

[Emmanuele Bassi <ebassi src gnome org>]

commit 7abb5b72060007caffbbfb8ee3c5c13f3edfc576
Author: Scott Rifenbark <srifenbark gmail com>
Date:   Mon Feb 20 10:30:58 2017 -0800

    bitbake: bitbake-user-manual: Added "path_spec" parameter to SVN Fetcher
    
    Fixes [YOCTO #10405]
    
    The section on the SVN Fetcher was missing information on the
    "path_spec" option.  I added this option and also updated the
    examples at the bottom of the section to include that parameter.
    Also, made the other two examples consistent.
    I also removed the "date" parameter.
    
    Also, updated the "protocol" parameter as well as the "modify"
    parameter.  For "modify" I removed the reference to "rsh". I
    applied a small wording change to the "protocol" parameter.
    
    Finally, I added a new "ssh" parameter.
    
    (Bitbake rev: 3ce6169afa646ef2b847e5fbabfe0191c93928b7)
    
    Signed-off-by: Scott Rifenbark <srifenbark gmail com>
    Signed-off-by: Richard Purdie <richard purdie linuxfoundation org>

 .../bitbake-user-manual-fetching.xml               |   30 ++++++++++++--------
 1 files changed, 18 insertions(+), 12 deletions(-)
---
diff --git a/bitbake/doc/bitbake-user-manual/bitbake-user-manual-fetching.xml 
b/bitbake/doc/bitbake-user-manual/bitbake-user-manual-fetching.xml
index 6e1642c..3f1d8eb 100644
--- a/bitbake/doc/bitbake-user-manual/bitbake-user-manual-fetching.xml
+++ b/bitbake/doc/bitbake-user-manual/bitbake-user-manual-fetching.xml
@@ -385,7 +385,8 @@
                 The supported parameters are as follows:
                 <itemizedlist>
                     <listitem><para><emphasis>"method":</emphasis>
-                        The protocol over which to communicate with the CVS server.
+                        The protocol over which to communicate with the CVS
+                        server.
                         By default, this protocol is "pserver".
                         If "method" is set to "ext", BitBake examines the
                         "rsh" parameter and sets <filename>CVS_RSH</filename>.
@@ -469,25 +470,29 @@
                         You can think of this parameter as the top-level
                         directory of the repository data you want.
                         </para></listitem>
+                    <listitem><para><emphasis>"path_spec":</emphasis>
+                        A specific directory in which to checkout the
+                        specified svn module.
+                        </para></listitem>
                     <listitem><para><emphasis>"protocol":</emphasis>
                         The protocol to use, which defaults to "svn".
-                        Other options are "svn+ssh" and "rsh".
-                        For "rsh", the "rsh" parameter is also used.
+                        If "protocol" is set to "svn+ssh", the "ssh"
+                        parameter is also used.
                         </para></listitem>
                     <listitem><para><emphasis>"rev":</emphasis>
                         The revision of the source code to checkout.
                         </para></listitem>
-                    <listitem><para><emphasis>"date":</emphasis>
-                        The date of the source code to checkout.
-                        Specific revisions are generally much safer to checkout
-                        rather than by date as they do not involve timezones
-                        (e.g. they are much more deterministic).
-                        </para></listitem>
                     <listitem><para><emphasis>"scmdata":</emphasis>
                         Causes the “.svn” directories to be available during
                         compile-time when set to "keep".
                         By default, these directories are removed.
                         </para></listitem>
+                    <listitem><para><emphasis>"ssh":</emphasis>
+                        An optional parameter used when "protocol" is set
+                        to "svn+ssh".
+                        You can use this parameter to specify the ssh
+                        program used by svn.
+                        </para></listitem>
                     <listitem><para><emphasis>"transportuser":</emphasis>
                         When required, sets the username for the transport.
                         By default, this parameter is empty.
@@ -496,10 +501,11 @@
                         command.
                         </para></listitem>
                 </itemizedlist>
-                Following are two examples using svn:
+                Following are three examples using svn:
                 <literallayout class='monospaced'>
-     SRC_URI = "svn://svn.oe.handhelds.org/svn;module=vip;proto=http;rev=667"
-     SRC_URI = "svn://svn.oe.handhelds.org/svn/;module=opie;proto=svn+ssh;date=20060126"
+     SRC_URI = "svn://myrepos/proj1;module=vip;protocol=http;rev=667"
+     SRC_URI = "svn://myrepos/proj1;module=opie;protocol=svn+ssh"
+     SRC_URI = "svn://myrepos/proj1;module=trunk;protocol=http;path_spec=${MY_DIR}/proj1"
                 </literallayout>
             </para>
         </section>