RADE

Source Code Manager

adl_ls_ws_rev

Listing workspace's revisions

Quick Reference

Abstract

The adl_ls_ws_rev command displays a list of the workspace's revisions in one or more tree(s).

Synopsis
Usage
Options
Examples
References

Synopsis

adl_ls_ws_rev [workspace_name] [-tree ws_tree_name...] [-from rev1_or_date1] [-to rev2_or_date2] [-at date] [-program [-sep | -separator char]] [-out file_path] [-h | -help | -?]

Usage

Workspace's revisions are displayed in a table format to explain the different revisions and their causes. The name of the current workspace ([1] adl_ch_ws command) is either the current workspace or the given workspace.
By default, the command displays the list of the revisions belonging to the same tree as the current workspace. If this workspace is multi-tree, all the revisions in all the trees are displayed.

You can limit the display to some of the trees, giving their names.

You can display the revisions of the workspace for only a given time period, giving a beginning date and an end date. The given date must follow the following format: YYYY/MM/DD-hh:mm:ss

YYYY is the year
MM is the month
DD is the day
hh is the hour
mm is the minute
ss is the second

You can also display the revisions of the workspace at a given date.

The "-program" option displays information in a specific output mode. For more details, see the article explaining this option.

[Top]

Options

adl_ls_ws_rev accepts the following options:

`-h\|-help\|-?`	Help of the command
`workspace_name`	Name of the workspace whose workspace's tree is displayed
`-tree tree_name`	List revisions only in these workspace trees
`-from rev1_or_date1`	Revision number origin of the list choosen in function of the given revision or the given date
`-to rev2_or_date2`	Revision number ending of the list choosen in function of the given revision or the given date
-at date	Search the current revision at this date
`-program`	Display in XML format
-sep char	Separator between each field for programs (space " " by default)
-separator char	Separator between each field for programs (space " " by default)
`-out file_name`	Path to a file "file_name" for writing the results

Examples

Display all the revisions of the current workspace:

adl_ls_ws_rev

Display all the revisions of the workspace "my_ws":

adl_ls_ws_rev my_ws

Display all the revisions of the current workspace at a given date "Year=YYYY Month=MM Day=DD":

adl_ls_ws_rev -at YYYY/MM/DD

Display all the revisions of the current workspace belonging to the trees "tree1" and "tree2":

adl_ls_ws_rev -tree tree1 tree2

Display all the revisions of the current workspace being between revision number rev1 and revision number rev2, in all the trees where current workspace exists:

adl_ls_ws_rev -from rev1 -to rev2

Display all the revisions of the current workspace being between revision at the given date date1 and revision at the given date date2:

adl_ls_ws_rev -from ws1 -tree tree1

Display all the revisions of the current workspace and result sent to the file "my_file":

adl_ls_ws_rev -out my_file

Example of result:

adl_ls_ws_rev Workspace tree TOOLSSDF: Revision Creation reason First command User Creation date ---------------------------------------------------------------------------- 1 Modification adl_mk_ws user_name Tuesday, March 20, 2001 08:27:48 AM 2 Modification adl_attach user_name Tuesday, March 20, 2001 09:30:01 AM 3 Synchronization adl_sync user_name Thursday, March 22, 2001 03:08:00 PM 4 Modification adl_co user_name Thursday, March 22, 2001 04:00:25 PM 5 Modification adl_mk_elem user_name Friday, March 23, 2001 09:50:02 AM 6 Synchronization adl_sync user_name Monday, March 26, 2001 09:23:12 AM 7 Modification adl_co user_name Monday, March 26, 2001 01:56:07 PM 8 Synchronization adl_sync user_name Tuesday, March 27, 2001 07:52:05 AM 9 Modification adl_co user_name Thursday, March 29, 2001 03:54:28 PM 10 Synchronization adl_sync user_name Monday, April 09, 2001 08:49:17 AM 11 Modification adl_co user_name Monday, April 09, 2001 09:45:19 AM 12 Synchronization adl_sync user_name Monday, April 09, 2001 05:31:04 PM 13 Modification adl_co user_name Monday, April 09, 2001 05:31:20 PM 14 Synchronization adl_sync user_name Tuesday, April 24, 2001 05:40:55 PM

[Top]

References

[1]
[2]

adl_ch_ws: Changing workspace
adl_ds_ws: Displaying workspace status

[Top]

History

Version: 2 [Nov 2001]	Document update
Version: 1 [Apr 2001]	Document creation

[Top]