Mercurial > hg > xemacs-beta
annotate man/lispref/dialog.texi @ 5892:053ef01b71a8
Import the #'clear-string API from GNU, use it in tls.c
src/ChangeLog addition:
2015-04-18 Aidan Kehoe <kehoea@parhasard.net>
* sequence.c (Fclear_string): New, API from GNU. Zero a string's
contents, making sure the text is not kept around even when the
string's data is reallocated because of a changed character
length.
* sequence.c (syms_of_sequence): Make it available to Lisp.
* lisp.h: Make it available to C code.
* tls.c (nss_pk11_password): Use it.
* tls.c (gnutls_pk11_password): Use it.
* tls.c (openssl_password): Use it.
tests/ChangeLog addition:
2015-04-18 Aidan Kehoe <kehoea@parhasard.net>
* automated/lisp-tests.el:
Test #'clear-string, just added. Unfortunately there's no way to
be certain from Lisp that the old password data has been erased
after realloc; it may be worth adding a test to tests.c, but
*we'll be reading memory we shouldn't be*, so that gives me pause.
author | Aidan Kehoe <kehoea@parhasard.net> |
---|---|
date | Sat, 18 Apr 2015 23:00:14 +0100 |
parents | 9fae6227ede5 |
children |
rev | line source |
---|---|
0 | 1 @c -*-texinfo-*- |
2 @c This is part of the XEmacs Lisp Reference Manual. | |
444 | 3 @c Copyright (C) 1990, 1991, 1992, 1993 Free Software Foundation, Inc. |
0 | 4 @c See the file lispref.texi for copying conditions. |
5 @setfilename ../../info/dialog.info | |
6 @node Dialog Boxes, Toolbar, Menus, Top | |
7 @chapter Dialog Boxes | |
8 @cindex dialog box | |
9 | |
10 @menu | |
11 * Dialog Box Format:: | |
12 * Dialog Box Functions:: | |
13 @end menu | |
14 | |
5791
9fae6227ede5
Silence texinfo 5.2 warnings, primarily by adding next, prev, and up
Jerry James <james@xemacs.org>
parents:
444
diff
changeset
|
15 @node Dialog Box Format, Dialog Box Functions, Dialog Boxes, Dialog Boxes |
0 | 16 @section Dialog Box Format |
17 | |
18 A dialog box description is a list. | |
19 | |
20 @itemize @bullet | |
21 @item | |
22 The first element of the list is a string to display in the dialog box. | |
23 @item | |
24 The rest of the elements are descriptions of the dialog box's buttons. | |
25 Each one is a vector of three elements: | |
26 @itemize @minus | |
27 @item | |
28 The first element is the text of the button. | |
29 @item | |
30 The second element is the @dfn{callback}. | |
31 @item | |
32 The third element is @code{t} or @code{nil}, whether this button is | |
33 selectable. | |
34 @end itemize | |
35 @end itemize | |
36 | |
37 If the callback of a button is a symbol, then it must name a command. | |
38 It will be invoked with @code{call-interactively}. If it is a list, | |
39 then it is evaluated with @code{eval}. | |
40 | |
41 One (and only one) of the buttons may be @code{nil}. This marker means | |
42 that all following buttons should be flushright instead of flushleft. | |
43 | |
44 The syntax, more precisely: | |
45 | |
46 @example | |
398 | 47 form := <something to pass to `eval'> |
48 command := <a symbol or string, to pass to `call-interactively'> | |
49 callback := command | form | |
50 active-p := <t, nil, or a form to evaluate to decide whether this | |
51 button should be selectable> | |
52 name := <string> | |
53 partition := 'nil' | |
54 button := '[' name callback active-p ']' | |
55 dialog := '(' name [ button ]+ [ partition [ button ]+ ] ')' | |
0 | 56 @end example |
57 | |
5791
9fae6227ede5
Silence texinfo 5.2 warnings, primarily by adding next, prev, and up
Jerry James <james@xemacs.org>
parents:
444
diff
changeset
|
58 @node Dialog Box Functions, , Dialog Box Format, Dialog Boxes |
0 | 59 @section Dialog Box Functions |
60 | |
61 @defun popup-dialog-box dbox-desc | |
62 This function pops up a dialog box. @var{dbox-desc} describes how the | |
63 dialog box will appear (@pxref{Dialog Box Format}). | |
64 @end defun | |
65 | |
66 @xref{Yes-or-No Queries}, for functions to ask a yes/no question using | |
67 a dialog box. |