From jgh@FreeBSD.org  Tue Feb 26 07:12:23 2013
Return-Path: <jgh@FreeBSD.org>
Received: from mx1.freebsd.org (mx1.FreeBSD.org [8.8.178.115])
	by hub.freebsd.org (Postfix) with ESMTP id F000B458
	for <FreeBSD-gnats-submit@freebsd.org>; Tue, 26 Feb 2013 07:12:23 +0000 (UTC)
	(envelope-from jgh@FreeBSD.org)
Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:1900:2254:206c::16:87])
	by mx1.freebsd.org (Postfix) with ESMTP id B2F0C19A
	for <FreeBSD-gnats-submit@freebsd.org>; Tue, 26 Feb 2013 07:12:23 +0000 (UTC)
Received: from freefall.freebsd.org (localhost [127.0.0.1])
	by freefall.freebsd.org (8.14.6/8.14.6) with ESMTP id r1Q7CMOm049505
	for <FreeBSD-gnats-submit@freebsd.org>; Tue, 26 Feb 2013 07:12:22 GMT
	(envelope-from jgh@freefall.freebsd.org)
Received: (from jgh@localhost)
	by freefall.freebsd.org (8.14.6/8.14.6/Submit) id r1Q7CMTG049504;
	Tue, 26 Feb 2013 07:12:22 GMT
	(envelope-from jgh)
Message-Id: <201302260712.r1Q7CMTG049504@freefall.freebsd.org>
Date: Tue, 26 Feb 2013 07:12:22 GMT
From: Jason Helfman <jgh@FreeBSD.org>
Reply-To: Jason Helfman <jgh@FreeBSD.org>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: [patch] [articles/committers-guide] update gnats mirroring section
X-Send-Pr-Version: 3.114
X-GNATS-Notify:

>Number:         176435
>Category:       docs
>Synopsis:       [patch] [articles/committers-guide] update gnats mirroring section
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    eadler
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Tue Feb 26 07:20:00 UTC 2013
>Closed-Date:    Mon Mar 04 20:01:43 UTC 2013
>Last-Modified:  Mon Mar 04 20:01:43 UTC 2013
>Originator:     Jason Helfman
>Release:        FreeBSD 10.0-CURRENT amd64
>Organization:
>Environment:
System: FreeBSD freefall.freebsd.org 10.0-CURRENT FreeBSD 10.0-CURRENT #2 r245102: Sun Jan 6 15:01:33 UTC 2013 root@freefall.freebsd.org:/usr/obj/usr/src/sys/FREEFALL amd64


	
>Description:
GNATS mirroring information needs to be updated, as it currently reflects deprecated methodology.
>How-To-Repeat:
	
>Fix:

Index: article.xml
===================================================================
--- article.xml	(revision 41047)
+++ article.xml	(working copy)
@@ -2299,33 +2299,21 @@
       </listitem>
     </itemizedlist>
 
-    <para>You can run a local copy of GNATS, and then integrate the FreeBSD
-      GNATS tree in to it using CVSup.  Then you can run GNATS commands
-      locally.
-      This lets you query the PR database without needing to be connected to
-      the Internet.</para>
+    <para>You may run a local copy of GNATS, and then integrate the FreeBSD
+      GNATS tree by creating an <application>rsync</application> mirror.
+      Then you can run GNATS commands locally, allowing you to query the PR
+      database without an Internet connection.</para>
 
     <sect2>
       <title>Mirroring the GNATS Tree</title>
 
-      <para>It is possible to mirror the GNATS database by adding this line
-	to your <filename>supfile</filename>. Note that since
-	GNATS is not under CVS control it has no tag, so if you are adding
-	it to your existing <filename>supfile</filename> it should appear
-	before any <quote>tag=</quote> entry as these remain active once set.</para>
+      <para>It is possible to mirror the GNATS database by installing
+	<application>rsync</application> found under <filename
+	 role="package">net/rsync</filename> in the portstree, and
+	 executing the following:</para>
 
-	<programlisting>gnats release=current prefix=/usr</programlisting>
+	<screen>&prompt.user; <userinput>rsync -va rsync://bit0.us-west.freebsd.org/FreeBSD-bit/gnats .</userinput></screen>
 
