Skip to Content.
Sympa Menu

sm-commit - [SM-Commit] GIT changes to test-1.13 sorcery by Jaka Kranjc (f875b3d10d15bfdfbac980cd4679c706ec06bbb6)

sm-commit AT lists.ibiblio.org

Subject: Source Mage code commit list

List archive

Chronological Thread  
  • From: Jaka Kranjc <scm AT sourcemage.org>
  • To: sm-commit AT lists.ibiblio.org
  • Subject: [SM-Commit] GIT changes to test-1.13 sorcery by Jaka Kranjc (f875b3d10d15bfdfbac980cd4679c706ec06bbb6)
  • Date: Fri, 14 Mar 2008 14:31:14 -0500

GIT changes to test-1.13 sorcery by Jaka Kranjc <lynxlynxlynx AT sourcemage.org>:

ChangeLog | 3
usr/sbin/cast | 2
usr/sbin/cleanse | 12 +--
usr/sbin/delve | 6 -
usr/sbin/gaze | 12 +++
usr/sbin/scribbler | 3
usr/sbin/scribe | 8 --
var/lib/sorcery/modules/build_api/common | 4 -
var/lib/sorcery/modules/dl_handlers/dl_cvs | 1
var/lib/sorcery/modules/dl_handlers/dl_dir | 1
var/lib/sorcery/modules/dl_handlers/dl_file | 1
var/lib/sorcery/modules/dl_handlers/dl_rsync | 8 +-
var/lib/sorcery/modules/dl_handlers/dl_wget | 16 ++---
var/lib/sorcery/modules/libapi | 5 -
var/lib/sorcery/modules/libcast | 7 --
var/lib/sorcery/modules/libdepends | 8 +-
var/lib/sorcery/modules/libdepengine | 8 --
var/lib/sorcery/modules/libdispel | 1
var/lib/sorcery/modules/libdownload | 4 -
var/lib/sorcery/modules/libgpg | 80
+++++++++++--------------
var/lib/sorcery/modules/liblock | 10 +--
var/lib/sorcery/modules/libmisc | 32 ++++------
var/lib/sorcery/modules/libstate | 8 --
var/lib/sorcery/modules/libtablet | 17 +----
var/lib/sorcery/modules/libtrack | 78
+++++++++++-------------
var/lib/sorcery/modules/liburl | 6 -
var/lib/sorcery/modules/url_handlers/url_cvs | 1
var/lib/sorcery/modules/url_handlers/url_dir | 1
var/lib/sorcery/modules/url_handlers/url_file | 1
var/lib/sorcery/modules/url_handlers/url_http | 12 +--
var/lib/sorcery/modules/url_handlers/url_rsync | 1
var/lib/sorcery/subroutines | 1
32 files changed, 159 insertions(+), 199 deletions(-)

New commits:
commit f875b3d10d15bfdfbac980cd4679c706ec06bbb6
Author: Jaka Kranjc <lynxlynxlynx AT sourcemage.org>
Commit: Jaka Kranjc <lynxlynxlynx AT sourcemage.org>

*: comment fixes for bashdoc - modified patch from Arvid Norlander

merged most of
(cherry-picked from commit 06b0376f193662002b0c2b18b237df55398fb957)

diff --git a/ChangeLog b/ChangeLog
index 580a694..04b93b8 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,6 @@
+2008-02-04 Jaka Kranjc <lynxlynxlynx AT sourcemage.org>
+ * *: comment fixes for bashdoc - modified patch from Arvid Norlander
+
2008-02-02 Jaka Kranjc <lynxlynxlynx AT sourcemage.org>
* gaze: import and export need root privileges #13789

diff --git a/usr/sbin/cast b/usr/sbin/cast
index a527bd6..5a5288f 100755
--- a/usr/sbin/cast
+++ b/usr/sbin/cast
@@ -428,7 +428,6 @@ function pass_two() {
}

