summaryrefslogtreecommitdiffstats
path: root/site
diff options
context:
space:
mode:
authorGravatar Tom Willemsen2012-07-01 15:29:16 +0200
committerGravatar Tom Willemsen2012-07-01 15:29:16 +0200
commit46a4c2fe6c1c5ff7d62e1d471c50e93ca71c172a (patch)
treeed7bcf0e7e6fdaa204844f317f419d96bb216ede /site
parent2e78e4e78de8289a7ef2447d03a3be41f4cac531 (diff)
downloadorgweb-46a4c2fe6c1c5ff7d62e1d471c50e93ca71c172a.tar.gz
orgweb-46a4c2fe6c1c5ff7d62e1d471c50e93ca71c172a.zip
Add gitto project description
Diffstat (limited to 'site')
-rw-r--r--site/index.org2
-rw-r--r--site/projects/gitto.org65
2 files changed, 67 insertions, 0 deletions
diff --git a/site/index.org b/site/index.org
index 56720e6..a420bde 100644
--- a/site/index.org
+++ b/site/index.org
@@ -47,6 +47,8 @@
- [[file:projects/org-blog.org][org-blog]] :: A continuation of David O'Toole's ~org-blog~ module for
[[emacs][Emacs]].
- [[file:projects/dispass.el.org][dispass.el]] :: An [[emacs][Emacs]] wrapper for DisPass.
+ - [[file:projects/gitto.org][gitto]] :: A utility for keeping track of my git repositories'
+ status.
* Dotfiles
diff --git a/site/projects/gitto.org b/site/projects/gitto.org
new file mode 100644
index 0000000..05f909c
--- /dev/null
+++ b/site/projects/gitto.org
@@ -0,0 +1,65 @@
+#+TITLE: gitto
+#+LINK_UP: ../index.html
+#+LINK_HOME: http://ryuslash.org
+#+LINK: src https://github.com/ryuslash/gitto
+#+LINK: tar_gz https://github.com/ryuslash/gitto/tarball/master
+#+LINK: zip https://github.com/ryuslash/gitto/zipball/master
+#+STARTUP: show all
+
+#+begin_html
+ <script src="/keyjs.KS" type="text/javascript"></script>
+ <script type="text/javascript">
+ keyjs_initialize({ "u": [ "keyjs_goto", "../index.html" ],
+ "h": [ "keyjs_goto", "http://ryuslash.org" ] });
+ </script>
+#+end_html
+
+#+INCLUDE: "dlmenu.inc"
+
+* About
+
+ ~gitto~ is a utility written in [[http://www.gnu.org/software/guile/][Guile scheme]] to help me keep track of
+ the status of my git repositories.
+
+** Features
+
+ - Show a list of how many commits to pull or push and whether or
+ not the working directory of that repository is dirty.
+
+** Requirements
+
+ - [[http://www.gnu.org/software/guile/][Guile]] v2.0.x
+ - [[http://git-scm.com][git]]
+
+* Usage
+
+** Register repositories
+
+ First you'll have to register some repositories:
+
+ #+begin_example
+ $ gitto -r ~/projects/project1
+ $ gitto -r ~/projects/project2
+ $ gitto -r ~/projects/project3
+ #+end_example
+
+** List status
+
+ Once you have registered some repositories you can list them by
+ calling ~gitto~ without any arguments:
+
+ #+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
+
+** Remove repositories
+
+ When you're fed up with a repository and no longer care about its
+ status, you can remove it with the =-R= switch:
+
+ #+begin_src shell-script
+ $ gitto -R ~/projects/project1
+ #+end_src