Fix indentation of comments, reflow

This commit is contained in:
Tom Willemse 2020-05-13 11:29:35 -07:00
parent 82edcdb262
commit 35beacc3d6
2 changed files with 96 additions and 97 deletions

View file

@ -344,9 +344,9 @@ bound and true."
(defun p4-lowlevel-canonicalize-revision (rev) (defun p4-lowlevel-canonicalize-revision (rev)
"Turn REV into a form which can be concatenated to file names in P4 "Turn REV into a form which can be concatenated to file names in P4
commands." commands."
; There is some ambiguity here, since a number can be either a ;; There is some ambiguity here, since a number can be either a revision
; revision number (#rev) or a change number (@change). We assume ;; number (#rev) or a change number (@change). We assume that a bare number is
; that a bare number is a revision number. ;; a revision number.
(if rev (if rev
(if (eq rev t) (if (eq rev t)
nil nil
@ -358,19 +358,19 @@ commands."
(concat "@" rev) (concat "@" rev)
rev)))))) rev))))))
; Here's what we need to support from the "p4 add" command, at least ;; Here's what we need to support from the "p4 add" command, at least for the
; for the time being: ;; time being:
; ;;
; Do NOT need to support "-c". ;; Do NOT need to support "-c".
; Do NOT need to support "-t". ;; Do NOT need to support "-t".
; Do NOT need to support the specification of multiple files. ;; Do NOT need to support the specification of multiple files.
(defun p4-lowlevel-add (file) (defun p4-lowlevel-add (file)
"Tell Perforce to add FILE to the repository. "Tell Perforce to add FILE to the repository.
Returns nil or raises an error on failure." Returns nil or raises an error on failure."
; Note that because "p4 -s add" has bugs, at least as of p4 99.2, ;; Note that because "p4 -s add" has bugs, at least as of p4 99.2, this won't
; this won't necessarily detect when the add fails, e.g., because of ;; necessarily detect when the add fails, e.g., because of an attempt to add a
; an attempt to add a file which already exists in the repository. ;; file which already exists in the repository.
(p4-lowlevel-command-or-error (list "add" file))) (p4-lowlevel-command-or-error (list "add" file)))
(defun p4-lowlevel-delete (file) (defun p4-lowlevel-delete (file)
@ -378,14 +378,14 @@ Returns nil or raises an error on failure."
Returns nil or raises an error on failure." Returns nil or raises an error on failure."
(p4-lowlevel-command-or-error (list "delete" file))) (p4-lowlevel-command-or-error (list "delete" file)))
; Here's what we need to support from the "p4 change" command, at ;; Here's what we need to support from the "p4 change" command, at least for the
; least for the time being: ;; time being:
; ;;
; Do NOT need to support "-f". ;; Do NOT need to support "-f".
; Do NOT need to support "-d". ;; Do NOT need to support "-d".
; DO need to support "-o". ;; DO need to support "-o".
; DO need to support "-i". ;; DO need to support "-i".
; DO need to support specified changelist #'s. ;; DO need to support specified changelist #'s.
(defun p4-lowlevel-change (&optional buffer op) (defun p4-lowlevel-change (&optional buffer op)
"Creates or edits a P4 changelist from/to BUFFER. "Creates or edits a P4 changelist from/to BUFFER.
@ -440,15 +440,15 @@ value with `-m'; if S-VAL is non-nil, pass that value with `-s'."
(list full-file)) (list full-file))
nil output-format))) nil output-format)))
; Here's what we need to support from the "p4 diff" command, at ;; Here's what we need to support from the "p4 diff" command, at least for the
; least for the time being: ;; time being:
; ;;
; DO need to support "-d<flag>". ;; DO need to support "-d<flag>".
; DO need to support "-f" (in fact, need to specify it all the time). ;; DO need to support "-f" (in fact, need to specify it all the time).
; Do NOT need to support "-s<flag>". ;; Do NOT need to support "-s<flag>".
; DO need to support "-t" (in fact, need to specify it all the time). ;; DO need to support "-t" (in fact, need to specify it all the time).
; DO need to support diffing a single file. ;; DO need to support diffing a single file.
; Do NOT need to support diffing multiple files. ;; Do NOT need to support diffing multiple files.
(defun p4-lowlevel-diff (files &optional rev buffer) (defun p4-lowlevel-diff (files &optional rev buffer)
"Run `p4 diff' on FILE at revision REV and return a buffer "Run `p4 diff' on FILE at revision REV and return a buffer
@ -486,13 +486,13 @@ return a list of the matching files."
(format "-s%s" flag) (format "-s%s" flag)
file)))) file))))
; Here's what we need to support from the "p4 diff2" command, at least ;; Here's what we need to support from the "p4 diff2" command, at least for the
; for the time being: ;; time being:
; ;;
; DO need to support "-d<flag>". ;; DO need to support "-d<flag>".
; Do NOT need to support "-q". ;; Do NOT need to support "-q".
; DO need to support "-t" (in fact, need to specify it all the time). ;; DO need to support "-t" (in fact, need to specify it all the time).
; Do NOT need to support "-b". ;; Do NOT need to support "-b".
(defun p4-lowlevel-diff2 (file1 file2 &optional rev1 rev2 buffer) (defun p4-lowlevel-diff2 (file1 file2 &optional rev1 rev2 buffer)
"Run `p4 diff2' on FILE and FILE2 and return a buffer containing the "Run `p4 diff2' on FILE and FILE2 and return a buffer containing the
@ -510,25 +510,25 @@ optional BUFFER is non-nil, output goes in that buffer. Uses
(or buffer "diff")))) (or buffer "diff"))))
buffer)) buffer))
; Here's what we need to support from the "p4 edit" command, at least ;; Here's what we need to support from the "p4 edit" command, at least for the
; for the time being: ;; time being:
; ;;
; Do NOT need to support "-c". ;; Do NOT need to support "-c".
; Do NOT need to support "-t". ;; Do NOT need to support "-t".
; Do NOT need to support the specification of multiple files. ;; Do NOT need to support the specification of multiple files.
(defun p4-lowlevel-edit (file) (defun p4-lowlevel-edit (file)
"Tell Perforce we want to edit FILE. "Tell Perforce we want to edit FILE.
Returns non-nil on success or nil on failure (or raises an error)." Returns non-nil on success or nil on failure (or raises an error)."
(p4-lowlevel-command-or-error (list "edit" file))) (p4-lowlevel-command-or-error (list "edit" file)))
; Here's what we need to support from the "p4 filelog" command, at ;; Here's what we need to support from the "p4 filelog" command, at least for
; least for the time being: ;; the time being:
; ;;
; DO need to support "-i". ;; DO need to support "-i".
; DO need to support "-l". ;; DO need to support "-l".
; Do NOT need to support "-m". ;; Do NOT need to support "-m".
; Do NOT need to support the specification of multiple files. ;; Do NOT need to support the specification of multiple files.
(defun p4-lowlevel-filelog (file &optional buffer long follow-branches limit) (defun p4-lowlevel-filelog (file &optional buffer long follow-branches limit)
"Fetch the p4 log of FILE and return a buffer containing it. "Fetch the p4 log of FILE and return a buffer containing it.
@ -547,11 +547,11 @@ last LIMIT log entries."
"Fetch the string returned by running `p4 opened' on FILE." "Fetch the string returned by running `p4 opened' on FILE."
(p4-lowlevel-command-or-error (list "opened" file) nil 'string)) (p4-lowlevel-command-or-error (list "opened" file) nil 'string))
; Here's what we need to support from the "p4 fstat" command, at least ;; Here's what we need to support from the "p4 fstat" command, at least for the
; for the time being: ;; time being:
; ;;
; Do NOT need to support any command-line switches. ;; Do NOT need to support any command-line switches.
; Do NOT need to support the specification of multiple files. ;; Do NOT need to support the specification of multiple files.
(defun p4-lowlevel-fstat (file &optional rev noerror) (defun p4-lowlevel-fstat (file &optional rev noerror)
"Fetch p4 information about FILE (optionally, at REV). "Fetch p4 information about FILE (optionally, at REV).
@ -614,13 +614,13 @@ QUIET is non-nil, then the `-q' flag is passed to `p4 print'."
(args (append (list "print") quiet-args (list fullfile)))) (args (append (list "print") quiet-args (list fullfile))))
(p4-lowlevel-command-or-error args nil output-format))) (p4-lowlevel-command-or-error args nil output-format)))
; Here's what we need to support from the "p4 reopen" command, at ;; Here's what we need to support from the "p4 reopen" command, at least for the
; least for the time being: ;; time being:
; ;;
; DO need to support "-c changelist#", so that we can reopen a file in ;; DO need to support "-c changelist#", so that we can reopen a file in
; the default changelist before submitting it. ;; the default changelist before submitting it.
; Do NOT need to support "-t". ;; Do NOT need to support "-t".
; Do NOT need to support the specification of multiple files. ;; Do NOT need to support the specification of multiple files.
(defun p4-lowlevel-reopen (file &optional changelist) (defun p4-lowlevel-reopen (file &optional changelist)
"Call `p4 reopen' on FILE. "Call `p4 reopen' on FILE.
@ -629,16 +629,16 @@ Optional CHANGELIST specifies the changelist to which to move it."
(if changelist (list "-c" changelist) nil) (if changelist (list "-c" changelist) nil)
(list file)))) (list file))))
; Here's what we need to support from the "p4 resolve" command, at ;; Here's what we need to support from the "p4 resolve" command, at least for
; least for the time being: ;; the time being:
; ;;
; DO need to support "-af" (in fact, need to specify it all the time). ;; DO need to support "-af" (in fact, need to specify it all the time).
; Do NOT need to support "-am", "-as", "-at", "-ay". ;; Do NOT need to support "-am", "-as", "-at", "-ay".
; Do NOT need to support "-f". ;; Do NOT need to support "-f".
; Do NOT need to support "-n". ;; Do NOT need to support "-n".
; DO need to support "-t" (in fact, need to specify it all the time). ;; DO need to support "-t" (in fact, need to specify it all the time).
; Do NOT need to support "-v". ;; Do NOT need to support "-v".
; Do NOT need to support the specification of multiple files. ;; Do NOT need to support the specification of multiple files.
(defun p4-lowlevel-resolve (file) (defun p4-lowlevel-resolve (file)
"Call `p4 resolve' on FILE. "Call `p4 resolve' on FILE.
@ -646,22 +646,22 @@ Specifies the `-af' and `-t' options to ensure a non-interactive
resolve. Raises an error if the command fails." resolve. Raises an error if the command fails."
(p4-lowlevel-command-or-error (list "resolve" "-af" "-t" file))) (p4-lowlevel-command-or-error (list "resolve" "-af" "-t" file)))
; Here's what we need to support from the "p4 revert" command, at ;; Here's what we need to support from the "p4 revert" command, at least for the
; least for the time being: ;; time being:
; ;;
; Do NOT need to support "-a". ;; Do NOT need to support "-a".
; Do NOT need to support "-c". ;; Do NOT need to support "-c".
; Do NOT need to support the specification of multiple files. ;; Do NOT need to support the specification of multiple files.
(defun p4-lowlevel-revert (file) (defun p4-lowlevel-revert (file)
"Tell Perforce to unedit FILE." "Tell Perforce to unedit FILE."
(p4-lowlevel-command-or-error (list "revert" file))) (p4-lowlevel-command-or-error (list "revert" file)))
; Here's what we need to support from the "p4 submit" command, at ;; Here's what we need to support from the "p4 submit" command, at least for the
; least for the time being: ;; time being:
; ;;
; Only need to support non-interactive use; therefore, only need to ;; Only need to support non-interactive use; therefore, only need to
; support "p4 submit -i". ;; support "p4 submit -i".
(defun p4-lowlevel-submit (change-spec) (defun p4-lowlevel-submit (change-spec)
"Calls `p4 submit' on CHANGE-SPEC, which should be a string or buffer." "Calls `p4 submit' on CHANGE-SPEC, which should be a string or buffer."
@ -676,13 +676,13 @@ resolve. Raises an error if the command fails."
(insert change-spec))) (insert change-spec)))
(p4-lowlevel-command-or-error (list "submit" "-i") buffer))) (p4-lowlevel-command-or-error (list "submit" "-i") buffer)))
; Here's what we need to support from the "p4 sync" command, at least ;; Here's what we need to support from the "p4 sync" command, at least for the
; for the time being: ;; time being:
; ;;
; DO need to support "-f". ;; DO need to support "-f".
; Do NOT need to support "-n". ;; Do NOT need to support "-n".
; DO need to support the specification of a file revision. ;; DO need to support the specification of a file revision.
; Do NOT need to support the specification of multiple files. ;; Do NOT need to support the specification of multiple files.
(defun p4-lowlevel-sync (file &optional rev force) (defun p4-lowlevel-sync (file &optional rev force)
"Call `p4 sync' for FILE. "Call `p4 sync' for FILE.

View file

@ -72,8 +72,8 @@
(if (not (memq 'P4 vc-handled-backends)) (if (not (memq 'P4 vc-handled-backends))
(setq vc-handled-backends (cons 'P4 vc-handled-backends))) (setq vc-handled-backends (cons 'P4 vc-handled-backends)))
; This is useful during development to ensure that we can simply ;; This is useful during development to ensure that we can simply reeval this
; reeval this buffer to get any new functions that have been added. ;; buffer to get any new functions that have been added.
(put 'P4 'vc-functions nil) (put 'P4 'vc-functions nil)
(defcustom vc-p4-require-p4config nil (defcustom vc-p4-require-p4config nil
@ -382,9 +382,8 @@ comment COMMENT."
"Steal Perforce lock on FILE." "Steal Perforce lock on FILE."
(if (and version (not (equal version (vc-workfile-version file)))) (if (and version (not (equal version (vc-workfile-version file))))
(error "Can't specify version when stealing Perforce lock.")) (error "Can't specify version when stealing Perforce lock."))
; Must set default-directory because this is called in a mail send ;; Must set default-directory because this is called in a mail send hook and
; hook and thus not with the current buffer set to the file being ;; thus not with the current buffer set to the file being reopened.
; reopened.
(let ((default-directory (file-name-directory file))) (let ((default-directory (file-name-directory file)))
(p4-lowlevel-reopen file))) (p4-lowlevel-reopen file)))
@ -660,9 +659,9 @@ Optional arg VERSION is a version to annotate from."
"\\s-+on\\s-+" "\\([^ \t]+\\)" ;; date "\\s-+on\\s-+" "\\([^ \t]+\\)" ;; date
"\\s-+by\\s-+" "\\([^ \t]+\\)" ;; author "\\s-+by\\s-+" "\\([^ \t]+\\)" ;; author
"@")) "@"))
head-name ;; file spec of the head revision for this blame assignment head-name ; file spec of the head revision for this blame assignment
branch-p ;; have we tracked into a branch? branch-p ; have we tracked into a branch?
cur-file ;; file name of the current branch during blame assignment cur-file ; file name of the current branch during blame assignment
change ch-alist fullname head-rev headseen) change ch-alist fullname head-rev headseen)
;; we asked for blame constrained by a change number ;; we asked for blame constrained by a change number