Ubuntu Manpage: vl - list version information

NAME

       vl - list version information

SYNOPSIS

       vl  [ version binding options ] [ options ] [ names .. ]
       vlog[ version binding options ] [ options ] [ names .. ]

       Options: [ -?1aAcCdFghlLOqQrRStuvx ] [ -help ] [ -all ]
                [ -attr attribute ] [ -cache ] [ -expand (or -xpon) ]
                [ -fast ] [ -format format string ] [ -intent ] [ -locked ]
                [ -locker ] [ -log ] [ -noexpand (or -xpoff) ]
                [ -p all|attribute name ] [ -version ]

DESCRIPTION

       vl  prints  various information about an AtFS object repository.  While
       its main operation is to list the contents of an object repository in a
       manner  similar  to  ls(1),  vl  knows  about many options that extract
       additional information about individual versions or version  histories.

       If  vl  is  invoked  without  any  name arguments, it simply prints the
       contents of the object repository, including files (busy versions)  and
       directories  in  the  current  directory. Version objects in the object
       repository are  represented  as  filenames  with  a  bracketed  version
       identification extension.  Generally, vl tries to give the illusion, as
       were all the versions in the object repository  regular  files  in  the
       current  directory. While busy versions - which are regular files - may
       be manipulated by all commands and tools that operate on files, version
       objects  can  only  be  manipulated  by special tools (ShapeTools) that
       operate on the object repository. The tools that operate on the  object
       repository,  however,  can  also access regular files because these are
       also part of the object repository.

       With the -h option given,  vl  prints  out  one  information  item  per
       history  rather than per version. Default output in this case is a list
       of history and directory names with the range(s) of available  versions
       following in brackets.

       If  filenames  are  given  as  arguments to vl, similarly to ls(1) only
       information about these object histories will be printed.  Object names
       may  also  be  given  in  bound  version notation, i.e. a notation that
       identifies a particular version of an object (e.g.  mkattr.c[2.4]).  It
       is also possible to use a previously assigned symbolic name rather than
       a numerical version identification  (e.g.  mkattr.c[tools-V4R3]).  Make
       sure to escape the bracket symbols as these usually have meaning to the
       shell. For further version binding possibilities (the  version  binding
       options) see the vbind(1) manual page.

       The  program  vlog  prints  the  log-entry for specified objects.  Log-
       entries usually describe the reason for  a  particular  change  to  the
       design object that led to the creation of the specified revision(s).

OPTIONS

All options also available in the ls(1) programs are marked on the
following list.

-?, -help
Print short information about usage of this command.

-1 (ls)
Force single column output.

-a (ls)
List all entries, even those with a name beginning with a ’.’
and the user.

-all List all available information.

-attr attribute
Print only information about objects that have the specified
attribute with the given values. The attribute value match is
done without attribute expansion, even if -expand is set.
attribute may also be a standard attribute. For a complete list
of standard attributes names see the vadm(1) manual page.

-A (ls)
Same as -a, but ’.’, ’..’, and ’AtFS’ are not listed.

-c (ls)
Sort the list of printed entries by the time of last status
change.

-cache List entries from the derived object cache too.

-C (ls)
Force multi column output. This is default when printing just
the entry names (no -l and no -p option) and output goes to a
terminal.

-d (ls)
With a directory name given as argument, list the directory
itself rather than its contents.

-expand, -xpon
Expand attribute values before printing. Attribute values may
contain citations of other attributes, or they may start with a
special character (’^’, ’!’ or ’*’) indicating that they need
some kind of processing to determine the real attribute value
(see vattr(1) for details). With the -expand option given, all
citations will be evaluated and the attribute will be evaluated
if necessary.

-fast Fast operation. Suppresses reader/writer synchronisation on
AtFS archive files and ignores non-standard attributes. In
combination with -h (histories), a short output is generated,
that lists only the names of all histories and not their
version ranges.

-format format string
Specify custom-format for information printed about objects.
This is a simple report generation facility for the shapeTools
toolkit. The format string can be any string, but typically
contains attribute citations (see retrv). As shapeTools
attribute citations use a syntax that contains dollar-
characters, it is advisable, to specify format strings in
single-quotes to prevent shell from trying to apply variable
substitution.

Format strings can contain simple layout specifications (‘
’
for newline characters, and ‘ ’ for tabs. ‘\’ is a single
backslash.)

The format of the output of vl -l could for example be
specified as follows:
vl -format ´$__mode$ $__state$$__author$ \
$__size$ $__mtime$ $__self$
´

While the example only illustrates use of standard attributes,
it is in fact possible to use any object attribute (i.e. user-
defined attributes) in the format specification.

-F (ls)
Append a symbolic file type character to each name. Directories
are marked with a ‘/’, sockets with a ‘=’, symbolic links with
a ‘@’, executable files with ‘*’, and derived objects with a
‘$’. If the file is locked a ‘^’ is additionally appended.

-g (ls)
Print the group of the entry owner (...) .

-h Print histories instead of versions. All versions with the same
name are folded together to one printed entry. All version
binding options (see vbind(1)) are ignored, when displaying
histories.

-intent
Print message of intention for change. An intention message can
be set while retrieving a version using retrv with option
-lock.

-l (ls)
List in long format, giving mode, version state, author, size
in bytes, the save date, and version identification. For busy
versions the date field will contain the time of last
modification rather than the save date. The status of a version
is printed as: b for busy, s for saved, p for proposed, P for
published, a for accessed, f for frozen, and $ for derived.

-lll Same as -l -locked -locker.

-locked
Print only locked versions.

-locker
Print the locker instead of the author and last locking date
instead of last modification or save date.

-log Print the log entry for each version.

-L (ls)
Follow symbolic links. If a given name is a symbolic link, list
the object referenced by the link rather than the link itself.

-noexpand, -xpoff
Do not expand attribute values. This is the default, except
when the -format option is set. Check -expand or vattr(1) for
more information on attribute expansion.

-O Print the version owner instead of the author.

-p "all" | attribute name
Print the value of the given attribute. With the string ’all’
given as argument to the -p option, print all non standard
attributes.

-q (ls)
Replace all non graphic character by ’?’ before printing. This
is the default when output goes to a terminal.

-Q Quiet Flag. Suppress any output to standard output. Only error
messages will be printed to standard error.

-r (ls)
Reverse the order of the entries printed.

-R (ls)
Operate recursively visiting all subdirectories encountered.

-S Print version states verbosely.

-t (ls)
Sort the list of printed entries by the modification time.

-u (ls)
Sort the list of printed entries by time of last access.

-U Show user identifications as user@domain rather than just the
user name.

-v Print versions. This is the default (counterpart to

-version
Print only the version identification of this program.

-x (ls)
Do multi-column output with the entries sorted across rather
than down the page.

BUGS

       When  using  the  version  binding  options  -since and -before, the vl
       output may look confusing. -since and -before define  a  time  interval
       for save dates but vl displays the date of last modification, which may
       be older than the save date.

       ’.’ and ’..’ are always ignored when displaying versions.

       Several  Options  are  not  available  when  displaying  histories  (-h
       option).  These  are: -all, -attr, -c, -format, -intent, -locked, -log,
       -n, -p, -R, -t, and -u.

       The displayed group name (-g option) may be wrong for busy versions.

       -noexpand does not work together with -format.

       -q, and -F are not implemented.

AUTHOR