home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 22 gnu / 22-gnu.zip / rcs57pc1.zip / doc / rlog.man < prev    next >
Text File  |  1996-02-13  |  8KB  |  265 lines
  1.  
  2.  
  3.  
  4. RLOG(1)                                                   RLOG(1)
  5.  
  6.  
  7. NAME
  8.        rlog  - print log messages and other information about RCS
  9.        files
  10.  
  11. SYNOPSIS
  12.        rlog [ options ] file ...
  13.  
  14. DESCRIPTION
  15.        rlog prints information about RCS files.
  16.  
  17.        Pathnames matching an RCS suffix  denote  RCS  files;  all
  18.        others   denote   working  files.   Names  are  paired  as
  19.        explained in ci(1).
  20.  
  21.        rlog prints the following information for each  RCS  file:
  22.        RCS  pathname, working pathname, head (i.e., the number of
  23.        the latest revision on the trunk), default branch,  access
  24.        list, locks, symbolic names, suffix, total number of revi-
  25.        sions, number of  revisions  selected  for  printing,  and
  26.        descriptive  text.   This  is  followed by entries for the
  27.        selected revisions in reverse chronological order for each
  28.        branch.   For  each revision, rlog prints revision number,
  29.        author, date/time, state, number  of  lines  added/deleted
  30.        (with  respect  to  the  previous revision), locker of the
  31.        revision (if any), and log message.  All  times  are  dis-
  32.        played  in  Coordinated  Universal  Time (UTC) by default;
  33.        this can be overridden with  -z.   Without  options,  rlog
  34.        prints  complete  information.  The options below restrict
  35.        this output.
  36.  
  37.        -L  Ignore RCS files that have no locks set.  This is con-
  38.            venient in combination with -h, -l, and -R.
  39.  
  40.        -R  Print  only  the name of the RCS file.  This is conve-
  41.            nient for translating a working pathname into  an  RCS
  42.            pathname.
  43.  
  44.        -h  Print  only  the RCS pathname, working pathname, head,
  45.            default branch, access list,  locks,  symbolic  names,
  46.            and suffix.
  47.  
  48.        -t  Print the same as -h, plus the descriptive text.
  49.  
  50.        -N  Do not print the symbolic names.
  51.  
  52.        -b  Print  information  about the revisions on the default
  53.            branch, normally the highest branch on the trunk.
  54.  
  55.        -ddates
  56.            Print  information  about  revisions  with  a  checkin
  57.            date/time  in  the  ranges  given  by  the  semicolon-
  58.            separated list of dates.  A range of the form d1<d2 or
  59.            d2>d1   selects  the  revisions  that  were  deposited
  60.            between d1 and d2 exclusive.  A range of the  form  <d
  61.  
  62.  
  63.  
  64. GNU                         1995/06/16                          1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. RLOG(1)                                                   RLOG(1)
  71.  
  72.  
  73.            or  d>  selects all revisions earlier than d.  A range
  74.            of the form d< or >d selects all revisions dated later
  75.            than  d.   If  < or > is followed by = then the ranges
  76.            are inclusive, not exclusive.  A range of the  form  d
  77.            selects  the  single,  latest revision dated d or ear-
  78.            lier.  The date/time strings d, d1, and d2 are in  the
  79.            free  format  explained in co(1).  Quoting is normally
  80.            necessary, especially for < and >.  Note that the sep-
  81.            arator is a semicolon.
  82.  
  83.        -l[lockers]
  84.            Print  information  about  locked  revisions only.  In
  85.            addition, if the comma-separated list lockers of login
  86.            names is given, ignore all locks other than those held
  87.            by the lockers.  For  example,  rlog -L -R -lwft RCS/*
  88.            prints the name of RCS files locked by the user wft.
  89.  
  90.        -r[revisions]
  91.            prints information about revisions given in the comma-
  92.            separated list revisions of revisions and  ranges.   A
  93.            range  rev1:rev2  means  revisions rev1 to rev2 on the
  94.            same branch, :rev means revisions from  the  beginning
  95.            of  the branch up to and including rev, and rev: means
  96.            revisions starting with rev to the end of  the  branch
  97.            containing  rev.   An  argument that is a branch means
  98.            all revisions on that branch.   A  range  of  branches
  99.            means  all revisions on the branches in that range.  A
  100.            branch followed by a . means the  latest  revision  in
  101.            that  branch.   A  bare -r with no revisions means the
  102.            latest revision on the default  branch,  normally  the
  103.            trunk.
  104.  
  105.        -sstates
  106.            prints   information   about   revisions  whose  state
  107.            attributes match one of the states given in the comma-
  108.            separated list states.
  109.  
  110.        -w[logins]
  111.            prints information about revisions checked in by users
  112.            with login names appearing in the comma-separated list
  113.            logins.   If  logins  is  omitted, the user's login is
  114.            assumed.
  115.  
  116.        -T  This option has no effect; it is present for  compati-
  117.            bility with other RCS commands.
  118.  
  119.        -V  Print RCS's version number.
  120.  
  121.        -Vn Emulate RCS version n when generating logs.  See co(1)
  122.            for more.
  123.  
  124.        -xsuffixes
  125.            Use suffixes to characterize RCS files.  See ci(1) for
  126.            details.
  127.  
  128.  
  129.  
  130. GNU                         1995/06/16                          2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. RLOG(1)                                                   RLOG(1)
  137.  
  138.  
  139.        rlog  prints  the  intersection  of the revisions selected
  140.        with the options -d, -l, -s, and -w, intersected with  the
  141.        union of the revisions selected by -b and -r.
  142.  
  143.        -zzone specifies the date output format, and specifies the
  144.               default time zone for date in the  -ddates  option.
  145.               The  zone should be empty, a numeric UTC offset, or
  146.               the special string LT for local time.  The  default
  147.               is  an  empty  zone, which uses the traditional RCS
  148.               format of UTC without any time zone indication  and
  149.               with slashes separating the parts of the date; oth-
  150.               erwise, times are output in ISO  8601  format  with
  151.               time  zone  indication.  For example, if local time
  152.               is January 11, 1990,  8pm  Pacific  Standard  Time,
  153.               eight hours west of UTC, then the time is output as
  154.               follows:
  155.  
  156.                      option    time output
  157.                      -z        1990/01/12 04:00:00        (default)
  158.                      -zLT      1990-01-11 20:00:00-08
  159.                      -z+05:30  1990-01-12 09:30:00+05:30
  160.  
  161. EXAMPLES
  162.            rlog  -L  -R  RCS/*
  163.            rlog  -L  -h  RCS/*
  164.            rlog  -L  -l  RCS/*
  165.            rlog  RCS/*
  166.  
  167.        The first command prints the names of all RCS files in the
  168.        subdirectory  RCS  that  have  locks.   The second command
  169.        prints the headers of those files, and  the  third  prints
  170.        the headers plus the log messages of the locked revisions.
  171.        The last command prints complete information.
  172.  
  173. ENVIRONMENT
  174.        RCSINIT
  175.               options prepended to the argument  list,  separated
  176.               by spaces.  See ci(1) for details.
  177.  
  178. DIAGNOSTICS
  179.        The exit status is zero if and only if all operations were
  180.        successful.
  181.  
  182. IDENTIFICATION
  183.        Author: Walter F. Tichy.
  184.        Manual Page Revision: 5.9; Release Date: 1995/06/16.
  185.        Copyright (C) 1982, 1988, 1989 Walter F. Tichy.
  186.        Copyright (C) 1990, 1991,  1992,  1993,  1994,  1995  Paul
  187.        Eggert.
  188.  
  189. SEE ALSO
  190.        ci(1),  co(1),  ident(1), rcs(1), rcsdiff(1), rcsintro(1),
  191.        rcsmerge(1), rcsfile(5)
  192.        Walter  F.  Tichy,  RCS--A  System  for  Version  Control,
  193.  
  194.  
  195.  
  196. GNU                         1995/06/16                          3
  197.  
  198.  
  199.  
  200.  
  201.  
  202. RLOG(1)                                                   RLOG(1)
  203.  
  204.  
  205.        Software--Practice   &   Experience  15,  7  (July  1985),
  206.        637-654.
  207.  
  208. BUGS
  209.        The separator for revision ranges in the -r option used to
  210.        be  -  instead of :, but this leads to confusion when sym-
  211.        bolic names contain -.  For backwards  compatibility  rlog
  212.        -r  still supports the old - separator, but it warns about
  213.        this obsolete use.
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262. GNU                         1995/06/16                          4
  263.  
  264.  
  265.