From: Per Abrahamsen Date: Tue, 26 Aug 2003 08:58:11 +0000 (+0000) Subject: Explain need of static text around editable field X-Git-Tag: ttn-vms-21-2-B4~8984 X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=4036ed8363b5a03b47d8a5dfd8243cdc41f154a8;p=emacs.git Explain need of static text around editable field --- diff --git a/man/ChangeLog b/man/ChangeLog index 3648ed4a11d..5a7f2c10a6f 100644 --- a/man/ChangeLog +++ b/man/ChangeLog @@ -1,3 +1,8 @@ +2003-08-26 Per Abrahamsen + + * widget.texi (User Interface): Explain the need of static text + around an editable field. + 2003-08-19 Luc Teirlinck * widget.texi (Basic Types): The argument to `:help-echo' can now diff --git a/man/widget.texi b/man/widget.texi index 88c068abd77..8971178e0a8 100644 --- a/man/widget.texi +++ b/man/widget.texi @@ -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 @@ change you make must be contained within a single editable text field. 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.