From owner-freebsd-doc@FreeBSD.ORG Thu Mar 29 21:10:11 2012 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id 0255C106566C for ; Thu, 29 Mar 2012 21:10:11 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id CBA488FC16 for ; Thu, 29 Mar 2012 21:10:10 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.5/8.14.5) with ESMTP id q2TLAAEJ009537 for ; Thu, 29 Mar 2012 21:10:10 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id q2TLAAw5009536; Thu, 29 Mar 2012 21:10:10 GMT (envelope-from gnats) Resent-Date: Thu, 29 Mar 2012 21:10:10 GMT Resent-Message-Id: <201203292110.q2TLAAw5009536@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Jason Helfman Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 9A56A106566B; Thu, 29 Mar 2012 21:08:14 +0000 (UTC) (envelope-from jhelfman@experts-exchange.com) Received: from mail.dw.redsrci.com (mail.pub.dw.redsrci.com [72.29.183.251]) by mx1.freebsd.org (Postfix) with ESMTP id 78F968FC17; Thu, 29 Mar 2012 21:08:14 +0000 (UTC) Received: from mail.dw.redsrci.com (localhost [127.0.0.1]) by mail.dw.redsrci.com (Postfix) with ESMTP id 314E96FF532; Thu, 29 Mar 2012 14:08:14 -0700 (PDT) Received: from mail.dw.redsrci.com ([127.0.0.1]) by mail.dw.redsrci.com (mail.dw.redsrci.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id yXvl0uYAqVqC; Thu, 29 Mar 2012 14:08:14 -0700 (PDT) Received: from experts-exchange.com (unknown [192.168.103.120]) by mail.dw.redsrci.com (Postfix) with SMTP id 0DA8E6F3880; Thu, 29 Mar 2012 14:08:14 -0700 (PDT) Received: (nullmailer pid 9901 invoked by uid 1001); Thu, 29 Mar 2012 21:07:19 -0000 Message-Id: <1333055239.029442.9900.nullmailer@experts-exchange.com> Date: Thu, 29 Mar 2012 14:07:19 -0700 From: Jason Helfman To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Cc: doc@FreeBSD.org Subject: docs/166502: [PATCH] porters-handbook: add make readme to testing, document post-deinstall as invalid X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 29 Mar 2012 21:10:11 -0000 >Number: 166502 >Category: docs >Synopsis: [PATCH] porters-handbook: add make readme to testing, document post-deinstall as invalid >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: change-request >Submitter-Id: current-users >Arrival-Date: Thu Mar 29 21:10:10 UTC 2012 >Closed-Date: >Last-Modified: >Originator: Jason Helfman >Release: FreeBSD 8.2-RELEASE amd64 >Organization: >Environment: System: FreeBSD dormouse.experts-exchange.com 8.2-RELEASE FreeBSD 8.2-RELEASE #0: Thu Feb 17 02:41:51 UTC 2011 >Description: make readme should be tested as part of the porting process post-deinstall is not a vaild target, and should be documented Port maintainer (doc@FreeBSD.org) is cc'd. Generated with FreeBSD Port Tools 0.99_5 (mode: change, diff: CVS) >How-To-Repeat: >Fix: --- .patch begins here --- Index: book.sgml =================================================================== RCS file: /usr/local/ncvs/doc/en_US.ISO8859-1/books/porters-handbook/book.sgml,v retrieving revision 1.1173 diff -u -r1.1173 book.sgml --- book.sgml 22 Mar 2012 04:09:20 -0000 1.1173 +++ book.sgml 29 Mar 2012 21:02:50 -0000 @@ -345,6 +345,10 @@ make package + + + make readme + Make sure that there are not any warnings issued in any of @@ -576,7 +580,9 @@ intended to be changed. If you want to fix the extraction, fix do-extract, but never ever change the way extract - operates! + operates! Additionally, the target post-deinstall + is invalid and is not run by the ports + infrastructure. Now that you understand what goes on when the user types --- .patch ends here --- >Release-Note: >Audit-Trail: >Unformatted: