v4.0.3: add --deep option for deep clones

Signed-off-by: Chris Warrick <[email protected]>

.pbwrapperhelp

@@ -39,9 +39,9 @@ options:
       --noscriptlet    do not execute the install scriptlet if one exists
       --print-format <string>
                        specify how the targets should be printed
-usage: pkgbuilder [-h] [-V] [-F] [--userfetch USER] [-i] [-s] [-u] [-U] [-c]
-                  [-C] [--debug] [-d] [-D] [-v] [-w] [--skippgpcheck] [-S]
-                  [-y]
+usage: pkgbuilder [-h] [-V] [-S] [-F] [--userfetch USER] [-i] [-s] [-u] [-U]
+                  [-c] [-C] [--debug] [-d] [-D] [-v] [-w] [--skippgpcheck]
+                  [--deep] [-y]
                   [PACKAGE [PACKAGE ...]]
 
 An AUR helper (and library) in Python 3.
@@ -54,6 +54,7 @@ optional arguments:
   -V, --version       show version number and quit
 
 operations:
+  -S, --sync          build in /tmp
   -F, --fetch         fetch package files
   --userfetch USER    fetch all package files of an user
   -i, --info          view package information
@@ -70,7 +71,7 @@ options:
   -v, --novalidation  don't check if packages were installed after build
   -w, --buildonly     don't install packages after building
   --skippgpcheck      do not verify source files with PGP signatures
-  -S, --sync          pacman-like mode
+  --deep              perform deep git clones
   -y, --refresh       (dummy)
 
 Also accepting ABS packages.

CHANGELOG.rst

@@ -5,8 +5,8 @@ Appendix C. Changelog
 :Author: Chris Warrick <[email protected]>
 :Copyright: © 2011-2015, Chris Warrick.
 :License: BSD (see /LICENSE or :doc:`Appendix B <LICENSE>`.)
-:Date: 2015-07-13
-:Version: 4.0.2
+:Date: 2015-07-15
+:Version: 4.0.3
 
 .. index:: CHANGELOG
 
