Date: Mon, 18 Feb 2013 19:54:21 +0000 (UTC) From: Eitan Adler <eadler@FreeBSD.org> To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r41010 - head/en_US.ISO8859-1/books/handbook/mirrors Message-ID: <201302181954.r1IJsLmd095109@svn.freebsd.org>
next in thread | raw e-mail | index | archive | help
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>
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201302181954.r1IJsLmd095109>