From owner-cvs-doc@FreeBSD.ORG Fri Jul 22 04:54:48 2005 Return-Path: X-Original-To: cvs-doc@FreeBSD.org Delivered-To: cvs-doc@FreeBSD.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 67CAF16A429; Fri, 22 Jul 2005 04:54:48 +0000 (GMT) (envelope-from linimon@FreeBSD.org) Received: from repoman.freebsd.org (repoman.freebsd.org [216.136.204.115]) by mx1.FreeBSD.org (Postfix) with ESMTP id 2BF8D43D68; Fri, 22 Jul 2005 04:54:43 +0000 (GMT) (envelope-from linimon@FreeBSD.org) Received: from repoman.freebsd.org (localhost [127.0.0.1]) by repoman.freebsd.org (8.13.1/8.13.1) with ESMTP id j6M4shX6057663; Fri, 22 Jul 2005 04:54:43 GMT (envelope-from linimon@repoman.freebsd.org) Received: (from linimon@localhost) by repoman.freebsd.org (8.13.1/8.13.1/Submit) id j6M4shjT057662; Fri, 22 Jul 2005 04:54:43 GMT (envelope-from linimon) Message-Id: <200507220454.j6M4shjT057662@repoman.freebsd.org> From: Mark Linimon Date: Fri, 22 Jul 2005 04:54:43 +0000 (UTC) To: doc-committers@FreeBSD.org, cvs-doc@FreeBSD.org, cvs-all@FreeBSD.org X-FreeBSD-CVS-Branch: HEAD Cc: Subject: cvs commit: doc/en_US.ISO8859-1/books/porters-handbook book.sgml X-BeenThere: cvs-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: CVS commit messages for the doc and www trees List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 22 Jul 2005 04:54:48 -0000 linimon 2005-07-22 04:54:43 UTC FreeBSD doc repository Modified files: en_US.ISO8859-1/books/porters-handbook book.sgml Log: Try to clear up the ongoing confusion between the usage of the BROKEN and IGNORE Makevars. Include example reasons to use BROKEN and example usages of both BROKEN and IGNORE. Remove text made redundant by this. Finally, to try to make the added text more readable, add some sections to try to break up the flow. I would accept the argument that these sections (now 17.18 and 17.19) now have a sufficient amount of text that they should be moved up one level to become the new section 17. Requested by: many Revision Changes Path 1.594 +80 -13 doc/en_US.ISO8859-1/books/porters-handbook/book.sgml