-	<para>This will place the FreeBSD GNATS tree in
-	  <filename>/usr/gnats</filename>.  You can use a
-	  <emphasis>refuse</emphasis> file to control which categories to
-	  receive.  For example, to only receive <literal>docs</literal> PRs,
-	  put this line in
-	  <filename>/usr/local/etc/cvsup/sup/refuse</filename><footnote>
-	    <para>The precise path depends on the <literal>*default
-		base</literal> setting in your
-	      <filename>supfile</filename>.</para>
-	  </footnote>.</para>
     </sect2>
 
     <sect2 id="gnatstools">
>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: freebsd-doc->eadler 
Responsible-Changed-By: eadler 
Responsible-Changed-When: Wed Feb 27 22:13:17 UTC 2013 
Responsible-Changed-Why:  
I'll take it. 

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

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/176435: commit references a PR
Date: Mon,  4 Mar 2013 19:16:10 +0000 (UTC)

 Author: eadler
 Date: Mon Mar  4 19:16:04 2013
 New Revision: 41090
 URL: http://svnweb.freebsd.org/changeset/doc/41090
 
 Log:
   Modernize the GNATS mirroring section
   
   PR:		docs/176435
   Submitted by:	jgh
   Approved by:	bcr (mentor)
 
 Modified:
   head/en_US.ISO8859-1/articles/committers-guide/article.xml
 
 Modified: head/en_US.ISO8859-1/articles/committers-guide/article.xml
 ==============================================================================
 --- head/en_US.ISO8859-1/articles/committers-guide/article.xml	Mon Mar  4 19:13:49 2013	(r41089)
 +++ head/en_US.ISO8859-1/articles/committers-guide/article.xml	Mon Mar  4 19:16:04 2013	(r41090)
 @@ -444,11 +444,11 @@
        <sect3>
  	<title>Checkout from a Mirror</title>
  
 -	<para>You can check out a working copy from a mirror by simply
 +	<para>Check out a working copy from a mirror by
  	  substituting the mirror's <acronym>URL</acronym> for
  	  <literal>svn+ssh://svn.freebsd.org/base</literal>.  This can
 -	  be an official mirror or a mirror you maintain yourself
 -	  using <command>svnsync</command> or similar.</para>
 +	  be an official mirror or a mirror maintained by
 +	  using <command>svnsync</command>.</para>
  
  	<para>There is a serious disadvantage to this method: every
  	  time something is to be committed, a <command>svn switch
 @@ -2300,32 +2300,19 @@ ControlPersist yes</screen>
      </itemizedlist>
  
      <para>You can run a local copy of GNATS, and then integrate the FreeBSD
 -      GNATS tree in to it using CVSup.  Then you can run GNATS commands
 -      locally.
 -      This lets you query the PR database without needing to be connected to
 -      the Internet.</para>
 +      GNATS tree by creating an <application>rsync</application> mirror.
 +      Then you can run GNATS commands locally, allowing you to query the PR
 +      database without an Internet connection.</para>
  
      <sect2>
        <title>Mirroring the GNATS Tree</title>
  
 -      <para>It is possible to mirror the GNATS database by adding this line
 -	to your <filename>supfile</filename>. Note that since
 -	GNATS is not under CVS control it has no tag, so if you are adding
 -	it to your existing <filename>supfile</filename> it should appear
 -	before any <quote>tag=</quote> entry as these remain active once set.</para>
 -
 -	<programlisting>gnats release=current prefix=/usr</programlisting>
 -
 -	<para>This will place the FreeBSD GNATS tree in
 -	  <filename>/usr/gnats</filename>.  You can use a
 -	  <emphasis>refuse</emphasis> file to control which categories to
 -	  receive.  For example, to only receive <literal>docs</literal> PRs,
 -	  put this line in
 -	  <filename>/usr/local/etc/cvsup/sup/refuse</filename><footnote>
 -	    <para>The precise path depends on the <literal>*default
 -		base</literal> setting in your
 -	      <filename>supfile</filename>.</para>
 -	  </footnote>.</para>
 +      <para>It is possible to mirror the GNATS database by installing
 +	<filename role="package">net/rsync</filename>, and
 +	 executing:</para>
 +
 +	<screen>&prompt.user; <userinput>rsync -va rsync://bit0.us-west.freebsd.org/FreeBSD-bit/gnats .</userinput></screen>
 +
      </sect2>
  
      <sect2 id="gnatstools">
 _______________________________________________
 svn-doc-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/svn-doc-all
 To unsubscribe, send any mail to "svn-doc-all-unsubscribe@freebsd.org"
 
State-Changed-From-To: open->closed 
State-Changed-By: eadler 
State-Changed-When: Mon Mar 4 20:01:42 UTC 2013 
State-Changed-Why:  
fixed in r41090 

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