aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorGlenn Morris2018-01-16 20:56:28 -0500
committerGlenn Morris2018-01-16 20:56:28 -0500
commit74280624b9b2b964f2b98a00af7aa6a55e7cdf9f (patch)
treef55a377c2d7384ef942e2fa30f143424c6fbbf57
parentf4e6b6e0771b03855b0772bcbd55a22e8cdda2fe (diff)
downloademacs-74280624b9b2b964f2b98a00af7aa6a55e7cdf9f.tar.gz
emacs-74280624b9b2b964f2b98a00af7aa6a55e7cdf9f.zip
; * lisp/vc/vc.el: Comment fixes.
-rw-r--r--lisp/vc/vc.el30
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;;