Class Parser.RCS()->Revision

Description

All data tied to a particular revision of the file.

Variable added

int Parser.RCS.Revision.added

Description

The number of lines that were added from the previous revision to make this revision (for the initial revision too).

See also

lines, removed

Variable ancestor

string|zero Parser.RCS.Revision.ancestor

Description

The revision of the ancestor of this revision, or 0 if this was the initial revision.

See also

next

Variable author

string Parser.RCS.Revision.author

Description

The userid of the user that committed the revision.

Variable branch

string Parser.RCS.Revision.branch

Description

The branch name on which this revision was committed (calculated according to how cvs manages branches).

Variable branches

array(string) Parser.RCS.Revision.branches

Description

When there are branches from this revision, an array with the first revision number for each of the branches, otherwise 0.

Follow the next fields to get to the branch head.

Variable lines

int Parser.RCS.Revision.lines

Description

The number of lines this revision contained, altogether (not of particular interest for binary files).

See also

added, removed

Variable log

string Parser.RCS.Revision.log

Description

The log message associated with the revision.

Variable next

string|zero Parser.RCS.Revision.next

Description

The revision that succeeds this revision, or 0 if none exists (ie if this is the HEAD of the trunk or of a branch).

See also

ancestor

Variable rcs_next

string|zero Parser.RCS.Revision.rcs_next

Description

The revision stored next in the RCS file, or 0 if none exists.

Note

This field is straight from the RCS file, and has somewhat weird semantics. Usually you will want to use one of the derived fields next or prev or possibly rcs_prev.

See also

next, prev, rcs_prev

Variable rcs_prev

string|zero Parser.RCS.Revision.rcs_prev

Description

The revision that this revision is based on, or 0 if it is the HEAD.

This is the reverse pointer of rcs_next and branches, and is used by get_contents_for_revision() when applying the deltas to set text.

See also

rcs_next

Variable rcs_text

string Parser.RCS.Revision.rcs_text

Description

The raw delta as stored in the RCS file.

See also

text, get_contents_for_revision()

Variable removed

int Parser.RCS.Revision.removed

Description

The number of lines that were removed from the previous revision to make this revision.

See also

lines, added

Variable revision

string Parser.RCS.Revision.revision

Description

The revision number (i e rcs_file->revisions["1.1"]->revision == "1.1").

Variable state

string Parser.RCS.Revision.state

Description

The state of the revision - typically "Exp" or "dead".

Variable text

string|zero Parser.RCS.Revision.text

Description

The text as committed or 0 if get_contents_for_revision() hasn't been called for this revision yet.

Typically you don't access this field directly, but use get_contents_for_revision() to retrieve it.

See also

get_contents_for_revision(), rcs_text

Variable time

Calendar.TimeRange Parser.RCS.Revision.time

Description

The (UTC) date and time when the revision was committed (second precision).