d/freebsd-dev
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
c1b118da86
freebsd-dev/usr.bin/c89/c89.1

184 lines
4.9 KiB
Groff
Raw Normal View History

c89 is the Posix.2 name for a C compiler that accepts ANSI/ISO C source code. Basically a shortcut to cc -ansi -trigraphs.
1997-09-17 20:44:54 +00:00
.\"
.\" Copyright (c) 1997 Joerg Wunsch
.\"
.\" All rights reserved.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\" notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\" notice, this list of conditions and the following disclaimer in the
.\" documentation and/or other materials provided with the distribution.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE DEVELOPERS ``AS IS'' AND ANY EXPRESS OR
.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
.\" IN NO EVENT SHALL THE DEVELOPERS BE LIABLE FOR ANY DIRECT, INDIRECT,
.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
$Id$ -> $FreeBSD$
1999-08-28 01:08:13 +00:00
.\" $FreeBSD$
c89 is the Posix.2 name for a C compiler that accepts ANSI/ISO C source code. Basically a shortcut to cc -ansi -trigraphs.
1997-09-17 20:44:54 +00:00
.\" "
.Dd September 17, 1997
.Os
.Dt C89 1
.Sh NAME
.Nm c89
mdoc(7) police: fix markup.
2001-05-10 07:29:35 +00:00
.Nd POSIX.2 C language compiler
c89 is the Posix.2 name for a C compiler that accepts ANSI/ISO C source code. Basically a shortcut to cc -ansi -trigraphs.
1997-09-17 20:44:54 +00:00
.Sh SYNOPSIS
mdoc(7) police: use the new features of the Nm macro.
2000-11-20 19:21:22 +00:00
.Nm
Sync program's usage() with manpage's SYNOPSIS.
2005-05-21 09:55:10 +00:00
.Op Fl cEgOs
.Oo Fl D Ar name Ns Oo = Ns Ar value Oc Oc ...
.Oo Fl I Ar directory Oc ...
.Oo Fl L Ar directory Oc ...
c89 is the Posix.2 name for a C compiler that accepts ANSI/ISO C source code. Basically a shortcut to cc -ansi -trigraphs.
1997-09-17 20:44:54 +00:00
.Op Fl o Ar outfile
Sync program's usage() with manpage's SYNOPSIS.
2005-05-21 09:55:10 +00:00
.Oo Fl U Ar name Oc ...
mdoc(7) police: fix markup.
2001-05-10 07:29:35 +00:00
.Ar operand ...
c89 is the Posix.2 name for a C compiler that accepts ANSI/ISO C source code. Basically a shortcut to cc -ansi -trigraphs.
1997-09-17 20:44:54 +00:00
.Sh DESCRIPTION
This is the name of the C language compiler as required by the
Typo. Standard list of flag Add ``c89: '' in front of error messages to be errx()-like.
1999-12-05 20:01:28 +00:00
.St -p1003.2
c89 is the Posix.2 name for a C compiler that accepts ANSI/ISO C source code. Basically a shortcut to cc -ansi -trigraphs.
1997-09-17 20:44:54 +00:00
standard.
.Pp
Use -ansi -pedantic -trigraphs, as suggested by Bruce. Enforce that only Posix-spec'ed options are being used, so people could use this as a Posixificator of some kind. Document the Posix usage in the man page, so to make it clear what's the difference between Posix c89, and gcc.
1997-09-18 20:55:50 +00:00
The
c89 is the Posix.2 name for a C compiler that accepts ANSI/ISO C source code. Basically a shortcut to cc -ansi -trigraphs.
1997-09-17 20:44:54 +00:00
.Nm
Use -ansi -pedantic -trigraphs, as suggested by Bruce. Enforce that only Posix-spec'ed options are being used, so people could use this as a Posixificator of some kind. Document the Posix usage in the man page, so to make it clear what's the difference between Posix c89, and gcc.
1997-09-18 20:55:50 +00:00
compiler accepts the following options:
Typo. Standard list of flag Add ``c89: '' in front of error messages to be errx()-like.
1999-12-05 20:01:28 +00:00
.Bl -tag -width indent
Use -ansi -pedantic -trigraphs, as suggested by Bruce. Enforce that only Posix-spec'ed options are being used, so people could use this as a Posixificator of some kind. Document the Posix usage in the man page, so to make it clear what's the difference between Posix c89, and gcc.
1997-09-18 20:55:50 +00:00
.It Fl c
Suppress the link-edit phase of the compilation, and do not remove any
object files that are produced.
mdoc(7) police: fix markup.
2001-05-10 07:29:35 +00:00
.It Fl D Ar name Ns Op = Ns Ar value
Use -ansi -pedantic -trigraphs, as suggested by Bruce. Enforce that only Posix-spec'ed options are being used, so people could use this as a Posixificator of some kind. Document the Posix usage in the man page, so to make it clear what's the difference between Posix c89, and gcc.
1997-09-18 20:55:50 +00:00
Define name as if by a C-language
mdoc(7) police: fix markup.
2001-05-10 07:29:35 +00:00
.Ic #define
Mechanically kill hard sentence breaks.
2004-07-02 22:22:35 +00:00
directive.
If
Use -ansi -pedantic -trigraphs, as suggested by Bruce. Enforce that only Posix-spec'ed options are being used, so people could use this as a Posixificator of some kind. Document the Posix usage in the man page, so to make it clear what's the difference between Posix c89, and gcc.
1997-09-18 20:55:50 +00:00
no
mdoc(7) police: fix markup.
2001-05-10 07:29:35 +00:00
.Dq = Ns Ar value
is given, a value of 1 will be used.
Note that in order to request a
Turned the shell script into a binary fixing several minor buglets. Mention _POSIX_SOURCE feature test macro in man page. PR: bin/19337 Submitted by: myself way back when I was a nobody :-) (schweikh) Reviewed by: joerg, bde MFC after: 2 weeks
2001-05-08 19:47:01 +00:00
translation as specified by
.St -p1003.2
you need to define
.Dv _POSIX_SOURCE
Mechanically kill hard sentence breaks.
2004-07-02 22:22:35 +00:00
either in the source or using this option.
The
Use -ansi -pedantic -trigraphs, as suggested by Bruce. Enforce that only Posix-spec'ed options are being used, so people could use this as a Posixificator of some kind. Document the Posix usage in the man page, so to make it clear what's the difference between Posix c89, and gcc.
1997-09-18 20:55:50 +00:00
.Fl D
option has lower precedence than the
.Fl U
Mechanically kill hard sentence breaks.
2004-07-02 22:22:35 +00:00
option.
That is, if
Use -ansi -pedantic -trigraphs, as suggested by Bruce. Enforce that only Posix-spec'ed options are being used, so people could use this as a Posixificator of some kind. Document the Posix usage in the man page, so to make it clear what's the difference between Posix c89, and gcc.
1997-09-18 20:55:50 +00:00
.Ar name
is used in both a
.Fl U
and a
.Fl D
option,
.Ar name
Mechanically kill hard sentence breaks.
2004-07-02 22:22:35 +00:00
will be undefined regardless of the order of the options.
The
Use -ansi -pedantic -trigraphs, as suggested by Bruce. Enforce that only Posix-spec'ed options are being used, so people could use this as a Posixificator of some kind. Document the Posix usage in the man page, so to make it clear what's the difference between Posix c89, and gcc.
1997-09-18 20:55:50 +00:00
.Fl D
option may be specified more than once.
.It Fl E
Copy C-language source files to the standard output, expanding all
preprocessor directives; no compilation will be performed.
.It Fl g
Produce symbolic information in the object or executable files.
.It Fl I Ar directory
Change the algorithm for searching for headers whose names are not
absolute pathnames to look in the directory named by the
.Ar directory
Mechanically kill hard sentence breaks.
2004-07-02 22:22:35 +00:00
pathname before looking in the usual places.
Thus, headers whose
mdoc(7) police: fix markup.
2001-05-10 07:29:35 +00:00
names are enclosed in double-quotes ("") will be searched for first
Use -ansi -pedantic -trigraphs, as suggested by Bruce. Enforce that only Posix-spec'ed options are being used, so people could use this as a Posixificator of some kind. Document the Posix usage in the man page, so to make it clear what's the difference between Posix c89, and gcc.
1997-09-18 20:55:50 +00:00
in the directory of the file with the
mdoc(7) police: fix markup.
2001-05-10 07:29:35 +00:00
.Ic #include
Use -ansi -pedantic -trigraphs, as suggested by Bruce. Enforce that only Posix-spec'ed options are being used, so people could use this as a Posixificator of some kind. Document the Posix usage in the man page, so to make it clear what's the difference between Posix c89, and gcc.
1997-09-18 20:55:50 +00:00
line, then in
directories named in
.Fl I
Mechanically kill hard sentence breaks.
2004-07-02 22:22:35 +00:00
options, and last in the usual places.
For
Use -ansi -pedantic -trigraphs, as suggested by Bruce. Enforce that only Posix-spec'ed options are being used, so people could use this as a Posixificator of some kind. Document the Posix usage in the man page, so to make it clear what's the difference between Posix c89, and gcc.
1997-09-18 20:55:50 +00:00
headers whose names are enclosed in angle brackets (<>), the header
will be searched for only in directories named in
.Fl I
Mechanically kill hard sentence breaks.
2004-07-02 22:22:35 +00:00
options and then in the usual places.
Directories named in
Use -ansi -pedantic -trigraphs, as suggested by Bruce. Enforce that only Posix-spec'ed options are being used, so people could use this as a Posixificator of some kind. Document the Posix usage in the man page, so to make it clear what's the difference between Posix c89, and gcc.
1997-09-18 20:55:50 +00:00
.Fl I
Mechanically kill hard sentence breaks.
2004-07-02 22:22:35 +00:00
options shall be searched in the order specified.
The
Use -ansi -pedantic -trigraphs, as suggested by Bruce. Enforce that only Posix-spec'ed options are being used, so people could use this as a Posixificator of some kind. Document the Posix usage in the man page, so to make it clear what's the difference between Posix c89, and gcc.
1997-09-18 20:55:50 +00:00
.Fl I
option may be specified more than once.
.It Fl L Ar directory
Change the algorithm of searching for the libraries named in the
.Fl l
objects to look in the directory named by the
.Ar directory
Mechanically kill hard sentence breaks.
2004-07-02 22:22:35 +00:00
pathname before looking in the usual places.
Directories named in
Use -ansi -pedantic -trigraphs, as suggested by Bruce. Enforce that only Posix-spec'ed options are being used, so people could use this as a Posixificator of some kind. Document the Posix usage in the man page, so to make it clear what's the difference between Posix c89, and gcc.
1997-09-18 20:55:50 +00:00
.Fl L
Mechanically kill hard sentence breaks.
2004-07-02 22:22:35 +00:00
options will be searched in the order specified.
The
Use -ansi -pedantic -trigraphs, as suggested by Bruce. Enforce that only Posix-spec'ed options are being used, so people could use this as a Posixificator of some kind. Document the Posix usage in the man page, so to make it clear what's the difference between Posix c89, and gcc.
1997-09-18 20:55:50 +00:00
.Fl L
option may be specified more than once.
.It Fl o Ar outfile
Use the pathname
.Ar outfile ,
instead of the default
.Pa a.out ,
for the executable file produced.
.It Fl O
Optimize the compilation.
.It Fl s
Produce object and/or executable files from which symbolic and other
information not required for proper execution has been removed
(stripped).
.It Fl U Ar name
Remove any initial definition of
.Ar name .
The
.Fl U
option may be specified more than once.
.El
c89 is the Posix.2 name for a C compiler that accepts ANSI/ISO C source code. Basically a shortcut to cc -ansi -trigraphs.
1997-09-17 20:44:54 +00:00
.Pp
Use -ansi -pedantic -trigraphs, as suggested by Bruce. Enforce that only Posix-spec'ed options are being used, so people could use this as a Posixificator of some kind. Document the Posix usage in the man page, so to make it clear what's the difference between Posix c89, and gcc.
1997-09-18 20:55:50 +00:00
An operand is either in the form of a pathname or the form
.Fl l
Mechanically kill hard sentence breaks.
2004-07-02 22:22:35 +00:00
library.
At least one operand of the pathname form needs to be
specified.
Supported operands are of the form:
Use -ansi -pedantic -trigraphs, as suggested by Bruce. Enforce that only Posix-spec'ed options are being used, so people could use this as a Posixificator of some kind. Document the Posix usage in the man page, so to make it clear what's the difference between Posix c89, and gcc.
1997-09-18 20:55:50 +00:00
.Bl -tag -offset indent -width "-l library"
mdoc(7) police: fix markup.
2001-05-10 07:29:35 +00:00
.It Ar file Ns Pa .c
Mechanically kill hard sentence breaks.
2004-07-02 22:22:35 +00:00
A C-language source file to be compiled and optionally linked.
The
Use -ansi -pedantic -trigraphs, as suggested by Bruce. Enforce that only Posix-spec'ed options are being used, so people could use this as a Posixificator of some kind. Document the Posix usage in the man page, so to make it clear what's the difference between Posix c89, and gcc.
1997-09-18 20:55:50 +00:00
operand must be of this form if the
.Fl c
option is used.
mdoc(7) police: fix markup.
2001-05-10 07:29:35 +00:00
.It Ar file Ns Pa .a
Use -ansi -pedantic -trigraphs, as suggested by Bruce. Enforce that only Posix-spec'ed options are being used, so people could use this as a Posixificator of some kind. Document the Posix usage in the man page, so to make it clear what's the difference between Posix c89, and gcc.
1997-09-18 20:55:50 +00:00
A library of object files, as produced by
.Xr ar 1 ,
passed directly to the link editor.
mdoc(7) police: fix markup.
2001-05-10 07:29:35 +00:00
.It Ar file Ns Pa .o
Use -ansi -pedantic -trigraphs, as suggested by Bruce. Enforce that only Posix-spec'ed options are being used, so people could use this as a Posixificator of some kind. Document the Posix usage in the man page, so to make it clear what's the difference between Posix c89, and gcc.
1997-09-18 20:55:50 +00:00
An object file produced by
mdoc(7) police: fix markup.
2001-05-10 07:29:35 +00:00
.Nm Fl c ,
Use -ansi -pedantic -trigraphs, as suggested by Bruce. Enforce that only Posix-spec'ed options are being used, so people could use this as a Posixificator of some kind. Document the Posix usage in the man page, so to make it clear what's the difference between Posix c89, and gcc.
1997-09-18 20:55:50 +00:00
and passed directly to the link editor.
mdoc(7) police: fix markup.
2001-05-10 07:29:35 +00:00
.It Fl l Ar library
Use -ansi -pedantic -trigraphs, as suggested by Bruce. Enforce that only Posix-spec'ed options are being used, so people could use this as a Posixificator of some kind. Document the Posix usage in the man page, so to make it clear what's the difference between Posix c89, and gcc.
1997-09-18 20:55:50 +00:00
Search the library named
mdoc(7) police: fix markup.
2001-05-10 07:29:35 +00:00
.Pa lib Ns Ar library Ns Pa .a .
Use -ansi -pedantic -trigraphs, as suggested by Bruce. Enforce that only Posix-spec'ed options are being used, so people could use this as a Posixificator of some kind. Document the Posix usage in the man page, so to make it clear what's the difference between Posix c89, and gcc.
1997-09-18 20:55:50 +00:00
A library will be searched when its name is encountered, so the
placement of a
.Fl l
operand is significant.
.El
c89 is the Posix.2 name for a C compiler that accepts ANSI/ISO C source code. Basically a shortcut to cc -ansi -trigraphs.
1997-09-17 20:44:54 +00:00
.Sh SEE ALSO
Use -ansi -pedantic -trigraphs, as suggested by Bruce. Enforce that only Posix-spec'ed options are being used, so people could use this as a Posixificator of some kind. Document the Posix usage in the man page, so to make it clear what's the difference between Posix c89, and gcc.
1997-09-18 20:55:50 +00:00
.Xr ar 1 ,
c89 is the Posix.2 name for a C compiler that accepts ANSI/ISO C source code. Basically a shortcut to cc -ansi -trigraphs.
1997-09-17 20:44:54 +00:00
.Xr cc 1
.Sh STANDARDS
The
.Nm
command is believed to comply with
.St -p1003.2 .
Reference in New Issue Copy Permalink