svn commit: r45150 - head/en_US.ISO8859-1/articles/pr-guidelines
Eitan Adler
eadler at FreeBSD.org
Sun Jun 29 07:40:23 UTC 2014
Author: eadler
Date: Sun Jun 29 07:40:22 2014
New Revision: 45150
URL: http://svnweb.freebsd.org/changeset/doc/45150
Log:
Remove further references to things which don't happen without GNATS
Modified:
head/en_US.ISO8859-1/articles/pr-guidelines/article.xml
Modified: head/en_US.ISO8859-1/articles/pr-guidelines/article.xml
==============================================================================
--- head/en_US.ISO8859-1/articles/pr-guidelines/article.xml Sun Jun 29 07:40:21 2014 (r45149)
+++ head/en_US.ISO8859-1/articles/pr-guidelines/article.xml Sun Jun 29 07:40:22 2014 (r45150)
@@ -227,7 +227,7 @@
<para><link linkend="pr-stale">Stale PRs</link></para>
</listitem>
<listitem>
- <para><link linkend="pr-misfiled">Misfiled PRs</link></para>
+ <para><link linkend="pr-misfiled-notpr">Non-Bug PRs</link></para>
</listitem>
</itemizedlist>
@@ -818,72 +818,6 @@
</itemizedlist>
</section>
- <section xml:id="pr-misfiled">
- <title>Misfiled PRs</title>
-
- <para>GNATS is picky about the format of a submitted bug report.
- This is why a lot of PRs end up being <quote>misfiled</quote> if
- the submitter forgets to fill in a field or puts the wrong sort of
- data in some of the PR fields. This section aims to provide most
- of the necessary details for FreeBSD developers that can help them to
- close or refile these PRs.</para>
-
- <para>When GNATS cannot deduce what to do with a problem report
- that reaches the database, it sets the responsible of the PR to
- <literal>gnats-admin</literal> and files it under the
- <literal>pending</literal> category. This is now a
- <quote>misfiled</quote> PR and will not appear in bug report
- listings, unless someone explicitly asks for a list of all the
- misfiled PRs. If you have access to the FreeBSD cluster
- machines, you can use <command>query-pr</command> to view a
- listing of PRs that have been misfiled:</para>
-
- <screen>&prompt.user; <userinput>query-pr -x -q -r gnats-admin</userinput>
- 52458 gnats-ad open serious medium Re: declaration clash f
- 52510 gnats-ad open serious medium Re: lots of sockets in
- 52557 gnats-ad open serious medium
- 52570 gnats-ad open serious medium Jigdo maintainer update</screen>
-
- <para>Commonly PRs like the ones shown above are misfiled for one
- of the following reasons:</para>
-
- <itemizedlist>
- <listitem>
- <para>A followup to an existing PR, sent through email, has
- the wrong format on its <literal>Subject:</literal>
- header.</para>
- </listitem>
-
- <listitem>
- <para>A submitter sent a Cc: to a mailing list and someone
- followed up to that post instead of the email issued by
- GNATS after processing. The email to the list will not
- have the category/PRnumber tracking tag. (This is why we
- discourage submitters from doing this exact thing.)</para>
- </listitem>
-
- <listitem>
- <para>When completing the &man.send-pr.1; template, the submitter
- forgot to set the category or class of the PR to a proper
- value.</para>
- </listitem>
-
- <listitem>
- <para>When completing the &man.send-pr.1; template, the submitter
- set Confidential to <literal>yes</literal>. (Since we allow
- anyone to mirror GNATS via <application>rsync</application>,
- our PRs are public information. Security alerts should
- therefore not be sent via GNATS but instead via email to
- the Security Team.)</para>
- </listitem>
-
- <listitem>
- <para>It is not a real PR, but some random message sent to
- <email>bug-followup at FreeBSD.org</email> or
- <email>freebsd-gnats-submit at FreeBSD.org</email>.</para>
- </listitem>
- </itemizedlist>
-
<section xml:id="pr-misfiled-notpr">
<title>Non-Bug PRs</title>
@@ -920,7 +854,6 @@
helps to reduce the clutter within the main categories.</para>
</section>
</section>
- </section>
<section xml:id="references">
<title>Further Reading</title>
More information about the svn-doc-head
mailing list