diff options
-rw-r--r-- | README.md | 113 | ||||
-rw-r--r-- | README.rst | 130 |
2 files changed, 130 insertions, 113 deletions
diff --git a/README.md b/README.md deleted file mode 100644 index 5a2ae3e..0000000 --- a/README.md +++ /dev/null @@ -1,113 +0,0 @@ -# combox - -Encrypts files and scatters them across storage provided by Google -Drive and Dropbox. - -The ideas for this program is based on [`combobox`][1]. - -Homepage at <https://ricketyspace.net/combox> - - -[1]: https://bitbucket.org/bgsucodeloverslab/combobox - -# etymology - -`combox` is a lazy contraction of the word "combo box". `combox` is -pronounced as "combo box". - - -# canonical repo - - $ git clone git://ricketyspace.net/combox.git - - -# runs on - - - GNU/Linux - - OS X - -# using combox - -## on GNU/Linux - -Install `virtualenv` and python dev. package. - -On a Debian based distribution, do: - - # aptitude install virtualenv python-dev - -## on OS X - -First install [Hombrew][brew.sh]: - - $ ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)" - -Then do: - - $ brew update - $ brew doctor - -[brew.sh]: http://brew.sh/ - -Next, install python from Hombrew: - - $ brew install python - -This will also install `pip`. - -Lastly do: - - $ pip install virtualenv - - -## set up combox - -Get the latest copy of combox: - - $ git clone git://ricketyspace.net/combox.git - -Setup virtual environment: - - $ cd combox - $ virtualenv . - -Activate the virtual environment: - - $ source bin/activate - -Install combox: - - $ python setup.py install - -Run combox: - - $ combox - -Always make sure that the virtual environment is activated before -running combox. To activate virtual environment, do: - - $ cd path/to/combox - $ source bin/activate - - -## combox on Windows - -At the moment, combox is not compatible with Windows. If you can make -combox work on Windows, look at -<https://ricketyspace.net/combox/windows/> for info on setting up the -development environment on Windows. - -# license - -`combox` is licensed under the -[GNU General Public License version 3 or later][gpl]. See COPYING. - -The `combox` logo (`graphics/logo/combox-logo.svg`) is under [Public Domain][pd]. - -[gpl]: https://gnu.org/licenses/gpl-3.0.txt -[pd]: https://creativecommons.org/publicdomain/zero/1.0/ - - -# contact - -siddharth ravikumar <sravik@bgsu.edu> (gpg id: `0x00B252AF`) diff --git a/README.rst b/README.rst new file mode 100644 index 0000000..a8c8c65 --- /dev/null +++ b/README.rst @@ -0,0 +1,130 @@ +====== +combox +====== + +Encrypts files and scatters them across storage provided by Google +Drive and Dropbox. + +The ideas for this program is based on combobox_ + +Homepage at <https://ricketyspace.net/combox> + +.. _combobox: https://bitbucket.org/bgsucodeloverslab/combobox + + +etymology +--------- + +``combox`` is a lazy contraction of the word "combo box". ``combox`` +is pronounced as "combo box". + + +canonical repo +-------------- + +:: + + $ git clone git://ricketyspace.net/combox.git + + +runs on +------- + + - GNU/Linux + - OS X + + +using combox +------------ + +on gnu/linux +============ + +Install ``virtualenv`` and python dev. package. + +On a Debian based distribution, do:: + + # aptitude install virtualenv python-dev + +on os x +======= + +First install Hombrew_:: + + $ ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)" + +.. _Hombrew: http://brew.sh/ + +Then do:: + + $ brew update + $ brew doctor + +Next, install python from Hombrew_:: + + $ brew install python + +This will also install ``pip``. + +Lastly do:: + + $ pip install virtualenv + +set up combox +============= + +Get the latest copy of combox:: + + $ git clone git://ricketyspace.net/combox.git + +Setup virtual environment:: + + $ cd combox + $ virtualenv . + +Activate the virtual environment:: + + $ source bin/activate + +Install combox:: + + $ python setup.py install + +Run combox:: + + $ combox + +Always make sure that the virtual environment is activated before +running combox. To activate virtual environment, do:: + + $ cd path/to/combox + $ source bin/activate + + +combox on windows +----------------- + +At the moment, combox is not compatible with Windows. If you can make +combox work on Windows, look at +<https://ricketyspace.net/combox/windows/> for info on setting up the +development environment on Windows. + +license +------- + +``combox`` is licensed under the `GNU General Public License version 3 +or later`__. See COPYING. + +.. _gpl: https://gnu.org/licenses/gpl-3.0.txt +.. __: gpl_ + +The ``combox`` logo (``graphics/logo/combox-logo.svg``) is under +`Public Domain`__. + +.. _pd: https://creativecommons.org/publicdomain/zero/1.0/ +.. __: pd_ + +contact +------- + +siddharth ravikumar <sravik@bgsu.edu> (gpg id: ``0x00B252AF``) |