[Emacs-diffs] Changes to emacs/man/widget.texi [emacs-unicode-2]

[Miles Bader]

Index: emacs/man/widget.texi
diff -c emacs/man/widget.texi:1.18.6.1 emacs/man/widget.texi:1.18.6.2
*** emacs/man/widget.texi:1.18.6.1      Fri Apr 16 12:50:42 2004
--- emacs/man/widget.texi       Mon Jun 28 07:29:03 2004
***************
*** 341,346 ****
--- 341,347 ----
    (make-local-variable 'widget-example-repeat)
    (let ((inhibit-read-only t))
      (erase-buffer))
+   (remove-overlays)
    (widget-insert "Here is some documentation.\n\nName: ")
    (widget-create 'editable-field
                 :size 13
***************
*** 680,686 ****
  @end deffn
  
  @deffn{User Option} widget-glyph-enable
! If non-nil, allow glyphs to appear on displays where they are supported.
  @end deffn
  
  
--- 681,687 ----
  @end deffn
  
  @deffn{User Option} widget-glyph-enable
! If address@hidden, allow glyphs to appear on displays where they are 
supported.
  @end deffn
  
  
***************
*** 813,819 ****
  @item :secret
  Character used to display the value.  You can set this to e.g.@: @code{?*}
  if the field contains a password or other secret information.  By
! default, this is nil, and the value is not secret.
  
  @vindex address@hidden keyword}
  @item :valid-regexp
--- 814,820 ----
  @item :secret
  Character used to display the value.  You can set this to e.g.@: @code{?*}
  if the field contains a password or other secret information.  By
! default, this is @code{nil}, and the value is not secret.
  
  @vindex address@hidden keyword}
  @item :valid-regexp
***************
*** 865,876 ****
  
  @vindex address@hidden keyword}
  @item :case-fold
! Set this to nil if you don't want to ignore case when prompting for a
  choice through the minibuffer.
  
  @vindex address@hidden keyword}
  @item :children
! A list whose @code{car} is the widget representing the currently chosen
  type in the buffer.
  
  @vindex address@hidden keyword}
--- 866,877 ----
  
  @vindex address@hidden keyword}
  @item :case-fold
! Set this to @code{nil} if you don't want to ignore case when prompting for a
  choice through the minibuffer.
  
  @vindex address@hidden keyword}
  @item :children
! A list whose @sc{car} is the widget representing the currently chosen
  type in the buffer.
  
  @vindex address@hidden keyword}
***************
*** 1064,1072 ****
  @item :greedy
  Usually a checklist will only match if the items are in the exact
  sequence given in the specification.  By setting @code{:greedy} to
! non-nil, it will allow the items to come in any sequence.  However, if
! you extract the value they will be in the sequence given in the
! checklist, i.e.@: the original sequence is forgotten.
  
  @vindex address@hidden keyword}
  @item :button-args
--- 1065,1073 ----
  @item :greedy
  Usually a checklist will only match if the items are in the exact
  sequence given in the specification.  By setting @code{:greedy} to
! address@hidden, it will allow the items to come in any sequence.
! However, if you extract the value they will be in the sequence given
! in the checklist, i.e.@: the original sequence is forgotten.
  
  @vindex address@hidden keyword}
  @item :button-args
***************
*** 1141,1147 ****
  
  @vindex address@hidden keyword}
  @item :args
! List whose @code{car} is the type of the list elements.
  @end table
  
  @node group,  , editable-list, Basic Types
--- 1142,1148 ----
  
  @vindex address@hidden keyword}
  @item :args
! List whose @sc{car} is the type of the list elements.
  @end table
  
  @node group,  , editable-list, Basic Types
***************
*** 1164,1170 ****
  @section Sexp Types
  @cindex sexp types
  
! A number of widgets for editing @dfn{s-expressions} (lisp types), sexp
  for short, are also available.  These basically fall in several
  categories described in this section.
  
--- 1165,1171 ----
  @section Sexp Types
  @cindex sexp types
  
! A number of widgets for editing @dfn{s-expressions} (Lisp types), sexp
  for short, are also available.  These basically fall in several
  categories described in this section.
  
***************
*** 1180,1186 ****
  @subsection The Constant Widgets
  @cindex constant widgets
  
! The @code{const} widget can contain any lisp expression, but the user is
  prohibited from editing it, which is mainly useful as a component of one
  of the composite widgets.
  
--- 1181,1187 ----
  @subsection The Constant Widgets
  @cindex constant widgets
  
! The @code{const} widget can contain any Lisp expression, but the user is
  prohibited from editing it, which is mainly useful as a component of one
  of the composite widgets.
  
***************
*** 1217,1223 ****
  @subsection Generic Sexp Widget
  @cindex generic sexp widget
  
! The @code{sexp} widget can contain any lisp expression, and allows the
  user to edit it inline in the buffer.
  
  The syntax for the @code{sexp} widget is:
--- 1218,1224 ----
  @subsection Generic Sexp Widget
  @cindex generic sexp widget
  
! The @code{sexp} widget can contain any Lisp expression, and allows the
  user to edit it inline in the buffer.
  
  The syntax for the @code{sexp} widget is:
