Changes to gnats/doc/p-admin.texi

Yngve Svendsen <[email protected]> Sat, 26 Oct 2002 18:02:54 -0400
Newsgroups gmane.comp.bug-tracking.gnats.patches
Message-ID <[email protected]>
Index: gnats/doc/p-admin.texi
diff -c gnats/doc/p-admin.texi:1.28 gnats/doc/p-admin.texi:1.29
*** gnats/doc/p-admin.texi:1.28	Thu Oct 24 08:46:56 2002
--- gnats/doc/p-admin.texi	Sat Oct 26 18:02:53 2002
***************
*** 690,710 ****
  The @code{on-change} subsection of a @code{fields} section specifies one
  or more actions to be performed when the field value is edited by the
  user.  It has the general form
  @example
  on-change [ "query-expression" ] @{
- @*
  @ @ [ add-audit-trail ]
- @*
  @ @ [ audit-trail-format @{
  @ @ @ @ format "formatstring"
  @ @ @ @ [ fields @{ "fieldname" ... @} ]
  @ @ @} ]
- @*
  @ @ [ require-change-reason ]
- @*
  @ @ [ set-field | append-to-field "fieldname" @{
  @ @ @ @ "format-string" [ fieldlist ]
  @ @ @} ]
  @}
  @end example
  
--- 690,708 ----
  The @code{on-change} subsection of a @code{fields} section specifies one
  or more actions to be performed when the field value is edited by the
  user.  It has the general form
+ 
  @example
  on-change [ "query-expression" ] @{
  @ @ [ add-audit-trail ]
  @ @ [ audit-trail-format @{
  @ @ @ @ format "formatstring"
  @ @ @ @ [ fields @{ "fieldname" ... @} ]
  @ @ @} ]
  @ @ [ require-change-reason ]
  @ @ [ set-field | append-to-field "fieldname" @{
  @ @ @ @ "format-string" [ fieldlist ]
  @ @ @} ]
+ @ @ [ require @{ "fieldname" ... @} ]
  @}
  @end example
  
***************
*** 734,739 ****
--- 732,745 ----
  @code{append-to-field} option (the @code{read-only} option on a field is
  ignored).  However, the changes are subject to the usual field content
  checks.
+ 
+ The @code{require} option specifies that one or more fields must have
+ a (non-blank) value when this field is changed.
+ 
+ A field may be enforced to have a (non-blank) value at all times by
+ including it in the set of fields required for the initial PR, see
+ @ref{Initial PR input fields}, as well as in the set of fields
+ required on change of the field itself.
  
  There is also a global @code{on-change} section that is executed once
  for each PR edit.  A typical use for such a section is to set the