[Emacs-diffs] emacs-24 r116913: Minor doc updates related to dribble files

[Glenn Morris]

------------------------------------------------------------
revno: 116913
revision-id: address@hidden
parent: address@hidden
committer: Glenn Morris <address@hidden>
branch nick: emacs-24
timestamp: Sat 2014-04-05 11:33:55 -0700
message:
  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.
modified:
  doc/emacs/ChangeLog            changelog-20091113204419-o5vbwnq5f7feedwu-6227
  doc/emacs/trouble.texi         
trouble.texi-20091113204419-o5vbwnq5f7feedwu-6279
  doc/lispref/ChangeLog          changelog-20091113204419-o5vbwnq5f7feedwu-6155
  doc/lispref/os.texi            os.texi-20091113204419-o5vbwnq5f7feedwu-6205
  lisp/ChangeLog                 changelog-20091113204419-o5vbwnq5f7feedwu-1432
  lisp/help.el                   help.el-20091113204419-o5vbwnq5f7feedwu-280
  src/ChangeLog                  changelog-20091113204419-o5vbwnq5f7feedwu-1438
  src/keyboard.c                 keyboard.c-20091113204419-o5vbwnq5f7feedwu-449

=== modified file 'doc/emacs/ChangeLog'
--- a/doc/emacs/ChangeLog       2014-04-04 02:09:35 +0000
+++ b/doc/emacs/ChangeLog       2014-04-05 18:33:55 +0000
@@ -1,3 +1,7 @@
+2014-04-05  Glenn Morris  <address@hidden>
+
+       * trouble.texi (Checklist): Dribble files may contain passwords.
+
 2014-04-04  Glenn Morris  <address@hidden>
 
        * files.texi (Backup Names):

=== modified file 'doc/emacs/trouble.texi'
--- a/doc/emacs/trouble.texi    2014-02-18 18:15:29 +0000
+++ b/doc/emacs/trouble.texi    2014-04-05 18:33:55 +0000
@@ -759,7 +759,9 @@
 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

=== modified file 'doc/lispref/ChangeLog'
--- a/doc/lispref/ChangeLog     2014-04-04 02:09:35 +0000
+++ b/doc/lispref/ChangeLog     2014-04-05 18:33:55 +0000
@@ -1,3 +1,7 @@
+2014-04-05  Glenn Morris  <address@hidden>
+
+       * os.texi (Recording Input): Dribble files may contain passwords.
+
 2014-04-04  Glenn Morris  <address@hidden>
 
        * backups.texi (Making Backups, Reverting):

=== modified file 'doc/lispref/os.texi'
--- a/doc/lispref/os.texi       2014-03-18 01:19:03 +0000
+++ b/doc/lispref/os.texi       2014-04-05 18:33:55 +0000
@@ -1991,20 +1991,11 @@
 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.
-
address@hidden
address@hidden
-(open-dribble-file "~/dribble")
-     @result{} nil
address@hidden group
address@hidden example
 @end deffn
 
   See also the @code{open-termscript} function (@pxref{Terminal Output}).

=== modified file 'lisp/ChangeLog'
--- a/lisp/ChangeLog    2014-04-05 07:44:56 +0000
+++ b/lisp/ChangeLog    2014-04-05 18:33:55 +0000
@@ -1,3 +1,7 @@
+2014-04-05  Glenn Morris  <address@hidden>
+
+       * help.el (view-lossage): Doc tweak.
+
 2014-04-05  Matthias Dahl  <address@hidden>
 
        * faces.el (face-spec-recalc): Call make-face-x-resource-internal

=== modified file 'lisp/help.el'
--- a/lisp/help.el      2014-03-16 09:26:58 +0000
+++ b/lisp/help.el      2014-04-05 18:33:55 +0000
@@ -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: address@hidden
 ;; Keywords: help, internal
@@ -450,7 +449,7 @@
 (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))

=== modified file 'src/ChangeLog'
--- a/src/ChangeLog     2014-04-04 16:32:24 +0000
+++ b/src/ChangeLog     2014-04-05 18:33:55 +0000
@@ -1,15 +1,17 @@
+2014-04-05  Glenn Morris  <address@hidden>
+
+       * keyboard.c (Fopen_dribble_file): Doc tweak.
+
 2014-04-04  Jan Djärv  <address@hidden>
 
        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  <address@hidden>
 

=== modified file 'src/keyboard.c'
--- a/src/keyboard.c    2014-04-04 13:19:35 +0000
+++ b/src/keyboard.c    2014-04-05 18:33:55 +0000
@@ -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 @@
        "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)