>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 
[email protected]:/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:
_______________________________________________
[email protected] mailing list
http://lists.freebsd.org/mailman/listinfo/freebsd-doc
To unsubscribe, send any mail to "[email protected]"

Reply via email to