diff options
Diffstat (limited to 'en_US.ISO8859-1/articles/releng/article.xml')
-rw-r--r-- | en_US.ISO8859-1/articles/releng/article.xml | 145 |
1 files changed, 66 insertions, 79 deletions
diff --git a/en_US.ISO8859-1/articles/releng/article.xml b/en_US.ISO8859-1/articles/releng/article.xml index 58d04fef88..119185d138 100644 --- a/en_US.ISO8859-1/articles/releng/article.xml +++ b/en_US.ISO8859-1/articles/releng/article.xml @@ -1,41 +1,33 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!DOCTYPE article PUBLIC "-//FreeBSD//DTD DocBook XML V4.5-Based Extension//EN" - "../../../share/xml/freebsd45.dtd" [ -<!ENTITY art.re.pkgs '<ulink url="&url.articles.releng-packages;/article.html">The Release Engineering of Third Party Packages</ulink>'> +<!DOCTYPE article PUBLIC "-//FreeBSD//DTD DocBook XML V5.0-Based Extension//EN" + "../../../share/xml/freebsd50.dtd" [ +<!ENTITY art.re.pkgs '<link xmlns="http://docbook.org/ns/docbook" xlink:href="{{{url.articles.releng-packages}}}/article.html">The Release Engineering of Third Party Packages</link>'> ]> +<article xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en"> + + <info><title>&os; Release Engineering</title> -<article lang='en'> - <title>&os; Release Engineering</title> - <articleinfo> - - <!-- This paper was presented at BSDCon Europe in Brighton, UK on - November 11, 2001. --> - <!-- The content in this paper was updated in March 2013 to - reflect the current FreeBSD Release process. --> + + <confgroup> <confdates>November 2001</confdates> <conftitle>BSDCon Europe</conftitle> </confgroup> <authorgroup> - <author> - <firstname>Murray</firstname> - <surname>Stokely</surname> - <authorblurb> + <author><personname><firstname>Murray</firstname><surname>Stokely</surname></personname><personblurb> <para>I've been involved in the development of &os; based products since 1997 at Walnut Creek CDROM, BSDi, and now Wind River Systems. &os; 4.4 was the first official release of &os; that I played a significant part in.</para> - </authorblurb> - <affiliation> + </personblurb><affiliation> <address><email>murray@FreeBSD.org</email> - <otheraddr><ulink url="http://www.FreeBSD.org/~murray/"></ulink></otheraddr> + <otheraddr xlink:href="http://www.FreeBSD.org/~murray/">http://www.FreeBSD.org/~murray/</otheraddr> </address> - </affiliation> - </author> + </affiliation></author> </authorgroup> - <legalnotice id="trademarks" role="trademarks"> + <legalnotice xml:id="trademarks" role="trademarks"> &tm-attrib.freebsd; &tm-attrib.cvsup; &tm-attrib.intel; @@ -64,10 +56,10 @@ productization.</para> </abstract> - </articleinfo> + </info> <!-- Introduction --> -<sect1 id="introduction"> +<sect1 xml:id="introduction"> <title>Introduction</title> <para>The development of &os; is a very open process. &os; is @@ -76,7 +68,7 @@ Subversion <footnote> <simpara> - Subversion, <ulink url="http://subversion.apache.org"></ulink> + Subversion, <uri xlink:href="http://subversion.apache.org">http://subversion.apache.org</uri> </simpara> </footnote> access to the general public so that @@ -88,22 +80,22 @@ access to the main repository was opened up to everyone on the Internet. Therefore only a <quote>select</quote> group of nearly 300 people are given write access to the Subversion repository. These - <ulink url="&url.articles.contributors;/article.html#staff-committers">committers</ulink> + <link xlink:href="&url.articles.contributors;/article.html#staff-committers">committers</link> <footnote> <simpara> - <ulink url="&url.articles.contributors;/article.html#staff-committers">FreeBSD committers</ulink> + <link xlink:href="&url.articles.contributors;/article.html#staff-committers">FreeBSD committers</link> </simpara> </footnote> are usually the people who do the bulk of &os; development. An elected - <ulink url="&url.base;/administration.html#t-core">Core Team</ulink> + <link xlink:href="&url.base;/administration.html#t-core">Core Team</link> <footnote> <simpara> - <ulink url="&url.base;/administration.html#t-core">&os; Core Team</ulink> + <link xlink:href="&url.base;/administration.html#t-core">&os; Core Team</link> </simpara> </footnote> of developers provide some level of direction over the project.</para> - <para>The rapid pace of <systemitem class="osname">&os;</systemitem> + <para>The rapid pace of <systemitem>&os;</systemitem> development makes the main development branch unsuitable for the everyday use by the general public. In particular, stabilizing efforts are required for polishing the development system into a @@ -137,15 +129,14 @@ <para>In the interim period between releases, weekly snapshots are built automatically by the &os; Project build machines and made - available for download from <systemitem - class="resource">ftp://ftp.FreeBSD.org/pub/FreeBSD/snapshots/</systemitem>. + available for download from <systemitem>ftp://ftp.FreeBSD.org/pub/FreeBSD/snapshots/</systemitem>. The widespread availability of binary release snapshots, and the tendency of our user community to keep up with -STABLE development with Subversion and <quote><command>make</command> - <maketarget>buildworld</maketarget></quote> + <buildtarget>buildworld</buildtarget></quote> <footnote> <simpara> - <ulink url="&url.books.handbook;/makeworld.html">Rebuilding "world"</ulink> + <link xlink:href="&url.books.handbook;/makeworld.html">Rebuilding "world"</link> </simpara> </footnote> helps to keep @@ -158,8 +149,7 @@ <application>VirtualBox</application>, <application>qemu</application>, or other popular emulation software. The virtual machine images can be downloaded from - <systemitem - class="resource">ftp://ftp.FreeBSD.org/pub/FreeBSD/snapshots/VM-IMAGES/</systemitem>.</para> + <systemitem>ftp://ftp.FreeBSD.org/pub/FreeBSD/snapshots/VM-IMAGES/</systemitem>.</para> <para>The virtual machine images are approximately 150MB &man.xz.1; compressed, and contain a 10GB sparse filesystem when attached to @@ -167,16 +157,15 @@ <para>Bug reports and feature requests are continuously submitted by users throughout the release cycle. Problems reports are entered into our - <application class="software">GNATS</application> database + <application>GNATS</application> database <footnote> <simpara> GNATS: The GNU Bug Tracking System - <ulink url="http://www.gnu.org/software/gnats"></ulink> + <uri xlink:href="http://www.gnu.org/software/gnats">http://www.gnu.org/software/gnats</uri> </simpara> </footnote> through email, the &man.send-pr.1; application, or via the web - interface provided at <ulink - url="http://www.FreeBSD.org/send-pr.html"></ulink>.</para> + interface provided at <uri xlink:href="http://www.FreeBSD.org/send-pr.html">http://www.FreeBSD.org/send-pr.html</uri>.</para> <para>To service our most conservative users, individual release branches were introduced with &os; 4.3. @@ -239,7 +228,7 @@ </sect1> <!-- Release Process --> -<sect1 id="release-proc"> +<sect1 xml:id="release-proc"> <title>Release Process</title> <para>New releases of &os; are released from the -STABLE branch @@ -330,7 +319,7 @@ widespread testing and all major issues have been resolved, the final release <quote>polishing</quote> can begin.</para> - <sect3 id="rel-branch"> + <sect3 xml:id="rel-branch"> <title>Creating the Release Branch</title> <note> @@ -340,10 +329,10 @@ </note> <para>The layout of &os; branches in Subversion is - described in the <ulink url="&url.articles.committers-guide;/subversion-primer.html#subversion-primer-base-layout">Committer's Guide</ulink>. + described in the <link xlink:href="&url.articles.committers-guide;/subversion-primer.html#subversion-primer-base-layout">Committer's Guide</link>. The first step in creating a branch is to identify the revision of the - <literal>stable/<replaceable>X</replaceable></literal> sources + <literal>stable/X</literal> sources that you want to branch <emphasis>from</emphasis>.</para> <screen>&prompt.root; <userinput>svn log -v $FSVN/stable/9</userinput></screen> @@ -359,9 +348,8 @@ <note> <para>Creating the <literal>releng</literal> branch and - <literal>release</literal> tags is done by the <ulink - url="&url.base;/administration.html#t-re">Release - Engineering Team</ulink>. + <literal>release</literal> tags is done by the <link xlink:href="&url.base;/administration.html#t-re">Release + Engineering Team</link>. </para> </note> @@ -446,7 +434,7 @@ </mediaobject> </sect3> - <sect3 id="versionbump"> + <sect3 xml:id="versionbump"> <title>Bumping up the Version Number</title> <para>Before the final release can be tagged, built, and @@ -548,7 +536,7 @@ <footnote> <simpara> &os; Ports Collection - <ulink url="http://www.FreeBSD.org/ports"></ulink> + <uri xlink:href="http://www.FreeBSD.org/ports">http://www.FreeBSD.org/ports</uri> </simpara> </footnote> This information is currently kept in @@ -561,7 +549,7 @@ <itemizedlist> <listitem> - <para><filename>share/images/articles/releng/branches-releng<replaceable>X</replaceable>.pic</filename></para> + <para><filename>share/images/articles/releng/branches-relengX.pic</filename></para> </listitem> <listitem> @@ -621,15 +609,15 @@ </sect1> <!-- Release Building --> -<sect1 id="release-build"> +<sect1 xml:id="release-build"> <title>Release Building</title> <para>&os; <quote>releases</quote> can be built by anyone with a fast machine and access to a source repository. (That should be everyone, since we offer Subversion access ! See the - <ulink url="&url.books.handbook;/svn.html">Subversion section - in the Handbook</ulink> for + <link xlink:href="&url.books.handbook;/svn.html">Subversion section + in the Handbook</link> for details.) The <emphasis>only</emphasis> special requirement is that the &man.md.4; device must be available. If the device is not loaded into your kernel, then the kernel module @@ -666,7 +654,7 @@ <listitem> <para>Creation of a sanitized system environment in a separate directory hierarchy with <quote><command>make - <literal>installworld</literal></command></quote>. + installworld</command></quote>. </para> </listitem> @@ -745,8 +733,8 @@ <sect2> <title>Contributed Software (<quote>ports</quote>)</title> - <para>The <ulink url="http://www.FreeBSD.org/ports">&os; Ports - collection</ulink> is a collection of over &os.numports; + <para>The <link xlink:href="http://www.FreeBSD.org/ports">&os; Ports + collection</link> is a collection of over &os.numports; third-party software packages available for &os;. The &a.portmgr; is responsible for maintaining a consistent ports tree that can be used to create the binary packages that accompany official &os; @@ -775,7 +763,7 @@ <emphasis>manifest</emphasis> can be created with a simple command:</para> - <screen>/stage/cdrom&prompt.root; <userinput>find . -type f | sed -e 's/^\.\///' | sort > filename.txt</userinput></screen> + <screen>/stage/cdrom&prompt.root; <userinput>find . -type f | sed -e 's/^\.\///' | sort > filename.txt</userinput></screen> <para>The specific requirements of each CD are outlined below.</para> @@ -849,22 +837,22 @@ </sect1> <!-- Distribution --> -<sect1 id="distribution"> +<sect1 xml:id="distribution"> <title>Distribution</title> - <sect2 id="dist-ftp"> + <sect2 xml:id="dist-ftp"> <title>FTP Sites</title> <para>When the release has been thoroughly tested and packaged for distribution, the master FTP site must be updated. The official &os; public FTP sites are all mirrors of a master server that is open only to other FTP sites. This site is known as - <hostid>ftp-master</hostid>. When the release is ready, the - following files must be modified on <hostid>ftp-master</hostid>:</para> + <systemitem>ftp-master</systemitem>. When the release is ready, the + following files must be modified on <systemitem>ftp-master</systemitem>:</para> <variablelist> <varlistentry> - <term><filename>/pub/FreeBSD/releases/<replaceable>arch</replaceable>/<replaceable>X.Y</replaceable>-RELEASE/</filename></term> + <term><filename>/pub/FreeBSD/releases/arch/X.Y-RELEASE/</filename></term> <listitem> <para>The installable FTP directory as output from <command>make release</command>.</para> @@ -872,25 +860,25 @@ </varlistentry> <varlistentry> - <term><filename>/pub/FreeBSD/ports/<replaceable>arch</replaceable>/packages-<replaceable>X.Y</replaceable>-release/</filename></term> + <term><filename>/pub/FreeBSD/ports/arch/packages-X.Y-release/</filename></term> <listitem><para>The complete package build for this release.</para></listitem> </varlistentry> <varlistentry> - <term><filename>/pub/FreeBSD/releases/<replaceable>arch</replaceable>/<replaceable>X.Y</replaceable>-RELEASE/tools</filename></term> + <term><filename>/pub/FreeBSD/releases/arch/X.Y-RELEASE/tools</filename></term> <listitem><para>A symlink to <filename>../../../tools</filename>.</para></listitem> </varlistentry> <varlistentry> - <term><filename>/pub/FreeBSD/releases/<replaceable>arch</replaceable>/<replaceable>X.Y</replaceable>-RELEASE/packages</filename></term> + <term><filename>/pub/FreeBSD/releases/arch/X.Y-RELEASE/packages</filename></term> <listitem><para>A symlink to - <filename>../../../ports/<replaceable>arch</replaceable>/packages-<replaceable>X.Y</replaceable>-release</filename>.</para></listitem> + <filename>../../../ports/arch/packages-X.Y-release</filename>.</para></listitem> </varlistentry> <varlistentry> - <term><filename>/pub/FreeBSD/releases/<replaceable>arch</replaceable>/ISO-IMAGES/<replaceable>X.Y</replaceable>/<replaceable>X.Y</replaceable>-RELEASE-<replaceable>arch</replaceable>-*.iso</filename></term> + <term><filename>/pub/FreeBSD/releases/arch/ISO-IMAGES/X.Y/X.Y-RELEASE-arch-*.iso</filename></term> <listitem><para>The ISO images. The <quote>*</quote> is <filename>disc1</filename>, <filename>disc2</filename>, etc. Only if there is a <filename>disc1</filename> and there is an @@ -902,11 +890,10 @@ </variablelist> <para>For more information about the distribution mirror - architecture of the &os; FTP sites, please see the <ulink - url="&url.articles.hubs;/">Mirroring &os;</ulink> article.</para> + architecture of the &os; FTP sites, please see the <link xlink:href="&url.articles.hubs;/">Mirroring &os;</link> article.</para> <para>It may take many hours to two days after updating - <hostid>ftp-master</hostid> before a majority of the Tier-1 FTP + <systemitem>ftp-master</systemitem> before a majority of the Tier-1 FTP sites have the new software depending on whether or not a package set got loaded at the same time. It is imperative that the release engineers coordinate with the &a.mirror-announce; before announcing the general @@ -924,7 +911,7 @@ time, for example make it relative to GMT.</para> </sect2> - <sect2 id="dist-cdrom"> + <sect2 xml:id="dist-cdrom"> <title>CD-ROM Replication</title> <para>Coming soon: Tips for sending &os; ISOs to a replicator @@ -934,7 +921,7 @@ </sect1> <!-- Extensibility --> -<sect1 id="extensibility"> +<sect1 xml:id="extensibility"> <title>Extensibility</title> <para>Although &os; forms a complete operating system, there is @@ -959,7 +946,7 @@ with &intel; PXE <footnote> <simpara> - <ulink url="&url.books.handbook;/network-pxe-nfs.html"></ulink> + <uri xlink:href="&url.books.handbook;/network-pxe-nfs.html">&url.books.handbook;/network-pxe-nfs.html</uri> </simpara> </footnote> to bootstrap systems from the network. @@ -968,7 +955,7 @@ </sect1> <!-- Lessons Learned --> -<sect1 id="lessons-learned"> +<sect1 xml:id="lessons-learned"> <title>Lessons Learned from &os; 4.4</title> <para>The release engineering process for 4.4 formally began on @@ -993,7 +980,7 @@ </sect1> <!-- Future Directions --> -<sect1 id="future"> +<sect1 xml:id="future"> <title>Future Directions</title> <para>It is imperative for our release engineering activities to @@ -1042,7 +1029,7 @@ </sect1> <!-- Acknowledgements --> -<sect1 id="ackno"> +<sect1 xml:id="ackno"> <title>Acknowledgements</title> <para>I would like to thank Jordan Hubbard for giving me the @@ -1059,8 +1046,8 @@ <footnote> <simpara> Marshall Kirk McKusick, Michael J. Karels, and Keith Bostic: - <ulink url="http://docs.FreeBSD.org/44doc/papers/releng.html"> - <emphasis>The Release Engineering of 4.3BSD</emphasis></ulink> + <link xlink:href="http://docs.FreeBSD.org/44doc/papers/releng.html"> + <emphasis>The Release Engineering of 4.3BSD</emphasis></link> </simpara> </footnote> , @@ -1068,7 +1055,7 @@ <footnote> <simpara> NetBSD Developer Documentation: Release Engineering - <ulink url="http://www.NetBSD.org/developers/releng/index.html"></ulink> + <uri xlink:href="http://www.NetBSD.org/developers/releng/index.html">http://www.NetBSD.org/developers/releng/index.html</uri> </simpara> </footnote> , and John @@ -1076,7 +1063,7 @@ <footnote> <simpara> John Baldwin's &os; Release Engineering Proposal - <ulink url="http://people.FreeBSD.org/~jhb/docs/releng.txt"></ulink> + <uri xlink:href="http://people.FreeBSD.org/~jhb/docs/releng.txt">http://people.FreeBSD.org/~jhb/docs/releng.txt</uri> </simpara> </footnote> </para> |