Summon downloads the source code for a specified spell.

Usage: summon <spellname>

After the download is complete, you can cast that spell without having to wait for a download. This lets you start downloading spells before you go to bed, then get up and cast them in the morning. Very useful for people on dialup connections.

You can summon the source for multiple spells simultaneously. Just list all the spells you want after the summon command, separated by spaces, thus:

summon <spell1> <spell2> <spell3> . . . <spellX>

---

Command-line Options

Summon has five command line options:

--from
Usage: summon --from <directory>
This is slightly misleading. What it does is specify the directory into which the downloaded source will be put, NOT the directory that the source should be retrieved from. Using this option, it will go ahead and download the file from the network, then put it into the specified dir.

--url
Usage: summon --url !http://www.fubar.com/soucedir/
Specifies the place to download the file from; not sure whether you specify the full path to the desired file or just to the dir with the file in it.

-d or --download
Usage: summon -d foo
Force download of source, regardless of whether it exists locally or not.

--queue
Usage: summon --queue
Downloads all spells in the install queue.

--all
Usage: summon --all
Downloads all spells in the codex.

WARNING: Summoning the entire codex is not necessarily a great idea. You'll use up an enormous amount of disk space with all that source code.

---

Proxy Settings

Summon can be made to use a proxy server by setting the environment variables http_proxy, ftp_proxy, and no_proxy (for sites which are to bypass the proxy).

Note that all of these environment variables are in lowercase.

---

Fastest mirror site lookup

Summon can be configured (using the sorcery command) to use netselect to find the fastest mirror site, wihch can reduce download time.