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