[Emacs-diffs] trunk r116175: Small doc updates for CUA and dired

[Glenn Morris]

------------------------------------------------------------
revno: 116175
revision-id: address@hidden
parent: address@hidden
committer: Glenn Morris <address@hidden>
branch nick: trunk
timestamp: Mon 2014-01-27 16:26:48 -0500
message:
  Small doc updates for CUA and dired
  
  * doc/emacs/dired.texi (Misc Dired Features): Copyedits for hide-details.
  
  * lisp/dired.el (dired-hide-details-hide-symlink-targets)
  (dired-hide-details-hide-information-lines)
  (dired-hide-details-mode): Doc fixes.
  
  * lisp/emulation/cua-base.el (cua-mode): Doc fix.
  
  * etc/NEWS: Related edits.
  
  * lisp/ChangeLog: Comment changes do not need ChangeLog entries.
modified:
  doc/emacs/ChangeLog            changelog-20091113204419-o5vbwnq5f7feedwu-6227
  doc/emacs/dired.texi           dired.texi-20091113204419-o5vbwnq5f7feedwu-6242
  etc/NEWS                       news-20100311060928-aoit31wvzf25yr1z-1
  lisp/ChangeLog                 changelog-20091113204419-o5vbwnq5f7feedwu-1432
  lisp/dired.el                  dired.el-20091113204419-o5vbwnq5f7feedwu-482
  lisp/emulation/cua-base.el     cuabase.el-20091113204419-o5vbwnq5f7feedwu-2415

=== modified file 'doc/emacs/ChangeLog'
--- a/doc/emacs/ChangeLog       2014-01-27 02:03:26 +0000
+++ b/doc/emacs/ChangeLog       2014-01-27 21:26:48 +0000
@@ -1,5 +1,7 @@
 2014-01-27  Glenn Morris  <address@hidden>
 
+       * dired.texi (Misc Dired Features): Copyedits for hide-details.
+
        * buffers.texi (List Buffers): Tiny edit.
 
        * calendar.texi (Time Intervals): Update for files in ~/.emacs.d/.

=== modified file 'doc/emacs/dired.texi'
--- a/doc/emacs/dired.texi      2014-01-10 02:30:51 +0000
+++ b/doc/emacs/dired.texi      2014-01-27 21:26:48 +0000
@@ -1382,7 +1382,7 @@
 a regular expression search.  @xref{Repeat Isearch}, for information
 about search repetition.
 
address@hidden Adding to the kill ring in Dired.
address@hidden adding to the kill ring in Dired
 @kindex w @r{(Dired)}
 @findex dired-copy-filename-as-kill
   The command @kbd{w} (@code{dired-copy-filename-as-kill}) puts the
@@ -1403,6 +1403,19 @@
 it added to the kill ring, so you can use it to display the list of
 currently marked files in the echo area.
 