***************
*** 1278,1285 ****
  @table @code
  @vindex address@hidden keyword}
  @item :must-match
! If this is set to non-nil, only existing file names will be allowed in
! the minibuffer.
  @end table
  @end deffn
  
--- 1279,1286 ----
  @table @code
  @vindex address@hidden keyword}
  @item :must-match
! If this is set to address@hidden, only existing file names will be
! allowed in the minibuffer.
  @end table
  @end deffn
  
***************
*** 1289,1295 ****
  @end deffn
  
  @deffn Widget symbol
! Allows you to edit a lisp symbol in an editable field.
  @end deffn
  
  @deffn Widget function
--- 1290,1296 ----
  @end deffn
  
  @deffn Widget symbol
! Allows you to edit a Lisp symbol in an editable field.
  @end deffn
  
  @deffn Widget function
***************
*** 1309,1316 ****
  @end deffn
  
  @deffn Widget boolean
! Allows you to edit a boolean.  In lisp this means a variable which is
! either nil meaning false, or non-nil meaning true.
  @end deffn
  
  
--- 1310,1317 ----
  @end deffn
  
  @deffn Widget boolean
! Allows you to edit a boolean.  In Lisp this means a variable which is
! either @code{nil} meaning false, or address@hidden meaning true.
  @end deffn
  
  
***************
*** 1330,1337 ****
  will be displayed in the buffer, and will be editable by the user.
  
  @deffn Widget cons
! The value of a @code{cons} widget is a cons-cell where the @code{car} is
! the value of the first component and the @code{cdr} is the value of the
  second component.  There must be exactly two components.
  @end deffn
  
--- 1331,1338 ----
  will be displayed in the buffer, and will be editable by the user.
  
  @deffn Widget cons
! The value of a @code{cons} widget is a cons-cell where the @sc{car} is
! the value of the first component and the @sc{cdr} is the value of the
  second component.  There must be exactly two components.
  @end deffn
  
***************
*** 1432,1438 ****
  @end defun
  
  @defun widget-member widget property
! Non-nil if @var{widget} has a value (even nil) for property @var{property}.
  @end defun
  
  Occasionally it can be useful to know which kind of widget you have,
--- 1433,1440 ----
  @end defun
  
  @defun widget-member widget property
! address@hidden if @var{widget} has a value (even @code{nil}) for
! property @var{property}.
  @end defun
  
  Occasionally it can be useful to know which kind of widget you have,
***************
*** 1475,1481 ****
  @end lisp
  
  You can check if a widget has been made inactive by examining the value
! of the @code{:inactive} keyword.  If this is non-nil, the widget itself
  has been deactivated.  This is different from using the @code{:active}
  keyword, in that the latter tells you if the widget @strong{or} any of
  its ancestors have been deactivated.  Do not attempt to set the
--- 1477,1483 ----
  @end lisp
  
  You can check if a widget has been made inactive by examining the value
! of the @code{:inactive} keyword.  If this is address@hidden, the widget itself
  has been deactivated.  This is different from using the @code{:active}
  keyword, in that the latter tells you if the widget @strong{or} any of
  its ancestors have been deactivated.  Do not attempt to set the
***************
*** 1500,1506 ****
  @var{name} and class should both be symbols, @code{class} should be one
  of the existing widget types.
  
! The third argument @var{DOC} is a documentation string for the widget.
  
  After the new widget has been defined, the following two calls will
  create identical widgets:
--- 1502,1508 ----
  @var{name} and class should both be symbols, @code{class} should be one
  of the existing widget types.
  
! The third argument @var{doc} is a documentation string for the widget.
  
  After the new widget has been defined, the following two calls will
  create identical widgets:
***************
*** 1653,1659 ****
  take four arguments, @var{widget}, @var{prompt}, @var{value}, and
  @var{unbound} and should return a value for widget entered by the user.
  @var{prompt} is the prompt to use.  @var{value} is the default value to
! use, unless @var{unbound} is non-nil, in which case there is no default
  value.  The function should read the value using the method most natural
  for this widget, and does not have to check that it matches.
  @end table
--- 1655,1661 ----
  take four arguments, @var{widget}, @var{prompt}, @var{value}, and
  @var{unbound} and should return a value for widget entered by the user.
  @var{prompt} is the prompt to use.  @var{value} is the default value to
! use, unless @var{unbound} is address@hidden, in which case there is no default
  value.  The function should read the value using the method most natural
  for this widget, and does not have to check that it matches.
  @end table
***************
*** 1719,1725 ****
  @defun widget-prompt-value widget prompt [ value unbound ]
  Prompt for a value matching @var{widget}, using @var{prompt}.
  The current value is assumed to be @var{value}, unless @var{unbound} is
! address@hidden
  @end defun
  
  @defun widget-get-sibling widget
--- 1721,1727 ----
  @defun widget-prompt-value widget prompt [ value unbound ]
  Prompt for a value matching @var{widget}, using @var{prompt}.
  The current value is assumed to be @var{value}, unless @var{unbound} is
! address@hidden@refill
  @end defun
  
  @defun widget-get-sibling widget