Ispell. Begin new sentences on a new line.
This commit is contained in:
parent
70b4d4ce4e
commit
44f2153f1e
|
@ -1,4 +1,4 @@
|
||||||
.\" $NetBSD: lock.1,v 1.7 2001/12/01 16:43:18 wiz Exp $
|
.\" $NetBSD: lock.1,v 1.8 2002/09/26 01:11:33 wiz Exp $
|
||||||
.\"
|
.\"
|
||||||
.\" Copyright (c) 1987, 1990, 1993
|
.\" Copyright (c) 1987, 1990, 1993
|
||||||
.\" The Regents of the University of California. All rights reserved.
|
.\" The Regents of the University of California. All rights reserved.
|
||||||
|
@ -56,16 +56,16 @@ Options:
|
||||||
.Pp
|
.Pp
|
||||||
.Bl -tag -width Fl
|
.Bl -tag -width Fl
|
||||||
.It Fl n
|
.It Fl n
|
||||||
No timeout is used. The terminal will be locked indefinitely or until
|
No timeout is used.
|
||||||
current challenge is met.
|
The terminal will be locked indefinitely or until current challenge is met.
|
||||||
.It Fl p
|
.It Fl p
|
||||||
A password is not requested, instead the user's current login password
|
A password is not requested, instead the user's current login password
|
||||||
is used.
|
is used.
|
||||||
If the user has an S/Key key, they may also use it
|
If the user has an S/Key key, they may also use it
|
||||||
to unlock the terminal. To do this the user should enter "s/key"
|
to unlock the terminal.
|
||||||
at the unlock "Key:" prompt. The user will then be issued an S/Key
|
To do this the user should enter "s/key" at the unlock "Key:" prompt.
|
||||||
challange to which they may respond with a six-word S/Key one-time
|
The user will then be issued an S/Key challenge to which they may respond
|
||||||
password.
|
with a six-word S/Key one-time password.
|
||||||
.It Fl t Ar timeout
|
.It Fl t Ar timeout
|
||||||
The time limit (default 15 minutes) is changed to
|
The time limit (default 15 minutes) is changed to
|
||||||
.Ar timeout
|
.Ar timeout
|
||||||
|
|
|
@ -1,4 +1,4 @@
|
||||||
.\" $NetBSD: lint.1,v 1.22 2002/06/13 22:59:02 wiz Exp $
|
.\" $NetBSD: lint.1,v 1.23 2002/09/26 01:09:46 wiz Exp $
|
||||||
.\"
|
.\"
|
||||||
.\" Copyright (c) 1996 Christopher G. Demetriou. All Rights Reserved.
|
.\" Copyright (c) 1996 Christopher G. Demetriou. All Rights Reserved.
|
||||||
.\" Copyright (c) 1994, 1995 Jochen Pohl
|
.\" Copyright (c) 1994, 1995 Jochen Pohl
|
||||||
|
@ -104,8 +104,8 @@
|
||||||
.Nm
|
.Nm
|
||||||
attempts to detect features of the named C program files
|
attempts to detect features of the named C program files
|
||||||
that are likely to be bugs, to be non-portable, or to be
|
that are likely to be bugs, to be non-portable, or to be
|
||||||
wasteful. It also performs stricter type checking than does
|
wasteful.
|
||||||
the C compiler.
|
It also performs stricter type checking than does the C compiler.
|
||||||
.Nm
|
.Nm
|
||||||
runs the C preprocessor as its first phase, with the
|
runs the C preprocessor as its first phase, with the
|
||||||
preprocessor symbol
|
preprocessor symbol
|
||||||
|
@ -120,7 +120,8 @@ word for all code that is to be checked by
|
||||||
Among the possible problems that are currently noted are
|
Among the possible problems that are currently noted are
|
||||||
unreachable statements, loops not entered at the top,
|
unreachable statements, loops not entered at the top,
|
||||||
variables declared and not used, and logical expressions
|
variables declared and not used, and logical expressions
|
||||||
with constant values. Function calls are checked for
|
with constant values.
|
||||||
|
Function calls are checked for
|
||||||
inconsistencies, such as calls to functions that return
|
inconsistencies, such as calls to functions that return
|
||||||
values in some places and not in others, functions called
|
values in some places and not in others, functions called
|
||||||
with varying numbers of arguments, function calls that
|
with varying numbers of arguments, function calls that
|
||||||
|
@ -131,8 +132,8 @@ the non-existent return value of the function.
|
||||||
.Pp
|
.Pp
|
||||||
Filename arguments ending with
|
Filename arguments ending with
|
||||||
.Pa \&.c
|
.Pa \&.c
|
||||||
are taken to be C source files. Filename arguments with
|
are taken to be C source files.
|
||||||
names ending with
|
Filename arguments with names ending with
|
||||||
.Pa \&.ln
|
.Pa \&.ln
|
||||||
are taken to be the result of an earlier invocation of
|
are taken to be the result of an earlier invocation of
|
||||||
.Nm "" ,
|
.Nm "" ,
|
||||||
|
@ -141,7 +142,8 @@ with either the
|
||||||
.Fl o
|
.Fl o
|
||||||
or
|
or
|
||||||
.Fl C
|
.Fl C
|
||||||
option in effect. The
|
option in effect.
|
||||||
|
The
|
||||||
.Pa \&.ln
|
.Pa \&.ln
|
||||||
files are analogous to the
|
files are analogous to the
|
||||||
.Pa \&.o
|
.Pa \&.o
|
||||||
|
@ -166,7 +168,8 @@ By default,
|
||||||
.Nm
|
.Nm
|
||||||
appends the standard C lint library
|
appends the standard C lint library
|
||||||
.Pq Pa llib-lc.ln
|
.Pq Pa llib-lc.ln
|
||||||
to the end of the list of files. When the
|
to the end of the list of files.
|
||||||
|
When the
|
||||||
.Fl i
|
.Fl i
|
||||||
option is used, the
|
option is used, the
|
||||||
.Pa \&.ln
|
.Pa \&.ln
|
||||||
|
@ -177,16 +180,17 @@ or
|
||||||
.Fl i
|
.Fl i
|
||||||
options are used, the
|
options are used, the
|
||||||
.Pa llib-l Ns Ar library Ns Pa \&.ln
|
.Pa llib-l Ns Ar library Ns Pa \&.ln
|
||||||
files are ignored. When the
|
files are ignored.
|
||||||
|
When the
|
||||||
.Fl i
|
.Fl i
|
||||||
option is
|
option is
|
||||||
.Em omitted
|
.Em omitted
|
||||||
the second pass of
|
the second pass of
|
||||||
.Nm
|
.Nm
|
||||||
checks this list of files for mutual compatibility. At this point,
|
checks this list of files for mutual compatibility.
|
||||||
if a complaint stems not from a given source file, but from one of
|
At this point, if a complaint stems not from a given source file,
|
||||||
its included files, the source filename will be printed followed by
|
but from one of its included files, the source filename will be
|
||||||
a question mark.
|
printed followed by a question mark.
|
||||||
.Pp
|
.Pp
|
||||||
The special input file name
|
The special input file name
|
||||||
.Dq Pa -
|
.Dq Pa -
|
||||||
|
@ -221,8 +225,8 @@ cause implicit narrowing conversion.
|
||||||
.It Fl b
|
.It Fl b
|
||||||
Report
|
Report
|
||||||
.Sy break
|
.Sy break
|
||||||
statements that cannot be reached. This is not the default
|
statements that cannot be reached.
|
||||||
because, unfortunately, most
|
This is not the default because, unfortunately, most
|
||||||
.Xr lex 1
|
.Xr lex 1
|
||||||
and many
|
and many
|
||||||
.Xr yacc 1
|
.Xr yacc 1
|
||||||
|
@ -239,9 +243,10 @@ and
|
||||||
.It Fl g
|
.It Fl g
|
||||||
Don't print warnings for some extensions of
|
Don't print warnings for some extensions of
|
||||||
.Xr gcc 1
|
.Xr gcc 1
|
||||||
to the C language. Currently these are nonconstant initializers in
|
to the C language.
|
||||||
automatic aggregate initializations, arithmetic on pointer to void,
|
Currently these are nonconstant initializers in automatic aggregate
|
||||||
trailing commas in enum declarations, C++ -style
|
initializations, arithmetic on pointer to void, trailing commas in
|
||||||
|
enum declarations, C++ -style
|
||||||
.Dq //
|
.Dq //
|
||||||
comments,
|
comments,
|
||||||
zero sized structures, subscripting of non-lvalue arrays, prototypes
|
zero sized structures, subscripting of non-lvalue arrays, prototypes
|
||||||
|
@ -266,7 +271,8 @@ Produce a
|
||||||
.Pa \&.ln
|
.Pa \&.ln
|
||||||
file for every
|
file for every
|
||||||
.Pa \&.c
|
.Pa \&.c
|
||||||
file on the command line. These
|
file on the command line.
|
||||||
|
These
|
||||||
.Pa \&.ln
|
.Pa \&.ln
|
||||||
files are the product of
|
files are the product of
|
||||||
.Nm "" Ns 's
|
.Nm "" Ns 's
|
||||||
|
@ -280,9 +286,11 @@ Attempt to check portability of code to other dialects of C.
|
||||||
In case of redeclarations report the position of the
|
In case of redeclarations report the position of the
|
||||||
previous declaration.
|
previous declaration.
|
||||||
.It Fl s
|
.It Fl s
|
||||||
Strict ANSI C mode. Issue warnings and errors required by ANSI C.
|
Strict ANSI C mode.
|
||||||
|
Issue warnings and errors required by ANSI C.
|
||||||
Also do not produce warnings for constructs which behave
|
Also do not produce warnings for constructs which behave
|
||||||
differently in traditional C and ANSI C. With the
|
differently in traditional C and ANSI C.
|
||||||
|
With the
|
||||||
.Fl s
|
.Fl s
|
||||||
flag,
|
flag,
|
||||||
.Li __STRICT_ANSI__
|
.Li __STRICT_ANSI__
|
||||||
|
@ -290,14 +298,16 @@ is a predefined preprocessor macro.
|
||||||
.It Fl t
|
.It Fl t
|
||||||
Traditional C mode.
|
Traditional C mode.
|
||||||
.Li __STDC__
|
.Li __STDC__
|
||||||
is not predefined in this mode. Warnings are printed for constructs
|
is not predefined in this mode.
|
||||||
not allowed in traditional C. Warnings for constructs which behave
|
Warnings are printed for constructs not allowed in traditional C.
|
||||||
differently in traditional C and ANSI C are suppressed. Preprocessor
|
Warnings for constructs which behave differently in traditional C
|
||||||
macros describing the machine type (e.g.
|
and ANSI C are suppressed.
|
||||||
|
Preprocessor macros describing the machine type (e.g.
|
||||||
.Li sun3 )
|
.Li sun3 )
|
||||||
and machine architecture (e.g.
|
and machine architecture (e.g.
|
||||||
.Li m68k )
|
.Li m68k )
|
||||||
are defined without leading and trailing underscores. The keywords
|
are defined without leading and trailing underscores.
|
||||||
|
The keywords
|
||||||
.Sy const ,
|
.Sy const ,
|
||||||
.Sy volatile
|
.Sy volatile
|
||||||
and
|
and
|
||||||
|
@ -321,7 +331,8 @@ Do not complain about structures that are never defined
|
||||||
(for example, using a structure pointer without knowing
|
(for example, using a structure pointer without knowing
|
||||||
its contents).
|
its contents).
|
||||||
.It Fl B Ns Ar path
|
.It Fl B Ns Ar path
|
||||||
Path to use when looking for the lint1 and lint2 binaries. Defualts to
|
Path to use when looking for the lint1 and lint2 binaries.
|
||||||
|
Defaults to
|
||||||
.Pa /usr/libexec .
|
.Pa /usr/libexec .
|
||||||
.It Fl C Ns Ar library
|
.It Fl C Ns Ar library
|
||||||
Create a
|
Create a
|
||||||
|
@ -332,7 +343,8 @@ This library is built from all
|
||||||
.Pa \&.c
|
.Pa \&.c
|
||||||
and
|
and
|
||||||
.Pa \&.ln
|
.Pa \&.ln
|
||||||
input files. After all global definitions of functions and
|
input files.
|
||||||
|
After all global definitions of functions and
|
||||||
variables in these files are written to the newly created library,
|
variables in these files are written to the newly created library,
|
||||||
.Nm
|
.Nm
|
||||||
checks all input files, including libraries specified with the
|
checks all input files, including libraries specified with the
|
||||||
|
@ -345,7 +357,8 @@ for
|
||||||
.Xr cpp 1 ,
|
.Xr cpp 1 ,
|
||||||
as if by a
|
as if by a
|
||||||
.Li #define
|
.Li #define
|
||||||
directive. If no definition is given,
|
directive.
|
||||||
|
If no definition is given,
|
||||||
.Ar name
|
.Ar name
|
||||||
is defined as 1.
|
is defined as 1.
|
||||||
.It Fl I Ns Ar directory
|
.It Fl I Ns Ar directory
|
||||||
|
@ -379,16 +392,19 @@ Name the output file
|
||||||
.Ar outputfile .
|
.Ar outputfile .
|
||||||
The output file produced is the input that is given to
|
The output file produced is the input that is given to
|
||||||
.Nm "" Ns 's
|
.Nm "" Ns 's
|
||||||
second pass. The
|
second pass.
|
||||||
|
The
|
||||||
.Fl o
|
.Fl o
|
||||||
option simply saves this file in the named output file. If the
|
option simply saves this file in the named output file.
|
||||||
|
If the
|
||||||
.Fl i
|
.Fl i
|
||||||
option is also used the files are not checked for compatibility.
|
option is also used the files are not checked for compatibility.
|
||||||
To produce a
|
To produce a
|
||||||
.Pa llib-l Ns Ar library Ns Pa \&.ln
|
.Pa llib-l Ns Ar library Ns Pa \&.ln
|
||||||
without extraneous messages, use of the
|
without extraneous messages, use of the
|
||||||
.Fl u
|
.Fl u
|
||||||
option is suggested. The
|
option is suggested.
|
||||||
|
The
|
||||||
.Fl v
|
.Fl v
|
||||||
option is useful if the source file(s) for the lint library
|
option is useful if the source file(s) for the lint library
|
||||||
are just external interfaces.
|
are just external interfaces.
|
||||||
|
@ -404,8 +420,8 @@ first and second pass.
|
||||||
.It Fl w
|
.It Fl w
|
||||||
Treat warnings as errors.
|
Treat warnings as errors.
|
||||||
.It Fl X Ar id Ns Op ,id ...
|
.It Fl X Ar id Ns Op ,id ...
|
||||||
Suppress error messages identified by the list of ids. A list of messages
|
Suppress error messages identified by the list of ids.
|
||||||
and ids can be found in
|
A list of messages and ids can be found in
|
||||||
.Xr lint 7 .
|
.Xr lint 7 .
|
||||||
.El
|
.El
|
||||||
.Pp
|
.Pp
|
||||||
|
@ -441,8 +457,8 @@ suppress complaints about fall through to a
|
||||||
.Sy case
|
.Sy case
|
||||||
or
|
or
|
||||||
.Sy default
|
.Sy default
|
||||||
labelled statement. This directive should be placed immediately
|
labeled statement.
|
||||||
preceding the label.
|
This directive should be placed immediately preceding the label.
|
||||||
.It Li /* LINTLIBRARY */
|
.It Li /* LINTLIBRARY */
|
||||||
At the beginning of a file, mark all functions and variables defined
|
At the beginning of a file, mark all functions and variables defined
|
||||||
in this file as
|
in this file as
|
||||||
|
@ -456,7 +472,8 @@ Also shut off complaints about unused function arguments.
|
||||||
.Li */
|
.Li */
|
||||||
.Xc
|
.Xc
|
||||||
Suppresses any intra-file warning except those dealing with
|
Suppresses any intra-file warning except those dealing with
|
||||||
unused variables or functions. This directive should be placed
|
unused variables or functions.
|
||||||
|
This directive should be placed
|
||||||
on the line immediately preceding where the lint warning occurred.
|
on the line immediately preceding where the lint warning occurred.
|
||||||
.It Li /* LONGLONG */
|
.It Li /* LONGLONG */
|
||||||
Suppress complaints about use of long long integer types.
|
Suppress complaints about use of long long integer types.
|
||||||
|
@ -470,7 +487,8 @@ makes
|
||||||
.Nm
|
.Nm
|
||||||
check the first
|
check the first
|
||||||
.Pq Ar n Ns No -1
|
.Pq Ar n Ns No -1
|
||||||
arguments as usual. The
|
arguments as usual.
|
||||||
|
The
|
||||||
.Ar n Ns No -th
|
.Ar n Ns No -th
|
||||||
argument is interpreted as a
|
argument is interpreted as a
|
||||||
.Sy printf
|
.Sy printf
|
||||||
|
@ -481,10 +499,11 @@ causes
|
||||||
to treat function declaration prototypes as function definitions
|
to treat function declaration prototypes as function definitions
|
||||||
if
|
if
|
||||||
.Ar n
|
.Ar n
|
||||||
is non-zero. This directive can only be used in conjunction with
|
is non-zero.
|
||||||
the
|
This directive can only be used in conjunction with the
|
||||||
.Li /* LINTLIBRARY */
|
.Li /* LINTLIBRARY */
|
||||||
directive. If
|
directive.
|
||||||
|
If
|
||||||
.Ar n
|
.Ar n
|
||||||
is zero, function prototypes will be treated normally.
|
is zero, function prototypes will be treated normally.
|
||||||
.It Li /* SCANFLIKE Ns Ar n Li */
|
.It Li /* SCANFLIKE Ns Ar n Li */
|
||||||
|
@ -492,14 +511,16 @@ makes
|
||||||
.Nm
|
.Nm
|
||||||
check the first
|
check the first
|
||||||
.Pq Ar n Ns No -1
|
.Pq Ar n Ns No -1
|
||||||
arguments as usual. The
|
arguments as usual.
|
||||||
|
The
|
||||||
.Ar n Ns No -th
|
.Ar n Ns No -th
|
||||||
argument is interpreted as a
|
argument is interpreted as a
|
||||||
.Sy scanf
|
.Sy scanf
|
||||||
format string that is used to check the remaining arguments.
|
format string that is used to check the remaining arguments.
|
||||||
.It Li /* VARARGS Ns Ar n Li */
|
.It Li /* VARARGS Ns Ar n Li */
|
||||||
Suppress the usual checking for variable numbers of arguments in
|
Suppress the usual checking for variable numbers of arguments in
|
||||||
the following function declaration. The data types of the first
|
the following function declaration.
|
||||||
|
The data types of the first
|
||||||
.Ar n
|
.Ar n
|
||||||
arguments are checked; a missing
|
arguments are checked; a missing
|
||||||
.Ar n
|
.Ar n
|
||||||
|
@ -512,17 +533,19 @@ and the
|
||||||
.Fl o
|
.Fl o
|
||||||
options allows for incremental use of
|
options allows for incremental use of
|
||||||
.Nm
|
.Nm
|
||||||
on a set of C source files. Generally, one invokes
|
on a set of C source files.
|
||||||
|
Generally, one invokes
|
||||||
.Nm
|
.Nm
|
||||||
once for each source file with the
|
once for each source file with the
|
||||||
.Fl i
|
.Fl i
|
||||||
option. Each of these invocations produces a
|
option.
|
||||||
|
Each of these invocations produces a
|
||||||
.Pa \&.ln
|
.Pa \&.ln
|
||||||
file that corresponds to the
|
file that corresponds to the
|
||||||
.Pa \&.c
|
.Pa \&.c
|
||||||
file, and prints all messages that are about just that
|
file, and prints all messages that are about just that
|
||||||
source file. After all the source files have been separetely
|
source file.
|
||||||
run through
|
After all the source files have been separately run through
|
||||||
.Nm "" ,
|
.Nm "" ,
|
||||||
it is invoked once more (without the
|
it is invoked once more (without the
|
||||||
.Fl i
|
.Fl i
|
||||||
|
@ -530,8 +553,9 @@ option), listing all the
|
||||||
.Pa \&.ln
|
.Pa \&.ln
|
||||||
files with the needed
|
files with the needed
|
||||||
.Fl l Ns Ar library
|
.Fl l Ns Ar library
|
||||||
options. this will print all the inter-file inconsistencies. This
|
options.
|
||||||
scheme works well with
|
This will print all the inter-file inconsistencies.
|
||||||
|
This scheme works well with
|
||||||
.Xr make 1 ;
|
.Xr make 1 ;
|
||||||
it allows
|
it allows
|
||||||
.Xr make 1
|
.Xr make 1
|
||||||
|
@ -545,15 +569,16 @@ time the set of source files were
|
||||||
.It Ev LIBDIR
|
.It Ev LIBDIR
|
||||||
the directory where the lint libraries specified by the
|
the directory where the lint libraries specified by the
|
||||||
.Fl l Ns Ar library
|
.Fl l Ns Ar library
|
||||||
option must exist. If this environment variable is undefined,
|
option must exist.
|
||||||
then the default path
|
If this environment variable is undefined, then the default path
|
||||||
.Pa /usr/libdata/lint
|
.Pa /usr/libdata/lint
|
||||||
will be used to search for the libraries.
|
will be used to search for the libraries.
|
||||||
.It Ev TMPDIR
|
.It Ev TMPDIR
|
||||||
usually the path for temporary files can be redefined by setting
|
usually the path for temporary files can be redefined by setting
|
||||||
this environment variable.
|
this environment variable.
|
||||||
.It Ev CC
|
.It Ev CC
|
||||||
Location of the C compiler program. Defaults to
|
Location of the C compiler program.
|
||||||
|
Defaults to
|
||||||
.Pa /usr/bin/cc .
|
.Pa /usr/bin/cc .
|
||||||
.El
|
.El
|
||||||
.Sh FILES
|
.Sh FILES
|
||||||
|
@ -588,7 +613,7 @@ option will, when used in later
|
||||||
runs, cause certain errors that were reported when the libraries
|
runs, cause certain errors that were reported when the libraries
|
||||||
were created to be reported again, and cause line numbers and file
|
were created to be reported again, and cause line numbers and file
|
||||||
names from the original source used to create those libraries
|
names from the original source used to create those libraries
|
||||||
to be reported in error messages. For these reasons, it is recommended
|
to be reported in error messages.
|
||||||
to use the
|
For these reasons, it is recommended to use the
|
||||||
.Fl C
|
.Fl C
|
||||||
option to create lint libraries.
|
option to create lint libraries.
|
||||||
|
|
Loading…
Reference in New Issue