From owner-svn-doc-head@FreeBSD.ORG Thu Apr 30 19:34:04 2015 Return-Path: Delivered-To: svn-doc-head@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id B6AABA63; Thu, 30 Apr 2015 19:34:04 +0000 (UTC) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::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 A4ADA12C5; Thu, 30 Apr 2015 19:34:04 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.9/8.14.9) with ESMTP id t3UJY4JQ007770; Thu, 30 Apr 2015 19:34:04 GMT (envelope-from mat@FreeBSD.org) Received: (from mat@localhost) by svn.freebsd.org (8.14.9/8.14.9/Submit) id t3UJY4CT007768; Thu, 30 Apr 2015 19:34:04 GMT (envelope-from mat@FreeBSD.org) Message-Id: <201504301934.t3UJY4CT007768@svn.freebsd.org> X-Authentication-Warning: svn.freebsd.org: mat set sender to mat@FreeBSD.org using -f From: Mathieu Arnold Date: Thu, 30 Apr 2015 19:34:04 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r46632 - head/en_US.ISO8859-1/articles/committers-guide X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-head@freebsd.org X-Mailman-Version: 2.1.20 Precedence: list List-Id: SVN commit messages for the doc tree for head List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 30 Apr 2015 19:34:04 -0000 Author: mat Date: Thu Apr 30 19:34:03 2015 New Revision: 46632 URL: https://svnweb.freebsd.org/changeset/doc/46632 Log: Add pkg-status to the "How do I know if my port is building correctly" question. While there, axe the ports freeze section. Differential Revision: https://reviews.freebsd.org/D2403 Approved by: gjb, wblock (mentors) Sponsored by: Absolight Modified: head/en_US.ISO8859-1/articles/committers-guide/article.xml Modified: head/en_US.ISO8859-1/articles/committers-guide/article.xml ============================================================================== --- head/en_US.ISO8859-1/articles/committers-guide/article.xml Thu Apr 30 17:44:47 2015 (r46631) +++ head/en_US.ISO8859-1/articles/committers-guide/article.xml Thu Apr 30 19:34:03 2015 (r46632) @@ -4250,127 +4250,16 @@ Relnotes: yes - Before a release, it is necessary to restrict - commits to the ports tree for a short period of time - while the packages and the release itself are being - built. This is to ensure consistency among the various - parts of the release, and is called the - ports freeze. - - For more information on the background and - policies surrounding a ports freeze, see the - Portmgr - Quality Assurance page. - - - - - - What is a ports slush or - feature freeze? - - - - During a release cycle the ports tree may be in a - slush state instead of in a hard freeze. - The goal during a slush is to reach a stable ports tree - to avoid rebuilding large sets of packages for the - release and to tag the tree. During this time - sweeping changes are prohibited unless - specifically permitted by portmgr. Complete details - about what qualifies as a sweeping change can be found - on the Portmgr - Implementation page. - - The benefit of a slush as opposed to a complete - freeze is that it allows maintainers to continue adding - new ports, making routine version updates, and bug fixes - to most existing ports, as long as the number of - affected ports is minimal. For example, updating the - shared library version on a port that many other ports - depend on. - - - - - - How long is a ports freeze or slush? - - - - A freeze only lasts long enough to tag the tree. - A slush usually lasts a week or two, but may last - longer. - - - - - - What does it mean to me? - - - - During a ports freeze, you are not allowed to - commit anything to the tree without explicit approval - from the Ports Management Team. Explicit - approval here means that you send a patch to - the Ports Management Team for review and get a reply - saying, Go ahead and commit it. - - Not everything is allowed to be committed during - a freeze. Please see the - Portmgr - Quality Assurance page for more - information. - - Note that you do not have implicit permission to fix - a port during the freeze just because it is - broken. - - During a ports slush, you are still allowed to - commit but you must exercise more caution in what you - commit. Furthermore a special note (typically - Feature Safe: yes) must be added to the - commit message. - - - - - - How do I know when the ports slush starts? - - - - The Ports Management Team will send out warning - messages to the &a.ports; and &a.committers; - announcing the start of the impending release, usually - two or three weeks in advance. The exact starting time - will not be determined until a few days before the - actual release. This is because the ports slush has to - be synchronized with the release, and it is usually not - known until then when exactly the release will be - rolled. - - When the slush starts, there will be another - announcement to the &a.ports; and &a.committers;, of - course. - - - - - - How do I know when the freeze or slush ends? - - - - A few hours after the release, the Ports Management - Team will send out a mail to the &a.ports; and - &a.committers; announcing the end of the ports freeze or - slush. Note that the release being cut does not - automatically indicate the end of the freeze. We have - to make sure there will be no last minute snafus that - result in an immediate re-rolling of the release. + A ports freeze was a restricted state + the ports tree was put in before a release. It was used + to ensure a higher quality for the packages shipped with + a release. It usually lasted a couple of weeks. During + that time, build problems were fixed, and the release + packages were built. This practice is no longer used, + as the packages for the releases are built from the + current stable, quarterly branch. For more information + on how to merge commits to the quarterly branch, see + . @@ -4591,9 +4480,14 @@ Relnotes: yes - The packages are built weekly. If a port fails, - the maintainer will be emailed from + The packages are built multiple times each week. If + a port fails, the maintainer will receive an email from pkg-fallout@FreeBSD.org. + + Reports for all the package builds (official, + experimental, and non-regression) are aggregated at + pkg-status.FreeBSD.org.