Abstract of INFO-MAC archived encoded Mac binary file
   'dev/cw/edit-comment-15-demo-cw.hqx'
  Uploaded 04/07/1995   44813 bytes

Date: Tue, 4 Apr 1995 02:00:14 -0700
From: jazmann@shell.portal.com (Larry Gerndt)
Subject: Edit Comment CW 1.5

Announcing Edit Comment for Code Warrior:
From: Larry Gerndt
email: jazmann@shell.portal.com

Do you use source control, such as Projector, SourceSafe, Source Manager,
or SourceServer? If so, do you use Code Warrior as your editor? If you
answered yes to both, you will definitely want this utility, so read on:

(An equivalent version of this program is available for Think environments)

What it does:
This add-on to the Think or Code Warrior environments adds an "Edit
Comment..." item to the Edit menu. When you choose it, it will present an
editing window which shows the revision comment of the front window's file
(and other source control information).  Of course, the file must be under
source control (Projector , SourceServer, or SourceSafe).  These programs
accomplish their source control by attaching a resource of type 'ckid' to
each file they control. The information in the 'ckid' resource includes the
current revision number and a comment about the changes in that revision.
This is what Edit Comment edits.  It extracts the comment text from the
'ckid' of the file you're currently editing and puts up an editing window
that shows the current revision and displays the comment text in an
editable field.

(This demo version doesn't save changes, but is otherwise fully functional)

Having Edit Comment makes it possible (and easy) to create your comments
about the changes you make to a file AS YOU'RE MAKING THEM, without
switching to another app.  And these comments go right into the 'ckid',
meaning the file is ready to check in, so you don't have to enter any
comment during checkin.  The result: accurate comments, no pre-check-in
diffing to recall what you did to the file, and no comment entering needed
at check in time.

Besides the main advantages above, another very useful thing about  Edit
Comment is just that you can see, at any time, which project a file lives
in, and what revision it is.  This is really helpful if you want to then
query the database to look at previous revisions.

And yet another advantage: Edit Comment can also change a "mod-read-only"
file back to "Read-Only" (something no one else let's you do).  How many
times have you made a file "mod read only" only to later change your mind
about changing the file...too late, from this point on, the source control
system will demand you either check it in or trash it (it won't write over
it).  Edit Comment to the rescue.  All you have to do is make it
"Read-Only" again, by choosing this in your host environment's Edit Menu
(courtesy of Edit Comment).