#---------------------------------------------------------------------
-
## @param spellname
## @Globals SPELL
## Sets SPELL to the spellname and calls summon_spell with spellname
@@ -908,4 +907,3 @@ debug "cast" "exiting..."
## Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
##
#---------------------------------------------------------------------
-
diff --git a/usr/sbin/cleanse b/usr/sbin/cleanse
index 266d3c9..bb012ea 100755
--- a/usr/sbin/cleanse
+++ b/usr/sbin/cleanse
@@ -79,19 +79,15 @@ EOF
#---------------------
## Interpret the arguments to this script
## @Args --help Display help
-## @Args --delint [full] Find stale dependency entries, with full it'll
-## look at off entries too
-## @Args --prune [doit] Find missing spells, do the actions of "doit" is
-## specified
-## @Args --packages Find packages entries that are corrupted, or
-## non-existant
+## @Args --delint [full] Find stale dependency entries, with full it'll
look at off entries too
+## @Args --prune [doit] Find missing spells, do the actions of "doit" is
specified
+## @Args --packages Find packages entries that are corrupted, or
non-existant
## @Args --tablet Clean up the tablet
## @args --tablet_spell Clean up the tablet for one spell
## @Args --logs Remove stale logs
## @Args --sweep Remove uneeded spool and cache files
## @Args --sweep_all Remove uneeded spool and cache files
-## @Args --fix Find binaries that are missing libs and files,
-## and recast broken spells
+## @Args --fix Find binaries that are missing libs and files,
and recast broken spells
## @Args --nofix Same as --fix, but won't recast.
## @Args --nofix_quick Same as --nofix, but doesn't check dependent
spells
#---------------------
diff --git a/usr/sbin/delve b/usr/sbin/delve
index 30d0496..fb63e04 100755
--- a/usr/sbin/delve
+++ b/usr/sbin/delve
@@ -1,9 +1,9 @@
#!/bin/bash
#---------------------------------------------------------------------
## @Synopsis Delve is a tool for running individual spell files during the
-## build and install phase. This can be used as a debugging tool or to
-## "force" a spell to be installed. Use with caution and keep your hands
-## off if you dont know what you are doing.
+## @Synopsis build and install phase. This can be used as a debugging tool
or to
+## @Synopsis "force" a spell to be installed. Use with caution and keep your
hands
+## @Synopsis off if you dont know what you are doing.
##
## @Copyright 2004 the Source Mage Team
## @Author Andrew Stitt
diff --git a/usr/sbin/gaze b/usr/sbin/gaze
index 9b29439..a25d612 100755
--- a/usr/sbin/gaze
+++ b/usr/sbin/gaze
@@ -221,14 +221,22 @@ function import_snapshot() {
## Is this used anywhere?
## @param File with list of files the sum
#-----
-function checksum() { for FILE in `cat $1 | files`; do sum -s $FILE;
done; }
+function checksum() {
+ for FILE in `cat $1 | files`; do
+ sum -s $FILE
+ done
+}

#-----
## Run an md5sum of a list of files in a file
## Is this used anywhere?
## @param File with list of files the sum
#-----
-function md5sum_files() { for FILE in `cat $1 | files`; do md5sum "$FILE";
done; }
+function md5sum_files() {
+ for FILE in `cat $1 | files`; do
+ md5sum "$FILE"
+ done
+}

#-----
## Find all files on the system not installed by a spell
diff --git a/usr/sbin/scribbler b/usr/sbin/scribbler
index 05d55f1..a94540f 100755
--- a/usr/sbin/scribbler
+++ b/usr/sbin/scribbler
@@ -2,7 +2,7 @@
#---------------------------------------------------------------------
##
## @Synopsis This utility lets you manage moving spells to your private
-## grimoire so you can mix-and-match versions from various other grimoires.
+## @Synopsis grimoire so you can mix-and-match versions from various other
grimoires.
##
## @Copyright
##
@@ -193,4 +193,3 @@ main "$@"
## Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
##
#---------------------------------------------------------------------
-
diff --git a/usr/sbin/scribe b/usr/sbin/scribe
index 7710b9b..e163a22 100755
--- a/usr/sbin/scribe
+++ b/usr/sbin/scribe
@@ -5,10 +5,9 @@
##
## @Synopsis scribe handles adding/updating/reindexing/etc. of grimoires
##
-## @Copyright
-## Original version Copywright 2002 by Ryan Abrams
-## Additions/Corrections Copyright 2002-2004 by the Source Mage Team
-## Released under the GPL
+## @Copyright Original version Copywright 2002 by Ryan Abrams
+## @Copyright Additions/Corrections Copyright 2002-2004 by the Source Mage
Team
+## @Copyright Released under the GPL
#---------------------------------------------------------------------


@@ -718,7 +717,6 @@ function main() {
esac
}

-#---------------------------------------------------------------------
. /etc/sorcery/config

#check if root. If not, become root
diff --git a/var/lib/sorcery/modules/build_api/common
b/var/lib/sorcery/modules/build_api/common
index 3ffaa7e..60e7701 100755
--- a/var/lib/sorcery/modules/build_api/common
+++ b/var/lib/sorcery/modules/build_api/common
@@ -15,14 +15,14 @@
##=head1 FUNCTIONS
#---------------------------------------------------------------------

+# checks for a security file
+# returns 0 if spell should be cast, 1 otherwise
#---------------------------------------------------------------------
## Prompts the user about possible security problems with the current
## spell. Allows a safe way of failing a spell due to security problems.
## @return 0 if there are no security problem or the user acknowledges them.
## @return 1 if the user decides not to accept the security concerns
#---------------------------------------------------------------------
-# checks for a security file
-# returns 0 if spell should be cast, 1 otherwise
function run_security() {
debug "build_api/common" "Starting run_security() on $SPELL"
if [ -f $SCRIPT_DIRECTORY/SECURITY ]; then
diff --git a/var/lib/sorcery/modules/dl_handlers/dl_cvs
b/var/lib/sorcery/modules/dl_handlers/dl_cvs
index 7f596d0..05fc068 100755
--- a/var/lib/sorcery/modules/dl_handlers/dl_cvs
+++ b/var/lib/sorcery/modules/dl_handlers/dl_cvs
@@ -106,4 +106,3 @@ function dl_cvs_get() {
## Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
##
#---------------------------------------------------------------------
-
diff --git a/var/lib/sorcery/modules/dl_handlers/dl_dir
b/var/lib/sorcery/modules/dl_handlers/dl_dir
index 7a4bda9..9cc25e6 100755
--- a/var/lib/sorcery/modules/dl_handlers/dl_dir
+++ b/var/lib/sorcery/modules/dl_handlers/dl_dir
@@ -89,4 +89,3 @@ function url_dir_get() {
## Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
##
#---------------------------------------------------------------------
-
diff --git a/var/lib/sorcery/modules/dl_handlers/dl_file
b/var/lib/sorcery/modules/dl_handlers/dl_file
index aa36001..5772c59 100755
--- a/var/lib/sorcery/modules/dl_handlers/dl_file
+++ b/var/lib/sorcery/modules/dl_handlers/dl_file
@@ -66,4 +66,3 @@ function dl_file_get() {
## Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
##
#---------------------------------------------------------------------
-
diff --git a/var/lib/sorcery/modules/dl_handlers/dl_rsync
b/var/lib/sorcery/modules/dl_handlers/dl_rsync
index 3553121..7f78874 100755
--- a/var/lib/sorcery/modules/dl_handlers/dl_rsync
+++ b/var/lib/sorcery/modules/dl_handlers/dl_rsync
@@ -81,10 +81,10 @@ function dl_rsync_get() {
}

#---------------------------------------------------------------------
-#=item dl_rsync_run_rsync <url> <to>
-#
-# Private function. Calls rsync and beautifies output
-#
+##=item dl_rsync_run_rsync <url> <to>
+##
+## Private function. Calls rsync and beautifies output
+##
#---------------------------------------------------------------------
function dl_rsync_run_rsync() {
local target=$1
diff --git a/var/lib/sorcery/modules/dl_handlers/dl_wget
b/var/lib/sorcery/modules/dl_handlers/dl_wget
index 9272aa3..216154a 100755
--- a/var/lib/sorcery/modules/dl_handlers/dl_wget
+++ b/var/lib/sorcery/modules/dl_handlers/dl_wget
@@ -51,10 +51,10 @@ function dl_wget_get() {
}

#---------------------------------------------------------------------
-# dl_wget_call_wget <filename> <extension-less filename> <url>
-#
-# Private Function. Call wget to download the url.
-#
+## dl_wget_call_wget <filename> <extension-less filename> <url>
+##
+## Private Function. Call wgets to download the url.
+##
#---------------------------------------------------------------------
function dl_wget_call_wget() {
local FILE=$1
@@ -73,10 +73,10 @@ function dl_wget_call_wget() {
}

#---------------------------------------------------------------------
-# dl_wget_set_wget_options
-#
-# Private Function. Sets wget options
-#
+## dl_wget_set_wget_options
+##
+## Private Function. Sets wget options
+##
#---------------------------------------------------------------------
function dl_wget_set_options() {
local URL=$1
diff --git a/var/lib/sorcery/modules/libapi b/var/lib/sorcery/modules/libapi
index 055d946..9215f1d 100755
--- a/var/lib/sorcery/modules/libapi
+++ b/var/lib/sorcery/modules/libapi
@@ -12,8 +12,8 @@
#---------------------------------------------------------------------

#---------------------------------------------------------------------
-# @NOTE: The following list and the function definition should be in
-# alphabetical order. If this is not the case, please file a bug
+## @NOTE The following list and the function definition should be in
+## @NOTE alphabetical order. If this is not the case, please file a bug
#---------------------------------------------------------------------

#---------------------------------------------------------------------
@@ -1158,4 +1158,3 @@ function track_manual() {
## Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
##
#---------------------------------------------------------------------
-
diff --git a/var/lib/sorcery/modules/libcast b/var/lib/sorcery/modules/libcast
index c15355b..fbb2900 100755
--- a/var/lib/sorcery/modules/libcast
+++ b/var/lib/sorcery/modules/libcast
@@ -1,9 +1,9 @@
#!/bin/bash
#---------------------------------------------------------------------
## @Synopsis Functions for dealing with the actual
-## compiling/installation of spells and walking through casts 'pass 4'
pipeline.
+## @Synopsis compiling/installation of spells and walking through cast's
'pass 4' pipeline.
## @Copyright Copyright (C) 2002 The Source Mage Team
-## &lt;http://www.sourcemage.org&gt;
+## @Copyright &lt;http://www.sourcemage.org&gt;
## @Globals $SGL_LIBRARY_MODULES $GRIMOIRE $BUILD_API $USE_FUNCTIONS
## A spell follows the following path during its installation:
## PREPARE -&gt; DETAILS -&gt; PRE_BUILD -&gt; BUILD, or COMPILE/INSTALL
-&gt;
@@ -86,8 +86,7 @@ function prepare_spell_config() {
## Prompts the user about spells that are in conflict with the current
## spell and allows them to dispel them. If the user chooses not to
## dispel the conflicting spell, the function returns 1
-## @param dis-allow conflict with anything in this list, normally used
-## to prevent self conflicts
+## @param dis-allow conflict with anything in this list, normally used to
prevent self conflicts
## @return nothing if the user dispels the conflicting spell
## @return 1 if the user chooses not to dispel the conflicting spell
#---------------------------------------------------------------------
diff --git a/var/lib/sorcery/modules/libdepends
b/var/lib/sorcery/modules/libdepends
index 778eaeb..184a262 100755
--- a/var/lib/sorcery/modules/libdepends
+++ b/var/lib/sorcery/modules/libdepends
@@ -1023,10 +1023,10 @@ function private_up_trigger() {
}

#---------------------------------------------------------------------
-# Force a spell to be recast, if it comes up for processing
-# if the spell was already looked at and processed nothing happens
-# if the spell was already looked at and didnt need processing, then
-# it'll get re-processed (assuming the caller also did a depends on it)
+## Force a spell to be recast, if it comes up for processing
+## if the spell was already looked at and processed nothing happens
+## if the spell was already looked at and didnt need processing, then
+## it'll get re-processed (assuming the caller also did a depends on it)
#---------------------------------------------------------------------
function real_force_depends() {
debug "libdepends" "$FUNCNAME - $SPELL - $@"
diff --git a/var/lib/sorcery/modules/libdepengine
b/var/lib/sorcery/modules/libdepengine
index 8a07ce3..cfb6c7b 100755
--- a/var/lib/sorcery/modules/libdepengine
+++ b/var/lib/sorcery/modules/libdepengine
@@ -75,8 +75,7 @@ function depengine_entry_point() {
## Builds the children, then itself, then executes triggers.
##
## @param Spell to cast
-## @param In trigger flag, default 0. If 1 and a depends loop exists
-## back-off and fail gracefully.
+## @param In trigger flag, default 0. If 1 and a depends loop exists
back-off and fail gracefully.
#------------------------------------------------------------------------
function depengine_cast_engine() {
$STD_DEBUG
@@ -135,10 +134,9 @@ function depengine_cast_engine() {
#------------------------------------------------------------------------
## Iterative recursive step. Build each of the spell's dependencies.
## @param Spell
-## @param In trigger flag (optional) if 1, then back off more readily in
-## the event of a dependency loop.
+## @param In trigger flag (optional) if 1, then back off more readily in the
event of a dependency loop.
## @global MINUS_K if 'yes', then act like make -k and continue building
-## dependent spells even if another one fails.
+## @global dependent spells even if another one fails.
##
#------------------------------------------------------------------------
function recurse_depends() {
diff --git a/var/lib/sorcery/modules/libdispel
b/var/lib/sorcery/modules/libdispel
index 6f4c4c1..9114cf4 100755
--- a/var/lib/sorcery/modules/libdispel
+++ b/var/lib/sorcery/modules/libdispel
@@ -313,7 +313,6 @@ function real_default_post_remove() {
#---------------------------------------------------------------------
## Dispel a spell
#---------------------------------------------------------------------
-
function dispel_spell() {

local SPELL=$1
diff --git a/var/lib/sorcery/modules/libdownload
b/var/lib/sorcery/modules/libdownload
index 7c396c5..f064cb8 100755
--- a/var/lib/sorcery/modules/libdownload
+++ b/var/lib/sorcery/modules/libdownload
@@ -16,6 +16,7 @@
## need to.
##
## WRITING NEW DL HANDLERS
+## <pre>
## Current dl handlers only need a single function
## "dl_get_<handler>" This function takes the following arguments:
## $target
@@ -26,7 +27,7 @@
## result directory or file
## $dl_type Name of the variable in which to store the type of
## thing downloaded
-##
+## </pre>
##
## The target parameter is advisory, it is a hint at what might be
downloaded.
##
@@ -226,4 +227,3 @@ EOF
## along with this software; if not, write to the Free Software
## Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
#---------------------------------------------------------------------
-
diff --git a/var/lib/sorcery/modules/libgpg b/var/lib/sorcery/modules/libgpg
index ac30567..7b24baf 100755
--- a/var/lib/sorcery/modules/libgpg
+++ b/var/lib/sorcery/modules/libgpg
@@ -17,11 +17,11 @@
## @param public keyring
##
## @return 0 on success, non-zero on failure:
-## 1: verification failure
-## 3: no signature file
-## 4: no file to verify
-## 5: no keyring
-## 200: gpg isnt installed
+## @return 1 verification failure
+## @return 3 no signature file
+## @return 4 no file to verify
+## @return 5 no keyring
+## @return 200 gpg isnt installed
##
## @stdout message when gpg is not installed
##
@@ -104,19 +104,16 @@ function gpg_get_grimoire_key() {
## Verify a grimoire tarball's gpg signature
## @param file on local disk to verify
## @param url from which to get the signature
-## @param (optional) grimoire branch, if derive it from the filename with
-## ${SOURCE%%*.}
-## @param (optional) signature file, if empty download $SOURCE.$GPG_SIG_EXT
-## from $2
+## @param (optional) grimoire branch, if derive it from the filename with
${SOURCE%%*.}
+## @param (optional) signature file, if empty download $SOURCE.$GPG_SIG_EXT
from $2
## @return 0 on success, non-zero on failure:
-## 1: verification failed
-## 2: verification is disabled
-## 254: no keyring found
-## 255: could not download signature
-## anything else see gpg_verify_signature
+## @return 1 verification failed
+## @return 2 verification is disabled
+## @return 254 no keyring found
+## @return 255 could not download signature
+## @return anything else see gpg_verify_signature
##
-## @stdout possibly a failure message depending on what happens (nothing
-## is output on success)
+## @stdout possibly a failure message depending on what happens (nothing is
output on success)
#---------------------------------------------------------------------
function gpg_verify_grimoire() {
if [[ "$GPG_VERIFY_GRIMOIRE" != on ]] ; then
@@ -187,18 +184,16 @@ function verify_grimoire_tree() {
## Verify a sorcery tarball's gpg signature
## @param file on local disk to verify
## @param url from which to get the signature
-## @param (optional) signature file, if empty download $SOURCE.$GPG_SIG_EXT
-## from $2
+## @param (optional) signature file, if empty download $SOURCE.$GPG_SIG_EXT
from $2
##
## @return 0 on success, non-zero on failure:
-## 1: verification failed
-## 2: verification is disabled
-## 254: no keyring found
-## 255: could not download signature
-## anything else see gpg_verify_signature
+## @return 1 verification failed
+## @return 2 verification is disabled
+## @return 254 no keyring found
+## @return 255 could not download signature
+## @return anything else see gpg_verify_signature
##
-## @stdout possibly a failure message depending on what happens (nothing
-## is output on success)
+## @stdout possibly a failure message depending on what happens (nothing is
output on success)
#---------------------------------------------------------------------
function gpg_verify_sorcery() {
if [[ "$GPG_VERIFY_SORCERY" != on ]] ; then
@@ -224,18 +219,15 @@ function gpg_verify_sorcery() {
## @param file on local disk to verify
## @param url from which to get the signature
## @param keyring to verify with
-## @param grimoire or sorcery, whatever it is thats being verified (used in
-## an output message
-## @param (optional) signature file, if empty download $SOURCE.$GPG_SIG_EXT
-## from $2
+## @param grimoire or sorcery, whatever it is thats being verified (used in
an output message
+## @param (optional) signature file, if empty download $SOURCE.$GPG_SIG_EXT
from $2
##
## @return 0 on success, non-zero on failure:
-## 1: verification failed
-## 255: could not download signature
-## anything else see gpg_verify_signature
+## @return 1 verification failed
+## @return 255 could not download signature
+## @return anything else see gpg_verify_signature
##
-## @stdout possibly a failure message depending on what happens (nothing
-## is output on success)
+## @stdout possibly a failure message depending on what happens (nothing is
output on success)
#---------------------------------------------------------------------
function gpg_verify_common() {
# download the signature
@@ -276,11 +268,12 @@ function gpg_verify_common() {
## gpg_verify_grimoire.
##
## @param return code of gpg_verify_sorcery or gpg_verify_grimoire
-## @return 0 if the program should continue, 1 if not
+## @return 0 if the program should continue
+## @return 1 if not
##
## @stdout Some message thats supposed to inform the user of whats
-## going on, or possibly a query asking the user if they want
-## to continue even though gpg verification failed.
+## @stdout going on, or possibly a query asking the user if they want
+## @stdout to continue even though gpg verification failed.
#---------------------------------------------------------------------
function gpg_user_query() {
local rc=$1
@@ -314,9 +307,9 @@ function gpg_user_query() {
#---------------------------------------------------------------------
## @param algorithm to use
## @param file to get hashsum of
-## @out output is exactly the same format as md5sum/sha1sum, just with
-## a different hashsum. "hashsum<space><space>filename". The hashsum is
-## printed with all lowercase letters.
+## @stdout output is exactly the same format as md5sum/sha1sum, just with
+## @stdout a different hashsum. "hashsum<space><space>filename". The hashsum
is
+## @stdout printed with all lowercase letters.
##
## This assumes that the caller has already verified that gpg is
## installed and supports the specified hash function.
@@ -331,8 +324,8 @@ function gpg_hashsum() {
}

#---------------------------------------------------------------------
-## @out All the hash algorithms supported by gpg, algorithms printed in
-## lower case.
+## @stdout All the hash algorithms supported by gpg, algorithms printed in
+## @stdout lower case.
##
## This assumes the caller has already verified that gpg is installed.
#---------------------------------------------------------------------
@@ -343,8 +336,7 @@ function gpg_get_hashes() {
#---------------------------------------------------------------------
## Verify a tree against a manifest file
## @param directory to verify
-## @param manifest file, the format is like what the md5sum tool would
-## produce
+## @param manifest file, the format is like what the md5sum tool would
produce
## @param algorithm to use, this can be anything supported by gpg
## @param regular expression of files to ignore
#---------------------------------------------------------------------
diff --git a/var/lib/sorcery/modules/liblock b/var/lib/sorcery/modules/liblock
index 010da47..487c8e4 100755
--- a/var/lib/sorcery/modules/liblock
+++ b/var/lib/sorcery/modules/liblock
@@ -34,6 +34,7 @@
## network | network | ?
## solo | resource name | when using a resource exclusively
## libgrimoire | install | when a spell is in the install stage
+## </pre>
## locking solo will not cause these routines to behave any different.
## catching it has to be done externally (see cast for an example)
##
@@ -462,10 +463,10 @@ function counter_clean() {
##
## Prevents more than one process from entering a section of code
## at a time
-## NOTE: This assumes that two functions of the same name will
-## not havethe SYNCHRONIZE command on the same line in different
-## files.
-##
+## @NOTE This assumes that two functions of the same name will
+## @NOTE not havethe SYNCHRONIZE command on the same line in different
+## @NOTE files.
+## <pre>
## Example:
## #!/bin/bash
## echo "Script started with PID=$$
@@ -496,4 +497,3 @@ UNSYNCHRONIZE='
debug "liblock" "+++ in unsynch code"
unlock_resources "lockfunction" "${FUNCNAME}/${__llSYNCH_LINE}"
unset __llSYNCH_LINE'
-
diff --git a/var/lib/sorcery/modules/libmisc b/var/lib/sorcery/modules/libmisc
index 22534bc..da74647 100755
--- a/var/lib/sorcery/modules/libmisc
+++ b/var/lib/sorcery/modules/libmisc
@@ -5,7 +5,6 @@
## @param delimiter
## @param name of array to put it in
##
-## @Description
## Turns a string into an array. Each element of the array
## is separated in the string by the delimiter.
##
@@ -753,8 +752,7 @@ function real_persistent_clear () {
## @param return variable (optional)
##
## @return 1 option is not present in the config
-## @return 0 option is present in the config (even if the option is
-## empty string "") and it's set.
+## @return 0 option is present in the config (even if the option is empty
string "") and it's set.
##
## Retrieves setting from $SPELL_CONFIG file and optionally sets user
## supplied variable. Function is here to make possible changes to
@@ -762,13 +760,6 @@ function real_persistent_clear () {
## function and are not working with variables directly
##
#---------------------------------------------------------------------
-#function config_get_option {
-# local VAR=$2
-# local REPLY=`grep -E "^$1=" $SPELL_CONFIG | head -n 1 | sed
"s/^[^=]*=//"`
-# [ -n "$VAR" ] && eval $VAR=\"$REPLY\"
-# [ -z "$REPLY" ] && return 1
-# return 0
-#}
function config_get_option () {
if [[ $PROTECT_SORCERY ]] ; then
if is_sorcery_var $1; then
@@ -788,13 +779,19 @@ function config_get_option () {
return 1
fi
}
+#function config_get_option {
+# local VAR=$2
+# local REPLY=`grep -E "^$1=" $SPELL_CONFIG | head -n 1 | sed
"s/^[^=]*=//"`
+# [ -n "$VAR" ] && eval $VAR=\"$REPLY\"
+# [ -z "$REPLY" ] && return 1
+# return 0
+#}

#---------------------------------------------------------------------
## @param Name of variable
## @param return variable
##
-## @return 0 if the variable could be found, 1 if no old persistent file
-## exists.
+## @return 0 if the variable could be found, 1 if no old persistent file
exists.
##
## Get value of a persistent variable from the previous cast when
## there is a -r. The persistent data moves to a seperate directory
@@ -847,14 +844,13 @@ function config_get_last_option() {
## working with variables directly
##
#---------------------------------------------------------------------
-#function config_set_option {
-# echo "$1=$2" >> $SPELL_CONFIG
-#}
function config_set_option () {
persistent_add $1
eval "$1=\"$2\""
}
-
+#function config_set_option {
+# echo "$1=$2" >> $SPELL_CONFIG
+#}

#---------------------------------------------------------------------
## @param config file variable
@@ -1253,8 +1249,8 @@ function is_sorcery_var() {

#---------------------------------------------------------------------
## @param Variable name used in complaint
-## @stdout Complain vehemently that a variable name is used by sorcery
-## and the user should file a bug because a spell is using the variable
+## @stdout Complain vehemently that a variable name is used by sorcery and
+## @stdout the user should file a bug because a spell is using the variable
#---------------------------------------------------------------------
function complain_sorcery_var() {
message "${PROBLEM_COLOR}WARNING: ATTEMPTING TO USE" \
diff --git a/var/lib/sorcery/modules/libstate
b/var/lib/sorcery/modules/libstate
index 004527a..de96b5a 100755
--- a/var/lib/sorcery/modules/libstate
+++ b/var/lib/sorcery/modules/libstate
@@ -515,9 +515,7 @@ function real_provider_ok() {
## @Type API
## @param Spell name
## @param Provider name
-## @param If empty get the uncommited spell info, if anything else get
-## info from the committed ($DEPENDS_STATUS) database. If the uncommited
-## db doesnt exist (maybe we're not casting) use DEPENDS_STATUS
+## @param If empty get the uncommited spell info, if anything else get info
from the committed ($DEPENDS_STATUS) database. If the uncommited db doesnt
exist (maybe we're not casting) use DEPENDS_STATUS
##
## @return 0 if a provider could be found 1 if not
## @stdout the provider name(s)
@@ -697,9 +695,7 @@ function get_all_spells_with_status () {
## @Type API
## @param Spell name
## @param Target spell name
-## @param If empty get the uncommited spell info, if anything else get
-## info from the committed ($DEPENDS_STATUS) database. If the uncommited
-## db doesnt exist (maybe we're not casting) use DEPENDS_STATUS
+## @param If empty get the uncommited spell info, if anything else get info
from the committed ($DEPENDS_STATUS) database. If the uncommited db doesnt
exist (maybe we're not casting) use DEPENDS_STATUS
##
## @return 0 if a dependency from $1 on $2 is enabled, 1 otherwise.
## @stdout the provider name(s)
diff --git a/var/lib/sorcery/modules/libtablet
b/var/lib/sorcery/modules/libtablet
index be64882..bc5472f 100755
--- a/var/lib/sorcery/modules/libtablet
+++ b/var/lib/sorcery/modules/libtablet
@@ -2,7 +2,7 @@
#---------------------------------------------------------------------
## @Synopsis Functions for dealing with tablet
## @Copyright (C) 2004 The Source Mage Team <http://www.sourcemage.org>
-##
+## <pre>
## tablet layout version 0:
## layout 0 is anything unversioned with all its problems, if a
## tablet like this is seen it should be updated to version 1,
@@ -43,7 +43,6 @@
## tablet_0_repair_spell DONE
## no tb_version : tablet_0_repair (bumps to version 1)
##
-#---------------------------------------------------------------------
##
## Terminology:
## "the tablet" the directory $TABLET_PATH and everything in it
@@ -79,11 +78,7 @@
## tablet_coalesce_files : hardlink identical files to save space
## tablet_fix_duplicates
## determine if a tablet points back at itself through the install log
-##
-##
-##
-##
-##
+## </pre>
#---------------------------------------------------------------------


@@ -383,10 +378,10 @@ function tablet_find_spell_dir() {
}

#----------------------------------------------------------------------
-# @param spell name
-# @param upvar
-# quicker dirtier version of above without special checks since the
-# tablet in a cache tarball has nothing to do with the installed system
+## @param spell name
+## @param upvar
+## quicker dirtier version of above without special checks since the
+## tablet in a cache tarball has nothing to do with the installed system
#----------------------------------------------------------------------
function tablet_find_resurrect_dir() {
local SPELL=$1
diff --git a/var/lib/sorcery/modules/libtrack
b/var/lib/sorcery/modules/libtrack
index b38fa0b..5e31ff6 100755
--- a/var/lib/sorcery/modules/libtrack
+++ b/var/lib/sorcery/modules/libtrack
@@ -181,8 +181,7 @@ function check_if_modified() {
## Creates a bzip/gzip'ed tar file containing an archived backup of
## file specified on standard input into $CACHE_COMP
## @stdin files, one per line, to put into the archive
-## @param directory input files are relative to install root for regular
-## files state root for state files
+## @param directory input files are relative to install root for regular
files state root for state files
##
#---------------------------------------------------------------------
function create_cache_archive() {
@@ -221,8 +220,8 @@ function create_cache_archive() {
}

#---------------------------------------------------------------------
-# this is to filter the install log from one form to another
-# for install_root/track_root conversions
+## this is to filter the install log from one form to another
+## for install_root/track_root conversions
#---------------------------------------------------------------------
function install_log_filter() {
sed "s:^$1:$2:"
@@ -232,40 +231,37 @@ function md5_log_filter() {
}

#---------------------------------------------------------------------
-# @param input file (can be /dev/stdin)
-# @param output file (can be /dev/stdout)
-# @param input format (root/log/filterable)
-# @param output format (root/log/filterable)
-# @param filter callback (optional install_log_filter, could be
-# md5_log_filter)
-#
-# This filters an install log from a given format into another format
-#
-# root: relative to / all paths are relative to / file existence tests
-# should work, INSTALL_ROOT and STATE_ROOT are prepended to data and
-# state files respectively
-#
-# log: relative to track_root etc, format used in the logs (see note on
-# special behavior below)
-#
-# filterable: track_root/install_root/state_root stripped out files can
-# have filters applied to them
-#
-# "Special" handling applies depending on whether STATE_ROOT is inside
-# or outside INSTALL_ROOT.
-# For converting into log format:
-# If STATE_ROOT is within INSTALL_ROOT
-# eg: STATE_ROOT=/opt/stuff INSTALL_ROOT=/opt/stuff
-# or STATE_ROOT=/opt/stuff/state INSTALL_ROOT=/opt/stuff
-# the portion of INSTALL_ROOT within STATE_ROOT is replaced with TRACK_ROOT
-# if STATE_ROOT is outside of INSTALL_ROOT (eg /opt/stuff and /opt/state)
-# then STATE_ROOT is left as is
-#
-# Converting from log to root format is the inverse, and of course going
-# to filterable format just requires removing whatever the expected prefix
is.
-#
-#
-#
+## @param input file (can be /dev/stdin)
+## @param output file (can be /dev/stdout)
+## @param input format (root/log/filterable)
+## @param output format (root/log/filterable)
+## @param filter callback (optional install_log_filter, could be
md5_log_filter)
+##
+## This filters an install log from a given format into another format
+## <pre>
+## root: relative to / all paths are relative to / file existence tests
+## should work, INSTALL_ROOT and STATE_ROOT are prepended to data and
+## state files respectively
+##
+## log: relative to track_root etc, format used in the logs (see note on
+## special behavior below)
+##
+## filterable: track_root/install_root/state_root stripped out files can
+## have filters applied to them
+##
+## "Special" handling applies depending on whether STATE_ROOT is inside
+## or outside INSTALL_ROOT.
+## For converting into log format:
+## If STATE_ROOT is within INSTALL_ROOT
+## eg: STATE_ROOT=/opt/stuff INSTALL_ROOT=/opt/stuff
+## or STATE_ROOT=/opt/stuff/state INSTALL_ROOT=/opt/stuff
+## the portion of INSTALL_ROOT within STATE_ROOT is replaced with TRACK_ROOT
+## if STATE_ROOT is outside of INSTALL_ROOT (eg /opt/stuff and /opt/state)
+## then STATE_ROOT is left as is
+##
+## Converting from log to root format is the inverse, and of course going
+## to filterable format just requires removing whatever the expected prefix
is.
+## </pre>
#---------------------------------------------------------------------
function log_adjuster() {
local input=$1
@@ -364,11 +360,9 @@ function log_adjuster() {
## Split a log file into data that should be TRACK_ROOT'd versus
## STATE_ROOT'd.
##
-## @param filename or - (or /dev/stdin) for a pipe. This routine will
-## read the input only once in-order to work with pipes.
+## @param filename or - (or /dev/stdin) for a pipe. This routine will read
the input only once in-order to work with pipes.
## @param filename for non-state files, possibly /dev/stdout or /dev/stderr
-## @param filename for state files, possibly /dev/stdout or /dev/stderr
-## don't use the same stream for both types.
+## @param filename for state files, possibly /dev/stdout or /dev/stderr
don't use the same stream for both types.
##
#---------------------------------------------------------------------
function seperate_state_files() {
diff --git a/var/lib/sorcery/modules/liburl b/var/lib/sorcery/modules/liburl
index 1934b82..fb7674c 100755
--- a/var/lib/sorcery/modules/liburl
+++ b/var/lib/sorcery/modules/liburl
@@ -54,7 +54,7 @@
## The next step is to write the actual functions that
## will handle url requests and put them in the new file you just
## created. The functions that must be implemented are:
-##
+## <pre>
## url_<URL_PREFIX>_bucketize <url>
## url_<URL_PREFIX>_crack <url>
## url_<URL_PREFIX>_expand <url>
@@ -62,7 +62,7 @@
## url_<URL_PREFIX>_is_valid <url>
## url_<URL_PREFIX>_netselect <url>
## url_<URL_PREFIX>_verify <url>
-##
+## </pre>
## The easiest way to figure out what to do is to look at
## one of the existing files (e.g., url_http handles http requests).
##
@@ -77,11 +77,9 @@
##
#---------------------------------------------------------------------

-#---------------------------------------------------------------------
# Load library files (url_*) that contain url handlers
#
# (2002/09/29) added if so it only loads the stuff once
-#---------------------------------------------------------------------
if ! [[ $URL_HANDLER_FILES ]] ; then
URL_HANDLER_FILES=`ls $SGL_LIBRARY_MODULES/url_handlers/url_*[^~]`
for url_handler_file in $URL_HANDLER_FILES; do
diff --git a/var/lib/sorcery/modules/url_handlers/url_cvs
b/var/lib/sorcery/modules/url_handlers/url_cvs
index 68ac9f3..fa55616 100755
--- a/var/lib/sorcery/modules/url_handlers/url_cvs
+++ b/var/lib/sorcery/modules/url_handlers/url_cvs
@@ -156,4 +156,3 @@ function url_cvs_netselect() {
## Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
##
#---------------------------------------------------------------------
-
diff --git a/var/lib/sorcery/modules/url_handlers/url_dir
b/var/lib/sorcery/modules/url_handlers/url_dir
index 0e8a25e..c09b804 100755
--- a/var/lib/sorcery/modules/url_handlers/url_dir
+++ b/var/lib/sorcery/modules/url_handlers/url_dir
@@ -70,4 +70,3 @@ function url_dir_verify() {
## Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
##
#---------------------------------------------------------------------
-
diff --git a/var/lib/sorcery/modules/url_handlers/url_file
b/var/lib/sorcery/modules/url_handlers/url_file
index b8aabef..25e8d6c 100755
--- a/var/lib/sorcery/modules/url_handlers/url_file
+++ b/var/lib/sorcery/modules/url_handlers/url_file
@@ -49,4 +49,3 @@ function url_file_verify() {
## Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
##
#---------------------------------------------------------------------
-
diff --git a/var/lib/sorcery/modules/url_handlers/url_http
b/var/lib/sorcery/modules/url_handlers/url_http
index e0fc50f..8fbb86e 100755
--- a/var/lib/sorcery/modules/url_handlers/url_http
+++ b/var/lib/sorcery/modules/url_handlers/url_http
@@ -82,12 +82,12 @@ function url_https_verify() {
## Verifies the specified ftp url. Echos results of wget if file
## is not found.
##
-#
-# Implementation note: wget --spider still downloads ftp files in
-# full rather than just checking that the file is there. To get
-# around this problem, we download the directory and see if the file
-# is in the directory listing.
-#
+##
+## @Implementation_note wget --spider still downloads ftp files in full
rather
+## @Implementation_note than just checking that the file is there. To get
+## @Implementation_note around this problem, we download the directory and
see
+## @Implementation_note if the file is in the directory listing.
+##
#---------------------------------------------------------------------
function url_ftp_verify() {
local URL=$1
diff --git a/var/lib/sorcery/modules/url_handlers/url_rsync
b/var/lib/sorcery/modules/url_handlers/url_rsync
index 4a62fb7..afac2a8 100755
--- a/var/lib/sorcery/modules/url_handlers/url_rsync
+++ b/var/lib/sorcery/modules/url_handlers/url_rsync
@@ -97,4 +97,3 @@ function url_rsync_netselect() {
## Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
##
#---------------------------------------------------------------------
-
diff --git a/var/lib/sorcery/subroutines b/var/lib/sorcery/subroutines
index 21fcdea..4d2ed21 100755
--- a/var/lib/sorcery/subroutines
+++ b/var/lib/sorcery/subroutines
@@ -47,4 +47,3 @@ done
## Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
##
#---------------------------------------------------------------------
-



  • [SM-Commit] GIT changes to test-1.13 sorcery by Jaka Kranjc (f875b3d10d15bfdfbac980cd4679c706ec06bbb6), Jaka Kranjc, 03/14/2008

Archive powered by MHonArc 2.6.24.

Top of Page