os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

Remove references to FreeBSD 6.x from the FAQ:

Browse source 
o Created local ENTITYs, which will make updating this chapter much
  easier next time we have major version numbers increase:
 - 10-CURRENT:
  . rel.head: 10-CURRENT
  . rel.head.relx: 10.x
  . rel.head.releng: HEAD
  . rel.head.packages: packages-9-current [1]
 - 9.x, 8.x, 7.x:
  . rel.relx, rel2.relx, rel3.relx: - 9.x, 8.x, 7.x
  . rel.stable, rel2.stable, rel3.stable: 9-, 8-, 7-STABLE
  . rel.releng, rel2.releng, rel3.releng: RELENG_9, _8, _7
  . rel.relengdate, rel2.relengdate, rel3.relengdate: branch date
     from UPDATING
  . rel.packages, rel2.packages, rel3.packages: packages-{9,8,7}-stable
  . rel3.current: local definition of "7.4"

o These entities now replace areas within this chapter where all
  versions of FreeBSD were specified (previously 6.x, 7.x, 8.x, 9-CURRENT).

o Bump copyright year.

[1] The 'packages-10-current' directory on the FTP site is empty,
and packages-9-current is still being populated.  This can be easily
switched to 'packages-10-current' later.
This commit is contained in:
Glen Barber 2012-02-19 00:18:34 +00:00
parent 3e6c956203
commit 0622501d94
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/head/; revision=38486
1 changed files with 83 additions and 54 deletions

137
en_US.ISO8859-1/books/faq/book.sgml
View file

