mirror of
https://git.savannah.gnu.org/git/emacs.git
synced 2024-11-27 07:37:33 +00:00
45fc7cc3c5
version-controlled symbolic link from the former to the latter.
890 lines
34 KiB
EmacsLisp
890 lines
34 KiB
EmacsLisp
;;; vc-hooks.el --- resident support for version-control
|
|
|
|
;; Copyright (C) 1992, 1993, 1994, 1995 Free Software Foundation, Inc.
|
|
|
|
;; Author: Eric S. Raymond <esr@snark.thyrsus.com>
|
|
;; Modified by:
|
|
;; Per Cederqvist <ceder@lysator.liu.se>
|
|
;; Andre Spiegel <spiegel@berlin.informatik.uni-stuttgart.de>
|
|
|
|
;; This file is part of GNU Emacs.
|
|
|
|
;; GNU Emacs is free software; you can redistribute it and/or modify
|
|
;; it under the terms of the GNU General Public License as published by
|
|
;; the Free Software Foundation; either version 2, or (at your option)
|
|
;; any later version.
|
|
|
|
;; GNU Emacs is distributed in the hope that it will be useful,
|
|
;; but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
;; GNU General Public License for more details.
|
|
|
|
;; You should have received a copy of the GNU General Public License
|
|
;; along with GNU Emacs; see the file COPYING. If not, write to
|
|
;; the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.
|
|
|
|
;;; Commentary:
|
|
|
|
;; This is the always-loaded portion of VC.
|
|
;; It takes care VC-related activities that are done when you visit a file,
|
|
;; so that vc.el itself is loaded only when you use a VC command.
|
|
;; See the commentary of vc.el.
|
|
|
|
;;; Code:
|
|
|
|
;; Customization Variables (the rest is in vc.el)
|
|
|
|
(defvar vc-default-back-end nil
|
|
"*Back-end actually used by this interface; may be SCCS or RCS.
|
|
The value is only computed when needed to avoid an expensive search.")
|
|
|
|
(defvar vc-handle-cvs t
|
|
"*If non-nil, use VC for files managed with CVS.
|
|
If it is nil, don't use VC for those files.")
|
|
|
|
(defvar vc-path
|
|
(if (file-directory-p "/usr/sccs")
|
|
'("/usr/sccs")
|
|
nil)
|
|
"*List of extra directories to search for version control commands.")
|
|
|
|
(defvar vc-master-templates
|
|
'(("%sRCS/%s,v" . RCS) ("%s%s,v" . RCS) ("%sRCS/%s" . RCS)
|
|
("%sSCCS/s.%s" . SCCS) ("%ss.%s". SCCS)
|
|
vc-find-cvs-master)
|
|
"*Where to look for version-control master files.
|
|
The first pair corresponding to a given back end is used as a template
|
|
when creating new masters.")
|
|
|
|
(defvar vc-make-backup-files nil
|
|
"*If non-nil, backups of registered files are made as with other files.
|
|
If nil (the default), files covered by version control don't get backups.")
|
|
|
|
(defvar vc-display-status t
|
|
"*If non-nil, display revision number and lock status in modeline.
|
|
Otherwise, not displayed.")
|
|
|
|
(defvar vc-consult-headers t
|
|
"*Identify work files by searching for version headers.")
|
|
|
|
(defvar vc-mistrust-permissions nil
|
|
"*Don't assume that permissions and ownership track version-control status.")
|
|
|
|
(defvar vc-keep-workfiles t
|
|
"*If non-nil, don't delete working files after registering changes.
|
|
If the back-end is CVS, workfiles are always kept, regardless of the
|
|
value of this flag.")
|
|
|
|
;; Tell Emacs about this new kind of minor mode
|
|
(if (not (assoc 'vc-mode minor-mode-alist))
|
|
(setq minor-mode-alist (cons '(vc-mode vc-mode)
|
|
minor-mode-alist)))
|
|
|
|
(make-variable-buffer-local 'vc-mode)
|
|
(put 'vc-mode 'permanent-local t)
|
|
|
|
;; We need a notion of per-file properties because the version
|
|
;; control state of a file is expensive to derive --- we compute
|
|
;; them when the file is initially found, keep them up to date
|
|
;; during any subsequent VC operations, and forget them when
|
|
;; the buffer is killed.
|
|
|
|
(defmacro vc-error-occurred (&rest body)
|
|
(list 'condition-case nil (cons 'progn (append body '(nil))) '(error t)))
|
|
|
|
(defvar vc-file-prop-obarray [0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0]
|
|
"Obarray for per-file properties.")
|
|
|
|
(defvar vc-buffer-backend t)
|
|
(make-variable-buffer-local 'vc-buffer-backend)
|
|
|
|
(defun vc-file-setprop (file property value)
|
|
;; set per-file property
|
|
(put (intern file vc-file-prop-obarray) property value))
|
|
|
|
(defun vc-file-getprop (file property)
|
|
;; get per-file property
|
|
(get (intern file vc-file-prop-obarray) property))
|
|
|
|
(defun vc-file-clearprops (file)
|
|
;; clear all properties of a given file
|
|
(setplist (intern file vc-file-prop-obarray) nil))
|
|
|
|
;;; Functions that determine property values, by examining the
|
|
;;; working file, the master file, or log program output
|
|
|
|
(defun vc-match-substring (bn)
|
|
(buffer-substring (match-beginning bn) (match-end bn)))
|
|
|
|
(defun vc-lock-file (file)
|
|
;; Generate lock file name corresponding to FILE
|
|
(let ((master (vc-name file)))
|
|
(and
|
|
master
|
|
(string-match "\\(.*/\\)s\\.\\(.*\\)" master)
|
|
(concat
|
|
(substring master (match-beginning 1) (match-end 1))
|
|
"p."
|
|
(substring master (match-beginning 2) (match-end 2))))))
|
|
|
|
(defun vc-parse-buffer (patterns &optional file properties)
|
|
;; Use PATTERNS to parse information out of the current buffer.
|
|
;; Each element of PATTERNS is a list of 2 to 3 elements. The first element
|
|
;; is the pattern to be matched, and the second (an integer) is the
|
|
;; number of the subexpression that should be returned. If there's
|
|
;; a third element (also the number of a subexpression), that
|
|
;; subexpression is assumed to be a date field and we want the most
|
|
;; recent entry matching the template.
|
|
;; If FILE and PROPERTIES are given, the latter must be a list of
|
|
;; properties of the same length as PATTERNS; each property is assigned
|
|
;; the corresponding value.
|
|
(mapcar (function (lambda (p)
|
|
(goto-char (point-min))
|
|
(cond
|
|
((eq (length p) 2) ;; search for first entry
|
|
(let ((value nil))
|
|
(if (re-search-forward (car p) nil t)
|
|
(setq value (vc-match-substring (elt p 1))))
|
|
(if file
|
|
(progn (vc-file-setprop file (car properties) value)
|
|
(setq properties (cdr properties))))
|
|
value))
|
|
((eq (length p) 3) ;; search for latest entry
|
|
(let ((latest-date "") (latest-val))
|
|
(while (re-search-forward (car p) nil t)
|
|
(let ((date (vc-match-substring (elt p 2))))
|
|
(if (string< latest-date date)
|
|
(progn
|
|
(setq latest-date date)
|
|
(setq latest-val
|
|
(vc-match-substring (elt p 1)))))))
|
|
(if file
|
|
(progn (vc-file-setprop file (car properties) latest-val)
|
|
(setq properties (cdr properties))))
|
|
latest-val)))))
|
|
patterns)
|
|
)
|
|
|
|
(defun vc-insert-file (file &optional limit blocksize)
|
|
;; Insert the contents of FILE into the current buffer.
|
|
;; Optional argument LIMIT is a regexp. If present,
|
|
;; the file is inserted in chunks of size BLOCKSIZE
|
|
;; (default 8 kByte), until the first occurence of
|
|
;; LIMIT is found. The function returns nil if FILE
|
|
;; doesn't exist.
|
|
(erase-buffer)
|
|
(cond ((file-exists-p file)
|
|
(cond (limit
|
|
(if (not blocksize) (setq blocksize 8192))
|
|
(let (found s)
|
|
(while (not found)
|
|
(setq s (buffer-size))
|
|
(goto-char (1+ s))
|
|
(setq found
|
|
(or (zerop (car (cdr
|
|
(insert-file-contents file nil s
|
|
(+ s blocksize)))))
|
|
(progn (beginning-of-line)
|
|
(re-search-forward limit nil t)))))))
|
|
(t (insert-file-contents file)))
|
|
(set-buffer-modified-p nil)
|
|
(auto-save-mode nil)
|
|
t)
|
|
(t nil)))
|
|
|
|
(defun vc-parse-locks (file locks)
|
|
;; Parse RCS or SCCS locks.
|
|
;; The result is a list of the form ((VERSION USER) (VERSION USER) ...),
|
|
;; which is returned and stored into the property `vc-master-locks'.
|
|
(if (not locks)
|
|
(vc-file-setprop file 'vc-master-locks 'none)
|
|
(let ((found t) (index 0) master-locks version user)
|
|
(cond ((eq (vc-backend file) 'SCCS)
|
|
(while (string-match "^\\([0-9.]+\\) [0-9.]+ \\([^ ]+\\) .*\n?"
|
|
locks index)
|
|
(setq version (substring locks
|
|
(match-beginning 1) (match-end 1)))
|
|
(setq user (substring locks
|
|
(match-beginning 2) (match-end 2)))
|
|
(setq master-locks (append master-locks
|
|
(list (cons version user))))
|
|
(setq index (match-end 0))))
|
|
((eq (vc-backend file) 'RCS)
|
|
(while (string-match "[ \t\n]*\\([^:]+\\):\\([0-9.]+\\)"
|
|
locks index)
|
|
(setq version (substring locks
|
|
(match-beginning 2) (match-end 2)))
|
|
(setq user (substring locks
|
|
(match-beginning 1) (match-end 1)))
|
|
(setq master-locks (append master-locks
|
|
(list (cons version user))))
|
|
(setq index (match-end 0)))))
|
|
(vc-file-setprop file 'vc-master-locks (or master-locks 'none)))))
|
|
|
|
(defun vc-fetch-master-properties (file)
|
|
;; Fetch those properties of FILE that are stored in the master file.
|
|
;; For an RCS file, we don't get vc-latest-version vc-your-latest-version
|
|
;; here because that is slow.
|
|
;; That gets done if/when the functions vc-latest-version
|
|
;; and vc-your-latest-version get called.
|
|
(save-excursion
|
|
(cond
|
|
((eq (vc-backend file) 'SCCS)
|
|
(set-buffer (get-buffer-create "*vc-info*"))
|
|
(if (vc-insert-file (vc-lock-file file))
|
|
(vc-parse-locks file (buffer-string))
|
|
(vc-file-setprop file 'vc-master-locks 'none))
|
|
(vc-insert-file (vc-name file) "^\001e")
|
|
(vc-parse-buffer
|
|
(list '("^\001d D \\([^ ]+\\)" 1)
|
|
(list (concat "^\001d D \\([^ ]+\\) .* "
|
|
(regexp-quote (user-login-name)) " ") 1))
|
|
file
|
|
'(vc-latest-version vc-your-latest-version)))
|
|
|
|
((eq (vc-backend file) 'RCS)
|
|
(set-buffer (get-buffer-create "*vc-info*"))
|
|
(vc-insert-file (vc-name file) "^locks")
|
|
(vc-parse-buffer
|
|
(list '("^head[ \t\n]+\\([^;]+\\);" 1)
|
|
'("^branch[ \t\n]+\\([^;]+\\);" 1)
|
|
'("^locks\\([^;]+\\);" 1))
|
|
file
|
|
'(vc-head-version
|
|
vc-default-branch
|
|
vc-master-locks))
|
|
;; determine vc-top-version: it is either the head version,
|
|
;; or the tip of the default branch
|
|
(let ((default-branch (vc-file-getprop file 'vc-default-branch)))
|
|
(cond
|
|
;; no default branch
|
|
((or (not default-branch) (string= "" default-branch))
|
|
(vc-file-setprop file 'vc-top-version
|
|
(vc-file-getprop file 'vc-head-version)))
|
|
;; default branch is actually a revision
|
|
((string-match "^[0-9]+\\.[0-9]+\\(\\.[0-9]+\\.[0-9]+\\)*$"
|
|
default-branch)
|
|
(vc-file-setprop file 'vc-top-version default-branch))
|
|
;; else, search for the tip of the default branch
|
|
(t (vc-insert-file (vc-name file) "^desc")
|
|
(vc-parse-buffer (list (list
|
|
(concat "^\\("
|
|
(regexp-quote default-branch)
|
|
"\\.[0-9]+\\)\ndate[ \t]+\\([0-9.]+\\);") 1 2))
|
|
file '(vc-top-version)))))
|
|
;; translate the locks
|
|
(vc-parse-locks file (vc-file-getprop file 'vc-master-locks)))
|
|
|
|
((eq (vc-backend file) 'CVS)
|
|
;; don't switch to the *vc-info* buffer before running the
|
|
;; command, because that would change its default directory
|
|
(save-excursion (set-buffer (get-buffer-create "*vc-info*"))
|
|
(erase-buffer))
|
|
(let ((exec-path (append vc-path exec-path)) exec-status
|
|
;; Add vc-path to PATH for the execution of this command.
|
|
(process-environment
|
|
(cons (concat "PATH=" (getenv "PATH")
|
|
path-separator
|
|
(mapconcat 'identity vc-path path-separator))
|
|
process-environment)))
|
|
(setq exec-status
|
|
(apply 'call-process "cvs" nil "*vc-info*" nil
|
|
(list "status" file)))
|
|
(cond ((> exec-status 0)
|
|
(switch-to-buffer (get-file-buffer file))
|
|
(shrink-window-if-larger-than-buffer
|
|
(display-buffer "*vc-info*"))
|
|
(error "Couldn't find version control information"))))
|
|
(set-buffer (get-buffer "*vc-info*"))
|
|
(set-buffer-modified-p nil)
|
|
(auto-save-mode nil)
|
|
(vc-parse-buffer
|
|
;; CVS 1.3 says "RCS Version:", other releases "RCS Revision:",
|
|
;; and CVS 1.4a1 says "Repository revision:".
|
|
'(("\\(RCS Version\\|RCS Revision\\|Repository revision\\):[\t ]+\\([0-9.]+\\)" 2)
|
|
("^File: [^ \t]+[ \t]+Status: \\(.*\\)" 1))
|
|
file
|
|
'(vc-latest-version vc-cvs-status))
|
|
;; Translate those status values that are needed into symbols.
|
|
;; Any other value is converted to nil.
|
|
(let ((status (vc-file-getprop file 'vc-cvs-status)))
|
|
(cond ((string-match "Up-to-date" status)
|
|
(vc-file-setprop file 'vc-cvs-status 'up-to-date)
|
|
(vc-file-setprop file 'vc-checkout-time
|
|
(nth 5 (file-attributes file))))
|
|
((string-match "Locally Modified" status)
|
|
(vc-file-setprop file 'vc-cvs-status 'locally-modified))
|
|
((string-match "Needs Merge" status)
|
|
(vc-file-setprop file 'vc-cvs-status 'needs-merge))
|
|
((string-match "Needs Checkout" status)
|
|
(vc-file-setprop file 'vc-cvs-status 'needs-checkout))
|
|
(t (vc-file-setprop file 'vc-cvs-status nil))))))
|
|
(if (get-buffer "*vc-info*")
|
|
(kill-buffer (get-buffer "*vc-info*")))))
|
|
|
|
;;; Functions that determine property values, by examining the
|
|
;;; working file, the master file, or log program output
|
|
|
|
(defun vc-consult-rcs-headers (file)
|
|
;; Search for RCS headers in FILE, and set properties
|
|
;; accordingly. This function can be disabled by setting
|
|
;; vc-consult-headers to nil.
|
|
;; Returns: nil if no headers were found
|
|
;; (or if the feature is disabled,
|
|
;; or if there is currently no buffer
|
|
;; visiting FILE)
|
|
;; 'rev if a workfile revision was found
|
|
;; 'rev-and-lock if revision and lock info was found
|
|
(cond
|
|
((or (not vc-consult-headers)
|
|
(not (get-file-buffer file))) nil)
|
|
((save-excursion
|
|
(set-buffer (get-file-buffer file))
|
|
(goto-char (point-min))
|
|
(cond
|
|
;; search for $Id or $Header
|
|
;; -------------------------
|
|
((or (and (search-forward "$Id: " nil t)
|
|
(looking-at "[^ ]+ \\([0-9.]+\\) "))
|
|
(and (progn (goto-char (point-min))
|
|
(search-forward "$Header: " nil t))
|
|
(looking-at "[^ ]+ \\([0-9.]+\\) ")))
|
|
(goto-char (match-end 0))
|
|
;; if found, store the revision number ...
|
|
(let ((rev (buffer-substring (match-beginning 1)
|
|
(match-end 1))))
|
|
;; ... and check for the locking state
|
|
(cond
|
|
((looking-at
|
|
(concat "[0-9]+[/-][01][0-9][/-][0-3][0-9] " ; date
|
|
"[0-2][0-9]:[0-5][0-9]+:[0-6][0-9]+\\([+-][0-9:]+\\)? " ; time
|
|
"[^ ]+ [^ ]+ ")) ; author & state
|
|
(goto-char (match-end 0)) ; [0-6] in regexp handles leap seconds
|
|
(cond
|
|
;; unlocked revision
|
|
((looking-at "\\$")
|
|
(vc-file-setprop file 'vc-workfile-version rev)
|
|
(vc-file-setprop file 'vc-locking-user 'none)
|
|
'rev-and-lock)
|
|
;; revision is locked by some user
|
|
((looking-at "\\([^ ]+\\) \\$")
|
|
(vc-file-setprop file 'vc-workfile-version rev)
|
|
(vc-file-setprop file 'vc-locking-user
|
|
(buffer-substring (match-beginning 1)
|
|
(match-end 1)))
|
|
'rev-and-lock)
|
|
;; everything else: false
|
|
(nil)))
|
|
;; unexpected information in
|
|
;; keyword string --> quit
|
|
(nil))))
|
|
;; search for $Revision
|
|
;; --------------------
|
|
((re-search-forward (concat "\\$"
|
|
"Revision: \\([0-9.]+\\) \\$")
|
|
nil t)
|
|
;; if found, store the revision number ...
|
|
(let ((rev (buffer-substring (match-beginning 1)
|
|
(match-end 1))))
|
|
;; and see if there's any lock information
|
|
(goto-char (point-min))
|
|
(if (re-search-forward (concat "\\$" "Locker:") nil t)
|
|
(cond ((looking-at " \\([^ ]+\\) \\$")
|
|
(vc-file-setprop file 'vc-workfile-version rev)
|
|
(vc-file-setprop file 'vc-locking-user
|
|
(buffer-substring (match-beginning 1)
|
|
(match-end 1)))
|
|
'rev-and-lock)
|
|
((looking-at " *\\$")
|
|
(vc-file-setprop file 'vc-workfile-version rev)
|
|
(vc-file-setprop file 'vc-locking-user 'none)
|
|
'rev-and-lock)
|
|
(t
|
|
(vc-file-setprop file 'vc-workfile-version rev)
|
|
(vc-file-setprop file 'vc-locking-user 'none)
|
|
'rev-and-lock))
|
|
(vc-file-setprop file 'vc-workfile-version rev)
|
|
'rev)))
|
|
;; else: nothing found
|
|
;; -------------------
|
|
(t nil))))))
|
|
|
|
;;; Access functions to file properties
|
|
;;; (Properties should be _set_ using vc-file-setprop, but
|
|
;;; _retrieved_ only through these functions, which decide
|
|
;;; if the property is already known or not. A property should
|
|
;;; only be retrieved by vc-file-getprop if there is no
|
|
;;; access function.)
|
|
|
|
;;; properties indicating the backend
|
|
;;; being used for FILE
|
|
|
|
(defun vc-backend-subdirectory-name (&optional file)
|
|
;; Where the master and lock files for the current directory are kept
|
|
(symbol-name
|
|
(or
|
|
(and file (vc-backend file))
|
|
vc-default-back-end
|
|
(setq vc-default-back-end (if (vc-find-binary "rcs") 'RCS 'SCCS)))))
|
|
|
|
(defun vc-name (file)
|
|
"Return the master name of a file, nil if it is not registered."
|
|
(or (vc-file-getprop file 'vc-name)
|
|
(let ((name-and-type (vc-registered file)))
|
|
(if name-and-type
|
|
(progn
|
|
(vc-file-setprop file 'vc-backend (cdr name-and-type))
|
|
(vc-file-setprop file 'vc-name (car name-and-type)))))))
|
|
|
|
(defun vc-backend (file)
|
|
"Return the version-control type of a file, nil if it is not registered."
|
|
(and file
|
|
(or (vc-file-getprop file 'vc-backend)
|
|
(let ((name-and-type (vc-registered file)))
|
|
(if name-and-type
|
|
(progn
|
|
(vc-file-setprop file 'vc-name (car name-and-type))
|
|
(vc-file-setprop file 'vc-backend (cdr name-and-type))))))))
|
|
|
|
;;; properties indicating the locking state
|
|
|
|
(defun vc-cvs-status (file)
|
|
;; Return the cvs status of FILE
|
|
;; (Status field in output of "cvs status")
|
|
(cond ((vc-file-getprop file 'vc-cvs-status))
|
|
(t (vc-fetch-master-properties file)
|
|
(vc-file-getprop file 'vc-cvs-status))))
|
|
|
|
(defun vc-master-locks (file)
|
|
;; Return the lock entries in the master of FILE.
|
|
;; Return 'none if there are no such entries, and a list
|
|
;; of the form ((VERSION USER) (VERSION USER) ...) otherwise.
|
|
(cond ((vc-file-getprop file 'vc-master-locks))
|
|
(t (vc-fetch-master-properties file)
|
|
(vc-file-getprop file 'vc-master-locks))))
|
|
|
|
(defun vc-master-locking-user (file)
|
|
;; Return the master file's idea of who is locking
|
|
;; the current workfile version of FILE.
|
|
;; Return 'none if it is not locked.
|
|
(let ((master-locks (vc-master-locks file)) lock)
|
|
(if (eq master-locks 'none) 'none
|
|
;; search for a lock on the current workfile version
|
|
(setq lock (assoc (vc-workfile-version file) master-locks))
|
|
(cond (lock (cdr lock))
|
|
('none)))))
|
|
|
|
(defun vc-locking-user (file)
|
|
;; Return the name of the person currently holding a lock on FILE.
|
|
;; Return nil if there is no such person.
|
|
;; Under CVS, a file is considered locked if it has been modified since
|
|
;; it was checked out. Under CVS, this will sometimes return the uid of
|
|
;; the owner of the file (as a number) instead of a string.
|
|
;; The property is cached. It is only looked up if it is currently nil.
|
|
;; Note that, for a file that is not locked, the actual property value
|
|
;; is 'none, to distinguish it from an unknown locking state. That value
|
|
;; is converted to nil by this function, and returned to the caller.
|
|
(let ((locking-user (vc-file-getprop file 'vc-locking-user)))
|
|
(if locking-user
|
|
;; if we already know the property, return it
|
|
(if (eq locking-user 'none) nil locking-user)
|
|
|
|
;; otherwise, infer the property...
|
|
(cond
|
|
;; in the CVS case, check the status
|
|
((eq (vc-backend file) 'CVS)
|
|
(if (and (not (eq (vc-cvs-status file) 'locally-modified))
|
|
(not (eq (vc-cvs-status file) 'needs-merge)))
|
|
(vc-file-setprop file 'vc-locking-user 'none)
|
|
;; The expression below should return the username of the owner
|
|
;; of the file. It doesn't. It returns the username if it is
|
|
;; you, or otherwise the UID of the owner of the file. The
|
|
;; return value from this function is only used by
|
|
;; vc-dired-reformat-line, and it does the proper thing if a UID
|
|
;; is returned.
|
|
;;
|
|
;; The *proper* way to fix this would be to implement a built-in
|
|
;; function in Emacs, say, (username UID), that returns the
|
|
;; username of a given UID.
|
|
;;
|
|
;; The result of this hack is that vc-directory will print the
|
|
;; name of the owner of the file for any files that are
|
|
;; modified.
|
|
(let ((uid (nth 2 (file-attributes file))))
|
|
(if (= uid (user-uid))
|
|
(vc-file-setprop file 'vc-locking-user (user-login-name))
|
|
(vc-file-setprop file 'vc-locking-user uid)))))
|
|
|
|
;; RCS case: attempt a header search. If this feature is
|
|
;; disabled, vc-consult-rcs-headers always returns nil.
|
|
((and (eq (vc-backend file) 'RCS)
|
|
(eq (vc-consult-rcs-headers file) 'rev-and-lock)))
|
|
|
|
;; if the file permissions are not trusted,
|
|
;; use the information from the master file
|
|
((or (not vc-keep-workfiles)
|
|
(eq vc-mistrust-permissions 't)
|
|
(and vc-mistrust-permissions
|
|
(funcall vc-mistrust-permissions
|
|
(vc-backend-subdirectory-name file))))
|
|
(vc-file-setprop file 'vc-locking-user (vc-master-locking-user file)))
|
|
|
|
;; Otherwise: Use the file permissions. (But if it turns out that the
|
|
;; file is not owned by the user, use the master file.)
|
|
;; This implementation assumes that any file which is under version
|
|
;; control and has -rw-r--r-- is locked by its owner. This is true
|
|
;; for both RCS and SCCS, which keep unlocked files at -r--r--r--.
|
|
;; We have to be careful not to exclude files with execute bits on;
|
|
;; scripts can be under version control too. Also, we must ignore the
|
|
;; group-read and other-read bits, since paranoid users turn them off.
|
|
;; This hack wins because calls to the somewhat expensive
|
|
;; `vc-fetch-master-properties' function only have to be made if
|
|
;; (a) the file is locked by someone other than the current user,
|
|
;; or (b) some untoward manipulation behind vc's back has changed
|
|
;; the owner or the `group' or `other' write bits.
|
|
(t
|
|
(let ((attributes (file-attributes file)))
|
|
(cond ((string-match ".r-..-..-." (nth 8 attributes))
|
|
(vc-file-setprop file 'vc-locking-user 'none))
|
|
((and (= (nth 2 attributes) (user-uid))
|
|
(string-match ".rw..-..-." (nth 8 attributes)))
|
|
(vc-file-setprop file 'vc-locking-user (user-login-name)))
|
|
(t
|
|
(vc-file-setprop file 'vc-locking-user
|
|
(vc-master-locking-user file))))
|
|
)))
|
|
;; recursively call the function again,
|
|
;; to convert a possible 'none value
|
|
(vc-locking-user file))))
|
|
|
|
;;; properties to store current and recent version numbers
|
|
|
|
(defun vc-latest-version (file)
|
|
;; Return version level of the latest version of FILE
|
|
(cond ((vc-file-getprop file 'vc-latest-version))
|
|
(t (vc-fetch-properties file)
|
|
(vc-file-getprop file 'vc-latest-version))))
|
|
|
|
(defun vc-your-latest-version (file)
|
|
;; Return version level of the latest version of FILE checked in by you
|
|
(cond ((vc-file-getprop file 'vc-your-latest-version))
|
|
(t (vc-fetch-properties file)
|
|
(vc-file-getprop file 'vc-your-latest-version))))
|
|
|
|
(defun vc-top-version (file)
|
|
;; Return version level of the highest revision on the default branch
|
|
;; If there is no default branch, return the highest version number
|
|
;; on the trunk.
|
|
;; This property is defined for RCS only.
|
|
(cond ((vc-file-getprop file 'vc-top-version))
|
|
(t (vc-fetch-master-properties file)
|
|
(vc-file-getprop file 'vc-top-version))))
|
|
|
|
(defun vc-fetch-properties (file)
|
|
;; Fetch vc-latest-version and vc-your-latest-version
|
|
;; if that wasn't already done.
|
|
(cond
|
|
((eq (vc-backend file) 'RCS)
|
|
(save-excursion
|
|
(set-buffer (get-buffer-create "*vc-info*"))
|
|
(vc-insert-file (vc-name file) "^desc")
|
|
(vc-parse-buffer
|
|
(list '("^\\([0-9]+\\.[0-9.]+\\)\ndate[ \t]+\\([0-9.]+\\);" 1 2)
|
|
(list (concat "^\\([0-9]+\\.[0-9.]+\\)\n"
|
|
"date[ \t]+\\([0-9.]+\\);[ \t]+"
|
|
"author[ \t]+"
|
|
(regexp-quote (user-login-name)) ";") 1 2))
|
|
file
|
|
'(vc-latest-version vc-your-latest-version))
|
|
(if (get-buffer "*vc-info*")
|
|
(kill-buffer (get-buffer "*vc-info*")))))
|
|
(t (vc-fetch-master-properties file))
|
|
))
|
|
|
|
(defun vc-workfile-version (file)
|
|
;; Return version level of the current workfile FILE
|
|
;; This is attempted by first looking at the RCS keywords.
|
|
;; If there are no keywords in the working file,
|
|
;; vc-top-version is taken.
|
|
;; Note that this property is cached, that is, it is only
|
|
;; looked up if it is nil.
|
|
;; For SCCS, this property is equivalent to vc-latest-version.
|
|
(cond ((vc-file-getprop file 'vc-workfile-version))
|
|
((eq (vc-backend file) 'SCCS) (vc-latest-version file))
|
|
((eq (vc-backend file) 'RCS)
|
|
(if (vc-consult-rcs-headers file)
|
|
(vc-file-getprop file 'vc-workfile-version)
|
|
(let ((rev (cond ((vc-top-version file))
|
|
((vc-latest-version file)))))
|
|
(vc-file-setprop file 'vc-workfile-version rev)
|
|
rev)))
|
|
((eq (vc-backend file) 'CVS)
|
|
(if (vc-consult-rcs-headers file) ;; CVS
|
|
(vc-file-getprop file 'vc-workfile-version)
|
|
(catch 'found
|
|
(vc-find-cvs-master (file-name-directory file)
|
|
(file-name-nondirectory file)))
|
|
(vc-file-getprop file 'vc-workfile-version)))))
|
|
|
|
;;; actual version-control code starts here
|
|
|
|
(defun vc-registered (file)
|
|
(let (handler handlers)
|
|
(if (boundp 'file-name-handler-alist)
|
|
(setq handler (find-file-name-handler file 'vc-registered)))
|
|
(if handler
|
|
(funcall handler 'vc-registered file)
|
|
;; Search for a master corresponding to the given file
|
|
(let ((dirname (or (file-name-directory file) ""))
|
|
(basename (file-name-nondirectory file)))
|
|
(catch 'found
|
|
(mapcar
|
|
(function (lambda (s)
|
|
(if (atom s)
|
|
(funcall s dirname basename)
|
|
(let ((trial (format (car s) dirname basename)))
|
|
(if (and (file-exists-p trial)
|
|
;; Make sure the file we found with name
|
|
;; TRIAL is not the source file itself.
|
|
;; That can happen with RCS-style names
|
|
;; if the file name is truncated
|
|
;; (e.g. to 14 chars). See if either
|
|
;; directory or attributes differ.
|
|
(or (not (string= dirname
|
|
(file-name-directory trial)))
|
|
(not (equal
|
|
(file-attributes file)
|
|
(file-attributes trial)))))
|
|
(throw 'found (cons trial (cdr s))))))))
|
|
vc-master-templates)
|
|
nil)))))
|
|
|
|
(defun vc-find-cvs-master (dirname basename)
|
|
;; Check if DIRNAME/BASENAME is handled by CVS.
|
|
;; If it is, do a (throw 'found (cons MASTER 'CVS)).
|
|
;; Note: If the file is ``cvs add''ed but not yet ``cvs commit''ed
|
|
;; the MASTER will not actually exist yet. The other parts of VC
|
|
;; checks for this condition. This function returns nil if
|
|
;; DIRNAME/BASENAME is not handled by CVS.
|
|
(if (and vc-handle-cvs
|
|
(file-directory-p (concat dirname "CVS/"))
|
|
(file-readable-p (concat dirname "CVS/Entries"))
|
|
(file-readable-p (concat dirname "CVS/Repository")))
|
|
(let ((bufs nil) (fold case-fold-search))
|
|
(unwind-protect
|
|
(save-excursion
|
|
(setq bufs (list
|
|
(find-file-noselect (concat dirname "CVS/Entries"))))
|
|
(set-buffer (car bufs))
|
|
(goto-char (point-min))
|
|
;; make sure the file name is searched
|
|
;; case-sensitively
|
|
(setq case-fold-search nil)
|
|
(cond
|
|
((re-search-forward
|
|
(concat "^/" (regexp-quote basename) "/\\([^/]*\\)/")
|
|
nil t)
|
|
(setq case-fold-search fold) ;; restore the old value
|
|
;; We found it. Store away version number, now
|
|
;; that we are anyhow so close to finding it.
|
|
(vc-file-setprop (concat dirname basename)
|
|
'vc-workfile-version
|
|
(buffer-substring (match-beginning 1)
|
|
(match-end 1)))
|
|
(setq bufs (cons (find-file-noselect
|
|
(concat dirname "CVS/Repository"))
|
|
bufs))
|
|
(set-buffer (car bufs))
|
|
(let ((master
|
|
(concat (file-name-as-directory
|
|
(buffer-substring (point-min)
|
|
(1- (point-max))))
|
|
basename
|
|
",v")))
|
|
(throw 'found (cons master 'CVS))))
|
|
(t (setq case-fold-search fold) ;; restore the old value
|
|
nil)))
|
|
(mapcar (function kill-buffer) bufs)))))
|
|
|
|
(defun vc-buffer-backend ()
|
|
"Return the version-control type of the visited file, or nil if none."
|
|
(if (eq vc-buffer-backend t)
|
|
(setq vc-buffer-backend (vc-backend (buffer-file-name)))
|
|
vc-buffer-backend))
|
|
|
|
(defun vc-toggle-read-only (&optional verbose)
|
|
"Change read-only status of current buffer, perhaps via version control.
|
|
If the buffer is visiting a file registered with version control,
|
|
then check the file in or out. Otherwise, just change the read-only flag
|
|
of the buffer. With prefix argument, ask for version number."
|
|
(interactive "P")
|
|
(if (vc-backend (buffer-file-name))
|
|
(vc-next-action verbose)
|
|
(toggle-read-only)))
|
|
(define-key global-map "\C-x\C-q" 'vc-toggle-read-only)
|
|
|
|
(defun vc-mode-line (file &optional label)
|
|
"Set `vc-mode' to display type of version control for FILE.
|
|
The value is set in the current buffer, which should be the buffer
|
|
visiting FILE. Second optional arg LABEL is put in place of version
|
|
control system name."
|
|
(interactive (list buffer-file-name nil))
|
|
(let ((vc-type (vc-backend file)))
|
|
(setq vc-mode
|
|
(and vc-type
|
|
(concat " " (or label (symbol-name vc-type))
|
|
(and vc-display-status (vc-status file)))))
|
|
(and vc-type
|
|
(equal file (buffer-file-name))
|
|
;; Make the buffer read-only if the file is not locked
|
|
;; (or unchanged, in the CVS case).
|
|
(if (not (vc-locking-user file))
|
|
(setq buffer-read-only t))
|
|
;; Even root shouldn't modify a registered file without
|
|
;; locking it first.
|
|
(not buffer-read-only)
|
|
(zerop (user-uid))
|
|
(not (equal (user-login-name) (vc-locking-user file)))
|
|
(setq buffer-read-only t))
|
|
(force-mode-line-update)
|
|
;;(set-buffer-modified-p (buffer-modified-p)) ;;use this if Emacs 18
|
|
vc-type))
|
|
|
|
(defun vc-status (file)
|
|
;; Return string for placement in modeline by `vc-mode-line'.
|
|
;; Format:
|
|
;;
|
|
;; "-REV" if the revision is not locked
|
|
;; ":REV" if the revision is locked by the user
|
|
;; ":LOCKER:REV" if the revision is locked by somebody else
|
|
;; " @@" for a CVS file that is added, but not yet committed
|
|
;;
|
|
;; In the CVS case, a "locked" working file is a
|
|
;; working file that is modified with respect to the master.
|
|
;; The file is "locked" from the moment when the user makes
|
|
;; the buffer writable.
|
|
;;
|
|
;; This function assumes that the file is registered.
|
|
|
|
(let ((locker (vc-locking-user file))
|
|
(rev (vc-workfile-version file)))
|
|
(cond ((string= "0" rev)
|
|
" @@")
|
|
((not locker)
|
|
(concat "-" rev))
|
|
((if (stringp locker)
|
|
(string= locker (user-login-name))
|
|
(= locker (user-uid)))
|
|
(concat ":" rev))
|
|
(t
|
|
(concat ":" locker ":" rev)))))
|
|
|
|
;;; install a call to the above as a find-file hook
|
|
(defun vc-find-file-hook ()
|
|
;; Recompute whether file is version controlled,
|
|
;; if user has killed the buffer and revisited.
|
|
(cond
|
|
(buffer-file-name
|
|
(vc-file-clearprops buffer-file-name)
|
|
(cond
|
|
((vc-backend buffer-file-name)
|
|
(vc-mode-line buffer-file-name)
|
|
(cond ((not vc-make-backup-files)
|
|
;; Use this variable, not make-backup-files,
|
|
;; because this is for things that depend on the file name.
|
|
(make-local-variable 'backup-inhibited)
|
|
(setq backup-inhibited t))))
|
|
((let* ((link (file-symlink-p buffer-file-name))
|
|
(link-type (and link (vc-backend link))))
|
|
(if link-type
|
|
(message
|
|
"Warning: symbolic link to %s-controlled source file"
|
|
link-type))))))))
|
|
|
|
(add-hook 'find-file-hooks 'vc-find-file-hook)
|
|
|
|
;;; more hooks, this time for file-not-found
|
|
(defun vc-file-not-found-hook ()
|
|
"When file is not found, try to check it out from RCS or SCCS.
|
|
Returns t if checkout was successful, nil otherwise."
|
|
(if (vc-backend buffer-file-name)
|
|
(save-excursion
|
|
(require 'vc)
|
|
(setq default-directory (file-name-directory (buffer-file-name)))
|
|
(not (vc-error-occurred (vc-checkout buffer-file-name))))))
|
|
|
|
(add-hook 'find-file-not-found-hooks 'vc-file-not-found-hook)
|
|
|
|
;; Discard info about a file when we kill its buffer.
|
|
(defun vc-kill-buffer-hook ()
|
|
(if (stringp (buffer-file-name))
|
|
(progn
|
|
(vc-file-clearprops (buffer-file-name))
|
|
(kill-local-variable 'vc-buffer-backend))))
|
|
|
|
;;;(add-hook 'kill-buffer-hook 'vc-kill-buffer-hook)
|
|
|
|
;;; Now arrange for bindings and autoloading of the main package.
|
|
;;; Bindings for this have to go in the global map, as we'll often
|
|
;;; want to call them from random buffers.
|
|
|
|
(setq vc-prefix-map (lookup-key global-map "\C-xv"))
|
|
(if (not (keymapp vc-prefix-map))
|
|
(progn
|
|
(setq vc-prefix-map (make-sparse-keymap))
|
|
(define-key global-map "\C-xv" vc-prefix-map)
|
|
(define-key vc-prefix-map "a" 'vc-update-change-log)
|
|
(define-key vc-prefix-map "c" 'vc-cancel-version)
|
|
(define-key vc-prefix-map "d" 'vc-directory)
|
|
(define-key vc-prefix-map "h" 'vc-insert-headers)
|
|
(define-key vc-prefix-map "i" 'vc-register)
|
|
(define-key vc-prefix-map "l" 'vc-print-log)
|
|
(define-key vc-prefix-map "r" 'vc-retrieve-snapshot)
|
|
(define-key vc-prefix-map "s" 'vc-create-snapshot)
|
|
(define-key vc-prefix-map "u" 'vc-revert-buffer)
|
|
(define-key vc-prefix-map "v" 'vc-next-action)
|
|
(define-key vc-prefix-map "=" 'vc-diff)
|
|
(define-key vc-prefix-map "~" 'vc-version-other-window)))
|
|
|
|
(if (not (boundp 'vc-menu-map))
|
|
;; Don't do the menu bindings if menu-bar.el wasn't loaded to defvar
|
|
;; vc-menu-map.
|
|
()
|
|
;;(define-key vc-menu-map [show-files]
|
|
;; '("Show Files under VC" . (vc-directory t)))
|
|
(define-key vc-menu-map [vc-directory] '("Show Locked Files" . vc-directory))
|
|
(define-key vc-menu-map [separator1] '("----"))
|
|
(define-key vc-menu-map [vc-rename-file] '("Rename File" . vc-rename-file))
|
|
(define-key vc-menu-map [vc-version-other-window]
|
|
'("Show Other Version" . vc-version-other-window))
|
|
(define-key vc-menu-map [vc-diff] '("Compare with Last Version" . vc-diff))
|
|
(define-key vc-menu-map [vc-update-change-log]
|
|
'("Update ChangeLog" . vc-update-change-log))
|
|
(define-key vc-menu-map [vc-print-log] '("Show History" . vc-print-log))
|
|
(define-key vc-menu-map [separator2] '("----"))
|
|
(define-key vc-menu-map [undo] '("Undo Last Check-In" . vc-cancel-version))
|
|
(define-key vc-menu-map [vc-revert-buffer]
|
|
'("Revert to Last Version" . vc-revert-buffer))
|
|
(define-key vc-menu-map [vc-insert-header]
|
|
'("Insert Header" . vc-insert-headers))
|
|
(define-key vc-menu-map [vc-menu-check-in] '("Check In" . vc-next-action))
|
|
(define-key vc-menu-map [vc-check-out] '("Check Out" . vc-toggle-read-only))
|
|
(define-key vc-menu-map [vc-register] '("Register" . vc-register))
|
|
(put 'vc-rename-file 'menu-enable 'vc-mode)
|
|
(put 'vc-version-other-window 'menu-enable 'vc-mode)
|
|
(put 'vc-diff 'menu-enable 'vc-mode)
|
|
(put 'vc-update-change-log 'menu-enable
|
|
'(eq (vc-buffer-backend) 'RCS))
|
|
(put 'vc-print-log 'menu-enable 'vc-mode)
|
|
(put 'vc-cancel-version 'menu-enable 'vc-mode)
|
|
(put 'vc-revert-buffer 'menu-enable 'vc-mode)
|
|
(put 'vc-insert-headers 'menu-enable 'vc-mode)
|
|
(put 'vc-next-action 'menu-enable '(and vc-mode (not buffer-read-only)))
|
|
(put 'vc-toggle-read-only 'menu-enable '(and vc-mode buffer-read-only))
|
|
(put 'vc-register 'menu-enable '(and buffer-file-name (not vc-mode)))
|
|
)
|
|
|
|
(provide 'vc-hooks)
|
|
|
|
;;; vc-hooks.el ends here
|