+(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 occurrence 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)))
+ (if (string-match ";[ \t\n]+strict;" locks index)
+ (vc-file-setprop file 'vc-checkout-model 'manual)
+ (vc-file-setprop file 'vc-checkout-model 'implicit))))
+ (vc-file-setprop file 'vc-master-locks (or master-locks 'none)))))
+
+(defun vc-simple-command (okstatus command file &rest args)
+ ;; Simple version of vc-do-command, for use in vc-hooks only.
+ ;; 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 command nil "*vc-info*" nil
+ (append args (list file))))
+ (cond ((> exec-status okstatus)
+ (switch-to-buffer (get-file-buffer file))
+ (shrink-window-if-larger-than-buffer
+ (display-buffer "*vc-info*"))
+ (error "Couldn't find version control information")))
+ exec-status))
+
+(defun vc-parse-cvs-status (&optional full)
+ ;; Parse output of "cvs status" command in the current buffer and
+ ;; set file properties accordingly. Unless FULL is t, parse only
+ ;; essential information.
+ (let (file status)
+ (goto-char (point-min))
+ (if (re-search-forward "^File: " nil t)
+ (cond
+ ((looking-at "no file") nil)
+ ((re-search-forward "\\=\\([^ \t]+\\)" nil t)
+ (setq file (concat default-directory (match-string 1)))
+ (vc-file-setprop file 'vc-backend 'CVS)
+ (if (not (re-search-forward "\\=[ \t]+Status: \\(.*\\)" nil t))
+ (setq status "Unknown")
+ (setq status (match-string 1)))
+ (if (and full
+ (re-search-forward
+ "\\(RCS Version\\|RCS Revision\\|Repository revision\\):[\t ]+\\([0-9.]+\\)"
+ nil t))
+ (vc-file-setprop file 'vc-latest-version (match-string 2)))
+ (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))))
+ ((vc-file-setprop file 'vc-cvs-status
+ (cond
+ ((string-match "Locally Modified" status) 'locally-modified)
+ ((string-match "Needs Merge" status) 'needs-merge)
+ ((string-match "Needs \\(Checkout\\|Patch\\)" status)
+ 'needs-checkout)
+ ((string-match "Unresolved Conflict" status)
+ 'unresolved-conflict)
+ ((string-match "File had conflicts on merge" status)
+ 'unresolved-conflict)
+ ((string-match "Locally Added" status) 'locally-added)
+ ((string-match "New file!" status) 'locally-added)
+ (t 'unknown))))))))))
+
+(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 (vc-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) "^[0-9]")
+ (vc-parse-buffer
+ (list '("^head[ \t\n]+\\([^;]+\\);" 1)
+ '("^branch[ \t\n]+\\([^;]+\\);" 1)
+ '("^locks[ \t\n]*\\([^;]*;\\([ \t\n]*strict;\\)?\\)" 1))
+ file
+ '(vc-head-version
+ vc-default-branch
+ vc-master-locks))
+ ;; determine vc-master-workfile-version: it is either the head
+ ;; of the trunk, the head of the default branch, or the
+ ;; "default branch" itself, if that is a full revision number.
+ (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-master-workfile-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-master-workfile-version default-branch))
+ ;; else, search for the head 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-master-workfile-version)))))
+ ;; translate the locks
+ (vc-parse-locks file (vc-file-getprop file 'vc-master-locks)))
+
+ ((eq (vc-backend file) 'CVS)
+ (save-excursion
+ ;; Call "cvs status" in the right directory, passing only the
+ ;; nondirectory part of the file name -- otherwise CVS might
+ ;; silently give a wrong result.
+ (let ((default-directory (file-name-directory file)))
+ (vc-simple-command 0 "cvs" (file-name-nondirectory file) "status"))
+ (set-buffer (get-buffer "*vc-info*"))
+ (vc-parse-cvs-status t))))
+ (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)
+ ((let (status version locking-user)
+ (save-excursion
+ (set-buffer (get-file-buffer file))
+ (goto-char (point-min))
+ (cond
+ ;; search for $Id or $Header
+ ;; -------------------------
+ ;; The `\ 's below avoid an RCS 5.7 bug when checking in this file.
+ ((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 ...
+ (setq version (buffer-substring-no-properties (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 "\\$")
+ (setq locking-user 'none)
+ (setq status 'rev-and-lock))
+ ;; revision is locked by some user
+ ((looking-at "\\([^ ]+\\) \\$")
+ (setq locking-user
+ (buffer-substring-no-properties (match-beginning 1)
+ (match-end 1)))
+ (setq status '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 ...
+ (setq version (buffer-substring-no-properties (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 " \\([^ ]+\\) \\$")
+ (setq locking-user (buffer-substring-no-properties
+ (match-beginning 1)
+ (match-end 1)))
+ (setq status 'rev-and-lock))
+ ((looking-at " *\\$")
+ (setq locking-user 'none)
+ (setq status 'rev-and-lock))
+ (t
+ (setq locking-user 'none)
+ (setq status 'rev-and-lock)))
+ (setq status 'rev)))
+ ;; else: nothing found
+ ;; -------------------
+ (t nil)))
+ (if status (vc-file-setprop file 'vc-workfile-version version))
+ (and (eq status 'rev-and-lock)
+ (eq (vc-backend file) 'RCS)
+ (vc-file-setprop file 'vc-locking-user locking-user)
+ ;; If the file has headers, we don't want to query the master file,
+ ;; because that would eliminate all the performance gain the headers
+ ;; brought us. We therefore use a heuristic for the checkout model
+ ;; now: If we trust the file permissions, and the file is not
+ ;; locked, then if the file is read-only the checkout model is
+ ;; `manual', otherwise `implicit'.
+ (not (vc-mistrust-permissions file))
+ (not (vc-locking-user file))
+ (if (string-match ".r-..-..-." (nth 8 (file-attributes file)))
+ (vc-file-setprop file 'vc-checkout-model 'manual)
+ (vc-file-setprop file 'vc-checkout-model 'implicit)))
+ status))))
+
+;;; 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.
+For CVS, the full name of CVS/Entries is returned."
+ (or (vc-file-getprop file 'vc-name)
+ ;; Use the caching mechanism of vc-backend, below.
+ (if (vc-backend file)
+ (vc-file-getprop file 'vc-name))))
+
+(defun vc-backend (file)
+ "Return the version-control type of a file, nil if it is not registered."
+ ;; Note that internally, Emacs remembers unregistered
+ ;; files by setting the property to `none'.
+ (if file
+ (let ((property (vc-file-getprop file 'vc-backend))
+ (name-and-type))
+ (cond ((eq property 'none) nil)
+ (property)
+ (t (setq 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)))
+ (vc-file-setprop file 'vc-backend 'none)
+ nil))))))
+
+(defun vc-checkout-model (file)
+ ;; Return `manual' if the user has to type C-x C-q to check out FILE.
+ ;; Return `implicit' if the file can be modified without locking it first.
+ (or
+ (vc-file-getprop file 'vc-checkout-model)
+ (cond
+ ((eq (vc-backend file) 'SCCS)
+ (vc-file-setprop file 'vc-checkout-model 'manual))
+ ((eq (vc-backend file) 'RCS)
+ (vc-consult-rcs-headers file)
+ (or (vc-file-getprop file 'vc-checkout-model)
+ (progn (vc-fetch-master-properties file)
+ (vc-file-getprop file 'vc-checkout-model))))
+ ((eq (vc-backend file) 'CVS)
+ (vc-file-setprop file 'vc-checkout-model
+ (cond
+ ((getenv "CVSREAD") 'manual)
+ ;; If the file is not writeable, this is probably because the
+ ;; file is being "watched" by other developers. Use "manual"
+ ;; checkout in this case. (If vc-mistrust-permissions was t,
+ ;; we actually shouldn't trust this, but there is no other way
+ ;; to learn this from CVS at the moment (version 1.9).)
+ ((string-match "r-..-..-." (nth 8 (file-attributes file)))
+ 'manual)
+ (t 'implicit)))))))
+
+;;; 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-lock-from-permissions (file)
+ ;; If the permissions can be trusted for this file, determine the
+ ;; locking state from them. Returns (user-login-name), `none', or nil.
+ ;; 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.
+ (let ((attributes (file-attributes file)))
+ (if (not (vc-mistrust-permissions 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 (vc-user-login-name)))
+ (nil)))))
+
+(defun vc-user-login-name (&optional uid)
+ ;; Return the name under which the user is logged in, as a string.
+ ;; (With optional argument UID, return the name of that user.)
+ ;; This function does the same as `user-login-name', but unlike
+ ;; that, it never returns nil. If a UID cannot be resolved, that
+ ;; UID is returned as a string.
+ (or (user-login-name uid)
+ (and uid (number-to-string uid))
+ (number-to-string (user-uid))))
+
+(defun vc-file-owner (file)
+ ;; Return who owns FILE (user name, as a string).
+ (vc-user-login-name (nth 2 (file-attributes file))))
+
+(defun vc-rcs-lock-from-diff (file)
+ ;; Diff the file against the master version. If differences are found,
+ ;; mark the file locked. This is only used for RCS with non-strict
+ ;; locking. (If "rcsdiff" doesn't understand --brief, we do a double-take
+ ;; and remember the fact for the future.)
+ (let* ((version (concat "-r" (vc-workfile-version file)))
+ (status (if (eq vc-rcsdiff-knows-brief 'no)
+ (vc-simple-command 1 "rcsdiff" file version)
+ (vc-simple-command 2 "rcsdiff" file "--brief" version))))
+ (if (eq status 2)
+ (if (not vc-rcsdiff-knows-brief)
+ (setq vc-rcsdiff-knows-brief 'no
+ status (vc-simple-command 1 "rcsdiff" file version))
+ (error "rcsdiff failed."))
+ (if (not vc-rcsdiff-knows-brief) (setq vc-rcsdiff-knows-brief 'yes)))
+ (if (zerop status)
+ (vc-file-setprop file 'vc-locking-user 'none)
+ (vc-file-setprop file 'vc-locking-user (vc-file-owner file)))))
+
+(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.
+ ;; 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
+ ((eq (vc-backend file) 'CVS)
+ (or (and (eq (vc-checkout-model file) 'manual)
+ (vc-lock-from-permissions file))
+ (and (equal (vc-file-getprop file 'vc-checkout-time)
+ (nth 5 (file-attributes file)))
+ (vc-file-setprop file 'vc-locking-user 'none))
+ (vc-file-setprop file 'vc-locking-user (vc-file-owner file))))
+
+ ((eq (vc-backend file) 'RCS)
+ (let (p-lock)
+
+ ;; Check for RCS headers first
+ (or (eq (vc-consult-rcs-headers file) 'rev-and-lock)
+
+ ;; If there are no headers, try to learn it
+ ;; from the permissions.
+ (and (setq p-lock (vc-lock-from-permissions file))
+ (if (eq p-lock 'none)
+
+ ;; If the permissions say "not locked", we know
+ ;; that the checkout model must be `manual'.
+ (vc-file-setprop file 'vc-checkout-model 'manual)
+
+ ;; If the permissions say "locked", we can only trust
+ ;; this *if* the checkout model is `manual'.
+ (eq (vc-checkout-model file) 'manual)))
+
+ ;; Otherwise, use lock information from the master file.
+ (vc-file-setprop file 'vc-locking-user
+ (vc-master-locking-user file)))
+
+ ;; Finally, if the file is not explicitly locked
+ ;; it might still be locked implicitly.
+ (and (eq (vc-file-getprop file 'vc-locking-user) 'none)
+ (eq (vc-checkout-model file) 'implicit)
+ (vc-rcs-lock-from-diff file))))
+
+ ((eq (vc-backend file) 'SCCS)
+ (or (vc-lock-from-permissions file)
+ (vc-file-setprop file 'vc-locking-user
+ (vc-master-locking-user file)))))
+
+ ;; convert a possible 'none value
+ (setq locking-user (vc-file-getprop file 'vc-locking-user))
+ (if (eq locking-user 'none) nil locking-user))))
+
+;;; 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-master-workfile-version (file)
+ ;; Return the master file's idea of what is the current workfile version.
+ ;; This property is defined for RCS only.
+ (cond ((vc-file-getprop file 'vc-master-workfile-version))
+ (t (vc-fetch-master-properties file)
+ (vc-file-getprop file 'vc-master-workfile-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 (vc-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-master-workfile-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-master-workfile-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)))))
+