From nobody@FreeBSD.org  Sun Nov 21 22:36:01 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 CE9BF106564A
	for <freebsd-gnats-submit@FreeBSD.org>; Sun, 21 Nov 2010 22:36:01 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from red.freebsd.org (unknown [IPv6:2001:4f8:fff6::22])
	by mx1.freebsd.org (Postfix) with ESMTP id BDB988FC13
	for <freebsd-gnats-submit@FreeBSD.org>; Sun, 21 Nov 2010 22:36:01 +0000 (UTC)
Received: from red.freebsd.org (localhost [127.0.0.1])
	by red.freebsd.org (8.14.4/8.14.4) with ESMTP id oALMa1rr072171
	for <freebsd-gnats-submit@FreeBSD.org>; Sun, 21 Nov 2010 22:36:01 GMT
	(envelope-from nobody@red.freebsd.org)
Received: (from nobody@localhost)
	by red.freebsd.org (8.14.4/8.14.4/Submit) id oALMa1wV072170;
	Sun, 21 Nov 2010 22:36:01 GMT
	(envelope-from nobody)
Message-Id: <201011212236.oALMa1wV072170@red.freebsd.org>
Date: Sun, 21 Nov 2010 22:36:01 GMT
From: Eitan Adler <lists@eitanadler.com>
To: freebsd-gnats-submit@FreeBSD.org
Subject: [patch] document UPDATIN and MOVED in the porters handbook
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>Number:         152462
>Category:       docs
>Synopsis:       [patch] document UPDATIN and MOVED in the porters handbook
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    jkois
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Sun Nov 21 22:40:11 UTC 2010
>Closed-Date:    Wed Nov 24 22:24:50 UTC 2010
>Last-Modified:  Wed Nov 24 22:24:50 UTC 2010
>Originator:     Eitan Adler
>Release:        
>Organization:
>Environment:
>Description:
The files UPDATING and MOVED are not currently documented.
>How-To-Repeat:

>Fix:
Index: book.sgml
===================================================================
RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/porters-handbook/book.sgml,v
retrieving revision 1.1081
diff -u -r1.1081 book.sgml
--- book.sgml	20 Nov 2010 13:45:33 -0000	1.1081
+++ book.sgml	21 Nov 2010 22:20:50 -0000
@@ -9404,7 +9404,23 @@
 
       <para>Now that you have done all that, you will want to read about
 	how to keep up-to-date in <xref linkend="keeping-up">.</para>
-
+	<sect1 id="moved-and-updating-files">
+         <title>UPDATING and MOVED</title>
+         <para>If upgrading the port requires a special process such as changing configuration files or 
+              running a specific program you should document it in <filename>UPDATING</filename>
+              The format of <filename>UPDATING</filename> is 
+		  <programlisting>YYYYMMDD:
+  AFFECTS: users of portcategory/portname
+  AUTHOR: Your name &lt;Your email address&gt;
+
+  Special instructions</programlisting>
+              If you are including exact portmaster or portupgrading instructions please make sure to get the shell escaping correct.
+        </para>
+        <para>
+          If your port is deleted or changes names you should add an entry to <filename>MOVED</filename>.
+          The format for an entry is:<programlisting>old name|new name (blank for deleted)|date of move|reason</programlisting>
+        </para>
+	</sect1>
     </chapter>
 
     <chapter id="security">

>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: freebsd-doc->jkois  
Responsible-Changed-By: jkois 
Responsible-Changed-When: Mon Nov 22 13:23:10 UTC 2010 
Responsible-Changed-Why:  
Take. 


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

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/152462: commit references a PR
Date: Mon, 22 Nov 2010 19:15:36 +0000 (UTC)

 jkois       2010-11-22 19:15:29 UTC
 
   FreeBSD doc repository
 
   Modified files:
     en_US.ISO8859-1/books/porters-handbook book.sgml 
   Log:
   PR:     docs/152462
   
   Document purpose/format of /usr/ports/UPDATING and /usr/ports/MOVED.
   
   Based on a patch provided by:   Eitan Adler (lists att eitanadler dott com)
   
   Revision  Changes    Path
   1.1083    +25 -0     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: jkois 
State-Changed-When: Wed Nov 24 22:24:21 UTC 2010 
State-Changed-Why:  
Porters-handbook has been modified.   Close this PR. 


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