Mercurial > emacs
changeset 52337:9bdd2608958e
Explain need of static text around editable field
| author | Per Abrahamsen <abraham@dina.kvl.dk> |
|---|---|
| date | Tue, 26 Aug 2003 08:58:11 +0000 |
| parents | 9fe6ece090b9 |
| children | ea32bf7cfca1 |
| files | man/ChangeLog man/widget.texi |
| diffstat | 2 files changed, 16 insertions(+), 2 deletions(-) [+] |
line wrap: on
line diff
--- a/man/ChangeLog Tue Aug 26 08:47:01 2003 +0000 +++ b/man/ChangeLog Tue Aug 26 08:58:11 2003 +0000 @@ -1,3 +1,8 @@ +2003-08-26 Per Abrahamsen <abraham@dina.kvl.dk> + + * widget.texi (User Interface): Explain the need of static text + around an editable field. + 2003-08-19 Luc Teirlinck <teirllm@mail.auburn.edu> * widget.texi (Basic Types): The argument to `:help-echo' can now
--- a/man/widget.texi Tue Aug 26 08:47:01 2003 +0000 +++ b/man/widget.texi Tue Aug 26 08:58:11 2003 +0000 @@ -10,7 +10,7 @@ @c %**end of header @copying -Copyright @copyright{} 2000, 2002 Free Software Foundation, Inc. +Copyright @copyright{} 2000, 2002, 2003 Free Software Foundation, Inc. @quotation Permission is granted to copy, distribute and/or modify this document @@ -211,7 +211,16 @@ For example, capitalizing all text from the middle of one field to the middle of another field is prohibited. -Editing text fields are created by the @code{editable-field} widget. +Editable text fields are created by the @code{editable-field} widget. + +An editable fields must be surrounded by static text on both sides, that +is, text that does not change in the lifetime of the widget. If the +field extend to the end of the line, the terminating line-feed character +will count as the necessary static text on that end, but you will have +to provide the static text before the field yourself. The +@code{:format} keyword is useful for generating the static text; for +instance, if you give it a value of @code{"Name: %v"}, the "Name: " part +will count as the static text. The editing text fields are highlighted with the @code{widget-field-face} face, making them easy to find.