Date: Wed, 18 Apr 2012 08:15:56 +0000 (UTC) From: Hiroki Sato <hrs@FreeBSD.org> To: src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-stable@freebsd.org, svn-src-stable-8@freebsd.org Subject: svn commit: r234413 - in stable/8/release/doc: en_US.ISO8859-1 en_US.ISO8859-1/installation share/sgml Message-ID: <201204180815.q3I8Fu5g021609@svn.freebsd.org>
next in thread | raw e-mail | index | archive | help
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@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/">;
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201204180815.q3I8Fu5g021609>