From 482aed1f9be4d8a7b51f81a45f98978116656e5c Mon Sep 17 00:00:00 2001 From: slakmagik Date: Sat, 5 Feb 2011 03:18:48 +0000 Subject: [PATCH] revise documentation Major reformatting and some textual modifications of src/usr/doc/sbopkg-*/* including breaking out the credits from the script into a detailed THANKS file, renaming and reformatting ChangeLog.txt into NEWS, renaming the sample queuefiles from *.sqf to *.sqf.sample, and making lesser modifications to all the other docs. --- src/usr/doc/HACKING | 445 ++-- src/usr/doc/KNOWN_ISSUES | 85 +- src/usr/doc/NEWS | 2026 ++++++++++------- src/usr/doc/README | 127 +- src/usr/doc/README-queuefiles | 129 +- src/usr/doc/README-renames.d | 28 +- src/usr/doc/README-repos.d | 81 +- src/usr/doc/THANKS | 71 + src/usr/doc/TODO | 54 +- .../{abiword.sqf => abiword.sqf.sample} | 0 .../{audacity.sqf => audacity.sqf.sample} | 0 ...drip_build.sqf => dvdrip_build.sqf.sample} | 2 +- ...ghtenment.sqf => enlightenment.sqf.sample} | 0 .../{ffmpeg.sqf => ffmpeg.sqf.sample} | 0 ...mpeg_build.sqf => ffmpeg_build.sqf.sample} | 0 ...gnome-print.sqf => gnome-print.sqf.sample} | 0 .../{gnucash.sqf => gnucash.sqf.sample} | 0 .../{gpodder.sqf => gpodder.sqf.sample} | 0 ...t-openshot.sqf => mlt-openshot.sqf.sample} | 2 +- .../{multimedia.sqf => multimedia.sqf.sample} | 0 ...tave_build.sqf => octave_build.sqf.sample} | 0 ...enbox-plus.sqf => openbox-plus.sqf.sample} | 0 .../{openshot.sqf => openshot.sqf.sample} | 4 +- ...-desktop.sqf => simple-desktop.sqf.sample} | 0 ...e_build.sqf => transcode_build.sqf.sample} | 0 src/usr/sbin/sbopkg | 15 - 26 files changed, 1741 insertions(+), 1328 deletions(-) create mode 100644 src/usr/doc/THANKS rename src/usr/doc/queuefiles/{abiword.sqf => abiword.sqf.sample} (100%) rename src/usr/doc/queuefiles/{audacity.sqf => audacity.sqf.sample} (100%) rename src/usr/doc/queuefiles/{dvdrip_build.sqf => dvdrip_build.sqf.sample} (90%) rename src/usr/doc/queuefiles/{enlightenment.sqf => enlightenment.sqf.sample} (100%) rename src/usr/doc/queuefiles/{ffmpeg.sqf => ffmpeg.sqf.sample} (100%) rename src/usr/doc/queuefiles/{ffmpeg_build.sqf => ffmpeg_build.sqf.sample} (100%) rename src/usr/doc/queuefiles/{gnome-print.sqf => gnome-print.sqf.sample} (100%) rename src/usr/doc/queuefiles/{gnucash.sqf => gnucash.sqf.sample} (100%) rename src/usr/doc/queuefiles/{gpodder.sqf => gpodder.sqf.sample} (100%) rename src/usr/doc/queuefiles/{mlt-openshot.sqf => mlt-openshot.sqf.sample} (96%) rename src/usr/doc/queuefiles/{multimedia.sqf => multimedia.sqf.sample} (100%) rename src/usr/doc/queuefiles/{octave_build.sqf => octave_build.sqf.sample} (100%) rename src/usr/doc/queuefiles/{openbox-plus.sqf => openbox-plus.sqf.sample} (100%) rename src/usr/doc/queuefiles/{openshot.sqf => openshot.sqf.sample} (96%) rename src/usr/doc/queuefiles/{simple-desktop.sqf => simple-desktop.sqf.sample} (100%) rename src/usr/doc/queuefiles/{transcode_build.sqf => transcode_build.sqf.sample} (100%) diff --git a/src/usr/doc/HACKING b/src/usr/doc/HACKING index b63caef..9b75fbd 100644 --- a/src/usr/doc/HACKING +++ b/src/usr/doc/HACKING @@ -1,302 +1,337 @@ -# $Id$ -# vim:set ft=: +SBOPKG HACKING -We welcome contributions to sbopkg. If you have a bug report or a feature -request, please go to the project's Google Code site and use the 'Issue -Tracker' so your bug report/feature request does not get lost: -http://code.google.com/p/sbopkg/issues/list. If you cannot post to the Issue -Tracker, please consider joining the sbopkg mailing list and post your bug -report or feature request there: -http://sbopkg.org/mailman/listinfo/sbopkg-users +INTRODUCTION -As far as hacking on the code, the best thing to do is to checkout the -latest version from subversion (see http://www.sbopkg.org/devel.php) and then -contribute patches with something like 'diff -Naurp' or 'svn diff -x -p'. -Please try to make each patch do one thing and do it well. Also, please do -not combine whitespace or other non-functional changes with functional changes -in the same patch (unless the same lines contain both types of changes). -Basically, just use common sense -- a one line functional change and a typo -correction can be a single patch, rather than two one-line patches. + We welcome contributions to sbopkg. If you have a bug report or a + feature request, please go to the project's Google Code site and use + the Issue Tracker so your bug report/feature request does not get + lost. -Please make sure your patches conform to these stylistic points: + http://code.google.com/p/sbopkg/issues/list -* Code in Bash. + If you cannot post to the Issue Tracker, please consider joining the + sbopkg mailing list and post your bug report or feature request + there. -* Wrap lines at 78 columns. + http://sbopkg.org/mailman/listinfo/sbopkg-users -* Expand tabs to spaces. + If you cannot join the mailing list, there is an #sbopkg channel on + the freenode IRC network. -* Indent with four spaces at all levels. + As far as hacking on the code, the best thing to do is to checkout + the latest version from subversion using something like the + following command: -* Use '[[' wherever possible, vs. '['. + svn checkout http://sbopkg.googlecode.com/svn/trunk \ + sbopkg-contrib -* Negate tests like '[[ ! foo ]]' instead of '! [[ foo ]]'. + (See http://www.sbopkg.org/devel.php for more information.) Then + contribute patches with something like 'diff -Naurp' or 'svn diff -x + -p'. -* write functions in the form: + Please try to make each patch do one thing and do it well. Also, + please do not combine whitespace or other non-functional changes + with functional changes in the same patch (unless the same lines + contain both types of changes). Basically, just use common sense -- + a one line functional change and a typo correction can be a single + patch, rather than two one-line patches. - my_func() { - # comments here +PATCH/SCRIPT GUIDELINES - stuff - } + * Write code compatible with bash 3.1.17 to the latest stable + version. -* In general, variables do not need to be quoted except in cases where the - variable may contain spaces. If unsure, quote the variable just to be safe. + * Wrap lines at 78 columns. -* Use variable names in the form: MYVARNAME except when MYVARNAME is - ambiguous or made of more than two or three components. In that case, use - MY_VAR_NAME. + * Expand tabs to spaces. -* If you are going to need a bit of data repeatedly, try to grab it once and - assign it to a variable rather than re-obtaining it. + * Indent with four spaces at all levels. -* If you are going to use a combination of several concatenated variables - multiple times, consider creating a new variable like: - 'NEWVAR=$OLDVAR1-$OLDVAR2-$OLDVAR3'. + * Use '[[' wherever possible, vs. '['. -* Prefer the style: + * Negate tests like '[[ ! foo ]]' instead of '! [[ foo ]]'. - if [[ foo ]]; then - bar - fi + * write functions in the form: - instead of: + my_func() { + # comments here - if [[ foo ]] - then - bar - fi + stuff + } - (same goes with 'for' and 'while' loops). + * In general, variables do not need to be quoted except in cases + where the variable may contain spaces. If unsure, quote the + variable just to be safe. -* The spacing in numeric 'for' loops is: + * Use variable names in the form: MYVARNAME except when MYVARNAME is + ambiguous or made of more than two or three components. In that + case, use MY_VAR_NAME. - for ((i=0; i<=10; i++)); do + * If you are going to need a bit of data repeatedly, try to grab it + once and assign it to a variable rather than re-obtaining it. -* Prefer shell redirection to piping 'echo' or 'cat'. + * If you are going to use a combination of several concatenated + variables multiple times, consider creating a new variable like: + 'NEWVAR=$OLDVAR1-$OLDVAR2-$OLDVAR3'. -* Prefer bash variable substitutions to 'tr', 'sed', 'cut', ..., when - possible. + * Prefer the style: -* Error messages should go to standard error: + if [[ foo ]]; then + bar + fi - echo "Things have gone nuts" >&2 + instead of: -* Make return codes meaningful (i.e. if you redirect to stderr try - to return or exit 1 at the same time). + if [[ foo ]] + then + bar + fi -* When both 'foo' is simple and 'bar' is a one-liner, the conditional form: + (same goes with 'for' and 'while' loops). - [[ foo ]] && bar + * The spacing in numeric 'for' loops is: - can be used instead of: + for ((i=0; i<=10; i++)); do - if [[ foo ]]; then - bar - fi + * Prefer shell redirection to piping 'echo' or 'cat'. - However, do not use the following form: + * Prefer bash variable substitutions to 'tr', 'sed', 'cut', ..., + when possible. - if [[ foo ]]; then bar; fi + * Error messages should go to standard error: -* Use: + echo "Things have gone nuts" >&2 - [[ foo ]] || bar + * Make return codes meaningful (i.e. if you redirect to stderr try + to return or exit 1 at the same time). - only when 'bar' is simple and supposed to be executed on error conditions - (i.e. almost never) + * When both 'foo' is simple and 'bar' is a one-liner, the + conditional form: -* Multiple conditionals can be done either as: + [[ foo ]] && bar - if [[ $CHOICE == 1 ]] || [[ $CHOICE == 0 && -z $CUSTOMOPTS ]]; then + can be used instead of: - or + if [[ foo ]]; then + bar + fi - if [[ $CHOICE == 1 || ( $CHOICE == 0 && -z $CUSTOMOPTS ) ]]; then + However, do not use the following form: - but not: + if [[ foo ]]; then bar; fi - if [ $CHOICE = 1 ] || [ $CHOICE = 0 -a "$CUSTOMOPTS" = "" ]; then + * Use: - The reasons the third example is not as good as the first two are that it - uses single brackets instead of double brackets and uses '-a' instead of - '&&'. + [[ foo ]] || bar -* 'case' statements should be indented as: + only when 'bar' is simple and supposed to be executed on error + conditions (i.e. almost never) - case $FOO in - bar ) # Comment goes here - commands - ;; - baz* ) # Comment goes here - commands - ;; - esac + * Multiple conditionals can be done either as: - unless the statements can be short one-liners, in which case the form + if [[ $FOO == 1 ]] || [[ $FOO == 0 && -z $BAR ]]; then - case $FOO in - bar ) short_simple_command ;; - baz* ) simple_short_command; exit ;; - esac + or - is preferred. + if [[ $FOO == 1 || ( $FOO == 0 && -z $BAR ) ]]; then -* Avoid chaining commands with ';' (with the above exceptions). + but not: -* Declare local variables as such at the function start. + if [ $FOO = 1 ] || [ $FOO = 0 -a "$BAR" = "" ]; then -* Positional parameters to functions should be assigned to local variables, - one per 'local' statement, before declaring the other local variables (which - can share a single 'local' statement): + The reasons the third example is not as good as the first two are + that it uses single brackets instead of double brackets and uses + '-a' instead of '&&'. - local FILE="$1" - local DIR="$2" - local FOO BAR BAZ + * 'case' statements should be indented as: -* In general, when wrapping long lines, the part going on the next line should - be indented with 8 spaces if there is ambiguity so as to distinguish the - wrap from other lines before and after it. The same would be true for line - wraps in conditions. For example: + case $FOO in + bar ) # Comment goes here + commands + ;; + baz* ) # Comment goes here + commands + ;; + esac - if ASD || - FGH; then - echo "Success" - fi + unless the statements can be short one-liners, in which case the + form - as opposed to: + case $FOO in + bar ) short_simple_command ;; + baz* ) simple_short_command; exit ;; + esac - if ASD || - FGH; then - echo "Success" - fi + is preferred. - In the latter case, having 'FGH; then' at the same indent level as the echo - is ambiguous. On the other hand: + * Avoid chaining commands with ';' (with the above exceptions). - APP=$(grep foo \ - really/long/path/to/file) - if foo; then - echo "Success" - fi + * Declare local variables as such at the function start. - is ok since there really is no ambiguity. + * Positional parameters to functions should be assigned to local + variables, one per 'local' statement, before declaring the other + local variables (which can share a single 'local' statement): -* Prefer 'foo | bar' over 'foo |bar' or 'foo|bar'. However, if the line - barely goes over 78 columns, then removing spaces is OK to keep it on a - single line. In other words: + local FILE="$1" + local DIR="$2" + local FOO BAR BAZ - foo |bar |baz + * In general, when wrapping long lines, the part going on the next + line should be indented 8 spaces beyond the initial line if there + is ambiguity so as to distinguish the wrap from other lines before + and after it. The same would be true for line wraps in conditions. + For example: - is better than + if ASD || + FGH; then + echo "Success" + fi - foo | bar | - baz + as opposed to: -* When wrapping between two piped commands, the pipe should be the last - character of the former line. For example, prefer: + if ASD || + FGH; then + echo "Success" + fi - some stuff here foo | - bar + In the latter case, having 'FGH; then' at the same indent level as + the echo is ambiguous. On the other hand: - instead of: + APP=$(grep foo \ + really/long/path/to/file) + if foo; then + echo "Success" + fi - some stuff here foo \ - | bar + is ok since there really is no ambiguity. - when possible. + * Prefer 'foo | bar' over 'foo |bar' or 'foo|bar'. However, if the + line barely goes over 78 columns, then removing spaces is OK to + keep it on a single line. In other words: -* Always use $( ... ) instead of ` ... `. + foo |bar |baz -* 'Break' and 'continue' should never be used to influence a loop outside of - the function they belong to. + is better than -* Avoid indirect recursion (A calls B that calls A). + foo | bar | + baz -* [[ -z "$VAR" ]] vs. [[ ! "$VAR" ]] and [[ "$VAR" ]] vs. [[ -n "$VAR" ]]: - -n/-z should be used when $VAR contains a computational result and the other - form should be used where $VAR is a functional flag. For example: + * When wrapping between two piped commands, the pipe should be the + last character of the former line. For example, prefer: - VAR=$(grep "^something=" <$SBOPKG_RENAMES) - if [[ -z $VAR ]]; then + some stuff here foo | + bar - and + instead of: - if [[ $DIAG ]]; then + some stuff here foo \ + | bar -* For indices, use FILE and DIR instead of 'f' and 'd'. However, 'i' is OK as - a counter since that is fairly universal. + when possible. -* When deciding whether or not to use the =~ operator in [[ commands, make - sure that they work across bash 3.1, 3.2, and 4.0. This means the regexes - must be unquoted for bash >=3.2 and still work in bash 3.1 (i.e., no - 'foo|bar' expressions). + * Always use $( ... ) instead of ` ... `. ----------------------------- -Manual Page Style Guidelines ----------------------------- + * 'Break' and 'continue' should never be used to influence a loop + outside of the function they belong to. -* Separate all text header and section header requests with commented lines of - equal (=) signs. Separate all subsections and tagged paragraphs that serve - as subsections with commented lines of minus (-) signs. + * Avoid indirect recursion (A calls B that calls A). -* Leave no blank lines in the file. E.g., .PP will often serve under .SH and - .IP under .TP. + * [[ -z "$VAR" ]] vs. [[ ! "$VAR" ]] and [[ "$VAR" ]] vs. + [[ -n "$VAR" ]]: -n/-z should be used when $VAR contains a + computational result and the other form should be used where $VAR + is a functional flag. For example: -* Wrap lines at 72 columns and begin all sentences on new lines. + VAR=$(grep "^something=" <$SBOPKG_RENAMES) + if [[ -z $VAR ]]; then -* If variables are being used in the sense of their value, use $VAL but if - they are being used in reference to themselves, use VAR. + and -* Where sensible, try to make .TPs have a consistent indent. + if [[ $DIAG ]]; then -* Try to use standard headers where possible, filing other information - under subsections of the relevant section header. + * For indices, use FILE and DIR instead of 'f' and 'd'. However, 'i' + is OK as a counter since that is fairly universal. -* Add options as .TP 5 (or current default), with \- and bold options, - followed by italic replaceable arguments to those options or bold literal - arguments, if any. Brackets, bars, etc., should be regular font, though. + * When deciding whether or not to use the =~ operator in [[ + commands, make sure that they work across bash 3.1, 3.2, and 4.0. + This means the regexes must be unquoted for bash >=3.2 and still + work in bash 3.1 (i.e., no 'foo|bar' expressions). -* More generally, italicize filenames, URLs, replaceable terms (including - references to unspecified variable values ($VARs)). +MANUAL PAGE STYLE GUIDELINES -* Embolden variables (when used literally rather than replaceably), option - values, programs, program flags, and all references to sbopkg itself. + * Separate all text header and section header requests with + commented lines of equal (=) signs. Separate all subsections and + tagged paragraphs that serve as subsections with commented lines + of minus (-) signs. -* Make all option dashes in the form \- (or \-\-) unless in a code example. + * Leave no blank lines in the file. E.g., .PP will often serve under + .SH and .IP under .TP. -* Try to refer to the user as 'the user' rather than 'you'. + * Wrap lines at 72 columns and begin all sentences on new lines. -* Collect all referenced programs (unless used purely as an example) in the - SEE ALSO section. (The SEE ALSO section is not *limited* to referenced - programs, however.) + * If variables are being used in the sense of their value, use $VAL + but if they are being used in reference to themselves, use VAR. -* Try to be as specific as conveniently possible, where 'convenient' means to - generalize wherever constant updates might be necessary and such - generalization wouldn't compromise clarity and accuracy. + * Where sensible, try to make .TPs have a consistent indent. -* Use `` and '' for double-quotes so groff does the fancy stuff for ps output. + * Try to use standard headers where possible, filing other + information under subsections of the relevant section header. -* .EX doesn't seem to be very well supported or necessarily what is wanted - - code examples can be done with the following cookie-cutter code: - .RS - .IP \" or .PP or whatever's appropriate - .nf - \fCline_of_code\fP - .fi - .RE - If inline, at least embolden them so they're set off in ascii overstrike - output. + * Add options as .TP 5 (or current default), with \- and bold + options, followed by italic replaceable arguments to those options + or bold literal arguments, if any. Brackets, bars, etc., should be + regular font, though. - In command line examples, prefix the commands with the root prompt (#). + * More generally, italicize filenames, URLs, replaceable terms + (including references to unspecified variable values ($VARs)). -* Start configuration file option sections with a statement of type, a - description, and the following cookie-cutter code: - The default assignment is: - .IP - \fCdefault_assignment\fP + * Embolden variables (when used literally rather than replaceably), + option values, programs, program flags, and all references to + sbopkg itself. -* Try to refer to SlackBuilds as SlackBuilds rather than SlackBuild scripts - unless for a particular need (for instance, explaining what SlackBuilds are - in the first place). And once SlackBuilds.org has been properly introduced, - try to refer to it as SBo. + * Make all option dashes in the form \- (or \-\-) unless in a code + example. + + * Try to refer to the user as 'the user' rather than 'you'. + + * Collect all referenced programs (unless used purely as an example) + in the SEE ALSO section. (The SEE ALSO section is not *limited* to + referenced programs, however.) + + * Try to be as specific as conveniently possible, where 'convenient' + means to generalize wherever constant updates might be necessary + and such generalization wouldn't compromise clarity and accuracy. + + * Use `` and '' for double-quotes so groff does the fancy stuff for + ps output. + + * .EX doesn't seem to be very well supported or necessarily what is + wanted - code examples can be done with the following + cookie-cutter code: + + .RS + .IP \" or .PP or whatever's appropriate + .nf + \fCline_of_code\fP + .fi + .RE + + If inline, at least embolden them so they're set off in ascii + overstrike output. + + In command line examples, prefix the commands with the root prompt + (#). + + * Start configuration file option sections with a statement of type, + a description, and the following cookie-cutter code: + + The default assignment is: + .IP + \fCxxxVARxxx\fP + + ('xxxVARxxx' will be replaced by whatever value VAR has in the + default sbopkg.conf file.) + + * Try to refer to SlackBuilds as SlackBuilds rather than SlackBuild + scripts unless for a particular need (for instance, explaining + what SlackBuilds are in the first place). And once SlackBuilds.org + has been properly introduced, try to refer to it as SBo. diff --git a/src/usr/doc/KNOWN_ISSUES b/src/usr/doc/KNOWN_ISSUES index ba2e9a9..dc557fa 100644 --- a/src/usr/doc/KNOWN_ISSUES +++ b/src/usr/doc/KNOWN_ISSUES @@ -1,60 +1,67 @@ -The following are the known user-visible issues in sbopkg or upstream in the -tools it uses: +SBOPKG KNOWN ISSUES -* in dialog '--inputbox' widgets (the boxes the user types text into) the - left/right arrows do not navigate in a button context. (They do navigate in - an editing context.) This does not seem to be an sbopkg issue. +The following are the known user-visible issues in sbopkg or upstream in +the tools it uses: - Workaround: navigate with up/down arrows or tab/shift-tab - Note: there is a newer dialog version available which fixes this issue, but - we encourage users to stick with the dialog Slackware ships. +* In dialog '--inputbox' widgets (the boxes the user types text into) + the left/right arrows do not navigate in a button context. (They do + navigate in an editing context.) This does not seem to be an sbopkg + issue. -* if dialog is run in a terminal emulator and the user exits using the - window manager's 'close' (or equivalent) button/command, dialog may hang, - using full CPU capacity and have to be killed. This does not seem to be an - sbopkg issue. + Workaround: navigate with up/down arrows or tab/shift-tab Note: there + is a newer dialog version available which fixes this issue, but we + encourage users to stick with the dialog Slackware ships. + +* If dialog is run in a terminal emulator and the user exits using the + window manager's 'close' (or equivalent) button/command, dialog may + hang, using full CPU capacity and have to be killed. This does not + seem to be an sbopkg issue. Details: http://code.google.com/p/sbopkg/issues/detail?id=30 - Workaround: use dialog's own exit methods - its buttons, escape, ^C, etc. + Workaround: use dialog's own exit methods - its buttons, escape, ^C, + etc. -* when checking for updates, for some packages sbopkg may tell you - "Note: repo version not obtainable by standard method, may be inaccurate.". - This happens with packages whose version is very difficult/impossible to - determine without actually building the package -- one example of this at - the time of writing is the google-chrome package, whose version is picked - from the source archive itself. In these cases sbopkg falls back to trusting - the .info file, and warns the user about it. +* When checking for updates, for some packages sbopkg may tell you + "Note: repo version not obtainable by standard method, may be + inaccurate.". This happens with packages whose version is very + difficult/impossible to determine without actually building the + package -- one example of this at the time of writing is the + google-chrome package, whose version is picked from the source archive + itself. In these cases sbopkg falls back to trusting the .info file, + and warns the user about it. Workaround: none needed -* while you are free to set PAGER to any value you like, be aware that some - pagers and settings may cause unexpected behavior. An example is if paging - less than a screenful of output from the uninstalled packages option - the - default pager 'more' will exit, displaying the packages and a prompt. 'less' - may prompt for exit and clear its output on exit. Setting the environment - variable LESS to include the F and X options will make less behave more like - more in this instance. Other pagers may have other behaviors and other means - of configuration. +* While you are free to set PAGER to any value you like, be aware that + some pagers and settings may cause unexpected behavior. An example is + if paging less than a screenful of output from the uninstalled + packages option - the default pager 'more' will exit, displaying the + packages and a prompt. 'less' may prompt for exit and clear its output + on exit. Setting the environment variable LESS to include the F and X + options will make less behave more like more in this instance. Other + pagers may have other behaviors and other means of configuration. Workaround: pager-specific -* a few SlackBuild scripts in the slackbuilds.org repo have a source download - that is only available through an https download. By default, sbopkg will - not be able to download these sources. +* A few SlackBuild scripts in the slackbuilds.org repo have a source + download that is only available through an https download. By + default, sbopkg will not be able to download these sources. Workaround: add --no-check-certificate to WGETFLAGS in sbopkg.conf -* certain packages build kernel modules and need to (re)set the ARCH to 'x86' - on i?86 (32-bit) systems which may result in packages with 'x86' as the ARCH - in the file name, while sbopkg will display the specific ARCH of your system - (or the ARCH you've set) in certain cases, such as in widget titles. +* Certain packages build kernel modules and need to (re)set the ARCH to + 'x86' on i?86 (32-bit) systems which may result in packages with 'x86' + as the ARCH in the file name, while sbopkg will display the specific + ARCH of your system (or the ARCH you've set) in certain cases, such as + in widget titles. Workaround: none needed -* when using sbopkg to sync to SBo git repositories (which is possible but - unsupported) unexpected results may occur. See - http://code.google.com/p/sbopkg/issues/detail?id=47 - http://sbopkg.org/pipermail/sbopkg-users/2010-May/000477.html +* When using sbopkg to sync to SBo git repositories (which is possible + but unsupported) unexpected results may occur. + + Details: http://code.google.com/p/sbopkg/issues/detail?id=47 + http://sbopkg.org/pipermail/sbopkg-users/2010-May/000477.html Workaround: see above links diff --git a/src/usr/doc/NEWS b/src/usr/doc/NEWS index 3df8740..bd00074 100644 --- a/src/usr/doc/NEWS +++ b/src/usr/doc/NEWS @@ -1,925 +1,1191 @@ -Fri Nov 12 03:37:16 UTC 2010 -Sbopkg 0.34.0 released. This version contains the following fixes and -enhancements: +SBOPKG NEWS - * Revised man pages - these are very different and now document a couple of - previously undocumented things and are worth a (re-)read. Thanks to - Marie-Claude Collilieux for the French translations of these. - * The HACKING file now includes a man page style guide in addition to the - coding style guide. - * The LOGDIR variable has been removed from sbopkg.conf - DIR can be - specified in LOGFILE. - * The DEBUG variable has been renamed to DEBUG_UPDATES in sbopkg.conf. - * The default timeout values in {WGET,RSYNC}FLAGS have been raised from - 10/15 to 30 in sbopkg.conf. - * All parameters in sbopkg.conf now use default values only if the variable - hasn't been previously set (meaning they can all be overridden by passing - variables on the command line). - * sbopkg.conf has been reordered - this may make any merging that may be - needed more interesting this time but hopefully it's worth it. - * The directory initialization process has been changed - at first run or - otherwise when encountering missing directories, the user will now be - presented with a single list of them and a (C)reate/(A)bort prompt. - * The command line user interface has been overhauled in terms of more - consistent validated command line messages and prompts. - * Fix an ARCH display issue in the updates screen; thanks to alkos333, Marc - Payne, and David Spencer for confirming the issue and thanks to David - Spencer for testing the fix. - * Fixed bugs with dzen2 and *zarafa* not downloading/building properly. Note - that, while the changes fix these issues and should make it easier to - handle similar problems in the future, this change may introduce - regressions. If a download or build fails due to a downloaded tarball - looking something like 'blah?actual_tarball.tar.gz' or the like, please - report it to us. - * Fixed bugs with the '-s' option where only the first of multiple - arguments would be returned and where the command line select menu was - broken. Also where it and the -g flag might inadvertently expand globs - wrongly. - * It's now possible to specify the b,g,i,s flags multiple times. Previously - multiple arguments to these flags had to be quoted (-b "foo bar") but now - they can be given as '-b foo -b bar'. The original style is still - supported. - * With the new style of passing multiple arguments, it is now possible to - specify app-specific options on the command line. These take the form of, - e.g., '-i app1:opt1="foo bar":opt2=baz app2:opt=mu'. If that's cryptic, - see the manual for details. - * Users now have the option of interactively retrying a failed https - download, invoking wget with '--no-check-certificate', as this can be - caused by 'self-signed certificates' and the like. -+--------------------------+ -Thu May 27 18:13:59 UTC 2010 -Sbopkg 0.33.1 released. This version contains the following fixes and -enhancements: +sbopkg xxxVERSIONxxx (xxxDATExxx) - * The ARCH assignment was modified to accord with the latest SBo SlackBuild - template. - * Tweaked widgets in select_repository() (no or less scrolling) and - load_user_queue() (better button) and modified check_gpg() to not disrupt - the dialog interface with gpg output - * Revised the KNOWN_ISSUES file and other documentation -+--------------------------+ -Mon May 24 20:53:43 UTC 2010 -Sbopkg 0.33.0 released. This version contains the following fixes and -enhancements: + MODIFICATIONS - * Addressed an apparent bash 4.1 bug that causes the 'obsolete sources' - function to break. - * Addressed issue 44 where hitting ^C during the download of part of a queue - and restarting the queue could result in a download failure. Thanks to - slava18 for the report. - * Changed the menu order of the "Build options" dialog to default to using - "Saved" options rather than "None". - * Fixed issue 45 where packages with '+' in the name were not properly - detected in some cases. Thanks to skalkoto for the report. - * Added a help item to the main menu of the dialog interface with pointers - to documentation and other resources. - * Added an option to print the version of sbopkg. We try not to change the - meaning of flags but note that this does change what was the '-v' flag to - '-V' and now uses '-v' for its customary 'version' purpose. Note that the - new -V flag now accepts a '?' argument (sbopkg -V ?) which will display - the list of valid repositories. - * Tweak the logic re determining ARCH and modify some ARCH-related - evals and conditionals in check_for_updates and info_item. - * Fixed a bug which could result in some sources being missed when checking - for obsolete sources. - * Added a command line option '-P' to access the 'remove uninstalled - packages' function which had previously only been accessible from the - dialog interface. - * Miscellaneous tweaks in preparation for release and to bring in line with - Slackware 13.1. -+--------------------------+ -Fri Mar 5 21:29:21 UTC 2010 -Sbopkg 0.32.0 released. This version contains the following fixes and -enhancements: + * Revision of documentation. Major reformatting and some textual + modifications of /usr/doc/sbopkg-*/* including breaking out + the credits in the script into a detailed THANKS file, + renaming and reformatting ChangeLog.txt into NEWS, renaming + the sample queuefiles from *.sqf to *.sqf.sample, and making + lesser modifications to all the other docs. - * Add several renames to 50-default renames file. - * Add support for UNSUPPORTED/UNTESTED packages in the SBo repo; thanks to - artourter for the bug report. - * Honor the TAG exported by the user; thanks to Matteo Bernardini for the - feature request. - * Fix issue where delete sources in package info item menu did not work in - some cases; thanks to artourter for the report, thanks to slakmagik for - the hard work in fixing this and thanks to Mauro for the review and - suggestions. - * Add the ability to skip the prompts for sbopkg's directory creations via - the new config file option MKDIR_PROMPT. This is useful, for example, if - you have some SBo/sbopkg directories on a temporary filesystem and don't - want to be bothered with repeated directory creation prompts. Thanks to - agikhan for the report. - * Address an issue where sbopkg could sometimes pick an older package to - present for installation rather than the most recent one; thanks to - artourter for the report. - * Prevent sbopkg from spitting error messages when trying to determine the - version of some packages (e.g. google-chrome, whose version is discovered - looking into the source package which can be missing). Thanks to alkos333 - for the bug report. - * Add ability to temporarily change $ARCH in the 'options' submenu. -+--------------------------+ -Sun Nov 1 02:54:29 UTC 2009 -Sbopkg 0.31.0 released. This version contains the following fixes and -enhancements: + BUGFIXES - * Fix typo in 50-default renames file. - * Fix the "Uncheck installed" feature. The code apparently worked fine even - without the fix. Spotted by slakmagik. - * Add $ARCH information in dialog backtitles. - * Add ":force" to sbopkg.conf WGETFLAGS --progress=bar to correctly - display the wget progress bar; thanks to happyslacker for nudging me on - this issue again. - * Fix an issue with the build options dialog menu where selecting 'None' - would not work; thanks to happyslacker for the bug report. - * Add the ability to uninstall SBo packages from the dialog interface that - lists installed packages. Thanks to pokipoki08 for the suggestion. - * Fix an incompatibility regarding the way bash 3.1, 3.2, and 4.0 handle the - RHS of [[ commands using the =~ operator which broke the repo file - validation, among other things. Thanks to SiegeX, Zmyrgel, and BCarey for - the reports and suggestions. - * Add the ability to run multiple sbopkg instances simultaneously. This has - been suggested many times in the past. Users should read the sbopkg.conf - man page before using this option (which is disabled by default). - * Be more strict validating YES/NO configuration variables. - * Add a KNOWN_ISSUES file - if you encounter a bug, check this file before - reporting it to see if it's known and if there's a workaround. - * Modify sspm to be root-only and change the default checkout location. In - case it isn't obvious, this means the checkout will be root-owned if it - isn't already. - * Fix cosmetic bug where ARCH and BUILD were not displaying correctly in - list of updates on x86_64. - * Add a dialog and cli option to show all READMEs for the queued packages. - This can come handy to do "final checks" on the active queue before - starting the build process. - * Reworked the options selection menu to avoid seeing only a truncated set - of the actual options; thanks to Erik Hanson for the bug report. - * Work around build issues caused by custom LC_COLLATE values. - * Add tint=tint2 to /etc/sbopkg/renames.d/50-default file. - * Prevent an infinite download loop by modifying get_source() and - check_source(); make sure that we do try to guess about the file name in a - DOWNLOAD/filename mismatch but only when we absolutely have to, by - modifying get_source_names(). Thanks to godling for noticing the problem. - * The 'check for updates' function now always lists apparent downgrades, - since it sometimes can mistakenly classify an upgrade as a downgrade - (e.g. version 1.0.1 looks older than 1.0-rc2 to sbopkg). The apparent - downgrades are added to the queue but are disabled by default. -+--------------------------+ -Fri Aug 28 17:34:35 UTC 2009 -Sbopkg 0.30.1 released. This version contains the following fixes and -enhancements: + * Fixed issue where MKDIR_PROMPT was being ignored. Thanks to + catkin for raising this issue. - * Fix the updates code for the 13.0 repo; thanks to everybody who - contacted us about this issue. - * Fix the $SBOPKGTMP sanity check. Thanks to Ken Roberts for raising the - issue. - * Update the renames file. -+--------------------------+ -Mon Aug 24 17:28:48 UTC 2009 -Sbopkg 0.30.0 released. This version contains the following fixes and -enhancements: + * Fixed issue where -o would wrongly produce no output. Thanks + to ArTourter for raising this issue and to Mauro Giachero for + the patch. - * Move sbopkg to /usr/sbin; update sbopkg.SlackBuild and sspm to reflect - /usr/sbin. - * Change default directory paths in sbopkg.conf.new; add new variable - SBOPKGTMP, which will be used to store sbopkg-related temp files; also - add new variable LOGDIR which will contain any sbopkg-related log files. - * Remove code related to user-mode support; sbopkg must now be run as - root in all cases; add single check at start of script to make sure we - are root. - * Apply a major code cleanup that touches just about every part of sbopkg. - This cleanup makes the code more readable, manageable, and less bug-prone. - Several bugs were fixed as part of this cleanup, and the cleanup will ease - further development and debugging efforts. - * Remove some useless code from check_for_latest and also fix the - download folder for sbopkg updates. Thanks to David Somero for the bug - report. - * Re-implement the code that checks for renamed software; fix upgrading - of renamed packages; thanks to Phillip Warner for raising the issues - with the older code; thanks to Mauro Giachero for working on these fixes. - * Fix a tr invocation issue where in certain instances, sbopkg would not run - from certain directories; thanks to Marie-Claude Collilieux for the bug - report. - * Alter sed expression in download code to work around calcurse filename - idiosyncrasy; thanks to Glenn Becker for the bug report. - * Move French man pages into correct /usr/man/fr* location and remove them - from the /docs directory; update French man pages; thanks to - Marie-Claude Collilieux. - * Remove a stale 'find' call, which slightly improves the update feature. - * Add acroread->adobe-reader, GNOME-Colors->gnome-colors, wbxml2->libwbxml - and museek-plus->museek+ renames. - * Display a message when no packages are installed instead of doing nothing. - * Properly quote the current working directory variable in the event there - are spaces in the directory name. - * Fix a bug where 'sbopkg -c -v local' would display a dialog even though - running in cli mode. - * Fix issue where the 'games' directory was non-browsable due to a - slack-desc file containing double-quotes in the first line; thanks to - Glenn Becker for the original bug report. - * Implement configurable repository support by introducing a new - /etc/sbopkg/repos.d directory where separate repositories files can be - maintained and also by adding support for git-based repositories. The - Slamd64Builds repository is now listed, to the joy of all the Slamd64 - users out there. Add a new document README-repos.d that explains how - these repository files work. - * 'Nice' the build process so as to improve sbopkg's resource utilization. - * Fix a few issues regarding user sbopkg.conf files. - * Move sbopkg-renames to new /etc/sbopkg/renames.d/50-default to manage - multiple renames files. Thanks to Robby Workman for the suggestion. Add - new document README-renames.d that explains how this works. - * Add support for new *.txz, *.tlz, and *.tbz Slackware package extensions. - * Rewrite several portions of the process_queue function in order to - properly handle certain items by the caller; clean up and improve the - logging displayed during the build process. - * Require build queuefiles have a '.sqf' file extension. - * Add a sanity check for files in sbopkg's temp directory. - * Cleanup several of the functions related to editing the .info and - SlackBuild files to remove code duplication; also cleanup and fix issues - associated with the two primary search functions, and improve file cleanup - for these search-related functions. - * Fix issue where MD5SUM checking would fail when certain upstream packages - do not change source file name on version updates by adding in an extra - check for existing sources. Additionally, add an option to retry a source - download in the event of an MD5SUM failure to avoid having to restart a - build. Thanks to David Spencer for raising these issues and thanks to - Mauro Giachero for the fixes and improvements. - * Create a ChangeLog.txt for git repos on the fly. - * Remove usage of ARCH in preparation for Slackware64 support. - * Remove obsolete load_backup_queue. - * Improve and fix some issues with the search functions and leaking - variables. - * Change queuefile format. No longer will the queuefile format be 'APP - VERSION ON/OFF' but instead will simply be one 'APP' per line. If a user - wants an APP to be deselected in the dialog menus, simply put a '-' in - front of it, e.g. '-APP'. This should make creating, using, and sharing - queuefiles much easier and more intuitive. - * Add ability to load more than one queuefile at a time when building - from command line interface. - * The info_item dialog now shows non-SBo installed packages and gained a - more robust approach to finding both the installed package names and - the available packages in $OUTPUT. - * Add ability to dump all installed packages into a build queue. This is an - alphabetical list, so shuffling/reordering of the queue will be necessary - in order to list the dependencies correctly, but at least this will give - users a head start on setting up a large build queue. - * The process of searching for obsolete source archives can now be - interrupted with ESC. - * Add several new functions related to checking GPG-signed tarballs, such as - those that SlackBuilds.org provides. Sbopkg will now automatically check - these tarballs when building or installing a package. Additionally, there - are two new menu items in info_item that allow the user to check the GPG - signature or re-extract the GPG-signed tarball. - * Add ability to have recursive queuefiles, so one queuefile named - "foo.sqf" may have an entry "@bar" in which case as the foo.sqf - queuefile is parsed, it will recursively go down into the 'bar.sqf' - queuefile as well. The '@' symbol is used in front of an entry in a - queuefile to denote another queuefile. - * Remove the old "$APP $VERSION$BUILD $ONOFF" format for the temporary queue - and instead make all queue formats "$APP" only. This simplifies some code - and results in a small speed increase. - * Exit edit_build_queue menu with 'ESC'; thanks to Nille for the bug report. - * Modify do_install() to correctly invoke upgradepkg to avoid a fairly rare - but serious case of removing the wrong package; thanks to NaCl for the - bug report. - * Add ability to pass build options in a queuefile when separated by a pipe - character, i.e. app | FOO=yes BAR=no means app will be built with FOO and - BAR build options set as indicated. - * Fix rare issue where incorrect file was upgraded; thanks to neonflux for - the bug report. - * Fix issue where custom build options may not be correctly exported. - * Add a 'diff' entry to the script customization menu. - * Add in 'uname -m' test for x86_64 and if so, set ARCH to x86_64. - * Set default SBo repo to 13.0; add 13.0 repo to - /etc/sbopkg/repos.d/40-sbo.repo. - * Add support for multiple architectures and multiple source files. This - makes sbopkg able to handle the new features that SlackBuilds.org admins - are preparing for the Slackware 13.0 release. - * Add option to retry a failed build. Thanks to Zordrak for suggesting this - feature. - * Add CLEANUP configuration variable, which when set to YES tells sbopkg to - delete the extracted sources, and all the associated "residuals" of the - build, as soon as the build is finished. Thanks to Marco Bonetti and - Gregory Tourte for the suggestion and the nice discussion. - * Add a function to delete obsolete (not installed) packages from $OUTPUT. - Thanks to alkos333 for the idea. - * Reorganize the queue editing functions a bit for a better user interface; - 'view queue' now only shows the queue; new 'sort' and 'remove' queue menu - items now handle the editing functions; thanks to Pierre Cazenave for the - suggestion. - * Add dialog notification of whether a queued package is installed. - * Add a dialog option to automatically uncheck installed packages from the - active queue, together with a command line option -k that automatically - skips such packages when building with -b or -i. - * Add ability to 'invert' all selected/deselected in the clear cache and - obsolete sources and packages dialogs; thanks to dive for the suggestion. -+--------------------------+ -Thu Feb 26 14:48:54 UTC 2009 -Sbopkg 0.27.0 released. This version contains the following fixes and -enhancements: + * Fixed issue where TAG would sometimes not appear in the final + package. Thanks to chytraeus for raising this issue. - * Commit a patch that adds a new sbopkg.conf configuration variable, - QUEUEDIR, where users can define where saved queues are stored; also, when - the user wants to load a saved queue, show a list of available saved - queues; thanks to slakmagik for the patch. - * Add ability to search for keywords in the README files using regular - expressions; this new 'string search' can also be narrowed to only search - installed packages; thanks to slakmagik for the original patch and - implementation and thanks to both slakmagik and Mauro Giachero for - cleaning it up and addressing minor issues before the commit. - * Commit a cleanup/misc patch from slakmagik that removes some useless code - and fixes some style issues; thanks to slakmagik for the patch. - * Allow user to interrupt/abort the update progressbar by pressing ESC; - thanks to Mauro Giachero for the feature. - * Assorted menu navigation fixes, and document -p switch in sbopkg(8) man - page; thanks to Mauro Giachero for these improvements. - * Add ability to view a diff of an edited .info or SlackBuild file before - choosing which one to use; this feature adds two configuration variables - to the sbopkg.conf file: DIFF and DIFFOPTS; thanks to Phillip Warner for - the suggestion and thanks to Mauro Giachero for helping debug/improve my - original implemenation. - * Add ability to view more files in each application's folder, i.e. - doinst.sh, or *.desktop files; thanks to Phillip Warner for the suggestion - and thanks to slakmagik for the patch implementing this feature. - * Rework the check for root:root permissions when installing packages; now, - if the package does not have root:root permissions, sbopkg will display - the output of ls -l and ask if the user wishes to install or - abort, rather than only aborting. - * Allow the usage of the -d, -f and -v command-line options in dialog mode, - and output an error message when the command line contains unrecognized - tokens. - * Move the -q option to -g (general search) in order to make way for -q, - 'quiet mode' where the output of some of the command line options (i.e. - the command line progressbar) can be minimized. More quieting will likely - occur in future releases. Thanks to alkos333 for the feature request. - * Implement a workaround so that the dialog interface now works better with - GNU Screen and rxvt-based terminals. Thanks to Phillip Warner for raising - the issue and thanks to Mauro Giachero for working on the implementation. - * Include a French translation of the two sbopkg man pages. For now, these - man pages will be included in the /doc directory until I have time to - figure out whether they can be automatically installed in place of the - English ones depending on a locale setting. In any event, I would like to - extend my thanks to Marie-Claude Collilieux for providing this first - translation for sbopkg. I am sure folks will appreciate the work she put - into it. If anyone else wants to follow her lead and provide some other - translations, I would be happy to include them. Thanks Marie-Claude! - * Add in several patches from slakmagik that lets the user choose from saved - queues, modifies how the saved queues and backup queues work, and modifies - several other queue-related functions and menus. Many thanks to slakmagik - for his continually excellent contributions. - * Implement an 'autoqueue' by allowing the user to specify queue names to - '-b' and '-i' and by adding a -e option whereby the user can specify what - to do on errors (stop, ask, or continue). Thanks to Alan Hicks for - suggesting this feature and thanks to Mauro Giachero for the - implementation. -+--------------------------+ -Fri Jan 30 23:03:49 UTC 2009 -Sbopkg 0.26.2 released. This version contains the following fixes and -enhancements: + * A revision which fixed a failure to properly initialize + directories when running under bash 3x was committed but + didn't make it into the released package. It is included in + this release. Also fixed a problem with a blank line being + wrongly displayed in the directory initialization output in + older bashes. Thanks to greinze for pointing the latter out. - * Fix regression where packages could not be installed in certain - instances. Thanks to artourter for the bug report. -+--------------------------+ -Fri Jan 30 04:21:44 UTC 2009 -Sbopkg 0.26.1 released. This version contains the following fixes and -enhancements: + * Fixed documentation bug where the obsolete SBOPKGTMP and + current TMPDIR variables weren't correctly documented. Thanks + to dive for raising this issue. - * Implement some security fixes, namely, customize the output of some of the - menus so only things that can be done as root (i.e. build, install, - process the queue) are seen by the root user; also add a check to make - sure only root can install packages and that packages are correctly set - with root:root permissions. Thanks to Phillip Warner for the report and - suggestions. - * Modify SLACKVER in sbopkg.conf so it can be passed at runtime to sbopkg. - Thanks to TSquaredF for the suggestion. - * Quiet down the number of messages displayed when updated items are added - to the queue; thanks to Phillip Warner for the suggestion. - * Fix issue where sometimes duplicate items would appear in the search - results dialog; thanks to Phillip Warner for the suggestion. -+--------------------------+ -Thu Jan 29 14:41:00 UTC 2009 -Sbopkg 0.26.0 released. This version contains the following fixes and -enhancements: + * Fixed non-documentation bug where TMPDIR wasn't being + correctly assigned when set in sbopkg.conf. Thanks to Ken + Roberts for reporting the issue and providing a preliminary + fix. - * Add in new update code by Mauro Giachero. This /greatly/ improves how the - updates are handled and virtually eliminates the need for specific - application quirks. Please note there is a new file - /etc/sbopkg/sbopkg-renames that handles a few name changes. If you - upgrade sbopkg with the new package, then this file will be automatically - installed. If not, you'll need to grab this file from the source tarball - and move it there manually. Many thanks to Mauro for the hard work in - finally getting the update code done right. :-) - * Change how selecting/unselecting items in the build queue are handled. - Now, when items are unselected, they remain in the queue but are turned - "OFF" and when the queue is processed, only those packages turned "ON" - will be built or installed. - * Improve how packages are added to the queue. The user is now prompted if - they want to replace items already in the queue or skip them. This may be - helpful if a user has saved a queue with lots of dependencies that are - then updated through the rsync process. The updates can be added to the - queue, replacing the old versions. - * Add in a nice progress gauge when running the update list rather than the - warning message. Thanks to alkos333 for the idea and initial - implementation, and thanks to Mauro Giachero for working on the CLI - version. - * Merge in a large whitespace/cleanup patch by slakmagik which greatly - improves the readability of the code; thanks to slakmagik for the patch. - * Replace the 'Clear Queue' menu item with 'Delete Queue Items' which - provides the user the ability to delete individual items in the queue or - clear the entire build queue. - * Add in ability to have a /local directory in the local SBo repository tree - on a user's system that is in parallel with other SBo directories (i.e. - /home/sbo/local). As long as this directory is maintained in an SBo style - (including user-defined categories), then sbopkg will pick them up and the - user can change their SLACKVER to 'local' and build/install packages from - there. This might be useful in testing pre-submissions to SBo or for - maintaining other software not in SBo. This was inspired by a similar - idea contributed by slakmagik. Please see the sbopkg.conf(5) man page for - more information. - * Commit a patch from slakmagik that adds a new sbopkg.conf variable LOGFILE - where the user can decide the name and location of the permanent build - log, if used; thanks to slakmagik for the patch. - * Improve the configuration file handling so that sbopkg now runs even with - a missing or deficient system-wide configuration file, as long as the - user's ~/.sbopkg.conf file is present and fills the gaps. - * Fix issue where downloaded sources with spaces in their file names would - cause an MD5SUM failure; thanks to alkos333 for the bug report, and thanks - to Mauro Giachero for improving my initial bug fix implementation. - * Commit several other patches from slakmagik that improve the handling of - the search box upon search failures; tweak the precheck log a bit; improve - the checking of root privilegs, and improve the handling of the - directory-creation checks; thanks to slakmagik for these patches. - * Fix issue where a failed download would still go through an md5sum check; - now it informs the user of the failed download and asks if the user wishes - to continue with the build queue or abort. - * Eliminate some redundant or annoying messages to the user, such as when - the backup queue is saved. - * Add 'sspm' utility script by slakmagik which makes mirroring the sbopkg - SVN repository and making a package from the local SVN mirror very easy; - this script is located in the /tools directory in the sbopkg SVN - repository; thanks to slakmagik for the script. - * Fix issue where ARCH would sometimes not get picked up in info_item menu - (notably for OpenOffice.org); thanks to artourter for the bug report, and - thanks to Mauro for the fix. - * Lots of other internal 'under the hood' improvements to the repository - browsing, directory check functionality, build queue, and just general - overall code cleanup. -+--------------------------+ -Sat Jan 17 02:15:03 UTC 2009 -Sbopkg 0.25.0 released. This is another version jump due to the -number of fixes, enhancements, and new features: +sbopkg 0.34.0 (2010-11-12 03:37 UTC) - * Fix issue where packages were sometimes incorrectly identified as - already being in the build queue when they were not; thanks to - SpacePlod for the bug report and thanks to Mauro Giachero for - further bug reporting and providing a patch to fix it. - * Add ability to pass build options/flavors/arguments to the - SlackBuild when using the dialog interface. - * Include ability to reverse or manually sort the items in the build - queue; thanks to Mauro Giachero for the patches to implement these + * Revised man pages - these are very different and now document a + couple of previously undocumented things and are worth a + (re-)read. Thanks to Marie-Claude Collilieux for the French + translations of these. + + * The HACKING file now includes a man page style guide in addition + to the coding style guide. + + * The LOGDIR variable has been removed from sbopkg.conf - DIR can be + specified in LOGFILE. + + * The DEBUG variable has been renamed to DEBUG_UPDATES in + sbopkg.conf. + + * The default timeout values in {WGET,RSYNC}FLAGS have been raised + from 10/15 to 30 in sbopkg.conf. + + * All parameters in sbopkg.conf now use default values only if the + variable hasn't been previously set (meaning they can all be + overridden by passing variables on the command line). + + * sbopkg.conf has been reordered - this may make any merging that + may be needed more interesting this time but hopefully it's worth + it. + + * The directory initialization process has been changed - at first + run or otherwise when encountering missing directories, the user + will now be presented with a single list of them and a + (C)reate/(A)bort prompt. + + * The command line user interface has been overhauled in terms of + more consistent validated command line messages and prompts. + + * Fix an ARCH display issue in the updates screen; thanks to + alkos333, Marc Payne, and David Spencer for confirming the issue + and thanks to David Spencer for testing the fix. + + * Fixed bugs with dzen2 and *zarafa* not downloading/building + properly. Note that, while the changes fix these issues and should + make it easier to handle similar problems in the future, this + change may introduce regressions. If a download or build fails due + to a downloaded tarball looking something like + 'blah?actual_tarball.tar.gz' or the like, please report it to us. + + * Fixed bugs with the '-s' option where only the first of multiple + arguments would be returned and where the command line select menu + was broken. Also where it and the -g flag might inadvertently + expand globs wrongly. + + * It's now possible to specify the b,g,i,s flags multiple times. + Previously multiple arguments to these flags had to be quoted (-b + "foo bar") but now they can be given as '-b foo -b bar'. The + original style is still supported. + + * With the new style of passing multiple arguments, it is now + possible to specify app-specific options on the command line. + These take the form of, e.g., '-i app1:opt1="foo bar":opt2=baz + app2:opt=mu'. If that's cryptic, see the manual for details. + + * Users now have the option of interactively retrying a failed https + download, invoking wget with '--no-check-certificate', as this can + be caused by 'self-signed certificates' and the like. + +sbopkg 0.33.1 (2010-05-27 18:13 UTC) + + * The ARCH assignment was modified to accord with the latest SBo + SlackBuild template. + + * Tweaked widgets in select_repository() (no or less scrolling) and + load_user_queue() (better button) and modified check_gpg() to not + disrupt the dialog interface with gpg output + + * Revised the KNOWN_ISSUES file and other documentation + +sbopkg 0.33.0 (2010-05-24 20:53 UTC) + + * Addressed an apparent bash 4.1 bug that causes the 'obsolete + sources' function to break. + + * Addressed issue 44 where hitting ^C during the download of part of + a queue and restarting the queue could result in a download + failure. Thanks to slava18 for the report. + + * Changed the menu order of the "Build options" dialog to default to + using "Saved" options rather than "None". + + * Fixed issue 45 where packages with '+' in the name were not + properly detected in some cases. Thanks to skalkoto for the + report. + + * Added a help item to the main menu of the dialog interface with + pointers to documentation and other resources. + + * Added an option to print the version of sbopkg. We try not to + change the meaning of flags but note that this does change what + was the '-v' flag to '-V' and now uses '-v' for its customary + 'version' purpose. Note that the new -V flag now accepts a '?' + argument (sbopkg -V ?) which will display the list of valid + repositories. + + * Tweak the logic re determining ARCH and modify some ARCH-related + evals and conditionals in check_for_updates and info_item. + + * Fixed a bug which could result in some sources being missed when + checking for obsolete sources. + + * Added a command line option '-P' to access the 'remove uninstalled + packages' function which had previously only been accessible from + the dialog interface. + + * Miscellaneous tweaks in preparation for release and to bring in + line with Slackware 13.1. + +sbopkg 0.32.0 (2010-03-05 21:29 UTC) + + * Add several renames to 50-default renames file. + + * Add support for UNSUPPORTED/UNTESTED packages in the SBo repo; + thanks to artourter for the bug report. + + * Honor the TAG exported by the user; thanks to Matteo Bernardini + for the feature request. + + * Fix issue where delete sources in package info item menu did not + work in some cases; thanks to artourter for the report, thanks to + slakmagik for the hard work in fixing this and thanks to Mauro for + the review and suggestions. + + * Add the ability to skip the prompts for sbopkg's directory + creations via the new config file option MKDIR_PROMPT. This is + useful, for example, if you have some SBo/sbopkg directories on a + temporary filesystem and don't want to be bothered with repeated + directory creation prompts. Thanks to agikhan for the report. + + * Address an issue where sbopkg could sometimes pick an older + package to present for installation rather than the most recent + one; thanks to artourter for the report. + + * Prevent sbopkg from spitting error messages when trying to + determine the version of some packages (e.g. google-chrome, whose + version is discovered looking into the source package which can be + missing). Thanks to alkos333 for the bug report. + + * Add ability to temporarily change $ARCH in the 'options' submenu. + +sbopkg 0.31.0 (2009-11-01 02:54 UTC) + + * Fix typo in 50-default renames file. + + * Fix the "Uncheck installed" feature. The code apparently worked + fine even without the fix. Spotted by slakmagik. + + * Add $ARCH information in dialog backtitles. + + * Add ":force" to sbopkg.conf WGETFLAGS --progress=bar to correctly + display the wget progress bar; thanks to happyslacker for nudging + me on this issue again. + + * Fix an issue with the build options dialog menu where selecting + 'None' would not work; thanks to happyslacker for the bug report. + + * Add the ability to uninstall SBo packages from the dialog + interface that lists installed packages. Thanks to pokipoki08 for + the suggestion. + + * Fix an incompatibility regarding the way bash 3.1, 3.2, and 4.0 + handle the RHS of [[ commands using the =~ operator which broke + the repo file validation, among other things. Thanks to SiegeX, + Zmyrgel, and BCarey for the reports and suggestions. + + * Add the ability to run multiple sbopkg instances simultaneously. + This has been suggested many times in the past. Users should read + the sbopkg.conf man page before using this option (which is + disabled by default). + + * Be more strict validating YES/NO configuration variables. + + * Add a KNOWN_ISSUES file - if you encounter a bug, check this file + before reporting it to see if it's known and if there's a + workaround. + + * Modify sspm to be root-only and change the default checkout + location. In case it isn't obvious, this means the checkout will + be root-owned if it isn't already. + + * Fix cosmetic bug where ARCH and BUILD were not displaying + correctly in list of updates on x86_64. + + * Add a dialog and cli option to show all READMEs for the queued + packages. This can come handy to do "final checks" on the active + queue before starting the build process. + + * Reworked the options selection menu to avoid seeing only a + truncated set of the actual options; thanks to Erik Hanson for the + bug report. + + * Work around build issues caused by custom LC_COLLATE values. + + * Add tint=tint2 to /etc/sbopkg/renames.d/50-default file. + + * Prevent an infinite download loop by modifying get_source() and + check_source(); make sure that we do try to guess about the file + name in a DOWNLOAD/filename mismatch but only when we absolutely + have to, by modifying get_source_names(). Thanks to godling for + noticing the problem. + + * The 'check for updates' function now always lists apparent + downgrades, since it sometimes can mistakenly classify an upgrade + as a downgrade (e.g. version 1.0.1 looks older than 1.0-rc2 to + sbopkg). The apparent downgrades are added to the queue but are + disabled by default. + +sbopkg 0.30.1 (2009-08-28 17:34 UTC) + + * Fix the updates code for the 13.0 repo; thanks to everybody who + contacted us about this issue. + + * Fix the $SBOPKGTMP sanity check. Thanks to Ken Roberts for raising + the issue. + + * Update the renames file. + +sbopkg 0.30.0 (2009-08-24 17:28 UTC) + + * Move sbopkg to /usr/sbin; update sbopkg.SlackBuild and sspm to + reflect /usr/sbin. + + * Change default directory paths in sbopkg.conf.new; add new + variable SBOPKGTMP, which will be used to store sbopkg-related + temp files; also add new variable LOGDIR which will contain any + sbopkg-related log files. + + * Remove code related to user-mode support; sbopkg must now be run + as root in all cases; add single check at start of script to make + sure we are root. + + * Apply a major code cleanup that touches just about every part of + sbopkg. This cleanup makes the code more readable, manageable, and + less bug-prone. Several bugs were fixed as part of this cleanup, + and the cleanup will ease further development and debugging + efforts. + + * Remove some useless code from check_for_latest and also fix the + download folder for sbopkg updates. Thanks to David Somero for + the bug report. + + * Re-implement the code that checks for renamed software; fix + upgrading of renamed packages; thanks to Phillip Warner for + raising the issues with the older code; thanks to Mauro Giachero + for working on these fixes. + + * Fix a tr invocation issue where in certain instances, sbopkg would + not run from certain directories; thanks to Marie-Claude + Collilieux for the bug report. + + * Alter sed expression in download code to work around calcurse + filename idiosyncrasy; thanks to Glenn Becker for the bug report. + + * Move French man pages into correct /usr/man/fr* location and + remove them from the /docs directory; update French man pages; + thanks to Marie-Claude Collilieux. + + * Remove a stale 'find' call, which slightly improves the update + feature. + + * Add acroread->adobe-reader, GNOME-Colors->gnome-colors, + wbxml2->libwbxml and museek-plus->museek+ renames. + + * Display a message when no packages are installed instead of doing + nothing. + + * Properly quote the current working directory variable in the event + there are spaces in the directory name. + + * Fix a bug where 'sbopkg -c -v local' would display a dialog even + though running in cli mode. + + * Fix issue where the 'games' directory was non-browsable due to a + slack-desc file containing double-quotes in the first line; thanks + to Glenn Becker for the original bug report. + + * Implement configurable repository support by introducing a new + /etc/sbopkg/repos.d directory where separate repositories files + can be maintained and also by adding support for git-based + repositories. The Slamd64Builds repository is now listed, to the + joy of all the Slamd64 users out there. Add a new document + README-repos.d that explains how these repository files work. + + * 'Nice' the build process so as to improve sbopkg's resource + utilization. + + * Fix a few issues regarding user sbopkg.conf files. + + * Move sbopkg-renames to new /etc/sbopkg/renames.d/50-default to + manage multiple renames files. Thanks to Robby Workman for the + suggestion. Add new document README-renames.d that explains how + this works. + + * Add support for new *.txz, *.tlz, and *.tbz Slackware package + extensions. + + * Rewrite several portions of the process_queue function in order to + properly handle certain items by the caller; clean up and improve + the logging displayed during the build process. + + * Require build queuefiles have a '.sqf' file extension. + + * Add a sanity check for files in sbopkg's temp directory. + + * Cleanup several of the functions related to editing the .info and + SlackBuild files to remove code duplication; also cleanup and fix + issues associated with the two primary search functions, and + improve file cleanup for these search-related functions. + + * Fix issue where MD5SUM checking would fail when certain upstream + packages do not change source file name on version updates by + adding in an extra check for existing sources. Additionally, add + an option to retry a source download in the event of an MD5SUM + failure to avoid having to restart a build. Thanks to David + Spencer for raising these issues and thanks to Mauro Giachero for + the fixes and improvements. + + * Create a ChangeLog.txt for git repos on the fly. + + * Remove usage of ARCH in preparation for Slackware64 support. + + * Remove obsolete load_backup_queue. + + * Improve and fix some issues with the search functions and leaking + variables. + + * Change queuefile format. No longer will the queuefile format be + 'APP VERSION ON/OFF' but instead will simply be one 'APP' per + line. If a user wants an APP to be deselected in the dialog + menus, simply put a '-' in front of it, e.g. '-APP'. This should + make creating, using, and sharing queuefiles much easier and more + intuitive. + + * Add ability to load more than one queuefile at a time when + building from command line interface. + + * The info_item dialog now shows non-SBo installed packages and + gained a more robust approach to finding both the installed + package names and the available packages in $OUTPUT. + + * Add ability to dump all installed packages into a build queue. + This is an alphabetical list, so shuffling/reordering of the queue + will be necessary in order to list the dependencies correctly, but + at least this will give users a head start on setting up a large + build queue. + + * The process of searching for obsolete source archives can now be + interrupted with ESC. + + * Add several new functions related to checking GPG-signed tarballs, + such as those that SlackBuilds.org provides. Sbopkg will now + automatically check these tarballs when building or installing a + package. Additionally, there are two new menu items in info_item + that allow the user to check the GPG signature or re-extract the + GPG-signed tarball. + + * Add ability to have recursive queuefiles, so one queuefile named + "foo.sqf" may have an entry "@bar" in which case as the foo.sqf + queuefile is parsed, it will recursively go down into the + 'bar.sqf' queuefile as well. The '@' symbol is used in front of + an entry in a queuefile to denote another queuefile. + + * Remove the old "$APP $VERSION$BUILD $ONOFF" format for the + temporary queue and instead make all queue formats "$APP" only. + This simplifies some code and results in a small speed increase. + + * Exit edit_build_queue menu with 'ESC'; thanks to Nille for the bug + report. + + * Modify do_install() to correctly invoke upgradepkg to avoid a + fairly rare but serious case of removing the wrong package; thanks + to NaCl for the bug report. + + * Add ability to pass build options in a queuefile when separated by + a pipe character, i.e. app | FOO=yes BAR=no means app will be + built with FOO and BAR build options set as indicated. + + * Fix rare issue where incorrect file was upgraded; thanks to + neonflux for the bug report. + + * Fix issue where custom build options may not be correctly + exported. + + * Add a 'diff' entry to the script customization menu. + + * Add in 'uname -m' test for x86_64 and if so, set ARCH to x86_64. + + * Set default SBo repo to 13.0; add 13.0 repo to + /etc/sbopkg/repos.d/40-sbo.repo. + + * Add support for multiple architectures and multiple source files. + This makes sbopkg able to handle the new features that + SlackBuilds.org admins are preparing for the Slackware 13.0 + release. + + * Add option to retry a failed build. Thanks to Zordrak for + suggesting this feature. + + * Add CLEANUP configuration variable, which when set to YES tells + sbopkg to delete the extracted sources, and all the associated + "residuals" of the build, as soon as the build is finished. Thanks + to Marco Bonetti and Gregory Tourte for the suggestion and the + nice discussion. + + * Add a function to delete obsolete (not installed) packages from + $OUTPUT. Thanks to alkos333 for the idea. + + * Reorganize the queue editing functions a bit for a better user + interface; 'view queue' now only shows the queue; new 'sort' and + 'remove' queue menu items now handle the editing functions; thanks + to Pierre Cazenave for the suggestion. + + * Add dialog notification of whether a queued package is installed. + + * Add a dialog option to automatically uncheck installed packages + from the active queue, together with a command line option -k that + automatically skips such packages when building with -b or -i. + + * Add ability to 'invert' all selected/deselected in the clear cache + and obsolete sources and packages dialogs; thanks to dive for the + suggestion. + +sbopkg 0.27.0 (2009-02-26 14:48 UTC) + + * Commit a patch that adds a new sbopkg.conf configuration variable, + QUEUEDIR, where users can define where saved queues are stored; + also, when the user wants to load a saved queue, show a list of + available saved queues; thanks to slakmagik for the patch. + + * Add ability to search for keywords in the README files using + regular expressions; this new 'string search' can also be narrowed + to only search installed packages; thanks to slakmagik for the + original patch and implementation and thanks to both slakmagik and + Mauro Giachero for cleaning it up and addressing minor issues + before the commit. + + * Commit a cleanup/misc patch from slakmagik that removes some + useless code and fixes some style issues; thanks to slakmagik for + the patch. + + * Allow user to interrupt/abort the update progressbar by pressing + ESC; thanks to Mauro Giachero for the feature. + + * Assorted menu navigation fixes, and document -p switch in + sbopkg(8) man page; thanks to Mauro Giachero for these + improvements. + + * Add ability to view a diff of an edited .info or SlackBuild file + before choosing which one to use; this feature adds two + configuration variables to the sbopkg.conf file: DIFF and + DIFFOPTS; thanks to Phillip Warner for the suggestion and thanks + to Mauro Giachero for helping debug/improve my original + implemenation. + + * Add ability to view more files in each application's folder, i.e. + doinst.sh, or *.desktop files; thanks to Phillip Warner for the + suggestion and thanks to slakmagik for the patch implementing this + feature. + + * Rework the check for root:root permissions when installing + packages; now, if the package does not have root:root permissions, + sbopkg will display the output of ls -l and ask if + the user wishes to install or abort, rather than only aborting. + + * Allow the usage of the -d, -f and -v command-line options in + dialog mode, and output an error message when the command line + contains unrecognized tokens. + + * Move the -q option to -g (general search) in order to make way for + -q, 'quiet mode' where the output of some of the command line + options (i.e. the command line progressbar) can be minimized. + More quieting will likely occur in future releases. Thanks to + alkos333 for the feature request. + + * Implement a workaround so that the dialog interface now works + better with GNU Screen and rxvt-based terminals. Thanks to Phillip + Warner for raising the issue and thanks to Mauro Giachero for + working on the implementation. + + * Include a French translation of the two sbopkg man pages. For + now, these man pages will be included in the /doc directory until + I have time to figure out whether they can be automatically + installed in place of the English ones depending on a locale + setting. In any event, I would like to extend my thanks to + Marie-Claude Collilieux for providing this first translation for + sbopkg. I am sure folks will appreciate the work she put into it. + If anyone else wants to follow her lead and provide some other + translations, I would be happy to include them. Thanks + Marie-Claude! + + * Add in several patches from slakmagik that lets the user choose + from saved queues, modifies how the saved queues and backup queues + work, and modifies several other queue-related functions and + menus. Many thanks to slakmagik for his continually excellent + contributions. + + * Implement an 'autoqueue' by allowing the user to specify queue + names to '-b' and '-i' and by adding a -e option whereby the user + can specify what to do on errors (stop, ask, or continue). Thanks + to Alan Hicks for suggesting this feature and thanks to Mauro + Giachero for the implementation. + +sbopkg 0.26.2 (2009-01-30 23:03 UTC) + + * Fix regression where packages could not be installed in certain + instances. Thanks to artourter for the bug report. + +sbopkg 0.26.1 (2009-01-30 04:21 UTC) + + * Implement some security fixes, namely, customize the output of + some of the menus so only things that can be done as root (i.e. + build, install, process the queue) are seen by the root user; also + add a check to make sure only root can install packages and that + packages are correctly set with root:root permissions. Thanks to + Phillip Warner for the report and suggestions. + + * Modify SLACKVER in sbopkg.conf so it can be passed at runtime to + sbopkg. Thanks to TSquaredF for the suggestion. + + * Quiet down the number of messages displayed when updated items are + added to the queue; thanks to Phillip Warner for the suggestion. + + * Fix issue where sometimes duplicate items would appear in the + search results dialog; thanks to Phillip Warner for the + suggestion. + +sbopkg 0.26.0 (2009-01-29 14:41 UTC) + + * Add in new update code by Mauro Giachero. This /greatly/ improves + how the updates are handled and virtually eliminates the need for + specific application quirks. Please note there is a new file + /etc/sbopkg/sbopkg-renames that handles a few name changes. If + you upgrade sbopkg with the new package, then this file will be + automatically installed. If not, you'll need to grab this file + from the source tarball and move it there manually. Many thanks + to Mauro for the hard work in finally getting the update code done + right. :-) + + * Change how selecting/unselecting items in the build queue are + handled. Now, when items are unselected, they remain in the queue + but are turned "OFF" and when the queue is processed, only those + packages turned "ON" will be built or installed. + + * Improve how packages are added to the queue. The user is now + prompted if they want to replace items already in the queue or + skip them. This may be helpful if a user has saved a queue with + lots of dependencies that are then updated through the rsync + process. The updates can be added to the queue, replacing the old + versions. + + * Add in a nice progress gauge when running the update list rather + than the warning message. Thanks to alkos333 for the idea and + initial implementation, and thanks to Mauro Giachero for working + on the CLI version. + + * Merge in a large whitespace/cleanup patch by slakmagik which + greatly improves the readability of the code; thanks to slakmagik + for the patch. + + * Replace the 'Clear Queue' menu item with 'Delete Queue Items' + which provides the user the ability to delete individual items in + the queue or clear the entire build queue. + + * Add in ability to have a /local directory in the local SBo + repository tree on a user's system that is in parallel with other + SBo directories (i.e. /home/sbo/local). As long as this directory + is maintained in an SBo style (including user-defined categories), + then sbopkg will pick them up and the user can change their + SLACKVER to 'local' and build/install packages from there. This + might be useful in testing pre-submissions to SBo or for + maintaining other software not in SBo. This was inspired by a + similar idea contributed by slakmagik. Please see the + sbopkg.conf(5) man page for more information. + + * Commit a patch from slakmagik that adds a new sbopkg.conf variable + LOGFILE where the user can decide the name and location of the + permanent build log, if used; thanks to slakmagik for the patch. + + * Improve the configuration file handling so that sbopkg now runs + even with a missing or deficient system-wide configuration file, + as long as the user's ~/.sbopkg.conf file is present and fills the + gaps. + + * Fix issue where downloaded sources with spaces in their file names + would cause an MD5SUM failure; thanks to alkos333 for the bug + report, and thanks to Mauro Giachero for improving my initial bug + fix implementation. + + * Commit several other patches from slakmagik that improve the + handling of the search box upon search failures; tweak the + precheck log a bit; improve the checking of root privilegs, and + improve the handling of the directory-creation checks; thanks to + slakmagik for these patches. + + * Fix issue where a failed download would still go through an md5sum + check; now it informs the user of the failed download and asks if + the user wishes to continue with the build queue or abort. + + * Eliminate some redundant or annoying messages to the user, such as + when the backup queue is saved. + + * Add 'sspm' utility script by slakmagik which makes mirroring the + sbopkg SVN repository and making a package from the local SVN + mirror very easy; this script is located in the /tools directory + in the sbopkg SVN repository; thanks to slakmagik for the script. + + * Fix issue where ARCH would sometimes not get picked up in + info_item menu (notably for OpenOffice.org); thanks to artourter + for the bug report, and thanks to Mauro for the fix. + + * Lots of other internal 'under the hood' improvements to the + repository browsing, directory check functionality, build queue, + and just general overall code cleanup. + +sbopkg 0.25.0 (2009-01-17 02:15 UTC) + + This is another version jump due to the number of fixes, + enhancements, and new features. + + * Fix issue where packages were sometimes incorrectly identified as + already being in the build queue when they were not; thanks to + SpacePlod for the bug report and thanks to Mauro Giachero for + further bug reporting and providing a patch to fix it. + + * Add ability to pass build options/flavors/arguments to the + SlackBuild when using the dialog interface. + + * Include ability to reverse or manually sort the items in the build + queue; thanks to Mauro Giachero for the patches to implement these + features. + + * Move all the queue functions into a separate 'Manage Queue' + submenu off the main menu. + + * Allow user to save (and load) the build queue between sessions by + specifing a file and location, so multiple saved queues can be + maintained. + + * Automatically backup the current queue upon exiting and offer to + reload upon first entering the queue submenu. + + * Provide a menu entry to clear the build queue. + + * Merge in several patches from Mauro Giachero to display the SVN + version number; clean up use of cancel/back and ESC (ESC now takes + you back a step in most dialogs); improve the cleanup process; and + improve the new build flavors/options dialog. + + * Apply several patches from slakmagik for various little fixes, + cleanups, and tweaks. + + * Create a new 'Utilities' submenu off the main menu and move some + of the less-important items there in order to clean up the main + menu. It was getting a bit bulky. :-) + + * Add ability to download a new sbopkg package when there is an + update. + + * Include optional use of a ~/.sbopkg.conf, which will override + settings in the system /etc/sbopkg/sbopkg.conf file. + + * When changing the Slackware version in the dialog interface, offer + the user the opportunity to save this change in the new + ~/.sbopkg.conf file. + + * Improve build queue logging and error reporting; correctly remove + symlink to the source tarball when build fails. + + * Bump default wget timeout from 10 to 15 seconds which prevents + some downloads from failing. + + * Add update list fix for ksmoothdock; thanks to Wade Grant for the + bug report. + + * Improve how the sources are downloaded and identified. + + * Remove the 'read sbopkg README' from the main menu. + + * Add a directory check for OUTPUT since that is now required. + + * Add preliminary check to make sure command line options -b and -i + are not used together. + + * Fix issue where certain packages in queue that end with a ++ (like + libsigc++) could not be added. + +sbopkg 0.20.0 (2009-01-01 20:53 UTC) + + This a version jump due to the numerous fixes, enhancements, and new features. - * Move all the queue functions into a separate 'Manage Queue' - submenu off the main menu. - * Allow user to save (and load) the build queue between sessions by - specifing a file and location, so multiple saved queues can be - maintained. - * Automatically backup the current queue upon exiting and offer to - reload upon first entering the queue submenu. - * Provide a menu entry to clear the build queue. - * Merge in several patches from Mauro Giachero to display the SVN - version number; clean up use of cancel/back and ESC (ESC now takes - you back a step in most dialogs); improve the cleanup process; and - improve the new build flavors/options dialog. - * Apply several patches from slakmagik for various little fixes, - cleanups, and tweaks. - * Create a new 'Utilities' submenu off the main menu and move some - of the less-important items there in order to clean up the main - menu. It was getting a bit bulky. :-) - * Add ability to download a new sbopkg package when there is an - update. - * Include optional use of a ~/.sbopkg.conf, which will override - settings in the system /etc/sbopkg/sbopkg.conf file. - * When changing the Slackware version in the dialog interface, offer - the user the opportunity to save this change in the new - ~/.sbopkg.conf file. - * Improve build queue logging and error reporting; correctly remove - symlink to the source tarball when build fails. - * Bump default wget timeout from 10 to 15 seconds which prevents - some downloads from failing. - * Add update list fix for ksmoothdock; thanks to Wade Grant for the - bug report. - * Improve how the sources are downloaded and identified. - * Remove the 'read sbopkg README' from the main menu. - * Add a directory check for OUTPUT since that is now required. - * Add preliminary check to make sure command line options -b and -i - are not used together. - * Fix issue where certain packages in queue that end with a ++ (like - libsigc++) could not be added. -+--------------------------+ -Thu Jan 1 20:53:19 UTC 2009 -Sbopkg version 0.20.0 released. This a version jump due to the -numerous fixes, enhancements, and new features. -New features: + New features: - * There is a new -i command line switch that allows the user to - build and install packages in a manner similar to the current -b - switch for building only. As with the -b switch, the user can - build and install more than one package by listing them in quotes. - And, by carefully listing dependencies in the right order, it - might be possible to build and install dependencies and the final, - target package in one go, like this: + * There is a new -i command line switch that allows the user to + build and install packages in a manner similar to the current + -b switch for building only. As with the -b switch, the user + can build and install more than one package by listing them in + quotes. And, by carefully listing dependencies in the right + order, it might be possible to build and install dependencies + and the final, target package in one go, like this: - # sbopkg -i "imlib2 giblib feh" + # sbopkg -i "imlib2 giblib feh" - In this case, imlib2 must be built and installed before giblib, - both of which need to be built and installed before feh. Given - the nature of building dependencies, this may not always work, but - it still may be helpful and useful in many cases. - * Coupled with the new -i switch, there is a new 'build queue' in - the dialog interface. The user can add packages to the queue and - then, when ready, can process the queue in the order the packages - are listed. The user can choose to build only or build and - install the packages in the queue. Again, by listing dependencies - in the right order, it may be possible to build dependencies and - the final, target package in one go like the feh example above. - * After checking for updates, the user is offered the opportunity to - add those flagged updates to the build queue automatically. - * When building packages individually outside of the build queue, - the user is offered the opportunity to build or build and install - the package. - * There is a new -u command line switch, and a corresponding new - dialog menu selection, that allows the user to check if there is - an update to sbopkg itself. - * A new DEBUG variable is introduced to the sbopkg.conf file that - allow for easier debugging and update list bug reporting. See the - sbopkg.conf man page for more detail. + In this case, imlib2 must be built and installed before + giblib, both of which need to be built and installed before + feh. Given the nature of building dependencies, this may not + always work, but it still may be helpful and useful in many + cases. -Bug Fixes: + * Coupled with the new -i switch, there is a new 'build queue' in + the dialog interface. The user can add packages to the queue + and then, when ready, can process the queue in the order the + packages are listed. The user can choose to build only or + build and install the packages in the queue. Again, by + listing dependencies in the right order, it may be possible to + build dependencies and the final, target package in one go + like the feh example above. - * Fix issues with the "Installed/Not Installed" text at the top of - info item menu screen. Thanks to Erik Hanson and Mauro Giachero - for assistance with this issue. - * Improve the wording and button labeling of several dialogs; thanks - to Erik Hanson for a patch to implement several of these - improvements and thanks to The-Croupier for suggestions on - another. - * Clean up the customization menu. - * Fix issue with typhoon_2001 not building correctly; thanks to - cotterochan for the bug report. - * Fix django download issue due to their weird tarball naming - scheme; thanks to David Somero for the bug report. - * Fix mplayer update issue; thanks to all the folks that reported - this one. Clearly, mlayer is a popular app. :-) - * Fix acroread update issue; thanks to Erik Hanson for the bug - report. - * Fix build queue failure issue found in 0.20.0rc1 due to not - recovering from control-c cleanly; thanks to Mauro Giachero for - the bug report. - * Fix issue found in 0.20.0rc1 where packages could be added to - queue more than once which caused some funky behavior; thanks to - Mauro Giachero for the bug report. - * Fix issue found in 0.20.0rc1 where customized SlackBuilds were not - being used in the build process; thanks to Mauro Giachero for the - bug report. - * Fix issue found in 0.20.0rc1 where the queue processing would - continue even after removing all packages from the queue; thanks - to Mauro Giachero for the bug report. + * After checking for updates, the user is offered the + opportunity to add those flagged updates to the build queue + automatically. -Changes to sbopkg.conf: + * When building packages individually outside of the build + queue, the user is offered the opportunity to build or build + and install the package. -As a result of some of these new features, users are advised of three -changes to the sbopkg.conf file. Users can either manually update -their existing sbopkg.conf file or use the sbopkg.conf.new file that -is installed when you upgrade sbopkg. + * There is a new -u command line switch, and a corresponding new + dialog menu selection, that allows the user to check if there + is an update to sbopkg itself. -sbopkg.conf change 1: OUTPUT is now required. This was commented out -in prior versions of sbopkg.conf. The default setting of OUTPUT is: + * A new DEBUG variable is introduced to the sbopkg.conf file + that allow for easier debugging and update list bug reporting. + See the sbopkg.conf man page for more detail. -export OUTPUT=${OUTPUT:-/tmp} + Bug Fixes: -this is the same default setting in SBo SlackBuild scripts themselves. + * Fix issues with the "Installed/Not Installed" text at the top + of info item menu screen. Thanks to Erik Hanson and Mauro + Giachero for assistance with this issue. -sbopkg.conf change 2: TERMBUILD is deprecated. All building and -installing switches now out of dialog and occurs in a terminal in all -cases. Having the build take place inside the dialog interface caused -some issues and made it difficult to implement some of the new -features. So, it went. As a result, you can delete TERMBUILD from -your sbopkg.conf file. + * Improve the wording and button labeling of several dialogs; + thanks to Erik Hanson for a patch to implement several of + these improvements and thanks to The-Croupier for suggestions + on another. -sbopkg.conf change 3: As mentioned above, DEBUG is a new required -variable in the sbopkg.conf file. The default setting is DEBUG=0. -+--------------------------+ -Thu Dec 11 02:45:58 UTC 2008 -Congrats to Patrick and the team on the new release of Slackware -12.2. + * Clean up the customization menu. -Sbopkg version 0.15.0 released. This version contains the following -fixes and enhancements: + * Fix issue with typhoon_2001 not building correctly; thanks to + cotterochan for the bug report. - * Slackware 12.2 is now the default Slackware version selected when - using sbopkg. - * Fix an issue where sometimes a built package was incorrectly - listed in the software info item menu, i.e. mplayer-codecs-all - instead of mplayer. Thanks to necropresto for the bug report. - * Add --no-owner to default rsync flags to avoid having the local - SBo repo tagged with owner 1016 permissions. Thanks to Pierre - Cazenave for the bug report and Erik Hanson for the suggested - solution. -+--------------------------+ -Thu Dec 4 09:35:09 UTC 2008 -Sbopkg version 0.14.1 released. This is a minor bug-fix release: + * Fix django download issue due to their weird tarball naming + scheme; thanks to David Somero for the bug report. - * Fix issue where certain package names were showing up incorrectly - in the 'install' option - i.e. mplayer instead of - mplayer-codecs-all. Thanks to necropresto for the bug report. - * A few little cleanups and cruft-removal. -+--------------------------+ -Sun Nov 16 17:15:49 UTC 2008 -Sbopkg version 0.14.0 released. This version contains the following -fixes and enhancements: + * Fix mplayer update issue; thanks to all the folks that + reported this one. Clearly, mlayer is a popular app. :-) - * Various fixes related to the SlackBuilds.org update changing - certain 'xx' to '++', such as TiMidity++, libsigc++, and libxml++. - * The info item menus now display the repo's software version in the - menu title, and also display whether the package has been - installed at the top of the screen. This is a really nice - improvement. Thanks to Erik Hanson for the patch. - * Improve the Control-C trapping. - * Fix the issue where simply pressing 'Enter' in the search box - would result in all packages in the repo being listed as search - results. Now, it just returns to the main menu. - * Fix xerces-c issue in the update list. Thanks to João Felipe - Santos for the bug report. - * Lots of other little cleanups and cruft-removal. - * Also, the sbopkg package itself now has a tag at the end, in - keeping with typical Slackware package convention. + * Fix acroread update issue; thanks to Erik Hanson for the bug + report. -In addition, a new home page (http://www.sbopkg.org) has been set up. -Many thanks to the guys at cardinal.lizella.net, and their colocation -provider, Cyberlink International (http://cyberlinkint.com) for the -hosting. -+--------------------------+ -Tue Oct 28 14:06:56 UTC 2008 -Sbopkg version 0.13.1 released. This is primarily a bug-fix release: + * Fix build queue failure issue found in 0.20.0rc1 due to not + recovering from control-c cleanly; thanks to Mauro Giachero + for the bug report. - * A fix for OpenOffice.org not being picked up correctly on the - updatelist feature. Thanks to Erik Hanson for the bug report. - * A fix for a couple issues that appeared with the changes to the - rsync and wget flags in version 0.13.0. Thanks to Ken Roberts and - Jorge Gaton for the bug reports. To remedy this problem, I have - removed TIMEOUT from sbopkg.conf and instead added two optional - variables, RSYNCFLAGS and WGETFLAGS. These options have been - populated with some of the flags that were previously in the - sbopkg script itself. This means that folks can manually tweak - the flags used by rsync and wget, although in most cases the - defaults should be left alone. This also means that for those who - are upgrading sbopkg from a previous version will again need to - manually update their sbopkg.conf from the sbopkg.conf.new that is - installed and merge the changes. Sorry about these changes to the - configuration file, but hopefully they are for the better since - these changes fix the problems mentioned previously and also give - the users a bit more control over the flags used, if desired. -+--------------------------+ -Sat Oct 25 12:38:34 UTC 2008 -Sbopkg version 0.13.0 released. This version contains the following -fixes and enhancements: + * Fix issue found in 0.20.0rc1 where packages could be added to + queue more than once which caused some funky behavior; thanks + to Mauro Giachero for the bug report. - * New code has been added to allow the user to cleanly abort the - source download by pressing Control-C; thanks to Zordak for the - suggestion. - * Add in several improvements to the rsync and wget stages, whereby - better error messages are detected and displayed, -z is removed - from rsync, and other general cleanups; thanks to macavity for the - suggestions and patches. - * Add in -O option to wget to allow for cases where downloaded - source name is different than expected (such as virtualbox-ose); - thanks to acidchild for the bug report. - * Add in new sbopkg.conf variable TIMEOUT to allow the user to - manually set the timeout value for rsync and wget; thanks to - macavity for the suggestion. NOTE: this will require users - upgrading from previous versions to either merge the new - sbopkg.conf into their existing file, or manually add a TIMEOUT=10 - (default is 10 seconds) to their existing sbopkg.conf file. - * Add in several updatelist fixes; thanks to Erik Hanson for the bug - reports. - * Add in fix where searching for category names would create - problems; thanks to nille for the bug report. - * Add in some new code in an initial attempt to fix the 'decimal' - problem in bash, in which comparing package versions (like 3.9 - versus 3.11) would result in incorrect updatelist results. This - code should fix some updatelist errors reported by Erik Hanson, - samac, and João Felipe Santos. This new code needs testing, so - please check the updatelist and then consider running it with the - debug feature enabled and check the results the again. See the - UPDATELIST-DEBUGGING document for details on how to enable - debugging. - * Fix size of several dialog boxes for a better UI; thanks to Erik - Hanson for the bug report. - * Several error-checking and graceful exit cleanups and fixes. -+--------------------------+ -Tue Oct 7 14:05:36 UTC 2008 -Sbopkg version 0.12.0 released. This version contains the following -fixes and enhancements: + * Fix issue found in 0.20.0rc1 where customized SlackBuilds were + not being used in the build process; thanks to Mauro Giachero + for the bug report. - * New code that better catches MD5SUM failures and offers the - opportunity to delete the corrupted source. - * New menu entry that allows a user to manually delete the saved - sources for any particular software in the SBo repository. Thanks - to Drew Ames for the bug reports and suggestions that led to both - of these two fixes and additions. - * Add in ability to edit the *.info file in a similar manner to - editing the SlackBuild. With this addition, a user can now - manually update the .info and SlackBuild from within sbopkg and - build and install an updated package before it hits the repo. If - you use vi/vim as your EDITOR and want an easy way to insert the - MD5SUM of a new source tarball, try ":r! md5sum - /path/to/new/source". Then clean up the inserted information into - a proper .info file layout. Thanks to nille for prodding me to - get this done. - * Move the editing functions into a submenu to better organize the - 'info item' menu for each software selection. Thanks to nille for - the suggestion. - * Several error-checking and graceful exit cleanups and fixes. -+--------------------------+ -Tue Sep 16 22:41:34 UTC 2008 -Sbopkg version 0.11.2 released. This version contains the following -fixes and enhancements: + * Fix issue found in 0.20.0rc1 where the queue processing would + continue even after removing all packages from the queue; + thanks to Mauro Giachero for the bug report. - * The pid file is now properly removed when using sbopkg from the - cli; many thanks to LukenShiro for the bug report and help with - testing. - * Checks for the various sbopkg-related directories and files are - improved. - * A couple of updatelist fixes; thanks to LukenShiro for the bug - reports. -+--------------------------+ -Fri Sep 12 12:32:07 EST 2008 -Sbopkg version 0.11.1 released. This is a minor bug fix for version -0.11.0. -+--------------------------+ -Fri Sep 12 09:51:39 EST 2008 -Sbopkg version 0.11.0 released. This version contains the following -fixes and enhancements: + Changes to sbopkg.conf: - * After many, _many_ requests, sbopkg now adds preliminary support - to install a package by calling upgradepkg --reinstall - --install-new. Currently, this new feature is only available in - the dialog interface (the cli version will include this feature - shortly). If sbopkg finds a package for the selected application - in the OUTPUT directory, then a new menu item will automagically - appear allowing the user to install the package. Thanks very much - to Erik Hanson for the initial code to get this working. Please - do test this functionality and let me know if there are any - issues. - * Much improved menu navigation -- the 'Return to Main Menu' feature - that appeared in the last release is now moved down as a button - next to "Ok" and "Back." Additionally, several of "Cancel" - buttons are renamed "Back." I think these changes greatly improve - things from a user interface perspective. Thanks to Erik Hanson - for the suggestions. - * There is a new option in sbopkg.conf "TERMBUILD" that allows a - user to optionally have the package building process step outside - of dialog and process in a regular terminal. Thanks to Erik - Hanson for the suggestion and patch to make this work. - * Create a pid file when sbopkg is first run and check for its - existence to prevent multiple instances of sbopkg from running. - Thanks to David Somero for the suggestion. - * Add in several bugfixes for the update list. Thanks to Erik - Hanson and The-spiki for the bug reports. -+--------------------------+ -Tue Aug 26 23:53:13 EST 2008 -Sbopkg version 0.10.0 released. This version contains the following -fixes and enhancements: + As a result of some of these new features, users are advised of + three changes to the sbopkg.conf file. Users can either + manually update their existing sbopkg.conf file or use the + sbopkg.conf.new file that is installed when you upgrade sbopkg. - * Committed a patch from that fixes ubuntulooks update bug, removes - ARCH from the update comparison code to prevent false positive - when different arches are used, and fixes libsigc++ and TiMidity++ - update bugs; thanks to Bert Babington for the patch. - * Modified the sbopkg.conf file to allow easier/more correct - exporting of variables; thanks to Ken Roberts for the patch and - helpful dialog on the issue. Please note that the default sbopkg - TMP has moved from /tmp to /tmp/SBo, so be sure to move your - permanent build log and package debugging list, if any, to the new - location. - * Renamed sbopkg.conf.sample to sbopkg.conf.new and incorporate a - doinst.sh script per general Slackware convention; thanks to Ken - Roberts for the suggestion, patch, and doinst.sh script. This - sbopkg.conf.new is the new 'sample' configuration file. As such, - please back up your old sbopkg.conf and then consider merging any - changes you made to your old sbopkg.conf and then renaming the - sbopkg.conf.new to sbopkg.conf. - * Add a "Return to Main Menu' function in the package information - menu; thanks to Murat D. Kadirov for the suggestion. - * Include fixes for several other packages in the update code. - * Fixed some typos; thanks to samac for the report. - * Add a feature to view the sbopkg README from the main menu. - * Lots and lots of little fixes, tweaks, and cleanups throughout the - script. The error checking and other similar low-level plumbing - issues are generally improved. - * Several changes/edits to the man pages and other documentation. -+--------------------------+ -Wed Aug 13 23:06:07 EST 2008 -Sbopkg version 0.0.9 released. This version contains the following -fixes and enhancements: + * OUTPUT is now required. This was commented out in prior + versions of sbopkg.conf. The default setting of OUTPUT is: - * Several bug fixes in the update list to prevent false positives. - Thanks to ktabic and Antoine for the bug reports. - * Fixed some things so that a user can now correctly set a different - TMP, SRCDIR, OUTPUT etc. in sbopkg.conf, which means that - someone can completely segregate sbopkg and it's related - SBo-building and package dumping directories, for example, - /sbo/tmp, /sbo/cache, /sbo/packages etc. See the sbopkg.conf(5) - man page for details. Thanks to Ken Roberts for the bug report. - * New features include the ability to clear the cache directory from - within the dialog interface and to display all installed SBo - packages in the dialog and cli. - * The search results page has been improved and the user can now - jump directly to a package's information menu from the search - results page. Thanks to Erik Hanson for the diffs, suggestions, - whitespace cleanups, and bug fixes. - * Menu navigation has been greatly improved so that sbopkg remembers - where you are when navigating up and down through the menus. - Again, big thanks to Erik Hanson for this improvement. -+--------------------------+ -Sun Aug 3 21:02:27 EST 2008 -Sbopkg version 0.0.8 released. The major addition to this version is -the ability to search for and display potential updates to SBo -packages installed on the user's system. There are also verious other -bug-fixes and code cleanups. Big thanks to Erik Hanson for his -suggestions and help with the new update code. -+--------------------------+ -Fri May 16 22:20:52 EST 2008 -Sbopkg version 0.0.7 released. This version contains the following -fixes and enhancements: + export OUTPUT=${OUTPUT:-/tmp} - * Sbopkg now properly creates the /home/sbo/12.1 directory if it - doesn't exist (or equivalent as set in sbopkg.conf). Note the - user still has to manually create the 'root' directory where the - SBo mirror will be held -- i.e. /home/sbo in this example. - * Category list menu has been tweaked to include the two new SBo - categories in the full view. - * Some old commented out cruft has been removed. -+--------------------------+ -Fri May 2 20:35:09 EST 2008 -Congratulations to Patrick and the Slackware team on the release of -Slackware 12.1. + this is the same default setting in SBo SlackBuild scripts + themselves. -Sbopkg version 0.0.6.1 released. The only change is to set the -default SBo repository to 12.1 and update the man pages etc. to -reference Slackware 12.1. Otherwise, there are no substantive changes -over 0.0.6. -+--------------------------+ -Sun Apr 13 10:24:27 EST 2008 -Sbopkg version 0.0.6 released. This version contains the following -fixes and enhancements: + * TERMBUILD is deprecated. All building and installing switches + now out of dialog and occurs in a terminal in all cases. + Having the build take place inside the dialog interface caused + some issues and made it difficult to implement some of the new + features. So, it went. As a result, you can delete TERMBUILD + from your sbopkg.conf file. - * Ability to rsync with and browse SBo repos for different Slackware - versions (currently 11.0 and 12.0, and will be updated when 12.1 - is out). - * Improved search functionality for cli. The -s switch is the same - as before, and will display the README, *.info etc. for a - particular package name. New, however, is -q, which will search - for packages by string and return a list of possible matches. - This is now the search used in the dialog interface as well. - * Various other cleanups and bugfixes. + * As mentioned above, DEBUG is a new required variable in the + sbopkg.conf file. The default setting is DEBUG=0. -Also, the sbopkg Google Groups list has been created: +sbopkg 0.15.0 (2008-12-11 02:45 UTC) -http://groups.google.com/group/sbopkg-discuss -+--------------------------+ -Wed Apr 2 14:29:36 EST 2008 -Sbopkg version 0.0.5 released. This version contains the following -fixes and enhancements: + Congrats to Patrick and the team on the new release of Slackware + 12.2. - * Users can now copy and edit the SlackBuild within the dialog - interface, keeping both the original and edited SlackBuild. - * Build packages using original or edited SlackBuild. - * Fixes to the permanent build log so it actually works from dialog - or cli. ;-) - * Ability to view/delete the permanent build log within dialog - interface. - * Basic search functionality built in to the dialog interface (shows - what category a piece of software is in); - * Better viewing of the README, .info, slack-desc, and SlackBuild - from cli. - * Various other cleanups. -+--------------------------+ -Sat Mar 29 12:26:00 EST 2008 -Sbopkg version 0.0.4 released. -+--------------------------+ -Fri Mar 28 00:18:23 EST 2008 -Sbopkg version 0.0.3 released. This version contains the following -fixes and enhancements: + * Slackware 12.2 is now the default Slackware version selected when + using sbopkg. - * More than one application can be searched at a time in the cli. - * Build process window remains in state correctly, as does the rsync - window. - * Source tarballs are saved in a separate SRCDIR directory and - symlinked to the build directory. - * Can browse this SRCDIR cache directory within the dialog - interface. - * Thanks to slackmagik for several of these excellent suggestions - and contributions. -+--------------------------+ -Wed Mar 26 12:00:00 EDT 2008 -Sbopkg version 0.0.2 released. -+--------------------------+ -Mon Mar 24 10:22:44 EDT 2008 -Sbopkg version 0.0.1 released. -+--------------------------+ + * Fix an issue where sometimes a built package was incorrectly + listed in the software info item menu, i.e. mplayer-codecs-all + instead of mplayer. Thanks to necropresto for the bug report. + + * Add --no-owner to default rsync flags to avoid having the local + SBo repo tagged with owner 1016 permissions. Thanks to Pierre + Cazenave for the bug report and Erik Hanson for the suggested + solution. + +sbopkg 0.14.1 (2008-12-04 09:35 UTC) + + * Fix issue where certain package names were showing up incorrectly + in the 'install' option - i.e. mplayer instead of + mplayer-codecs-all. Thanks to necropresto for the bug report. + + * A few little cleanups and cruft-removal. + +sbopkg 0.14.0 (2008-11-16 17:15 UTC) + + * Various fixes related to the SlackBuilds.org update changing + certain 'xx' to '++', such as TiMidity++, libsigc++, and libxml++. + + * The info item menus now display the repo's software version in the + menu title, and also display whether the package has been + installed at the top of the screen. This is a really nice + improvement. Thanks to Erik Hanson for the patch. + + * Improve the Control-C trapping. + + * Fix the issue where simply pressing 'Enter' in the search box + would result in all packages in the repo being listed as search + results. Now, it just returns to the main menu. + + * Fix xerces-c issue in the update list. Thanks to João Felipe + Santos for the bug report. + + * Lots of other little cleanups and cruft-removal. + + * Also, the sbopkg package itself now has a tag at the end, in + keeping with typical Slackware package convention. + + In addition, a new home page (http://www.sbopkg.org) has been set + up. Many thanks to the guys at cardinal.lizella.net, and their + colocation provider, Cyberlink International + (http://cyberlinkint.com) for the hosting. + +sbopkg 0.13.1 (2008-10-28 14:06 UTC) + + * A fix for OpenOffice.org not being picked up correctly on the + updatelist feature. Thanks to Erik Hanson for the bug report. + + * A fix for a couple issues that appeared with the changes to the + rsync and wget flags in version 0.13.0. Thanks to Ken Roberts and + Jorge Gaton for the bug reports. To remedy this problem, I have + removed TIMEOUT from sbopkg.conf and instead added two optional + variables, RSYNCFLAGS and WGETFLAGS. These options have been + populated with some of the flags that were previously in the + sbopkg script itself. This means that folks can manually tweak + the flags used by rsync and wget, although in most cases the + defaults should be left alone. This also means that for those who + are upgrading sbopkg from a previous version will again need to + manually update their sbopkg.conf from the sbopkg.conf.new that is + installed and merge the changes. Sorry about these changes to the + configuration file, but hopefully they are for the better since + these changes fix the problems mentioned previously and also give + the users a bit more control over the flags used, if desired. + +sbopkg 0.13.0 (2008-10-25 12:38 UTC) + + * New code has been added to allow the user to cleanly abort the + source download by pressing Control-C; thanks to Zordak for the + suggestion. + + * Add in several improvements to the rsync and wget stages, whereby + better error messages are detected and displayed, -z is removed + from rsync, and other general cleanups; thanks to macavity for the + suggestions and patches. + + * Add in -O option to wget to allow for cases where downloaded + source name is different than expected (such as virtualbox-ose); + thanks to acidchild for the bug report. + + * Add in new sbopkg.conf variable TIMEOUT to allow the user to + manually set the timeout value for rsync and wget; thanks to + macavity for the suggestion. NOTE: this will require users + upgrading from previous versions to either merge the new + sbopkg.conf into their existing file, or manually add a TIMEOUT=10 + (default is 10 seconds) to their existing sbopkg.conf file. + + * Add in several updatelist fixes; thanks to Erik Hanson for the bug + reports. + + * Add in fix where searching for category names would create + problems; thanks to nille for the bug report. + + * Add in some new code in an initial attempt to fix the 'decimal' + problem in bash, in which comparing package versions (like 3.9 + versus 3.11) would result in incorrect updatelist results. This + code should fix some updatelist errors reported by Erik Hanson, + samac, and João Felipe Santos. This new code needs testing, so + please check the updatelist and then consider running it with the + debug feature enabled and check the results the again. See the + UPDATELIST-DEBUGGING document for details on how to enable + debugging. + + * Fix size of several dialog boxes for a better UI; thanks to Erik + Hanson for the bug report. + + * Several error-checking and graceful exit cleanups and fixes. + +sbopkg 0.12.0 (2008-10-07 14:05 UTC) + + * New code that better catches MD5SUM failures and offers the + opportunity to delete the corrupted source. + + * New menu entry that allows a user to manually delete the saved + sources for any particular software in the SBo repository. Thanks + to Drew Ames for the bug reports and suggestions that led to both + of these two fixes and additions. + + * Add in ability to edit the *.info file in a similar manner to + editing the SlackBuild. With this addition, a user can now + manually update the .info and SlackBuild from within sbopkg and + build and install an updated package before it hits the repo. If + you use vi/vim as your EDITOR and want an easy way to insert the + MD5SUM of a new source tarball, try ":r! md5sum + /path/to/new/source". Then clean up the inserted information into + a proper .info file layout. Thanks to nille for prodding me to + get this done. + + * Move the editing functions into a submenu to better organize the + 'info item' menu for each software selection. Thanks to nille for + the suggestion. + + * Several error-checking and graceful exit cleanups and fixes. + +sbopkg 0.11.2 (2008-09-16 22:41 UTC) + + * The pid file is now properly removed when using sbopkg from the + cli; many thanks to LukenShiro for the bug report and help with + testing. + + * Checks for the various sbopkg-related directories and files are + improved. + + * A couple of updatelist fixes; thanks to LukenShiro for the bug + reports. + +sbopkg 0.11.1 (2008-09-12 17:32 UTC) + + This is a minor bug fix for version 0.11.0. + +sbopkg 0.11.0 (2008-09-12 14:51 UTC) + + * After many, _many_ requests, sbopkg now adds preliminary support + to install a package by calling upgradepkg --reinstall + --install-new. Currently, this new feature is only available in + the dialog interface (the cli version will include this feature + shortly). If sbopkg finds a package for the selected application + in the OUTPUT directory, then a new menu item will automagically + appear allowing the user to install the package. Thanks very much + to Erik Hanson for the initial code to get this working. Please + do test this functionality and let me know if there are any + issues. + + * Much improved menu navigation -- the 'Return to Main Menu' feature + that appeared in the last release is now moved down as a button + next to "Ok" and "Back." Additionally, several of "Cancel" + buttons are renamed "Back." I think these changes greatly improve + things from a user interface perspective. Thanks to Erik Hanson + for the suggestions. + + * There is a new option in sbopkg.conf "TERMBUILD" that allows a + user to optionally have the package building process step outside + of dialog and process in a regular terminal. Thanks to Erik + Hanson for the suggestion and patch to make this work. + + * Create a pid file when sbopkg is first run and check for its + existence to prevent multiple instances of sbopkg from running. + Thanks to David Somero for the suggestion. + + * Add in several bugfixes for the update list. Thanks to Erik + Hanson and The-spiki for the bug reports. + +sbopkg 0.10.0 (2008-08-27 04:53 UTC) + + * Committed a patch from that fixes ubuntulooks update bug, removes + ARCH from the update comparison code to prevent false positive + when different arches are used, and fixes libsigc++ and TiMidity++ + update bugs; thanks to Bert Babington for the patch. + + * Modified the sbopkg.conf file to allow easier/more correct + exporting of variables; thanks to Ken Roberts for the patch and + helpful dialog on the issue. Please note that the default sbopkg + TMP has moved from /tmp to /tmp/SBo, so be sure to move your + permanent build log and package debugging list, if any, to the new + location. + + * Renamed sbopkg.conf.sample to sbopkg.conf.new and incorporate a + doinst.sh script per general Slackware convention; thanks to Ken + Roberts for the suggestion, patch, and doinst.sh script. This + sbopkg.conf.new is the new 'sample' configuration file. As such, + please back up your old sbopkg.conf and then consider merging any + changes you made to your old sbopkg.conf and then renaming the + sbopkg.conf.new to sbopkg.conf. + + * Add a "Return to Main Menu' function in the package information + menu; thanks to Murat D. Kadirov for the suggestion. + + * Include fixes for several other packages in the update code. + + * Fixed some typos; thanks to samac for the report. + + * Add a feature to view the sbopkg README from the main menu. + + * Lots and lots of little fixes, tweaks, and cleanups throughout the + script. The error checking and other similar low-level plumbing + issues are generally improved. + + * Several changes/edits to the man pages and other documentation. + +sbopkg 0.0.9 (2008-08-14 04:06 UTC) + + * Several bug fixes in the update list to prevent false positives. + Thanks to ktabic and Antoine for the bug reports. + + * Fixed some things so that a user can now correctly set a different + TMP, SRCDIR, OUTPUT etc. in sbopkg.conf, which means that someone + can completely segregate sbopkg and it's related SBo-building and + package dumping directories, for example, /sbo/tmp, /sbo/cache, + /sbo/packages etc. See the sbopkg.conf(5) man page for details. + Thanks to Ken Roberts for the bug report. + + * New features include the ability to clear the cache directory from + within the dialog interface and to display all installed SBo + packages in the dialog and cli. + + * The search results page has been improved and the user can now + jump directly to a package's information menu from the search + results page. Thanks to Erik Hanson for the diffs, suggestions, + whitespace cleanups, and bug fixes. + + * Menu navigation has been greatly improved so that sbopkg remembers + where you are when navigating up and down through the menus. + Again, big thanks to Erik Hanson for this improvement. + +sbopkg 0.0.8 (2008-08-04 02:02 UTC) + + * The major addition to this version is the ability to search for + and display potential updates to SBo packages installed on the + user's system. There are also verious other bug-fixes and code + cleanups. Big thanks to Erik Hanson for his suggestions and help + with the new update code. + +sbopkg 0.0.7 (2008-05-17 03:20 UTC) + + * Sbopkg now properly creates the /home/sbo/12.1 directory if it + doesn't exist (or equivalent as set in sbopkg.conf). Note the + user still has to manually create the 'root' directory where the + SBo mirror will be held -- i.e. /home/sbo in this example. + + * Category list menu has been tweaked to include the two new SBo + categories in the full view. + + * Some old commented out cruft has been removed. + +sbopkg 0.0.6.1 (2008-05-03 01:35 UTC) + + Congratulations to Patrick and the Slackware team on the release of + Slackware 12.1. + + * The only change is to set the default SBo repository to 12.1 and + update the man pages etc. to reference Slackware 12.1. Otherwise, + there are no substantive changes over 0.0.6. + +sbopkg 0.0.6 (2008-04-13 15:24 UTC) + + * Ability to rsync with and browse SBo repos for different Slackware + versions (currently 11.0 and 12.0, and will be updated when 12.1 + is out). + + * Improved search functionality for cli. The -s switch is the same + as before, and will display the README, *.info etc. for a + particular package name. New, however, is -q, which will search + for packages by string and return a list of possible matches. + This is now the search used in the dialog interface as well. + + * Various other cleanups and bugfixes. + + Also, the sbopkg Google Groups list has been created: + + http://groups.google.com/group/sbopkg-discuss + +sbopkg 0.0.5 (2008-04-02 19:29 UTC) + + * Users can now copy and edit the SlackBuild within the dialog + interface, keeping both the original and edited SlackBuild. + + * Build packages using original or edited SlackBuild. + + * Fixes to the permanent build log so it actually works from dialog + or cli. ;-) + + * Ability to view/delete the permanent build log within dialog + interface. + + * Basic search functionality built in to the dialog interface (shows + what category a piece of software is in); + + * Better viewing of the README, .info, slack-desc, and SlackBuild + from cli. + + * Various other cleanups. + +sbopkg 0.0.4 (2008-03-29 17:26 UTC) + +sbopkg 0.0.3 (2008-03-28 05:18 UTC) + + * More than one application can be searched at a time in the cli. + + * Build process window remains in state correctly, as does the rsync + window. + + * Source tarballs are saved in a separate SRCDIR directory and + symlinked to the build directory. + + * Can browse this SRCDIR cache directory within the dialog + interface. + + * Thanks to slackmagik for several of these excellent suggestions + and contributions. + +sbopkg 0.0.2 (2008-03-26 16:00 UTC) + +sbopkg 0.0.1 (2008-03-24 14:22 UTC) diff --git a/src/usr/doc/README b/src/usr/doc/README index 1dc26e7..1fe2d7c 100644 --- a/src/usr/doc/README +++ b/src/usr/doc/README @@ -1,64 +1,89 @@ -# $Id$ -# vim:set ft=: +SBOPKG README -Sbopkg README -Copyright 2007-2010 Chess Griffin -Copyright 2009-2010 Mauro Giachero - slakmagik +SBOPKG COPYRIGHT/LICENSE -Homepage: http://www.sbopkg.org + Copyright 2007-2010 Chess Griffin + Copyright 2009-2010 Mauro Giachero + slakmagik + + Sbopkg is released under a one-clause BSD license. See the script + itself for the text. ABOUT -Sbopkg (pronounced s-b-o-package) is a command-line and dialog-based tool to -synchronize with the SlackBuilds.org ("SBo") repository, a collection of -third-party SlackBuild scripts to build Slackware packages. Sbopkg can also -synchronize with certain third-party repositories or access a -locally-maintained repository. + Sbopkg (pronounced 's-b-o-package') is a command-line and + menu-based tool to synchronize with the SlackBuilds.org ('SBo') + repository, a collection of third-party SlackBuild scripts to build + Slackware packages. Sbopkg can also synchronize with any repository + with an SBo-compatible hierarchy, including a locally-maintained + repository. -Sbopkg will allow the user to create, synchronize, search, and browse a copy -of the active repository (currently, the size of a local copy of the SBo -repository is xxxSIZExxx), read the ChangeLog (if available), list the -installed SBo packages, display potential updates to SlackBuilds.org packages, -view the README, SlackBuild, .info, and slack-desc files for each package, and -make manual edits to a copy of the original .info or SlackBuild files. Sbopkg -will also allow the user to select packages to build and it will download the -source code, check the md5sum, build a Slackware package, and, optionally -install the package. The user can also build, and optionally install, more -than one package by using the 'build queue' feature. Sbopkg will not check -dependencies since that is not a feature native to Slackware, but since the -build queue will process packages in the order listed, it sometimes may be -possible to build and install dependencies in order prior to building and -installing the final, desired package. Given the nature of building -dependencies, however, this probably will not always work and is not really a -supported feature. Ultimately, Sbopkg is one thing and one thing only: a -medium to easily browse a local copy of the SlackBuilds.org and certain other -repositories and build packages from them. + Sbopkg will allow the user to create, synchronize, search, and + browse a copy of the active repository (currently, the size of a + local copy of the SBo repository is xxxSIZExxx), read the ChangeLog + (if available), list the installed SBo packages, display potential + updates to SlackBuilds.org packages, view the README, SlackBuild, + .info, and slack-desc and other files for each package, and make + manual edits to a copy of the original .info or SlackBuild files. + Sbopkg will also allow the user to select packages to build and it + will download the source code, check the md5sum, build a Slackware + package, and optionally install the package. The user can also build + and optionally install more than one package by using the 'build + queue' feature. Sbopkg will not check dependencies since that is not + a feature native to Slackware, but since the build queue will + process packages in the order listed, it is possible to build and + install dependencies in order prior to building and installing the + final, desired package. -Sbopkg can be also be used strictly from the command line without the -dialog interface to do most of the above items. Typing sbopkg -h -will display the command line options. + Sbopkg can also be used strictly from the command line without the + dialog(1)-provided menu interface to do most of the above items. + Typing 'sbopkg -h' will display the command line options. HELP -Sbopkg comes with two man pages: sbopkg.conf(5) and sbopkg(8). These -man pages are kept up-to-date with functional changes in the script -itself, so they are a good source of information on how to use sbopkg. + Sbopkg comes with two man pages: sbopkg.conf(5) and sbopkg(8). These + are the primary sources of information on how to use sbopkg. -If the man pages are not sufficient, please consider joining the sbopkg -mailing list and posting your question there. You should be able to -subscribe by sending mail to sbopkg-users-request@sbopkg.org whose body -is 'subscribe your-email@address-here'. There is also an IRC channel for -sbopkg on Freenode at #sbopkg. Further information on all of these -resources is on the project's website at http://www.sbopkg.org - click -the "Docs/Help" tab. + If you have read the manuals and still need help, you may want to + join the sbopkg mailing list. Subscribe by sending a mail whose body + is "subscribe your-email@address-here" to: -CONTRIBUTORS + sbopkg-users-request@sbopkg.org -We welcome bug reports, suggestions, patches, or feature requests. -Please post any of these to the Issue tracker (kind of like a -Bugzilla) on the project's Google page (click the Issues tab) at -http://code.google.com/p/sbopkg so we can keep track of them. There -have been many contributors so far, and they are all mentioned near -the top of the sbopkg script itself. Thanks to everyone who has -helped make this script better. + or use the web interface: + + http://sbopkg.org/mailman/listinfo/sbopkg-users + + There is also an IRC channel for sbopkg on Freenode at #sbopkg. + + Further information on these and other resources is on the project + website: + + http://sbopkg.org + + Specifically, the documentation page is: + + http://sbopkg.org/docs.php + +CONTRIBUTING + + We welcome bug reports, suggestions/feature requests, and patches. + Please post any of these to the issue tracker: + + http://code.google.com/p/sbopkg/issues/list + + Before reporting a bug, please check the KNOWN_ISSUES file. Before + contributing a suggestion please check the TODO file. Before + submitting a patch, please read the HACKING file. + + Sbopkg's source is available in an svn repository hosted on + googlecode. To view a copy of the repo, see: + + http://code.google.com/p/sbopkg/source/browse/ + + To obtain a local copy, use something like the following command: + + svn checkout http://sbopkg.googlecode.com/svn/trunk/ sbopkg-contrib + + There have been many contributors so far (see the THANKS file). + Thanks to everyone who has helped make this script better. diff --git a/src/usr/doc/README-queuefiles b/src/usr/doc/README-queuefiles index 5508f68..c9659b1 100644 --- a/src/usr/doc/README-queuefiles +++ b/src/usr/doc/README-queuefiles @@ -1,80 +1,91 @@ -# $Id$ -# vim:set ft=: +README-queuefiles -Sbopkg queuefiles are very simple to create, maintain, and share amongst other -users. Each queuefile can contain a list of applications to build in order, -from top to bottom, and should be named with a .sqf extension. Several sample -queuefiles are provided in the /doc/queuefiles directory. Please note that -these queuefiles are, in fact, only samples and have not necessarily been -tested on the latest release of Slackware or on Slackware -current. Please -use at your risk. Additionally, the hope is that user-contributed queues can -be shared. Please consider sending a copy of your queuefile to the sbopkg -mailing list located at: http://sbopkg.org/mailman/listinfo/sbopkg-users. +Sbopkg queuefiles are very simple to create, maintain, and share amongst +other users. Each queuefile can contain a list of packages to build in +order, from top to bottom, and should be named with a .sqf extension. +Several sample queuefiles are provided in the /doc/queuefiles directory. +Please note that these queuefiles are, in fact, only samples and have +not necessarily been tested on the latest release of Slackware or on +Slackware -current. If you wish to use these at your own risk, remove +the '.sample' extension and either put them in QUEUEDIR or set QUEUEDIR +to where they are (see sbopkg.conf(5) for details). Additionally, the +hope is that user-contributed queues can be shared. Please consider +sending a copy of your queuefile(s) to the sbopkg mailing list located +at http://sbopkg.org/mailman/listinfo/sbopkg-users. -1. Selecting ON or OFF in dialog: +SELECTING ON OR OFF IN DIALOG -If the application's name is left alone, it will default to 'ON,' or -selected, in the sbopkg dialog menus when the queuefile is loaded. If -the application's name is prepended with a '-' it will default to -'OFF,' or deselected, in the dialog menus. + If a line starts with an application's name, it will default to 'ON' + and be selected in the sbopkg dialog menus when the queuefile is + loaded. If the application's name is prepended with a '-' it will + default to 'OFF' and be deselected in the dialog menus. -For example, a queuefile might contain: + For example, a queuefile might contain: -foo --bar -baz + foo + -bar + baz -In this case, both 'foo' and 'baz' will appear 'ON,' or selected, in the sbopkg -dialog menus, and 'bar' will appear 'OFF,' or deselected. + In this case, both 'foo' and 'baz' will be 'ON' and appear selected + in the sbopkg dialog menus, and 'bar' will be 'OFF' and appear + deselected. -2. Recursive queuefiles: +RECURSIVE QUEUEFILES -Additionally, queuefiles may be loaded recursively. This means the user can -have separate queuefiles for certain applications, or certain queues, and then -a 'master' queuefile can bring them all together. Recursively-loaded queues -are indicated by a '@' prepended to the name of the queuefile. + Additionally, queuefiles may be loaded recursively. This means the + user can have separate queuefiles for certain applications, or + certain queues, and then a 'master' queuefile can bring them all + together. Recursively-loaded queues are indicated by an '@' + prepended to the name of the queuefile. -For example, a user might have one queuefile named 'multimedia.sqf' with these -items: + For example, a user might have one queuefile named 'multimedia.sqf' + with these items: -app1 -app2 -app3 + app1 + app2 + app3 -And then the user might have another queuefile named 'mydesktop.sqf' with -these items: + And then the user might have another queuefile named 'mydesktop.sqf' + with these items: -app4 -app5 -@multimedia.sqf + app4 + app5 + @multimedia.sqf -In this case, when the 'mydesktop.sqf' queuefile is loaded, it will first load -app4, then app5, then the contents of the multimedia.sqf queuefile. The final -queue will look like this: + In this case, when the 'mydesktop.sqf' queuefile is loaded, it will + first load app4, then app5, then the contents of the multimedia.sqf + queuefile. The final queue will look like this: -app4 -app5 -app1 -app2 -app3 + app4 + app5 + app1 + app2 + app3 -3. Passing build options: + (Note that, while a given queuefile must have the .sqf extension to + be loaded, the extension is optional within queuefiles. For + instance, if multimedia.sqf exists in the QUEUEDIR, '@multimedia' + would work in the above example.) -Finally, it is possible to pass build options for an application in a -queuefile. This is done by using a single pipe ('|') character after the -application name. For example: +PASSING BUILD OPTIONS -app | FOO=yes BAR=no + Finally, it is possible to pass build options for an application in + a queuefile. This is done by using a single pipe ('|') character + after the application name (spaces are optional). For example: -Only use one pipe to separate the application name and the variables. + app | FOO=yes BAR=no -In case the user has saved build options individually in the dialog interface, -and also puts build options for that same application in the queuefile, sbopkg -will ask the user which one should be used. + Only use one pipe to separate the application name and the + variables. -4. Multiple instances. + In case the user has saved build options individually in the dialog + interface, and also puts build options for that same application in + the queuefile, sbopkg will ask the user which one should be used. -In all cases, whether loading software names more than once, or indicating -build options in more than one queuefile, the first instance will apply. So -if a user has "app" in one queuefile, and "-app" in a recursive queuefile that -is loaded further down the list, the first instance, or "app" will prevail. +DUPLICATE BUILDS/OPTIONS + + In all cases, whether loading software names more than once, or + indicating build options in more than one queuefile, the first + instance will apply. So if a user has "app" in one queuefile, and + "-app" in a recursive queuefile that is loaded further down the + list, the first instance, or "app" will prevail. diff --git a/src/usr/doc/README-renames.d b/src/usr/doc/README-renames.d index 65b0bf6..75b5acb 100644 --- a/src/usr/doc/README-renames.d +++ b/src/usr/doc/README-renames.d @@ -1,14 +1,20 @@ -# $Id$ -# vim:set ft=: +README-renames.d The /etc/sbopkg/renames.d directory is the directory that holds files -associated with renamed software in the SlackBuilds.org repository. The -default file that is installed with sbopkg is '50-default'. This file will be -overwritten each time sbopkg is upgraded, so do not make local edits to it. -Instead, create other files with a higher or lower number than 50-default and -list your renamed files in those local files. The files are loaded in -alphabetical order (like the files in /etc/fonts/conf.d) so 'priority' -is determined from low number to high and the first match wins, so: +associated with renamed software in the SlackBuilds.org repository. + +Renames are written, one per line, in the following format: + +oldname=newname + +The default file that is installed with sbopkg is '50-default'. This +file will be overwritten each time sbopkg is upgraded, so do not make +local edits to it. Instead, create other files with a higher or lower +number than 50-default and list your renamed files in those local files. + +The files are loaded in alphabetical order (like the files in, e.g., +/etc/fonts/conf.d) so 'priority' is determined from low number to high +and the first match wins, so: $ cat /etc/sbopkg/renames.d/10-local foo=bar @@ -18,7 +24,3 @@ will override anything in a higher-numbered file, including anything in $ cat /etc/sbopkg/renames.d/50-default foo=baz - -Renames are written in the following format: - -oldname=newname diff --git a/src/usr/doc/README-repos.d b/src/usr/doc/README-repos.d index e6a1499..279cca9 100644 --- a/src/usr/doc/README-repos.d +++ b/src/usr/doc/README-repos.d @@ -1,40 +1,49 @@ -# $Id$ -# vim:set ft=: +README-repos.d -In sbopkg parlance, a "repository" is a local or remote service used as a -source of scripts. For example, slackbuilds.org is a repository. The -builds.slamd64.com project is another repository. Every repository has one or -more "branches". Branches consist of a single tree of scripts. For example, -slackbuilds.org has a 11.0 branch, a 12.0 branch and so on. +In sbopkg parlance, a "repository" is a local or remote service used as +a source of SlackBuilds. For example, slackbuilds.org is a repository. +The builds.slamd64.com project is another repository. Every repository +has one or more "branches". Branches consist of a single tree of scripts +in a category/application hierarchy. For example, slackbuilds.org has a +11.0 branch, a 12.0 branch and so on. /etc/sbopkg/repos.d is a directory containing files defining the -sbopkg-supported repositories and branches. All *.repo files are scanned in -alphabetical order. Every line in a *.repo file defines a branch. Each line -is compound of the following seven fields: - -1. REPOSITORY (a _short_ name identifying the repository) -2. BRANCH (a _short_ name identifying the branch of that repository) -3. DESCRIPTION (a <50 chars description, which _must_be_quoted_) -4. TAG (the packages' tag) -5. TOOL (rsync, git or "", is the tool able to check out the repository/branch) -6. LINK (the tool-dependent link to the branch) -7. CHECKGPG (whether the repo provides .asc signature files and signed - tarballs that can be verified with GPG) - -For example, one branch (line) of the sbo.repo file might look like this (note -the seven fields): - -SBo 12.2 "SBo repository for Slackware 12.2" _SBo rsync slackbuilds.org::slackbuilds/12.2 GPG - -If TOOL is set to "", then it will not be possible to automatically update the -branch (i.e., it has no upstream). This is most commonly used for -locally-maintained repositories on the host filesystem that do not use rsync -or git to pull down the repository tree. The LINK format is essentially what -is required to be passed to the specified TOOL. In case of git links, it -_must_ be in the form url@branch. If TOOL is "", LINK is ignored (but _must_ -still be present). CHECKGPG format can be "GPG" if the repo supports GPG -checking, or "" (which also must be present) if the repo does not support GPG -checks. - -Lines _containing_ # are ignored when parsing the files. Lines containing +repositories and branches sbopkg will use. All *.repo files are scanned +in alphabetical order. Every line in a *.repo file defines a branch +except those _containing_ a '#' which are ignored. Lines containing backslashes (\) are not allowed. + +Each line contains the following seven fields (if a field is not +applicable, it still _must_ be present in the form of an empty quote +(""): + +1. REPO + A _short_ name identifying the repository; e.g., 'SBo'. +2. BRANCH + A _short_ name identifying the branch of that repository; e.g., + '11.0'. +3. DESCRIPTION + A description of the repo, which _must be quoted_ and must be less + than 50 characters long; e.g., '"SBo repository for Slackware + 11.0"'. +4. TAG + The tag the built packages will have; e.g., '_SBo'. +5. TOOL + The tools used to download the repository/branch. The currently + supported value is 'rsync'. Using 'git' is also possible. Local + repos will have an empty quote. If this field is an empty quote, it + will not be possible to automatically update the branch (i.e., it + has no upstream). +6. LINK + The link (URL) to the branch that the TOOL will use. Local repos + will have an empty quote. In the case of git links, it _must_ be in + the form url@branch. +7. CHECKGPG + Filled with 'GPG' if the repo provides .asc signature files and + signed tarballs that can be verified with GPG, and an empty quote + otherwise. + +For example, one branch (line) of the sbo.repo file looks like this +(note the seven fields): + +SBo 11.0 "SBo repository for Slackware 11.0" _SBo rsync slackbuilds.org::slackbuilds/11.0 GPG diff --git a/src/usr/doc/THANKS b/src/usr/doc/THANKS new file mode 100644 index 0000000..dcea589 --- /dev/null +++ b/src/usr/doc/THANKS @@ -0,0 +1,71 @@ +SBOPKG THANKS + +The following people have contributed to the development of sbopkg. They +are generally listed by the revision number the effect of their first +contribution entered the trunk, followed by their alternate name(s) (if +any), and the type(s) of contributions. This script would not be where +it is without the help of these folks. If we left anyone out, we +apologize. Thank you! + + 1 Chess Griffin (project initiation, bug reports, suggestions, code) + 14 Bob Lounsbury (suggestion) + 14 Robby Workman (suggestion) + 14 Alan Hicks (suggestion) + 14 Paul Wisehart (suggestion + 14 Phillip Warner (bug reports, suggestion) + 14 slakmagik (bug reports, suggestions, code) + ?? Eric Hameleers (?,code) + ?? Michiel van Wessem (?) + 30 hba (patch) + 77 Erik Hanson (suggestions, patches) + ?? Antoine (bug report) + 97 ktabic (bug report) + 97 Ken Roberts (bug report) + 120 samac (bug report) + 122 Bert Babington (patch) + 123 Murat D. Kadirov [banderols] (suggestion) + 157 The-spiki (bug report, suggestion) + 160 David Somero (bug report) + 174 LukenShiro (bug reports) + 182 Drew Ames (bug report, suggestion) + 186 nille (suggestion) + 192 acidchild (bug report) + ??? mancha (?) + 194 macavity (patch, suggestion) + 197 Zordrak (suggestion) + 201 Joao Felipe Santos (bug report) + 205 Jorge Gaton (bug report) + 213 cotterochan (bug report) + 228 necropresto (bug report) + 230 Pierre Cazenave (bug report) + 257 Mauro Giachero (bug reports, suggestions, code) + 259 The-Croupier (suggestion) + 282 Wade Grant (bug report) + 283 SpacePlod (bug report) + 389 TSquaredF (suggestion) + 398 alkos333 (suggestion, code) + 418 Gregory Tourte [artourter] (bug reports, suggestions) + 464 Marie-Claude Collilieux (translations) + 534 Glenn Becker (bug reports) + 534 jturning (bug report) + 584 David Spencer (bug reports; testing fix) + 641 NaCl (bug report) + 661 neonflux (bug report) + 673 Marco Bonetti (suggestion) + 696 dive (suggestion) + 700 idknow (bug report) + 706 slackhead (bug report) + 716 happyslacker (suggestion) + 720 pokipoki08 (suggestion) + 723 SiegeX (bug report and suggestions) + 723 Zmyrgel (bug report and suggestions) + 723 BCarey (bug report and suggestions) + 735 godling (bug report) + 748 Matteo Bernardini (suggestion) + 757 agikhan (suggestion) + 770 slava18 (bug reports) + 772 skalkoto (bug report) + 828 Marc Payne (confirming bug report) + 847 catkin (bug report) + 849 chytraeus (bug report) + 850 greinze (bug report) diff --git a/src/usr/doc/TODO b/src/usr/doc/TODO index e9d3a91..c876caf 100644 --- a/src/usr/doc/TODO +++ b/src/usr/doc/TODO @@ -1,27 +1,29 @@ -# $Id$ -# vim:set ft=: +SBOPKG TODO -Sbopkg TODO (in no particular order) -* Add in better traps and error checks so a user can safely exit (by pressing - Control-C) during the source download or during the package building - process. I have spent a _lot_ of time hacking on this but have not come up - with a workable solution yet. The problem is that many subprocesses are - forked off during the package building process and it's difficult to capture - all the pids. If anyone wants to help with this, please let me know. - of sbopkg 0.26.0. -* Include a way to change the sync from rsync to lftp for those who have rsync - blocked. -* Figure out proper way of testing getopts in order to prevent certain cli - options from being used together, such as -b and -i. Right now, there is a - crude test to prevent -b and -i from being used together, but I know there - is a better way. -* Add 'long' switches to the cli options, i.e. --build in addition to the - current -b switch. This is pretty low priority, IMHO, and something tells - me that getopts does not like long options anyway. -* Maybe change all instances of 'dialog' to $DIALOG and set $DIALOG to be a - variable equal to either 'dialog' or 'xdialog' in case someone wanted to run - sbopkg using xdialog. I don't know how compatible dialog is with xdialog so - if there was breakage, I would not want to really address it as being able - to use xdialog is not important to me. I prefer dialog anyway. -* More error checking. -* General code cleanups. +Items should be grouped by {High,Medium,Low} Priorities with sub-groups +of {Feature,Modification,Bugfix} Categories. + +MEDIUM PRIORITY + + Feature Category + + * Allow lftp as a sync method. + + Modification Category + + * Properly test supplied options to ensure that only sensible + option combinations are allowed, thus replacing the current + crude test which only prevents -b and -i from being used + together. + +LOW PRIORITY + + Feature Category + + * Replace getopts call with custom option parsing and add 'long' + switches to the cli options (for example, '--build' in + addition to the current '-b' switch). + + * Replace all calls to dialog with a DIALOG variable (which + would still default to dialog), allowing users to more easily + try other interfaces. diff --git a/src/usr/doc/queuefiles/abiword.sqf b/src/usr/doc/queuefiles/abiword.sqf.sample similarity index 100% rename from src/usr/doc/queuefiles/abiword.sqf rename to src/usr/doc/queuefiles/abiword.sqf.sample diff --git a/src/usr/doc/queuefiles/audacity.sqf b/src/usr/doc/queuefiles/audacity.sqf.sample similarity index 100% rename from src/usr/doc/queuefiles/audacity.sqf rename to src/usr/doc/queuefiles/audacity.sqf.sample diff --git a/src/usr/doc/queuefiles/dvdrip_build.sqf b/src/usr/doc/queuefiles/dvdrip_build.sqf.sample similarity index 90% rename from src/usr/doc/queuefiles/dvdrip_build.sqf rename to src/usr/doc/queuefiles/dvdrip_build.sqf.sample index dd0fadf..58284f2 100644 --- a/src/usr/doc/queuefiles/dvdrip_build.sqf +++ b/src/usr/doc/queuefiles/dvdrip_build.sqf.sample @@ -11,7 +11,7 @@ perl-event perl-libintl lsdvd # mplayer is available in /extra for current/13.0 -# You may wish to recompile it to include the ability to read +# You may wish to recompile it to include the ability to read # encrypted DVDs though. See its SlackBuild for more info. -mplayer ogmtools diff --git a/src/usr/doc/queuefiles/enlightenment.sqf b/src/usr/doc/queuefiles/enlightenment.sqf.sample similarity index 100% rename from src/usr/doc/queuefiles/enlightenment.sqf rename to src/usr/doc/queuefiles/enlightenment.sqf.sample diff --git a/src/usr/doc/queuefiles/ffmpeg.sqf b/src/usr/doc/queuefiles/ffmpeg.sqf.sample similarity index 100% rename from src/usr/doc/queuefiles/ffmpeg.sqf rename to src/usr/doc/queuefiles/ffmpeg.sqf.sample diff --git a/src/usr/doc/queuefiles/ffmpeg_build.sqf b/src/usr/doc/queuefiles/ffmpeg_build.sqf.sample similarity index 100% rename from src/usr/doc/queuefiles/ffmpeg_build.sqf rename to src/usr/doc/queuefiles/ffmpeg_build.sqf.sample diff --git a/src/usr/doc/queuefiles/gnome-print.sqf b/src/usr/doc/queuefiles/gnome-print.sqf.sample similarity index 100% rename from src/usr/doc/queuefiles/gnome-print.sqf rename to src/usr/doc/queuefiles/gnome-print.sqf.sample diff --git a/src/usr/doc/queuefiles/gnucash.sqf b/src/usr/doc/queuefiles/gnucash.sqf.sample similarity index 100% rename from src/usr/doc/queuefiles/gnucash.sqf rename to src/usr/doc/queuefiles/gnucash.sqf.sample diff --git a/src/usr/doc/queuefiles/gpodder.sqf b/src/usr/doc/queuefiles/gpodder.sqf.sample similarity index 100% rename from src/usr/doc/queuefiles/gpodder.sqf rename to src/usr/doc/queuefiles/gpodder.sqf.sample diff --git a/src/usr/doc/queuefiles/mlt-openshot.sqf b/src/usr/doc/queuefiles/mlt-openshot.sqf.sample similarity index 96% rename from src/usr/doc/queuefiles/mlt-openshot.sqf rename to src/usr/doc/queuefiles/mlt-openshot.sqf.sample index e8e9a09..bd592af 100644 --- a/src/usr/doc/queuefiles/mlt-openshot.sqf +++ b/src/usr/doc/queuefiles/mlt-openshot.sqf.sample @@ -6,4 +6,4 @@ libdv libsamplerate @ffmpeg.sqf libquicktime -mlt \ No newline at end of file +mlt diff --git a/src/usr/doc/queuefiles/multimedia.sqf b/src/usr/doc/queuefiles/multimedia.sqf.sample similarity index 100% rename from src/usr/doc/queuefiles/multimedia.sqf rename to src/usr/doc/queuefiles/multimedia.sqf.sample diff --git a/src/usr/doc/queuefiles/octave_build.sqf b/src/usr/doc/queuefiles/octave_build.sqf.sample similarity index 100% rename from src/usr/doc/queuefiles/octave_build.sqf rename to src/usr/doc/queuefiles/octave_build.sqf.sample diff --git a/src/usr/doc/queuefiles/openbox-plus.sqf b/src/usr/doc/queuefiles/openbox-plus.sqf.sample similarity index 100% rename from src/usr/doc/queuefiles/openbox-plus.sqf rename to src/usr/doc/queuefiles/openbox-plus.sqf.sample diff --git a/src/usr/doc/queuefiles/openshot.sqf b/src/usr/doc/queuefiles/openshot.sqf.sample similarity index 96% rename from src/usr/doc/queuefiles/openshot.sqf rename to src/usr/doc/queuefiles/openshot.sqf.sample index 4b2a2c6..dfad75a 100644 --- a/src/usr/doc/queuefiles/openshot.sqf +++ b/src/usr/doc/queuefiles/openshot.sqf.sample @@ -5,11 +5,11 @@ # /var/lib/sbopkg/queues directory # openshot.sqf # mlt-openshot.sqf -# +# @mlt-openshot.sqf frei0r goocanvas pygoocanvas pyxdg -openshot \ No newline at end of file +openshot diff --git a/src/usr/doc/queuefiles/simple-desktop.sqf b/src/usr/doc/queuefiles/simple-desktop.sqf.sample similarity index 100% rename from src/usr/doc/queuefiles/simple-desktop.sqf rename to src/usr/doc/queuefiles/simple-desktop.sqf.sample diff --git a/src/usr/doc/queuefiles/transcode_build.sqf b/src/usr/doc/queuefiles/transcode_build.sqf.sample similarity index 100% rename from src/usr/doc/queuefiles/transcode_build.sqf rename to src/usr/doc/queuefiles/transcode_build.sqf.sample diff --git a/src/usr/sbin/sbopkg b/src/usr/sbin/sbopkg index 3f91143..80c579a 100755 --- a/src/usr/sbin/sbopkg +++ b/src/usr/sbin/sbopkg @@ -23,21 +23,6 @@ # LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING # NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS # SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. -# -# Slackware is a registered trademark of Patrick Volkerding. -# Linux is a registered trademark of Linus Torvalds. -# -# Other contributors: Bob Lounsbury, Robby Workman, Alan Hicks, Paul -# Wisehart, slakmagik, Eric Hameleers, Michiel van Wessem, hba, Erik Hanson, -# Antoine, ktabic, Ken Roberts, samac, Bert Babington, Murat D. Kadirov, -# The-spiki, David Somero, LukenShiro, Drew Ames, nille, acidchild, mancha, -# macavity, Zordrak, João Felipe Santos, cotterochan, necropresto, Pierre -# Cazenave, Mauro Giachero, The-Croupier, Wade Grant, TSquaredF, alkos333, -# Marco Bonetti and Gregory Tourte. -# This script would not be where it is without the help of these folks. -# If I left anyone out, I apologize. Thank you! -# -#set -x dialog_refresh_workaround() { # Dialog has refresh problems on some terminals (currently known are some