svn commit: r41010 - head/en_US.ISO8859-1/books/handbook/mirrors
Eitan Adler
eadler at FreeBSD.org
Mon Feb 18 19:54:21 UTC 2013
Author: eadler
Date: Mon Feb 18 19:54:21 2013
New Revision: 41010
URL: http://svnweb.freebsd.org/changeset/doc/41010
Log:
While cvsup is deprecated, as long as it is documented and working,
don't document bogus, ancient, or useless parts.
Approved by: bcr (mentor)
Modified:
head/en_US.ISO8859-1/books/handbook/mirrors/chapter.xml
Modified: head/en_US.ISO8859-1/books/handbook/mirrors/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/handbook/mirrors/chapter.xml Mon Feb 18 15:53:41 2013 (r41009)
+++ head/en_US.ISO8859-1/books/handbook/mirrors/chapter.xml Mon Feb 18 19:54:21 2013 (r41010)
@@ -1215,23 +1215,10 @@ src-all</programlisting>
In the default configuration, the
<application>CVSup</application> 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
- <filename>doc</filename>, <filename>ports</filename>, or
- <filename>www</filename> trees — most people cannot
- read four or five languages, and therefore they do not need
- to download the language-specific files. If you are
- <application>CVSup</application>ing the Ports Collection,
- you can get around this by specifying each collection
- individually (e.g., <emphasis>ports-astrology</emphasis>,
- <emphasis>ports-biology</emphasis>, etc instead of simply
- saying <emphasis>ports-all</emphasis>). However, since the
- <filename>doc</filename> and <filename>www</filename> trees
- do not have language-specific collections, you must use one
- of <application>CVSup</application>'s many nifty features:
- the <filename>refuse</filename> file.</para>
+ configuration file. In order to download a partial tree
+ use the <filename>refuse</filename> file.</para>
- <para>The <filename>refuse</filename> file essentially tells
+ <para>The <filename>refuse</filename> file tells
<application>CVSup</application> that it should not take
every single file from a collection; in other words, it
tells the client to <emphasis>refuse</emphasis> certain
@@ -1254,33 +1241,12 @@ src-all</programlisting>
translation of documentation, you can put the following in
your <filename>refuse</filename> file:</para>
- <programlisting>doc/bn_*
-doc/da_*
-doc/de_*
-doc/el_*
-doc/es_*
-doc/fr_*
-doc/hu_*
-doc/it_*
-doc/ja_*
-doc/mn_*
-doc/nl_*
-doc/no_*
-doc/pl_*
-doc/pt_*
-doc/ru_*
-doc/sr_*
-doc/tr_*
-doc/zh_*</programlisting>
-
- <para>and so forth for the other languages (you can find the
- full list by browsing the
- <ulink url="http://www.FreeBSD.org/cgi/cvsweb.cgi/">&os; CVS
- repository</ulink>).</para>
+ <programlisting>bin/
+usr.bin/</programlisting>
- <para>With this very useful feature, those users who are on
+ <para>With this very 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
+ connection will be able to save time as they will
no longer need to download files that they will never use.
For more information on <filename>refuse</filename> files
and other neat features of <application>CVSup</application>,
@@ -1372,11 +1338,8 @@ doc/zh_*</programlisting>
hierarchical relationships among collections are reflected by
the use of indentation in the list below.</para>
- <para>The most commonly used collections are
- <literal>src-all</literal>, and
- <literal>ports-all</literal>. The other collections are used
- only by small groups of people for specialized purposes, and
- some mirror sites may not carry all of them.</para>
+ <para>The most commonly used collection is
+ <literal>src-all</literal>. </para>
<variablelist>
<varlistentry>
@@ -1397,630 +1360,6 @@ doc/zh_*</programlisting>
</varlistentry>
<varlistentry>
- <term><literal>ports-all release=cvs</literal></term>
-
- <listitem>
- <para>The &os; Ports Collection.</para>
-
- <important id="cvsup-collec-pbase-warn">
- <para>If you do not want to update the whole of
- <literal>ports-all</literal> (the whole ports
- tree), but use one of the subcollections listed
- below, make sure that you
- <emphasis>always</emphasis> update the
- <literal>ports-base</literal> subcollection!
- Whenever something changes in the ports build
- infrastructure represented by
- <literal>ports-base</literal>, it is virtually
- certain that those changes will be used by
- <quote>real</quote> ports real soon. Thus, if
- you only update the <quote>real</quote> ports
- and they use some of the new features, there is
- a very high chance that their build will fail
- with some mysterious error message. The
- <emphasis>very first</emphasis> thing to do in
- this case is to make sure that your
- <literal>ports-base</literal> subcollection is
- up to date.</para>
- </important>
-
- <important id="cvsup-collec-index-warn">
- <para>If you are going to be building your own
- local copy of <filename>ports/INDEX</filename>,
- you <emphasis>must</emphasis> accept
- <literal>ports-all</literal> (the whole ports
- tree). Building
- <filename>ports/INDEX</filename> with a partial
- tree is not supported. See the <ulink
- url="&url.books.faq;/applications.html#MAKE-INDEX">
- FAQ</ulink>.</para>
- </important>
-
- <variablelist>
- <varlistentry>
- <term><literal>ports-accessibility
- release=cvs</literal></term>
-
- <listitem>
- <para>Software to help disabled users.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><literal>ports-arabic
- release=cvs</literal></term>
-
- <listitem>
- <para>Arabic language support.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><literal>ports-archivers
- release=cvs</literal></term>
-
- <listitem>
- <para>Archiving tools.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><literal>ports-astro
- release=cvs</literal></term>
-
- <listitem>
- <para>Astronomical ports.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><literal>ports-audio
- release=cvs</literal></term>
-
- <listitem>
- <para>Sound support.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><literal>ports-base
- release=cvs</literal></term>
-
- <listitem>
- <para>The Ports Collection build
- infrastructure - various files located in
- the <filename>Mk/</filename> and
- <filename>Tools/</filename> subdirectories
- of <filename>/usr/ports</filename>.</para>
-
- <note>
- <para>Please see the <link
- linkend="cvsup-collec-pbase-warn">important
- warning above</link>: you should
- <emphasis>always</emphasis> update this
- subcollection, whenever you update any
- part of the &os; Ports Collection!</para>
- </note>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><literal>ports-benchmarks
- release=cvs</literal></term>
-
- <listitem>
- <para>Benchmarks.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><literal>ports-biology
- release=cvs</literal></term>
-
- <listitem>
- <para>Biology.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><literal>ports-cad
- release=cvs</literal></term>
-
- <listitem>
- <para>Computer aided design tools.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><literal>ports-chinese
- release=cvs</literal></term>
-
- <listitem>
- <para>Chinese language support.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><literal>ports-comms
- release=cvs</literal></term>
-
- <listitem>
- <para>Communication software.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><literal>ports-converters
- release=cvs</literal></term>
-
- <listitem>
- <para>character code converters.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><literal>ports-databases
- release=cvs</literal></term>
-
- <listitem>
- <para>Databases.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><literal>ports-deskutils
- release=cvs</literal></term>
-
- <listitem>
- <para>Things that used to be on the desktop
- before computers were invented.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><literal>ports-devel
- release=cvs</literal></term>
-
- <listitem>
- <para>Development utilities.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><literal>ports-dns
- release=cvs</literal></term>
-
- <listitem>
- <para>DNS related software.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><literal>ports-editors
- release=cvs</literal></term>
-
- <listitem>
- <para>Editors.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><literal>ports-emulators
- release=cvs</literal></term>
-
- <listitem>
- <para>Emulators for other operating
- systems.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><literal>ports-finance
- release=cvs</literal></term>
-
- <listitem>
- <para>Monetary, financial and related
- applications.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><literal>ports-ftp
- release=cvs</literal></term>
-
- <listitem>
- <para>FTP client and server utilities.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><literal>ports-games
- release=cvs</literal></term>
-
- <listitem>
- <para>Games.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><literal>ports-german
- release=cvs</literal></term>
-
- <listitem>
- <para>German language support.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><literal>ports-graphics
- release=cvs</literal></term>
-
- <listitem>
- <para>Graphics utilities.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><literal>ports-hebrew
- release=cvs</literal></term>
-
- <listitem>
- <para>Hebrew language support.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><literal>ports-hungarian
- release=cvs</literal></term>
-
- <listitem>
- <para>Hungarian language support.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><literal>ports-irc
- release=cvs</literal></term>
-
- <listitem>
- <para>Internet Relay Chat utilities.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><literal>ports-japanese
- release=cvs</literal></term>
-
- <listitem>
- <para>Japanese language support.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><literal>ports-java
- release=cvs</literal></term>
-
- <listitem>
- <para>&java; utilities.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><literal>ports-korean
- release=cvs</literal></term>
-
- <listitem>
- <para>Korean language support.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><literal>ports-lang
- release=cvs</literal></term>
-
- <listitem>
- <para>Programming languages.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><literal>ports-mail
- release=cvs</literal></term>
-
- <listitem>
- <para>Mail software.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><literal>ports-math
- release=cvs</literal></term>
-
- <listitem>
- <para>Numerical computation software.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><literal>ports-misc
- release=cvs</literal></term>
-
- <listitem>
- <para>Miscellaneous utilities.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><literal>ports-multimedia
- release=cvs</literal></term>
-
- <listitem>
- <para>Multimedia software.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><literal>ports-net
- release=cvs</literal></term>
-
- <listitem>
- <para>Networking software.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><literal>ports-net-im
- release=cvs</literal></term>
-
- <listitem>
- <para>Instant messaging software.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><literal>ports-net-mgmt
- release=cvs</literal></term>
-
- <listitem>
- <para>Network management software.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><literal>ports-net-p2p
- release=cvs</literal></term>
-
- <listitem>
- <para>Peer to peer networking.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><literal>ports-news
- release=cvs</literal></term>
-
- <listitem>
- <para>USENET news software.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><literal>ports-palm
- release=cvs</literal></term>
-
- <listitem>
- <para>Software support for
- <trademark class="trade">Palm</trademark>
- series.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><literal>ports-polish
- release=cvs</literal></term>
-
- <listitem>
- <para>Polish language support.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><literal>ports-ports-mgmt
- release=cvs</literal></term>
-
- <listitem>
- <para>Utilities to manage ports and
- packages.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><literal>ports-portuguese
- release=cvs</literal></term>
-
- <listitem>
- <para>Portuguese language support.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><literal>ports-print
- release=cvs</literal></term>
-
- <listitem>
- <para>Printing software.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><literal>ports-russian
- release=cvs</literal></term>
-
- <listitem>
- <para>Russian language support.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><literal>ports-science
- release=cvs</literal></term>
-
- <listitem>
- <para>Science.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><literal>ports-security
- release=cvs</literal></term>
-
- <listitem>
- <para>Security utilities.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><literal>ports-shells
- release=cvs</literal></term>
-
- <listitem>
- <para>Command line shells.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><literal>ports-sysutils
- release=cvs</literal></term>
-
- <listitem>
- <para>System utilities.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><literal>ports-textproc
- release=cvs</literal></term>
-
- <listitem>
- <para>text processing utilities (does not
- include desktop publishing).</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><literal>ports-ukrainian
- release=cvs</literal></term>
-
- <listitem>
- <para>Ukrainian language support.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><literal>ports-vietnamese
- release=cvs</literal></term>
-
- <listitem>
- <para>Vietnamese language support.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><literal>ports-www
- release=cvs</literal></term>
-
- <listitem>
- <para>Software related to the World Wide
- Web.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><literal>ports-x11
- release=cvs</literal></term>
-
- <listitem>
- <para>Ports to support the X window
- system.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><literal>ports-x11-clocks
- release=cvs</literal></term>
-
- <listitem>
- <para>X11 clocks.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><literal>ports-x11-drivers
- release=cvs</literal></term>
-
- <listitem>
- <para>X11 drivers.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><literal>ports-x11-fm
- release=cvs</literal></term>
-
- <listitem>
- <para>X11 file managers.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><literal>ports-x11-fonts
- release=cvs</literal></term>
-
- <listitem>
- <para>X11 fonts and font utilities.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><literal>ports-x11-toolkits
- release=cvs</literal></term>
-
- <listitem>
- <para>X11 toolkits.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><literal>ports-x11-servers
- release=cvs</literal></term>
-
- <listitem>
- <para>X11 servers.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><literal>ports-x11-themes
- release=cvs</literal></term>
-
- <listitem>
- <para>X11 themes.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><literal>ports-x11-wm
- release=cvs</literal></term>
-
- <listitem>
- <para>X11 window managers.</para>
- </listitem>
- </varlistentry>
- </variablelist>
- </listitem>
- </varlistentry>
-
- <varlistentry>
<term>
<literal>projects-all release=cvs</literal>
</term>
@@ -2326,15 +1665,6 @@ doc/zh_*</programlisting>
<para>&os; mailing list archive.</para>
</listitem>
</varlistentry>
-
- <varlistentry>
- <term><literal>www release=current</literal></term>
-
- <listitem>
- <para>The pre-processed &os; WWW site files (not the
- source files). Used by WWW mirror sites.</para>
- </listitem>
- </varlistentry>
</variablelist>
</sect2>
More information about the svn-doc-head
mailing list