From owner-freebsd-doc@FreeBSD.ORG Fri Dec 16 20:30:21 2005 Return-Path: X-Original-To: freebsd-doc@hub.freebsd.org Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 401F516A433 for ; Fri, 16 Dec 2005 20:30:21 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 0C82943D7B for ; Fri, 16 Dec 2005 20:30:03 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.13.4/8.13.4) with ESMTP id jBGKU3bM085010 for ; Fri, 16 Dec 2005 20:30:03 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.13.4/8.13.4/Submit) id jBGKU3Ya085009; Fri, 16 Dec 2005 20:30:03 GMT (envelope-from gnats) Resent-Date: Fri, 16 Dec 2005 20:30:03 GMT Resent-Message-Id: <200512162030.jBGKU3Ya085009@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, Gabor Kovesdan Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id F3D9E16A41F for ; Fri, 16 Dec 2005 20:29:39 +0000 (GMT) (envelope-from root@server.t-hosting.hu) Received: from server.t-hosting.hu (server.t-hosting.hu [217.20.133.7]) by mx1.FreeBSD.org (Postfix) with ESMTP id 1745443D77 for ; Fri, 16 Dec 2005 20:29:39 +0000 (GMT) (envelope-from root@server.t-hosting.hu) Received: from localhost (localhost [127.0.0.1]) by server.t-hosting.hu (Postfix) with ESMTP id 1A43C998351; Fri, 16 Dec 2005 21:29:37 +0100 (CET) Received: from server.t-hosting.hu ([127.0.0.1]) by localhost (server.t-hosting.hu [127.0.0.1]) (amavisd-new, port 10024) with LMTP id 46289-04; Fri, 16 Dec 2005 21:29:33 +0100 (CET) Received: by server.t-hosting.hu (Postfix, from userid 0) id A784D99834D; Fri, 16 Dec 2005 21:29:33 +0100 (CET) Message-Id: <20051216202933.A784D99834D@server.t-hosting.hu> Date: Fri, 16 Dec 2005 21:29:33 +0100 (CET) From: Gabor Kovesdan To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Cc: Gabor Kovesdan Subject: docs/90515: Use new patch naming convention in Porter's Handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Gabor Kovesdan List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 16 Dec 2005 20:30:21 -0000 >Number: 90515 >Category: docs >Synopsis: Use new patch naming convention in Porter's Handbook >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: update >Submitter-Id: current-users >Arrival-Date: Fri Dec 16 20:30:03 GMT 2005 >Closed-Date: >Last-Modified: >Originator: Gabor Kovesdan >Release: FreeBSD 5.3-RELEASE-p17 amd64 >Organization: n/a >Environment: System: FreeBSD server.t-hosting.hu 5.3-RELEASE-p17 FreeBSD 5.3-RELEASE-p17 #0: Mon Jul 4 20:23:15 CEST 2005 root@server.t-hosting.hu:/usr/src/sys/amd64/compile/FREEBSD amd64 >Description: According to http://wikitest.freebsd.org/moin.cgi/PortsLongtermTargets the new patch naming convention requires to use :: signs for specifying paths in the patch filenames, e.g. patch-src::config.c, but Porter's Handbook describes the old naming convention, e.g. patch-src-config.c. This patch updates Porter's Handbook to explain the new rule. >How-To-Repeat: >Fix: --- book.sgml.diff begins here --- --- /usr/doc/en_US.ISO8859-1/books/porters-handbook/book.sgml Thu Dec 15 09:49:06 2005 +++ ./book.sgml Fri Dec 16 21:21:09 2005 @@ -635,11 +635,14 @@ * indicates the pathnames of the files that are patched, such as patch-Imakefile or - patch-src-config.h. These files should + patch-src::config.h. All patches must be + relative to WRKSRC (generally the directory your + port's tarball unpacks itself into, that being where the build is + done), and the / signs must be substituted with :: in this relative + path when constructing patch filenames, as the example represents + above. The patch files should be stored in PATCHDIR, from where they will be - automatically applied. All patches must be relative to - WRKSRC (generally the directory your port's - tarball unpacks itself into, that being where the build is done). + automatically applied. To make fixes and upgrades easier, you should avoid having more than one patch fix the same file (e.g., patch-file and patch-file2 both changing --- book.sgml.diff ends here --- >Release-Note: >Audit-Trail: >Unformatted: