bk-comments - (unknown subject)
NAME
bk comments − change checkin comments
SYNOPSIS
bk comments [−p] [−Ccset]
[−rrev]
[file ... | −]
bk comments [−Ccset]
[−rrev] [−ycmt]
[−Yfile]
[file ... | −]
DESCRIPTION
The bk comments command changes the stored comments
for a revision controlled file. The comments may be
specified on the command line, or if they are not, you will
be placed in your editor to type in the comments.
If given − for a file argument, bk comments reads a list of files and comments to be edited from stdin. The format looks like this:
### Comments
for file.c|1.23
this is a sample comment
### Comments for file2.h|1.2.3.4
these are
other comments
OPTIONS
−rrev Change the comments for the specified
revision. The default is the most recent revision.
−ycomment Use comment as the new
comment for all files.
−Yfile Use the contents of file as
the new comment for all files.
−Crev Edit all the file comments on the
requested changeset at once. May not be combined with
−r.
−p Generate the list of all comments in the files
requested and write them to stdout. This file can be edited
and then later fed into bk comments − on stdin
to change the comments.
If no files to edit is given on the command line then −C+ is assumed and the comments for the files in the last changeset are edited.
BUGS
Nota bene: if the deltas being commented have been
committed to a changeset and have been pulled out of this
repository, the comment changes will not propagate on the
next bk pull. It is strongly suggested that you use
this only on uncommitted deltas which have not been pulled
or cloned. In the future, we will add a way of enforcing
this.
SEE ALSO
bk-log, bk-sccslog
CATEGORY
File