# HG changeset patch
# User Per Abrahamsen <abraham@dina.kvl.dk>
# Date 1061888291 0
# Node ID 9bdd2608958eb6263eaff27ba41bbf180e618009
# Parent  9fe6ece090b9204f0ab0415aa2fe88f27097bb2d
Explain need of static text around editable field

diff -r 9fe6ece090b9 -r 9bdd2608958e man/ChangeLog
--- 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
diff -r 9fe6ece090b9 -r 9bdd2608958e man/widget.texi
--- 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.