Name

svk annotate — Show author and revision information in-line for the specified files or URLs.

Synopsis

svk annotate TARGET[@REV[@]]...

Description

Show author and revision information in-line for the specified files or URLs. Each line of text is annotated at the beginning with the author (username) and the revision number for the last change to that line.

Alternate Names

ann, blame, praise

Changes

Nothing

Accesses Depot

Yes

Accesses Mirrored Repository

No

Switches

--revision (-r) REV[@]
--cross (-x)

Examples

If you want to see annotated source for readme.txt in your test depot:

$ svk ann //calc/integer.c
Annotations for /calc/integer.c (3 active revisions):
****************
     2  (   sally 2005-07-20):          /* integer.c */
    10  (   sally 2005-07-21):
    10  (   sally 2005-07-21):          #define ZERO  0
    10  (   sally 2005-07-21):          #define ONE   1

By default svk annotate will not look further back than the closest copy. If you wish to see the entire history of the file including who changed what before the copy use the --cross switch. In particular if you are running annotate on a branched or tagged revision of a file you might want to see it history back beyond the copy:

$ svk annotate //tags/calc-1.0/integer.c
Annotations for /tags/calc-1.0/integer.c (1 active revisions):
****************
    31  (   sally 2005-07-22):          /* integer.c */
    31  (   sally 2005-07-22):
    31  (   sally 2005-07-22):          #define ZERO  0
    31  (   sally 2005-07-22):          #define ONE   1
$ svk annotate --cross //tags/calc-1.0/integer.c
Annotations for /tags/calc-1.0/integer.c (4 active revisions):
****************
     2  (   sally 2005-07-20):          /* integer.c */
    10  (   sally 2005-07-21):
    10  (   sally 2005-07-21):          #define ZERO  0
    10  (   sally 2005-07-21):          #define ONE   1