sync docs from stg.tizen.org and bump to 0.14.rc3

Change-Id: I5023e5bbcde79c81695284d104ff92b1b919410d

diff --git a/debian/changelog b/debian/changelog
index b2b9f6ba2e9de425c1bf82b30f6f4f147c66fff4..34ac547fd60033fa0fba247c59f072bdbf2f6ea3 100644 (file)
--- a/debian/changelog
+++ b/debian/changelog
@@ -1,4 +1,4 @@
-gbs (0.14-0.rc2) unstable; urgency=high
+gbs (0.14-0.rc3) unstable; urgency=high
   * upgrade to gbs v0.14, which contains the following bug fixing & features:
     * Add --binary-from-file option to specify a package list file
     * Change --binary-list option, accept a packages list separated by comma(,).

diff --git a/distfiles/gbs.spec b/distfiles/gbs.spec
index 02dc555aa7b4d697154c5f889f1e15d8b1659898..ca3367aee7144743a4434d593596481ab1dd0b28 100644 (file)
--- a/distfiles/gbs.spec
+++ b/distfiles/gbs.spec
@@ -3,7 +3,7 @@
 Name:       gbs
 Summary:    The command line tools for Tizen package developers
 Version:    0.14
-Release:    0.rc2.<CI_CNT>.<B_CNT>
+Release:    0.rc3.<CI_CNT>.<B_CNT>
 Group:      Development/Tools
 License:    GPLv2
 BuildArch:  noarch

diff --git a/docs/GBS.rst b/docs/GBS.rst
index c3aa1a83dbf19b39c7dc5dfe4536ce7171dd92b9..1413b84e35716193964a53c825ff75afe7712f04 100644 (file)
--- a/docs/GBS.rst
+++ b/docs/GBS.rst
@@ -907,28 +907,42 @@ Multiple package build has been supported since gbs 0.10. If packages have depen
    # current directory have multiple packages, --threads can be used to set the max build worker at the same time
    $ gbs build -A armv7l --threads=4
 
-3. Select a group of packages to build
+3. Select a group of packages to be built
 
-`--binary-list` option can be used to specify a text file, which contains the RPM binary name list you want to build, the format is one package per line
+The --binary-from-file option specifies a text file that contains a name list of RPM packages to be built. The format in the text file is one package per line.
+
+The --binary-list option specifies a list in which the package names are separated by comma.
+
+When the number of packages is small, thus the packages can be clearly presented in command line, it is recommended to use the --binary-list option for simplicity.
 
 ::
 
-$ gbs build -A i586 --binary-list=/path/to/packages.list
+  $ gbs build -A i586 --binary-from-file=/path/to/packages.list
+  $ gbs build -A i586 --binary-list=<pkg1>,<pkg2>
+
+4. Exclude certain packages.
 
-4. If you want to exclude some packages, `--exclude` can be used to exclude one package.
+The --exclude option specifies a list in which the names of packages to be ignored are separated by comma.
+The --exclude-from-file option specifies a text file  that contains a name list of packages to be ignored.
 
 ::
 
-    $ gbs build -A i586 tizen-packages --exclude=<pkg1>
-    $ gbs build -A i586 tizen-packages --exclude=<pkg1> --exclude=<pkg2>
+  $ gbs build -A i586 tizen-packages --exclude=<pkg1>
+  $ gbs build -A i586 tizen-packages --exclude=<pkg1>,<pkg2>
+  $ gbs build -A i586 tizen-packages --exclude-from-file=/path/to/packages.list
 
-5. If you want to exclude many packages, you can use `--exclude-from-file` to specify a package list. The format is the same as `--binary-list`
+5. Build packages based on dependencies.
+The --deps option enables GBS to build specific packages, together with all the related packages on which they depend.The --rdep option enables GBS to build specific packages, together with all the related packages that depend on them.  
 
-::
+The specific packages can be included by the --binary-from-file option or the --binary-list option, and be excluded by the --exclude option or the --exclude-from-file option.
 
-    $ gbs build -A i586 tizen-packages --exclude-from-file=<file>
+These two options are compatible. When added at the same time, besides the specific packages, GBS will build not only the related packages on which they depend, but also all the related packages that depend on them.
 
+::
 
+  $ gbs build -A i586 --binary-list=<pkg1>,<pkg2> --deps
+  $ gbs build -A i586 --binary-list=<pkg1>,<pkg2> --rdeps
+  $ gbs build -A i586 --binary-list=<pkg1>,<pkg2> --deps --rdeps
 
 Other useful options
 ````````````````````