Minor doc updates related to dribble files

* doc/emacs/trouble.texi (Checklist):
* doc/lispref/os.texi (Recording Input): Dribble files may contain passwords.

* lisp/help.el (view-lossage): Doc tweak.

* src/keyboard.c (Fopen_dribble_file): Doc tweak.

diff --git a/doc/emacs/ChangeLog b/doc/emacs/ChangeLog
index c05814248336cd1eb7767e6276bb420e40afe055..56daee101014ae9d166ca1b5b9b4d88a9fafc17c 100644 (file)
--- a/doc/emacs/ChangeLog
+++ b/doc/emacs/ChangeLog
@@ -1,3 +1,7 @@
+2014-04-05  Glenn Morris  <rgm@gnu.org>
+
+       * trouble.texi (Checklist): Dribble files may contain passwords.
+
 2014-04-04  Glenn Morris  <rgm@gnu.org>
 
        * files.texi (Backup Names):

diff --git a/doc/emacs/trouble.texi b/doc/emacs/trouble.texi
index e7bff6c28a4fe8f74943e2481be462fc5d0efb14..52e5b9c404523fd339b927a72b733f74f64ef62b 100644 (file)
--- a/doc/emacs/trouble.texi
+++ b/doc/emacs/trouble.texi
@@ -759,7 +759,9 @@ customizations.
 One way to record the input to Emacs precisely is to write a dribble
 file.  To start the file, use the @kbd{M-x open-dribble-file
 @key{RET}} command.  From then on, Emacs copies all your input to the
-specified dribble file until the Emacs process is killed.
+specified dribble file until the Emacs process is killed.  Be aware
+that sensitive information (such as passwords) may end up recorded in
+the dribble file.
 
 @item
 @findex open-termscript

diff --git a/doc/lispref/ChangeLog b/doc/lispref/ChangeLog
index 1fb664893f889f5a6fd2bd821bf98eef772570b5..b31398fffc4b47c2ffaa6ae2bd44c21adb970ccd 100644 (file)
--- a/doc/lispref/ChangeLog
+++ b/doc/lispref/ChangeLog
@@ -1,3 +1,7 @@
+2014-04-05  Glenn Morris  <rgm@gnu.org>
+
+       * os.texi (Recording Input): Dribble files may contain passwords.
+
 2014-04-04  Glenn Morris  <rgm@gnu.org>
 
        * backups.texi (Making Backups, Reverting):

diff --git a/doc/lispref/os.texi b/doc/lispref/os.texi
index df30ac12e2e6fc04a60cbb2c06591e758463a62a..c80dfda096c8e427c348dccedf7473408b61db2a 100644 (file)
--- a/doc/lispref/os.texi
+++ b/doc/lispref/os.texi
@@ -1991,20 +1991,11 @@ This function opens a @dfn{dribble file} named @var{filename}.  When a
 dribble file is open, each input event from the keyboard or mouse (but
 not those from keyboard macros) is written in that file.  A
 non-character event is expressed using its printed representation
-surrounded by @samp{<@dots{}>}.
+surrounded by @samp{<@dots{}>}.  Be aware that sensitive information
+(such as passwords) may end up recorded in the dribble file.
 
 You close the dribble file by calling this function with an argument
 of @code{nil}.
-
-This function is normally used to record the input necessary to
-trigger an Emacs bug, for the sake of a bug report.
-
-@example
-@group
-(open-dribble-file "~/dribble")
-     @result{} nil
-@end group
-@end example
 @end deffn
 
   See also the @code{open-termscript} function (@pxref{Terminal Output}).

diff --git a/lisp/ChangeLog b/lisp/ChangeLog
index 71f3749a19cc0fd1dd4167fe47e7a97897bb6211..2084cbbb7b62af664a4c0c424d24e085c4404712 100644 (file)
--- a/lisp/ChangeLog
+++ b/lisp/ChangeLog
@@ -1,3 +1,7 @@
+2014-04-05  Glenn Morris  <rgm@gnu.org>
+
+       * help.el (view-lossage): Doc tweak.
+
 2014-04-05  Matthias Dahl  <ml_emacs-lists@binary-island.eu>
 
        * faces.el (face-spec-recalc): Call make-face-x-resource-internal

