home *** CD-ROM | disk | FTP | other *** search
/ NetNews Usenet Archive 1992 #27 / NN_1992_27.iso / spool / comp / unix / programm / 5369 < prev    next >
Encoding:
Text File  |  1992-11-19  |  2.5 KB  |  53 lines
  1. Newsgroups: comp.unix.programmer
  2. Path: sparky!uunet!nwnexus!Celestial.COM!bill
  3. From: bill@Celestial.COM (Bill Campbell)
  4. Subject: Re: RCS logfile usage
  5. Organization: Celestial Software, Mercer Island, WA
  6. Date: Thu, 19 Nov 1992 17:48:02 GMT
  7. Message-ID: <1992Nov19.174802.21915@Celestial.COM>
  8. References: <1992Nov17.150301.23707@geac.com>
  9. Lines: 42
  10.  
  11. In <1992Nov17.150301.23707@geac.com> adb@geac.com (Anthony DeBoer) writes:
  12.  
  13. :I'm currently in the process of setting up RCS, and after having tried
  14. :out various options and various test cases, I'm wondering about the
  15. :usefulness of the comments log feature versus just keying in change notes
  16. :in the source directly while editing.
  17.  
  18. :Direct keying lets you note the changes as you make them, while they're
  19. :fresh in your mind, as opposed to having to remember a summary of what
  20. :you did, to type in at checkin time.  Using the log feature, on the other
  21. :hand, seems to gain only that the rlog command will list the log
  22. :comments.  A third choice might be keeping the current change notes in a
  23. :separate file and doing "ci foo.c < foo.notes", but that requires editing
  24. :multiple files.
  25.  
  26. I use cvs on top of RCS and it gives me the opportunity to enter
  27. change notes in my favorite editor when I do a checkin.  I then
  28. read `cvs diff -u filename` into the editor session which shows
  29. me the differences and I document changes accordingly.  cvs also
  30. maintains a file automatically in the current directory (Changes)
  31. which has a history of all changes on files in the directory.  I
  32. include the Changes files in my source repository and check it in
  33. so I have a single reference file.
  34.  
  35. :Using either feature gives you the comment changes during an rcsdiff, so
  36. :there's no difference there, and you can always see who changed what and
  37. :when.  Using $Log$ in the source does NOT buy you any log integrity;
  38. :other than adding the most current comment at checkout time, it does not
  39. :verify that previous comments are already there or that they haven't been
  40. :altered or damaged during later editing at some point.
  41.  
  42. I wrote a script I call rcslog which runs the rlog command and
  43. cleans it up for inclusion under a $Log: $ line.  I use this to
  44. insert log documentation in files that either never had a log
  45. section or it may have been corrupted.
  46.  
  47. Bill
  48. -- 
  49. INTERNET:  bill@Celestial.COM   Bill Campbell; Celestial Software
  50. UUCP:   ...!thebes!camco!bill   6641 East Mercer Way
  51.              uunet!camco!bill   Mercer Island, WA 98040; (206) 947-5591
  52. SPEED COSTS MONEY -- HOW FAST DO YOU WANT TO GO?
  53.