@ -2,13 +2,32 @@
<!ENTITY % books.ent PUBLIC "-//FreeBSD//ENTITIES DocBook FreeBSD Books Entity Set//EN">
%books.ent;
<!ENTITY bibliography SYSTEM "../../../share/sgml/bibliography.sgml">
<!ENTITY rel.head "<emphasis>10-CURRENT</emphasis>">
<!ENTITY rel.head.relx "10.<replaceable>X</replaceable>">
<!ENTITY rel.head.releng "<symbol>HEAD</symbol>">
<!ENTITY rel.head.packages "packages-9-current">
<!ENTITY rel.relx "9.<replaceable>X</replaceable>">
<!ENTITY rel.stable "<emphasis>9-STABLE</emphasis>">
<!ENTITY rel.releng "<symbol>RELENG_9</symbol>">
<!ENTITY rel.relengdate "September 2011">
<!ENTITY rel.packages "packages-9-stable">
<!ENTITY rel2.relx "8.<replaceable>X</replaceable>">
<!ENTITY rel2.stable "<emphasis>8-STABLE</emphasis>">
<!ENTITY rel2.releng "<symbol>RELENG_8</symbol>">
<!ENTITY rel2.relengdate "August 2009">
<!ENTITY rel2.packages "packages-8-stable">
<!ENTITY rel3.current "7.4">
<!ENTITY rel3.relx "7.<replaceable>X</replaceable>">
<!ENTITY rel3.stable "<emphasis>7-STABLE</emphasis>">
<!ENTITY rel3.releng "<symbol>RELENG_7</symbol>">
<!ENTITY rel3.relengdate "October 2007">
<!ENTITY rel3.packages "packages-7-stable">
]>
<book>
<bookinfo>
<title>Frequently Asked Questions for &os;
6.<replaceable>X</replaceable>, 7.<replaceable>X</replaceable> and
8.<replaceable>X</replaceable></title>
&rel3.relx;, &rel2.relx;, and &rel.relx;</title>
<corpauthor>The &os; Documentation Project</corpauthor>
@ -32,6 +51,7 @@
<year>2009</year>
<year>2010</year>
<year>2011</year>
<year>2012</year>
<holder>The &os; Documentation Project</holder>
</copyright>
@ -63,9 +83,9 @@
<abstract>
<para>This is the FAQ for &os; versions
6.<replaceable>X</replaceable>, 7.<replaceable>X</replaceable>
and 8.<replaceable>X</replaceable>. All entries are assumed to be
relevant to &os; 6.<replaceable>X</replaceable> and later,
&rel3.relx;, &rel2.relx; and &rel.relx;.
All entries are assumed to be
relevant to &os; &rel3.relx; and later,
unless otherwise noted. If you are interested in helping with
this project, send email to the &a.doc;. The latest version of
this document is always available from the <ulink
@ -84,8 +104,8 @@
<title>Introduction</title>
<para>Welcome to the &os;
6.<replaceable>X</replaceable>-, 7.<replaceable>X</replaceable>- and
8.<replaceable>X</replaceable> FAQ!</para>
&rel3.relx;&nbsp;-, &rel2.relx;&nbsp;- and &rel.relx;&nbsp;-
FAQ!</para>
<para>As is usual with Usenet FAQs, this document aims to cover the
most frequently asked questions concerning the &os; operating
@ -295,31 +315,29 @@
-->
<answer>
<para>At this point in &os;'s development, there are two
parallel development branches; releases are being made from
both branches. 7.<replaceable>X</replaceable> releases are
made from the <emphasis>7-STABLE</emphasis> branch and
8.<replaceable>X</replaceable> releases from the
<emphasis>8-STABLE</emphasis> branch.</para>
<para>At any point in the development of &os;, there can be
multiple parallel branches. &rel.relx; releases are
made from the &rel.stable; branch, and &rel2.relx;
releases are made from the &rel2.stable; branch.</para>
<para>Up until the release of 8.0, the
7.<replaceable>X</replaceable> series was the one known as
&rel3.relx; series was the one known as
<emphasis>-STABLE</emphasis>. However, as of 8.0, the
7.<replaceable>X</replaceable> branch will be designated for
&rel3.relx; branch will be designated for
an <quote>extended support</quote> status and receive only
fixes for major problems, such as security-related fixes.
There will be more releases made from the
<emphasis>7-STABLE</emphasis> branch, but it is considered a
There will be no more releases made from the
&rel3.stable; branch, and it is considered a
<quote>legacy</quote> branch and most current work will only
become a part of <emphasis>8-STABLE</emphasis>.</para>
become a part of &rel.stable; and &rel2.stable;.</para>
<para>Version <ulink
url="ftp://ftp.FreeBSD.org/pub/FreeBSD/releases/i386/&rel.current;-RELEASE/">&rel.current;</ulink>
is the latest release from the <emphasis>8-STABLE</emphasis>
url="ftp://ftp.FreeBSD.org/pub/FreeBSD/releases/i386/i386/&rel.current;-RELEASE/">&rel.current;</ulink>
is the latest release from the &rel.stable;
branch; it was released in &rel.current.date;. Version
<ulink
url="ftp://ftp.FreeBSD.org/pub/FreeBSD/releases/i386/&rel2.current;-RELEASE/">&rel2.current;</ulink>
is the latest release from the <emphasis>7-STABLE</emphasis>
is the latest release from the &rel2.stable;
branch; it was released in &rel2.current.date;.</para>
<para>Briefly, <emphasis>-STABLE</emphasis> is aimed at the
@ -477,7 +495,7 @@
the &rel.current;-STABLE branch is &rel.current;-RELEASE,
which was released in &rel.current.date;.</para>
<para>The 9-CURRENT branch is the actively developed
<para>The &rel.head; branch is the actively developed
<emphasis>-CURRENT</emphasis> branch toward the next
generation of &os;. See <link
linkend="current">What is &os;-CURRENT?</link> for more
@ -550,9 +568,9 @@
<itemizedlist>
<listitem>
<para>The latest 8-STABLE release, &rel.current;-RELEASE
<para>The latest &rel.stable; release, &rel.current;-RELEASE
can be found in the <ulink
url="ftp://ftp.FreeBSD.org/pub/FreeBSD/releases/i386/&rel.current;-RELEASE/">&rel.current;-RELEASE directory</ulink>.
url="ftp://ftp.FreeBSD.org/pub/FreeBSD/releases/i386/i386/&rel.current;-RELEASE/">&rel.current;-RELEASE directory</ulink>.
</para>
</listitem>
@ -566,11 +584,18 @@
</listitem>
<listitem>
<para>The latest 7-STABLE release, &rel2.current;-RELEASE
<para>The latest &rel2.stable; release, &rel2.current;-RELEASE
can be found in the <ulink
url="ftp://ftp.FreeBSD.org/pub/FreeBSD/releases/i386/&rel2.current;-RELEASE/">&rel2.current;-RELEASE directory</ulink>.
</para>
</listitem>
<listitem>
<para>The latest &rel3.stable; release, &rel3.current;-RELEASE
can be found in the <ulink
url="ftp://ftp.FreeBSD.org/pub/FreeBSD/releases/i386/&rel3.current;-RELEASE/">&rel3.current;-RELEASE directory</ulink>.
</para>
</listitem>
</itemizedlist>
<para>Information about obtaining &os; on CD, DVD, and other
@ -4225,9 +4250,8 @@ kern.timecounter.hardware: TSC -&gt; i8254</screen>
periodic updates on new entries.</para>
<para>Most ports should work on the
6.<replaceable>X</replaceable>,
7.<replaceable>X</replaceable> and
8.<replaceable>X</replaceable> branches. Each time a &os;
&rel3.relx;, &rel2.relx;, and &rel.relx; branches.
Each time a &os;
release is made, a snapshot of the ports tree at the time of
release in also included in the <filename class="directory">ports/</filename>
directory.</para>
@ -4253,41 +4277,41 @@ kern.timecounter.hardware: TSC -&gt; i8254</screen>
<variablelist>
<varlistentry>
<term>for 6.<replaceable>X</replaceable>-RELEASE/6-STABLE</term>
<term>for &rel3.relx;&nbsp;-RELEASE/&rel3.stable;</term>
<listitem>
<para><ulink
url="ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/i386/packages-6-stable/">ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/i386/packages-6-stable</ulink>
url="ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/i386/&rel3.packages;/">ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/i386/&rel3.packages;</ulink>
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>for 7.<replaceable>X</replaceable>-RELEASE/7-STABLE</term>
<term>for &rel2.relx;&nbsp;-RELEASE/&rel2.stable;</term>
<listitem>
<para><ulink
url="ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/i386/packages-7-stable/">ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/i386/packages-7-stable</ulink>
url="ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/i386/&rel2.packages;/">ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/i386/&rel2.packages;</ulink>
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>for 8.<replaceable>X</replaceable>-RELEASE/8-STABLE</term>
<term>for &rel.relx;&nbsp;-RELEASE/&rel.stable;</term>
<listitem>
<para><ulink
url="ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/i386/packages-8-stable/">ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/i386/packages-8-stable</ulink>
url="ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/i386/&rel.packages;/">ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/i386/&rel.packages;</ulink>
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>for 9-CURRENT</term>
<term>for &rel.head;</term>
<listitem>
<para><ulink
url="ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/i386/packages-9-current/">ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/i386/packages-9-current</ulink>
url="ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/i386/&rel.head.packages;/">ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/i386/&rel.head.packages;</ulink>
</para>
</listitem>
</varlistentry>
@ -4334,8 +4358,8 @@ kern.timecounter.hardware: TSC -&gt; i8254</screen>
<qandaentry>
<question id="ports-4x">
<para>Why can I not build this port on my
6.<replaceable>X</replaceable>, 7.<replaceable>X</replaceable> or
8.<replaceable>X</replaceable>-STABLE machine?</para>
&rel3.relx;&nbsp;-, &rel2.relx;&nbsp;-, or
&rel.relx;&nbsp;-STABLE machine?</para>
</question>
<answer>
@ -10656,44 +10680,49 @@ hint.sio.7.irq="12"</programlisting>
</question>
<answer>
<para>There are currently three active/semi-active branches in
<para>There are currently four active/semi-active branches in
the &os; <ulink
url="http://www.FreeBSD.org/cgi/cvsweb.cgi">CVS Repository</ulink>.
(Earlier branches are only changed very rarely, which is why
there are only three active branches of development):</para>
there are only four active branches of development):</para>
<itemizedlist>
<listitem>
<para><literal>RELENG_7</literal> AKA
<emphasis>7-STABLE</emphasis></para>
<para>&rel3.releng; AKA
&rel3.stable;</para>
</listitem>
<listitem>
<para><literal>RELENG_8</literal> AKA
<emphasis>8-STABLE</emphasis></para>
<para>&rel2.releng; AKA
&rel2.stable;</para>
</listitem>
<listitem>
<para><literal>HEAD</literal> AKA
<para>&rel.releng; AKA
&rel.stable;</para>
</listitem>
<listitem>
<para>&rel.head.releng; AKA
<emphasis>-CURRENT</emphasis> AKA
<emphasis>9-CURRENT</emphasis></para>
&rel.head;</para>
</listitem>
</itemizedlist>
<para><literal>HEAD</literal> is not an actual branch tag,
like the other two; it is simply a symbolic constant for
like the others; it is simply a symbolic constant for
<quote><emphasis>the current, non-branched development
stream</emphasis></quote> which we simply refer to as
<emphasis>-CURRENT</emphasis>.</para>
<para>Right now, <emphasis>-CURRENT</emphasis> is the
9.<replaceable>X</replaceable> development stream; the
<literal>7-STABLE</literal> branch,
<symbol>RELENG_7</symbol>, forked off from
<emphasis>-CURRENT</emphasis> in February 2008 and the
<literal>8-STABLE</literal> branch,
<symbol>RELENG_8</symbol>, forked off from
<emphasis>-CURRENT</emphasis> in November 2009.</para>
&rel.head.relx; development stream; the
&rel.stable; branch,
&rel.releng;, forked off from
<emphasis>-CURRENT</emphasis> in &rel.relengdate; and the
&rel2.stable; branch,
&rel2.releng;, forked off from
<emphasis>-CURRENT</emphasis> in &rel2.relengdate;.</para>
</answer>
</qandaentry>