tag and release 0.35.0

src/usr/doc/NEWS

@@ -1,5 +1,8 @@
 SBOPKG NEWS
 
+sbopkg xxxVERSIONxxx (xxxDATExxx)
+
+
 sbopkg 0.35.0 (2011-04-28 02:48 UTC)
 
     FEATURES

tools/ChangeLog-latest.txt

@@ -1,44 +1,114 @@
-sbopkg 0.34.1 (2011-02-05 04:20 UTC)
+sbopkg 0.35.0 (2011-04-28 02:48 UTC)
 
     FEATURES
 
-        * Added Spanish translations of the man pages. Much thanks to
+        * This release of sbopkg is Slackware 13.37-ready. (Congrats to
-          Pablo Castano Fernandez for doing these translations.
+          all involved in the Slackware release.)
+
+        * The READMEs of all installed packages can now be read from the
+          main menu's list/uninstall item. (Selection state will also
+          now be remembered.) Thanks to dmotaleite for the RFE.
+
+        * Similarly, the -R and -p flags can now be combined to page
+          through the READMEs of all installed packages.
+
+        * Added ponce's repo (SBo variant for -current) to the default
+          repos. Thanks to Mauro for suggesting this about a year ago.
+          Note that this is unsupported (if a build from this repo
+          breaks in sbopkg you get to keep both pieces) but people seem
+          pleased with this repo and it'll save a step for new users.
+          Note that the default repo files have been reordered, as well.
+          50-sb64 is now 70, 60-local is now 50, and the new one is 60.
+          This puts the unsupported repos last. If by chance you have a
+          file with those names already in there, upgrading sbopkg will
+          clobber them. See each of the two following sections for more
+          repo-related modifications and bugfixing.
+
+        * Added a bash completion file for sbopkg. This is independent
+          of the bash-completion package. It can be found in the new
+          doc/contrib directory. Source the file (in your shell startup
+          files if you want it always on automatically) from its current
+          location or wherever you wish to copy it and you should be
+          able to complete some of sbopkg's flags and their arguments.
+          Also see the KNOWN_ISSUES file. Thanks to Sergey V. for this
+          contribution.
 
     MODIFICATIONS
 
