Bug 70124

Summary: [PATCH] add note about cvsup
Product: Documentation Reporter: Joel Dahl <joel>
Component: Books & ArticlesAssignee: freebsd-doc (Nobody) <doc>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   

Description Joel Dahl 2004-08-07 13:50:23 UTC
I get this question all the time, "Why is CVSup not in the base installation of FreeBSD", so maybe we should include it in the FAQ? This patch does that.

Fix: 

http://www.automatvapen.se/freebsd/patches/cvsup.patch
How-To-Repeat: n/a
Comment 1 Peter Pentchev 2004-08-10 11:39:33 UTC
On Sat, Aug 07, 2004 at 12:48:53PM +0000, Joel Dahl wrote:
> 
> >Number:         70124
> >Category:       docs
> >Synopsis:       [PATCH] add note about cvsup
> >Description:
> I get this question all the time, "Why is CVSup not in the base
> installation of FreeBSD", so maybe we should include it in the FAQ?
> This patch does that.   

What do you think about the following patch, which explains the problem
a bit more thoroughly? :)

G'luck,
Peter

Index: doc/en_US.ISO8859-1/books/faq/book.sgml
===================================================================
RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/faq/book.sgml,v
retrieving revision 1.639
diff -u -r1.639 book.sgml
--- doc/en_US.ISO8859-1/books/faq/book.sgml	9 Aug 2004 19:49:17 -0000	1.639
+++ doc/en_US.ISO8859-1/books/faq/book.sgml	10 Aug 2004 10:37:45 -0000
@@ -5060,6 +5060,30 @@
       </qandaentry>
 
       <qandaentry>
+        <question id="cvsup-in-base">
+	  <para>Why is CVSup not integrated in the main FreeBSD tree?
+	  </para>
+	</question>
+
+	<answer>
+	  <para>The FreeBSD base system is designed as self-hosting - it
+	    should be possible to build the whole operating system starting
+	    with a very limited set of tools.  Thus, the actual build tools
+	    needed to compile the FreeBSD sources are bundled with the
+	    sources themselves.  This includes a C compiler (&man.gcc.1;),
+	    &man.make.1;, &man.awk.1;, and similar tools.</para>
+
+	  <para>Since CVSup is written in Modula-3, adding it to the FreeBSD
+	    base system would also require adding and maintaining a Modula-3
+	    compiler.  This would lead to both a growth in the disk space
+	    consumed by the FreeBSD sources and additional maintenance work.
+	    Thus, it is much easier for both the developers and users to
+	    keep CVSup as a separate port, which can be easily installed as
+	    a package bundled on the FreeBSD installation CD's.</para>
+	</answer>
+      </qandaentry>
+
+      <qandaentry>
         <question id="ports-update">
            <para>I updated the sources, now how do I update my installed
              ports?</para>

-- 
Peter Pentchev	roam@ringlet.net    roam@cnsys.bg    roam@FreeBSD.org
PGP key:	http://people.FreeBSD.org/~roam/roam.key.asc
Key fingerprint	FDBA FD79 C26F 3C51 C95E  DF9E ED18 B68D 1619 4553
If the meanings of 'true' and 'false' were switched, then this sentence wouldn't be false.
Comment 2 Joel Dahl 2004-08-10 17:15:45 UTC
Tis 2004-08-10 klockan 12.39 skrev Peter Pentchev:
> On Sat, Aug 07, 2004 at 12:48:53PM +0000, Joel Dahl wrote:
> > 
> > >Number:         70124
> > >Category:       docs
> > >Synopsis:       [PATCH] add note about cvsup
> > >Description:
> > I get this question all the time, "Why is CVSup not in the base
> > installation of FreeBSD", so maybe we should include it in the FAQ?
> > This patch does that.   
> 
> What do you think about the following patch, which explains the problem
> a bit more thoroughly? :)
> 
> G'luck,
> Peter
> 
> Index: doc/en_US.ISO8859-1/books/faq/book.sgml
> ===================================================================
> RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/faq/book.sgml,v
> retrieving revision 1.639
> diff -u -r1.639 book.sgml
> --- doc/en_US.ISO8859-1/books/faq/book.sgml	9 Aug 2004 19:49:17 -0000	1.639
> +++ doc/en_US.ISO8859-1/books/faq/book.sgml	10 Aug 2004 10:37:45 -0000
> @@ -5060,6 +5060,30 @@
>        </qandaentry>
>  
>        <qandaentry>
> +        <question id="cvsup-in-base">
> +	  <para>Why is CVSup not integrated in the main FreeBSD tree?
> +	  </para>
> +	</question>
> +
> +	<answer>
> +	  <para>The FreeBSD base system is designed as self-hosting - it
> +	    should be possible to build the whole operating system starting
> +	    with a very limited set of tools.  Thus, the actual build tools
> +	    needed to compile the FreeBSD sources are bundled with the
> +	    sources themselves.  This includes a C compiler (&man.gcc.1;),
> +	    &man.make.1;, &man.awk.1;, and similar tools.</para>
> +
> +	  <para>Since CVSup is written in Modula-3, adding it to the FreeBSD
> +	    base system would also require adding and maintaining a Modula-3
> +	    compiler.  This would lead to both a growth in the disk space
> +	    consumed by the FreeBSD sources and additional maintenance work.
> +	    Thus, it is much easier for both the developers and users to
> +	    keep CVSup as a separate port, which can be easily installed as
> +	    a package bundled on the FreeBSD installation CD's.</para>
> +	</answer>
> +      </qandaentry>
> +
> +      <qandaentry>
>          <question id="ports-update">
>             <para>I updated the sources, now how do I update my installed
>               ports?</para>

This looks a lot better than my minimalistic patch. Thanks! :)

-- 
Joel
Comment 3 Peter Pentchev freebsd_committer freebsd_triage 2004-08-10 18:32:34 UTC
State Changed
From-To: open->closed

I committed my version of the patch.  Thanks!