@@ -47,6 +47,9 @@ More information can be found on GitHub in the `releases section <https://github
 Version History
 ===============
 
+4.0.3
+    * Add ``--deep`` option to create deep clones (especially useful for ``-F`` and ``--userfetch``)
+
 4.0.2
     * Update documentation (man pages, README)
     * Support upgrade-fetch (``-uF``) properly

CONTRIBUTING.rst

@@ -4,8 +4,8 @@ Appendix A. Contribution rules
 :Author: Chris Warrick <[email protected]>
 :Copyright: © 2011-2015, Chris Warrick.
 :License: BSD (see /LICENSE or :doc:`Appendix B <LICENSE>`.)
-:Date: 2015-07-13
-:Version: 4.0.2
+:Date: 2015-07-15
+:Version: 4.0.3
 
 .. index:: contributing
 

PKGBUILD

@@ -1,7 +1,7 @@
 # Maintainer: Chris Warrick <[email protected]>
 pkgname=pkgbuilder
 _pyname=pkgbuilder
-pkgver=4.0.2
+pkgver=4.0.3
 pkgrel=1
 pkgdesc='A Python AUR helper/library.'
 arch=('any')
@@ -10,7 +10,7 @@ license=('BSD')
 depends=('python' 'python-setuptools' 'pyalpm>=0.5.1-1' 'python-requests' 'python-srcinfo' 'rsync' 'git')
 options=(!emptydirs)
 source=("https://pypi.python.org/packages/source/${_pyname:0:1}/${_pyname}/${_pyname}-${pkgver}.tar.gz")
-md5sums=('939e9afbfe0a7d84d7953e50e0b74f22')
+md5sums=('3c11b0a3d52e7c186f42660e7e7a57a7')
 
 package() {
   cd "${srcdir}/${_pyname}-${pkgver}"

PKGBUILD-git

@@ -2,7 +2,7 @@
 pkgname=pkgbuilder-git
 _pyname=pkgbuilder
 _gitname=pkgbuilder
-pkgver=4.0.2
+pkgver=4.0.3
 pkgrel=1
 pkgdesc='A Python AUR helper/library. (git version)'
 arch=('any')

README

@@ -3,8 +3,8 @@ PKGBUILDer.  An AUR helper (and library) in Python 3.
 =====================================================
 :Info: This is the README file for PKGBUILDer.
 :Author: Chris Warrick <[email protected]>
-:Date: 2015-07-13
-:Version: 4.0.2
+:Date: 2015-07-15
+:Version: 4.0.3
 
 .. index: README
 
@@ -33,7 +33,7 @@ PKGBUILDer also comes with ``pb``, a wrapper that works with both pacman and
 the AUR.
 
 For more information, refer to the ``-h`` command, the ``pkgbuilder(8)`` man
-page, or the online documentation at http://pkgbuilder.rtfd.org/.
+page, or the online documentation at https://pkgbuilder.readthedocs.org/.
 
 COPYRIGHT
 ---------

README.rst

@@ -3,8 +3,8 @@ PKGBUILDer.  An AUR helper (and library) in Python 3.
 =====================================================
 :Info: This is the README file for PKGBUILDer.
 :Author: Chris Warrick <[email protected]>
-:Date: 2015-07-13
-:Version: 4.0.2
+:Date: 2015-07-15
+:Version: 4.0.3
 
 .. index: README
 
@@ -33,7 +33,7 @@ PKGBUILDer also comes with ``pb``, a wrapper that works with both pacman and
 the AUR.
 
 For more information, refer to the ``-h`` command, the ``pkgbuilder(8)`` man
-page, or the online documentation at http://pkgbuilder.rtfd.org/.
+page, or the online documentation at https://pkgbuilder.readthedocs.org/.
 
 COPYRIGHT
 ---------

docs/CHANGELOG.rst

@@ -5,8 +5,8 @@ Appendix C. Changelog
 :Author: Chris Warrick <[email protected]>
 :Copyright: © 2011-2015, Chris Warrick.
 :License: BSD (see /LICENSE or :doc:`Appendix B <LICENSE>`.)
-:Date: 2015-07-13
-:Version: 4.0.2
+:Date: 2015-07-15
+:Version: 4.0.3
 
 .. index:: CHANGELOG
 
@@ -47,6 +47,9 @@ More information can be found on GitHub in the `releases section <https://github
 Version History
 ===============
 
+4.0.3
+    * Add ``--deep`` option to create deep clones (especially useful for ``-F`` and ``--userfetch``)
+
 4.0.2
     * Update documentation (man pages, README)
     * Support upgrade-fetch (``-uF``) properly

docs/CONTRIBUTING.rst

@@ -4,8 +4,8 @@ Appendix A. Contribution rules
 :Author: Chris Warrick <[email protected]>
 :Copyright: © 2011-2015, Chris Warrick.
 :License: BSD (see /LICENSE or :doc:`Appendix B <LICENSE>`.)
-:Date: 2015-07-13
-:Version: 4.0.2
+:Date: 2015-07-15
+:Version: 4.0.3
 
 .. index:: contributing
 

docs/LICENSE.rst

@@ -3,8 +3,8 @@ Appendix B. License for PKGBUILDer
 ==================================
 :Info: This is the license for PKGBUILDer.
 :Author: Chris Warrick <[email protected]>
-:Date: 2015-07-13
-:Version: 4.0.2
+:Date: 2015-07-15
+:Version: 4.0.3
 
 .. index:: LICENSE
 

docs/README.rst

@@ -3,8 +3,8 @@ PKGBUILDer.  An AUR helper (and library) in Python 3.
 =====================================================
 :Info: This is the README file for PKGBUILDer.
 :Author: Chris Warrick <[email protected]>
-:Date: 2015-07-13
-:Version: 4.0.2
+:Date: 2015-07-15
+:Version: 4.0.3
 
 .. index: README
 

docs/aur.rst

@@ -4,8 +4,8 @@ aur module (AUR class)
 :Author: Chris Warrick <[email protected]>
 :Copyright: © 2011-2015, Chris Warrick.
 :License: BSD (see /LICENSE or :doc:`Appendix B <LICENSE>`.)
