[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Emacs-diffs] /srv/bzr/emacs/trunk r110159: Doc updates for read-only-mo
From: |
Chong Yidong |
Subject: |
[Emacs-diffs] /srv/bzr/emacs/trunk r110159: Doc updates for read-only-mode. |
Date: |
Sun, 23 Sep 2012 18:46:50 +0800 |
User-agent: |
Bazaar (2.5.0) |
------------------------------------------------------------
revno: 110159
committer: Chong Yidong <address@hidden>
branch nick: trunk
timestamp: Sun 2012-09-23 18:46:50 +0800
message:
Doc updates for read-only-mode.
* buffers.texi (Misc Buffer): Replace toggle-read-only with
read-only-mode.
* files.texi (Visiting): Likewise.
* backups.texi (Auto-Saving): Refer to Minor Mode Conventions for
calling conventions.
* buffers.texi (Read Only Buffers): Document read-only-mode.
* keymaps.texi (Alias Menu Items): Replace toggle-read-only with
read-only-mode.
modified:
doc/emacs/ChangeLog
doc/emacs/buffers.texi
doc/emacs/files.texi
doc/lispref/ChangeLog
doc/lispref/backups.texi
doc/lispref/buffers.texi
doc/lispref/keymaps.texi
etc/NEWS
=== modified file 'doc/emacs/ChangeLog'
--- a/doc/emacs/ChangeLog 2012-09-22 19:27:25 +0000
+++ b/doc/emacs/ChangeLog 2012-09-23 10:46:50 +0000
@@ -1,3 +1,10 @@
+2012-09-23 Chong Yidong <address@hidden>
+
+ * buffers.texi (Misc Buffer): Replace toggle-read-only with
+ read-only-mode.
+
+ * files.texi (Visiting): Likewise.
+
2012-09-22 Paul Eggert <address@hidden>
* trouble.texi (Crashing): Document ulimit -c.
=== modified file 'doc/emacs/buffers.texi'
--- a/doc/emacs/buffers.texi 2012-07-13 07:06:09 +0000
+++ b/doc/emacs/buffers.texi 2012-09-23 10:46:50 +0000
@@ -212,7 +212,7 @@
@table @kbd
@item C-x C-q
-Toggle read-only status of buffer (@code{toggle-read-only}).
+Toggle read-only status of buffer (@code{read-only-mode}).
@item M-x rename-buffer @key{RET} @var{name} @key{RET}
Change the name of the current buffer.
@item M-x rename-uniquely
@@ -231,9 +231,9 @@
have special commands to operate on the text; also by visiting a file
whose access control says you cannot write it.
address@hidden toggle-read-only
address@hidden read-only-mode
@vindex view-read-only
- The command @kbd{C-x C-q} (@code{toggle-read-only}) makes a read-only
+ The command @kbd{C-x C-q} (@code{read-only-mode}) makes a read-only
buffer writable, and makes a writable buffer read-only. This 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
=== modified file 'doc/emacs/files.texi'
--- a/doc/emacs/files.texi 2012-06-17 05:13:40 +0000
+++ b/doc/emacs/files.texi 2012-09-23 10:46:50 +0000
@@ -246,7 +246,7 @@
or that is marked read-only, Emacs makes the buffer read-only too, so
that you won't go ahead and make changes that you'll have trouble
saving afterward. You can make the buffer writable with @kbd{C-x C-q}
-(@code{toggle-read-only}). @xref{Misc Buffer}.
+(@code{read-only-mode}). @xref{Misc Buffer}.
@kindex C-x C-r
@findex find-file-read-only
=== modified file 'doc/lispref/ChangeLog'
--- a/doc/lispref/ChangeLog 2012-09-22 15:24:26 +0000
+++ b/doc/lispref/ChangeLog 2012-09-23 10:46:50 +0000
@@ -1,3 +1,13 @@
+2012-09-23 Chong Yidong <address@hidden>
+
+ * buffers.texi (Read Only Buffers): Document read-only-mode.
+
+ * keymaps.texi (Alias Menu Items): Replace toggle-read-only with
+ read-only-mode.
+
+ * backups.texi (Auto-Saving): Refer to Minor Mode Conventions for
+ calling conventions.
+
2012-09-22 Chong Yidong <address@hidden>
* searching.texi (Replacing Match): Minor clarification.
=== modified file 'doc/lispref/backups.texi'
--- a/doc/lispref/backups.texi 2012-05-27 01:34:14 +0000
+++ b/doc/lispref/backups.texi 2012-09-23 10:46:50 +0000
@@ -441,12 +441,14 @@
@end defvar
@deffn Command auto-save-mode arg
-When used interactively without an argument, this command is a toggle
-switch: it turns on auto-saving of the current buffer if it is off,
-and vice versa. When called from Lisp with no argument, it turns
-auto-saving on. With an argument @var{arg}, it turns auto-saving on
-if the value of @var{arg} is @code{t}, a nonempty list, or a positive
-integer; otherwise, it turns auto-saving off.
+This is the mode command for Auto Save mode, a buffer-local minor
+mode. When Auto Save mode is enabled, auto-saving is enabled in the
+buffer. The calling convention is the same as for other minor mode
+commands (@pxref{Minor Mode Conventions}).
+
+Unlike most minor modes, there is no @code{auto-save-mode} variable.
+Auto Save mode is enabled if @code{buffer-auto-save-file-name} is
address@hidden and @code{buffer-saved-size} (see below) is non-zero.
@end deffn
@defun auto-save-file-name-p filename
=== modified file 'doc/lispref/buffers.texi'
--- a/doc/lispref/buffers.texi 2012-07-13 07:06:09 +0000
+++ b/doc/lispref/buffers.texi 2012-09-23 10:46:50 +0000
@@ -740,31 +740,25 @@
of the list (comparison is done with @code{eq}).
@end defvar
address@hidden Command toggle-read-only &optional arg message
-This command toggles whether the current buffer is read-only, by
-setting the variable @code{buffer-read-only}. If @var{arg} is
address@hidden, it should be a raw prefix argument; the command then
-makes the buffer read-only if the numeric value of that prefix
-argument is positive, and makes the buffer writable otherwise.
address@hidden Command Arguments}.
-
-If called interactively, or if called from Lisp with @var{message} is
address@hidden, the command prints a message reporting the buffer's
-new read-only status.
-
-When making the buffer read-only, this command also enables View mode
address@hidden Command read-only-mode &optional arg
+This is the mode command for Read Only minor mode, a buffer-local
+minor mode. When the mode is enabled, @code{buffer-read-only} is
address@hidden in the buffer; when disabled, @code{buffer-read-only}
+is @code{nil} in the buffer. The calling convention is the same as
+for other minor mode commands (@pxref{Minor Mode Conventions}).
+
+This minor mode mainly serves as a wrapper for
address@hidden; unlike most minor modes, there is no separate
address@hidden variable. Even when Read Only mode is disabled,
+characters with address@hidden @code{read-only} text properties remain
+read-only. To temporarily ignore all read-only states, bind
address@hidden, as described above.
+
+When enabling Read Only mode, this mode command also enables View mode
if the option @code{view-read-only} is address@hidden @xref{Misc
Buffer,,Miscellaneous Buffer Operations, emacs, The GNU Emacs Manual}.
-When making the buffer writable, it disables View mode if View mode
-was enabled.
-
-Lisp programs should only call @code{toggle-read-only} if they really
-intend to do the same thing as the user command, including possibly
-enabling or disabling View mode. Note also that this command works by
-setting @code{buffer-read-only}, so even if you make the buffer
-writable, characters with address@hidden @code{read-only} text
-properties will remain read-only. To temporarily ignore all read-only
-states, bind @code{inhibit-read-only}, as described above.
+When disabling Read Only mode, it disables View mode if View mode was
+enabled.
@end deffn
@defun barf-if-buffer-read-only
=== modified file 'doc/lispref/keymaps.texi'
--- a/doc/lispref/keymaps.texi 2012-08-04 14:33:00 +0000
+++ b/doc/lispref/keymaps.texi 2012-09-23 10:46:50 +0000
@@ -2288,12 +2288,12 @@
in Emacs now is with extended menu items; before that feature existed,
it could be done by defining alias commands and using them in menu
items. Here's an example that makes two aliases for
address@hidden and gives them different enable conditions:
address@hidden and gives them different enable conditions:
@example
-(defalias 'make-read-only 'toggle-read-only)
+(defalias 'make-read-only 'read-only-mode)
(put 'make-read-only 'menu-enable '(not buffer-read-only))
-(defalias 'make-writable 'toggle-read-only)
+(defalias 'make-writable 'read-only-mode)
(put 'make-writable 'menu-enable 'buffer-read-only)
@end example
@@ -2310,7 +2310,7 @@
@noindent
causes menu items for @code{make-read-only} and @code{make-writable} to
-show the keyboard bindings for @code{toggle-read-only}.
+show the keyboard bindings for @code{read-only-mode}.
@node Toolkit Differences
@subsubsection Toolkit Differences
=== modified file 'etc/NEWS'
--- a/etc/NEWS 2012-09-22 17:19:28 +0000
+++ b/etc/NEWS 2012-09-23 10:46:50 +0000
@@ -94,7 +94,7 @@
next and previous path separator, respectively.
** Mode line changes
-
+---
*** New option `mode-line-default-help-echo' specifies the help text
(shown in a tooltip or in the echo area) for any part of the mode line
that does not have its own specialized help text.
@@ -143,6 +143,7 @@
** In the Package Menu, newly-available packages are listed as "new",
and sorted above the other "available" packages by default.
++++
** `C-x C-q' is now bound to the new minor mode `read-only-mode'.
This minor mode replaces `toggle-read-only', which is now obsolete.
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [Emacs-diffs] /srv/bzr/emacs/trunk r110159: Doc updates for read-only-mode.,
Chong Yidong <=