From owner-freebsd-doc@FreeBSD.ORG Tue Sep 25 06: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 0553B106566C for ; Tue, 25 Sep 2012 06: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 D73568FC16 for ; Tue, 25 Sep 2012 06: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 q8P6AABJ042856 for ; Tue, 25 Sep 2012 06: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 q8P6AAjq042855; Tue, 25 Sep 2012 06:10:10 GMT (envelope-from gnats) Resent-Date: Tue, 25 Sep 2012 06:10:10 GMT Resent-Message-Id: <201209250610.q8P6AAjq042855@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, Adam Weinberger Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id 565A41065670; Tue, 25 Sep 2012 06:08:14 +0000 (UTC) (envelope-from adamw@adamw.org) Received: from apnoea.adamw.org (apnoea.adamw.org [204.109.59.150]) by mx1.freebsd.org (Postfix) with ESMTP id 2E33D8FC0C; Tue, 25 Sep 2012 06:08:13 +0000 (UTC) Received: by apnoea.adamw.org (Postfix, from userid 1002) id D418F45B37; Tue, 25 Sep 2012 02:08:06 -0400 (EDT) Message-Id: <20120925060806.D418F45B37@apnoea.adamw.org> Date: Tue, 25 Sep 2012 02:08:06 -0400 (EDT) From: Adam Weinberger To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Cc: portmgr@FreeBSD.org Subject: docs/171941: Return "Whom/Created by" to the porters handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Adam Weinberger List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 25 Sep 2012 06:10:11 -0000 >Number: 171941 >Category: docs >Synopsis: Return "Whom/Created by" to the porters handbook >Confidential: no >Severity: non-critical >Priority: medium >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Tue Sep 25 06:10:10 UTC 2012 >Closed-Date: >Last-Modified: >Originator: Adam Weinberger >Release: FreeBSD 9.1-PRERELEASE i386 >Organization: >Environment: System: FreeBSD apnoea.adamw.org 9.1-PRERELEASE FreeBSD 9.1-PRERELEASE #0: Sun Sep 2 00:54:22 EDT 2012 root@apnoea.adamw.org:/usr/obj/usr/src/sys/PEEP i386 >Description: The sample port Makefile headers and related instructions were stripped to the single line version. The attached patch reflects portmgr's decision to adopt the two-line header, while making it clear that the "Created by" line is optional. A single acknowledgement of the 2nd header line is restored back to the example Makefile (with text I hope everyone can agree upon). Also included is a correction to a warning to reflect that the "New [...] makefile for:" and "Date" lines are being removed, not creator "name and email" like the warning threatens. >How-To-Repeat: >Fix: --- porters-handbook-header-revert.patch begins here --- Index: book.sgml =================================================================== --- book.sgml (revision 39614) +++ book.sgml (working copy) @@ -143,9 +143,9 @@ In some cases, the Makefile of an existing port may contain additional lines in the header, - such as the name and email of the person that originally - created the port. This additional information has been - declared obsolete, and is being phased out. + such as the name of the port and the date it was created. + This additional information has been declared obsolete, and + is being phased out. See if you can figure it out. Do not worry about the @@ -16440,6 +16440,11 @@ [ ^^^^^^^^^ This will be automatically replaced with RCS ID string by SVN when it is committed to our repository. If upgrading a port, do not alter this line back to "$FreeBSD$". SVN deals with it automatically.] +# Created by: Satoshi Asami <asami@FreeBSD.org> +[This is the person who did the original port to FreeBSD, in particular, the +person who wrote the first version of this Makefile. Remember, this should +not be changed when upgrading the port later. This line is purely optional, +and many contributors prefer not to include it.] [section to describe the port itself and the master site - PORTNAME and PORTVERSION are always first, followed by CATEGORIES, --- porters-handbook-header-revert.patch ends here --- >Release-Note: >Audit-Trail: >Unformatted: