1 ;;; vc-svn.el --- non-resident support for Subversion version-control
3 ;; Copyright (C) 1995, 1998, 1999, 2000, 2001, 2002, 2003, 2004
4 ;; Free Software Foundation, Inc.
6 ;; Author: FSF (see vc.el for full credits)
7 ;; Maintainer: Stefan Monnier <monnier@gnu.org>
9 ;; This file is part of GNU Emacs.
11 ;; GNU Emacs is free software; you can redistribute it and/or modify
12 ;; it under the terms of the GNU General Public License as published by
13 ;; the Free Software Foundation; either version 2, or (at your option)
16 ;; GNU Emacs is distributed in the hope that it will be useful,
17 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
18 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
19 ;; GNU General Public License for more details.
21 ;; You should have received a copy of the GNU General Public License
22 ;; along with GNU Emacs; see the file COPYING. If not, write to the
23 ;; Free Software Foundation, Inc., 59 Temple Place - Suite 330,
24 ;; Boston, MA 02111-1307, USA.
28 ;; This is preliminary support for Subversion (http://subversion.tigris.org/).
29 ;; It started as `sed s/cvs/svn/ vc.cvs.el' (from version 1.56)
30 ;; and hasn't been completely fixed since.
32 ;; Sync'd with Subversion's vc-svn.el as of revision 5801.
36 ;; - VC-dired is (really) slow.
44 ;;; Customization options
47 (defcustom vc-svn-global-switches nil
48 "*Global switches to pass to any SVN command."
49 :type '(choice (const :tag "None" nil)
50 (string :tag "Argument String")
51 (repeat :tag "Argument List"
57 (defcustom vc-svn-register-switches nil
58 "*Extra switches for registering a file into SVN.
59 A string or list of strings passed to the checkin program by
61 :type '(choice (const :tag "None" nil)
62 (string :tag "Argument String")
63 (repeat :tag "Argument List"
69 (defcustom vc-svn-diff-switches
70 t ;`svn' doesn't support common args like -c or -b.
71 "String or list of strings specifying extra switches for svn diff under VC.
72 If nil, use the value of `vc-diff-switches'.
73 If you want to force an empty list of arguments, use t."
74 :type '(choice (const :tag "Unspecified" nil)
76 (string :tag "Argument String")
77 (repeat :tag "Argument List"
83 (defcustom vc-svn-header (or (cdr (assoc 'SVN vc-header-alist)) '("\$Id\$"))
84 "*Header keywords to be inserted by `vc-insert-headers'."
86 :type '(repeat string)
89 (defconst vc-svn-use-edit nil
90 ;; Subversion does not provide this feature (yet).
91 "*Non-nil means to use `svn edit' to \"check out\" a file.
92 This is only meaningful if you don't use the implicit checkout model
93 \(i.e. if you have $SVNREAD set)."
100 ;;; State-querying functions
103 ;;;###autoload (defun vc-svn-registered (f)
104 ;;;###autoload (when (file-readable-p (expand-file-name
105 ;;;###autoload ".svn/entries" (file-name-directory f)))
106 ;;;###autoload (load "vc-svn")
107 ;;;###autoload (vc-svn-registered f)))
110 (add-to-list 'completion-ignored-extensions ".svn/")
112 (defun vc-svn-registered (file)
113 "Check if FILE is SVN registered."
114 (when (file-readable-p (expand-file-name ".svn/entries"
115 (file-name-directory file)))
117 (cd (file-name-directory file))
119 (vc-svn-command t 0 file "status" "-v")
120 ;; We can't find an `svn' executable. We could also deregister SVN.
122 (vc-svn-parse-status t)
123 (eq 'SVN (vc-file-getprop file 'vc-backend)))))
125 (defun vc-svn-state (file &optional localp)
126 "SVN-specific version of `vc-state'."
127 (setq localp (or localp (vc-stay-local-p file)))
129 (cd (file-name-directory file))
130 (vc-svn-command t 0 file "status" (if localp "-v" "-u"))
131 (vc-svn-parse-status localp)
132 (vc-file-getprop file 'vc-state)))
134 (defun vc-svn-state-heuristic (file)
135 "SVN-specific state heuristic."
136 (vc-svn-state file 'local))
138 (defun vc-svn-dir-state (dir &optional localp)
139 "Find the SVN state of all files in DIR."
140 (setq localp (or localp (vc-stay-local-p dir)))
141 (let ((default-directory dir))
142 ;; Don't specify DIR in this command, the default-directory is
143 ;; enough. Otherwise it might fail with remote repositories.
145 (vc-svn-command t 0 nil "status" (if localp "-v" "-u"))
146 (vc-svn-parse-status localp))))
148 (defun vc-svn-workfile-version (file)
149 "SVN-specific version of `vc-workfile-version'."
150 ;; There is no need to consult RCS headers under SVN, because we
151 ;; get the workfile version for free when we recognize that a file
152 ;; is registered in SVN.
153 (vc-svn-registered file)
154 (vc-file-getprop file 'vc-workfile-version))
156 (defun vc-svn-checkout-model (file)
157 "SVN-specific version of `vc-checkout-model'."
158 ;; It looks like Subversion has no equivalent of CVSREAD.
161 ;; vc-svn-mode-line-string doesn't exist because the default implementation
164 (defun vc-svn-dired-state-info (file)
165 "SVN-specific version of `vc-dired-state-info'."
166 (let ((svn-state (vc-state file)))
167 (cond ((eq svn-state 'edited)
168 (if (equal (vc-workfile-version file) "0")
169 "(added)" "(modified)"))
170 ((eq svn-state 'needs-patch) "(patch)")
171 ((eq svn-state 'needs-merge) "(merge)"))))
175 ;;; State-changing functions
178 (defun vc-svn-register (file &optional rev comment)
179 "Register FILE into the SVN version-control system.
180 COMMENT can be used to provide an initial description of FILE.
182 `vc-register-switches' and `vc-svn-register-switches' are passed to
183 the SVN command (in that order)."
184 (apply 'vc-svn-command nil 0 file "add" (vc-switches 'SVN 'register)))
186 (defun vc-svn-responsible-p (file)
187 "Return non-nil if SVN thinks it is responsible for FILE."
188 (file-directory-p (expand-file-name ".svn"
189 (if (file-directory-p file)
191 (file-name-directory file)))))
193 (defalias 'vc-svn-could-register 'vc-svn-responsible-p
194 "Return non-nil if FILE could be registered in SVN.
195 This is only possible if SVN is responsible for FILE's directory.")
197 (defun vc-svn-checkin (file rev comment)
198 "SVN-specific version of `vc-backend-checkin'."
200 'vc-svn-command nil 1 file "ci"
201 (nconc (list "-m" comment) (vc-switches 'SVN 'checkin)))))
203 (goto-char (point-min))
204 (unless (equal status 0)
205 ;; Check checkin problem.
207 ((search-forward "Transaction is out of date" nil t)
208 (vc-file-setprop file 'vc-state 'needs-merge)
209 (error (substitute-command-keys
210 (concat "Up-to-date check failed: "
211 "type \\[vc-next-action] to merge in changes"))))
213 (pop-to-buffer (current-buffer))
214 (goto-char (point-min))
215 (shrink-window-if-larger-than-buffer)
216 (error "Check-in failed"))))
217 ;; Update file properties
219 ;; file 'vc-workfile-version
220 ;; (vc-parse-buffer "^\\(new\\|initial\\) revision: \\([0-9.]+\\)" 2))
223 (defun vc-svn-find-version (file rev buffer)
224 (apply 'vc-svn-command
227 (and rev (not (string= rev ""))
229 (vc-switches 'SVN 'checkout)))
231 (defun vc-svn-checkout (file &optional editable rev)
232 (message "Checking out %s..." file)
233 (with-current-buffer (or (get-file-buffer file) (current-buffer))
234 (vc-call update file editable rev (vc-switches 'SVN 'checkout)))
236 (message "Checking out %s...done" file))
238 (defun vc-svn-update (file editable rev switches)
239 (if (and (file-exists-p file) (not rev))
240 ;; If no revision was specified, just make the file writable
241 ;; if necessary (using `svn-edit' if requested).
242 (and editable (not (eq (vc-svn-checkout-model file) 'implicit))
244 (vc-svn-command nil 0 file "edit")
245 (set-file-modes file (logior (file-modes file) 128))
246 (if (equal file buffer-file-name) (toggle-read-only -1))))
247 ;; Check out a particular version (or recreate the file).
248 (vc-file-setprop file 'vc-workfile-version nil)
249 (apply 'vc-svn-command nil 0 file
251 ;; default for verbose checkout: clear the sticky tag so
252 ;; that the actual update will get the head of the trunk
254 ((null rev) "-rBASE")
255 ((or (eq rev t) (equal rev "")) nil)
256 (t (concat "-r" rev)))
259 (defun vc-svn-delete-file (file)
260 (vc-svn-command nil 0 file "remove"))
262 (defun vc-svn-rename-file (old new)
263 (vc-svn-command nil 0 new "move" (file-relative-name old)))
265 (defun vc-svn-revert (file &optional contents-done)
266 "Revert FILE to the version it was based on."
267 (unless contents-done
268 (vc-svn-command nil 0 file "revert"))
269 (unless (eq (vc-checkout-model file) 'implicit)
271 (vc-svn-command nil 0 file "unedit")
272 ;; Make the file read-only by switching off all w-bits
273 (set-file-modes file (logand (file-modes file) 3950)))))
275 (defun vc-svn-merge (file first-version &optional second-version)
276 "Merge changes into current working copy of FILE.
277 The changes are between FIRST-VERSION and SECOND-VERSION."
278 (vc-svn-command nil 0 file
280 "-r" (if second-version
281 (concat first-version ":" second-version)
283 (vc-file-setprop file 'vc-state 'edited)
284 (with-current-buffer (get-buffer "*vc*")
285 (goto-char (point-min))
286 (if (looking-at "C ")
288 0))) ; signal success
290 (defun vc-svn-merge-news (file)
291 "Merge in any new changes made to FILE."
292 (message "Merging changes into %s..." file)
293 ;; (vc-file-setprop file 'vc-workfile-version nil)
294 (vc-file-setprop file 'vc-checkout-time 0)
295 (vc-svn-command nil 0 file "update")
296 ;; Analyze the merge result reported by SVN, and set
297 ;; file properties accordingly.
298 (with-current-buffer (get-buffer "*vc*")
299 (goto-char (point-min))
300 ;; get new workfile version
301 (if (re-search-forward
302 "^\\(Updated to\\|At\\) revision \\([0-9]+\\)" nil t)
303 (vc-file-setprop file 'vc-workfile-version (match-string 2))
304 (vc-file-setprop file 'vc-workfile-version nil))
306 (goto-char (point-min))
308 (if (looking-at "At revision")
309 0 ;; there were no news; indicate success
310 (if (re-search-forward
311 (concat "^\\([CGDU] \\)?"
312 (regexp-quote (file-name-nondirectory file)))
315 ;; Merge successful, we are in sync with repository now
316 ((string= (match-string 1) "U ")
317 (vc-file-setprop file 'vc-state 'up-to-date)
318 (vc-file-setprop file 'vc-checkout-time
319 (nth 5 (file-attributes file)))
320 0);; indicate success to the caller
321 ;; Merge successful, but our own changes are still in the file
322 ((string= (match-string 1) "G ")
323 (vc-file-setprop file 'vc-state 'edited)
324 0);; indicate success to the caller
325 ;; Conflicts detected!
327 (vc-file-setprop file 'vc-state 'edited)
328 1);; signal the error to the caller
330 (pop-to-buffer "*vc*")
331 (error "Couldn't analyze svn update result")))
332 (message "Merging changes into %s...done" file))))
336 ;;; History functions
339 (defun vc-svn-print-log (file &optional buffer)
340 "Get change log associated with FILE."
342 (vc-setup-buffer buffer)
343 (let ((inhibit-read-only t))
344 (goto-char (point-min))
345 ;; Add a line to tell log-view-mode what file this is.
346 (insert "Working file: " (file-relative-name file) "\n"))
349 (if (and (vc-stay-local-p file) (fboundp 'start-process)) 'async 0)
352 (defun vc-svn-diff (file &optional oldvers newvers buffer)
353 "Get a difference report using SVN between two versions of FILE."
354 (unless buffer (setq buffer "*vc-diff*"))
355 (if (string= (vc-workfile-version file) "0")
356 ;; This file is added but not yet committed; there is no master file.
357 (if (or oldvers newvers)
358 (error "No revisions of %s exist" file)
359 ;; We regard this as "changed".
360 ;; Diff it against /dev/null.
361 ;; Note: this is NOT a "svn diff".
362 (apply 'vc-do-command buffer
364 (append (vc-switches nil 'diff) '("/dev/null")))
365 ;; Even if it's empty, it's locally modified.
368 (if vc-svn-diff-switches
369 (vc-switches 'SVN 'diff)
370 (list "-x" (mapconcat 'identity (vc-switches nil 'diff) " "))))
371 (async (and (vc-stay-local-p file)
372 (or oldvers newvers) ; Svn diffs those locally.
373 (fboundp 'start-process))))
374 (apply 'vc-svn-command buffer
380 (list "-r" (if newvers (concat oldvers ":" newvers)
382 (if async 1 ; async diff => pessimistic assumption
383 ;; For some reason `svn diff' does not return a useful
384 ;; status w.r.t whether the diff was empty or not.
385 (buffer-size (get-buffer buffer))))))
387 (defun vc-svn-diff-tree (dir &optional rev1 rev2)
388 "Diff all files at and below DIR."
389 (vc-svn-diff (file-name-as-directory dir) rev1 rev2))
395 (defun vc-svn-create-snapshot (dir name branchp)
396 "Assign to DIR's current version a given NAME.
397 If BRANCHP is non-nil, the name is created as a branch (and the current
398 workspace is immediately moved to that new branch).
399 NAME is assumed to be a URL."
400 (vc-svn-command nil 0 dir "copy" name)
401 (when branchp (vc-svn-retrieve-snapshot dir name nil)))
403 (defun vc-svn-retrieve-snapshot (dir name update)
404 "Retrieve a snapshot at and below DIR.
405 NAME is the name of the snapshot; if it is empty, do a `svn update'.
406 If UPDATE is non-nil, then update (resynch) any affected buffers.
407 NAME is assumed to be a URL."
408 (vc-svn-command nil 0 dir "switch" name)
409 ;; FIXME: parse the output and obey `update'.
416 ;; Subversion makes backups for us, so don't bother.
417 ;; (defalias 'vc-svn-make-version-backups-p 'vc-stay-local-p
418 ;; "Return non-nil if version backups should be made for FILE.")
420 (defun vc-svn-check-headers ()
421 "Check if the current file has any headers in it."
423 (goto-char (point-min))
424 (re-search-forward "\\$[A-Za-z\300-\326\330-\366\370-\377]+\
425 \\(: [\t -#%-\176\240-\377]*\\)?\\$" nil t)))
429 ;;; Internal functions
432 (defun vc-svn-command (buffer okstatus file &rest flags)
433 "A wrapper around `vc-do-command' for use in vc-svn.el.
434 The difference to vc-do-command is that this function always invokes `svn',
435 and that it passes `vc-svn-global-switches' to it before FLAGS."
436 (apply 'vc-do-command buffer okstatus "svn" file
437 (if (stringp vc-svn-global-switches)
438 (cons vc-svn-global-switches flags)
439 (append vc-svn-global-switches
442 (defun vc-svn-repository-hostname (dirname)
444 (let ((coding-system-for-read
445 (or file-name-coding-system
446 default-file-name-coding-system)))
447 (vc-insert-file (expand-file-name ".svn/entries" dirname)))
448 (goto-char (point-min))
449 (when (re-search-forward
450 (concat "name=\"svn:this_dir\"[\n\t ]*"
451 "\\([-a-z]+=\"[^\"]*\"[\n\t ]*\\)*?"
452 "url=\"\\([^\"]+\\)\"") nil t)
455 (defun vc-svn-parse-status (localp)
456 "Parse output of \"svn status\" command in the current buffer.
457 Set file properties accordingly. Unless FULL is t, parse only
458 essential information."
460 (goto-char (point-min))
461 (while (re-search-forward
462 "^[ ADMCI?!~][ MC][ L][ +][ S]..\\([ *]\\) +\\([-0-9]+\\) +\\([0-9?]+\\) +\\([^ ]+\\) +" nil t)
463 (setq file (expand-file-name
464 (buffer-substring (point) (line-end-position))))
465 (setq status (char-after (line-beginning-position)))
466 (unless (eq status ??)
467 (vc-file-setprop file 'vc-backend 'SVN)
468 ;; Use the last-modified revision, so that searching in vc-print-log
470 (vc-file-setprop file 'vc-workfile-version (match-string 3))
475 (if (eq (char-after (match-beginning 1)) ?*)
477 (vc-file-setprop file 'vc-checkout-time
478 (nth 5 (file-attributes file)))
481 ;; If the file was actually copied, (match-string 2) is "-".
482 (vc-file-setprop file 'vc-workfile-version "0")
483 (vc-file-setprop file 'vc-checkout-time 0)
485 ((memq status '(?M ?C))
486 (if (eq (char-after (match-beginning 1)) ?*)
491 (defun vc-svn-dir-state-heuristic (dir)
492 "Find the SVN state of all files in DIR, using only local information."
493 (vc-svn-dir-state dir 'local))
495 (defun vc-svn-valid-symbolic-tag-name-p (tag)
496 "Return non-nil if TAG is a valid symbolic tag name."
497 ;; According to the SVN manual, a valid symbolic tag must start with
498 ;; an uppercase or lowercase letter and can contain uppercase and
499 ;; lowercase letters, digits, `-', and `_'.
500 (and (string-match "^[a-zA-Z]" tag)
501 (not (string-match "[^a-z0-9A-Z-_]" tag))))
503 (defun vc-svn-valid-version-number-p (tag)
504 "Return non-nil if TAG is a valid version number."
505 (and (string-match "^[0-9]" tag)
506 (not (string-match "[^0-9]" tag))))
510 ;; arch-tag: 02f10c68-2b4d-453a-90fc-1eee6cfb268d
511 ;;; vc-svn.el ends here