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