Date: Tue, 26 Feb 2013 07:12:22 GMT From: Jason Helfman <jgh@FreeBSD.org> To: FreeBSD-gnats-submit@freebsd.org Subject: docs/176435: [patch] [articles/committers-guide] update gnats mirroring section Message-ID: <201302260712.r1Q7CMTG049504@freefall.freebsd.org> Resent-Message-ID: <201302260720.r1Q7K0rI050542@freefall.freebsd.org>
next in thread | raw e-mail | index | archive | help
>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@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:
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201302260712.r1Q7CMTG049504>