doc/man/rcs-checkin.1

   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 .
  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 .
  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)
  72 2008-2012 Free Software Foundation, Inc.
  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 .