diff --git a/en_US.ISO8859-1/articles/committers-guide/article.sgml b/en_US.ISO8859-1/articles/committers-guide/article.sgml
index a88684f1c9..8a0866bb83 100644
--- a/en_US.ISO8859-1/articles/committers-guide/article.sgml
+++ b/en_US.ISO8859-1/articles/committers-guide/article.sgml
@@ -2715,16 +2715,14 @@ $target - head/$source:$P,$Q,$R
This lets you query the PR database without needing to be connected to
the Internet.
-
- Using a local GNATS tree
+
+ Mirroring the GNATS Tree
-
- If you are not already downloading the GNATS tree, add this line
- to your supfile, and re-sup. Note that since
- GNATS is not under CVS control it has no tag, so if you are adding
- it to your existing supfile it should appear
- before any tag=
entry as these remain active once set.
-
+ It is possible to mirror the GNATS database by adding this line
+ to your supfile. Note that since
+ GNATS is not under CVS control it has no tag, so if you are adding
+ it to your existing supfile it should appear
+ before any tag=
entry as these remain active once set.
gnats release=current prefix=/usr
@@ -2738,75 +2736,34 @@ $target - head/$source:$P,$Q,$R
base setting in your
supfile.
.
+
- gnats/[a-ce-z]*
+
+ Useful Tools
- The rest of these examples assume you have only supped the
- docs category. Adjust them as necessary,
- depending on the categories you are syncing.
-
+ Other than edit-pr there are a
+ collection of tools in ~gnats/tools/
+ on freefall which can make
+ working with PRs much easier.
-
- Install the GNATS port from
- ports/databases/gnats. This will place the
- various GNATS directories under
- $PREFIX/share/gnats.
-
+ open-pr, close-pr,
+ take-pr, and feedback-pr
+ take PR numbers as arguments and then ask you to select from a
+ preexisting list of change reasons or let you type in your
+ own.
-
- Symlink the GNATS directories you are supping under the version
- of GNATS you have installed.
+ change-pr is a multi purpose tool
+ that lets you make multiple changes at the same time with one
+ command.
- &prompt.root; cd /usr/local/share/gnats/gnats-db
-&prompt.root; ln -s /usr/gnats/docs
-
- Repeat as necessary, depending on how many GNATS categories you
- are syncing.
-
-
-
- Update the GNATS categories file with these
- categories. The file is
- $PREFIX/share/gnats/gnats-db/gnats-adm/categories.
-
- # This category is mandatory
-pending:Category for faulty PRs:gnats-admin:
-#
-# FreeBSD categories
-#
-docs:Documentation Bug:freebsd-doc:
-
-
-
- Run $PREFIX/libexec/gnats/gen-index to
- recreate the GNATS index. The output has to be redirected to
- $PREFIX/share/gnats/gnats-db/gnats-adm/index.
- You can do this periodically from &man.cron.8;, or run &man.cvsup.1;
- from a shell script that does this as well.
-
- &prompt.root; /usr/local/libexec/gnats/gen-index \
- > /usr/local/share/gnats/gnats-db/gnats-adm/index
-
-
-
- Test the configuration by querying the PR database. This
- command shows open docs PRs.
-
- &prompt.root; query-pr -c docs -s open
-
-
-
-
- Pick a PR and close it.
-
-
-
-
- This procedure only works to allow you to view and query the PRs
- locally. To edit or close them you will still have to log in to
- freefall and do it from there.
-
-
+ For example, to assign PR 123456 to yourself type
+ take-pr 123456.
+ If you want to set the PR to patched awaiting an MFC at
+ the same time use:
+ change-pr -t -p -m "awaiting MFC"
+ 123456
+
+
Who's Who