- Add some text about csup, mentioning its pros and cons and how to install it

PR:		docs/109034
Submitted by:	Chris Haulmark <chris@sigd.net>
Approved by:	keramida (mentor)

en_US.ISO8859-1/books/handbook/mirrors/chapter.sgml

@@ -889,6 +889,27 @@ Warning: Permanently added 'anoncvs.freebsd.org' (DSA) to the list of known host
 	<application>Sup</application> is no longer used in the FreeBSD
 	project, because <application>CVSup</application> is both faster
 	and more flexible.</para>
+
+      <note>
+	<para>The <application>csup</application> utility is a rewrite of the
+	  <application>CVSup</application> software in C.  Its biggest
+	  advantage is, that it is faster and does not depend on the
+	  Modula-3 language, thus you do not need to install it as a
+	  requirement.  Moreover, if you are using &os; 6.2 or later,
+	  you can use it out-of-the-box, since it is included in the base
+	  system.  Older &os; versions do not have &man.csup.1; in their
+	  base system but can easily install the
+	  <filename role="package">net/csup</filename> port, or a precompiled
+	  package.  The <application>csup</application> utility does not
+	  support CVS mode, though.  If you want to mirror complete
+	  repositories, you will still need to use
+	  <application>CVSup</application>.  If you decided to use
+	  <application>csup</application>, just skip the steps on the
+	  installation of <application>CVSup</application> and
+	  substitute the references of <application>CVSup</application> with
+	  <application>csup</application> while following the remainder of
+	  this article.</para>
+      </note>
     </sect2>
 
     <sect2 id="cvsup-install">
@@ -912,6 +933,14 @@ Warning: Permanently added 'anoncvs.freebsd.org' (DSA) to the list of known host
 	  <application>CVSup</application> <acronym>GUI</acronym>,
 	  <filename role="package">net/cvsup-without-gui</filename>.</para>
 	</note>
+
+      <para>If you want to install <application>csup</application> on
+	FreeBSD 6.1 or earlier, you can use the precompiled
+	<filename role="package">net/csup</filename> package
+	from the FreeBSD <link linkend="ports">packages collection</link>.
+	If you prefer to build <application>csup</application> from source,
+	you can use the <filename role="package">net/csup</filename>
+	port instead.</para>
     </sect2>
 
     <sect2 id="cvsup-config">