| Extracted from Pike v7.8 release 700 at 2013-06-08.

[Top]
Parser
Parser.RCS
Parser.RCS()->Revision

# Class Parser.RCS()->Revision

Description

  All data tied to a particular revision of the file.

Variable revision

  `string Parser.RCS.Revision.revision`

Description

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

Variable author

  `string Parser.RCS.Revision.author`

Description

  The userid of the user that committed the revision.

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 state

  `string Parser.RCS.Revision.state`

Description

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

Variable time

  `Calendar.TimeRange Parser.RCS.Revision.time`

Description

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

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 rcs_next

  `string 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 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 ancestor

  `string 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 next

  `string 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 log

  `string Parser.RCS.Revision.log`

Description

  The log message associated with the revision.

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 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 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 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 text

  `string 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