diff --git a/lisp/help.el b/lisp/help.el
index 14dda6456cf3981b861471aa0aded0d710933958..fdbf91f7dbdffbee4f6ff1fd6f0aa59330c3c11f 100644 (file)
--- a/lisp/help.el
+++ b/lisp/help.el
@@ -1,7 +1,6 @@
 ;;; help.el --- help commands for Emacs
 
-;; Copyright (C) 1985-1986, 1993-1994, 1998-2014 Free Software
-;; Foundation, Inc.
+;; Copyright (C) 1985-1986, 1993-1994, 1998-2014 Free Software Foundation, Inc.
 
 ;; Maintainer: emacs-devel@gnu.org
 ;; Keywords: help, internal
@@ -450,7 +449,7 @@ is specified by the variable `message-log-max'."
 (defun view-lossage ()
   "Display last 300 input keystrokes.
 
-To record all your input on a file, use `open-dribble-file'."
+To record all your input, use `open-dribble-file'."
   (interactive)
   (help-setup-xref (list #'view-lossage)
                   (called-interactively-p 'interactive))

diff --git a/src/ChangeLog b/src/ChangeLog
index c370bdc0404f24ef97ff41fdd60d73bcfad9908b..9b0847019337b460ea9844731c282f837af777f8 100644 (file)
--- a/src/ChangeLog
+++ b/src/ChangeLog
@@ -1,15 +1,17 @@
+2014-04-05  Glenn Morris  <rgm@gnu.org>
+
+       * keyboard.c (Fopen_dribble_file): Doc tweak.
+
 2014-04-04  Jan Djärv  <jan.h.d@swipnet.se>
 
        Backport from trunk.
        * nsterm.m (updateFrameSize:): If waiting for the tool bar and tool
-       bar is zero height, just return (Bug#16976).
-       (initFrameFromEmacs:): Initialize wait_for_tool_bar.
-
-       * nsterm.h (EmacsView): Add wait_for_tool_bar.
-
-       * nsmenu.m (update_frame_tool_bar): Return early if view or toolbar
+       bar is zero height, just return (Bug#16976).
+       (initFrameFromEmacs:): Initialize wait_for_tool_bar.
+       * nsterm.h (EmacsView): Add wait_for_tool_bar.
+       * nsmenu.m (update_frame_tool_bar): Return early if view or toolbar
        is nil.  If waiting for toolbar to complete, force a redraw.
-       (free_frame_tool_bar): Set wait_for_tool_bar = NO (Bug#16976)
+       (free_frame_tool_bar): Set wait_for_tool_bar = NO (Bug#16976).
 
 2014-04-03  Ken Brown  <kbrown@cornell.edu>
 

diff --git a/src/keyboard.c b/src/keyboard.c
index 20e75822fd3922b93f8151c8bbefe1c117f9347b..3b50140684e7e84c1293090240ed056f4a9a6b14 100644 (file)
--- a/src/keyboard.c
+++ b/src/keyboard.c
@@ -1,7 +1,6 @@
 /* Keyboard and mouse input; editor command loop.
 
-Copyright (C) 1985-1989, 1993-1997, 1999-2014 Free Software Foundation,
-Inc.
+Copyright (C) 1985-1989, 1993-1997, 1999-2014 Free Software Foundation, Inc.
 
 This file is part of GNU Emacs.
 
@@ -10071,7 +10070,10 @@ DEFUN ("open-dribble-file", Fopen_dribble_file, Sopen_dribble_file, 1, 1,
        "FOpen dribble file: ",
        doc: /* Start writing all keyboard characters to a dribble file called FILE.
 If FILE is nil, close any open dribble file.
-The file will be closed when Emacs exits.  */)
+The file will be closed when Emacs exits.
+
+Be aware that this records ALL characters you type!
+This may include sensitive information such as passwords.  */)
   (Lisp_Object file)
 {
   if (dribble)