[Emacs-diffs] Changes to emacs/doc/emacs/mini.texi,v

[Chong Yidong]

CVSROOT:        /sources/emacs
Module name:    emacs
Changes by:     Chong Yidong <cyd>      08/11/17 01:24:48

Index: mini.texi
===================================================================
RCS file: /sources/emacs/emacs/doc/emacs/mini.texi,v
retrieving revision 1.8
retrieving revision 1.9
diff -u -b -r1.8 -r1.9
--- mini.texi   12 Oct 2008 19:54:23 -0000      1.8
+++ mini.texi   17 Nov 2008 01:24:48 -0000      1.9
@@ -46,6 +46,7 @@
 * Completion::           An abbreviation facility for minibuffer input.
 * Minibuffer History::    Reusing recent minibuffer arguments.
 * Repetition::           Re-executing commands that used the minibuffer.
+* Passwords::             Entering passwords in the echo area.
 @end menu
 
 @node Minibuffer File
@@ -589,6 +590,35 @@
 can re-execute a command by calling @code{eval} with the
 @code{command-history} element.
 
address@hidden Passwords
address@hidden Entering passwords
+
+Sometimes, you may need to enter a password into Emacs.  For instance,
+when you tell Emacs to visit a file on another machine via a network
+protocol such as FTP, you often need to supply a password to gain
+access to the machine (@pxref{Remote Files}).
+
+  Entering a password is, in a basic sense, similar to using a
+minibuffer.  Emacs displays a prompt in the echo area (such as
address@hidden: }); after you type the required password, press
address@hidden to submit it.  To prevent others from seeing your password,
+every character you type is displayed as a dot (@samp{.}) instead of
+its usual form.
+
+  Most of the features and commands associated with the minibuffer can
address@hidden be used when entering a password.  There is no history or
+completion, and you cannot change windows or perform any other action
+with Emacs until you have submitted the password.
+
+  While you are typing the password, you may press @key{DEL} to delete
+backwards, removing the last character entered.  @key{C-u} deletes
+everything you have typed so far.  @kbd{C-g} quits the password prompt
+(@pxref{Quitting}).  @kbd{C-y} inserts the current kill into the
+password (@pxref{Killing}).  You may type either @key{RET} or
address@hidden to submit the password.  Any other self-inserting character
+key inserts the associated character into the password, and all other
+input is ignored.
+
 @ignore
    arch-tag: ba913cfd-b70e-400f-b663-22b2c309227f
 @end ignore