home *** CD-ROM | disk | FTP | other *** search
- Path: sparky!uunet!usc!zaphod.mps.ohio-state.edu!magnus.acs.ohio-state.edu!usenet.ins.cwru.edu!agate!doc.ic.ac.uk!uknet!edcastle!dcs.ed.ac.uk!epcc.ed.ac.uk!cmb
- From: cmb@epcc.ed.ac.uk (C.M.Brough)
- Newsgroups: comp.unix.programmer
- Subject: Re: RCS logfile usage
- Message-ID: <BxwrHK.FKn@dcs.ed.ac.uk>
- Date: 18 Nov 92 10:51:19 GMT
- References: <1992Nov17.150301.23707@geac.com>
- Sender: cnews@dcs.ed.ac.uk (UseNet News Admin)
- Followup-To: comp.unix.programmer
- Organization: Edinburgh Parallel Computing Centre
- Lines: 41
-
- In article <1992Nov17.150301.23707@geac.com>, adb@geac.com (Anthony DeBoer) writes:
- > Direct keying lets you note the changes as you make them, while they're
- > fresh in your mind, as opposed to having to remember a summary of what
- > you did, to type in at checkin time. Using the log feature, on the other
- > hand, seems to gain only that the rlog command will list the log
- > comments. A third choice might be keeping the current change notes in a
- > separate file and doing "ci foo.c < foo.notes", but that requires editing
- > multiple files.
-
- Use the 'rcsdiff' program to remind you of the differences that you
- made when you are checking in the changes. I find this particularly
- helpful as I can summarise all the changes I have made - say to a long
- document, lots of changes all over the place, but all minor
- re-arrangements as part of a review process, then I can have a single
- ``adjustments for review'' in the log, which is much more useful than
- bit-by-bit comments on each change. X, with 'ci' in one window and
- 'rcsdiff' in another, makes this simple...!
-
- > Using either feature gives you the comment changes during an rcsdiff, so
- > there's no difference there, and you can always see who changed what and
- > when. Using $Log$ in the source does NOT buy you any log integrity;
- > other than adding the most current comment at checkout time, it does not
- > verify that previous comments are already there or that they haven't been
- > altered or damaged during later editing at some point.
-
- No, you don't gain any integrity. However, when you are sharing files
- between multiple users having the log present in the file means that
- you don't have to do a separate 'rlog' to find out what your colleague
- did last. The size of logs can get out of hand, however, and totally
- dominate the size of the file, so for small frequently edited files I
- tend not to use $Log$, only $Id$, and explicitly look at the log using
- rlog only when I need to.
-
- > What do other RCS users do, and why? I'd be interested in hearing your
- > comments. Thanks in advance.
-
- Hope the above has been of interest. I too would be interested in how
- other people do it.
-
- __________________________________________________________________________
- Colin Brough cmb@epcc.ed.ac.uk Edinburgh Parallel Computing Centre
-