Mercurial > ~dholland > hg > tradcpp > index.cgi

annotate tradcpp.1 @ 121:103acee239e0

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Man page fixes from wiz@.
author David A. Holland
date Tue, 11 Jun 2013 18:02:13 -0400
parents b2f2f30194b8
children 64c4de3709de
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
110
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
1 .\"
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
2 .\" Copyright (c) 2013 The NetBSD Foundation, Inc.
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
3 .\" All rights reserved.
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
4 .\"
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
5 .\" This code is derived from software contributed to The NetBSD Foundation
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
6 .\" by David A. Holland.
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
7 .\"
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
8 .\" Redistribution and use in source and binary forms, with or without
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
9 .\" modification, are permitted provided that the following conditions
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
10 .\" are met:
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
11 .\" 1. Redistributions of source code must retain the above copyright
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
12 .\" notice, this list of conditions and the following disclaimer.
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
13 .\" 2. Redistributions in binary form must reproduce the above copyright
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
14 .\" notice, this list of conditions and the following disclaimer in the
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
15 .\" documentation and/or other materials provided with the distribution.
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
16 .\"
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
17 .\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
18 .\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
19 .\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
20 .\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
21 .\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
22 .\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
23 .\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
24 .\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
25 .\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
26 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
27 .\" POSSIBILITY OF SUCH DAMAGE.
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
28 .\"
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
29 .Dd June 11, 2013
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
30 .Dt TRADCPP 1
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
31 .Os
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
32 .Sh NAME
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
33 .Nm tradcpp
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
34 .Nd traditional (K&R-style) C macro preprocessor
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
35 .Sh SYNOPSIS
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
36 .Nm tradcpp
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
37 .Op Fl options
121
103acee239e0 Man page fixes from wiz@.
David A. Holland
parents: 110
diff changeset
38 .Op Ar input-file Op Ar output-file
110
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
39 .Sh DESCRIPTION
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
40 The
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
41 .Nm
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
42 command provides a traditional K&R-style C macro preprocessor.
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
43 It is intended to be suitable for historical Unix uses of the
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
44 preprocessor, such as
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
45 .Xr imake 1 ,
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
46 particularly those that depend on preservation of whitespace.
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
47 .Pp
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
48 The chief ways in which traditional cpp differs from
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
49 Standard C are:
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
50 .Bl -bullet -offset indent
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
51 .It
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
52 Macro arguments are expanded within quoted strings.
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
53 There is no stringize operator.
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
54 .It
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
55 There is no token pasting operator; tokens can be concatenated by
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
56 placing comments between them.
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
57 This process is also not limited to valid C language tokens.
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
58 .It
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
59 Whitespace is preserved, and in particular tabs are not expanded into
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
60 spaces.
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
61 Furthermore, additional whitespace is not injected.
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
62 .El
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
63 .Sh OPTIONS
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
64 .Nm
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
65 has many options, many of which are defined for compatibility with
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
66 .Xr gcc 1
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
67 or other compilers.
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
68 Many of the options are not yet implemented.
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
69 .\" The option lists have been sorted in what I hope is a sensible
121
103acee239e0 Man page fixes from wiz@.
David A. Holland
parents: 110
diff changeset
70 .\" order. Please don't arbitrarily alphabetize them.
110
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
71 .Ss Common Options
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
72 .Bl -tag -width bubblebabble
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
73 .It Fl C
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
74 Retain comments in output.
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
75 .It Fl Dmacro[=expansion]
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
76 Provide a definition for the named macro.
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
77 If no expansion is provided, the value
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
78 .Dq 1
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
79 is used.
121
103acee239e0 Man page fixes from wiz@.
David A. Holland
parents: 110
diff changeset
80 .It Fl Ipath
110
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
81 Add the specified path to the main list of include directories.
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
82 .It Fl nostdinc
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
83 Do not search the standard system include directories.
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
84 .It Fl P
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
85 Suppress line number information in the output.
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
86 Currently line number information is not generated at all and this
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
87 option has no effect.
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
88 .It Fl Umacro
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
89 Remove any existing defintion for the named macro.
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
90 .It Fl undef
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
91 Remove all predefined macros.
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
92 .El
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
93 .Ss Warning Options
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
94 Warning options can be disabled or enabled by inserting, or not, the
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
95 string
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
96 .Dq no-
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
97 between the
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
98 .Dq W
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
99 and the warning name.
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
100 Herein the
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
101 .Dq Fl Wno-
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
102 form is shown for options that are enabled by default.
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
103 .Bl -tag -width bubblebabble
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
104 .It Fl Wall
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
105 Turn on all warnings.
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
106 The option
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
107 .Fl Wno-all
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
108 disables only the warnings that are disabled by default.
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
109 .It Fl w
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
110 Turn off all warnings.
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
111 .It Fl Werror
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
112 Make warnings into fatal errors.
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
113 .It Fl Wcomment
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
114 Warn about nested comments.
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
115 .It Fl Wno-endif-labels
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
116 Don't warn about symbols attached to #endif directives.
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
117 (The warning is currently not implemented.)
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
118 .It Fl Wundef
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
119 Warn about undefined symbols appearing in #if and #elif expressions.
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
120 .It Fl Wunused-macros
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
121 Warn about macros that are defined and never used.
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
122 Not implemented.
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
123 .El
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
124 .Ss Depend Options
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
125 .Bl -tag -width bubblebabble
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
126 .It Fl M
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
127 Generate dependency information for
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
128 .Xr make 1
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
129 on the standard output, instead of preprocessing.
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
130 Not implemented.
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
131 .It Fl MD
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
132 Like
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
133 .Fl M
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
134 but skip system headers.
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
135 Not implemented.
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
136 .It Fl MM
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
137 Like
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
138 .Fl M
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
139 but write the dependency information to a file named after the input
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
140 file with extension
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
141 .Pa \.d
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
142 and preprocess normally to standard output.
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
143 Not implemented.
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
144 .It Fl MMD
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
145 Like
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
146 .Fl MM
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
147 but skip system headers.
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
148 Not implemented.
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
149 .It Fl MG
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
150 When generating dependency information, assume that missing files are
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
151 generated instead of failing.
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
152 Not implemented.
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
153 .It Fl MP
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
154 Issue dummy rules for all include files.
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
155 This prevents
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
156 .Xr make 1
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
157 from choking if an include file is removed.
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
158 Not implemented.
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
159 .El
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
160 .Ss Diagnostic Options
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
161 .Bl -tag -width bubblebabble
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
162 .It Fl dD
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
163 Dump all macro definitions, except for the predefined macros, after
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
164 the normal preprocessing output.
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
165 Not implemented.
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
166 .It Fl dI
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
167 Dump all include directives along with the normal preprocessing
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
168 output.
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
169 Not implemented.
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
170 .It Fl dM
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
171 Dump all macro definitions instead of the normal preprocessing
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
172 output.
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
173 Not implemented.
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
174 .It Fl dN
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
175 Like
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
176 .Fl dD
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
177 but emits only macro names and not the expansions.
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
178 Not implemented.
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
179 .It Fl H
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
180 Output a trace of the include tree as it gets processed.
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
181 Not implemented.
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
182 .El
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
183 .Ss Other Options
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
184 .Bl -tag -width bubblebabble
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
185 .It Fl CC
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
186 Retain comments in output.
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
187 Same as
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
188 .Fl C ,
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
189 accepted for compatibility with
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
190 .Xr gcc 1 .
121
103acee239e0 Man page fixes from wiz@.
David A. Holland
parents: 110
diff changeset
191 .It Fl fdollars-in-identifiers , Fl fno-dollars-in-identifiers
110
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
192 Enable
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
193 .Pq or disable, respectively
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
194 the use of the dollar sign in identifiers.
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
195 Not implemented.
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
196 .It Fl ftabstop=num
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
197 Set the tab width to the specified value, for reporting column
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
198 positions in diagnostics.
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
199 The default is 8.
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
200 Not implemented.
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
201 .It Fl std=standard
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
202 Ask
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
203 .Nm
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
204 to conform to the named standard.
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
205 The default, and the only supported value, is
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
206 .Dq krc .
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
207 .It Fl traditional
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
208 This option is accepted for compatibility with
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
209 .Xr gcc 1
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
210 and ignored.
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
211 .El
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
212 .Sh FILES
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
213 The default list of directories searched for include files is:
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
214 .Bl -item -offset indent -compact
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
215 .It
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
216 .Pa /usr/local/include
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
217 .It
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
218 .Pa /usr/include
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
219 .El
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
220 .Sh SEE ALSO
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
221 .Xr cc 1 ,
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
222 .Xr cpp 1 ,
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
223 .Xr make 1
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
224 .Sh STANDARDS
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
225 None.
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
226 The whole point of a traditional cpp is that it reflects practices
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
227 in pre-standardization implementations of C.
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
228 Some information is available from the first edition of Kernighan and
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
229 Ritchie.
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
230 Much of the rest of the behavior is based on lore, pragmatism,
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
231 material encountered in the wild, and comparison to other
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
232 implementations.
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
233 .Sh HISTORY
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
234 The original version of
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
235 .Nm
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
236 was written one evening in late 2010.
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
237 This version had some problems and was put aside.
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
238 The first working version was released in June 2013.
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
239 .\" .Sh AUTHORS
121
103acee239e0 Man page fixes from wiz@.
David A. Holland
parents: 110
diff changeset
240 .\" .An David A. Holland
110
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
241 .Sh BUGS
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
242 Probably plenty.