From owner-svn-doc-user@freebsd.org Thu Mar 23 17:34:07 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 6AFD5D1A8F8 for ; Thu, 23 Mar 2017 17:34:07 +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 33CFD1213; Thu, 23 Mar 2017 17:34:07 +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 v2NHY60f023572; Thu, 23 Mar 2017 17:34:06 GMT (envelope-from gjb@FreeBSD.org) Received: (from gjb@localhost) by repo.freebsd.org (8.15.2/8.15.2/Submit) id v2NHY66c023571; Thu, 23 Mar 2017 17:34:06 GMT (envelope-from gjb@FreeBSD.org) Message-Id: <201703231734.v2NHY66c023571@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 17:34:06 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-user@freebsd.org Subject: svn commit: r50077 - 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 17:34:07 -0000 Author: gjb Date: Thu Mar 23 17:34:06 2017 New Revision: 50077 URL: https://svnweb.freebsd.org/changeset/doc/50077 Log: Fix a typo found by textproc/igor. Sponsored by: The FreeBSD Foundation Modified: user/gjb/releng-rewrite/en_US.ISO8859-1/articles/freebsd-releng/releng-minor-version.xml Modified: user/gjb/releng-rewrite/en_US.ISO8859-1/articles/freebsd-releng/releng-minor-version.xml ============================================================================== --- user/gjb/releng-rewrite/en_US.ISO8859-1/articles/freebsd-releng/releng-minor-version.xml Thu Mar 23 15:06:43 2017 (r50076) +++ user/gjb/releng-rewrite/en_US.ISO8859-1/articles/freebsd-releng/releng-minor-version.xml Thu Mar 23 17:34:06 2017 (r50077) @@ -159,7 +159,7 @@ &prompt.user; svn commit &branch.stablex; Now that two new __FreeBSD_version values - exist, also upate + exist, also update head/en_US.ISO8859-1/books/porters-handbook/versions/chapter.xml in the Documentation Project repository. From owner-svn-doc-user@freebsd.org Thu Mar 23 17:35:05 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 42564D1A933 for ; Thu, 23 Mar 2017 17:35:05 +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 121DA1285; Thu, 23 Mar 2017 17:35:04 +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 v2NHZ4vu023673; Thu, 23 Mar 2017 17:35:04 GMT (envelope-from gjb@FreeBSD.org) Received: (from gjb@localhost) by repo.freebsd.org (8.15.2/8.15.2/Submit) id v2NHZ4EK023672; Thu, 23 Mar 2017 17:35:04 GMT (envelope-from gjb@FreeBSD.org) Message-Id: <201703231735.v2NHZ4EK023672@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 17:35:04 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-user@freebsd.org Subject: svn commit: r50078 - 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 17:35:05 -0000 Author: gjb Date: Thu Mar 23 17:35:03 2017 New Revision: 50078 URL: https://svnweb.freebsd.org/changeset/doc/50078 Log: Wrap long lines reported by textproc/igor. Sponsored by: The FreeBSD Foundation Modified: user/gjb/releng-rewrite/en_US.ISO8859-1/articles/freebsd-releng/releng-minor-version.xml Modified: user/gjb/releng-rewrite/en_US.ISO8859-1/articles/freebsd-releng/releng-minor-version.xml ============================================================================== --- user/gjb/releng-rewrite/en_US.ISO8859-1/articles/freebsd-releng/releng-minor-version.xml Thu Mar 23 17:34:06 2017 (r50077) +++ user/gjb/releng-rewrite/en_US.ISO8859-1/articles/freebsd-releng/releng-minor-version.xml Thu Mar 23 17:35:03 2017 (r50078) @@ -111,7 +111,8 @@ releng/11.0/sys/conf/newvers.sh - Change BETAX + Change + BETAX to RC1 @@ -136,8 +137,9 @@ stable/11/sys/conf/newver.sh - Update BETAX - with PRERELEASE + Update + BETAX with + PRERELEASE 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 + +   + + From owner-svn-doc-user@freebsd.org Thu Mar 23 20:57:40 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 1353ED190D2 for ; Thu, 23 Mar 2017 20:57:40 +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 D4A2815EA; Thu, 23 Mar 2017 20:57:39 +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 v2NKvcEH005843; Thu, 23 Mar 2017 20:57:38 GMT (envelope-from gjb@FreeBSD.org) Received: (from gjb@localhost) by repo.freebsd.org (8.15.2/8.15.2/Submit) id v2NKvcjS005842; Thu, 23 Mar 2017 20:57:38 GMT (envelope-from gjb@FreeBSD.org) Message-Id: <201703232057.v2NKvcjS005842@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:57:38 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-user@freebsd.org Subject: svn commit: r50080 - 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:57:40 -0000 Author: gjb Date: Thu Mar 23 20:57:38 2017 New Revision: 50080 URL: https://svnweb.freebsd.org/changeset/doc/50080 Log: Expand clarification a bit. Sponsored by: The FreeBSD Foundation Modified: 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/releng-building.xml ============================================================================== --- user/gjb/releng-rewrite/en_US.ISO8859-1/articles/freebsd-releng/releng-building.xml Thu Mar 23 20:32:21 2017 (r50079) +++ user/gjb/releng-rewrite/en_US.ISO8859-1/articles/freebsd-releng/releng-building.xml Thu Mar 23 20:57:38 2017 (r50080) @@ -36,7 +36,7 @@ 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. + details and example usage. From owner-svn-doc-user@freebsd.org Thu Mar 23 22:04:24 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 A5416CA1FEC for ; Thu, 23 Mar 2017 22:04:24 +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 7D5D51B48; Thu, 23 Mar 2017 22:04:24 +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 v2NM4NWH034788; Thu, 23 Mar 2017 22:04:23 GMT (envelope-from gjb@FreeBSD.org) Received: (from gjb@localhost) by repo.freebsd.org (8.15.2/8.15.2/Submit) id v2NM4Njq034784; Thu, 23 Mar 2017 22:04:23 GMT (envelope-from gjb@FreeBSD.org) Message-Id: <201703232204.v2NM4Njq034784@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 22:04:23 +0000 (UTC) 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 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 22:04:24 -0000 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 @@ + ]>
- + - Wrapping up the release cycle. + Information related to the specific procedures to + build installation medium. - + - Information related to the specific procedures to - build installation medium. + Procedures to publish installation medium. + + + + + + + + Wrapping up the release cycle. @@ -331,6 +340,7 @@ &release.major.version; &release.minor.version; &release.building; + &release.mirrors; Wrapping up the Release Cycle 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. + + As a brief example of using + src/release/release.sh to build a single + release in /scratch: + + &prompt.root; /bin/sh /usr/src/release/release.sh + + As a brief example of using + src/release/release.sh to build a single, + cross-built release using a different target directory, create + a custom release.conf containing: + + # release.sh configuration for powerpc/powerpc64 +CHROOTDIR="/scratch-powerpc64" +TARGET="powerpc" +TARGET_ARCH="powerpc64" +KERNEL="GENERIC64" + + Then invoke src/release/release.sh + as: + + &prompt.root; /bin/sh /usr/src/release/release.sh -c $HOME/release.conf + + See &man.release.7; and src/release/release.conf.sample for more details and example usage. @@ -58,6 +83,10 @@ in addition to configuration files used to build &branch.head; and &branch.stablex; development snapshots. + + Using thermite.sh is covered in and . 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 @@ + + + + Publishing &os; Installation Media to Project Mirrors + + This section describes the procedure to publish &os; + development snapshots and releases to the Project mirrors. + + + Staging &os; Installation Media Images + + Staging &os; snapshots and releases is a two part + process: + + + + Creating the directory structure to match the hierarchy + on ftp-master + + + + Copying the files to a staging directory on + ftp-master before moving the files + into pub/ to begin + propagation to the Project mirrors + + + + + + Publishing &os; Installation Media + +   + +