From nobody@FreeBSD.org  Thu Apr 24 05:34:24 2008
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 55219106567A
	for <freebsd-gnats-submit@FreeBSD.org>; Thu, 24 Apr 2008 05:34:24 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (www.freebsd.org [IPv6:2001:4f8:fff6::21])
	by mx1.freebsd.org (Postfix) with ESMTP id 5F5A38FC19
	for <freebsd-gnats-submit@FreeBSD.org>; Thu, 24 Apr 2008 05:34:24 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (localhost [127.0.0.1])
	by www.freebsd.org (8.14.2/8.14.2) with ESMTP id m3O5Xv9i023954
	for <freebsd-gnats-submit@FreeBSD.org>; Thu, 24 Apr 2008 05:33:57 GMT
	(envelope-from nobody@www.freebsd.org)
Received: (from nobody@localhost)
	by www.freebsd.org (8.14.2/8.14.1/Submit) id m3O5Xv79023953;
	Thu, 24 Apr 2008 05:33:57 GMT
	(envelope-from nobody)
Message-Id: <200804240533.m3O5Xv79023953@www.freebsd.org>
Date: Thu, 24 Apr 2008 05:33:57 GMT
From: Lawrence Mayer <lawmay3@i12.com>
To: freebsd-gnats-submit@FreeBSD.org
Subject: [patch] Update to articles/problem-reports/article.sgml
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>Number:         123043
>Category:       docs
>Synopsis:       [patch] Update to articles/problem-reports/article.sgml
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          update
>Submitter-Id:   current-users
>Arrival-Date:   Thu Apr 24 05:40:00 UTC 2008
>Closed-Date:    Sun Jul 13 14:05:01 UTC 2008
>Last-Modified:  Sun Jul 13 14:10:04 UTC 2008
>Originator:     Lawrence Mayer
>Release:        7.0R
>Organization:
>Environment:
>Description:
Patch updates articles/problem-reports/article.sgml revision 1.55 as follows:

1. Clarifies that synopses with [patch] and [maintainer update] should include the brackets

2. Adds hyperlink to web-based PR submission form 
>How-To-Repeat:

>Fix:
Apply included patch to articles/problem-reports/article.sgml revision 1.55 <http://www.freebsd.org/cgi/cvsweb.cgi/~checkout~/doc/en_US.ISO8859-1/articles/problem-reports/article.sgml?rev=1.55;content-type=text%2Fplain>

Patch attached with submission follows:

--- Problem-reports_155.sgml	2008-04-23 21:20:23.444529600 -0700
+++ Problem-reports_156.sgml	2008-04-23 21:59:16.248937600 -0700
@@ -342,7 +342,7 @@
 	  <para><emphasis>If you have a patch, say so.</emphasis>
 	    A PR with a patch included is much more likely to be
 	    looked at than one without.  If you are including one,
-	    put the string <literal>[patch]</literal> at the
+	    put the string <literal>[patch]</literal> (including the brackets) at the
 	    beginning of the <quote>Synopsis</quote>.  (Although it is
 	    not mandatory to use that exact string, by convention,
 	    that is the one that is used.)</para>
@@ -352,7 +352,7 @@
 	  <para><emphasis>If you are a maintainer, say so.</emphasis>
 	    If you are maintaining a part of the source code (for
 	    instance, a port), you might consider adding the string
-	    <literal>[maintainer update]</literal> at the beginning of
+	    <literal>[maintainer update]</literal> (including the brackets) at the beginning of
 	    your synopsis line, and you definitely should set the
 	    <quote>Class</quote> of
 	    your PR to <literal>maintainer-update</literal>.  This way
@@ -521,8 +521,9 @@
 	you insert manual linebreaks somewhere around 70 characters,
 	so that the web display of the PR will be readable.</para>
 
-      <para>Similar considerations apply if you are using the web-based
-	PR submittal form instead of &man.send-pr.1;.  Note that
+      <para>Similar considerations apply if you are using the
+	<ulink url="http://www.freebsd.org/send-pr.html"> web-based
+	PR submittal form</ulink> instead of &man.send-pr.1;.  Note that
 	cut-and-paste operations can have their own side-effects on
 	text formatting.  In certain cases it may be necessary to use
 	&man.uuencode.1; to ensure that patches arrive unmodified.</para>
@@ -530,7 +531,7 @@
       <para>Finally, if your submission will be lengthy, you should
 	to prepare your work offline so that nothing will be lost in
 	case there is a problem submitting it.  This can be an especial
-	problem with the web form.</para>
+	problem with the<ulink url="http://www.freebsd.org/send-pr.html"> web form</ulink>.</para>
     </section>
 
     <section>
@@ -638,7 +639,7 @@
       </itemizedlist>
 
       <para>The next section describes fields that are common to both
-	the email interface and the web interface:</para>
+	the email interface and the<ulink url="http://www.freebsd.org/send-pr.html"> web interface</ulink>:</para>
 
       <itemizedlist>
 
@@ -677,10 +678,10 @@
 	    get ignored.</para>
 
 	  <para>As noted above, if your problem report includes a patch,
-	    please have the synopsis start with <literal>[patch]</literal>;
+	    please have the synopsis start with <literal>[patch]</literal> (including the brackets);
 	    if this is a ports PR and you are the
 	    maintainer, you may consider adding
-	    <literal>[maintainer update]</literal> and set the
+	    <literal>[maintainer update]</literal> (including the brackets) and set the
 	    <quote>Class</quote> of your PR to
 	    <literal>maintainer-update</literal>.</para>
 	</listitem>
@@ -1107,7 +1108,7 @@
       <para>This will read the specified file, validate the contents,
 	strip comments and send it off.</para>
 
-      <para>If you are using the web form:</para>
+      <para>If you are using the<ulink url="http://www.freebsd.org/send-pr.html"> web form</ulink>:</para>
 
       <para>Before you hit <literal>submit</literal>, you will need to
 	fill in a field containing text that is represented in image


>Release-Note:
>Audit-Trail:
State-Changed-From-To: open->closed 
State-Changed-By: remko 
State-Changed-When: Sun Jul 13 14:05:00 UTC 2008 
State-Changed-Why:  
Committed. Thanks! 

http://www.freebsd.org/cgi/query-pr.cgi?pr=123043 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/123043: commit references a PR
Date: Sun, 13 Jul 2008 14:04:47 +0000 (UTC)

 remko       2008-07-13 14:04:34 UTC
 
   FreeBSD doc repository
 
   Modified files:
     en_US.ISO8859-1/articles/problem-reports article.sgml 
   Log:
   Clarify that we need to use the brackets, and update the web page references
   with actual links. [1]
   
   Also s/submittal/submission/ (changed by myself)
   
   PR:                     123043 [1]
   Submitted by:           Lawrence Mayer <lawmay3 at i12 dot com> [1]
   
   Revision  Changes    Path
   1.57      +10 -9     doc/en_US.ISO8859-1/articles/problem-reports/article.sgml
 _______________________________________________
 cvs-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/cvs-all
 To unsubscribe, send any mail to "cvs-all-unsubscribe@freebsd.org"
 
>Unformatted:
