vc-toggle-read-only is no longer a good idea.

diff --git a/doc/emacs/ChangeLog b/doc/emacs/ChangeLog
index 14a25643dfe41b73094f499e840105abdb3bb382..5453df460d890aff8e187a3972aa4365a0472dff 100644 (file)
--- a/doc/emacs/ChangeLog
+++ b/doc/emacs/ChangeLog
@@ -1,3 +1,8 @@
+2008-05-02  Eric S. Raymond  <esr@snark.thyrsus.com>
+
+       * emacs/buffers.texi, emacs/files.texi (Version-control):
+       vc-toggle-read-only is no longer a good idea...
+
 2008-04-29  Glenn Morris  <rgm@gnu.org>
 
        * cal-xtra.texi (Sexp Diary Entries): Clarify diary-float.

diff --git a/doc/emacs/buffers.texi b/doc/emacs/buffers.texi
index 0cb4f596d9cada2150ed6350bb0b85ebd6ef8c04..4d8fa5ad51e0cececc97f1936ebda2a86859373d 100644 (file)
--- a/doc/emacs/buffers.texi
+++ b/doc/emacs/buffers.texi
@@ -239,9 +239,8 @@ works by setting the variable @code{buffer-read-only}, which has a local
 value in each buffer and makes the buffer read-only if its value is
 non-@code{nil}.  If you have files under version control, you may find
 it convenient to bind @kbd{C-x C-q} to @code{vc-toggle-read-only}
-instead.  Then, typing @kbd{C-x C-q} not only changes the read-only
-flag, but it also checks the file in or out.  @xref{Version
-Control}.
+instead.  This will guard you against an operation that will confuse
+most modern version-conmtrol systems. @xref{Version Control}.
 
 @findex rename-buffer
   @kbd{M-x rename-buffer} changes the name of the current buffer.  You

diff --git a/doc/emacs/files.texi b/doc/emacs/files.texi
index 1199573cc0554e8bae4e25aaeb397f9d05055cbd..93883e847eee788555567209935720fced212745 100644 (file)
--- a/doc/emacs/files.texi
+++ b/doc/emacs/files.texi
@@ -1664,15 +1664,6 @@ RCS normally use locking; CVS and Subversion normally use
 merging but can be configured to do locking.  Later systems such as 
 GNU Arch and Mercurial always use merging.
 
-@findex vc-toggle-read-only
-@kindex C-x C-q @r{(Version Control)}
-  As a special convenience that is particularly useful for files with
-locking, you can let Emacs check a file in or out whenever you change
-its read-only flag.  This means, for example, that you cannot
-accidentally edit a file without properly checking it out first.  To
-achieve this, bind the key @kbd{C-x C-q} to @kbd{vc-toggle-read-only}
-in your @file{~/.emacs} file.  (@xref{Init Rebinding}.)
-
 @node VC With A Locking VCS
 @subsubsection Basic Version Control with Locking