Homepage
At the moment, Erlisp's homepage is at the author's personal website. There you will find Erlisp's roadmap and other more in-depth information.
Mailing list
The erlisp-devel mailing list is a forum to discuss Erlisp, its development, and its usage. It is also mailed automatically with patch logs whenever a new set of patches is added to the darcs repository.
Thanks to GMANE, the mailing list is also accessible as the newsgroup gmane.lisp.erlisp.devel on news.gmane.org. The newsgroup is a bi-directional interface to the mailing list, so e-mails sent to either one will show up on both.
Latest snapshot
You can download the latest snapshot of the Erlisp source code here: erlisp-snapshot.tar.gz. Whenever a new patch is checked into the repository, a patch description is sent to the mailing list and the snapshot is updated.
Darcs repository
Erlisp is being developed in the darcs
repository at http://www.common-lisp.net/project/erlisp/darcs/erlisp
.
Below are some instructions on working with the Erlisp source
code using command-line darcs
. More information can
be found at the darcs
website.
Getting the source
To get Erlisp's source code for the first time, simply do:
$ darcs get http://www.common-lisp.net/project/erlisp/darcs/erlisp
In the current working directory, this will create a subdirectory called erlisp, containing a working copy of the Erlisp repository.
Whenever you want to get the latest updates from the repository, go to this erlisp directory and do:
$ darcs pull
Working with the source
With darcs, there's no difference between a working copy and a repository. So after the above you should have your own private Erlisp repository to do development in. At any time, you can inspect your changes with:
$ darcs whatsnew --summary -l
The -l
causes new files that have not been
darcs add
ed yet to show up in the listing.
Leave off the --summary
to see the actual diffs,
instead of just the filenames of changed files.
Whenever you have some changes you are satisfied with, do:
$ darcs record
If this is the first time you do a darcs record
,
you'll be asked for your e-mail address. You are recommended to
use the format "Full Name <e-mail@addr.ess>", for example:
SpongeBob SquarePants <sb@bikini-bottom.tk>.
You will then be asked which of your changes you want to record in the patch. This is handy to make several coherent patches out of a lot of unrelated changes.
Finally, you'll be asked for a patch name and a longer patch description. (The latter will open your default editor.) Try to give patches a meaningful name, and a description in the style of GNU Change Logs.
After all this, you will have a new local patch. You can now make more changes and patches, unrecord some patches you are not happy with after all, get new patches from the main repository (as described above), and so forth. See the manual at the darcs website for more information.
Sending patches back
If you have a patch (or a set of patches) that you feel should be in the main Erlisp repository, you'll need to e-mail them to me. To do so, start with the following:
$ darcs send -o filename
Darcs wil ask you which patches you want to include, and then writes them out to the file called filename. You should then attach this file to an e-mail and send it to dirk@dirkgerrits.com.
If you have a command-line e-mail command (like
nail
or sendmail
), you can automate the
e-mail sending as follows:
$ darcs send --sendmail-command
COMMAND
After you specify the patches to include, darcs should figure out my e-mail address by itself, and then use the specified COMMAND to send the e-mail. For more information about the syntax of COMMAND, and how to set it in your darcs preferences, see the manual at the darcs website.
Back to Common-lisp.net.