Replace README.markdown with README.org

And add .0 to version
This commit is contained in:
Tom Willemsen 2013-01-20 13:20:52 +01:00
parent 6246b977c3
commit 09ace1bc4b
3 changed files with 88 additions and 74 deletions

View file

@ -1,73 +0,0 @@
# Gitto
For lack of a better title.
My simple utility to keep track of all the git repositories I have on
my computer(s). Also an experiment in writing scheme.
Written for `guile` 2.0.x
## Installation
Installing `gitto` is not really necessary, but it *is* more
convenient. In order to install it just run:
# make install
This will install `gitto` to `/usr/local/`, if you would like it
somewhere else you could use the `DESTDIR` variable:
# make install DESTDIR=/some/other/place
This will install `gitto` to `/some/other/place/`.
## Removal
If you're fed up with `gitto` and want it gone, and I do mean **now**,
you can run:
# make uninstall
This will remove any `gitto` installed files from `/usr/local/`, if
you used the `DESTDIR` variable during installation, you should give
it the same value here, like:
# make uninstall DESTDIR=/some/other/place
This will remove any `gitto` installed files from
`/some/other/place/`.
## Usage
Usage is, hopefully, simple, first you have to register some repos:
$ gitto -r ~/projects/project1
$ gitto -r ~/projects/project2
$ gitto -r ~/projects/project3
Then you can call `gitto` without any argument to see a list of your
repos and their statuses:
$ gitto
project1: 0 to push, 0 to pull and is dirty
project2: 5 to push, 2 to pull and is not dirty
project3: 0 to push, 1 to pull and is not dirty
If you're done with one of your projects and no longer wish to track
their status you can unregister them:
$ gitto -R ~/projects/project1
If you require further assistance:
$ gitto -h
### `run-gitto`
As I mentioned, it is not completely necessary to install gitto, I
have added a utility to run it straight from je project directory,
although mostly for testing purposes.
Using `run-gitto` works exactly the same as using `gitto` when it is
installed.

87
README.org Normal file
View file

@ -0,0 +1,87 @@
* Gitto
For lack of a better title.
My simple utility to keep track of all the git repositories I have
on my computer(s). Also an experiment in writing scheme.
Written for [[http://gnu.org/software/guile][GNU Guile]] 2.0.x
** Installation
Installing ~gitto~ is not really necessary, but it *is* more
convenient. In order to install it just run:
#+BEGIN_EXAMPLE
make install
#+END_EXAMPLE
This will install ~gitto~ to ~/usr/local/~, if you would like it
somewhere else you could use the ~DESTDIR~ variable:
#+BEGIN_EXAMPLE
make install DESTDIR=/some/other/place
#+END_EXAMPLE
This will install ~gitto~ to ~/some/other/place/~.
** Removal
If you're fed up with ~gitto~ and want it gone, and I do mean *now*,
you can run:
#+BEGIN_EXAMPLE
make uninstall
#+END_EXAMPLE
This will remove any ~gitto~ installed files from ~/usr/local/~, if you
used the ~DESTDIR~ variable during installation, you should give it
the same value here, like:
#+BEGIN_EXAMPLE
make uninstall DESTDIR=/some/other/place
#+END_EXAMPLE
This will remove any ~gitto~ installed files from ~/some/other/place/~.
** Usage
Usage is, hopefully, simple, first you have to register some repos:
#+BEGIN_EXAMPLE
$ gitto -r ~/projects/project1
$ gitto -r ~/projects/project2
$ gitto -r ~/projects/project3
#+END_EXAMPLE
Then you can call ~gitto~ without any argument to see a list of your
repos and their statuses:
#+BEGIN_EXAMPLE
$ gitto
project1: 0 to push, 0 to pull and is dirty
project2: 5 to push, 2 to pull and is not dirty
project3: 0 to push, 1 to pull and is not dirty
#+END_EXAMPLE
If you're done with one of your projects and no longer wish to
track their status you can unregister them:
#+BEGIN_EXAMPLE
$ gitto -R ~/projects/project1
#+END_EXAMPLE
If you require further assistance:
#+BEGIN_EXAMPLE
$ gitto -h
#+END_EXAMPLE
*** run-gitto
As I mentioned, it is not completely necessary to install gitto, I
have added a utility to run it straight from je project directory,
although mostly for testing purposes.
Using ~run-gitto~ works exactly the same as using ~gitto~ when it is
installed.

View file

@ -44,7 +44,7 @@
(define (version)
"Display version information."
(display "gitto 0.1") (newline)
(display "gitto 0.1.0") (newline)
(display "Copyright (C) 2012 Tom Willemsen") (newline)
(display "This program comes with ABSOLUTELY NO WARRANTY.") (newline)
(display "You may redistribute copies of this program") (newline)