From owner-svn-doc-all@FreeBSD.ORG Mon Sep 2 18:21:26 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTP id A1B26475; Mon, 2 Sep 2013 18:21:26 +0000 (UTC) (envelope-from wblock@FreeBSD.org) 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)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id 8E4242888; Mon, 2 Sep 2013 18:21:26 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r82ILQJL044049; Mon, 2 Sep 2013 18:21:26 GMT (envelope-from wblock@svn.freebsd.org) Received: (from wblock@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r82ILQEX044046; Mon, 2 Sep 2013 18:21:26 GMT (envelope-from wblock@svn.freebsd.org) Message-Id: <201309021821.r82ILQEX044046@svn.freebsd.org> From: Warren Block Date: Mon, 2 Sep 2013 18:21:26 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42608 - head/en_US.ISO8859-1/books/porters-handbook X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees \(except for " user" , " projects" , and " translations" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 02 Sep 2013 18:21:26 -0000 Author: wblock Date: Mon Sep 2 18:21:26 2013 New Revision: 42608 URL: http://svnweb.freebsd.org/changeset/doc/42608 Log: Mention PLIST_DIRSTRY. Committed version is slightly edited from the second diff in the PR. PR: docs/181080 Submitted by: Frederic Culot Modified: head/en_US.ISO8859-1/books/porters-handbook/book.xml Modified: head/en_US.ISO8859-1/books/porters-handbook/book.xml ============================================================================== --- head/en_US.ISO8859-1/books/porters-handbook/book.xml Sun Sep 1 22:36:52 2013 (r42607) +++ head/en_US.ISO8859-1/books/porters-handbook/book.xml Mon Sep 2 18:21:26 2013 (r42608) @@ -278,6 +278,19 @@ PLIST_DIRS= lib/X11/onekoOf course, PLIST_DIRS should be left unset if a port installs no directories of its own. + + + Several ports can share a common directory. In that + case, PLIST_DIRS should be replaced by + PLIST_DIRSTRY so that the directory is + removed only if empty, otherwise it is silently ignored. + PLIST_DIRS and + PLIST_DIRSTRY are equivalent to using + @dirrm and @dirrmtry + in pkg-plist, as described in + . + + The price for this way of listing port's files and directories is that you cannot use command sequences described in &man.pkg.create.1;. Therefore, it is suitable @@ -9917,21 +9930,26 @@ PLIST_SUB+= X11="@comment " post-install to a file named TMPPLIST. - Another possibility to modify port's packing list is based - on setting the variables PLIST_FILES and - PLIST_DIRS. The value of each variable is + Another way of modifying a port's packing list is based + on setting the variables PLIST_FILES, + PLIST_DIRS, and + PLIST_DIRSTRY. The value of each variable is regarded as a list of pathnames to write to TMPPLIST along with PLIST contents. Names - listed in PLIST_FILES and - PLIST_DIRS are subject to + listed in PLIST_FILES, + PLIST_DIRS, and + PLIST_DIRSTRY are subject to %%VAR%% - substitution, as described above. Except for that, names from + substitution as described above. Except for that, names from PLIST_FILES will appear in the final - packing list unchanged, while @dirrm will - be prepended to names from PLIST_DIRS. To - take effect, PLIST_FILES and - PLIST_DIRS must be set before + packing list unchanged, while @dirrm and + @dirrmtry will + be prepended to names from PLIST_DIRS + and PLIST_DIRSTRY, respectively. To + take effect, PLIST_FILES, + PLIST_DIRS, and + PLIST_DIRSTRY must be set before TMPPLIST is written, i.e., in pre-install or earlier. @@ -10059,8 +10077,9 @@ etc/orbit.conf.sample pkg-plist file (with or without variable substitution), or embedded into the Makefile via - PLIST_FILES and - PLIST_DIRS. Even if the contents are + PLIST_FILES, + PLIST_DIRS, and + PLIST_DIRSTRY. Even if the contents are auto-generated by a tool or a target in the Makefile before the inclusion into the Ports Collection by a committer, this is still considered a static