svn commit: r234413 - in stable/8/release/doc: en_US.ISO8859-1
en_US.ISO8859-1/installation share/sgml
Hiroki Sato
hrs at FreeBSD.org
Wed Apr 18 08:15:56 UTC 2012
Author: hrs
Date: Wed Apr 18 08:15:55 2012
New Revision: 234413
URL: http://svn.freebsd.org/changeset/base/234413
Log:
Add installation/upgrade instructions for 8.3R.
Added:
stable/8/release/doc/en_US.ISO8859-1/installation/
stable/8/release/doc/en_US.ISO8859-1/installation/Makefile (contents, props changed)
stable/8/release/doc/en_US.ISO8859-1/installation/article.sgml (contents, props changed)
Modified:
stable/8/release/doc/en_US.ISO8859-1/Makefile
stable/8/release/doc/share/sgml/release.ent
Modified: stable/8/release/doc/en_US.ISO8859-1/Makefile
==============================================================================
--- stable/8/release/doc/en_US.ISO8859-1/Makefile Wed Apr 18 07:02:53 2012 (r234412)
+++ stable/8/release/doc/en_US.ISO8859-1/Makefile Wed Apr 18 08:15:55 2012 (r234413)
@@ -6,6 +6,7 @@ SUBDIR = relnotes
SUBDIR+= hardware
SUBDIR+= readme
SUBDIR+= errata
+SUBDIR+= installation
COMPAT_SYMLINK = en
Added: stable/8/release/doc/en_US.ISO8859-1/installation/Makefile
==============================================================================
--- /dev/null 00:00:00 1970 (empty, because file is newly added)
+++ stable/8/release/doc/en_US.ISO8859-1/installation/Makefile Wed Apr 18 08:15:55 2012 (r234413)
@@ -0,0 +1,19 @@
+# $FreeBSD$
+
+RELN_ROOT?= ${.CURDIR}/../..
+.ifdef NO_LANGCODE_IN_DESTDIR
+DESTDIR?= ${DOCDIR}/installation
+.else
+DESTDIR?= ${DOCDIR}/en_US.ISO8859-1/installation
+.endif
+
+DOC?= article
+FORMATS?= html
+INSTALL_COMPRESSED?= gz
+INSTALL_ONLY_COMPRESSED?=
+
+# SGML content
+SRCS+= article.sgml
+
+.include "${RELN_ROOT}/share/mk/doc.relnotes.mk"
+.include "${DOC_PREFIX}/share/mk/doc.project.mk"
Added: stable/8/release/doc/en_US.ISO8859-1/installation/article.sgml
==============================================================================
--- /dev/null 00:00:00 1970 (empty, because file is newly added)
+++ stable/8/release/doc/en_US.ISO8859-1/installation/article.sgml Wed Apr 18 08:15:55 2012 (r234413)
@@ -0,0 +1,111 @@
+<!DOCTYPE article PUBLIC "-//FreeBSD//DTD DocBook V4.1-Based Extension//EN" [
+<!ENTITY % articles.ent PUBLIC "-//FreeBSD//ENTITIES DocBook FreeBSD Articles Entity Set//EN">
+%articles.ent;
+
+<!ENTITY % release PUBLIC "-//FreeBSD//ENTITIES Release Specification//EN">
+%release;
+]>
+
+<article>
+ <articleinfo>
+ <title>&os; &release.current; Installation Instructions</title>
+
+ <corpauthor>The &os; Project</corpauthor>
+
+ <pubdate>$FreeBSD$</pubdate>
+
+ <copyright>
+ <year>2012</year>
+
+ <holder role="mailto:doc at FreeBSD.org">The &os; Documentation Project</holder>
+ </copyright>
+
+ <legalnotice id="trademarks" role="trademarks">
+ &tm-attrib.freebsd;
+ &tm-attrib.intel;
+ &tm-attrib.sparc;
+ &tm-attrib.general;
+ </legalnotice>
+ </articleinfo>
+
+ <abstract>
+ <para>This article gives some brief instructions on installing
+ &os; &release.current; and upgrading the systems running earlier
+ releases.</para>
+ </abstract>
+
+ <sect1 id="install">
+ <title>Installing &os;</title>
+
+ <para>For instructions on installing FreeBSD, please see Chapter 2
+ of The FreeBSD Handbook. It provides a complete installation
+ walk-through for users new to FreeBSD, and can be found online
+ at: <ulink
+ url="&url.books.handbook;/install.html"></ulink></para>
+ </sect1>
+
+ <sect1 id="upgrade">
+ <title>Upgrading &os;</title>
+
+ <sect2>
+ <title>Upgrading from Source</title>
+
+ <para>The procedure for doing a source code based update is
+ described in
+ <ulink url="&url.books.handbook;/synching.html"></ulink> and
+ <ulink url="&url.books.handbook;//makeworld.html"></ulink>.</para>
+
+ <para>The branch tag to use for updating the source is
+ <literal>RELENG_8_3</literal> for CVS. For SVN use
+ <filename>releng/8.3</filename>.</para>
+ </sect2>
+
+ <sect2>
+ <title>Upgrading Using <quote>&os; Update</quote></title>
+
+ <para>The &man.freebsd-update.8; utility supports binary
+ upgrades of &arch.i386; and &arch.amd64; systems running
+ earlier FreeBSD releases. Systems running
+ <literal>7.[01234]-RELEASE</literal>,
+ <literal>8.[012]-RELEASE</literal>,
+ <literal>8.3-BETA1</literal>, or
+ <literal>8.3-RC[12]</literal> can upgrade as follows:</para>
+
+ <screen>&prompt.root; freebsd-update upgrade -r 8.3-RELEASE</screen>
+
+ <para>During this process, FreeBSD Update may ask the user to
+ help by merging some configuration files or by confirming that
+ the automatically performed merging was done correctly.</para>
+
+ <screen>&prompt.root; freebsd-update install</screen>
+
+ <para>The system must be rebooted with the newly installed
+ kernel before continuing.</para>
+
+ <screen>&prompt.root; shutdown -r now</screen>
+
+ <para>After rebooting, &man.freebsd-update.8; needs to be run
+ again to install the new userland components:</para>
+
+ <screen>&prompt.root; freebsd-update install</screen>
+
+ <para>At this point, users of systems being upgraded from
+ FreeBSD 7.4-RELEASE or earlier will be prompted by
+ freebsd-update to rebuild all third-party applications (e.g.,
+ ports installed from the ports tree) due to updates in system
+ libraries.</para>
+
+ <para>After updating installed third-party applications (and
+ again, only if &man.freebsd-update.8; printed a message
+ indicating that this was necessary), run
+ &man.freebsd-update.8; again so that it can delete the old (no
+ longer used) system libraries:</para>
+
+ <screen>&prompt.root; freebsd-update install</screen>
+
+ <para>Finally, reboot into &release.current;</para>
+
+ <screen>&prompt.root; shutdown -r now</screen>
+ </sect2>
+ </sect1>
+</article>
Modified: stable/8/release/doc/share/sgml/release.ent
==============================================================================
--- stable/8/release/doc/share/sgml/release.ent Wed Apr 18 07:02:53 2012 (r234412)
+++ stable/8/release/doc/share/sgml/release.ent Wed Apr 18 08:15:55 2012 (r234413)
@@ -6,18 +6,18 @@
<!-- Version of the OS we're describing. This needs to be updated
with each new release. -->
-<!ENTITY release.current "8.2-RELEASE">
+<!ENTITY release.current "8.3-RELEASE">
<!-- The previous version used for comparison in the "What's New"
section. For -CURRENT, we might point back to the last
branchpoint. -->
-<!ENTITY release.prev "8.1-RELEASE">
+<!ENTITY release.prev "8.2-RELEASE">
<!-- The next version to be released, usually used for snapshots. -->
-<!ENTITY release.next "8.3-RELEASE">
+<!ENTITY release.next "8.4-RELEASE">
<!-- The name of this branch. -->
-<!ENTITY release.branch "8.2-STABLE">
+<!ENTITY release.branch "8.3-STABLE">
<!-- The URL for obtaining this version of FreeBSD. -->
<!ENTITY release.url "ftp://ftp.FreeBSD.org/">
More information about the svn-src-stable-8
mailing list