The Sage-combinat patch server: basic instructions

This page describes how to install and update the Sage-combinat experimental patches.

For advanced usage of the patch server, see [http:/combinat/Mercurial].

TableOfContents(2)

Install the Sage-combinat patches

We assume sage is already installed (say in /opt/sage), and that the user has write access on the installation tree.

Edit your Mercurial configuration file (~/.hgrc in your home directory), and insert the following (if not yet there):

[ui]
username = YourFirstName YourLastName <YourEmail>

[extensions]
hgext.mq =
extdiff =
alias =

[alias]
qstatus = status --rev -2:.

[hooks]
pre-qrefresh = (echo "Are you sure you want to refresh the following changes:"; sage -hg status; echo -n "into the patch: "; hg qtop; read -p "(y/n)" answer; test "$answer" = "y"  )

[extdiff] 
cmd.interdiff = hg-interdiff

Download the attachment:sage-combinat script, and run from anywhere:

python sage-combinat install

In case Sage or python is not in the user's path, you may have to specify where they are, as in:

/opt/sage/sage-python sage-combinat install --sage=/opt/sage/sage

Note: starting from sage 3.1.3, the sage-combinat script is readily included in the sage distribution, and you can run it with:

sage -combinat install

Some help is available with:

/opt/sage/sage-python sage-combinat --help

Update the Sage-combinat patches

python sage-combinat update

Upgrade Sage and update the Sage-combinat patches

python sage-combinat upgrade