aboutsummaryrefslogtreecommitdiffstats
path: root/README.org
blob: f5be72598ed36d84633d7067b4b5b1d53e90ed99 (plain)
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
64
65
66
67
68
69
70
71
* 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:

   : 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.