Setting Up Git#
To work on the Sage source code, you need
gitinstallation, see Installing Git.
gitto use your name and email address for commits, see Your Name and Email.
The Tips and References chapter contains further information
git that might be useful to some but are not required.
git on the command line. Most distributions will have
it installed by default if other development tools are installed. If
that fails, use the following to install git:
- Debian / Ubuntu
sudo apt-get install git-core
sudo yum install git-core
- Windows (Cygwin)
Install the Cygwin package
git. Do not attempt to use native Windows installations of
- Windows (WSL)
We strongly recommend to install the package using the Linux distribution’s package manager. Native Windows installations of
gitmay also work, but there are possible pitfalls.
Install the Xcode Command Line Tools.
Some further resources for installation help are:
The git homepage for the most recent information.
Your Name and Email#
The commit message of any change contains your name and email address to acknowledge your contribution and to have a point of contact if there are questions in the future; filling it in is required if you want to share your changes. The simplest way to do this is from the command line:
[[email protected] ~] git config --global user.name "Your Name" [[email protected] ~] git config --global user.email [email protected]
This will write the settings into your git configuration file with your name and email:
[user] name = Your Name email = [email protected]
Of course you’ll need to replace
Your Name and
with your actual name and email address.