Differences between revisions 1 and 24 (spanning 23 versions)
⇤ ← Revision 1 as of 2008-10-13 10:41:49 →
Size: 1609
Editor: NicolasThiery
Comment: New page with basic instructions on the patch server
← Revision 24 as of 2009-01-28 01:00:45 → ⇥
Size: 1931
Editor: NicolasThiery
Comment:
Deletions are marked like this. Additions are marked like this.
Line 2: Line 2:
Line 5: Line 4:
For advanced usage of the patch server, see [combinat/Mercurial]. See also the [[http:/combinat/MercurialStepByStep|step by step instructions]] to contribute to sage-combinat.
Line 7: Line 6:
== Install the Sage-combinat patches For technical background on the usage of the patch server, see http:/combinat/Mercurial.
Line 9: Line 8:
We assume sage is already installed (say in /opt/sage), and that the user has write access on the installation tree. <<TableOfContents(2)>>
Line 11: Line 10:
Edit your Mercurial configuration file (~/.hgrc in your home directory), and insert the following (if not yet there): == Prerequisites ==

We assume that:
 * Sage 3.2 or higher is already installed (say in {{{/opt/sage}}}), and can be started by typing {{{sage}}} at the command line
   (it is recommended to use the most recent stable version)
 * The user has write access on the {{{Sage}}} installation tree
 * The user has access to: http://sage.math.washington.edu:2144/

/* * Mercurial is already installed ({{{sudo apt-get install mercurial}}} on Debian) */

Open (or create, if it does not exist yet) your Mercurial configuration file ({{{~/.hgrc}}} in your home directory), insert the following, and edit the username:
Line 14: Line 23:
username = YourFirstName YourLastName <YourEmail>
 username = Simon Cussonnet <Simon.Cussonnet at lycee-technique.torrez.eure.fr>
Line 20: Line 28:
Line 23: Line 30:
Line 26: Line 32:

[extdiff] 		 [extdiff]
Line 31: Line 36:
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:		 == Download and install the Sage-combinat patches ==
Line 47: Line 41:
Some help is available with: == Update the Sage-combinat patches ==
Line 49: Line 43:
/opt/sage/sage-python sage-combinat --help sage -combinat update
Line 52: Line 46:

== Update the Sage-combinat patches
 == Upgrade Sage and update the Sage-combinat patches ==
Line 56: Line 48:
python sage-combinat update sage -combinat upgrade
Line 59: Line 51:
== Upgrade Sage and update the Sage-combinat patches == Get further help on {{{sage -combinat}}} ==
{{{
sage -combinat --help
}}}
Line 61: Line 56:
== Uninstall the Sage-combinat patches ==
Line 62: Line 58:
python sage-combinat upgrade sage -b main
Line 64: Line 60:
Now, you may destroy {{{.../sage/devel/sage-combinat/}}} (after checking that you do not have local changes!)

The Sage-combinat patch server: basic instructions

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

See also the step by step instructions to contribute to sage-combinat.

For technical background on the usage of the patch server, see http:/combinat/Mercurial.

Contents

  1. The Sage-combinat patch server: basic instructions
    1. Prerequisites
    2. Download and install the Sage-combinat patches
    3. Update the Sage-combinat patches
    4. Upgrade Sage and update the Sage-combinat patches
    5. Get further help on {{{sage -combinat}}}
    6. Uninstall the Sage-combinat patches

Prerequisites

We assume that:

  • Sage 3.2 or higher is already installed (say in /opt/sage), and can be started by typing sage at the command line

    • (it is recommended to use the most recent stable version)

  • The user has write access on the Sage installation tree

  • The user has access to: http://sage.math.washington.edu:2144/

Open (or create, if it does not exist yet) your Mercurial configuration file (~/.hgrc in your home directory), insert the following, and edit the username: 

[ui]
username = Simon Cussonnet <Simon.Cussonnet at lycee-technique.torrez.eure.fr>
[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 and install the Sage-combinat patches

sage -combinat install

Update the Sage-combinat patches

sage -combinat update

Upgrade Sage and update the Sage-combinat patches

sage -combinat upgrade

Get further help on {{{sage -combinat}}}

sage -combinat --help

Uninstall the Sage-combinat patches

sage -b main

Now, you may destroy .../sage/devel/sage-combinat/ (after checking that you do not have local changes!)