From owner-freebsd-doc@FreeBSD.ORG Tue Feb 26 07:20:00 2013 Return-Path: Delivered-To: freebsd-doc@smarthost.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.FreeBSD.org [8.8.178.115]) by hub.freebsd.org (Postfix) with ESMTP id C743A4D4 for ; Tue, 26 Feb 2013 07:20:00 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:1900:2254:206c::16:87]) by mx1.freebsd.org (Postfix) with ESMTP id AB3F51C9 for ; Tue, 26 Feb 2013 07:20:00 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.6/8.14.6) with ESMTP id r1Q7K0nR050543 for ; Tue, 26 Feb 2013 07:20:00 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.6/8.14.6/Submit) id r1Q7K0rI050542; Tue, 26 Feb 2013 07:20:00 GMT (envelope-from gnats) Resent-Date: Tue, 26 Feb 2013 07:20:00 GMT Resent-Message-Id: <201302260720.r1Q7K0rI050542@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Jason Helfman Received: from mx1.freebsd.org (mx1.FreeBSD.org [8.8.178.115]) by hub.freebsd.org (Postfix) with ESMTP id F000B458 for ; Tue, 26 Feb 2013 07:12:23 +0000 (UTC) (envelope-from jgh@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:1900:2254:206c::16:87]) by mx1.freebsd.org (Postfix) with ESMTP id B2F0C19A for ; Tue, 26 Feb 2013 07:12:23 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.6/8.14.6) with ESMTP id r1Q7CMOm049505 for ; Tue, 26 Feb 2013 07:12:22 GMT (envelope-from jgh@freefall.freebsd.org) Received: (from jgh@localhost) by freefall.freebsd.org (8.14.6/8.14.6/Submit) id r1Q7CMTG049504; Tue, 26 Feb 2013 07:12:22 GMT (envelope-from jgh) Message-Id: <201302260712.r1Q7CMTG049504@freefall.freebsd.org> Date: Tue, 26 Feb 2013 07:12:22 GMT From: Jason Helfman To: FreeBSD-gnats-submit@freebsd.org X-Send-Pr-Version: 3.114 Subject: docs/176435: [patch] [articles/committers-guide] update gnats mirroring section X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list Reply-To: Jason Helfman List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 26 Feb 2013 07:20:00 -0000 >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 @@ - 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. + You may run a local copy of GNATS, and then integrate the FreeBSD + 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. + It is possible to mirror the GNATS database by installing + rsync found under net/rsync in the portstree, and + executing the following: - gnats release=current prefix=/usr + &prompt.user; rsync -va rsync://bit0.us-west.freebsd.org/FreeBSD-bit/gnats . - 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. - . >Release-Note: >Audit-Trail: >Unformatted: