From owner-freebsd-doc Mon Jun 12 21:30:16 2000 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.ORG [204.216.27.21]) by hub.freebsd.org (Postfix) with ESMTP id E8BF937B99B for ; Mon, 12 Jun 2000 21:30:00 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id VAA73063; Mon, 12 Jun 2000 21:30:01 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: from merlin.prod.itd.earthlink.net (merlin.prod.itd.earthlink.net [207.217.120.156]) by hub.freebsd.org (Postfix) with ESMTP id F23AE37B530 for ; Mon, 12 Jun 2000 21:22:53 -0700 (PDT) (envelope-from eogren@earthlink.net) Received: from rod.darktech.org (ip29.cambridge2.ma.pub-ip.psi.net [38.32.112.29]) by merlin.prod.itd.earthlink.net (8.9.3-EL_1_3/8.9.3) with ESMTP id VAA21542 for ; Mon, 12 Jun 2000 21:22:51 -0700 (PDT) Received: (from eogren@localhost) by rod.darktech.org (8.10.1/8.10.1) id e5D4N8q02095; Tue, 13 Jun 2000 00:23:08 -0400 (EDT) Message-Id: <200006130423.e5D4N8q02095@rod.darktech.org> Date: Tue, 13 Jun 2000 00:23:08 -0400 (EDT) From: eogren@earthlink.net Reply-To: eogren@earthlink.net To: FreeBSD-gnats-submit@freebsd.org X-Send-Pr-Version: 3.2 Subject: docs/19233: [PATCH] Add mention of refuse file to CVSup section of handbook Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org >Number: 19233 >Category: docs >Synopsis: [PATCH] Section about refuse files added to CVSup section >Confidential: no >Severity: non-critical >Priority: medium >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Mon Jun 12 21:30:00 PDT 2000 >Closed-Date: >Last-Modified: >Originator: Eric Ogren >Release: FreeBSD 4.0-STABLE i386 >Organization: >Environment: Doc repository was CVSup'd and cvs update'd 10 minutes ago. >Description: After reading -questions, -stable, and -current, I noticed that there are a lot of people who don't know about the refuse file functionality in CVSup; a section in the CVSup part of the handbook (A.3) is probably worthwhile. >How-To-Repeat: n/a >Fix: Apply the following patch: Index: chapter.sgml =================================================================== RCS file: /usr/local/doctree/doc/en_US.ISO_8859-1/books/handbook/mirrors/chapter.sgml,v retrieving revision 1.68 diff -u -r1.68 chapter.sgml --- chapter.sgml 2000/06/09 22:54:37 1.68 +++ chapter.sgml 2000/06/13 04:17:50 @@ -1753,6 +1753,72 @@ cvs-crypto + + The refuse file + + As mentioned above, CVSup uses + a pull method. Basically, this means that + you connect to the CVSup server, and + it says, Here's what you can download from + me..., and your client responds OK, I'll take + this, this, this, and this. In the default + configuration, the CVSup client will + take every file associated with the collection and tag you + chose in the configuration file. However, this is not always + what you want, especially if you are synching the doc, ports, or + www trees — most people can't read four or five + languages, and therefore they don't need to download the + language-specific files. If you are + CVSuping the ports collection, you + can get around this by specifying each collection individually + (eg ports-astrology, + ports-biology, etc instead of simply + saying ports-all). However, since the doc + and www trees do not have language-specific collections, you + must use one of CVSup's many nify + features; the refuse file. + + The refuse file essentially tells + CVSup that it should not take every + single file from a collection; in other words, it tells the + client to refuse certain files from the + server. The refuse file can be found (or, if you do not yet + have one, should be placed) in + base/sup/refuse. + base is defined in your supfile; by + default, base is + /usr/sup, which means that by default the + refuse file is in /usr/sup/refuse. + + The refuse file has a very simple format; it simply + contains the names of files or directories that you do not wish + to to download. For example, since I cannot speak any languages + except for English and some German, and I do not feel the need + to use German applications, I have the following in my + refuse file: + + + ports/chinese + ports/german + ports/japanese + ports/korean + ports/russian + ports/vietnamese + doc/es_ES.ISO_8859-1 + doc/ja_JP.eucJP + + and so forth for the other languages. Note that the name + of the repository is the first directory in the + refuse file. + + With this very useful feature, those users who are on + slow links or pay by the minute for their Internet connection + will be able to save valuable time as they will no longer need + to download files that they will never use. For more + information on refuse files and other neat + features of CVSup, please view its + manpage. + >Release-Note: >Audit-Trail: >Unformatted: To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message