A item version is defined by (Library, Item, Version) in the dim namespace.

Library is an absolute Unix directory path. Library can be defined by '-L Library' or 'export DIMLIB=Library'.

Item is a sequence of letters, digits and underscores. Item can be defined by '-I Item' or specified for each argument.

Version is a a sha1 checksum (a sequence of 40 hex digits) or list of node names (Main node, Branch node, ...). Version can be specified for each argument, specified or modified by various command flags.

Branch node is a sequence of letters, digits, underscores and dots. A dot can only be used between two digits.

Main nodes are:
   Public, created by 'dim export', prefixed by '-', starting with a digit.

Branch nodes can be:
Public, created by 'dim export', prefixed by '-', starting with a letter. Private, created by 'dim save', prefixed by '--', starting with a letter. Volatile, created by 'dim mount', prefixed by '+', without letters or underscores.

An existing item version can be unambiguously specified by the Unix path of one of its file or directory (at the cost of using '.'n '..' or '/'). The argument of dim commands operating one item version typically defaults to '.'.

On the other hand, the current command line syntax used by dim to specify an item version in the dim namespace is inconsistent and ambiguous. There are also some restrictions.

Inconsistencies:
   Library cannot be specified for each argument.
   Item cannot be specified for each sha1 checksum argument.
   Version cannot be specified with -V Version.

Ambiguities:
   Relative Unix path without '.' or '/' looks like Item or Version.
   Main node Version without '.' looks like Item.

Restrictions:
   Item or Main node Version cannot be 40 hex digits.
   Public node Version must end with a digit.
--
Archive: http://www.mail-archive.com/dim@ml.free.fr/
To unsubscribe: mailto:[EMAIL PROTECTED]

Reply via email to