mdoc(7) police: overhaul.

Approved by:	re
This commit is contained in:
Ruslan Ermilov 2002-12-11 17:26:53 +00:00
parent 749757ed33
commit f0fab6045d
Notes: svn2git 2020-12-20 02:59:44 +00:00
svn path=/head/; revision=107750

View File

@ -23,7 +23,7 @@
.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
.\" .\"
.\" FreeBSD: src/usr.bin/c89/c89.1,v 1.4.2.4 2001/08/02 01:11:13 obrien Exp .\" FreeBSD: src/usr.bin/c89/c89.1,v 1.4.2.4 2001/08/02 01:11:13 obrien Exp
.\" $FreeBSD$ .\" $FreeBSD$
.\" .\"
.Dd October 7, 2002 .Dd October 7, 2002
@ -58,20 +58,22 @@ object files that are produced.
.It Fl D Ar name Ns Op = Ns Ar value .It Fl D Ar name Ns Op = Ns Ar value
Define name as if by a C-language Define name as if by a C-language
.Ic #define .Ic #define
directive. If directive.
no If no
.Dq = Ns Ar value .Dq = Ns Ar value
is given, a value of 1 will be used. is given, a value of 1 will be used.
Note that in order to request a Note that in order to request a
translation as specified by translation as specified by
.St -p1003.1-2001 .St -p1003.1-2001 ,
you need to define you need to define
.Dv _POSIX_C_SOURCE=200112L .Dv _POSIX_C_SOURCE=200112L
either in the source or using this option. The either in the source or using this option.
The
.Fl D .Fl D
option has lower precedence than the option has lower precedence than the
.Fl U .Fl U
option. That is, if option.
That is, if
.Ar name .Ar name
is used in both a is used in both a
.Fl U .Fl U
@ -79,7 +81,8 @@ and a
.Fl D .Fl D
option, option,
.Ar name .Ar name
will be undefined regardless of the order of the options. The will be undefined regardless of the order of the options.
The
.Fl D .Fl D
option may be specified more than once. option may be specified more than once.
.It Fl E .It Fl E
@ -91,20 +94,27 @@ Produce symbolic information in the object or executable files.
Change the algorithm for searching for headers whose names are not Change the algorithm for searching for headers whose names are not
absolute pathnames to look in the directory named by the absolute pathnames to look in the directory named by the
.Ar directory .Ar directory
pathname before looking in the usual places. Thus, headers whose pathname before looking in the usual places.
names are enclosed in double-quotes ("") will be searched for first Thus, headers whose
names are enclosed in double-quotes
.Pq Qq
will be searched for first
in the directory of the file with the in the directory of the file with the
.Ic #include .Ic #include
line, then in line, then in
directories named in directories named in
.Fl I .Fl I
options, and last in the usual places. For options, and last in the usual places.
headers whose names are enclosed in angle brackets (<>), the header For headers whose names are enclosed in angle brackets
.Pq Aq ,
the header
will be searched for only in directories named in will be searched for only in directories named in
.Fl I .Fl I
options and then in the usual places. Directories named in options and then in the usual places.
Directories named in
.Fl I .Fl I
options shall be searched in the order specified. The options shall be searched in the order specified.
The
.Fl I .Fl I
option may be specified more than once. option may be specified more than once.
.It Fl L Ar directory .It Fl L Ar directory
@ -112,9 +122,11 @@ Change the algorithm of searching for the libraries named in the
.Fl l .Fl l
objects to look in the directory named by the objects to look in the directory named by the
.Ar directory .Ar directory
pathname before looking in the usual places. Directories named in pathname before looking in the usual places.
Directories named in
.Fl L .Fl L
options will be searched in the order specified. The options will be searched in the order specified.
The
.Fl L .Fl L
option may be specified more than once. option may be specified more than once.
.It Fl o Ar outfile .It Fl o Ar outfile
@ -126,8 +138,8 @@ for the executable file produced.
.It Fl O Ar optlevel .It Fl O Ar optlevel
If If
.Ar optlevel .Ar optlevel
is zero, disable all optimizations. Otherwise, enable optimizations at is zero, disable all optimizations.
the specified level. Otherwise, enable optimizations at the specified level.
.It Fl s .It Fl s
Produce object and/or executable files from which symbolic and other Produce object and/or executable files from which symbolic and other
information not required for proper execution has been removed information not required for proper execution has been removed
@ -142,12 +154,13 @@ option may be specified more than once.
.Pp .Pp
An operand is either in the form of a pathname or the form An operand is either in the form of a pathname or the form
.Fl l .Fl l
library. At least one operand of the pathname form needs to be library.
specified. Supported operands are of the form: At least one operand of the pathname form needs to be specified.
.Bl -tag -offset indent -width "-l library" Supported operands are of the form:
.Bl -tag -offset indent -width ".Fl l Ar library"
.It Ar file Ns Pa .c .It Ar file Ns Pa .c
A C-language source file to be compiled and optionally linked. The A C-language source file to be compiled and optionally linked.
operand must be of this form if the The operand must be of this form if the
.Fl c .Fl c
option is used. option is used.
.It Ar file Ns Pa .a .It Ar file Ns Pa .a
@ -177,6 +190,10 @@ utility interface conforms to
.St -p1003.1-2001 . .St -p1003.1-2001 .
Since it is a wrapper around Since it is a wrapper around
.Tn GCC , .Tn GCC ,
it is limited to the C99 features that GCC actually implements. it is limited to the
.Tn C99
features that
.Tn GCC
actually implements.
See See
.Em http://gcc.gnu.org/gcc-3.1/c99status.html . .Pa http://gcc.gnu.org/gcc-3.1/c99status.html .