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

annotate tradcpp.1 @ 114:05d67dd74e1f

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Reduce the maximum include depth from 128 to 120. This way with the default limits on netbsd we hit it before we run out of file handles.
author David A. Holland
date Tue, 11 Jun 2013 13:55:38 -0400
parents b2f2f30194b8
children 103acee239e0
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
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
38 .Op Cm input-file Op Cm output-file
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
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
70 .\" order. Please don't arbirarily alphabetize them.
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.
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
80 .It Fl -Ipath
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 .
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
191 .It Fl fdollars-in-identifiers Fl fno-dollars-in-identifiers
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
b2f2f30194b8 Add a man page.
David A. Holland
parents:
diff changeset
240 .\" David A. Holland
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.