From owner-svn-doc-user@freebsd.org Thu Mar 23 20:32:22 2017 Return-Path: Delivered-To: svn-doc-user@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id C9378CA1C76 for ; Thu, 23 Mar 2017 20:32:22 +0000 (UTC) (envelope-from gjb@FreeBSD.org) Received: from repo.freebsd.org (repo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id 89F7F1D14; Thu, 23 Mar 2017 20:32:22 +0000 (UTC) (envelope-from gjb@FreeBSD.org) Received: from repo.freebsd.org ([127.0.1.37]) by repo.freebsd.org (8.15.2/8.15.2) with ESMTP id v2NKWL21097342; Thu, 23 Mar 2017 20:32:21 GMT (envelope-from gjb@FreeBSD.org) Received: (from gjb@localhost) by repo.freebsd.org (8.15.2/8.15.2/Submit) id v2NKWLtM097158; Thu, 23 Mar 2017 20:32:21 GMT (envelope-from gjb@FreeBSD.org) Message-Id: <201703232032.v2NKWLtM097158@repo.freebsd.org> X-Authentication-Warning: repo.freebsd.org: gjb set sender to gjb@FreeBSD.org using -f From: Glen Barber Date: Thu, 23 Mar 2017 20:32:21 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-user@freebsd.org Subject: svn commit: r50079 - user/gjb/releng-rewrite/en_US.ISO8859-1/articles/freebsd-releng X-SVN-Group: doc-user MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-user@freebsd.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: SVN commit messages for doc experimental trees List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 23 Mar 2017 20:32:22 -0000 Author: gjb Date: Thu Mar 23 20:32:21 2017 New Revision: 50079 URL: https://svnweb.freebsd.org/changeset/doc/50079 Log: Move the 'releng-building' section to its own file. Document the relationship between release.sh and thermite.sh, and the purpose each serves. Sponsored by: The FreeBSD Foundation Added: user/gjb/releng-rewrite/en_US.ISO8859-1/articles/freebsd-releng/releng-building.xml (contents, props changed) Modified: user/gjb/releng-rewrite/en_US.ISO8859-1/articles/freebsd-releng/article.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 17:35:03 2017 (r50078) +++ user/gjb/releng-rewrite/en_US.ISO8859-1/articles/freebsd-releng/article.xml Thu Mar 23 20:32:21 2017 (r50079) @@ -15,6 +15,7 @@ releng/11.0/"> + @@ -329,6 +330,7 @@ &release.terminology; &release.major.version; &release.minor.version; + &release.building; Wrapping up the Release Cycle @@ -336,31 +338,4 @@ This section describes general post-release tasks. - - Building the Installer Images - - This section describes how to build the installation images - as part of the &os; release cycle. - - - The <filename>release.sh</filename> Script - -   - - - - The <filename>release.conf</filename> - Configuration - -   - - - - Information About <filename>release.sh</filename> and - <filename>release.conf</filename> for Specific - Architectures - -   - - Added: user/gjb/releng-rewrite/en_US.ISO8859-1/articles/freebsd-releng/releng-building.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-building.xml Thu Mar 23 20:32:21 2017 (r50079) @@ -0,0 +1,75 @@ + + + + Building &os; Installation Media + + This section describes the general procedures producing &os; + development snapshots and releases. + + + Release Build Scripts + + This section describes the build scripts used by &team.re; + to produce development snapshots and releases. + + + The <filename>release.sh</filename> Script + + Prior to &os; 9.0-RELEASE, + src/release/Makefile was updated to + support &man.bsdinstall.8;, and the + src/release/generate-release.sh script + was introduced as a wrapper to automate invoking the + &man.release.7; targets. + + Prior to &os; 9.2-RELEASE, + src/release/release.sh was introduced, + which heavily based on + src/release/generate-release.sh included + support to specify configuration files to override various + 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 + src/release/release.conf.sample for more + details. + + + + The <filename>thermite.sh</filename> Wrapper + Script + + In order to make cross building the full set of + architectures supported on a given branch faster, easier, and + reduce human error factors, a wrapper script around + src/release/release.sh was written to + iterate through the various combinations of architectures and + invoke src/release/release.sh using + a configuration file specific to that architecture. + + The wrapper script is called + thermite.sh, which is available in the + &os; Subversion repository at + svn://svn.freebsd.org/user/gjb/thermite/, + in addition to configuration files used to build + &branch.head; and &branch.stablex; development + snapshots. + + + + + Building &os; Development Snapshots + +   + + + + Building &os; Releases + +   + +