os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

Modernize the GNATS mirroring section

Browse source 
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
1 changed files with 10 additions and 23 deletions

33
en_US.ISO8859-1/articles/committers-guide/article.xml
View file

@ -444,11 +444,11 @@
<sect3> <sect3>
<title>Checkout from a Mirror</title> <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 substituting the mirror's <acronym>URL</acronym> for
<literal>svn+ssh://svn.freebsd.org/base</literal>. This can <literal>svn+ssh://svn.freebsd.org/base</literal>. This can
be an official mirror or a mirror you maintain yourself be an official mirror or a mirror maintained by
using <command>svnsync</command> or similar.</para> using <command>svnsync</command>.</para>
<para>There is a serious disadvantage to this method: every <para>There is a serious disadvantage to this method: every
time something is to be committed, a <command>svn switch time something is to be committed, a <command>svn switch
@ -2300,32 +2300,19 @@ ControlPersist yes</screen>
</itemizedlist> </itemizedlist>
<para>You can run a local copy of GNATS, and then integrate the FreeBSD <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 GNATS tree by creating an <application>rsync</application> mirror.
locally. Then you can run GNATS commands locally, allowing you to query the PR
This lets you query the PR database without needing to be connected to database without an Internet connection.</para>
the Internet.</para>
<sect2> <sect2>
<title>Mirroring the GNATS Tree</title> <title>Mirroring the GNATS Tree</title>
<para>It is possible to mirror the GNATS database by adding this line <para>It is possible to mirror the GNATS database by installing
to your <filename>supfile</filename>. Note that since <filename role="package">net/rsync</filename>, and
GNATS is not under CVS control it has no tag, so if you are adding executing:</para>
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> <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>
<sect2 id="gnatstools"> <sect2 id="gnatstools">