-:Date: 2015-07-13
-:Version: 4.0.2
+:Date: 2015-07-15
+:Version: 4.0.3
 
 .. index:: AUR; RPC
 .. index:: RPC

docs/build.rst

@@ -5,8 +5,8 @@ build module
 :Author: Chris Warrick <[email protected]>
 :Copyright: © 2011-2015, Chris Warrick.
 :License: BSD (see /LICENSE or :doc:`Appendix B <LICENSE>`.)
-:Date: 2015-07-13
-:Version: 4.0.2
+:Date: 2015-07-15
+:Version: 4.0.3
 
 .. index:: build
 .. versionadded:: 2.1.0.0

docs/conf.py

@@ -48,9 +48,9 @@
 # built documents.
 #
 # The short X.Y version.
-version = '4.0.2'
+version = '4.0.3'
 # The full version, including alpha/beta/rc tags.
-release = '4.0.2'
+release = '4.0.3'
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.

docs/exceptions.rst

@@ -5,8 +5,8 @@ Exceptions in PKGBUILDer
 :Author: Chris Warrick <[email protected]>
 :Copyright: © 2011-2015, Chris Warrick.
 :License: BSD (see /LICENSE or :doc:`Appendix B <LICENSE>`.)
-:Date: 2015-07-13
-:Version: 4.0.2
+:Date: 2015-07-15
+:Version: 4.0.3
 
 .. index:: Exceptions
 .. versionadded:: 3.0.0

docs/main.rst

@@ -4,8 +4,8 @@ __main__ module
 :Author: Chris Warrick <[email protected]>
 :Copyright: © 2011-2015, Chris Warrick.
 :License: BSD (see /LICENSE or :doc:`Appendix B <LICENSE>`.)
-:Date: 2015-07-13
-:Version: 4.0.2
+:Date: 2015-07-15
+:Version: 4.0.3
 
 .. index:: main
 .. versionchanged:: 4.0.0

docs/package.rst

@@ -5,8 +5,8 @@ package module (Package, AURPackage, ABSPackage classes)
 :Author: Chris Warrick <[email protected]>
 :Copyright: © 2011-2015, Chris Warrick.
 :License: BSD (see /LICENSE or :doc:`Appendix B <LICENSE>`.)
-:Date: 2015-07-13
-:Version: 4.0.2
+:Date: 2015-07-15
+:Version: 4.0.3
 
 .. index:: Package
 .. index:: AURPackage

docs/pb.rst

@@ -6,9 +6,9 @@ PBWrapper
 :Author: Chris Warrick <[email protected]>
 :Copyright: © 2011-2015, Chris Warrick.
 :License: BSD (see /LICENSE or Appendix B.)
-:Date: 2015-07-13
-:Version: 4.0.2
-:Wrapper Version: 0.4.1
+:Date: 2015-07-15
+:Version: 4.0.3
+:Wrapper Version: 0.4.2
 :Manual section: 8
 :Manual group: PKGBUILDer manual
 
@@ -74,10 +74,10 @@ SEE ALSO
 **pacman(8)**, **pkgbuilder(8)**, **makepkg(8)**, **PKGBUILD(5)**
 
 You can visit the git repo at <https://github.com/Kwpolska/pkgbuilder>
+or the documentation at <https://pkgbuilder.readthedocs.org>
 for more info.
 
 BUGS
 ====
