Modernize the GNATS mirroring section

PR:		docs/176435
Submitted by:	jgh
Approved by:	bcr (mentor)
This commit is contained in:
Eitan Adler 2013-03-04 19:16:04 +00:00
parent a436b13c38
commit 0557f5eb66
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/head/; revision=41090

View file

@ -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>
<para>It is possible to mirror the GNATS database by installing
<filename role="package">net/rsync</filename>, and
executing:</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">