Date: Thu, 23 Mar 2017 22:04:23 +0000 (UTC) From: Glen Barber <gjb@FreeBSD.org> To: doc-committers@freebsd.org, svn-doc-user@freebsd.org Subject: svn commit: r50081 - user/gjb/releng-rewrite/en_US.ISO8859-1/articles/freebsd-releng Message-ID: <201703232204.v2NM4Njq034784@repo.freebsd.org>
next in thread | raw e-mail | index | archive | help
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>
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201703232204.v2NM4Njq034784>