Explain need of static text around editable field

2 files changed, 16 insertions, 2 deletions

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  <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 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.