Comment.
[emacs.git] / lib-src / rcs-checkin
blob94396709e653b3a6a4927233dd3232c86cd763b8
1 #! /bin/sh
3 # This script accepts any number of file arguments and checks them into RCS.
5 # Copyright (C) 1993, 1994, 1995, 2001, 2002, 2003, 2004,
6 # 2005, 2006, 2007 Free Software Foundation, Inc.
8 # This file is part of GNU Emacs.
10 # GNU Emacs is free software; you can redistribute it and/or modify
11 # it under the terms of the GNU General Public License as published by
12 # the Free Software Foundation; either version 3, or (at your option)
13 # any later version.
15 # GNU Emacs is distributed in the hope that it will be useful,
16 # but WITHOUT ANY WARRANTY; without even the implied warranty of
17 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18 # GNU General Public License for more details.
20 # You should have received a copy of the GNU General Public License
21 # along with GNU Emacs; see the file COPYING. If not, write to the
22 # Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
23 # Boston, MA 02110-1301, USA.
25 # Arguments which are detectably either RCS masters (with names ending in ,v)
26 # or Emacs version files (with names of the form foo.~<number>~) are ignored.
27 # For each file foo, the script looks for Emacs version files related to it.
28 # These files are checked in as deltas, oldest first, so that the contents of
29 # the file itself becomes the latest revision in the master.
31 # The first line of each file is used as its description text. The file itself
32 # is not deleted, as under VC with vc-keep-workfiles at its default of t, but
33 # all the version files are.
35 # If an argument file is already version-controlled under RCS, any version
36 # files are added to the list of deltas and deleted, and then the workfile
37 # is checked in again as the latest version. This is probably not quite
38 # what was wanted, and is the main reason VC doesn't simply call this to
39 # do checkins.
41 # This script is intended to be used to convert files with an old-Emacs-style
42 # version history for use with VC (the Emacs 19 version-control interface),
43 # which likes to use RCS as its back end. It was written by Paul Eggert
44 # and revised/documented for use with VC by Eric S. Raymond, Mar 19 1993.
46 case $# in
48 echo "rcs-checkin: usage: rcs-checkin file ..."
49 echo "rcs-checkin: function: checks file.~*~ and file into a new RCS file"
50 echo "rcs-checkin: function: uses the file's first line for the description"
51 esac
53 # expr pattern to extract owner from ls -l output
54 ls_owner_pattern='[^ ][^ ]* *[^ ][^ ]* *\([^ ][^ ]*\)'
56 for file
58 # Make it easier to say `rcs-checkin *'
59 # by ignoring file names that already contain `~', or end in `,v'.
60 case $file in
61 *~* | *,v) continue
62 esac
63 # Ignore non-files too.
64 test -f "$file" || continue
66 # Check that file is readable.
67 test -r "$file" || exit
69 # If the RCS file does not already exist,
70 # initialize it with a description from $file's first line.
71 rlog -R "$file" >/dev/null 2>&1 ||
72 rcs -i -q -t-"`sed 1q $file`" "$file" || exit
74 # Get list of old files.
75 oldfiles=`
76 ls $file.~[0-9]*~ 2>/dev/null |
77 sort -t~ -n -k 2
80 # Check that they are properly sorted by date.
81 case $oldfiles in
82 ?*)
83 oldfiles_by_date=`ls -rt $file $oldfiles`
84 test " $oldfiles
85 $file" = " $oldfiles_by_date" || {
86 echo >&2 "rcs-checkin: skipping $file, because its mod times are out of order.
88 Sorted by mod time:
89 $oldfiles_by_date
91 Sorted by name:
92 $oldfiles
93 $file"
94 continue
96 esac
98 echo >&2 rcs-checkin: checking in: $oldfiles $file
100 # Save $file as $file.~-~ temporarily.
101 mv "$file" "$file.~-~" || exit
103 # Rename each old file to $file, and check it in.
104 for oldfile in $oldfiles
106 mv "$oldfile" "$file" || exit
107 ls_l=`ls -l "$file"` || exit
108 owner=-w`expr " $ls_l" : " $ls_owner_pattern"` || owner=
109 echo "Formerly ${oldfile}" | ci -d -l -q $owner "$file" || exit
110 done
112 # Bring $file back from $file.~-~, and check it in.
113 mv "$file.~-~" "$file" || exit
114 ls_l=`ls -l "$file"` || exit
115 owner=-w`expr " $ls_l" : " $ls_owner_pattern"` || owner=
116 ci -d -q -u $owner -m"entered into RCS" "$file" || exit
117 done
119 # arch-tag: 89c86949-ef04-4380-838b-bc1444dcb074