tradcpp K&R-style C preprocessor: tradcpp.1 annotate

annotate tradcpp.1 @ 122:64c4de3709de

Complain if -[DIU] is given an empty argument. (Like many compilers over the years, we don't accept the argument appearing in the next argv word.) Warn about this in the man page too.

author	David A. Holland
date	Tue, 11 Jun 2013 18:32:41 -0400
parents	103acee239e0
children	9f479b52364a

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.
122 64c4de3709de Complain if -[DIU] is given an empty argument. David A. Holland parents: 121 diff changeset	80 Note that like many Unix compilers,
64c4de3709de Complain if -[DIU] is given an empty argument. David A. Holland parents: 121 diff changeset	81 .Nm
64c4de3709de Complain if -[DIU] is given an empty argument. David A. Holland parents: 121 diff changeset	82 does not accept a space between the
64c4de3709de Complain if -[DIU] is given an empty argument. David A. Holland parents: 121 diff changeset	83 .Dq D
64c4de3709de Complain if -[DIU] is given an empty argument. David A. Holland parents: 121 diff changeset	84 and the macro name.
121 103acee239e0 Man page fixes from wiz@. David A. Holland parents: 110 diff changeset	85 .It Fl Ipath
110 b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	86 Add the specified path to the main list of include directories.
122 64c4de3709de Complain if -[DIU] is given an empty argument. David A. Holland parents: 121 diff changeset	87 Note that like many Unix compilers,
64c4de3709de Complain if -[DIU] is given an empty argument. David A. Holland parents: 121 diff changeset	88 .Nm
64c4de3709de Complain if -[DIU] is given an empty argument. David A. Holland parents: 121 diff changeset	89 does not accept a space between the
64c4de3709de Complain if -[DIU] is given an empty argument. David A. Holland parents: 121 diff changeset	90 .Dq I
64c4de3709de Complain if -[DIU] is given an empty argument. David A. Holland parents: 121 diff changeset	91 and the directory name.
110 b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	92 .It Fl nostdinc
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	93 Do not search the standard system include directories.
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	94 .It Fl P
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	95 Suppress line number information in the output.
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	96 Currently line number information is not generated at all and this
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	97 option has no effect.
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	98 .It Fl Umacro
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	99 Remove any existing defintion for the named macro.
122 64c4de3709de Complain if -[DIU] is given an empty argument. David A. Holland parents: 121 diff changeset	100 Note that like many Unix compilers,
64c4de3709de Complain if -[DIU] is given an empty argument. David A. Holland parents: 121 diff changeset	101 .Nm
64c4de3709de Complain if -[DIU] is given an empty argument. David A. Holland parents: 121 diff changeset	102 does not accept a space between the
64c4de3709de Complain if -[DIU] is given an empty argument. David A. Holland parents: 121 diff changeset	103 .Dq U
64c4de3709de Complain if -[DIU] is given an empty argument. David A. Holland parents: 121 diff changeset	104 and the macro name.
110 b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	105 .It Fl undef
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	106 Remove all predefined macros.
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	107 .El
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	108 .Ss Warning Options
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	109 Warning options can be disabled or enabled by inserting, or not, the
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	110 string
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	111 .Dq no-
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	112 between the
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	113 .Dq W
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	114 and the warning name.
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	115 Herein the
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	116 .Dq Fl Wno-
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	117 form is shown for options that are enabled by default.
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	118 .Bl -tag -width bubblebabble
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	119 .It Fl Wall
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	120 Turn on all warnings.
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	121 The option
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	122 .Fl Wno-all
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	123 disables only the warnings that are disabled by default.
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	124 .It Fl w
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	125 Turn off all warnings.
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	126 .It Fl Werror
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	127 Make warnings into fatal errors.
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	128 .It Fl Wcomment
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	129 Warn about nested comments.
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	130 .It Fl Wno-endif-labels
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	131 Don't warn about symbols attached to #endif directives.
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	132 (The warning is currently not implemented.)
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	133 .It Fl Wundef
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	134 Warn about undefined symbols appearing in #if and #elif expressions.
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	135 .It Fl Wunused-macros
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	136 Warn about macros that are defined and never used.
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	137 Not implemented.
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	138 .El
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	139 .Ss Depend Options
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	140 .Bl -tag -width bubblebabble
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	141 .It Fl M
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	142 Generate dependency information for
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	143 .Xr make 1
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	144 on the standard output, instead of preprocessing.
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	145 Not implemented.
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	146 .It Fl MD
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	147 Like
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	148 .Fl M
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	149 but skip system headers.
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	150 Not implemented.
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	151 .It Fl MM
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	152 Like
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	153 .Fl M
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	154 but write the dependency information to a file named after the input
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	155 file with extension
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	156 .Pa \.d
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	157 and preprocess normally to standard output.
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 .It Fl MMD
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	160 Like
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	161 .Fl MM
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	162 but skip system headers.
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	163 Not implemented.
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	164 .It Fl MG
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	165 When generating dependency information, assume that missing files are
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	166 generated instead of failing.
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	167 Not implemented.
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	168 .It Fl MP
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	169 Issue dummy rules for all include files.
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	170 This prevents
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	171 .Xr make 1
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	172 from choking if an include file is removed.
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 .El
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	175 .Ss Diagnostic Options
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	176 .Bl -tag -width bubblebabble
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	177 .It Fl dD
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	178 Dump all macro definitions, except for the predefined macros, after
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	179 the normal preprocessing output.
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	180 Not implemented.
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	181 .It Fl dI
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	182 Dump all include directives along with the normal preprocessing
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	183 output.
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	184 Not implemented.
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	185 .It Fl dM
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	186 Dump all macro definitions instead of the normal preprocessing
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	187 output.
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	188 Not implemented.
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	189 .It Fl dN
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	190 Like
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	191 .Fl dD
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	192 but emits only macro names and not the expansions.
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	193 Not implemented.
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	194 .It Fl H
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	195 Output a trace of the include tree as it gets processed.
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	196 Not implemented.
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	197 .El
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	198 .Ss Other Options
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	199 .Bl -tag -width bubblebabble
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	200 .It Fl CC
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	201 Retain comments in output.
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	202 Same as
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	203 .Fl C ,
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	204 accepted for compatibility with
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	205 .Xr gcc 1 .
121 103acee239e0 Man page fixes from wiz@. David A. Holland parents: 110 diff changeset	206 .It Fl fdollars-in-identifiers , Fl fno-dollars-in-identifiers
110 b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	207 Enable
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	208 .Pq or disable, respectively
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	209 the use of the dollar sign in identifiers.
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	210 Not implemented.
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	211 .It Fl ftabstop=num
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	212 Set the tab width to the specified value, for reporting column
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	213 positions in diagnostics.
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	214 The default is 8.
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	215 Not implemented.
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	216 .It Fl std=standard
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	217 Ask
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	218 .Nm
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	219 to conform to the named standard.
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	220 The default, and the only supported value, is
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	221 .Dq krc .
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	222 .It Fl traditional
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	223 This option is accepted for compatibility with
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	224 .Xr gcc 1
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	225 and ignored.
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	226 .El
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	227 .Sh FILES
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	228 The default list of directories searched for include files is:
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	229 .Bl -item -offset indent -compact
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	230 .It
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	231 .Pa /usr/local/include
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	232 .It
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	233 .Pa /usr/include
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	234 .El
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	235 .Sh SEE ALSO
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	236 .Xr cc 1 ,
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	237 .Xr cpp 1 ,
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	238 .Xr make 1
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	239 .Sh STANDARDS
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	240 None.
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	241 The whole point of a traditional cpp is that it reflects practices
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	242 in pre-standardization implementations of C.
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	243 Some information is available from the first edition of Kernighan and
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	244 Ritchie.
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	245 Much of the rest of the behavior is based on lore, pragmatism,
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	246 material encountered in the wild, and comparison to other
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	247 implementations.
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	248 .Sh HISTORY
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	249 The original version of
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	250 .Nm
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	251 was written one evening in late 2010.
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	252 This version had some problems and was put aside.
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	253 The first working version was released in June 2013.
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	254 .\" .Sh AUTHORS
121 103acee239e0 Man page fixes from wiz@. David A. Holland parents: 110 diff changeset	255 .\" .An David A. Holland
110 b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	256 .Sh BUGS
b2f2f30194b8 Add a man page. David A. Holland parents: diff changeset	257 Probably plenty.

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

annotate tradcpp.1 @ 122:64c4de3709de