docs/176435: [patch] [articles/committers-guide] update gnats mirroring section

Jason Helfman jgh at FreeBSD.org
Tue Feb 26 07:20:00 UTC 2013


>Number:         176435
>Category:       docs
>Synopsis:       [patch] [articles/committers-guide] update gnats mirroring section
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Tue Feb 26 07:20:00 UTC 2013
>Closed-Date:
>Last-Modified:
>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 at 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:
>Unformatted:


More information about the freebsd-doc mailing list