Quick Start

The installation is really easy, as there is nothing to compile. You just copy the dim script (plus one small optional script: wd for word diff browsing) in your usual binpath(i.e /usr/local/bin or ~/bin), idem for manpages. There is also a Makefile to handle that.

If there is already an existing repository that you want to track, just attach a library to it, and start updating:

  $ mkdir jobdir; cd jobdir
  $ dim mkjob http://www.oligem.com/dim/wdim.php       # create jobdir/.dimlib
  $ dim get -a             # download all archives in jobdir/.dimlib/archive

You can perform queries in jobdir with the following commands:

  $ dim item -a                 # list all imported items 
  $ dim version -aA myitem      # list all versions of item myitem
  $ dim diff item-v1 item-v2     # print different files
  $ dim wdiff item-v1 item-v2   # browse word diffs of all changed files
  $ dim wdiff -2 item-v2 ./dim  # word diff with the 2nd level anc, per file

Still in jobdir, start your own set of modifications, and save them locally:

  $ mkdir item; cd item  # optional
  $ dim clone item-v2    # obtain a writable copy of item-v2
  $ vi file1
  $ dim save                    # save into item--1
  $ vi file2
  $ dim add file2             # add file2 to item
  $ dim save                   # save into item--2

If you want now to publish your work, you have first to register as user:

  $ dim mkuser          # obtain an alias from the library server

Then each time you want to publish:

  $ dim export  # will be exported as item-alias1

Document updated 23-November-2009.