From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from lists.gentoo.org (pigeon.gentoo.org [208.92.234.80]) by finch.gentoo.org (Postfix) with ESMTP id 345B01383D9 for ; Mon, 20 Jul 2015 21:48:43 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id D98A0E07FE; Mon, 20 Jul 2015 21:48:42 +0000 (UTC) Received: from smtp.gentoo.org (smtp.gentoo.org [140.211.166.183]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by pigeon.gentoo.org (Postfix) with ESMTPS id 73C31E081C for ; Mon, 20 Jul 2015 21:48:42 +0000 (UTC) Received: from oystercatcher.gentoo.org (unknown [IPv6:2a01:4f8:202:4333:225:90ff:fed9:fc84]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by smtp.gentoo.org (Postfix) with ESMTPS id A2662340AA9 for ; Mon, 20 Jul 2015 21:48:41 +0000 (UTC) Received: from localhost.localdomain (localhost [127.0.0.1]) by oystercatcher.gentoo.org (Postfix) with ESMTP id 699C9B9 for ; Mon, 20 Jul 2015 21:48:37 +0000 (UTC) From: "Brian Dolbec" To: gentoo-commits@lists.gentoo.org Content-Transfer-Encoding: 8bit Content-type: text/plain; charset=UTF-8 Reply-To: gentoo-dev@lists.gentoo.org, "Brian Dolbec" Message-ID: <1437428548.66f5190e3c44a628c01d9a554005b1debf583dc2.dolsen@gentoo> Subject: [gentoo-commits] proj/portage:master commit in: man/ X-VCS-Repository: proj/portage X-VCS-Files: man/make.conf.5 X-VCS-Directories: man/ X-VCS-Committer: dolsen X-VCS-Committer-Name: Brian Dolbec X-VCS-Revision: 66f5190e3c44a628c01d9a554005b1debf583dc2 X-VCS-Branch: master Date: Mon, 20 Jul 2015 21:48:37 +0000 (UTC) Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-commits@lists.gentoo.org X-Archives-Salt: 58d780df-0af5-45f5-802a-4c20271788b0 X-Archives-Hash: b5b1072dc3aab47dad444fc8dac61a42 commit: 66f5190e3c44a628c01d9a554005b1debf583dc2 Author: Michael Orlitzky gentoo org> AuthorDate: Sun Jul 19 16:08:52 2015 +0000 Commit: Brian Dolbec gentoo org> CommitDate: Mon Jul 20 21:42:28 2015 +0000 URL: https://gitweb.gentoo.org/proj/portage.git/commit/?id=66f5190e man/make.conf.5: Document globbing for INSTALL_MASK. The INSTALL_MASK variable has long supported shell glob patterns, but these were not mentioned in the man page. In fact there are two different behaviors -- one for globs that the shell can expand, and one for "bare globs" like "*.pdf". Both of these are now documented in the man page. In addition, a warning and example have been added to the man page regarding spaces within filenames (patterns). man/make.conf.5 | 44 ++++++++++++++++++++++++++++++++++++-------- 1 file changed, 36 insertions(+), 8 deletions(-) diff --git a/man/make.conf.5 b/man/make.conf.5 index a7417f3..13b8042 100644 --- a/man/make.conf.5 +++ b/man/make.conf.5 @@ -699,14 +699,42 @@ These variables are used by network clients such as \fBwget\fR(1) and \fBrsync\fR(1). They are only required if you use a proxy server for internet access. .TP -\fBINSTALL_MASK\fR = \fI[space delimited list of file names]\fR -Use this variable if you want to selectively prevent certain files from being -copied into your file system tree. This does not work on symlinks, but only on -actual files. Useful if you wish to filter out files like HACKING.gz and -TODO.gz. The \fBINSTALL_MASK\fR is processed just before a package is merged. -Also supported is a \fBPKG_INSTALL_MASK\fR variable that behaves exactly like -\fBINSTALL_MASK\fR except that it is processed just before creation of a binary -package. +\fBINSTALL_MASK\fR = \fI[space delimited list of filename patterns (globs)]\fR +Use this variable if you want to selectively prevent certain files +from being copied into your file system tree. This does not work on +symlinks, but only on actual files. Useful if you wish to filter out +files like HACKING.gz and TODO.gz. + +Patterns are matched against both the absolute path and the bare +filename of each file (or directory) to be installed. + +The \fBINSTALL_MASK\fR is processed just before a package is merged. +Also supported is a \fBPKG_INSTALL_MASK\fR variable that behaves +exactly like \fBINSTALL_MASK\fR except that it is processed just +before creation of a binary package. + +\fB***warning***\fR +.br +This does not place nice with filenames containing spaces. If you +supply a pattern with a space in it, that single pattern will be +interpreted as two separate patterns. + +.I Examples: + +.nf +# Prevent individual files from being installed. +INSTALL_MASK="/usr/bin/zless /usr/bin/zzxorcat" + +# Prevent all PDF files from being installed. +INSTALL_MASK="*.pdf" + +# Block PDF files one level beneath /usr/share/doc. +INSTALL_MASK="/usr/share/doc/*/*.pdf" + +# Watch out! This will be interpreted as two patterns, and +# prevent both "README" AND all PDF files from being installed. +INSTALL_MASK="README\\ *.pdf" +.fi .TP .B LDFLAGS A list of flags to pass to the compiler when the linker will be called. See