summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorSebastian Thiel <byronimo@gmail.com>2010-07-01 15:45:25 +0200
committerSebastian Thiel <byronimo@gmail.com>2010-07-01 15:45:25 +0200
commit28a33ca17ac5e0816a3e24febb47ffcefa663980 (patch)
treeddcf9f00b3fc262074469795552198c46872f953 /doc
parentfde6522c40a346c8b1d588a2b8d4dd362ae1f58f (diff)
downloadgitpython-28a33ca17ac5e0816a3e24febb47ffcefa663980.tar.gz
Added further information about the required submodules, and how to install them. Incremeneted version to 0.3.0 beta1
Diffstat (limited to 'doc')
-rw-r--r--doc/conf.py4
-rw-r--r--doc/intro.rst25
2 files changed, 27 insertions, 2 deletions
diff --git a/doc/conf.py b/doc/conf.py
index 0dda5b0f..766ecb75 100644
--- a/doc/conf.py
+++ b/doc/conf.py
@@ -92,6 +92,10 @@ pygments_style = 'sphinx'
# Options for HTML output
# -----------------------
+html_theme_options = {
+ "stickysidebar": "true"
+}
+
# The style sheet to use for HTML and HTML Help pages. A file of that name
# must exist either in Sphinx' static/ path, or in one of the custom paths
# given in html_static_path.
diff --git a/doc/intro.rst b/doc/intro.rst
index 51187569..c96766fb 100644
--- a/doc/intro.rst
+++ b/doc/intro.rst
@@ -13,13 +13,21 @@ The object database implementation is optimized for handling large quantities of
Requirements
============
-* Tested with `Git`_ 1.7.0 or newer
+* `Git`_ 1.7.0 or newer
+ It should also work with older versions, but it may be that some operations
+ involving remotes will not work as expected.
+* `GitDB`_ - a pure python git database implementation
+
+ * `async`_ - asynchronous task scheduling
+
* `Python Nose`_ - used for running the tests
* `Mock by Michael Foord`_ used for tests. Requires version 0.5
.. _Git: http://git-scm.com/
.. _Python Nose: http://code.google.com/p/python-nose/
.. _Mock by Michael Foord: http://www.voidspace.org.uk/python/mock.html
+.. _GitDB: http://pypi.python.org/pypi/gitdb
+.. _async: http://pypi.python.org/pypi/async
Installing GitPython
====================
@@ -49,6 +57,8 @@ script:
.. sourcecode:: none
# python setup.py install
+
+.. note:: In this case, you have to manually install `GitDB`_ and `async`_ as well. It would be recommended to use the :ref:`git source repository <source-code-label>` in that case.
Getting Started
===============
@@ -63,6 +73,8 @@ API Reference
An organized section of the GitPthon API is at :ref:`api_reference_toplevel`.
+.. _source-code-label:
+
Source Code
===========
@@ -75,7 +87,16 @@ and cloned using::
$ git clone git://gitorious.org/git-python/mainline.git git-python
$ git clone git://github.com/Byron/GitPython.git git-python
-
+
+Initialize all submodules to obtain the required dependencies with::
+
+ $ cd git-python
+ $ git submodule update --init --recursive
+
+Finally verify the installation by running the `nose powered <http://code.google.com/p/python-nose/>`_ unit tests::
+
+ $ nosetests
+
Mailing List
============
http://groups.google.com/group/git-python