# HG changeset patch
# User David A. Holland
# Date 1346717840 14400
# Node ID 0365c1ab6fd87513669f7f5bc210d3c50a61e270
# Parent  2f6e36e87efdbcb15e4786adb251c6521de6fbdf
Improve description of classification schemes.

diff -r 2f6e36e87efd -r 0365c1ab6fd8 doc/swallowtail.pdf
Binary file doc/swallowtail.pdf has changed
diff -r 2f6e36e87efd -r 0365c1ab6fd8 doc/swallowtail.tex
--- a/doc/swallowtail.tex	Mon Sep 03 19:29:24 2012 -0400
+++ b/doc/swallowtail.tex	Mon Sep 03 20:17:20 2012 -0400
@@ -650,6 +650,14 @@
 Here is a quick discussion of the classification schemes that we
 expect to use, or might use.
 
+There are four kinds of classifications: enumerated (the value must be
+one from a fixed set of constants), tags (the value is zero or more
+constants from a fixed pool), text (the value can be any string), and
+hierarchical (like enumerated, but with structure).
+
+In the long run some of the things that are currently PR states may
+want to be tags instead.
+
 \subsection{Enumerated classifications}
 
 \paragraph{Category.}
@@ -670,6 +678,16 @@
 
 The GNATS ``Priority'' field.
 
+\subsection{Tag sets.}
+
+\paragraph{Release-goals.}
+Tags like \texttt{6-CRITICAL}, to be applied and managed by releng
+when planning for a release.
+
+\paragraph{Branch-notes.}
+Tags like \texttt{5-ONLY}, to mark bugs that do not affect HEAD and
+that can therefore be retired along with branches.
+
 \subsection{Text classifications}
 
 \paragraph{Manpage.}
@@ -689,11 +707,6 @@
 A hierarchical taxonomy of the results of the problem (annoyance,
 system crash, remote root exploit, etc.)
 
-\subsection{Tag sets.}
-
-\paragraph{Releng.}
-Tags like \texttt{6-CRITICAL}.
-
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 \section{Other Future Features}