add several sample queuefiles in new doc/queuefiles directory; modify man pages and README-queuefiles

src/usr/doc/README-queuefiles

@@ -1,11 +1,17 @@
 # $Id$
 
-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.  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.
+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.
+
+1.  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.
 
 For example, a queuefile might contain:
 
@@ -16,6 +22,8 @@ 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.
 
+2.  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
@@ -45,6 +53,8 @@ app1
 app2
 app3
 
+3.  Passing build options:
+
 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:
@@ -57,6 +67,8 @@ 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.
 
+4.  Multiple instances.
+
 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

src/usr/doc/queuefiles/abiword.sqf

@@ -0,0 +1,11 @@
+# Sbopkg queuefile for abiword
+# Tested on Slackware 12.2
+# Created by Chess Griffin
+
+gail
+wv
+libgnomecanvas
+libgnomecups
+libgnomeprint
+libgnomeprintui
+abiword

src/usr/doc/queuefiles/audacity.sqf

@@ -0,0 +1,12 @@
+# Sbopkg queuefile for Audacity.
+# Tested on Slackware 12.2
+# Created by Chess Griffin
+#
+# Note: soundtouch and twolame are optional, and require tweaking the
+# Audacity SlackBuild if you want to include them.
+
+-soundtouch
+-twolame
+wxGTK
+libsndfile
+audacity

src/usr/doc/queuefiles/gnucash.sqf

@@ -0,0 +1,24 @@
+# Sbopkg queuefile for gnucash
+# Tested on Slackware 12.2
+# Created by Chess Griffin
+
+slib
+libofx
+ORBit2
+GConf
+libtasn1
+gnome-keyring
+gnome-mime-data
+gnome-vfs
+libbonobo
+gail
+libgnomecanvas
+libgnome
+libbonoboui
+libgnomeui
+libgnomecups
+libgnomeprint
+libgnomeprintui
+gtkhtml
+goffice
+gnucash

src/usr/doc/queuefiles/multimedia.sqf

@@ -0,0 +1,57 @@
+######################################################################
+# Unofficially suggested build order for almost everything that is
+# AV/DVD related at SBo. After all of this, k3b #should support
+# reading/ripping CSS DVDs, DVD creation with menus, and VCD creation.
+# MPlayer will support quicktime #and reading encrypted DVDs,
+# k9copy/avidemux2/kino/audacity will have nearly have a full set of
+# encodings supported #as well. This is only a suggested build list and
+# order and is not directly endorsed by slackbuilds.org. YMMV.
+# Courtesy of antiwire
+######################################################################
+a52dec
+aften
+amrnb
+amrwb
+libmp4v2
+faac
+faad2
+lame
+libavc1394
+libdca
+libiec61883
+libmpcdec
+libmpeg2
+libsamplerate
+libsndfile
+twolame
+openjpeg
+mjpegtools
+schroedinger
+speex
+soundtouch
+xvidcore
+yasm
+x264
+divx4linux
+libdvdcss
+dvdauthor
+libdv
+libdvbpsi
+#current/13.0 includes the next
+libdvdread
+libdvdnav
+libdvdplay
+vcdimager
+vobcopy
+ffmpeg | AMRNB=yes AMRWB=yes
+libquicktime
+transcode | MJPEGTOOLS=yes
+mplayer-codecs
+# current/13.0 includes the next but lacks libdvdcss support and
+# codec package.  Rebuild for CSS required.
+mplayer
+kino | QUICKTIME=yes
+avidemux | QT4=yes
+k9copy
+wxGTK
+audacity

src/usr/doc/queuefiles/openbox-plus.sqf

@@ -0,0 +1,17 @@
+# Sbopkg queuefile for openbox, plus a few extas.
+# Tested on Slackware 12.2
+# Created by Chess Griffin
+#
+# This is a queue file for openbox, plus several extras that are
+# helpful or commonly used with openbox.  They are all optional and
+# not required dependencies of openbox.  If giblib, and feh are
+# desired, remove the '-' in front of their names.  Or, turn them on
+# in the sbopkg dialog menus.  Obconf must be compiled after openbox.
+
+imlib2
+-giblib
+-feh
+python-xlib
+pypanel
+openbox
+obconf

src/usr/doc/queuefiles/simple-desktop.sqf

@@ -0,0 +1,20 @@
+# Sbopkg queuefile for a simple desktop: openbox-plus, abiword,
+# gnucash, audacity, and multimedia queuefiles are included.
+# Created by Chess Griffin
+#
+# This queuefile is intended to demonstrate how the sbopkg queuefiles
+# can be used.  Several queuefiles have been created for certain
+# specific applications.  In this case, there are separate queuefiles
+# for abiword, audacity, gnucash, and openbox with some additional
+# extras.  You can see these separate queuefiles by going up one level
+# to http://sbopkg.org/queues/12.2.  Anyway, this 'simple-desktop'
+# queuefile brings them all together.  The '@' means that the listed
+# item is a recursive queuefile.  Essentially, it just tells sbopkg to
+# load another queuefile.  In this way, you can have separate
+# queuefiles for certain applications and then a 'master' queuefile
+# that brings them all together.
+
+@abiword
+@audacity
+@gnucash
+@openbox-plus

src/usr/man/man5/sbopkg.conf.5

@@ -230,7 +230,8 @@ sbopkg at all.
 
 .SH "SEE ALSO"
 .BR sbopkg (8)
-.BR README in doc/
-.BR README-queuefiles in doc/
-.BR README-renames.d in doc/
-.BR README-repos.d in doc/
+.BR doc/README
+.BR doc/README-queuefiles
+.BR doc/README-renames.d
+.BR doc/README-repos.d
+.BR doc/queuefiles/*

src/usr/man/man8/sbopkg.8

@@ -85,10 +85,10 @@ than one package is specified, they must be in quotes.  For example:
 #sbopkg -b "foo bar"
 
 will build foo and then bar.
-Queuefle names can also be specified. In that case, all the packages
+Queuefile names can also be specified. In that case, all the packages
 specified in the queuefile will be built. In the unfortunate case a
-token matches both a queue name and a package name (i.e. the user
-named a queue with the name of a package), sbopkg will ask the user
+token matches both a queuefile name and a package name (i.e. the user
+named a queuefile with the name of a package), sbopkg will ask the user
 which one should be used.  The tokens (package names or queuefiles)
 are processed in the order they are specified on the command line, and
 the build order specified in the queuefiles is retained.  If a package
@@ -237,10 +237,11 @@ README-repos.d document in the sbopkg doc/ directory for more information.
 
 .SH "SEE ALSO"
 .BR sbopkg.conf (5)
-.BR README in doc/
-.BR README-queuefiles in doc/
-.BR README-renames.d in doc/
-.BR README-repos.d in doc/
+.BR doc/README
+.BR doc/README-queuefiles
+.BR doc/README-renames.d
+.BR doc/README-repos.d
+.BR doc/queuefiles/*
 
 .SH AUTHOR
 Chess Griffin