public inbox for
help / color / mirror / Atom feed
* gnats/364: Manual not up-to-date regarding states file
@ 2002-03-26  3:00 Hans-Albert
  0 siblings, 0 replies; only message in thread
From: Hans-Albert @ 2002-03-26  3:00 UTC (permalink / raw)
  To: pdm-gnats, gnats-prs, bug-gnats

>Number:         364
>Category:       gnats
>Synopsis:       Manual not up-to-date regarding states file
>Confidential:   no
>Severity:       serious
>Priority:       high
>Responsible:    unassigned
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Tue Mar 26 05:58:59 -0500 2002
>Originator:     Hans-Albert Schneider
>Release:        3.999.1
GNATS FAQ maintainer
The manual section "The states file" still describes
the states file.  Notably, the new field "type"
is not mentioned.
Furthermore, the semantics have slightly changed: the last
state mentioned need not be *named* "closed" anymore (*1), 
but needs to be of *type* closed (this is enforced, according
to the states file).
Similarly, the first state mentioned in the states file need
not be named "open" anymore (*1); it is the default state
for new PRs. It was not completely clear to me what is meant
by "default": Does this refer to the default installation,
i.e., can dbconfig define a different initail state?
Or is this refering to a scenario where a new PR already
bears a >State: field when it arrives?

Concerning the "type" field itself: the comments in file
states mention that two types ("open" and "closed") exist.
Please make clear whether something internally depends on
these two types, whether and how additional types can
be defined (just mention them in the file?), and what they
are useful for (transition logic like setting the
"Closed-Date"; more?).

(*1) To be precise, 3.1xx did not *require* the first and
last states given in gnats-adm/states to be called "open"
and "closed", but strongly suggested that for compatibility
reasons (some clients may expect...).

Check with comments in the states and dbconfig files.

Gnats-prs mailing list

^ permalink raw reply	[flat|nested] only message in thread

only message in thread, other threads:[~2002-03-26 11:00 UTC | newest]

Thread overview: (only message) (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2002-03-26  3:00 gnats/364: Manual not up-to-date regarding states file Hans-Albert

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).