1 ;;; vc-hooks.el --- resident support for version-control
3 ;; Copyright (C) 1992 Free Software Foundation, Inc.
5 ;; Author: Eric S. Raymond <esr@snark.thyrsus.com>
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 2, or (at your option)
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
22 ;; the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.
26 ;; See the commentary of vc.el.
30 (defvar vc-master-templates
31 '(("%sRCS/%s,v" . RCS
) ("%s%s,v" . RCS
) ("%sRCS/%s" . RCS
)
32 ("%sSCCS/s.%s" . SCCS
) ("%ss.%s". SCCS
))
33 "*Where to look for version-control master files.
34 The first pair corresponding to a given back end is used as a template
35 when creating new masters.")
37 (defvar vc-make-backup-files nil
38 "*If non-nil, backups of registered files are made according to
39 the make-backup-files variable. Otherwise, prevents backups being made.")
41 ;; Tell Emacs about this new kind of minor mode
42 (if (not (assoc 'vc-mode minor-mode-alist
))
43 (setq minor-mode-alist
(cons '(vc-mode vc-mode
)
46 (make-variable-buffer-local 'vc-mode
)
48 ;; We need a notion of per-file properties because the version
49 ;; control state of a file is expensive to derive --- we don't
50 ;; want to recompute it even on every find.
52 (defmacro vc-error-occurred
(&rest body
)
53 (list 'condition-case nil
(cons 'progn
(append body
'(nil))) '(error t
)))
55 (defvar vc-file-prop-obarray
[0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0]
56 "Obarray for per-file properties.")
58 (defun vc-file-setprop (file property value
)
59 ;; set per-file property
60 (put (intern file vc-file-prop-obarray
) property value
))
62 (defun vc-file-getprop (file property
)
63 ;; get per-file property
64 (get (intern file vc-file-prop-obarray
) property
))
66 ;;; actual version-control code starts here
68 (defun vc-registered (file)
69 (let (handler handlers
)
70 (if (boundp 'file-name-handler-alist
)
72 (setq handlers file-name-handler-alist
)
73 (while (and (consp handlers
) (null handler
))
74 (if (and (consp (car handlers
))
75 (stringp (car (car handlers
)))
76 (string-match (car (car handlers
)) file
))
77 (setq handler
(cdr (car handlers
))))
78 (setq handlers
(cdr handlers
)))))
80 (funcall handler
'vc-registered file
)
81 ;; Search for a master corresponding to the given file
82 (let ((dirname (or (file-name-directory file
) ""))
83 (basename (file-name-nondirectory file
)))
87 (let ((trial (format (car s
) dirname basename
)))
88 (if (and (file-exists-p trial
)
89 ;; Make sure the file we found with name
90 ;; TRIAL is not the source file itself.
91 ;; That can happen with RCS-style names
92 ;; if the file name is truncated
93 ;; (e.g. to 14 chars). See if either
94 ;; directory or attributes differ.
95 (or (not (string= dirname
96 (file-name-directory trial
)))
98 (file-attributes file
)
99 (file-attributes trial
)))))
100 (throw 'found
(cons trial
(cdr s
)))))))
104 (defun vc-backend-deduce (file)
105 "Return the version-control type of a file, nil if it is not registered"
107 (or (vc-file-getprop file
'vc-backend
)
108 (vc-file-setprop file
'vc-backend
(cdr (vc-registered file
))))))
110 (defun vc-toggle-read-only ()
111 "If the file in the current buffer is under version control, perform the
112 logical next version-control action; otherwise, just toggle the buffer's
115 (if (vc-backend-deduce (buffer-file-name))
119 (defun vc-mode-line (file &optional label
)
120 "Set `vc-mode' to display type of version control for FILE.
121 The value is set in the current buffer, which should be the buffer
123 (interactive (list buffer-file-name nil
))
124 (let ((vc-type (vc-backend-deduce file
)))
127 (if (null (current-local-map))
128 (use-local-map (make-sparse-keymap)))
129 (define-key (current-local-map) "\C-x\C-q" 'vc-toggle-read-only
)
131 (concat " " (or label
(symbol-name vc-type
))))))
132 ;; force update of mode line
133 (set-buffer-modified-p (buffer-modified-p))
136 ;;; install a call to the above as a find-file hook
137 (defun vc-find-file-hook ()
138 ;; Recompute whether file is version controlled,
139 ;; if user has killed the buffer and revisited.
140 (vc-file-setprop buffer-file-name
'vc-backend nil
)
141 (if (and (vc-mode-line buffer-file-name
) (not vc-make-backup-files
))
143 (make-local-variable 'make-backup-files
)
144 (setq make-backup-files nil
))))
146 (or (memq 'vc-find-file-hook find-file-hooks
)
147 (setq find-file-hooks
148 (cons 'vc-find-file-hook find-file-hooks
)))
150 ;;; more hooks, this time for file-not-found
151 (defun vc-file-not-found-hook ()
152 "When file is not found, try to check it out from RCS or SCCS.
153 Returns t if checkout was successful, nil otherwise."
154 (if (vc-backend-deduce buffer-file-name
)
157 (not (vc-error-occurred (vc-checkout buffer-file-name
))))))
159 (or (memq 'vc-file-not-found-hook find-file-not-found-hooks
)
160 (setq find-file-not-found-hooks
161 (cons 'vc-file-not-found-hook find-file-not-found-hooks
)))
163 ;;; Now arrange for bindings and autoloading of the main package.
164 ;;; Bindings for this have to go in the global map, as we'll often
165 ;;; want to call them from random buffers.
167 (setq vc-prefix-map
(lookup-key global-map
"\C-xv"))
168 (if (not (keymapp vc-prefix-map
))
170 (setq vc-prefix-map
(make-sparse-keymap))
171 (define-key global-map
"\C-xv" vc-prefix-map
)
172 (define-key vc-prefix-map
"a" 'vc-update-change-log
)
173 (define-key vc-prefix-map
"c" 'vc-cancel-version
)
174 (define-key vc-prefix-map
"d" 'vc-directory
)
175 (define-key vc-prefix-map
"h" 'vc-insert-headers
)
176 (define-key vc-prefix-map
"i" 'vc-register
)
177 (define-key vc-prefix-map
"l" 'vc-print-log
)
178 (define-key vc-prefix-map
"r" 'vc-retrieve-snapshot
)
179 (define-key vc-prefix-map
"s" 'vc-create-snapshot
)
180 (define-key vc-prefix-map
"u" 'vc-revert-buffer
)
181 (define-key vc-prefix-map
"v" 'vc-next-action
)
182 (define-key vc-prefix-map
"=" 'vc-diff
)
187 ;;; vc-hooks.el ends here