rlog man page on BSDOS

Man page or keyword search:  
man Server   6284 pages
apropos Keyword Search (all sections)
Output format
BSDOS logo
[printable version]



RLOG(1)							  RLOG(1)

NAME
       rlog  - print log messages and other information about RCS
       files

SYNOPSIS
       rlog [ options ] file ...

DESCRIPTION
       rlog prints information about RCS files.

       Pathnames matching an RCS suffix	 denote	 RCS  files;  all
       others	denote	 working  files.   Names  are  paired  as
       explained in ci(1).

       rlog prints the following information for each  RCS  file:
       RCS  pathname, working pathname, head (i.e., the number of
       the latest revision on the trunk), default branch,  access
       list, locks, symbolic names, suffix, total number of revi-
       sions, number of	 revisions  selected  for  printing,  and
       descriptive  text.   This  is  followed by entries for the
       selected revisions in reverse chronological order for each
       branch.	 For  each revision, rlog prints revision number,
       author, date/time, state, number	 of  lines  added/deleted
       (with  respect  to  the	previous revision), locker of the
       revision (if any), and log message.  All	 times	are  dis-
       played  in  Coordinated	Universal  Time (UTC) by default;
       this can be overridden with  -z.	  Without  options,  rlog
       prints  complete	 information.  The options below restrict
       this output.

       -L  Ignore RCS files that have no locks set.  This is con-
	   venient in combination with -h, -l, and -R.

       -R  Print  only	the name of the RCS file.  This is conve-
	   nient for translating a working pathname into  an  RCS
	   pathname.

       -h  Print  only	the RCS pathname, working pathname, head,
	   default branch, access list,	 locks,	 symbolic  names,
	   and suffix.

       -t  Print the same as -h, plus the descriptive text.

       -N  Do not print the symbolic names.

       -b  Print  information  about the revisions on the default
	   branch, normally the highest branch on the trunk.

       -ddates
	   Print  information  about  revisions	 with  a  checkin
	   date/time  in  the ranges given by the semicolon-sepa-
	   rated list of dates.	 A range of  the  form	d1<d2  or
	   d2>d1   selects  the	 revisions  that  were	deposited
	   between d1 and d2 exclusive.	 A range of the	 form  <d

GNU			     18:12:09				1

RLOG(1)							  RLOG(1)

	   or  d>  selects all revisions earlier than d.  A range
	   of the form d< or >d selects all revisions dated later
	   than	 d.   If  < or > is followed by = then the ranges
	   are inclusive, not exclusive.  A range of the  form	d
	   selects  the	 single,  latest revision dated d or ear-
	   lier.  The date/time strings d, d1, and d2 are in  the
	   free	 format	 explained in co(1).  Quoting is normally
	   necessary, especially for < and >.  Note that the sep-
	   arator is a semicolon.

       -l[lockers]
	   Print  information  about  locked  revisions only.  In
	   addition, if the comma-separated list lockers of login
	   names is given, ignore all locks other than those held
	   by the lockers.  For	 example,  rlog -L -R -lwft RCS/*
	   prints the name of RCS files locked by the user wft.

       -r[revisions]
	   prints information about revisions given in the comma-
	   separated list revisions of revisions and  ranges.	A
	   range  rev1:rev2  means  revisions rev1 to rev2 on the
	   same branch, :rev means revisions from  the	beginning
	   of  the branch up to and including rev, and rev: means
	   revisions starting with rev to the end of  the  branch
	   containing  rev.   An  argument that is a branch means
	   all revisions on that branch.   A  range  of	 branches
	   means  all revisions on the branches in that range.	A
	   branch followed by a . means the  latest  revision  in
	   that	 branch.   A  bare -r with no revisions means the
	   latest revision on the default  branch,  normally  the
	   trunk.

       -sstates
	   prints   information	  about	  revisions  whose  state
	   attributes match one of the states given in the comma-
	   separated list states.

       -w[logins]
	   prints information about revisions checked in by users
	   with login names appearing in the comma-separated list
	   logins.   If	 logins	 is  omitted, the user's login is
	   assumed.

       -T  This option has no effect; it is present for	 compati-
	   bility with other RCS commands.

       -V  Print RCS's version number.

       -Vn Emulate RCS version n when generating logs.	See co(1)
	   for more.

       -xsuffixes
	   Use suffixes to characterize RCS files.  See ci(1) for
	   details.

GNU			     18:12:09				2

RLOG(1)							  RLOG(1)

       rlog  prints  the  intersection	of the revisions selected
       with the options -d, -l, -s, and -w, intersected with  the
       union of the revisions selected by -b and -r.

       -zzone specifies the date output format, and specifies the
	      default time zone for date in the	 -ddates  option.
	      The  zone should be empty, a numeric UTC offset, or
	      the special string LT for local time.  The  default
	      is  an  empty  zone, which uses the traditional RCS
	      format of UTC without any time zone indication  and
	      with slashes separating the parts of the date; oth-
	      erwise, times are output in ISO  8601  format  with
	      time  zone  indication.  For example, if local time
	      is January 11, 1990,  8pm	 Pacific  Standard  Time,
	      eight hours west of UTC, then the time is output as
	      follows:

		     option    time output
		     -z	       1990/01/12 04:00:00	  (default)
		     -zLT      1990-01-11 20:00:00-08
		     -z+05:30  1990-01-12 09:30:00+05:30

EXAMPLES
	   rlog	 -L  -R	 RCS/*
	   rlog	 -L  -h	 RCS/*
	   rlog	 -L  -l	 RCS/*
	   rlog	 RCS/*

       The first command prints the names of all RCS files in the
       subdirectory  RCS  that	have  locks.   The second command
       prints the headers of those files, and  the  third  prints
       the headers plus the log messages of the locked revisions.
       The last command prints complete information.

ENVIRONMENT
       RCSINIT
	      options prepended to the argument	 list,	separated
	      by spaces.  See ci(1) for details.

DIAGNOSTICS
       The exit status is zero if and only if all operations were
       successful.

IDENTIFICATION
       Author: Walter F. Tichy.
       Manual Page Revision: 1995/12/06; Release Date:	18:12:09.
       Copyright (C) 1982, 1988, 1989 Walter F. Tichy.
       Copyright  (C)  1990,  1991,  1992,  1993, 1994, 1995 Paul
       Eggert.

SEE ALSO
       ci(1), co(1), ident(1), rcs(1),	rcsdiff(1),  rcsintro(1),
       rcsmerge(1), rcsfile(5)
       Walter  F.  Tichy,  RCS--A  System  for	Version	 Control,

GNU			     18:12:09				3

RLOG(1)							  RLOG(1)

       Software--Practice  &  Experience  15,  7   (July   1985),
       637-654.

BUGS
       The separator for revision ranges in the -r option used to
       be - instead of :, but this leads to confusion  when  sym-
       bolic  names  contain -.	 For backwards compatibility rlog
       -r still supports the old - separator, but it warns  about
       this obsolete use.

GNU			     18:12:09				4

[top]
                             _         _         _ 
                            | |       | |       | |     
                            | |       | |       | |     
                         __ | | __ __ | | __ __ | | __  
                         \ \| |/ / \ \| |/ / \ \| |/ /  
                          \ \ / /   \ \ / /   \ \ / /   
                           \   /     \   /     \   /    
                            \_/       \_/       \_/ 
More information is available in HTML format for server BSDOS

List of man pages available for BSDOS

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net