# 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` 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` 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` 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 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` 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).