08837877ea
* Fix some grammar nits in portlint.1 * Add some missing options to the summary in portlint.1 * Reorganize some option descriptions in portlint.1 * Add an ENVIRONMENT section describing PL_CVS_IGNORE and PORTSDIR in portlint.1 * Don't check the MAINTAINER field for direct command use [1] * Add a new PL_CVS_IGNORE environment variable that allows users to filter out certain patterns from the CVS files check [2] * Only warn about CATEGORY problems if the user is in PORTSDIR [3] * Sync new command macros with recent bsd.port.mk changes * Correct a regular expression problem when looking for direct command use [4] PR: 61562 [1] 61449 [2] [3] Submitted by: Sergey Matveychuk <sem@ciam.ru> [1] sergei [3] leeym [4]
169 lines
4.1 KiB
Groff
169 lines
4.1 KiB
Groff
.\" $FreeBSD$
|
|
.\"
|
|
.\" Copyright (c) 1997 by Jun-ichiro Hagino <itojun@itojun.org>.
|
|
.\" All Rights Reserved. Absolutely no warranty.
|
|
.\"
|
|
.Dd July 11, 1997
|
|
.Dt PORTLINT 1
|
|
.Sh NAME
|
|
.Nm portlint
|
|
.Nd a verifier for port directories
|
|
.Sh SYNOPSIS
|
|
.Nm portlint
|
|
.Op Fl abchvtACNV
|
|
.Op Fl M Ar ENV
|
|
.Op Fl B Ar n
|
|
.Op Ar dir
|
|
.Sh DESCRIPTION
|
|
.Nm
|
|
tries to verify the content of a port directory.
|
|
The purpose of
|
|
.Nm
|
|
can be separated into two parts:
|
|
.Pq 1
|
|
to let the submitters easily polish their own port directory, and
|
|
.Pq 2
|
|
to decrease the labor of the committers.
|
|
.Pp
|
|
.Nm
|
|
uses very simple regular-expression matching for verifying
|
|
files that make up a port directory.
|
|
Note that it does NOT implement a complete parser for those files.
|
|
Because of this the user may see some extra warnings,
|
|
especially when checking complex
|
|
.Pa Makefile Ns No s .
|
|
.Pp
|
|
.Sy Options
|
|
.Bl -tag -width Fl
|
|
.It Fl a
|
|
Perform additional checks for extra files, such as
|
|
.Pa scripts/*
|
|
and
|
|
.Pa pkg-* .
|
|
.It Fl b
|
|
Warn the use of
|
|
.Pa $(VARIABLE) .
|
|
Some of the committers prefer
|
|
.Pa ${VARIABLE}
|
|
instead of
|
|
.Pa $(VARIABLE) ,
|
|
even though they are semantically same.
|
|
.It Fl c
|
|
Committer flag.
|
|
It will add several checks useful only for committers.
|
|
If you are a committer and performing check just before committing a port,
|
|
use this option.
|
|
.It Fl h
|
|
Show the summary of command line options, then exit.
|
|
.It Fl v
|
|
Be verbose.
|
|
Show the progress report for items that are being checked.
|
|
.It Fl t
|
|
Nit pick about use of spaces.
|
|
.It Fl A
|
|
Turn on all additional checks.
|
|
.It Fl C
|
|
Pedantic committer flag. This is equivalent to
|
|
.Fl abct .
|
|
.It Fl N
|
|
New port flag.
|
|
Adds several checks specific to newly submitted port.
|
|
If you are willing to submit the directory to be checked as a new port,
|
|
use this option.
|
|
.It Fl V
|
|
Print the portlint version and exit.
|
|
.It Fl M Ar ENV
|
|
Set make variables to
|
|
.Pa ENV
|
|
(ex. PORTSDIR=/usr/ports.work).
|
|
.It Fl B Ar n
|
|
Set the number of contiguous blank lines allowed in
|
|
.Pa Makefile
|
|
to
|
|
.Ar n .
|
|
(by default,
|
|
.Ar n
|
|
is 1)
|
|
.It dir
|
|
The port directory to be checked.
|
|
If omitted, check will be performed over the current directory.
|
|
.El
|
|
.Sh DIAGNOSTICS
|
|
Messages will be sent to standard output, not standard error output.
|
|
.Bl -tag -width WARN: foobaa
|
|
.It FATAL: ...
|
|
This type of error messages suggest that there is some fatal error
|
|
in the port directory.
|
|
For example, if some files need a rewrite, or if
|
|
some inevitable files are missing, this message will show up.
|
|
This kind of errors should be avoided BEFORE submitting
|
|
a port via send-pr to the committers.
|
|
.\"If a submitter submits it without update, committers will need to rewrite
|
|
.\"on behalf of the submitters, which may result in delay of
|
|
.\"the development of operating system itself.
|
|
.It WARN: ...
|
|
This type of error messages suggest that some files may (or may not)
|
|
need some fix.
|
|
Basically, warnings are produced when
|
|
.Nm
|
|
is not completely sure about the result.
|
|
For example, complex
|
|
.Pa Makefile Ns No s
|
|
may need some statements that can match the regular expression
|
|
.Nm
|
|
uses for sanity checks.
|
|
In those cases, the user should evaluate the result manually,
|
|
and obey/ignore the result.
|
|
.It OK: ...
|
|
This type of messages are used in verbose mode
|
|
.Pq Fl v .
|
|
.El
|
|
.Sh ENVIRONMENT
|
|
The following environment variables affect the execution of
|
|
.Nm :
|
|
.Bl -tag -width ".Ev PL_CVS_IGNORE"
|
|
.It Ev PL_CVS_IGNORE
|
|
Set to a Perl-compatible regular expression, of patterns
|
|
to ignore when checking to see if files are in the CVS
|
|
repository. For example,
|
|
.Li '^\ed+$|^pr-patch$' .
|
|
.It Ev PORTSDIR
|
|
The fully-qualified path to the ports tree.
|
|
For example,
|
|
.Dq Li /usr/ports .
|
|
.El
|
|
.Sh FILES
|
|
.Bl -tag -width bsd.port.mkxx -compact
|
|
.It Pa bsd.port.mk
|
|
master Makefile for ports
|
|
.Po
|
|
.Pa bsd.pkg.mk
|
|
on
|
|
.Nx
|
|
/
|
|
.Ox
|
|
.Pc
|
|
.It Pa /usr/ports/*
|
|
ports collection
|
|
.Po
|
|
.Pa /usr/pkgsrc/*
|
|
on
|
|
.Nx
|
|
/
|
|
.Ox
|
|
.Pc ;
|
|
can be overriden by setting the
|
|
.Va PORTSDIR
|
|
environment variable.
|
|
|
|
.Sh AUTHORS
|
|
.An Joe Marcus Clarke Aq marcus@FreeBSD.org
|
|
.An Michael Haro Aq mharo@FreeBSD.org
|
|
.An Jun-ichiro Hagino Aq itojun@itojun.org
|
|
and
|
|
.An Yoshishige Arai Aq ryo2@on.rim.or.jp .
|
|
.Pp
|
|
Many people have contributed patches and comments/suggestions.
|
|
.Sh BUGS
|
|
.Nm
|
|
is not a magic wand, as described above.
|