From owner-svn-doc-all@FreeBSD.ORG Mon Mar 4 19:16:04 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.FreeBSD.org [8.8.178.115]) by hub.freebsd.org (Postfix) with ESMTP id A55AF8D7; Mon, 4 Mar 2013 19:16:04 +0000 (UTC) (envelope-from eadler@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id 88ABDF27; Mon, 4 Mar 2013 19:16:04 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.5/8.14.5) with ESMTP id r24JG45r072206; Mon, 4 Mar 2013 19:16:04 GMT (envelope-from eadler@svn.freebsd.org) Received: (from eadler@localhost) by svn.freebsd.org (8.14.6/8.14.5/Submit) id r24JG46g072205; Mon, 4 Mar 2013 19:16:04 GMT (envelope-from eadler@svn.freebsd.org) Message-Id: <201303041916.r24JG46g072205@svn.freebsd.org> From: Eitan Adler Date: Mon, 4 Mar 2013 19:16:04 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r41090 - head/en_US.ISO8859-1/articles/committers-guide X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees \(except for " user" , " projects" , and " translations" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 04 Mar 2013 19:16:04 -0000 Author: eadler Date: Mon Mar 4 19:16:04 2013 New Revision: 41090 URL: http://svnweb.freebsd.org/changeset/doc/41090 Log: Modernize the GNATS mirroring section PR: docs/176435 Submitted by: jgh Approved by: bcr (mentor) Modified: head/en_US.ISO8859-1/articles/committers-guide/article.xml Modified: head/en_US.ISO8859-1/articles/committers-guide/article.xml ============================================================================== --- head/en_US.ISO8859-1/articles/committers-guide/article.xml Mon Mar 4 19:13:49 2013 (r41089) +++ head/en_US.ISO8859-1/articles/committers-guide/article.xml Mon Mar 4 19:16:04 2013 (r41090) @@ -444,11 +444,11 @@ Checkout from a Mirror - You can check out a working copy from a mirror by simply + Check out a working copy from a mirror by substituting the mirror's URL for svn+ssh://svn.freebsd.org/base. This can - be an official mirror or a mirror you maintain yourself - using svnsync or similar. + be an official mirror or a mirror maintained by + using svnsync. There is a serious disadvantage to this method: every time something is to be committed, a svn switch @@ -2300,32 +2300,19 @@ ControlPersist yes 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. + GNATS tree by creating an rsync mirror. + Then you can run GNATS commands locally, allowing you to query the PR + database without an Internet connection. Mirroring the GNATS Tree - It is possible to mirror the GNATS database by adding this line - to your supfile. Note that since - GNATS is not under CVS control it has no tag, so if you are adding - it to your existing supfile it should appear - before any tag= entry as these remain active once set. - - gnats release=current prefix=/usr - - This will place the FreeBSD GNATS tree in - /usr/gnats. You can use a - refuse file to control which categories to - receive. For example, to only receive docs PRs, - put this line in - /usr/local/etc/cvsup/sup/refuse - The precise path depends on the *default - base setting in your - supfile. - . + It is possible to mirror the GNATS database by installing + net/rsync, and + executing: + + &prompt.user; rsync -va rsync://bit0.us-west.freebsd.org/FreeBSD-bit/gnats . +