Explain need of static text around editable field

diff --git a/man/ChangeLog b/man/ChangeLog
index 3648ed4a11dccb5e350babe7ee6e41bd4f214283..5a7f2c10a6fe46567b1c14bbbb8a5dfe7c9d4735 100644 (file)
--- a/man/ChangeLog
+++ b/man/ChangeLog
@@ -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

diff --git a/man/widget.texi b/man/widget.texi
index 88c068abd7723e0260cd640231c883eaafe14f6c..8971178e0a8f83d389d279b1c755244b440bd83b 100644 (file)
--- 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.