The sorcery command is a very useful command as it has a lot of different functions. First I'll talk about the command line options for sorcery.
sorcery update This command will update the sorcery package on your system.
sorcery system-update This command is the equivalent of running: scribe update, sorcery update, sorcery queue, cast --queue, cast --fix. This will update the grimoire then update any out of date software on your computer.
sorcery queue This generates a list of spells that need to be updated and places them in the install queue.
sorcery upgrade This command updates the spells but does not update the grimoire. This is the equivalent of typing: sorcery queue, cast --queue.
Now onto the menu system of sorcery. This menu allows you to do a lot of things easily, from managing grimoires and spells to changing features of your system.
Sorcery
Spell Menu - Selecting this will allow you to add spells, rebuild the system, hold spells, remove spells, select spells to install/remove, and updates your spells.
Options Menu - Allows you to customize your sorcery options.
*Sorcery Branch - Allows you to select which branch of sorcery you wish to track. The two branches of sorcery you can use are the Devel branch and the Stable branch. NOTE: don't get this confused with the codex, the branches are for the sorcery scripts themselves only, not the grimoire.
*Prompt Delay - Changing this allows you to shorten or elongate the amount of time the sorcery scripts wait at a prompt before it automatically chooses the default.
*Download Rate - This lets you put a limit, if you so choose, on how many bytes per second summon downloads files. If you don't wish there to be any limit just leave this blank.
*Email of Sorcerer - This allows you to enter in the email address you wish to recieve reports about the box.
*Feature Menu - Allows you to select/deselect various sorcery features.
*Integrity Checking - Allows you to change options for checking the integrity for system integrity checking and download integrity checking.
*Number of "make" Jobs - This allows you to specify the maximum number of jobs make should run at a time. Setting this to 0 will mean there is no limit. WARNING: Setting this to more then 1 is risky as not all makefiles support concurrent builds.
*Distributed Compiling which allows you to setup distributed compiling by specifying which volunteer computers will be helping with the compiling process, or you can leave it blank to disable distributed compiling all together.
*Software Mirrors - Allows you to select which mirrors you wish to use to download spells in a certain category.
*Optimize Architecture - This allows you to choose how you wish to optimize the spells you compile later.
*Sorcery Development - Allows you to debug sorcery. This is mainly for developers and thus the debug file should be kept at /dev/null unless you really wish to use this option.
Log Menu - Allows you to set some specific log files
*Grep Install Logs - Lets you search through install logs.
*View Install Log - Shows you the install log of a spell.
*Edit Install Log - Opens up the install log under your specified editor for editing.
*View Compile Log - Shows you the compile log of a spell.
*Remove Compile Log - Allows you to remove a compile log of a spell from the system.
Queue Menu - Manage sorcery queues
*View Install Queue - Shows the list of spells that have been selected for installation
*Edit Install Queue - Opens your editor for you to change the list of spells which are tagged for install.
*View Removal Queue - Shows the list of spells that have been selected for removal.
*Edit Removal Queue - Opens your editor for you to change the list of spells which are tagged for removal.
*View Spell Status - Shows the datafile of installed spells.
*Edit Spell Status - Opens your editor for you to edit the datafile of installed spells.
Foreground Execute - Exits the sorcery command to process all the queues.
Background Execute - Processes the queues. It will then return you to the sorcery menu and continue to process the queues in the background.
Cabal Menu - Allows you to administrate groups of Unix/Linux boxes.
