diff options
| author | Karl Heuer | 1998-08-29 17:11:50 +0000 |
|---|---|---|
| committer | Karl Heuer | 1998-08-29 17:11:50 +0000 |
| commit | e75ecfecdcaa39d127b448a10cb8c0f374c6923c (patch) | |
| tree | 206726ace6c59016fa2a0d7b1d25a7754d639f08 | |
| parent | 960b55e8398b78fbdff4f1f11291a7a9e6dcccd9 (diff) | |
| download | emacs-e75ecfecdcaa39d127b448a10cb8c0f374c6923c.tar.gz emacs-e75ecfecdcaa39d127b448a10cb8c0f374c6923c.zip | |
*** empty log message ***
| -rw-r--r-- | lispref/minibuf.texi | 24 | ||||
| -rw-r--r-- | lispref/os.texi | 24 | ||||
| -rw-r--r-- | lispref/text.texi | 2 |
3 files changed, 25 insertions, 25 deletions
diff --git a/lispref/minibuf.texi b/lispref/minibuf.texi index d47810484c8..e6aeb01a163 100644 --- a/lispref/minibuf.texi +++ b/lispref/minibuf.texi | |||
| @@ -25,6 +25,7 @@ for reading an argument. | |||
| 25 | * Completion:: How to invoke and customize completion. | 25 | * Completion:: How to invoke and customize completion. |
| 26 | * Yes-or-No Queries:: Asking a question with a simple answer. | 26 | * Yes-or-No Queries:: Asking a question with a simple answer. |
| 27 | * Multiple Queries:: Asking a series of similar questions. | 27 | * Multiple Queries:: Asking a series of similar questions. |
| 28 | * Reading a Password:: Reading a password from the terminal. | ||
| 28 | * Minibuffer Misc:: Various customization hooks and variables. | 29 | * Minibuffer Misc:: Various customization hooks and variables. |
| 29 | @end menu | 30 | @end menu |
| 30 | 31 | ||
| @@ -1415,6 +1416,29 @@ value around the call. | |||
| 1415 | The return value of @code{map-y-or-n-p} is the number of objects acted on. | 1416 | The return value of @code{map-y-or-n-p} is the number of objects acted on. |
| 1416 | @end defun | 1417 | @end defun |
| 1417 | 1418 | ||
| 1419 | @node Reading a Password | ||
| 1420 | @section Reading a Password | ||
| 1421 | @cindex passwords, reading | ||
| 1422 | |||
| 1423 | To read a password to pass to another program, you can use the | ||
| 1424 | function @code{read-passwd}. | ||
| 1425 | |||
| 1426 | @tindex read-passwd | ||
| 1427 | @defun read-passwd prompt &optional confirm default | ||
| 1428 | This function reads a password, prompting with @var{prompt}. It does | ||
| 1429 | not echo the password as the user types it; instead, it echoes @samp{.} | ||
| 1430 | for each character in the password. | ||
| 1431 | |||
| 1432 | The optional argument @var{confirm}, if non-@code{nil}, says to read the | ||
| 1433 | password twice and insist it must be the same both times. If it isn't | ||
| 1434 | the same, the user has to type it over and over until the last two | ||
| 1435 | times match. | ||
| 1436 | |||
| 1437 | The optional argument @var{default} specifies the default password to | ||
| 1438 | return if the user enters empty input. If @var{default} is @code{nil}, | ||
| 1439 | then @code{read-passwd} returns the null string in that case. | ||
| 1440 | @end defun | ||
| 1441 | |||
| 1418 | @node Minibuffer Misc | 1442 | @node Minibuffer Misc |
| 1419 | @section Minibuffer Miscellany | 1443 | @section Minibuffer Miscellany |
| 1420 | 1444 | ||
diff --git a/lispref/os.texi b/lispref/os.texi index d6cfe6fcc31..91025ec8b91 100644 --- a/lispref/os.texi +++ b/lispref/os.texi | |||
| @@ -19,7 +19,6 @@ pertaining to the terminal and the screen. | |||
| 19 | * Getting Out:: How exiting works (permanent or temporary). | 19 | * Getting Out:: How exiting works (permanent or temporary). |
| 20 | * System Environment:: Distinguish the name and kind of system. | 20 | * System Environment:: Distinguish the name and kind of system. |
| 21 | * User Identification:: Finding the name and user id of the user. | 21 | * User Identification:: Finding the name and user id of the user. |
| 22 | * Reading a Password:: Reading a password from the terminal. | ||
| 23 | * Time of Day:: Getting the current time. | 22 | * Time of Day:: Getting the current time. |
| 24 | * Time Conversion:: Converting a time from numeric form to a string, or | 23 | * Time Conversion:: Converting a time from numeric form to a string, or |
| 25 | to calendrical data (or vice versa). | 24 | to calendrical data (or vice versa). |
| @@ -870,29 +869,6 @@ This function returns the real @sc{uid} of the user. | |||
| 870 | This function returns the effective @sc{uid} of the user. | 869 | This function returns the effective @sc{uid} of the user. |
| 871 | @end defun | 870 | @end defun |
| 872 | 871 | ||
| 873 | @node Reading a Password | ||
| 874 | @section Reading a Password | ||
| 875 | @cindex passwords, reading | ||
| 876 | |||
| 877 | To read a password to pass to another program, you can use the | ||
| 878 | function @code{read-passwd}. | ||
| 879 | |||
| 880 | @tindex read-passwd | ||
| 881 | @defun read-passwd prompt &optional confirm default | ||
| 882 | This function reads a password, prompting with @var{prompt}. It does | ||
| 883 | not echo the password as the user types it; instead, it echoes @samp{.} | ||
| 884 | for each character in the password. | ||
| 885 | |||
| 886 | The optional argument @var{confirm}, if non-@code{nil}, says to read the | ||
| 887 | password twice and insist it must be the same both times. If it isn't | ||
| 888 | the same, the user has to type it over and over until the last two | ||
| 889 | times match. | ||
| 890 | |||
| 891 | The optional argument @var{default} specifies the default password to | ||
| 892 | return if the user enters empty input. If @var{default} is @code{nil}, | ||
| 893 | then @code{read-passwd} returns the null string in that case. | ||
| 894 | @end defun | ||
| 895 | |||
| 896 | @node Time of Day | 872 | @node Time of Day |
| 897 | @section Time of Day | 873 | @section Time of Day |
| 898 | 874 | ||
diff --git a/lispref/text.texi b/lispref/text.texi index 75d6e1863dc..02e5a110571 100644 --- a/lispref/text.texi +++ b/lispref/text.texi | |||
| @@ -42,7 +42,7 @@ buffer, together with their properties (when relevant). | |||
| 42 | How to control how much information is kept. | 42 | How to control how much information is kept. |
| 43 | * Filling:: Functions for explicit filling. | 43 | * Filling:: Functions for explicit filling. |
| 44 | * Margins:: How to specify margins for filling commands. | 44 | * Margins:: How to specify margins for filling commands. |
| 45 | * Adaptive Fill: Adaptive Fill mode chooses a fill prefix from context. | 45 | * Adaptive Fill:: Adaptive Fill mode chooses a fill prefix from context. |
| 46 | * Auto Filling:: How auto-fill mode is implemented to break lines. | 46 | * Auto Filling:: How auto-fill mode is implemented to break lines. |
| 47 | * Sorting:: Functions for sorting parts of the buffer. | 47 | * Sorting:: Functions for sorting parts of the buffer. |
| 48 | * Columns:: Computing horizontal positions, and using them. | 48 | * Columns:: Computing horizontal positions, and using them. |