[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Minor rewording for Bugs/Reporting.wml



-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Hi,

I think the description of how to report a bug with a MUA (instead of 
reportbug) should be updated.

reportbug constructs a subject line of the form
Subject: <packagename>: <bug summary>, and this is not explicitely mentioned 
as good practice in the section for MUAs.

I've prepared a patch for this, and I'd welcome any comments on it 
(especially on the wording -- I'm not a native speaker). If not one 
objects, I would commit this (given that the grammar is alright).

Cheers,

- -- 

Tobias

    Bigamy is having one spouse too many.  Monogamy is the same.
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.2.4 (GNU/Linux)

iD8DBQFAzEjuCqqEJ0Fs8twRAtA3AKCZxtxED6eEEygXhsc8tZZez8rL4wCgn25z
2ZcCC9F5gNRr25K78boUsfE=
=Rnvi
-----END PGP SIGNATURE-----
Index: Reporting.wml
===================================================================
RCS file: /cvs/webwml/webwml/english/Bugs/Reporting.wml,v
retrieving revision 1.43
diff -u -r1.43 Reporting.wml
--- Reporting.wml	16 Feb 2004 21:29:24 -0000	1.43
+++ Reporting.wml	13 Jun 2004 12:24:35 -0000
@@ -52,7 +52,9 @@
 <P>Of course, like any email, you should include a clear, descriptive
 <code>Subject</code> line in your main mail header.  The subject you
 give will be used as the initial bug title in the tracking system, so
-please try to make it informative!</P>
+please try to make it informative! Generally, you should state the
+package name, followed by a colon, a space, and a summary of your
+bug report.</P>
 
 <p>You need to put a <a name="pseudoheader">pseudo-header</a> at the
 start of the body of the
@@ -124,7 +126,7 @@
 <PRE>
   To: submit@bugs.debian.org
   From: diligent@testing.linux.org
-  Subject: Hello says `goodbye'
+  Subject: hello: Program says `goodbye'
 
   Package: hello
   Version: 1.3-16

Reply to: