HCoop / bpt / emacs.git / blame
| Commit | Line | Data |
|---|---|---|
| 967b69cd GM |
1 | .\" See section COPYING for copyright and redistribution information. |
| 2 | .TH rcs-checkin 1 | |
| 3 | .SH NAME | |
| 4 | rcs-checkin \- check files into RCS | |
| 5 | .SH SYNOPSIS | |
| 6 | .B rcs-checkin | |
| 7 | .RI [ FILE .\|.\|.] | |
| 8 | .SH DESCRIPTION | |
| 9 | .B rcs-checkin | |
| 10 | is a helper script for checking files into RCS. This program is | |
| 11 | distributed with | |
| 12 | .BR "GNU Emacs" . | |
| 13 | ||
| 14 | This program converts files with an old | |
| 15 | .BR Emacs -style | |
| 16 | version history for use with the | |
| 17 | .B "Emacs 19" | |
| 18 | version control interface | |
| 19 | .BR VC , | |
| 20 | which likes to use RCS as its back end. | |
| 21 | ||
| 22 | For each file to be processed, the script looks for | |
| 23 | .B Emacs | |
| 24 | version files related to it. These files are checked in as deltas, | |
| 25 | oldest first, so that the contents of the file itself becomes the | |
| 26 | latest revision in the master. | |
| 27 | ||
| 28 | The first line of each file is used as its description. The file | |
| 29 | itself is not deleted, as under | |
| 30 | .B VC | |
| 31 | with | |
| 32 | .B vc-keep-workfiles | |
| 33 | at its default of | |
| 34 | .BR t , | |
| 35 | but all the version files are. | |
| 36 | ||
| 37 | If an argument file is already version-controlled under RCS, any | |
| 38 | version files are added to the list of deltas and deleted, and then | |
| 39 | the workfile is checked in again as the latest version. This is | |
| 40 | probably not quite what was wanted, and is the main reason VC doesn't | |
| 41 | simply call this to do checkins. | |
| 42 | ||
| 43 | In order to make it easier to use | |
| 44 | .BR "rcs-checkin *" , | |
| 45 | files which are detectably either RCS masters (with names ending in | |
| 46 | .BR ,v ) | |
| 47 | or Emacs version files (with names containing | |
| 48 | .BR ~ ) | |
| 49 | are ignored. | |
| 50 | . | |
| 51 | .PP | |
| 52 | .SH OPTIONS | |
| 53 | The program accepts no options. | |
| 54 | . | |
| a3a81e9e GM |
55 | .SH SEE ALSO |
| 56 | The Emacs version control interface is documented in the GNU Emacs manual, | |
| 57 | which you can read using | |
| 58 | .BR Info , | |
| 59 | either from Emacs or as a standalone program. | |
| 60 | . | |
| 967b69cd GM |
61 | .SH AUTHORS |
| 62 | .I rcs-checkin | |
| 63 | was originally written by Paul Eggert. It was revised for use with | |
| 64 | .B "GNU Emacs" | |
| 65 | .B VC | |
| 66 | by Eric S. Raymond. | |
| 67 | . | |
| 68 | .SH COPYING | |
| 69 | Copyright | |
| 70 | .if t \(co | |
| 71 | .if n (C) | |
| 7497ef13 | 72 | 2008-2012 Free Software Foundation, Inc. |
| 967b69cd GM |
73 | .PP |
| 74 | Permission is granted to make and distribute verbatim copies of this | |
| 75 | document provided the copyright notice and this permission notice are | |
| 76 | preserved on all copies. | |
| 77 | .PP | |
| 78 | Permission is granted to copy and distribute modified versions of | |
| 79 | this document under the conditions for verbatim copying, provided that | |
| 80 | the entire resulting derived work is distributed under the terms of | |
| 81 | a permission notice identical to this one. | |
| 82 | .PP | |
| 83 | Permission is granted to copy and distribute translations of this | |
| 84 | document into another language, under the above conditions for | |
| 85 | modified versions, except that this permission notice may be stated | |
| 86 | in a translation approved by the Free Software Foundation. | |
| 87 | . |