home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 January / usenetsourcesnewsgroupsinfomagicjanuary1994.iso / sources / unix / volume24 / rcs / part11 / rcs.ms.02
Encoding:
Text File  |  1991-03-05  |  6.9 KB  |  270 lines
  1. if that option is missing, it derives the number from the
  2. lock held by the user; if there is no lock and locking is not strict,
  3. \fIci\fR increments the number of the latest revision on the trunk.
  4. A side branch can only be started by explicitly specifying its
  5. number with the \fI\-r\fR option during check-in.
  6. .sp 1
  7. \fICi\fR also determines
  8. whether the revision to be checked in is different from the
  9. previous one, and asks whether to proceed if not.
  10. This facility simplifies check-in operations for large systems,
  11. because one need not remember which files were changed.
  12. .sp 1
  13. The option \fI\-k\fR searches the checked in file for identification
  14. markers containing
  15. the attributes
  16. revision number, check-in date, author and state, and assigns these
  17. to the new revision rather than computing them.  This option is
  18. useful for software distribution: Recipients of distributed software
  19. using RCS should check in updates with the \fI\-k\fR option.
  20. This convention guarantees that revision numbers, check-in dates,
  21. etc., are the same at all sites.
  22. .IP "\fIco\fP \fB\- check out revisions\fP"
  23. .sp 0
  24. \fICo\fR retrieves revisions according to revision number,
  25. date, author and state attributes.  It either places the revision
  26. into the working file, or prints it on the standard output.
  27. \fICo\fR always expands the identification markers.
  28. .IP "\fIident\fP \fB\- extract identification markers\fP"
  29. .sp 0
  30. \fIIdent\fR extracts the identification markers expanded by \fIco\fR
  31. from any file and prints them.
  32. .IP "\fIrcs\fP \fB\- change RCS file attributes\fP"
  33. .sp 0
  34. \fIRcs\fR is an administrative operation that changes access lists,
  35. locks, unlocks, breaks locks, toggles the strict-locking feature,
  36. sets state attributes and symbolic revision numbers, changes the
  37. description, and deletes revisions.  A revision can
  38. only be deleted if it is not the fork of a side branch.
  39. .IP "\fIrcsclean\fP \fB\- clean working directory\fP"
  40. .sp 0
  41. .ne 10
  42. \fIRcsclean\fR removes working files that were checked out but never changed.*
  43. .FS *
  44. The \fIrcsclean\fP and \fIrcsfreeze\fP commands
  45. are optional and are not always installed.
  46. .FE
  47. .IP "\fIrcsdiff\fP \fB\- compare revisions\fP"
  48. .sp 0
  49. \fIRcsdiff\fR compares two revisions and prints their
  50. difference, using the UNIX tool \fIdiff\fR.
  51. One of the revisions compared may be checked out.
  52. This command is useful for finding out about changes.
  53. .IP "\fIrcsfreeze\fP \fB\- freeze a configuration\fP"
  54. .sp 0
  55. \fIRcsfreeze\fR assigns the same symbolic revision number
  56. to a given revision in all RCS files.
  57. This command is useful for accurately recording a configuration.*
  58. .IP "\fIrcsmerge\fP \fB\- merge revisions\fP"
  59. .sp 0
  60. \fIRcsmerge\fR merges two revisions, \fIrev1\fR and \fIrev2\fR,
  61. with respect to a common ancestor.
  62. A 3-way file comparison determines the segments of lines that
  63. are (a) the same in all three revisions, or (b) the same in 2 revisions,
  64. or (c) different in all three.  For all segments of type (b) where
  65. \fIrev1\fR is the differing revision,
  66. the segment in \fIrev1\fR replaces the corresponding segment of \fIrev2\fR.
  67. Type (c) indicates an overlapping change, is flagged as an error, and requires user
  68. intervention to select the correct alternative.
  69. .IP "\fIrlog\fP \fB\- read log messages\fP"
  70. .sp 0
  71. \fIRlog\fR prints the log messages and other information in an RCS file.
  72. .bp
  73. .LP
  74. .nr VS 12p
  75. .vs 12p
  76. .]<
  77. .ds [F 1
  78. .]-
  79. .ds [K FELD02
  80. .ds [K MakeArticle
  81. .ds [A Feldman, Stuart I.
  82. .ds [D March 1979
  83. .ds [T Make\*-A Program for Maintaining Computer Programs
  84. .ds [J Software\*-Practice & Experience
  85. .ds [V 9
  86. .ds [N 3
  87. .ds [P 255-265
  88. .nr [P 1
  89. .nr [T 0
  90. .nr [A 1
  91. .nr [O 0
  92. .][ 1 journal-article
  93. .ds [F 2
  94. .]-
  95. .ds [K HUNT01
  96. .ds [T An Algorithm for Differential File Comparison
  97. .ds [A Hunt, James W.
  98. .as [A " and McIlroy, M. D.
  99. .ds [I Computing Science Technical Report, Bell Laboratories
  100. .ds [R 41
  101. .ds [D June 1976
  102. .nr [T 0
  103. .nr [A 1
  104. .nr [O 0
  105. .][ 4 tech-report
  106. .ds [F 3
  107. .]-
  108. .ds [K SCCS
  109. .ds [A Rochkind, Marc J.
  110. .ds [D Dec. 1975
  111. .ds [T The Source Code Control System
  112. .ds [J IEEE Transactions on Software Engineering
  113. .ds [V SE-1
  114. .ds [N 4
  115. .ds [P 364-370
  116. .nr [P 1
  117. .nr [T 0
  118. .nr [A 1
  119. .nr [O 0
  120. .][ 1 journal-article
  121. .ds [F 4
  122. .]-
  123. .ds [K TICH08
  124. .ds [T Design, Implementation, and Evaluation of a Revision Control System
  125. .ds [A Tichy, Walter F.
  126. .ds [B Proceedings of the 6th International Conference on Software Engineering
  127. .ds [I ACM, IEEE, IPS, NBS
  128. .ds [D September 1982
  129. .ds [P 58-67
  130. .nr [P 1
  131. .nr [T 0
  132. .nr [A 1
  133. .nr [O 0
  134. .][ 3 article-in-book
  135. .ds [F 5
  136. .]-
  137. .ds [K LEBL01
  138. .ds [A Leblang, David B.
  139. .as [A " and Chase, Robert P.
  140. .ds [T Computer-Aided Software Engineering in a Distributed Workstation Environment
  141. .ds [O Proceedings of the ACM SIGSOFT/SIGPLAN Software Engineering Symposium
  142. .as [O " on Practical Software Development Environments.
  143. .ds [J SIGPLAN Notices
  144. .ds [V 19
  145. .ds [N 5
  146. .ds [D May 1984
  147. .ds [P 104-112
  148. .nr [P 1
  149. .nr [T 0
  150. .nr [A 1
  151. .nr [O 0
  152. .][ 1 journal-article
  153. .ds [F 1
  154. .ds [F 3
  155. .ds [F 6
  156. .]-
  157. .ds [K SCCSEval
  158. .ds [A Glasser, Alan L.
  159. .ds [D Nov. 1978
  160. .ds [T The Evolution of a Source Code Control System
  161. .ds [J Software Engineering Notes
  162. .ds [V 3
  163. .ds [N 5
  164. .ds [P 122-125
  165. .nr [P 1
  166. .ds [O Proceedings of the Software Quality and Assurance Workshop.
  167. .nr [T 0
  168. .nr [A 1
  169. .nr [O 1
  170. .][ 1 journal-article
  171. .ds [F 5
  172. .ds [F 7
  173. .]-
  174. .ds [K IBMClearCaster
  175. .ds [A Brown, H.B.
  176. .ds [D 1970
  177. .ds [T The Clear/Caster System
  178. .ds [J Nato Conference on Software Engineering, Rome
  179. .nr [T 0
  180. .nr [A 1
  181. .nr [O 0
  182. .][ 1 journal-article
  183. .ds [F 3
  184. .ds [F 8
  185. .]-
  186. .ds [K HabermannSDC
  187. .ds [A Habermann, A. Nico
  188. .ds [D Jan. 1979
  189. .ds [T A Software Development Control System
  190. .ds [I Technical Report, Carnegie-Mellon University, Department of Computer Science
  191. .nr [T 0
  192. .nr [A 0
  193. .nr [O 0
  194. .][ 2 book
  195. .ds [F 9
  196. .]-
  197. .ds [K CMS
  198. .ds [A DEC
  199. .ds [T Code Management System
  200. .ds [I Digital Equipment Corporation
  201. .ds [O Document No.\ EA-23134-82
  202. .ds [D 1982
  203. .nr [T 0
  204. .nr [A 0
  205. .nr [O 0
  206. .][ 2 book
  207. .ds [F 10
  208. .]-
  209. .ds [K LAMP01
  210. .ds [A Lampson, Butler W.
  211. .as [A " and Schmidt, Eric E.
  212. .ds [T Practical Use of a Polymorphic Applicative Language
  213. .ds [B Proceedings of the 10th Symposium on Principles of Programming Languages
  214. .ds [I ACM
  215. .ds [P 237-255
  216. .nr [P 1
  217. .ds [D January 1983
  218. .nr [T 0
  219. .nr [A 1
  220. .nr [O 0
  221. .][ 3 article-in-book
  222. .ds [F 5
  223. .ds [F 11
  224. .]-
  225. .ds [K TICH07
  226. .ds [T A Data Model for Programming Support Environments and its Application
  227. .ds [A Tichy, Walter F.
  228. .ds [B Automated Tools for Information System Design and Development
  229. .ds [E Hans-Jochen Schneider and Anthony I. Wasserman
  230. .ds [C Amsterdam
  231. .ds [I North-Holland Publishing Company
  232. .ds [D 1982
  233. .nr [T 0
  234. .nr [A 1
  235. .nr [O 0
  236. .][ 3 article-in-book
  237. .ds [F 4
  238. .ds [F 2
  239. .ds [F 12
  240. .]-
  241. .ds [K HECK01
  242. .ds [T A Technique for Isolating Differences Between Files
  243. .ds [A Heckel, Paul
  244. .ds [J Communications of the ACM
  245. .ds [D April 1978
  246. .ds [V 21
  247. .ds [N 4
  248. .ds [P 264-268
  249. .nr [P 1
  250. .nr [T 0
  251. .nr [A 0
  252. .nr [O 0
  253. .][ 1 journal-article
  254. .ds [F 13
  255. .]-
  256. .ds [K TICH11
  257. .ds [T The String-to-String Correction Problem with Block Moves
  258. .ds [A Tichy, Walter F.
  259. .ds [D Nov. 1984
  260. .ds [J ACM Transactions on Computer Systems
  261. .ds [V 2
  262. .ds [N 4
  263. .ds [P 309-321
  264. .nr [P 1
  265. .nr [T 0
  266. .nr [A 1
  267. .nr [O 0
  268. .][ 1 journal-article
  269. .]>
  270.