rcs-checkin.1 2.5 KB

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