Skip site navigation (1)Skip section navigation (2)
Date:      Mon, 6 Apr 2015 05:30:42 +0000 (UTC)
From:      Eitan Adler <eadler@FreeBSD.org>
To:        doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org
Subject:   svn commit: r46484 - head/en_US.ISO8859-1/articles/releng
Message-ID:  <201504060530.t365UgOi098505@svn.freebsd.org>

next in thread | raw e-mail | index | archive | help
Author: eadler
Date: Mon Apr  6 05:30:41 2015
New Revision: 46484
URL: https://svnweb.freebsd.org/changeset/doc/46484

Log:
  releng: strip some old things
  	There is a two year old warning that this document is partly outdated
  	and that re@ is working on updating it.
  	I don't see many substantive commits updating this doc, so just do a
  	drive-by and remove the obviously wrong and outdated things.
  
  	- sysinstall has been replaced (and so scripting it is meaningless)
  	- cross building is possible
  	- drop support for disk2 and on
  	- remove empty sections, such as the one on cd-rom replication

Modified:
  head/en_US.ISO8859-1/articles/releng/article.xml

Modified: head/en_US.ISO8859-1/articles/releng/article.xml
==============================================================================
--- head/en_US.ISO8859-1/articles/releng/article.xml	Mon Apr  6 05:16:09 2015	(r46483)
+++ head/en_US.ISO8859-1/articles/releng/article.xml	Mon Apr  6 05:30:41 2015	(r46484)
@@ -5,14 +5,6 @@
 <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>
-
-    
-    
-    <confgroup>
-      <confdates>November 2001</confdates>
-      <conftitle>BSDCon Europe</conftitle>
-    </confgroup>
-
     <authorgroup>
       <author><personname><firstname>Murray</firstname><surname>Stokely</surname></personname><personblurb>
           <para>I've been involved in the development of &os; based products
@@ -746,64 +738,6 @@
       command:</para>
 
     <screen>/stage/cdrom&prompt.root; <userinput>find . -type f | sed -e 's/^\.\///' | sort &gt; filename.txt</userinput></screen>
-
-    <para>The specific requirements of each CD are outlined below.</para>
-
-    <sect3>
-      <title>Disc 1</title>
-
-      <para>The first disc is almost completely created by
-        <command>make
-        release</command>. The only changes
-        that should be made to the <filename>disc1</filename> directory are the addition of
-        a <filename>tools</filename> directory, and as many popular
-        third party software packages as will fit on the disc. The
-        <filename>tools</filename> directory contains software that allow users to create
-        installation floppies from other operating systems. This disc
-        should be made bootable so that users of modern PCs do not
-        need to create installation floppy disks.</para>
-
-      <para>If a custom kernel of &os; is to be included, then
-        &man.sysinstall.8; and &man.release.7; must be updated to
-        include installation instructions. The relevant code is contained
-        in <filename>src/release</filename> and <filename>src/usr.sbin/sysinstall</filename>.
-        Specifically, the file <filename>src/release/Makefile</filename>, and
-        <filename>dist.c</filename>, <filename>dist.h</filename>,
-        <filename>menus.c</filename>, <filename>install.c</filename>, and
-        <filename>Makefile</filename> will need to be updated under
-        <filename>src/usr.sbin/sysinstall</filename>.  Optionally, you may choose
-        to update <filename>sysinstall.8</filename>.</para>
-
-    </sect3>
-
-    <sect3>
-      <title>Disc 2</title>
-
-      <para>The second disc is also largely created by <command>make
-        release</command>. This disc contains a <quote>live
-        filesystem</quote> that can be used from &man.sysinstall.8; to
-        troubleshoot a &os; installation. This disc should be
-        bootable and should also contain a compressed copy of the CVS
-        repository in the <filename>CVSROOT</filename> directory and
-        commercial software demos in the <filename>commerce</filename>
-        directory.</para>
-    </sect3>
-
-    <sect3>
-      <title>Multi-volume support</title>
-
-      <para><application>Sysinstall</application> supports multiple
-        volume package installations.  This requires that each disc
-        have an <filename>INDEX</filename> file containing all of the
-        packages on all volumes of a set, along with an extra field
-        that indicates which volume that particular package is on.
-        Each volume in the set must also have the
-        <literal>CD_VOLUME</literal> variable set in the
-        <filename>cdrom.inf</filename> file so that sysinstall can
-        tell which volume is which.  When a user attempts to install a
-        package that is not on the current disc, sysinstall will
-        prompt the user to insert the appropriate one.</para>
-    </sect3>
   </sect2>
 </sect1>
 
@@ -882,13 +816,6 @@
     time, for example make it relative to GMT.</para>
   </sect2>
 
-  <sect2 xml:id="dist-cdrom">
-    <title>CD-ROM Replication</title>
-
-    <para>Coming soon: Tips for sending &os; ISOs to a replicator
-      and quality assurance measures to be taken.</para>
-  </sect2>
-
 </sect1>
 
 <!-- Extensibility -->
@@ -907,25 +834,8 @@
     certainly encourage innovation in the form of advanced
     installation and administration tools, for example, but we cannot
     be expected to answer questions about it.</para>
-
-  <sect2>
-    <title>Scripting <command>sysinstall</command></title>
-
-    <para>The &os; system installation and configuration tool,
-      &man.sysinstall.8;, can be scripted to provide automated installs
-      for large sites. This functionality can be used in conjunction
-      with &intel; PXE
-      <footnote>
-        <simpara>
-          <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.
-    </para>
-  </sect2>
 </sect1>
 
-<!-- Lessons Learned -->
 <sect1 xml:id="lessons-learned">
   <title>Lessons Learned from &os;&nbsp;4.4</title>
 
@@ -968,33 +878,12 @@
         using multiple processors in speeding up the <command>make
         release</command> process.  If multiple disks are used for
         different hierarchies in the &man.chroot.2;
-        environment, then the CVS checkout of the <filename>ports</filename> and <filename>doc</filename> trees
+        environment, then the subversion checkout of the <filename>ports</filename> and <filename>doc</filename> trees
         can be happening simultaneously as the <command>make
         world</command> on another disk.  Using a
         <acronym>RAID</acronym> solution (hardware or software) can
         significantly decrease the overall build time.</para>
     </listitem>
-
-    <listitem>
-      <para><emphasis>Cross-building releases</emphasis> - Building
-        IA-64 or Alpha release on x86 hardware? <command>make
-        TARGET=ia64 release</command>.
-      </para>
-    </listitem>
-
-    <listitem>
-      <para><emphasis>Regression Testing</emphasis> - We need better
-        automated correctness testing for &os;.</para>
-    </listitem>
-
-    <listitem>
-      <para><emphasis>Installation Tools</emphasis> - Our installation
-        program has long since outlived its intended life span.
-        Several projects are under development to provide a more
-        advanced installation mechanism.  The libh project was one
-        such project that aimed to provide an intelligent new package
-        framework and GUI installation program.</para>
-    </listitem>
   </itemizedlist>
 
 </sect1>



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201504060530.t365UgOi098505>