Glossary

Glossary
A
AccuRev® Server
The program that manages the AccuRev® repository and handles commands issued by AccuRev client programs. See also client program.
AccuWork
AccuRev’s optional and tightly-integrated change package and issue management package.
activate
The process of enabling a workflow in AccuRev so that the workflow can be used to automate issue processing and enforce compliance with your SCM policies. You activate a workflow by setting conditions that issues must meet in order to be subject to the workflow.
active
An element is said to be active in a workspace or stream if a new version of the element has been created there, and that version has not been either (1) promoted to the parent stream or (2) purged from the workspace or stream. See also default group, backed, passive. An issue record is said to be active in a workspace or stream if the head version of one or more of its change package entries is in the stream's default group.
add
The operation that places a file, located in a user's workspace tree, under version control.
ancestor
In the version graph of an element, version A is an ancestor of version B if there is a direct line of descent (possibly including merges) from A to B. See predecessor (or direct ancestor). 'A is an ancestor of B' is equivalent to 'B is a descendant of A'.
ancestry
The entire set of versions of an element. See also version graph.
atomic
An important characteristic of AccuRev transactions: the entire transaction (including all specified files) must be performed successfully; if not, the entire transaction is cancelled, as if it were never attempted.
B
backed
An element has '(backed)' status in a workspace or stream if it is not currently active there. This means that the workspace/stream inherits the version of the element that is currently in the workspace/stream's parent stream (also called the backing stream).
backing chain
The 'path' (sequence of streams) through the depot's stream hierarchy, leading from a particular workspace or stream up to the depot's root stream. See also stream path.
backing stream
(parent stream, basis stream) The stream that is just above a given workspace or stream in a depot's stream hierarchy. The given workspace/stream inherits versions from the backing stream.
base stream
See root stream.
basis stream
See backing stream.
basis time
A date-timestamp setting for a stream, affecting which versions the stream inherits from its parent stream: for each element, the version inherited is the one that was in the parent stream at the basis time. See also snapshot.
basis version
A particular ancestor of the version specified in a Patch, Revert, Diff, or Send to Issue command. The series of versions between the basis version and the specified version constitute the 'recent changes' to be patched into (or removed from) the target. Similarly, a change package entry consists of all the versions between a specified basis version and a specified head version.
C
change package
A set of entries, each in the form of a basis-version/head-version pair, recorded on the Changes tab of an issue record. The change package records the changes to one or more elements, made to implement the feature or bug fix described in that issue record. Each entry in the change package describes changes to one element: the changes between the basis version and the head version. See also patch.
change package dependency
A relationship between the change package of an issue record (A) and the change packages of one or more other issue records (B,C,D, ...), expressing the fact that promoting A would also cause some or all of the changes in B,C,D, ... to be promoted.
change section
In a text-file merge (or patch) operation, a location where the two contributors being merged differ from each other. The Merge tool highlights and counts the change sections. It also tracks the conflicting changes (conflicts) -- the subset of change sections in which both contributors differ from the closest common ancestor. Conflicts must be resolved by human intervention. See also difference section.
checkpoint
Stopping to save a version of an element, then proceeding to make additional changes to the element.
client program
An AccuRev UI through which users submit commands to be executed by the AccuRev Server (the CLI, GUI, and Web UI are all client programs).
closest common ancestor
(of two versions of an element) The most recent version that is an ancestor of two specified versions. Used in a merge operation to minimize the amount of work required to combine the contents of the two specified versions. See also merge, version graph.
concurrent development
(parallel development) The practice of having two or more users concurrently work on the same project -- modifying the same version-controlled elements. See also serial development.
configuration
A set of element versions -- one version of each element. Typically, the set of versions currently in a particular workspace or stream.
conflict
See conflicting change.
conflicting change
The situation in which both contributors to a merge operation differ from the closest common ancestor at the same text line (or set of lines). Also, the situation in which both contributors have pathnames that differ from the closest common ancestor, and from each other.
container file
The ordinary file, located in the file storage area of the AccuRev repository, that contains the permanent copy of a version created in a workspace with the keep command.
content change
A change to the contents of a file element, recorded in a new version created with the Keep command. For a symbolic-link element, a change to the target pathname is a content change. For an element-link element, a change to the target element is not considered a content change to the link. See also namespace change.
contributor
Either of two versions of an element, which are to be combined in a merge operation, producing a new version of the element. This can involve both content changes and names pace changes.
current change
See current difference.
current depot
CLI: the depot associated with the workspace that contains current working directory. GUI: the depot whose data appears in the currently visible tab. The current depot's name is displayed in the status bar at the bottom of the window.
current difference
The currently highlighted difference section (Diff tool) or change section (Merge tool).
current version
The version of an element that currently appears in a particular workspace or stream. (It's also possible that a given workspace/stream might not contain any version of a given element.) The current version can be directly active in the workspace/stream; if not, it is inherited from the parent stream. See also passive.
current workspace
The workspace whose data is displayed in the current tab; or the workspace from which the current tab was invoked.
D
dark matter
The term used to refer to element versions that are not associated with any issue. Also referred to as unaffiliated changes. See Unaffiliated Changes ("Dark Matter") on page 107.
deep overlap
An overlap that is not in the current workspace or stream, but in the parent stream or another stream higher up in the stream hierarchy.
deep underlap
An underlap that is not in the current workspace or stream, but in the parent stream or another stream higher up in the stream hierarchy.
default group
The set of elements that are currently active in a particular workspace or stream.
default query
An AccuWork query that you've designated to be executed automatically in certain situations: when you open a new Queries tab or Query Browser; when AccuRev prompts you to specify one or more issue records in a Send to Issue command; when you execute Promote and AccuRev/AccuWork integration is enabled.
defunct
A particular kind of change to an element in a workspace or stream: that the element is to be deleted. The element disappears from the workspace or stream. Somewhat counter-intuitively, it also becomes active in the workspace or stream, because defuncting is a change that can be promoted to the parent stream (or can be undone with a purge operation). A defunct operation is originally recorded as a new version of the element in some workspace. Promoting this version up the stream hierarchy causes the element to disappear from the higher-level streams.
dependency
See change package dependency.
depot
The portion of the AccuRev repository that stores the entire history of a particular directory tree. See also element, version.
depot-relative pathname
A pathname that begins with /./ (UNIX) or \.\ (Windows), indicating the path from the top-level directory of a depot to a particular element.
descendant
See ancestor.
diff
An operation that compares the contents of two versions of a text-file element.
difference section
In a text-file-comparison operation, a location where the two files (or two versions of the same file) differ from each other. The Diff tool highlights and counts the difference sections. See also change section.
direct ancestor
See predecessor.
directory
(folder) A file system object that can contain files and other directories. Each version of a directory records a change to its name and/or pathname location in the depot's directory hierarchy.
dynamic stream
A stream whose configuration changes over time, with new versions promoted from child workspaces and/or from other dynamic streams. It also inherits versions from its parent stream.
E
edit form
(AccuWork) A UI form for displaying and changing the field values of issue records.
EID
See element-ID.
element
A file or directory that is under AccuRev version control. See also version.
element link
An element that is a pointer to another element, which must be in the same depot. The target element can be a directory element, a file element, another element link, or a symbolic link.
element type
The kind of data stored in versions of a file element. Different versions of the same element can have different element types.
element-ID
The unique, immutable integer identifier by which AccuRev tracks the changes to a particular file element or directory element. An element's name or pathname can change, but its element-ID never changes.
exclusive file locking
An AccuRev feature that enforces serial development: when a file becomes active in one workspace, an exclusive file lock prevents the file from becoming active in sibling workspaces.
executable bits
(UNIX only) The data items in a file's access mode that control the ability of users to invoke the file as an executable program.
external
A file or directory located within a workspace but not yet placed under version control has '(external)' status.
F
File Browser
The GUI tab that shows the contents of a workspace or stream.
file storage area
The portion of a depot in which AccuRev maintains a permanent copy ('storage file') of each newly created file version. See also metadata.
filter
See search.
folder
A file system object that can contain files and other folders. Each version of a folder records a change to its name and/or pathname location in the depot's folder hierarchy. See also directory.
from version
One of the contributor versions in a merge operation. In a typical merge, it is the version in the parent stream that is to be combined with the version in the user's workspace.
G
gated stream
A stream that uses user-defined rules to control whether changes promoted into it can be promoted out of it. Gated streams cannot be created using the Web UI, but they are displayed in the StreamBrowser. See also staging stream.
gateway area
A directory with a depot's slice, but outside the depot's file storage area, where version container files are staged for offline archiving. The gateway area is also used to restore archived versions' storage files.
H
head version
The version of an element that, along with a basis version, specifies that element's entry in a change package. Equivalently, the head-version/basis-version pair specifies a patch to that element.
header section
(AccuWork) The section of a multiple-page edit form that always remains visible as you switch from page to page.
hidden stream
Any stream that has been Removed and which by default no longer appears in the StreamBrowser. Hidden streams can be viewed in a grayed-out state by checking the Include hidden streams checkbox.
History Browser
The GUI tab that displays the set of transactions that affect a particular data structure: depot, stream, file, etc.
I
immutable
The 'permanence' property of an AccuRev transaction: the transaction cannot be deleted or modified in any way.
indicator
See status indicator.
inherit
The facility by which versions in higher-level streams automatically propagate to lower-level streams. If an element is not currently active in a stream or workspace, the stream/workspace inherits the version of the element that appears in its parent stream.
invisible
Describes a data structure that has been deactivated (Remove command), and so does not appear in default GUI displays or CLI listings.
issue database
(AccuWork) A set of issue records, each of which implements a bug report, feature description, etc. Each depot can have its own issue database. Each issue database has its own schema.
issue record
(AccuWork) A data record, consisting of values of data fields, stored in an issue database.
K
keep
The operation (Keep command) that creates a new version of a file element in a workspace, permanently recording in the AccuRev repository a change to the contents of the file.
kept
Refers to a version that has been created with a keep operation.
L
lock (dynamic stream)
A control on the ability to perform promote and include/exclude operations involving the stream.
login
Establishing a particular user identity ('username') with the Login command. The username must have been created previously. AccuRev licenses specify a maximum number of currently-active usernames.
M
master repository
The primary data repository that logs all transaction activity processed by the AccuRev master server. All storage depots are created in the master repository, from which they can later be replicated.
master server
The instance of the AccuRev Server process that handles all transactions that change the status of elements in the master repository. Only the master server can write data to the repository. See replica server.
member
An element has '(member)' status in a workspace or stream if one of its versions is in the default group of that workspace or stream. An element with '(member)' status is said to be active in that workspace or stream; otherwise, it's passive.
merge
An operation that combines the contents of two versions (contributors) of the same element. To merge the contents of text files, AccuRev uses a '3-way merge' algorithm: it compares the two files line-by-line with a third file, the version that is the closest common ancestor of the other two. Merging of namespace changes also takes into account the closest common ancestor.
metadata
Information stored in the AccuRev repository other than the actual contents of file versions. Metadata is stored in the repository database; file contents are stored in the file storage area.
modified
A file element has '(modified)' status in a workspace if the file's contents have changed since the last time the user kept a new version of the file or updated the entire workspace.
N
namespace change
A change to the pathname of a file or directory element: either renaming the element in place or moving the element to a different location in the depot's directory hierarchy.
non-conflicting change
In a merge operation, a change that occurs in just one contributor (not both of them). Such a change can be merged automatically, without requiring a decision from the user.
O
overlap
Version X, in a workspace or stream, has '(overlap)' status if the parent stream's current version of the element contains changes that are not reflected in version X. (That is, the parent stream's version is not an ancestor of version X.) Such a version cannot be promoted to the parent stream; the user must create a new version with a merge operation, combining version X with the parent stream's version. The new, merged version can then be promoted. Similarly, an overlap can exist between the versions in two dynamic streams. See also deep overlap.
P
parallel development
(concurrent development) The practice of having two or more users concurrently work on the same project -- modifying the same version-controlled elements. See also serial development.
parent stream
See backing stream.
passive
An element that is not active in a workspace or stream is said to be passive in that workspace or stream. Passive versions can be overwritten by an update operation.
pass-through stream
When a version is nominally promoted to pass-through stream X, the version automatically 'passes through' X: it is actually promoted to X's parent stream.
patch
A set of versions of a text-file element -- typically, containing the 'recent changes' made in one workspace. Also, the merge-like operation that incorporates those changes into another version of the same element. See also merge, basis version, head version, change package, reverse patch.
pending
An element has '(pending)' status in a workspace if the version in the workspace has changes that have not yet been promoted to the parent stream. The set of pending elements includes both kept elements and modified elements.
predecessor
(direct ancestor) The real version from which a given version was derived. A version and its predecessor are not necessarily located in the same workspace stream. In the Version Browser, a version and its predecessor are connected by a black line. (Exception: a version created by the Revert command is connected to its predecessor by a dashed blue line.) In the version graph of an element, version A is an ancestor of version B if there is a direct line of descent (possibly including merges) from A to B.
private query
(AccuWork) A query that appears in the Query List pane only for the user who created it. See also public query.
promote
The operation (Promote command) that transitions a version from being active in one workspace or stream to being active in the parent stream (or some other stream). This operation creates a new virtual version in the parent stream; the virtual version provides an alias for the real version, which was originally created in some user's workspace. See also version.
public query
(AccuWork) A query that appears in the Query List pane for all users. See also private query.
purge
The operation (CLI: purge command; GUI: Revert to Backed command) that discards the changes made to an element in a given workspace or stream.
Q
query
A set of search criteria that selects records from an AccuWork issue database, based on the records' field values. Each AccuWork issue database can have one of its queries designated as the 'default query', to be invoked automatically in certain situations calling for the user to specify one or more issue records.
R
real version
A version of an element, created in some user's workspace, recording a change to the contents and/or pathname of the element. See also version, virtual version.
recent changes
A set of versions of a particular file element; representing the changes made to accomplish some task (or any set of related changes). The recent changes start with the current version (or another selected version), termed the head version; they extended backward to (but do not include) the corresponding basis version.
reclaim
An operation that deletes archived storage files from a depot's gateway area, to reduce the amount of disk storage required for the depot's slice.
reparent
The operation that changes the parent stream of a particular workspace or stream.
replica repository
A copy of part or all of the contents of the master repository that must be re-synchronized regularly to remain current. New transaction records are written to the master repository only, making resynchronization necessary.
replica server
The instance of the AccuRev Server process that is associated with a replica repository on the same machine. It can directly service client programs' repository-read requests, but forwards repository-write requests to the master server.
repository
The directory tree that stores all software configuration management data managed by AccuRev. This data is maintained by the AccuRev Server, responding to requests made through AccuRev client programs. Users never manipulate the repository directly.
repository database
The portion of the repository that stores data other than the contents of element versions. See also file storage area.
reverse patch
An operation that removes a selected set of changes from the current version of a text-file element. See also patch, change package.
revert
An operation that 'removes' a selected set of changes from a specified version, by creating a new version that does not contain the change.
root stream
(base stream) The top-level stream in a depot's stream hierarchy.
S
scan threshold
The time at which a workspace's most recent search for modified files was initiated. Such searches are performed by the Update command and by certain File Browser searches. See also update level.
schema
The set of specifications that define the structure of an issue database: data fields and their value types/ranges, edit-form layout, field validations.
SCM
Acronym for software configuration management.
search
An operation that determines all the elements in a workspace or stream that have a particular status.
serial development
The practice of ensuring that multiple users do not work concurrently on the same version-controlled file. See also parallel development.
server
See AccuRev® Server.
sibling
Two or more workspaces or streams that have the same parent stream. Pass-through streams 'don't count' -- that is, all workspaces that promote versions to the same stream are considered siblings, even if some of them are direct children of the stream, while others are children of an intervening pass-through stream.
site slice
The subdirectory tree within the AccuRev repository that stores repository-wide database files (as opposed to depot-specific database files). By default, the top-level directory of this subtree is named site_slice. See also repository database.
slice
The subdirectory tree that stores all the data for a particular depot, including the depot's file storage area. By default, the top-level directory of this subtree has the same name as the depot itself.
snapshot
An immutable (frozen, static) stream that captures the configuration of another stream at a particular time. A snapshot cannot be renamed or modified in any way.
stage
In a workflow, an object that represents a phase in a development or release process. For example, your development process might have New, Scheduled, WIP (work-in-progress), and Closed phases, among others.
staging stream
A child of a gated stream that AccuRev creates automatically when you create or reparent a workspace off the gated stream. Staging streams are used to hold changes promoted to the gated stream until the successful completion of any job defined by the trigger associated with the gated stream (like a build or test, for example). You cannot create staging streams explicitly. See also gated stream.
stale
An element has '(stale)' status in a workspace if it is not currently active in the workspace, but a new version of the element has entered the parent stream. An update operation will overwrite the stale version with the parent stream's new version.
static stream
An AccuRev snapshot. The term 'static stream' emphasizes the fact that snapshots are part of a depot's stream hierarchy. See also snapshot.
status
The state of an element, from a version-control perspective, in a particular workspace or stream.
status indicator
A keyword (usually enclosed in parentheses) that reports the AccuRev-level status of a particular element in a particular workspace or stream. Commonly, multiple status indicators apply to an element. See also status.
storage file
See container file.
stranded
An element has '(stranded)' status in a workspace or stream if it's currently active, but there is no pathname to the element. This occurs when the element's directory (or a higher-level directory) is removed from the workspace or stream by the Defunct command or an exclude rule.
stream
The AccuRev data structure that implements a configuration of the elements in a particular depot. The configuration of a dynamic stream changes over time; the configuration of a snapshot (static stream) never changes. Each workspace has its own private workspace stream. See also workspace, stream hierarchy.
stream hierarchy
The tree-structured collection of streams -- including snapshots and workspace streams -- for a particular depot.
stream lock
See lock (dynamic stream).
stream path
A sequence of streams that starts at the root stream and ends at the stream being referenced.
stream-ID
An integer that uniquely identifies a stream, snapshot, or workspace with its depot. Changing the name of a stream or workspace does not affect its stream-ID.
StreamBrowser
The GUI tab that provides both graphical and tabular view of a depot's stream hierarchy. It has commands for comparing streams, promoting versions between streams, and other stream-based operations.
symbolic link
(symbolic-link element) An element whose contents is a pathname. The pathname can point to AccuRev data (that is, a location inside a workspace) or non-AccuRev data.
T
target
The file or directory that an element link or symbolic link points to.
target transaction
The most recent transaction at the time of a workspace's most recent update. The Update command attempts to load versions created in transactions up to and including the target transaction.
time-based stream
A stream that has a 'basis time', affecting which versions it inherits from its parent stream. See also basis time, parent stream.
time-spec
A specification of a particular date/time combination, used in various contexts: creating snapshots, viewing portions of the history of an element, etc.
TimeSafe®
The aspect of AccuRev's architecture that guarantees the reproducibility of any previous configuration of a stream, a depot, or the entire repository.
to version
One of the contributor versions in a merge operation. In a typical merge, it's the version in a user's workspace that is to be combined with the version in the parent stream.
transaction
A record in the AccuRev repository database that indicates a particular change: promoting of a set of versions, changing the name of a stream, modification to an issue record, etc. Each transaction has an integer transaction number, which is unique within the depot.
transaction history
The set of transactions related to a particular depot, stream, element, or other AccuRev data structure that changes over time.
transaction level
The number of the most recently completed transaction for a particular depot. See also update level.
transaction-level integration
The AccuRev facility that records the transaction number of a promote operation in a user-specified AccuWork issue record. This facility is enabled on a depot-by-depot basis by a trigger.
transition
In a workflow, an object that links one stage in a workflow with another; it represents how an issue may move from one workflow stage to another.
trigger
The AccuRev facility that enables user-defined procedures (trigger scripts) to be performed automatically before or after certain operations take place.
trigger script
The executable program that implements a user-defined procedure, to be invoked when a trigger fires. Also called a trigger program.
twins
When two or more repository elements have the same pathname in a dynamic stream. Example: (1) an element is defuncted in a workspace, (2) the element is promoted to the backing stream, (3) another element is created at the same pathname in the same workspace or a sibling workspace, (4) the new element is promoted to the backing stream.
U
UI
See client program.
unaffiliated changes
The term used to refer to element versions that are not associated with any issue. Also referred to as dark matter. See Unaffiliated Changes ("Dark Matter") on page 107.
undefunct
The operation that undoes the effect of a previous defunct operation, restoring a previously removed element back to a workspace.
underlap
Similar to overlap: for both underlap and overlap, the version in the parent stream is not an ancestor of your version. With an underlap (but not an overlap), your version is an ancestor of the parent stream's version; that is, the parent-stream version already contains all the changes in your version. There can be deep underlaps in the stream hierarchy, just like overlaps.
update
The operation (Update command) that copies new versions of elements into a workspace from its parent stream.
update level
The most recent (highest-numbered) transaction whose changes have been incorporated into a workspace, through an update operation. See also scan threshold, transaction level.
user
A person who uses an AccuRev client program to access (read and/or change) the data in the AccuRev repository. Access is granted only to those who login with a 'username' that was previously registered in the AccuRev repository. See also login.
user/group filter
A subset of AccuRev users or groups, which is used to limit the data displayed in parts of the AccuRev GUI or Web UI.
V
validation
(AccuWork) A rule, specified on the Validations subtab of the Schema Editor, that controls a particular edit-form field. This can take various forms, including specifying a default value, making a field required, and modifying the list of choices in a multiple-choice listbox.
version
A particular revision of an element, reflecting a content change (files only) or a namespace change (files and directories). All versions are originally created in workspaces, and can subsequently be promoted to dynamic streams. The original (workspace) version is termed a 'real version'. Each promotion to a dynamic stream creates a 'virtual version', which serves as an alias for (pointer to) the original real version.
version control
The discipline of keeping track of the changes made over time to one or more files or directories.
version graph
The directed-graph data structure that shows the ancestry of an element. The nodes are all the versions of an element, and whose lines indicate how later versions were derived from earlier versions. The Version Browser displays the version graph of an element.
version specification
Identifies a particular version of one or more elements. It can be a version-ID; in many contexts, it can be a stream or workspace name/number, which indicates the version currently in that stream/workspace.
version-ID
The unique identifier for a version, consisting of two parts: (1) the name or number of the workspace or stream in which the version was created; (2) an integer. Examples: talon_dvt_mary/14, 245\19.
virtual version
In a dynamic stream, a version of an element, created by the Promote command, which serves as an alias for (reference to) a previously created real version. In a workspace stream, a version created by the Send to Workspace or Anchor command, referring to the real version that the command 'checked out'.
W
Workflow
AccuRev’s issue processing automation and SCM process and policy enforcement tool.
workflow
A model of an organization’s software development and release processes that consists of individual stages and the transitions that link them.
workspace
A location in which one or more users perform their work, using files under version control. Each workspace consists of a workspace stream (in the repository) and a workspace tree (in the user's disk storage). See also workspace stream, workspace tree.
workspace name
The name by which users refer to a workspace. A workspace name always ends with _<user_name>, indicating the user who owns it. The default workspace naming convention, used by the New Workspace command, is <backing_stream_name>_<user_name>.
workspace stream
The private stream that is part of a workspace. All new versions of elements are originally created in workspaces; AccuRev records element versions in workspace streams when the element is added to the depot, kept, or promoted.
workspace tree
The ordinary directory tree, located in the user's disk storage, in which the user performs development tasks and executes AccuRev commands on files and directories under version control.
 

Micro Focus