From nobody@FreeBSD.org  Sat Sep 18 21:26:06 2010
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 74C88106566B
	for <freebsd-gnats-submit@FreeBSD.org>; Sat, 18 Sep 2010 21:26:06 +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 6453E8FC17
	for <freebsd-gnats-submit@FreeBSD.org>; Sat, 18 Sep 2010 21:26:06 +0000 (UTC)
Received: from www.freebsd.org (localhost [127.0.0.1])
	by www.freebsd.org (8.14.3/8.14.3) with ESMTP id o8ILQ6OX060868
	for <freebsd-gnats-submit@FreeBSD.org>; Sat, 18 Sep 2010 21:26:06 GMT
	(envelope-from nobody@www.freebsd.org)
Received: (from nobody@localhost)
	by www.freebsd.org (8.14.3/8.14.3/Submit) id o8ILQ69E060867;
	Sat, 18 Sep 2010 21:26:06 GMT
	(envelope-from nobody)
Message-Id: <201009182126.o8ILQ69E060867@www.freebsd.org>
Date: Sat, 18 Sep 2010 21:26:06 GMT
From: Ben Kaduk <kaduk@mit.edu>
To: freebsd-gnats-submit@FreeBSD.org
Subject: minor fixes for porter's handbook "slow porting/patching" subsection
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>Number:         150708
>Category:       docs
>Synopsis:       minor fixes for porter's handbook "slow porting/patching" subsection
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    pgj
>State:          closed
>Quarter:        
>Keywords:       porthandbook
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sat Sep 18 21:30:01 UTC 2010
>Closed-Date:    Sun Sep 19 15:11:01 UTC 2010
>Last-Modified:  Sun Sep 19 15:11:01 UTC 2010
>Originator:     Ben Kaduk
>Release:        9-current
>Organization:
MIT SIPB
>Environment:
FreeBSD hysteresis.mit.edu 9.0-CURRENT FreeBSD 9.0-CURRENT #25: Mon May 17 20:37:32 EDT 2010     kaduk@hysteresis.mit.edu:/usr/obj/usr/src/sys/GENERIC  amd64
>Description:
minor nits in the text and formatting -- the <maketarget> tag is for make targets, not for commands the user should run
>How-To-Repeat:
http://www.freebsd.org/doc/en/books/porters-handbook/slow-patch.html
>Fix:
patch attached

Patch attached with submission follows:

--- book.sgml.orig	2010-09-18 17:05:49.000000000 -0400
+++ book.sgml	2010-09-18 17:17:27.000000000 -0400
@@ -673,7 +673,8 @@
 	<para>Please only use characters <literal>[-+._a-zA-Z0-9]</literal> for
 	  naming your patches.  Do not use any other characters besides them.
 	  Do not name your patches like <filename>patch-aa</filename> or
-	  <filename>patch-ab</filename> etc, always mention path and file name
+	  <filename>patch-ab</filename> etc, always mention the path
+	  and file name
 	  in patch names.</para>
 
 	<para>Do not put RCS strings in patches.  CVS will mangle them when we
@@ -745,8 +746,8 @@
 	<para>If you want to create a patch file based off of an
 	  existing file, you can copy it with an
 	  <filename>.orig</filename> extension, and then modify the
-	  original one.  Run <maketarget>makepatch</maketarget>, and
-	  this will write out an appropriate patch file to the <filename
+	  original one.  The <maketarget>makepatch</maketarget> target
+	  will write out an appropriate patch file to the <filename
 	    class="directory">files</filename> directory of the
 	  port.</para>
       </sect1>


>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: freebsd-doc->pgj 
Responsible-Changed-By: pgj 
Responsible-Changed-When: Sat Sep 18 21:42:18 UTC 2010 
Responsible-Changed-Why:  
It is mine. 

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

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/150708: commit references a PR
Date: Sun, 19 Sep 2010 15:06:47 +0000 (UTC)

 pgj         2010-09-19 15:06:42 UTC
 
   FreeBSD doc repository
 
   Modified files:
     en_US.ISO8859-1/books/porters-handbook book.sgml 
   Log:
   - Minor fixes in the "slow porting/patching" subsection
   
   PR:             docs/150708
   Submitted by:   Ben Kaduk <kaduk@mit.edu>
   
   Revision  Changes    Path
   1.1076    +3 -3      doc/en_US.ISO8859-1/books/porters-handbook/book.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"
 
State-Changed-From-To: open->closed 
State-Changed-By: pgj 
State-Changed-When: Sun Sep 19 15:10:38 UTC 2010 
State-Changed-Why:  
Committed, thank you! 

http://www.freebsd.org/cgi/query-pr.cgi?pr=150708 
>Unformatted:
