File: git_install.rst

package info (click to toggle)
astropy 3.1.2-2
  • links: PTS, VCS
  • area: main
  • in suites: buster
  • size: 45,664 kB
  • sloc: ansic: 168,124; python: 147,173; sh: 11,313; lex: 7,215; xml: 1,710; makefile: 463; cpp: 364
file content (63 lines) | stat: -rw-r--r-- 1,556 bytes parent folder | download | duplicates (3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
:orphan:

.. include:: links.inc
.. _install-git:

**************************
 Install and configure git
**************************


Get git
=======

Installers and instructions for all platforms are available at
https://git-scm.com/downloads

.. _essential_config:

Essential configuration
=======================

Though technically not required to install `git`_ and get it running, configure `git`_ so that you get credit for your contributions::

    git config --global user.name "Your Name"
    git config --global user.email you@yourdomain.example.com

.. note::
    Use the same email address here that you used for setting up your GitHub
    account to save yourself a couple of steps later, when you connect your
    git to GitHub.

Check it with::

    $ git config --list
    user.name=Your Name
    user.email=you@yourdomain.example.com
    # ...likely followed by many other configuration values

.. _git_gui_options:

Get a git GUI (optional)
========================

There are several good, free graphical interfaces for git.
Even if you are proficient with `git`_ at the command line a GUI can be useful.

Mac and Windows:

+ `SourceTree`_
+ The github client for `Mac`_ or `Windows`_

Linux, Mac and Windows:

+ `git-cola`_

There is a more extensive list of `git GUIs`_, including non-free options, for
all platforms.

.. _git GUIs: https://git-scm.com/downloads/guis
.. _SourceTree: https://www.sourcetreeapp.com/
.. _Mac: https://desktop.github.com/
.. _Windows: https://desktop.github.com/
.. _git-cola: http://git-cola.github.io/