diff options
| author | Glenn Morris | 2018-01-16 20:56:28 -0500 |
|---|---|---|
| committer | Glenn Morris | 2018-01-16 20:56:28 -0500 |
| commit | 74280624b9b2b964f2b98a00af7aa6a55e7cdf9f (patch) | |
| tree | f55a377c2d7384ef942e2fa30f143424c6fbbf57 | |
| parent | f4e6b6e0771b03855b0772bcbd55a22e8cdda2fe (diff) | |
| download | emacs-74280624b9b2b964f2b98a00af7aa6a55e7cdf9f.tar.gz emacs-74280624b9b2b964f2b98a00af7aa6a55e7cdf9f.zip | |
; * lisp/vc/vc.el: Comment fixes.
| -rw-r--r-- | lisp/vc/vc.el | 30 |
1 files changed, 15 insertions, 15 deletions
diff --git a/lisp/vc/vc.el b/lisp/vc/vc.el index f8d63d1498a..6516c91de3c 100644 --- a/lisp/vc/vc.el +++ b/lisp/vc/vc.el | |||
| @@ -63,15 +63,15 @@ | |||
| 63 | ;; | 63 | ;; |
| 64 | ;; When using SCCS, RCS, CVS: be careful not to do repo surgery, or | 64 | ;; When using SCCS, RCS, CVS: be careful not to do repo surgery, or |
| 65 | ;; operations like registrations and deletions and renames, outside VC | 65 | ;; operations like registrations and deletions and renames, outside VC |
| 66 | ;; while VC is running. The support for these systems was designed | 66 | ;; while VC is running. The support for these systems was designed |
| 67 | ;; when disks were much slower, and the code maintains a lot of | 67 | ;; when disks were much slower, and the code maintains a lot of |
| 68 | ;; internal state in order to reduce expensive operations to a | 68 | ;; internal state in order to reduce expensive operations to a |
| 69 | ;; minimum. Thus, if you mess with the repo while VC's back is turned, | 69 | ;; minimum. Thus, if you mess with the repo while VC's back is turned, |
| 70 | ;; VC may get seriously confused. | 70 | ;; VC may get seriously confused. |
| 71 | ;; | 71 | ;; |
| 72 | ;; When using Subversion or a later system, anything you do outside VC | 72 | ;; When using Subversion or a later system, anything you do outside VC |
| 73 | ;; *through the VCS tools* should safely interlock with VC | 73 | ;; *through the VCS tools* should safely interlock with VC |
| 74 | ;; operations. Under these VC does little state caching, because local | 74 | ;; operations. Under these VC does little state caching, because local |
| 75 | ;; operations are assumed to be fast. | 75 | ;; operations are assumed to be fast. |
| 76 | ;; | 76 | ;; |
| 77 | ;; The 'assumed to be fast' category includes SRC, even though it's | 77 | ;; The 'assumed to be fast' category includes SRC, even though it's |
| @@ -235,7 +235,7 @@ | |||
| 235 | ;; | 235 | ;; |
| 236 | ;; * checkin (files comment &optional rev) | 236 | ;; * checkin (files comment &optional rev) |
| 237 | ;; | 237 | ;; |
| 238 | ;; Commit changes in FILES to this backend. COMMENT is used as a | 238 | ;; Commit changes in FILES to this backend. COMMENT is used as a |
| 239 | ;; check-in comment. The implementation should pass the value of | 239 | ;; check-in comment. The implementation should pass the value of |
| 240 | ;; vc-checkin-switches to the backend command. The optional REV | 240 | ;; vc-checkin-switches to the backend command. The optional REV |
| 241 | ;; revision argument is only supported with some older VCSes, like | 241 | ;; revision argument is only supported with some older VCSes, like |
| @@ -257,7 +257,7 @@ | |||
| 257 | ;; that means to check out the head of the current branch; if it is | 257 | ;; that means to check out the head of the current branch; if it is |
| 258 | ;; the empty string, check out the head of the trunk. The | 258 | ;; the empty string, check out the head of the trunk. The |
| 259 | ;; implementation should pass the value of vc-checkout-switches to | 259 | ;; implementation should pass the value of vc-checkout-switches to |
| 260 | ;; the backend command. The 'editable' argument of older VC versions | 260 | ;; the backend command. The 'editable' argument of older VC versions |
| 261 | ;; is gone; all files are checked out editable. | 261 | ;; is gone; all files are checked out editable. |
| 262 | ;; | 262 | ;; |
| 263 | ;; * revert (file &optional contents-done) | 263 | ;; * revert (file &optional contents-done) |
| @@ -543,8 +543,8 @@ | |||
| 543 | ;;; Changes from the pre-25.1 API: | 543 | ;;; Changes from the pre-25.1 API: |
| 544 | ;; | 544 | ;; |
| 545 | ;; - INCOMPATIBLE CHANGE: The 'editable' optional argument of | 545 | ;; - INCOMPATIBLE CHANGE: The 'editable' optional argument of |
| 546 | ;; vc-checkout is gone. The upper level assumes that all files are | 546 | ;; vc-checkout is gone. The upper level assumes that all files are |
| 547 | ;; checked out editable. This moves closer to emulating modern | 547 | ;; checked out editable. This moves closer to emulating modern |
| 548 | ;; non-locking behavior even on very old VCSes. | 548 | ;; non-locking behavior even on very old VCSes. |
| 549 | ;; | 549 | ;; |
| 550 | ;; - INCOMPATIBLE CHANGE: The vc-register function and its backend | 550 | ;; - INCOMPATIBLE CHANGE: The vc-register function and its backend |
| @@ -577,11 +577,11 @@ | |||
| 577 | ;; only affected back ends were SCCS and RCS. | 577 | ;; only affected back ends were SCCS and RCS. |
| 578 | ;; | 578 | ;; |
| 579 | ;; - vc-stay-local-p and repository-hostname are no longer part | 579 | ;; - vc-stay-local-p and repository-hostname are no longer part |
| 580 | ;; of the public API. The vc-cvs-stay-local configuration variable | 580 | ;; of the public API. The vc-cvs-stay-local configuration variable |
| 581 | ;; remains and only affects the CVS back end. | 581 | ;; remains and only affects the CVS back end. |
| 582 | ;; | 582 | ;; |
| 583 | ;; - The init-revision function and the default-initial-revision | 583 | ;; - The init-revision function and the default-initial-revision |
| 584 | ;; variable are gone. These have't made sense on anything shipped | 584 | ;; variable are gone. These haven't made sense on anything shipped |
| 585 | ;; since RCS, and using them was a dumb stunt even on RCS. | 585 | ;; since RCS, and using them was a dumb stunt even on RCS. |
| 586 | ;; | 586 | ;; |
| 587 | ;; - workfile-unchanged-p is no longer a public back-end method. It | 587 | ;; - workfile-unchanged-p is no longer a public back-end method. It |
| @@ -596,11 +596,11 @@ | |||
| 596 | ;; when set to the (non-default) value nil. The original justification | 596 | ;; when set to the (non-default) value nil. The original justification |
| 597 | ;; for it (saving disk space) is long obsolete. | 597 | ;; for it (saving disk space) is long obsolete. |
| 598 | ;; | 598 | ;; |
| 599 | ;; - The rollback method (implemented by RCS and SCCS only) is gone. See | 599 | ;; - The rollback method (implemented by RCS and SCCS only) is gone. See |
| 600 | ;; the to-do note on uncommit. | 600 | ;; the to-do note on uncommit. |
| 601 | ;; | 601 | ;; |
| 602 | ;; - latest-on-branch-p is no longer a public method. It was to be used | 602 | ;; - latest-on-branch-p is no longer a public method. It was to be used |
| 603 | ;; for implementing rollback. RCS keeps its implementation (the only one) | 603 | ;; for implementing rollback. RCS keeps its implementation (the only one) |
| 604 | ;; for internal use. | 604 | ;; for internal use. |
| 605 | 605 | ||
| 606 | 606 | ||
| @@ -627,7 +627,7 @@ | |||
| 627 | ;; - Make sure the *vc-dir* buffer is updated after merge-branch operations. | 627 | ;; - Make sure the *vc-dir* buffer is updated after merge-branch operations. |
| 628 | ;; | 628 | ;; |
| 629 | ;; - add a generic mechanism for remembering the current branch names, | 629 | ;; - add a generic mechanism for remembering the current branch names, |
| 630 | ;; display the branch name in the mode-line. Replace | 630 | ;; display the branch name in the mode-line. Replace |
| 631 | ;; vc-cvs-sticky-tag with that. | 631 | ;; vc-cvs-sticky-tag with that. |
| 632 | ;; | 632 | ;; |
| 633 | ;; - Add a primitives for switching to a branch (creating it if required. | 633 | ;; - Add a primitives for switching to a branch (creating it if required. |
| @@ -644,7 +644,7 @@ | |||
| 644 | ;; | 644 | ;; |
| 645 | ;; - Second, `log-view-modify-change-comment' doesn't seem to support | 645 | ;; - Second, `log-view-modify-change-comment' doesn't seem to support |
| 646 | ;; modern backends at all because `log-view-extract-comment' | 646 | ;; modern backends at all because `log-view-extract-comment' |
| 647 | ;; unconditionally calls `log-view-current-file'. This should be easy to | 647 | ;; unconditionally calls `log-view-current-file'. This should be easy to |
| 648 | ;; fix. | 648 | ;; fix. |
| 649 | ;; | 649 | ;; |
| 650 | ;; - Third, doing message editing in log-view might be a natural way to go | 650 | ;; - Third, doing message editing in log-view might be a natural way to go |
| @@ -687,7 +687,7 @@ | |||
| 687 | ;; - add a function that calls vc-dir to `find-directory-functions'. | 687 | ;; - add a function that calls vc-dir to `find-directory-functions'. |
| 688 | ;; | 688 | ;; |
| 689 | ;; - vc-diff, vc-annotate, etc. need to deal better with unregistered | 689 | ;; - vc-diff, vc-annotate, etc. need to deal better with unregistered |
| 690 | ;; files. Now that unregistered and ignored files are shown in | 690 | ;; files. Now that unregistered and ignored files are shown in |
| 691 | ;; vc-dir, it is possible that these commands are called | 691 | ;; vc-dir, it is possible that these commands are called |
| 692 | ;; for unregistered/ignored files. | 692 | ;; for unregistered/ignored files. |
| 693 | ;; | 693 | ;; |