diff --git a/en_US.ISO8859-1/books/handbook/mirrors/chapter.sgml b/en_US.ISO8859-1/books/handbook/mirrors/chapter.sgml index cd2c1e00e4..0a0ebf3ce5 100644 --- a/en_US.ISO8859-1/books/handbook/mirrors/chapter.sgml +++ b/en_US.ISO8859-1/books/handbook/mirrors/chapter.sgml @@ -1,7 +1,7 @@ @@ -1753,6 +1753,72 @@ src-all 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. + diff --git a/en_US.ISO_8859-1/books/handbook/mirrors/chapter.sgml b/en_US.ISO_8859-1/books/handbook/mirrors/chapter.sgml index cd2c1e00e4..0a0ebf3ce5 100644 --- a/en_US.ISO_8859-1/books/handbook/mirrors/chapter.sgml +++ b/en_US.ISO_8859-1/books/handbook/mirrors/chapter.sgml @@ -1,7 +1,7 @@ @@ -1753,6 +1753,72 @@ src-all 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. +