svn commit: r50081 - user/gjb/releng-rewrite/en_US.ISO8859-1/articles/freebsd-releng
Glen Barber
gjb at FreeBSD.org
Thu Mar 23 22:04:24 UTC 2017
Author: gjb
Date: Thu Mar 23 22:04:23 2017
New Revision: 50081
URL: https://svnweb.freebsd.org/changeset/doc/50081
Log:
Create a releng-mirrors.xml file.
Reorder the table of contents.
Provide examples of using release.sh for a single, native build as
well as a single, cross built release.
Sponsored by: The FreeBSD Foundation
Added:
user/gjb/releng-rewrite/en_US.ISO8859-1/articles/freebsd-releng/releng-mirrors.xml (contents, props changed)
Modified:
user/gjb/releng-rewrite/en_US.ISO8859-1/articles/freebsd-releng/article.xml
user/gjb/releng-rewrite/en_US.ISO8859-1/articles/freebsd-releng/releng-building.xml
Modified: user/gjb/releng-rewrite/en_US.ISO8859-1/articles/freebsd-releng/article.xml
==============================================================================
--- user/gjb/releng-rewrite/en_US.ISO8859-1/articles/freebsd-releng/article.xml Thu Mar 23 20:57:38 2017 (r50080)
+++ user/gjb/releng-rewrite/en_US.ISO8859-1/articles/freebsd-releng/article.xml Thu Mar 23 22:04:23 2017 (r50081)
@@ -18,6 +18,7 @@
<!ENTITY release.building SYSTEM "./releng-building.xml">
<!ENTITY release.major.version SYSTEM "./releng-major-version.xml">
<!ENTITY release.minor.version SYSTEM "./releng-minor-version.xml">
+<!ENTITY release.mirrors SYSTEM "./releng-mirrors.xml">
<!ENTITY release.terminology SYSTEM "./releng-terminology.xml">
]>
<article xmlns="http://docbook.org/ns/docbook"
@@ -119,19 +120,27 @@
</varlistentry>
<varlistentry>
- <term><xref linkend="releng-wrapup"/></term>
+ <term><xref linkend="releng-building"/></term>
<listitem>
- <para>Wrapping up the release cycle.</para>
+ <para>Information related to the specific procedures to
+ build installation medium.</para>
</listitem>
</varlistentry>
<varlistentry>
- <term><xref linkend="releng-building"/></term>
+ <term><xref linkend="releng-mirrors"/></term>
<listitem>
- <para>Information related to the specific procedures to
- build installation medium.</para>
+ <para>Procedures to publish installation medium.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><xref linkend="releng-wrapup"/></term>
+
+ <listitem>
+ <para>Wrapping up the release cycle.</para>
</listitem>
</varlistentry>
</variablelist>
@@ -331,6 +340,7 @@
&release.major.version;
&release.minor.version;
&release.building;
+ &release.mirrors;
<sect1 xml:id="releng-wrapup">
<title>Wrapping up the Release Cycle</title>
Modified: user/gjb/releng-rewrite/en_US.ISO8859-1/articles/freebsd-releng/releng-building.xml
==============================================================================
--- user/gjb/releng-rewrite/en_US.ISO8859-1/articles/freebsd-releng/releng-building.xml Thu Mar 23 20:57:38 2017 (r50080)
+++ user/gjb/releng-rewrite/en_US.ISO8859-1/articles/freebsd-releng/releng-building.xml Thu Mar 23 22:04:23 2017 (r50081)
@@ -34,7 +34,32 @@
options and environment variables. Support for configuration
files provided support for cross building each architecture
for a release by specifying a separate configuration file for
- each invocation. See &man.release.7; and
+ each invocation.</para>
+
+ <para>As a brief example of using
+ <filename>src/release/release.sh</filename> to build a single
+ release in <filename
+ class="directory">/scratch</filename>:</para>
+
+ <screen>&prompt.root; <userinput>/bin/sh /usr/src/release/release.sh</userinput></screen>
+
+ <para>As a brief example of using
+ <filename>src/release/release.sh</filename> to build a single,
+ cross-built release using a different target directory, create
+ a custom <filename>release.conf</filename> containing:</para>
+
+ <programlisting># release.sh configuration for powerpc/powerpc64
+CHROOTDIR="/scratch-powerpc64"
+TARGET="powerpc"
+TARGET_ARCH="powerpc64"
+KERNEL="GENERIC64"</programlisting>
+
+ <para>Then invoke <filename>src/release/release.sh</filename>
+ as:</para>
+
+ <screen>&prompt.root; <userinput>/bin/sh /usr/src/release/release.sh -c <replaceable>$HOME/release.conf</replaceable></userinput></screen>
+
+ <para>See &man.release.7; and
<filename>src/release/release.conf.sample</filename> for more
details and example usage.</para>
</sect3>
@@ -58,6 +83,10 @@
in addition to configuration files used to build
&branch.head; and &branch.stablex; development
snapshots.</para>
+
+ <para>Using <filename>thermite.sh</filename> is covered in <xref
+ linkend="releng-build-snapshot"/> and <xref
+ linkend="releng-build-release"/>.</para>
</sect3>
</sect2>
Added: user/gjb/releng-rewrite/en_US.ISO8859-1/articles/freebsd-releng/releng-mirrors.xml
==============================================================================
--- /dev/null 00:00:00 1970 (empty, because file is newly added)
+++ user/gjb/releng-rewrite/en_US.ISO8859-1/articles/freebsd-releng/releng-mirrors.xml Thu Mar 23 22:04:23 2017 (r50081)
@@ -0,0 +1,39 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!--
+ The FreeBSD Documentation Project
+
+ $FreeBSD$
+-->
+<sect1 xml:id="releng-mirrors">
+ <title>Publishing &os; Installation Media to Project Mirrors</title>
+
+ <para>This section describes the procedure to publish &os;
+ development snapshots and releases to the Project mirrors.</para>
+
+ <sect2 xml:id="releng-mirrors-staging">
+ <title>Staging &os; Installation Media Images</title>
+
+ <para>Staging &os; snapshots and releases is a two part
+ process:</para>
+
+ <itemizedlist>
+ <listitem>
+ <para>Creating the directory structure to match the hierarchy
+ on <systemitem>ftp-master</systemitem></para>
+ </listitem>
+
+ <listitem>
+ <para>Copying the files to a staging directory on
+ <systemitem>ftp-master</systemitem> before moving the files
+ into <filename class="directory">pub/</filename> to begin
+ propagation to the Project mirrors</para>
+ </listitem>
+ </itemizedlist>
+ </sect2>
+
+ <sect2 xml:id="releng-mirrors-publishing">
+ <title>Publishing &os; Installation Media</title>
+
+ <para> </para>
+ </sect2>
+</sect1>
More information about the svn-doc-user
mailing list