address@hidden ( @r{(Dired)}
address@hidden dired-hide-details-mode
address@hidden dired-hide-details-hide-symlink-targets
address@hidden dired-hide-details-hide-information-lines
address@hidden hiding details in Dired
+  The command @kbd{(} (@code{dired-hide-details-mode}) toggles whether
+details, such as ownership or file permissions, are visible in the
+current Dired buffer.  By default, it also hides the targets of
+symbolic links, and all lines other than the header line and
+file/directory listings.  To change this, customize the options
address@hidden and
address@hidden, respectively.
+
 @cindex Dired and version control
   If the directory you are visiting is under version control
 (@pxref{Version Control}), then the normal VC diff and log commands
@@ -1440,18 +1453,3 @@
 to the file in that directory.  Precisely which action is taken is
 determined by the originating program.  Dragging files out of a Dired
 buffer is currently not supported.
-
address@hidden ( @r{(Dired)}
address@hidden )
address@hidden dired-hide-details-mode
address@hidden dired-hide-details-hide-symlink-targets
address@hidden dired-hide-details-hide-information-lines
address@hidden Hide details in Dired.
-  The command @kbd{(} (@code{dired-hide-details-mode}) toggles whether
-details, such as ownership or file permissions, are hidden.  If the
-variable @code{dired-hide-details-hide-symlink-targets} is
address@hidden then targets of symbolic links are hidden as well.  A
address@hidden value for the variable
address@hidden means that all lines
-other than the header and lines containing files and directories are
-hidden.

=== modified file 'etc/NEWS'
--- a/etc/NEWS  2014-01-27 19:56:13 +0000
+++ b/etc/NEWS  2014-01-27 21:26:48 +0000
@@ -432,6 +432,7 @@
 Hence, you can now enable it independently from `transient-mark-mode',
 `delete-selection-mode', and `shift-select-mode'.
 
+---
 *** `cua-highlight-region-shift-only' is now obsolete.
 You can disable `transient-mark-mode' to get the same result.
 
@@ -458,9 +459,8 @@
 and `desktop-restore-forces-onscreen' offer further customization.
 
 +++
-** Dired
-
-*** New minor mode `dired-hide-details-mode' hides details.
+** New Dired minor mode `dired-hide-details-mode' toggles whether details,
+such as file ownership or permissions, are visible.
 
 ** Eldoc Mode works properly in the minibuffer.
 

=== modified file 'lisp/ChangeLog'
--- a/lisp/ChangeLog    2014-01-27 12:30:17 +0000
+++ b/lisp/ChangeLog    2014-01-27 21:26:48 +0000
@@ -1,10 +1,11 @@
-2014-01-27  Reuben Thomas  <address@hidden>
-
-       * whitespace.el (whitespace-enable-predicate): fix sense of comment.
-       Fixes bug #16564, from change of 2013-03-10.
-
 2014-01-27  Glenn Morris  <address@hidden>
 
+       * emulation/cua-base.el (cua-mode): Doc fix.
+
+       * dired.el (dired-hide-details-hide-symlink-targets)
+       (dired-hide-details-hide-information-lines)
+       (dired-hide-details-mode): Doc fixes.
+
        * shadowfile.el (shadow-info-file, shadow-todo-file): Doc fix.
        * strokes.el (strokes-file): Doc fix.  Bump :version.
        (strokes-help): Doc fix.

=== modified file 'lisp/dired.el'
--- a/lisp/dired.el     2014-01-12 11:24:16 +0000
+++ b/lisp/dired.el     2014-01-27 21:26:48 +0000
@@ -241,13 +241,13 @@
   :group 'dired)
 
 (defcustom dired-hide-details-hide-symlink-targets t
-  "If non-nil, `dired-hide-details-mode' hides symbolic link targets."
+  "Non-nil means `dired-hide-details-mode' hides symbolic link targets."
   :type 'boolean
   :version "24.4"
   :group 'dired)
 
 (defcustom dired-hide-details-hide-information-lines t
-  "Non-nil means hide lines other than header and file/dir lines."
+  "Non-nil means `dired-hide-details-mode' hides all but header and file 
lines."
   :type 'boolean
   :version "24.4"
   :group 'dired)
@@ -2267,10 +2267,14 @@
       (substring file (match-end 0))
     file))
 
-;;; Minor mode for hiding details
 ;;;###autoload
 (define-minor-mode dired-hide-details-mode
-  "Hide details in Dired mode."
+  "Toggle visibility of detailed information in current Dired buffer.
+When this minor mode is enabled, details such as file ownership and
+permissions are hidden from view.
+
+See options: `dired-hide-details-hide-symlink-targets' and
+`dired-hide-details-hide-information-lines'."
   :group 'dired
   (unless (derived-mode-p 'dired-mode)
     (error "Not a Dired buffer"))

=== modified file 'lisp/emulation/cua-base.el'
--- a/lisp/emulation/cua-base.el        2014-01-01 07:43:34 +0000
+++ b/lisp/emulation/cua-base.el        2014-01-27 21:26:48 +0000
@@ -1426,12 +1426,7 @@
 
 You can customize `cua-enable-cua-keys' to completely disable the
 CUA bindings, or `cua-prefix-override-inhibit-delay' to change
-the prefix fallback behavior.
-
-CUA mode manages Transient Mark mode internally.  Trying to disable
-Transient Mark mode while CUA mode is enabled does not work; if you
-only want to highlight the region when it is selected using a
-shifted movement key, set `cua-highlight-region-shift-only'."
+the prefix fallback behavior."
   :global t
   :group 'cua
   :set-after '(cua-enable-modeline-indications