summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorSiddharth Ravikumar <sravik@bgsu.edu>2015-12-24 19:25:55 -0500
committerSiddharth Ravikumar <sravik@bgsu.edu>2015-12-24 19:25:55 -0500
commitbcb925691cc4cfc9309ba6ba7bd192de7ce9c781 (patch)
treea31ee76856f514fbc0086c31ff9ddb4392e101c7
parent6f073c493d70a05d4de76d7513d8cf5a72b86b73 (diff)
Added docs/setup/index.rst
`docs/setup/index.rst` contains information about install combox on gnu/linux and osx and information about setting up development environment on windows.
-rw-r--r--ChangeLog5
-rw-r--r--docs/setup/index.rst165
2 files changed, 168 insertions, 2 deletions
diff --git a/ChangeLog b/ChangeLog
index a30f0c0..d9ad8e6 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,12 +1,13 @@
2015-12-24 Siddharth Ravikumar <sravik@bgsu.edu>
* setup.py: updated `description`.
- * docs/index.rst: Removed gnu, osx, windows, setup-combox from
- toctree; Added releases to toctree.
+ * docs/index.rst: Removed `gnu`, `osx`, `windows`, `setup-combox`
+ from toctree; Added `releases` and `setup/index` to toctree.
* docs/gnu.rst: Removed.
* docs/osx.rst: Removed.
* docs/setup-combox.rst: Removed.
* docs/windows.rst: Removed.
+ * docs/setup/index.rst: Added.
* docs/releases.rst: Added.
* docs/api/combox.crypto.rst: Added.
* docs/api/index.rst: Added api/combox.crypto, docs/releases to toctree.
diff --git a/docs/setup/index.rst b/docs/setup/index.rst
new file mode 100644
index 0000000..50d9513
--- /dev/null
+++ b/docs/setup/index.rst
@@ -0,0 +1,165 @@
+=====
+setup
+=====
+
+.. highlight:: bash
+
+gnu/linux
+=========
+
+Install ``python-pip`` package.
+
+On Debian_ or Ubuntu_::
+
+ $ sudo aptitude install python-pip
+
+On Fedora_::
+
+ $ sudo yum install python-pip
+
+On Arch_::
+
+ $ pacman -S python2-pip
+
+.. _Debian: https://www.debian.org
+.. _Ubuntu: http://www.ubuntu.com
+.. _Fedora: https://getfedora.org
+.. _Arch: https://www.archlinux.org
+
+Install ``combox`` using the ``pip`` installer::
+
+ $ pip install combox
+
+
+os x
+====
+
+If Hombrew_ is not already installed, install it first::
+
+ $ ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
+
+.. _Hombrew: http://brew.sh/
+
+Next, install ``python`` from Hombrew_::
+
+ $ brew install python
+
+This will also install ``pip``.
+
+Install ``combox`` using the ``pip`` installer::
+
+ $ pip install combox
+
+
+windows
+=======
+
+.. highlight:: powershell
+
+At the moment, ``combox`` is not compatible with Windows. The following
+sections describe how to set up the development environment on
+Windows.
+
+
+setup python, pip and virtualenv
+--------------------------------
+
+Install python v2.7.x first: `python.org/downloads/windows`__
+
+.. _pywindows: https://www.python.org/downloads/windows
+.. __: pywindows_
+
+Add python to ``PATH``:
+
+.. code-block:: none
+
+ %PATH%;C:\Python27
+
+Make sure python works from Windows Powershell
+
+Get a copy of `get-pip.py`_.
+
+.. _get-pip.py: https://raw.githubusercontent.com/pypa/pip/master/contrib/get-pip.py
+
+From Windows Powershell, ``cd`` to the directory containing
+``get-pip.py`` file and do::
+
+ python get-pip.y
+
+That should install ``pip`` and ``setuptools``.
+
+Next, add pip to ``PATH``:
+
+.. code-block:: none
+
+ %PATH%;C:\Python27;C:\Python27\Scripts
+
+Make sure ``pip`` works from Windows Powershell by doing::
+
+ pip --version
+
+Lastly, install ``virtualenv``::
+
+ pip install virtualenv
+
+
+install git
+-----------
+
+Get a copy of ``git`` from `git-scm.com/download/win`__
+
+.. _gitwin: http://git-scm.com/download/win
+.. __: gitwin_
+
+In the "Adjusting your PATH environment" screen in the ``git``
+installation wizard, choose the "Use Git from the Windows Command
+Prompt"
+
+Make sure ``git`` works from Windows Powershell by doing::
+
+ git --version
+
+
+setup combox
+------------
+
+install v. c++ compiler
+_______________________
+
+From `aka.ms/vcpython27`__ (this is required for installing
+``pycrypto`` package from ``pip``).
+
+.. _vcpython27: http://aka.ms/vcpython27
+.. __: vcpython27_
+
+
+setup combox
+____________
+
+From the Windows Powershell, do::
+
+ git clone git://ricketyspace.net/combox.git
+
+
+setup virtual environment
+.........................
+
+``cd`` to the ``combox`` directory and do::
+
+ virtualenv .
+
+
+activate virtual environment
+............................
+
+``cd`` to the ``combox`` directory and do::
+
+ .\Scripts\activate
+
+
+install combox
+..............
+
+in ``develop`` mode::
+
+ python setup.py develop