-        * Revision of documentation. Major reformatting and some textual
+        * Updated French man pages. Thanks to Marie-Claude Collilieux.
-          modifications of /usr/doc/sbopkg-*/* including breaking out
+
-          the credits in the script into a detailed THANKS file,
+        * Revised documentation: moved the queuefiles directory into a
-          renaming and reformatting ChangeLog.txt into NEWS, renaming
+          new contrib directory, renamed the README-*.d documents,
-          the sample queuefiles from *.sqf to *.sqf.sample, and making
+          stripping the '.d'. Clarified/updated the dialog nav/certcheck
-          lesser modifications to all the other docs.
+          sections of KNOWN_ISSUES, brought the missing 0.27.0 and
+          0.33.1 branch changes from their ChangeLogs into NEWS, added a
+          block in README describing all the plain text documents, added
+          a note about making corrections to THANKS, a couple of TODO
+          items, etc.
+
+        * Note also that symlinks are now made from README-repos and
+          README-renames to READMEs in the corresponding /etc/sbopkg/*.d
+          directories. NOTE that renames files must now end in .renames
+          so, if you have custom files in renames.d, you'll need to
+          rename them.
+
+        * The 'Choose a repository' dialog widget is now titled
+          'Repository Selection' and the widget text was revised. Also,
+          the menu itself used to say 'BRANCH (REPO) DESCRIPTION' and
+          now says 'REPO (BRANCH) DESCRIPTION'. The relevant item in the
+          Utilities menu that shows which repo/branch you're on and
+          takes you to the Repository Selection widget was similarly
+          re-ordered.
+
+        * When a repository directory does not exist, sbopkg now
+          displays, e.g.
+
+          REPO_{ROOT,NAME,BRANCH} -> /var/lib/sbopkg/,SBo/,13.1
+
+          or, in the case of git repos which don't currently have BRANCH
+          directories, it just shows REPO_{ROOT,NAME}. It used to
+          display
+
+          REPO_ROOT -----------> /var/lib/sbopkg/
+
+          While the new line may be odd looking, it should be clear
+          enough that it means REPO_ROOT is /var/lib/sbopkg/, REPO_NAME
+          is SBo/ and REPO_BRANCH is 13.1 and that these are path
+          components and that the path is missing. Before, it would say
+          /var/lib/sbopkg/ didn't exist if, e.g., 13.1 was missing even
+          when /var/lib/sbopkg/ did exist.
 
     BUGFIXES
 
-        * Fixed issue where MKDIR_PROMPT was being ignored. Thanks to
+        * Fixed an issue where URL redirects and SSL certificate check
-          catkin for raising this issue.
+          failures could combine to cause a download failure. Thanks to
+          vbatts for raising this issue.
 
-        * Fixed issue where -o would wrongly produce no output. Thanks
+        * Fixed a documentation bug where the ability to keep a
-          to ArTourter for raising this issue and to Mauro Giachero for
+          ~/.sbopkg.conf file to override the system config file (since
-          the patch.
+          0.25.0) wasn't documented anywhere other than this file. It's
+          now in both manuals. Thanks to Bill Kirkpatrick for raising
+          this issue.
 
-        * Fixed issue where TAG would sometimes not appear in the final
+        * Fixed an issue where 'Invert all' in file removal dialogs
-          package. Thanks to chytraeus for raising this issue.
+          didn't 'invert' but turned everything on or off, regardless of
+          selection state. If it was really intended to be
+          'Select/Deselect all', then changing the button to "Invert
+          Sel" and making it do that was a feature/modification instead
+          of a bugfix. ;)
 
-        * A revision which fixed a failure to properly initialize
+        * Fixed an issue were the user could switch repos, receive a
-          directories when running under bash 3x was committed but
+          directory creation prompt, abort it, and the active repo would
-          didn't make it into the released package. It is included in
+          be switched anyway, despite the directory not being created.
-          this release. Also fixed a problem with a blank line being
+          Now, the original repo is restored as the active one.
-          wrongly displayed in the directory initialization output in
-          older bashes. Thanks to greinze for pointing the latter out.
 
-        * Fixed documentation bug where the obsolete SBOPKGTMP and
+        * Fixed a bug in a previous bugfix that would still let sbopkg
-          current TMPDIR variables weren't correctly documented. Thanks
+          download source files whose DOWNLOAD value ended in
-          to dive for raising this issue.
+          '/download' even when the source files were cached.
 
-        * Fixed non-documentation bug where TMPDIR wasn't being
+        * Fixed a depth-restriction bug triggered when an app
-          correctly assigned when set in sbopkg.conf. Thanks to Ken
+          directory's subdirectory has the same name as another app
-          Roberts for reporting the issue and providing a preliminary
+          directory, causing sbopkg to match things or try to use things
-          fix.
+          like openvswitch/xen/foo when xen/foo is intended. Thanks to
+          David Somero for reporting this.
 

tools/current-download

@@ -1 +1 @@
-http://sbopkg.googlecode.com/files/sbopkg-0.34.1-noarch-1_cng.tgz
+http://sbopkg.googlecode.com/files/sbopkg-0.35.0-noarch-1_cng.tgz

tools/current-package

@@ -1 +1 @@
-sbopkg-0.34.1-noarch-1_cng.tgz
+sbopkg-0.35.0-noarch-1_cng.tgz

tools/current-source

@@ -1 +1 @@
-sbopkg-0.34.1.tar.gz
+sbopkg-0.35.0.tar.gz

tools/current-version

@@ -1 +1 @@
-0.34.1
+0.35.0

tools/sbopkg-conf5.html

@@ -3,7 +3,7 @@ Content-type: text/html
 <HTML><HEAD><TITLE>Manpage of SBOPKG.CONF</TITLE>
 </HEAD><BODY>
 <H1>SBOPKG.CONF</H1>
-Section:  (5)<BR>Updated: February 2011<BR><A HREF="#index">Index</A>
+Section:  (5)<BR>Updated: April 2011<BR><A HREF="#index">Index</A>
 <A HREF="http://localhost/cgi-bin/man/man2html">Return to Main Contents</A><HR>
 
 
@@ -27,7 +27,15 @@ packages.
 The default configuration file is installed at
 <I>/etc/sbopkg/sbopkg.conf</I>.
 
-Also, please see the subsection below about
+The user may override any settings in that file by creating
+<I>~/.sbopkg.conf</I>.
+
+<P>
+
+Please see the
+<B>NOTES</B>
+
+section for more information about variables, including
 <B>ARCH</B>.
 
 <P>
@@ -126,7 +134,13 @@ to
 is that
 <B>TMP</B>
 
-is set to an internal value and any other
+is set to
+<B>sbopkg</B>'s
+
+own temporary directory
+(<I>$TMPDIR/sbopkg.RANDOM_STRING</I>)
+
+and any other
 <B>TMP</B>
 
 setting is ignored.
@@ -325,7 +339,7 @@ files and can also be listed by issuing
 <DT><DD>
 The default assignment is:
 <DT><DD>
-REPO_BRANCH=${REPO_BRANCH:-13.1}
+REPO_BRANCH=${REPO_BRANCH:-13.37}
 
 <DT><B>REPO_NAME</B>
 
@@ -349,7 +363,7 @@ variables are affected by the repository files maintained in
 <I>/etc/sbopkg/repos.d.</I>
 
 Please see the
-<I>README-repos.d</I>
+<I>README-repos</I>
 
 document in the
 <B>sbopkg</B>
@@ -367,7 +381,7 @@ Path.
 <DT><DD>
 This option allows the user to set the location of the local mirrors of
 the remote repositories.
-Currently, the size of a local copy of the SBo repository is about 93M.
+Currently, the size of a local copy of the SBo repository is about 96M.
 <DT><DD>
 The default assignment is:
 <DT><DD>
@@ -512,20 +526,6 @@ flags (options) that are used by
 
 Users are cautioned against making any changes to the default values
 since new flags may or may not work.
-Note: the
-<B>wget</B>
-
-command in
-<B>sbopkg</B>
-
-already uses the
-<B>-O</B>
-
-flag, so there is no need to add that to the
-<B>WGETFLAGS</B>
-
-option.
-Changing most of these default options is not recommended.
 However,
 <B>--timeout</B>
 
@@ -711,27 +711,30 @@ settings if this is required for the build.
 
 <DD>
 File to specify configuration options.
-<DT><I>/etc/sbopkg/renames.d/50-default</I>
+<DT><I>~/.sbopkg.conf</I>
 
 <DD>
-Default file that lists software in the SBo repository that has been
+File to override system configuration options.
-renamed.
+<DT><I>/etc/sbopkg/renames.d/*.renames</I>
+
+<DD>
+Files that list software in the SBo repository that has been renamed.
 See the
-<I>README-renames.d</I>
+<I>README-renames</I>
 
 document in the
 <B>sbopkg</B>
 
 documentation directory for more information.
-<DT><I>/etc/sbopkg/repos.d/{40-sbo.repo,50-sb64.repo,60-local.repo}</I>
+<DT><I>/etc/sbopkg/repos.d/*.repo</I>
 
 <DD>
-Three default files for various types of
+Files for various types of
 <B>sbopkg</B>
 
 repositories.
 See the
-<I>README-repos.d</I>
+<I>README-repos</I>
 
 document in the
 <B>sbopkg</B>
@@ -770,7 +773,7 @@ slakmagik
 
 <B><A HREF="http://localhost/cgi-bin/man/man2html?1+wget">wget</A></B>(1),
 
-<I>/usr/doc/sbopkg-0.34.1/*</I>
+<I>/usr/doc/sbopkg-0.35.0/*</I>
 
 
 <P>
@@ -793,6 +796,6 @@ slakmagik
 This document was created by
 <A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
 using the manual pages.<BR>
-Time: 04:21:25 GMT, February 05, 2011
+Time: 02:57:11 GMT, April 28, 2011
 </BODY>
 </HTML>

tools/sbopkg-help

@@ -1,4 +1,4 @@
-sbopkg 0.34.1
+sbopkg 0.35.0
 Usage: sbopkg [OPTIONS] <packagename(s)>
 Options are:
   -b pkg/queue(s) Build the specified package(s). If one or more queuefiles
@@ -19,7 +19,10 @@ Options are:
   -q              Quiet some of the command-line output.
   -r              Sync the remote repository with the local mirror and then
                   quit.
-  -R              Preview the READMEs before starting the build process.
+  -R              When combined with -b or -i, preview the READMEs of the
+                  packages to be built/installed before starting the build
+                  process. When combined with -p, show the READMEs of all
+                  installed packages from the active repo.
   -s package(s)   Specific search by specific package and, if found,
                   display package information.
   -u              Check for an update to sbopkg.

tools/sbopkg8.html

@@ -3,7 +3,7 @@ Content-type: text/html
 <HTML><HEAD><TITLE>Manpage of SBOPKG</TITLE>
 </HEAD><BODY>
 <H1>SBOPKG</H1>
-Section:  (8)<BR>Updated: February 2011<BR><A HREF="#index">Index</A>
+Section:  (8)<BR>Updated: April 2011<BR><A HREF="#index">Index</A>
 <A HREF="http://localhost/cgi-bin/man/man2html">Return to Main Contents</A><HR>
 
 
@@ -52,17 +52,20 @@ In order for
 <B>sbopkg</B>
 
 to be used, a configuration file must exist at
-<I>/etc/sbopkg/sbopkg.conf</I>.
+<I>/etc/sbopkg/sbopkg.conf</I>
 
-An initial install will provide the user with that file while upgrades
+and/or
-will add an
+<I>~/.sbopkg.conf</I>.
+
+An initial install will provide the user with the system file while
+upgrades will add an
 <I>/etc/sbopkg/sbopkg.conf.new</I>
 
 file with which the user may merge or replace the older version.
 See
 <B><A HREF="http://localhost/cgi-bin/man/man2html?5+sbopkg.conf">sbopkg.conf</A></B>(5)
 
-for more information about the configuration file.
+for more information about the configuration files.
 <P>
 
 <B>Sbopkg</B>
@@ -113,7 +116,7 @@ of
 <B>sbopkg</B>.
 
 Currently, the size of a local copy of the SBo repository is about
-about 93M.
+about 96M.
 The main menu also allows the user to view the SBo
 <I>ChangeLog</I>,
 
@@ -171,10 +174,7 @@ Finally, if
 is set to
 <B>YES</B>
 
-in the
+in a configuration file, a permanent log of the build process is saved.
-<I>sbopkg.conf</I>
-
-file then a permanent log of the build process is saved.
 See
 <B><A HREF="http://localhost/cgi-bin/man/man2html?5+sbopkg.conf">sbopkg.conf</A></B>(5)
 
@@ -246,18 +246,15 @@ and  will default to
 If the user wants
 <B>sbopkg</B>
 
-to use another editor, such as
+to use another editor or pager, then adding the requisite information in
-<B>nano</B>,
-
-then adding the requisite information in
 <I>~/.bashrc</I>,
 
 <I>/etc/profile</I>,
 
-or other similar configuration file to export
+or other similar configuration file (including
-<B>EDITOR</B>
+<B>sbopkg</B>'s
 
-will suffice.
+own configuration files) to export the relevant variable will suffice.
 
 <A NAME="lbAF">&nbsp;</A>
 <H2>OPTIONS</H2>
@@ -495,11 +492,25 @@ options is minimized.
 <DT><B>-R</B>
 
 <DD>
-Show all the
+When combined with
+<B>-b</B>
+
+or
+<B>-i</B>,
+
+view the
 <I>README</I>
 
-files of the queued packages before starting the build.
+files of the packages to be built/installed before starting the build
-This is useful when the user wants to make a final check.
+process.
+This is useful for making a final check.
+When combined with
+<B>-p</B>,
+
+view the
+<I>README</I>
+
+files of all installed packages from the active repo.
 
 <DT><B>-r</B>
 
@@ -551,8 +562,8 @@ or
 <I>bar</I>.
 
 <DT><DD>
-Note that shell metacharacters may be supplied in the arguments. For
+Note that shell metacharacters may be supplied in the arguments.
-instance,
+For instance,
 <DL COMPACT><DT><DD>
 <DL COMPACT>
 <DT><DD>
@@ -604,7 +615,7 @@ man page for more information about the ``local'' repository.
 The
 <I>VERSION</I>
 
-format is repository/branch (e.g., SBo/13.1).
+format is repository/branch (e.g., SBo/13.37).
 If the repository is omitted,
 <B>sbopkg</B>
 
@@ -631,27 +642,30 @@ on stdout.
 
 <DD>
 Default system-wide file to specify configuration options.
-<DT><I>/etc/sbopkg/renames.d/50-default</I>
+<DT><I>~/.sbopkg.conf</I>
 
 <DD>
-Default file that lists software in the SBo repositories that has been
+File to override system configuration options.
-renamed.
+<DT><I>/etc/sbopkg/renames.d/*.renames</I>
+
+<DD>
+Files that list software in the SBo repositories that has been renamed.
 See the
-<I>README-renames.d</I>
+<I>README-renames</I>
 
 document in the
 <B>sbopkg</B>
 
 documentation directory for more information.
-<DT><I>/etc/sbopkg/repos.d/{40-sbo.repo,50-sb64.repo,60-local.repo}</I>
+<DT><I>/etc/sbopkg/repos.d/*.repo</I>
 
 <DD>
-Three default files for various types of
+Files for various types of
 <B>sbopkg</B>
 
 repositories.
 See the
-<I>README-repos.d</I>
+<I>README-repos</I>
 
 document in the
 <B>sbopkg</B>
@@ -694,7 +708,7 @@ slakmagik
 
 <B><A HREF="http://localhost/cgi-bin/man/man2html?1+vi">vi</A></B>(1),
 
-<I>/usr/doc/sbopkg-0.34.1/*</I>
+<I>/usr/doc/sbopkg-0.35.0/*</I>
 
 
 <P>
@@ -717,6 +731,6 @@ slakmagik
 This document was created by
 <A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
 using the manual pages.<BR>
-Time: 04:21:25 GMT, February 05, 2011
+Time: 02:57:11 GMT, April 28, 2011
 </BODY>
 </HTML>