www

Unnamed repository; edit this file 'description' to name the repository.
Log | Files | Refs

README.markdown (1090B)


      1 git-history
      2 ===========
      3 
      4 Usage
      5 -----
      6 
      7     Usage : sh git-hist.sh filename
      8     You must be in a directory versionned with git for this to work.
      9 
     10 Features
     11 --------
     12 
     13 At the moment, you can view previous, next, first, last version, scroll up, down & back to top.
     14 
     15 Dependencies
     16 ------------
     17 
     18 * terminal with color & cursor movement ansi codes
     19 * bash
     20 * tput
     21 * git
     22 * unix tools : tail head nl tac cut
     23 
     24 Background
     25 ----------
     26 
     27 I've been looking for a tool that would visually "replay" the programmer's work, like a 24h/24 screencast of their editor, but played at an accelerated speed. The aim is to :
     28 1. See the evolution of the whole project.
     29 2. See the evolution of the contents of a single file.
     30 
     31 [Gource](http://code.google.com/p/gource/) provides a soluion for aim #1, and Apple's "time machine" (Mac OS X) seems to provide something somehow related. But both seem to work with a granularity of files & folders, which is too big for aim #2 (I want to see the acual code being modified).
     32 
     33 So I created a short script that allows you to navigate through the different versions of a single file.