Update copyright notices for 2013.
[emacs.git] / lisp / vc / vc-hg.el
blob186671177141cebcceda6fb12becbdeb07f27401
1 ;;; vc-hg.el --- VC backend for the mercurial version control system -*- lexical-binding: t -*-
3 ;; Copyright (C) 2006-2013 Free Software Foundation, Inc.
5 ;; Author: Ivan Kanis
6 ;; Maintainer: FSF
7 ;; Keywords: vc tools
8 ;; Package: vc
10 ;; This file is part of GNU Emacs.
12 ;; GNU Emacs is free software: you can redistribute it and/or modify
13 ;; it under the terms of the GNU General Public License as published by
14 ;; the Free Software Foundation, either version 3 of the License, or
15 ;; (at your option) any later version.
17 ;; GNU Emacs is distributed in the hope that it will be useful,
18 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
19 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
20 ;; GNU General Public License for more details.
22 ;; You should have received a copy of the GNU General Public License
23 ;; along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>.
25 ;;; Commentary:
27 ;; This is a mercurial version control backend
29 ;;; Thanks:
31 ;;; Bugs:
33 ;;; Installation:
35 ;;; Todo:
37 ;; 1) Implement the rest of the vc interface. See the comment at the
38 ;; beginning of vc.el. The current status is:
40 ;; FUNCTION NAME STATUS
41 ;; BACKEND PROPERTIES
42 ;; * revision-granularity OK
43 ;; STATE-QUERYING FUNCTIONS
44 ;; * registered (file) OK
45 ;; * state (file) OK
46 ;; - state-heuristic (file) NOT NEEDED
47 ;; - dir-status (dir update-function) OK
48 ;; - dir-status-files (dir files ds uf) OK
49 ;; - dir-extra-headers (dir) OK
50 ;; - dir-printer (fileinfo) OK
51 ;; * working-revision (file) OK
52 ;; - latest-on-branch-p (file) ??
53 ;; * checkout-model (files) OK
54 ;; - workfile-unchanged-p (file) OK
55 ;; - mode-line-string (file) NOT NEEDED
56 ;; STATE-CHANGING FUNCTIONS
57 ;; * register (files &optional rev comment) OK
58 ;; * create-repo () OK
59 ;; - init-revision () NOT NEEDED
60 ;; - responsible-p (file) OK
61 ;; - could-register (file) OK
62 ;; - receive-file (file rev) ?? PROBABLY NOT NEEDED
63 ;; - unregister (file) COMMENTED OUT, MAY BE INCORRECT
64 ;; * checkin (files rev comment) OK
65 ;; * find-revision (file rev buffer) OK
66 ;; * checkout (file &optional editable rev) OK
67 ;; * revert (file &optional contents-done) OK
68 ;; - rollback (files) ?? PROBABLY NOT NEEDED
69 ;; - merge (file rev1 rev2) NEEDED
70 ;; - merge-news (file) NEEDED
71 ;; - steal-lock (file &optional revision) NOT NEEDED
72 ;; HISTORY FUNCTIONS
73 ;; * print-log (files buffer &optional shortlog start-revision limit) OK
74 ;; - log-view-mode () OK
75 ;; - show-log-entry (revision) NOT NEEDED, DEFAULT IS GOOD
76 ;; - comment-history (file) NOT NEEDED
77 ;; - update-changelog (files) NOT NEEDED
78 ;; * diff (files &optional rev1 rev2 buffer) OK
79 ;; - revision-completion-table (files) OK?
80 ;; - annotate-command (file buf &optional rev) OK
81 ;; - annotate-time () OK
82 ;; - annotate-current-time () NOT NEEDED
83 ;; - annotate-extract-revision-at-line () OK
84 ;; TAG SYSTEM
85 ;; - create-tag (dir name branchp) NEEDED
86 ;; - retrieve-tag (dir name update) NEEDED
87 ;; MISCELLANEOUS
88 ;; - make-version-backups-p (file) ??
89 ;; - repository-hostname (dirname) ??
90 ;; - previous-revision (file rev) OK
91 ;; - next-revision (file rev) OK
92 ;; - check-headers () ??
93 ;; - clear-headers () ??
94 ;; - delete-file (file) TEST IT
95 ;; - rename-file (old new) OK
96 ;; - find-file-hook () PROBABLY NOT NEEDED
98 ;; 2) Implement Stefan Monnier's advice:
99 ;; vc-hg-registered and vc-hg-state
100 ;; Both of those functions should be super extra careful to fail gracefully in
101 ;; unexpected circumstances. The reason this is important is that any error
102 ;; there will prevent the user from even looking at the file :-(
103 ;; Ideally, just like in vc-arch and vc-cvs, checking that the file is under
104 ;; mercurial's control and extracting the current revision should be done
105 ;; without even using `hg' (this way even if you don't have `hg' installed,
106 ;; Emacs is able to tell you this file is under mercurial's control).
108 ;;; History:
111 ;;; Code:
113 (eval-when-compile
114 (require 'cl-lib)
115 (require 'vc)
116 (require 'vc-dir))
118 ;;; Customization options
120 (defgroup vc-hg nil
121 "VC Mercurial (hg) backend."
122 :version "24.1"
123 :group 'vc)
125 (defcustom vc-hg-global-switches nil
126 "Global switches to pass to any Hg command."
127 :type '(choice (const :tag "None" nil)
128 (string :tag "Argument String")
129 (repeat :tag "Argument List" :value ("") string))
130 :version "22.2"
131 :group 'vc-hg)
133 (defcustom vc-hg-diff-switches t ; Hg doesn't support common args like -u
134 "String or list of strings specifying switches for Hg diff under VC.
135 If nil, use the value of `vc-diff-switches'. If t, use no switches."
136 :type '(choice (const :tag "Unspecified" nil)
137 (const :tag "None" t)
138 (string :tag "Argument String")
139 (repeat :tag "Argument List" :value ("") string))
140 :version "23.1"
141 :group 'vc-hg)
143 (defcustom vc-hg-program "hg"
144 "Name of the Mercurial executable (excluding any arguments)."
145 :type 'string
146 :group 'vc-hg)
148 (defcustom vc-hg-root-log-format
149 '("{rev}:{tags}: {author|person} {date|shortdate} {desc|firstline}\\n"
150 "^\\([0-9]+\\):\\([^:]*\\): \\(.*?\\)[ \t]+\\([0-9]\\{4\\}-[0-9]\\{2\\}-[0-9]\\{2\\}\\)"
151 ((1 'log-view-message-face)
152 (2 'change-log-list)
153 (3 'change-log-name)
154 (4 'change-log-date)))
155 "Mercurial log template for `vc-print-root-log'.
156 This should be a list (TEMPLATE REGEXP KEYWORDS), where TEMPLATE
157 is the \"--template\" argument string to pass to Mercurial,
158 REGEXP is a regular expression matching the resulting Mercurial
159 output, and KEYWORDS is a list of `font-lock-keywords' for
160 highlighting the Log View buffer."
161 :type '(list string string (repeat sexp))
162 :group 'vc-hg
163 :version "24.1")
166 ;;; Properties of the backend
168 (defvar vc-hg-history nil)
170 (defun vc-hg-revision-granularity () 'repository)
171 (defun vc-hg-checkout-model (_files) 'implicit)
173 ;;; State querying functions
175 ;;;###autoload (defun vc-hg-registered (file)
176 ;;;###autoload "Return non-nil if FILE is registered with hg."
177 ;;;###autoload (if (vc-find-root file ".hg") ; short cut
178 ;;;###autoload (progn
179 ;;;###autoload (load "vc-hg")
180 ;;;###autoload (vc-hg-registered file))))
182 ;; Modeled after the similar function in vc-bzr.el
183 (defun vc-hg-registered (file)
184 "Return non-nil if FILE is registered with hg."
185 (when (vc-hg-root file) ; short cut
186 (let ((state (vc-hg-state file))) ; expensive
187 (and state (not (memq state '(ignored unregistered)))))))
189 (defun vc-hg-state (file)
190 "Hg-specific version of `vc-state'."
191 (let*
192 ((status nil)
193 (default-directory (file-name-directory file))
194 (out
195 (with-output-to-string
196 (with-current-buffer
197 standard-output
198 (setq status
199 (condition-case nil
200 ;; Ignore all errors.
201 (let ((process-environment
202 ;; Avoid localization of messages so we
203 ;; can parse the output.
204 (append (list "TERM=dumb" "LANGUAGE=C")
205 process-environment)))
206 (process-file
207 vc-hg-program nil t nil
208 "--config" "alias.status=status"
209 "--config" "defaults.status="
210 "status" "-A" (file-relative-name file)))
211 ;; Some problem happened. E.g. We can't find an `hg'
212 ;; executable.
213 (error nil)))))))
214 (when (eq 0 status)
215 (when (null (string-match ".*: No such file or directory$" out))
216 (let ((state (aref out 0)))
217 (cond
218 ((eq state ?=) 'up-to-date)
219 ((eq state ?A) 'added)
220 ((eq state ?M) 'edited)
221 ((eq state ?I) 'ignored)
222 ((eq state ?R) 'removed)
223 ((eq state ?!) 'missing)
224 ((eq state ??) 'unregistered)
225 ((eq state ?C) 'up-to-date) ;; Older mercurial versions use this.
226 (t 'up-to-date)))))))
228 (defun vc-hg-working-revision (file)
229 "Hg-specific version of `vc-working-revision'."
230 (let ((default-directory (if (file-directory-p file)
231 (file-name-as-directory file)
232 (file-name-directory file))))
233 (ignore-errors
234 (with-output-to-string
235 (process-file vc-hg-program nil standard-output nil
236 "log" "-l" "1" "--template" "{rev}"
237 (file-relative-name file))))))
239 ;;; History functions
241 (defcustom vc-hg-log-switches nil
242 "String or list of strings specifying switches for hg log under VC."
243 :type '(choice (const :tag "None" nil)
244 (string :tag "Argument String")
245 (repeat :tag "Argument List" :value ("") string))
246 :group 'vc-hg)
248 (defun vc-hg-print-log (files buffer &optional shortlog start-revision limit)
249 "Get change log associated with FILES."
250 ;; `vc-do-command' creates the buffer, but we need it before running
251 ;; the command.
252 (vc-setup-buffer buffer)
253 ;; If the buffer exists from a previous invocation it might be
254 ;; read-only.
255 (let ((inhibit-read-only t))
256 (with-current-buffer
257 buffer
258 (apply 'vc-hg-command buffer 0 files "log"
259 (nconc
260 (when start-revision (list (format "-r%s:" start-revision)))
261 (when limit (list "-l" (format "%s" limit)))
262 (when shortlog (list "--template" (car vc-hg-root-log-format)))
263 vc-hg-log-switches)))))
265 (defvar log-view-message-re)
266 (defvar log-view-file-re)
267 (defvar log-view-font-lock-keywords)
268 (defvar log-view-per-file-logs)
269 (defvar log-view-expanded-log-entry-function)
271 (define-derived-mode vc-hg-log-view-mode log-view-mode "Hg-Log-View"
272 (require 'add-log) ;; we need the add-log faces
273 (set (make-local-variable 'log-view-file-re) "\\`a\\`")
274 (set (make-local-variable 'log-view-per-file-logs) nil)
275 (set (make-local-variable 'log-view-message-re)
276 (if (eq vc-log-view-type 'short)
277 (cadr vc-hg-root-log-format)
278 "^changeset:[ \t]*\\([0-9]+\\):\\(.+\\)"))
279 ;; Allow expanding short log entries
280 (when (eq vc-log-view-type 'short)
281 (setq truncate-lines t)
282 (set (make-local-variable 'log-view-expanded-log-entry-function)
283 'vc-hg-expanded-log-entry))
284 (set (make-local-variable 'log-view-font-lock-keywords)
285 (if (eq vc-log-view-type 'short)
286 (list (cons (nth 1 vc-hg-root-log-format)
287 (nth 2 vc-hg-root-log-format)))
288 (append
289 log-view-font-lock-keywords
291 ;; Handle the case:
292 ;; user: FirstName LastName <foo@bar>
293 ("^user:[ \t]+\\([^<(]+?\\)[ \t]*[(<]\\([A-Za-z0-9_.+-]+@[A-Za-z0-9_.-]+\\)[>)]"
294 (1 'change-log-name)
295 (2 'change-log-email))
296 ;; Handle the cases:
297 ;; user: foo@bar
298 ;; and
299 ;; user: foo
300 ("^user:[ \t]+\\([A-Za-z0-9_.+-]+\\(?:@[A-Za-z0-9_.-]+\\)?\\)"
301 (1 'change-log-email))
302 ("^date: \\(.+\\)" (1 'change-log-date))
303 ("^tag: +\\([^ ]+\\)$" (1 'highlight))
304 ("^summary:[ \t]+\\(.+\\)" (1 'log-view-message)))))))
306 (defun vc-hg-diff (files &optional oldvers newvers buffer)
307 "Get a difference report using hg between two revisions of FILES."
308 (let* ((firstfile (car files))
309 (working (and firstfile (vc-working-revision firstfile))))
310 (when (and (equal oldvers working) (not newvers))
311 (setq oldvers nil))
312 (when (and (not oldvers) newvers)
313 (setq oldvers working))
314 (apply #'vc-hg-command (or buffer "*vc-diff*") nil files "diff"
315 (append
316 (vc-switches 'hg 'diff)
317 (when oldvers
318 (if newvers
319 (list "-r" oldvers "-r" newvers)
320 (list "-r" oldvers)))))))
322 (defun vc-hg-expanded-log-entry (revision)
323 (with-temp-buffer
324 (vc-hg-command t nil nil "log" "-r" revision)
325 (goto-char (point-min))
326 (unless (eobp)
327 ;; Indent the expanded log entry.
328 (indent-region (point-min) (point-max) 2)
329 (goto-char (point-max))
330 (buffer-string))))
332 (defun vc-hg-revision-table (files)
333 (let ((default-directory (file-name-directory (car files))))
334 (with-temp-buffer
335 (vc-hg-command t nil files "log" "--template" "{rev} ")
336 (split-string
337 (buffer-substring-no-properties (point-min) (point-max))))))
339 ;; Modeled after the similar function in vc-cvs.el
340 (defun vc-hg-revision-completion-table (files)
341 (letrec ((table (lazy-completion-table
342 table (lambda () (vc-hg-revision-table files)))))
343 table))
345 (defun vc-hg-annotate-command (file buffer &optional revision)
346 "Execute \"hg annotate\" on FILE, inserting the contents in BUFFER.
347 Optional arg REVISION is a revision to annotate from."
348 (vc-hg-command buffer 0 file "annotate" "-d" "-n" "--follow"
349 (when revision (concat "-r" revision))))
351 (declare-function vc-annotate-convert-time "vc-annotate" (time))
353 ;; The format for one line output by "hg annotate -d -n" looks like this:
354 ;;215 Wed Jun 20 21:22:58 2007 -0700: CONTENTS
355 ;; i.e: VERSION_NUMBER DATE: CONTENTS
356 ;; If the user has set the "--follow" option, the output looks like:
357 ;;215 Wed Jun 20 21:22:58 2007 -0700 foo.c: CONTENTS
358 ;; i.e. VERSION_NUMBER DATE FILENAME: CONTENTS
359 (defconst vc-hg-annotate-re
360 "^[ \t]*\\([0-9]+\\) \\(.\\{30\\}\\)\\(?:\\(: \\)\\|\\(?: +\\(.+\\): \\)\\)")
362 (defun vc-hg-annotate-time ()
363 (when (looking-at vc-hg-annotate-re)
364 (goto-char (match-end 0))
365 (vc-annotate-convert-time
366 (date-to-time (match-string-no-properties 2)))))
368 (defun vc-hg-annotate-extract-revision-at-line ()
369 (save-excursion
370 (beginning-of-line)
371 (when (looking-at vc-hg-annotate-re)
372 (if (match-beginning 3)
373 (match-string-no-properties 1)
374 (cons (match-string-no-properties 1)
375 (expand-file-name (match-string-no-properties 4)
376 (vc-hg-root default-directory)))))))
378 (defun vc-hg-previous-revision (_file rev)
379 (let ((newrev (1- (string-to-number rev))))
380 (when (>= newrev 0)
381 (number-to-string newrev))))
383 (defun vc-hg-next-revision (_file rev)
384 (let ((newrev (1+ (string-to-number rev)))
385 (tip-revision
386 (with-temp-buffer
387 (vc-hg-command t 0 nil "tip")
388 (goto-char (point-min))
389 (re-search-forward "^changeset:[ \t]*\\([0-9]+\\):")
390 (string-to-number (match-string-no-properties 1)))))
391 ;; We don't want to exceed the maximum possible revision number, ie
392 ;; the tip revision.
393 (when (<= newrev tip-revision)
394 (number-to-string newrev))))
396 ;; Modeled after the similar function in vc-bzr.el
397 (defun vc-hg-delete-file (file)
398 "Delete FILE and delete it in the hg repository."
399 (condition-case ()
400 (delete-file file)
401 (file-error nil))
402 (vc-hg-command nil 0 file "remove" "--after" "--force"))
404 ;; Modeled after the similar function in vc-bzr.el
405 (defun vc-hg-rename-file (old new)
406 "Rename file from OLD to NEW using `hg mv'."
407 (vc-hg-command nil 0 new "mv" old))
409 (defun vc-hg-register (files &optional _rev _comment)
410 "Register FILES under hg.
411 REV is ignored.
412 COMMENT is ignored."
413 (vc-hg-command nil 0 files "add"))
415 (defun vc-hg-create-repo ()
416 "Create a new Mercurial repository."
417 (vc-hg-command nil 0 nil "init"))
419 (defalias 'vc-hg-responsible-p 'vc-hg-root)
421 ;; Modeled after the similar function in vc-bzr.el
422 (defun vc-hg-could-register (file)
423 "Return non-nil if FILE could be registered under hg."
424 (and (vc-hg-responsible-p file) ; shortcut
425 (condition-case ()
426 (with-temp-buffer
427 (vc-hg-command t nil file "add" "--dry-run"))
428 ;; The command succeeds with no output if file is
429 ;; registered.
430 (error))))
432 ;; FIXME: This would remove the file. Is that correct?
433 ;; (defun vc-hg-unregister (file)
434 ;; "Unregister FILE from hg."
435 ;; (vc-hg-command nil nil file "remove"))
437 (declare-function log-edit-extract-headers "log-edit" (headers string))
439 (defun vc-hg-checkin (files _rev comment)
440 "Hg-specific version of `vc-backend-checkin'.
441 REV is ignored."
442 (apply 'vc-hg-command nil 0 files
443 (nconc (list "commit" "-m")
444 (log-edit-extract-headers '(("Author" . "--user")
445 ("Date" . "--date"))
446 comment))))
448 (defun vc-hg-find-revision (file rev buffer)
449 (let ((coding-system-for-read 'binary)
450 (coding-system-for-write 'binary))
451 (if rev
452 (vc-hg-command buffer 0 file "cat" "-r" rev)
453 (vc-hg-command buffer 0 file "cat"))))
455 ;; Modeled after the similar function in vc-bzr.el
456 (defun vc-hg-checkout (file &optional _editable rev)
457 "Retrieve a revision of FILE.
458 EDITABLE is ignored.
459 REV is the revision to check out into WORKFILE."
460 (let ((coding-system-for-read 'binary)
461 (coding-system-for-write 'binary))
462 (with-current-buffer (or (get-file-buffer file) (current-buffer))
463 (if rev
464 (vc-hg-command t 0 file "cat" "-r" rev)
465 (vc-hg-command t 0 file "cat")))))
467 ;; Modeled after the similar function in vc-bzr.el
468 (defun vc-hg-workfile-unchanged-p (file)
469 (eq 'up-to-date (vc-hg-state file)))
471 ;; Modeled after the similar function in vc-bzr.el
472 (defun vc-hg-revert (file &optional contents-done)
473 (unless contents-done
474 (with-temp-buffer (vc-hg-command t 0 file "revert"))))
476 ;;; Hg specific functionality.
478 (defvar vc-hg-extra-menu-map
479 (let ((map (make-sparse-keymap)))
480 map))
482 (defun vc-hg-extra-menu () vc-hg-extra-menu-map)
484 (defun vc-hg-extra-status-menu () vc-hg-extra-menu-map)
486 (defvar log-view-vc-backend)
488 (cl-defstruct (vc-hg-extra-fileinfo
489 (:copier nil)
490 (:constructor vc-hg-create-extra-fileinfo (rename-state extra-name))
491 (:conc-name vc-hg-extra-fileinfo->))
492 rename-state ;; rename or copy state
493 extra-name) ;; original name for copies and rename targets, new name for
495 (declare-function vc-default-dir-printer "vc-dir" (backend fileentry))
497 (defun vc-hg-dir-printer (info)
498 "Pretty-printer for the vc-dir-fileinfo structure."
499 (let ((extra (vc-dir-fileinfo->extra info)))
500 (vc-default-dir-printer 'Hg info)
501 (when extra
502 (insert (propertize
503 (format " (%s %s)"
504 (pcase (vc-hg-extra-fileinfo->rename-state extra)
505 (`copied "copied from")
506 (`renamed-from "renamed from")
507 (`renamed-to "renamed to"))
508 (vc-hg-extra-fileinfo->extra-name extra))
509 'face 'font-lock-comment-face)))))
511 (defun vc-hg-after-dir-status (update-function)
512 (let ((file nil)
513 (translation '((?= . up-to-date)
514 (?C . up-to-date)
515 (?A . added)
516 (?R . removed)
517 (?M . edited)
518 (?I . ignored)
519 (?! . missing)
520 (? . copy-rename-line)
521 (?? . unregistered)))
522 (translated nil)
523 (result nil)
524 (last-added nil)
525 (last-line-copy nil))
526 (goto-char (point-min))
527 (while (not (eobp))
528 (setq translated (cdr (assoc (char-after) translation)))
529 (setq file
530 (buffer-substring-no-properties (+ (point) 2)
531 (line-end-position)))
532 (cond ((not translated)
533 (setq last-line-copy nil))
534 ((eq translated 'up-to-date)
535 (setq last-line-copy nil))
536 ((eq translated 'copy-rename-line)
537 ;; For copied files the output looks like this:
538 ;; A COPIED_FILE_NAME
539 ;; ORIGINAL_FILE_NAME
540 (setf (nth 2 last-added)
541 (vc-hg-create-extra-fileinfo 'copied file))
542 (setq last-line-copy t))
543 ((and last-line-copy (eq translated 'removed))
544 ;; For renamed files the output looks like this:
545 ;; A NEW_FILE_NAME
546 ;; ORIGINAL_FILE_NAME
547 ;; R ORIGINAL_FILE_NAME
548 ;; We need to adjust the previous entry to not think it is a copy.
549 (setf (vc-hg-extra-fileinfo->rename-state (nth 2 last-added))
550 'renamed-from)
551 (push (list file translated
552 (vc-hg-create-extra-fileinfo
553 'renamed-to (nth 0 last-added))) result)
554 (setq last-line-copy nil))
556 (setq last-added (list file translated nil))
557 (push last-added result)
558 (setq last-line-copy nil)))
559 (forward-line))
560 (funcall update-function result)))
562 (defun vc-hg-dir-status (dir update-function)
563 (vc-hg-command (current-buffer) 'async dir "status" "-C")
564 (vc-exec-after
565 `(vc-hg-after-dir-status (quote ,update-function))))
567 (defun vc-hg-dir-status-files (dir files _default-state update-function)
568 (apply 'vc-hg-command (current-buffer) 'async dir "status" "-C" files)
569 (vc-exec-after
570 `(vc-hg-after-dir-status (quote ,update-function))))
572 (defun vc-hg-dir-extra-header (name &rest commands)
573 (concat (propertize name 'face 'font-lock-type-face)
574 (propertize
575 (with-temp-buffer
576 (apply 'vc-hg-command (current-buffer) 0 nil commands)
577 (buffer-substring-no-properties (point-min) (1- (point-max))))
578 'face 'font-lock-variable-name-face)))
580 (defun vc-hg-dir-extra-headers (dir)
581 "Generate extra status headers for a Mercurial tree."
582 (let ((default-directory dir))
583 (concat
584 (vc-hg-dir-extra-header "Root : " "root") "\n"
585 (vc-hg-dir-extra-header "Branch : " "id" "-b") "\n"
586 (vc-hg-dir-extra-header "Tags : " "id" "-t") ; "\n"
587 ;; these change after each commit
588 ;; (vc-hg-dir-extra-header "Local num : " "id" "-n") "\n"
589 ;; (vc-hg-dir-extra-header "Global id : " "id" "-i")
592 (defun vc-hg-log-incoming (buffer remote-location)
593 (vc-hg-command buffer 1 nil "incoming" "-n" (unless (string= remote-location "")
594 remote-location)))
596 (defun vc-hg-log-outgoing (buffer remote-location)
597 (vc-hg-command buffer 1 nil "outgoing" "-n" (unless (string= remote-location "")
598 remote-location)))
600 (declare-function log-view-get-marked "log-view" ())
602 ;; XXX maybe also add key bindings for these functions.
603 (defun vc-hg-push ()
604 (interactive)
605 (let ((marked-list (log-view-get-marked)))
606 (if marked-list
607 (apply #'vc-hg-command
608 nil 0 nil
609 "push"
610 (apply 'nconc
611 (mapcar (lambda (arg) (list "-r" arg)) marked-list)))
612 (error "No log entries selected for push"))))
614 (defvar vc-hg-error-regexp-alist nil
615 ;; 'hg pull' does not list modified files, so, for now, the only
616 ;; benefit of `vc-compilation-mode' is that one can get rid of
617 ;; *vc-hg* buffer with 'q' or 'z'.
618 ;; TODO: call 'hg incoming' before pull/merge to get the list of
619 ;; modified files
620 "Value of `compilation-error-regexp-alist' in *vc-hg* buffers.")
622 (defun vc-hg-pull (prompt)
623 "Issue a Mercurial pull command.
624 If called interactively with a set of marked Log View buffers,
625 call \"hg pull -r REVS\" to pull in the specified revisions REVS.
627 With a prefix argument or if PROMPT is non-nil, prompt for a
628 specific Mercurial pull command. The default is \"hg pull -u\",
629 which fetches changesets from the default remote repository and
630 then attempts to update the working directory."
631 (interactive "P")
632 (let (marked-list)
633 ;; The `vc-hg-pull' command existed before the `pull' VC action
634 ;; was implemented. Keep it for backward compatibility.
635 (if (and (called-interactively-p 'interactive)
636 (setq marked-list (log-view-get-marked)))
637 (apply #'vc-hg-command
638 nil 0 nil
639 "pull"
640 (apply 'nconc
641 (mapcar (lambda (arg) (list "-r" arg))
642 marked-list)))
643 (let* ((root (vc-hg-root default-directory))
644 (buffer (format "*vc-hg : %s*" (expand-file-name root)))
645 (command "pull")
646 (hg-program vc-hg-program)
647 ;; Fixme: before updating the working copy to the latest
648 ;; state, should check if it's visiting an old revision.
649 (args '("-u")))
650 ;; If necessary, prompt for the exact command.
651 (when prompt
652 (setq args (split-string
653 (read-shell-command "Run Hg (like this): "
654 (format "%s pull -u" hg-program)
655 'vc-hg-history)
656 " " t))
657 (setq hg-program (car args)
658 command (cadr args)
659 args (cddr args)))
660 (apply 'vc-do-async-command buffer root hg-program
661 command args)
662 (with-current-buffer buffer (vc-exec-after '(vc-compilation-mode 'hg)))
663 (vc-set-async-update buffer)))))
665 (defun vc-hg-merge-branch ()
666 "Merge incoming changes into the current working directory.
667 This runs the command \"hg merge\"."
668 (let* ((root (vc-hg-root default-directory))
669 (buffer (format "*vc-hg : %s*" (expand-file-name root))))
670 (apply 'vc-do-async-command buffer root vc-hg-program '("merge"))
671 (with-current-buffer buffer (vc-exec-after '(vc-compilation-mode 'hg)))
672 (vc-set-async-update buffer)))
674 ;;; Internal functions
676 (defun vc-hg-command (buffer okstatus file-or-list &rest flags)
677 "A wrapper around `vc-do-command' for use in vc-hg.el.
678 This function differs from vc-do-command in that it invokes
679 `vc-hg-program', and passes `vc-hg-global-switches' to it before FLAGS."
680 (apply 'vc-do-command (or buffer "*vc*") okstatus vc-hg-program file-or-list
681 (if (stringp vc-hg-global-switches)
682 (cons vc-hg-global-switches flags)
683 (append vc-hg-global-switches
684 flags))))
686 (defun vc-hg-root (file)
687 (vc-find-root file ".hg"))
689 (provide 'vc-hg)
691 ;;; vc-hg.el ends here