-Bugs should be reported at the GitHub page
-(<https://github.com/Kwpolska/pkgbuilder/issues>), with the PBWrapper
-label.  You can also send mail to <[email protected]>.
+Bugs should be reported at the GitHub page (<https://github.com/Kwpolska/pkgbuilder/issues>).
+You can also send mail to <[email protected]>.

docs/pbds.rst

@@ -5,8 +5,8 @@ pbds module (PBDS class)
 :Author: Chris Warrick <[email protected]>
 :Copyright: © 2011-2015, Chris Warrick.
 :License: BSD (see /LICENSE or :doc:`Appendix B <LICENSE>`.)
-:Date: 2015-07-13
-:Version: 4.0.2
+:Date: 2015-07-15
+:Version: 4.0.3
 
 .. module: pbds
 

docs/pkgbuilder.rst

@@ -6,15 +6,15 @@ PKGBUILDer
 :Author: Chris Warrick <[email protected]>
 :Copyright: © 2011-2015, Chris Warrick.
 :License: BSD (see /LICENSE or Appendix B.)
-:Date: 2015-07-13
-:Version: 4.0.2
+:Date: 2015-07-15
+:Version: 4.0.3
 :Manual section: 8
 :Manual group: PKGBUILDer manual
 
 SYNOPSIS
 ========
 
-*pkgbuilder* [-hVcCdDvwSy] [--debug] [--skippgpcheck] [--userfetch USER] [-FisuU] [PACKAGE [PACKAGE ...]]
+*pkgbuilder* [-hVcCdDvwy] [--debug] [--skippgpcheck] [--userfetch USER] [--deep] [-SFisuU] [PACKAGE [PACKAGE ...]]
 
 DESCRIPTION
 ===========
@@ -35,11 +35,22 @@ Notice: Running PKGBUILDer and/or PBWrapper as root can deal catastrophic
 damage to your system.  Run it as a regular user, you will be prompted for
 the root password when one will be required (i.e. to run **pacman**).
 
+CONFIGURATION
+=============
+
+PKGBUILDer does not support any global configuration, and should instead be
+configured on a per-usage basis via command-line arguments.  However, the
+``VerbosePkgLists`` pacman option is also honored by PKGBUILDer (and using it
+is recommended).
+
 OPERATIONS
 ==========
 
+**-S, --sync**
+    Build packages in */tmp* instead of CWD.
+
 **-F, --fetch**
-    Fetch (and don’t build) **PACKAGE**\s in a fashion similar to
+    Fetch (and don't build) **PACKAGE**\s in a fashion similar to
     ``cower -d``.
 
 **--userfetch USER**
@@ -102,8 +113,11 @@ OPTIONS
 **--skippgpcheck**
     Skip PGP checks.
 
-**-S, --sync**
-    Build packages in */tmp* and uses *aur* instead of the category in search.
+**--deep**
+    Perform deep clones of git repositories.
+
+**-y, --refresh**
+    Dummy option for pacman compatibility.
 
 EXAMPLES
 ========
@@ -131,8 +145,6 @@ pkgbuilder -Syu
 pkgbuilder -uF
     Check for updates and offer fetching them.
 
-hello is a package for GNU Hello: http://www.gnu.org/software/hello/
-
 SEE ALSO
 ========
 **pb(8)**, a wrapper for pacman and PKGBUILDer, included with PKGBUILDer, also
@@ -141,10 +153,10 @@ known as PBWrapper.
 **pacman(8)**, **makepkg(8)**, **PKGBUILD(5)**
 
 You can visit the git repo at <https://github.com/Kwpolska/pkgbuilder>
+or the documentation at <https://pkgbuilder.readthedocs.org>
 for more info.
 
 BUGS
 ====
-Bugs should be reported at the GitHub page
-(<https://github.com/Kwpolska/pkgbuilder/issues>).  You can also
-send mail to <[email protected]>.
+Bugs should be reported at the GitHub page (<https://github.com/Kwpolska/pkgbuilder/issues>).
+You can also send mail to <[email protected]>.

docs/sample-scripts.rst

@@ -4,8 +4,8 @@ PKGBUILDer Sample Scripts
 :Author: Chris Warrick <[email protected]>
 :Copyright: © 2011-2015, Chris Warrick.
 :License: BSD (see /LICENSE or :doc:`Appendix B <LICENSE>`.)
-:Date: 2015-07-13
-:Version: 4.0.2
+:Date: 2015-07-15
+:Version: 4.0.3
 
 .. index:: sample scripts
 

docs/ui.rst

@@ -5,8 +5,8 @@ ui module (UI class)
 :Author: Chris Warrick <[email protected]>
 :Copyright: © 2011-2015, Chris Warrick.
 :License: BSD (see /LICENSE or :doc:`Appendix B <LICENSE>`.)
-:Date: 2015-07-13
-:Version: 4.0.2
+:Date: 2015-07-15
+:Version: 4.0.3
 
 .. index:: UI
 .. versionadded:: 3.0.0