Mon Jul 9 17:36:59 2012 UTC ()
Document permissions. Addresses part of PR 46570.


(wiz)
diff -r1.43 -r1.44 pkgsrc/pkgtools/pkglint/files/pkglint.1
cvs diff -r1.43 -r1.44 pkgsrc/pkgtools/pkglint/files/Attic/pkglint.1 (expand / switch to unified diff)

--- pkgsrc/pkgtools/pkglint/files/Attic/pkglint.1 2006/10/22 05:26:41 1.43
+++ pkgsrc/pkgtools/pkglint/files/Attic/pkglint.1 2012/07/09 17:36:59 1.44
@@ -1,23 +1,23 @@ @@ -1,23 +1,23 @@
1.\" $NetBSD: pkglint.1,v 1.43 2006/10/22 05:26:41 rillig Exp $ 1.\" $NetBSD: pkglint.1,v 1.44 2012/07/09 17:36:59 wiz Exp $
2.\" From FreeBSD: portlint.1,v 1.8 1997/11/25 14:53:14 itojun Exp 2.\" From FreeBSD: portlint.1,v 1.8 1997/11/25 14:53:14 itojun Exp
3.\" 3.\"
4.\" Copyright (c) 1997 by Jun-ichiro Itoh <itojun@itojun.org>. 4.\" Copyright (c) 1997 by Jun-ichiro Itoh <itojun@itojun.org>.
5.\" All Rights Reserved. Absolutely no warranty. 5.\" All Rights Reserved. Absolutely no warranty.
6.\" 6.\"
7.\" Roland Illig <roland.illig@gmx.de>, 2004, 2005. 7.\" Roland Illig <roland.illig@gmx.de>, 2004, 2005.
8.\" Roland Illig <rillig@NetBSD.org>, 2005, 2006. 8w.\" Thomas Klausner <rillig@NetBSD.org>, 2012.
9.\" 9.\"
10.Dd July 27, 2006 10.Dd July 9, 2012
11.Dt PKGLINT 1 11.Dt PKGLINT 1
12.Sh NAME 12.Sh NAME
13.Nm pkglint 13.Nm pkglint
14.Nd static analyzer for pkgsrc packages 14.Nd static analyzer for pkgsrc packages
15.Sh SYNOPSIS 15.Sh SYNOPSIS
16.Nm pkglint 16.Nm pkglint
17.Op Fl options 17.Op Fl options
18.Op Ar dir ... 18.Op Ar dir ...
19.Sh DESCRIPTION 19.Sh DESCRIPTION
20.Nm 20.Nm
21attempts to detect features of the named pkgsrc packages that are likely 21attempts to detect features of the named pkgsrc packages that are likely
22to be bugs, or that are simply deprecated. 22to be bugs, or that are simply deprecated.
23.Pp 23.Pp
@@ -149,26 +149,42 @@ Enable all warnings. @@ -149,26 +149,42 @@ Enable all warnings.
149Disable all warnings. 149Disable all warnings.
150.It Cm [no-]absname 150.It Cm [no-]absname
151Warn if a file contains an absolute pathname. 151Warn if a file contains an absolute pathname.
152.It Cm [no-]directcmd 152.It Cm [no-]directcmd
153Warn if a system command name is used instead of a variable (e.g. sed 153Warn if a system command name is used instead of a variable (e.g. sed
154instead of ${SED}). 154instead of ${SED}).
155.It Cm [no-]extra 155.It Cm [no-]extra
156Emit some additional warnings that are not enabled by default, 156Emit some additional warnings that are not enabled by default,
157for whatever reason. 157for whatever reason.
158.It Cm [no-]order 158.It Cm [no-]order
159Warn if Makefile variables are not in the preferred order. 159Warn if Makefile variables are not in the preferred order.
160.It Cm [no-]perm 160.It Cm [no-]perm
161Warn if a variable is used or defined outside its specified scope. 161Warn if a variable is used or defined outside its specified scope.
 162The available permissions are:
 163.Bl -tag -width 3n -compact
 164.It a
 165append something using +=
 166.It d
 167set a default value using ?=
 168.It s
 169set a variable using :=, =, !=
 170.It p
 171use a variable during preprocessing
 172.It u
 173use a variable at runtime
 174.El
 175A
 176.Sq \&?
 177means that it is not yet clear which permissions are allowed and which aren't.
162.It Cm [no-]plist-depr 178.It Cm [no-]plist-depr
163Warn if deprecated pathnames are used in 179Warn if deprecated pathnames are used in
164.Pa PLIST 180.Pa PLIST
165files. 181files.
166This warning is disabled by default. 182This warning is disabled by default.
167.It Cm [no-]plist-sort 183.It Cm [no-]plist-sort
168Warn if items of a PLIST file are not sorted alphabetically. 184Warn if items of a PLIST file are not sorted alphabetically.
169This warning is disabled by default. 185This warning is disabled by default.
170.It Cm [no-]quoting 186.It Cm [no-]quoting
171Warn for possibly invalid quoting of make variables in shell programs 187Warn for possibly invalid quoting of make variables in shell programs
172and shell variables themselves. 188and shell variables themselves.
173.It Cm [no-]space 189.It Cm [no-]space
174Emit notes for inconsistent use of white-space. 190Emit notes for inconsistent use of white-space.