Skip site navigation (1)Skip section navigation (2)
Date:      Fri, 3 Aug 2001 14:33:08 +0300 (EEST)
From:      Vladimir Tchoukharev <chu@h33.erkki.ton.tut.fi>
To:        FreeBSD-gnats-submit@freebsd.org
Subject:   docs/29410: More about RELENG_4_3 in FAQ
Message-ID:  <200108031133.f73BX7A74204@h33.erkki.ton.tut.fi>

next in thread | raw e-mail | index | archive | help

>Number:         29410
>Category:       docs
>Synopsis:       More about RELENG_4_3 in FAQ
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Fri Aug 03 04:40:01 PDT 2001
>Closed-Date:
>Last-Modified:
>Originator:     Vladimir Tchoukharev
>Release:        FreeBSD 4.4-PRERELEASE i386
>Organization:
>Environment:
System: FreeBSD h33.erkki.ton.tut.fi 4.4-PRERELEASE FreeBSD 4.4-PRERELEASE #3: Fri Aug 3 08:56:25 EEST 2001 root@h33.erkki.ton.tut.fi:/usr/obj/usr/src/sys/H33 i386

>Description:

RELENG_4_3 is described well in one part of the handbook, but in FAQ it is
not mentioned and -STABLE seem to be advertized as a secure branch. At least
in the local newsgroups I see many references to FAQ along with this beaten 
question "is STABLE stable".
I tried to make a patch for /usr/doc/en_US.ISO8859-1/books/faq/book.sgml
Some bad links to the handbook are also changed.

Unfortunately I cannot make new docs at the moment to check syntax and all - 
something happend to my jade recently, reinstalling docproj (with depends) 
does not help. Take more care therefore.

Yes, I know about -BEET vs. -RUTABAGA battle :) feel free to change.
Also please clean my English up, I'm not a good speaker I guess.

There is one more ready patch for FAQ with some style changes, 
mainly unification of references to -STABLE and alike.

There is a need to patch handbook too - it has two parts with references
to tags, only one is corrected (in respect to RELENG_4_3). I also see
here people write "there is no such a tag acording to the handbook".
I think I can prepare a patch and send it if this PR will find someone
interested.

I have one more ready patch for FAQ with some style changes,
mainly unification of references to -STABLE and alike.

Bets regards,
V. Tchoukharev
 
>How-To-Repeat:
	
>Fix:


--- book.sgml.orig	Wed Jul 25 08:41:13 2001
+++ book.sgml	Thu Aug  2 23:08:52 2001
@@ -174,15 +174,19 @@
         <answer>
           <para>Version <ulink
             URL="ftp://ftp.FreeBSD.org/pub/FreeBSD/releases/i386/4.3-RELEASE/">4.3</ulink>;
-            is the latest <emphasis>STABLE</emphasis> version; it was
+            is the latest <emphasis>-RELEASE</emphasis> version; it was
             released in April, 2001. This is also the latest
-            <emphasis>RELEASE</emphasis> version.</para>
+            <emphasis>-SECURITY</emphasis> and <emphasis>-STABLE</emphasis> version.</para>
 
-          <para>Briefly explained, <emphasis>-STABLE</emphasis> is aimed
-            at the ISP or other corporate user who wants stability and a
-            low change count over the wizzy new features of the latest
+          <para>Briefly explained, <emphasis>-SECURITY</emphasis>
+            is aimed at all users who want highest security and stability,
+            it is <quote><emphasis>-RELEASE</emphasis> with security patches</quote>.
+            <emphasis>-STABLE</emphasis> is aimed
+            at users who want more new features along with stability
+            higher than that of the latest
             <emphasis>-CURRENT</emphasis> snapshot.  Releases can come
-            from either branch, but you should only use
+            either from <emphasis>-STABLE</emphasis> or from
+            <emphasis>-CURRENT</emphasis> branch, but you should only use
             <emphasis>-CURRENT</emphasis> if you are sure that you are
             prepared for its increased volatility (relative to
             <emphasis>-STABLE</emphasis>, that is).</para>
@@ -204,12 +208,12 @@
 
         <answer>
           <para><ulink
-            URL="../handbook/cutting-edge.html#CURRENT">FreeBSD-CURRENT</ulink>
+            URL="../handbook/cutting-edge.html">FreeBSD-CURRENT</ulink>
             is the development version of the operating system, which will
             in due course become 5.0-RELEASE.  As such, it is really only
             of interest to developers working on the system and die-hard
             hobbyists.  See the <ulink
-            URL="../handbook/cutting-edge.html#CURRENT">relevant
+            URL="../handbook/cutting-edge.html">relevant
             section</ulink> in the <ulink
             URL="../handbook/index.html">handbook</ulink> for details on
             running -CURRENT.</para>
@@ -287,16 +291,18 @@
         <answer>
           <para>Back when FreeBSD 2.0.5 was released, we decided to
             branch FreeBSD development into two parts.  One branch was
-            named <ulink URL="../handbook/stable.html">-STABLE</ulink>,
+            <ulink URL="../handbook/cutting-edge.html">named</ulink> -STABLE,
             with the intention that only well-tested bug fixes and small
             incremental enhancements would be made to it (for Internet
             Service Providers and other commercial enterprises for whom
             sudden shifts or experimental features are quite
-            undesirable).  The other branch was <ulink
-            URL="../handbook/cutting-edge.html#CURRENT">-CURRENT</ulink>,
+            undesirable).  The other branch was -CURRENT,
             which essentially has been one unbroken line leading towards
             5.0-RELEASE (and beyond) since 2.0 was released. If a little
             ASCII art would help, this is how it looks:</para>
+          <para>With release of FreeBSD 4.3 a new <emphasis>-SECURITY</emphasis> branch was
+            introduced, which is a <quote>-RELEASE with security 
+            patches</quote>.</para>
 
           <programlisting>                 2.0
                   |
	
>Release-Note:
>Audit-Trail:
>Unformatted:

To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message




Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200108031133.f73BX7A74204>