« back to all changes in this revision
Viewing changes to doc/indent.html
- browse files at revision 1
- compare with another revision
- download diff
- download tarball
- view history from revision 1
- Committer: Bazaar Package Importer
- Author(s): Santiago Vila
- Date: 2002-01-27 18:47:28 UTC
- Revision ID: james.westby@ubuntu.com-20020127184728-5w6lnpj072bqil91
Tags: upstream-2.2.7
Import upstream version 2.2.7
- files added:
- aclocal
- config
- doc
- intl
- man
- miscel
- po
- src
added
removed
doc/indent.html
1
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2
<HTML>
3
<!-- Created on December, 18 2001 by texi2html 1.65 -->
4
<!--
5
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
6
Karl Berry <karl@freefriends.org>
7
Olaf Bachmann <obachman@mathematik.uni-kl.de>
8
and many others.
9
Maintained by: Olaf Bachmann <obachman@mathematik.uni-kl.de>
10
Send bugs and suggestions to <texi2html@mathematik.uni-kl.de>
11
12
-->
13
<HEAD>
14
<TITLE><CODE>indent</CODE>: Indent and Format C Program Source: </TITLE>
15
16
<META NAME="description" CONTENT="<CODE>indent</CODE>: Indent and Format C Program Source: ">
17
<META NAME="keywords" CONTENT="<CODE>indent</CODE>: Indent and Format C Program Source: ">
18
<META NAME="resource-type" CONTENT="document">
19
<META NAME="distribution" CONTENT="global">
20
<META NAME="Generator" CONTENT="texi2html 1.65">
21
22
</HEAD>
23
24
<BODY LANG="en" BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#800080" ALINK="#FF0000">
25
26
<A NAME="SEC_Top"></A>
27
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
28
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC_Top">Top</A>]</TD>
29
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC_Contents">Contents</A>]</TD>
30
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC19">Index</A>]</TD>
31
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC_About"> ? </A>]</TD>
32
</TR></TABLE>
33
<H1><CODE>indent</CODE>: Indent and Format C Program Source</H1></P><P>
34
35
The <CODE>indent</CODE> program
36
changes the appearance of a C program by inserting or deleting whitespace.
37
</P><P>
38
39
This is Edition 2.2.7, 20 November 2001, of <CITE>The <CODE>indent</CODE> Manual</CITE>,
40
for Indent Version 2.2.7.
41
</P><P>
42
43
<BLOCKQUOTE><TABLE BORDER=0 CELLSPACING=0>
44
<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="indent.html#SEC1">1. The <CODE>indent</CODE> Program</A></TD><TD> </TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
45
<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="indent.html#SEC17">A. Option Summary</A></TD><TD> </TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
46
<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="indent.html#SEC19">Index</A></TD><TD> </TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
47
</TABLE></BLOCKQUOTE>
48
<P>
49
50
<HR SIZE=1>
51
<A NAME="SEC1"></A>
52
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
53
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC_Top"> < </A>]</TD>
54
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC2"> > </A>]</TD>
55
<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC_Top"> << </A>]</TD>
56
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC_Top"> Up </A>]</TD>
57
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC17"> >> </A>]</TD>
58
<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC_Top">Top</A>]</TD>
59
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC_Contents">Contents</A>]</TD>
60
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC19">Index</A>]</TD>
61
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC_About"> ? </A>]</TD>
62
</TR></TABLE>
63
<A NAME="Indent Program"></A>
64
<H1> 1. The <CODE>indent</CODE> Program </H1>
65
<!--docid::SEC1::-->
66
<P>
67
68
The <CODE>indent</CODE> program
69
can be used to make code easier to read. It can also convert from one
70
style of writing C to another.
71
</P><P>
72
73
<CODE>indent</CODE> understands a substantial amount about the syntax of C,
74
but it also attempts to cope with incomplete and misformed syntax.
75
</P><P>
76
77
In version 1.2 and more recent versions, the GNU style of indenting is
78
the default.
79
</P><P>
80
81
<BLOCKQUOTE><TABLE BORDER=0 CELLSPACING=0>
82
<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="indent.html#SEC2">1.1 Invoking <CODE>indent</CODE></A></TD><TD> </TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
83
<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="indent.html#SEC3">1.2 Backup Files</A></TD><TD> </TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
84
<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="indent.html#SEC4">1.3 Common styles</A></TD><TD> </TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
85
<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="indent.html#SEC5">1.4 Blank lines</A></TD><TD> </TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
86
<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="indent.html#SEC8">1.5 Comments</A></TD><TD> </TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
87
<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="indent.html#SEC9">1.6 Statements</A></TD><TD> </TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
88
<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="indent.html#SEC10">1.7 Declarations</A></TD><TD> </TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
89
<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="indent.html#SEC11">1.8 Indentation</A></TD><TD> </TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
90
<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="indent.html#SEC12">1.9 Breaking long lines</A></TD><TD> </TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
91
<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="indent.html#SEC13">1.10 Disabling Formatting</A></TD><TD> </TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
92
<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="indent.html#SEC14">1.11 Miscellaneous options</A></TD><TD> </TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
93
<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="indent.html#SEC15">1.12 Bugs</A></TD><TD> </TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
94
<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="indent.html#SEC16">1.13 Copyright</A></TD><TD> </TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
95
</TABLE></BLOCKQUOTE>
96
<P>
97
98
<A NAME="Invoking indent"></A>
99
<HR SIZE="6">
100
<A NAME="SEC2"></A>
101
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
102
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC1"> < </A>]</TD>
103
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC3"> > </A>]</TD>
104
<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC1"> << </A>]</TD>
105
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC1"> Up </A>]</TD>
106
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC17"> >> </A>]</TD>
107
<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC_Top">Top</A>]</TD>
108
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC_Contents">Contents</A>]</TD>
109
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC19">Index</A>]</TD>
110
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC_About"> ? </A>]</TD>
111
</TR></TABLE>
112
<H2> 1.1 Invoking <CODE>indent</CODE> </H2>
113
<!--docid::SEC2::-->
114
<P>
115
116
As of version 1.3, the format of the <CODE>indent</CODE> command is:
117
</P><P>
118
119
<TABLE><tr><td> </td><td class=example><pre>
120
indent [<VAR>options</VAR>] [<VAR>input-files</VAR>]
121
122
indent [<VAR>options</VAR>] [<VAR>single-input-file</VAR>] [-o <VAR>output-file</VAR>]
123
124
</pre></td></tr></table></P><P>
125
126
This format is different from earlier versions and other versions of
127
<CODE>indent</CODE>.
128
</P><P>
129
130
In the first form, one or more input files are specified. <CODE>indent</CODE>
131
makes a backup copy of each file, and the original file is replaced with
132
its indented version. See section <A HREF="indent.html#SEC3">1.2 Backup Files</A>, for an explanation of how
133
backups are made.
134
</P><P>
135
136
<A NAME="IDX1"></A>
137
<A NAME="IDX2"></A>
138
<A NAME="IDX3"></A>
139
In the second form, only one input file is specified. In this case, or
140
when the standard input is used, you may specify an output file after
141
the `<SAMP>-o</SAMP>' option.
142
</P><P>
143
144
<A NAME="IDX4"></A>
145
<A NAME="IDX5"></A>
146
<A NAME="IDX6"></A>
147
To cause <CODE>indent</CODE> to write to standard output, use the `<SAMP>-st</SAMP>'
148
option. This is only allowed when there is only one input file, or when
149
the standard input is used.
150
</P><P>
151
152
<A NAME="IDX7"></A>
153
If no input files are named, the standard input is read for input.
154
Also, if a filename named `<SAMP>-</SAMP>' is specified, then the standard input
155
is read.
156
</P><P>
157
158
As an example, each of the following commands will input the program
159
`<TT>slithy_toves.c</TT>' and write its indented text to
160
`<TT>slithy_toves.out</TT>':
161
</P><P>
162
163
<TABLE><tr><td> </td><td class=example><pre>
164
indent slithy_toves.c -o slithy_toves.out
165
166
indent -st slithy_toves.c > slithy_toves.out
167
168
cat slithy_toves.c | indent -o slithy_toves.out
169
170
</pre></td></tr></table></P><P>
171
172
<A NAME="IDX8"></A>
173
Most other options to <CODE>indent</CODE> control how programs are formatted.
174
As of version 1.2, <CODE>indent</CODE> also recognizes a long name for each
175
option name. Long options are prefixed by either `<SAMP>--</SAMP>' or
176
`<SAMP>+</SAMP>'.
177
<A NAME="DOCF1" HREF="indent.html#FOOT1">(1)</A>
178
In most of this document,
179
the traditional, short names are used for the sake of brevity.
180
See section <A HREF="indent.html#SEC17">A. Option Summary</A>, for a list of options, including both long and
181
short names.
182
</P><P>
183
184
Here is another example:
185
</P><P>
186
187
<TABLE><tr><td> </td><td class=example><pre>indent -br test/metabolism.c -l85
188
</pre></td></tr></table></P><P>
189
190
This will indent the program `<TT>test/metabolism.c</TT>' using the
191
`<SAMP>-br</SAMP>' and `<SAMP>-l85</SAMP>' options, write the output back to
192
`<TT>test/metabolism.c</TT>', and write the original contents of
193
`<TT>test/metabolism.c</TT>' to a backup file in the directory `<TT>test</TT>'.
194
</P><P>
195
196
Equivalent invocations using long option names for this example would
197
be:
198
</P><P>
199
200
<TABLE><tr><td> </td><td class=example><pre>
201
indent --braces-on-if-line --line-length185 test/metabolism.c
202
203
indent +braces-on-if-line +line-length185 test/metabolism.c
204
205
</pre></td></tr></table></P><P>
206
207
<A NAME="IDX9"></A>
208
<A NAME="IDX10"></A>
209
<A NAME="IDX11"></A>
210
<A NAME="IDX12"></A>
211
If you find that you often use <CODE>indent</CODE> with the same options, you
212
may put those options into a file named `<TT>.indent.pro</TT>'.
213
<CODE>indent</CODE> will first look for `<TT>.indent.pro</TT>' in the current
214
directory and use that if found. Otherwise, <CODE>indent</CODE> will search
215
your home directory for `<TT>.indent.pro</TT>' and use that file if it is
216
found. This behaviour is different from that of other versions of
217
<CODE>indent</CODE>, which load both files if they both exist.
218
</P><P>
219
220
The format of `<TT>.indent.pro</TT>' is simply a list of options, just as
221
they would appear on the command line, separated by white space (tabs,
222
spaces, and newlines). Options in `<TT>.indent.pro</TT>' may be surrounded by C
223
or C++ comments, in which case they are ignored.
224
</P><P>
225
226
Command line switches are handled <EM>after</EM> processing
227
`<TT>.indent.pro</TT>'. Options specified later override arguments
228
specified earlier, with one exception: Explicitly specified options
229
always override background options (see section <A HREF="indent.html#SEC4">1.3 Common styles</A>). You can
230
prevent <CODE>indent</CODE> from reading an `<TT>.indent.pro</TT>' file by
231
specifying the `<SAMP>-npro</SAMP>' option.</P><P>
232
233
<A NAME="Backup files"></A>
234
<HR SIZE="6">
235
<A NAME="SEC3"></A>
236
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
237
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC2"> < </A>]</TD>
238
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC4"> > </A>]</TD>
239
<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC1"> << </A>]</TD>
240
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC1"> Up </A>]</TD>
241
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC17"> >> </A>]</TD>
242
<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC_Top">Top</A>]</TD>
243
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC_Contents">Contents</A>]</TD>
244
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC19">Index</A>]</TD>
245
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC_About"> ? </A>]</TD>
246
</TR></TABLE>
247
<H2> 1.2 Backup Files </H2>
248
<!--docid::SEC3::-->
249
<P>
250
251
<A NAME="IDX13"></A>
252
As of version 1.3, GNU <CODE>indent</CODE> makes GNU-style backup files, the
253
same way GNU Emacs does. This means that either <EM>simple</EM> or
254
<EM>numbered</EM> backup filenames may be made.
255
</P><P>
256
257
Simple backup file names are generated by appending a suffix to the
258
original file name. The default for this suffix is the
259
one-character string `<TT>~</TT>' (tilde). Thus, the backup file for
260
`<TT>python.c</TT>' would be `<TT>python.c~</TT>'.
261
</P><P>
262
263
Instead of the default, you may specify any string as a suffix by
264
setting the environment variable <CODE>SIMPLE_BACKUP_SUFFIX</CODE> to
265
your preferred suffix.
266
</P><P>
267
268
Numbered backup versions of a file `<TT>momeraths.c</TT>' look like
269
`<TT>momeraths.c.~23~</TT>', where 23 is the version of this particular
270
backup. When making a numbered backup of the file `<TT>src/momeraths.c</TT>',
271
the backup file will be named `<TT>src/momeraths.c.~<VAR>V</VAR>~</TT>', where
272
<VAR>V</VAR> is one greater than the highest version currently existing in
273
the directory `<TT>src</TT>'. The environment variable <CODE>VERSION_WIDTH</CODE>
274
controls the number of digits, using left zero padding when necessary.
275
For instance, setting this variable to "2" will lead to the backup
276
file being named `<TT>momeraths.c.~04~</TT>'.
277
</P><P>
278
279
The type of backup file made is controlled by the value of the
280
environment variable <CODE>VERSION_CONTROL</CODE>. If it is the string
281
`<SAMP>simple</SAMP>', then only simple backups will be made. If its value is
282
the string `<SAMP>numbered</SAMP>', then numbered backups will be made. If its
283
value is `<SAMP>numbered-existing</SAMP>', then numbered backups will be made if
284
there <EM>already exist</EM> numbered backups for the file being indented;
285
otherwise, a simple backup is made. If <CODE>VERSION_CONTROL</CODE> is not
286
set, then <CODE>indent</CODE> assumes the behaviour of
287
`<SAMP>numbered-existing</SAMP>'.
288
</P><P>
289
290
Other versions of <CODE>indent</CODE> use the suffix `<TT>.BAK</TT>' in naming
291
backup files. This behaviour can be emulated by setting
292
<CODE>SIMPLE_BACKUP_SUFFIX</CODE> to `<SAMP>.BAK</SAMP>'.
293
</P><P>
294
295
Note also that other versions of <CODE>indent</CODE> make backups in the
296
current directory, rather than in the directory of the source file as
297
GNU <CODE>indent</CODE> now does.
298
</P><P>
299
300
<A NAME="Common styles"></A>
301
<HR SIZE="6">
302
<A NAME="SEC4"></A>
303
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
304
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC3"> < </A>]</TD>
305
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC5"> > </A>]</TD>
306
<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC1"> << </A>]</TD>
307
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC1"> Up </A>]</TD>
308
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC17"> >> </A>]</TD>
309
<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC_Top">Top</A>]</TD>
310
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC_Contents">Contents</A>]</TD>
311
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC19">Index</A>]</TD>
312
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC_About"> ? </A>]</TD>
313
</TR></TABLE>
314
<H2> 1.3 Common styles </H2>
315
<!--docid::SEC4::-->
316
<P>
317
318
There are several common styles of C code, including the GNU style, the
319
Kernighan & Ritchie style, and the original Berkeley style. A style may
320
be selected with a single <EM>background</EM> option, which specifies a set
321
of values for all other options. However, explicitly specified options
322
always override options implied by a background option.
323
</P><P>
324
325
<A NAME="IDX14"></A>
326
<A NAME="IDX15"></A>
327
<A NAME="IDX16"></A>
328
As of version 1.2, the default style of GNU <CODE>indent</CODE> is the GNU
329
style. Thus, it is no longer necessary to specify the option
330
`<SAMP>-gnu</SAMP>' to obtain this format, although doing so will not cause an
331
error. Option settings which correspond to the GNU style are:
332
</P><P>
333
334
<TABLE><tr><td> </td><td class=example><pre>-nbad -bap -nbc -bbo -bl -bli2 -bls -ncdb -nce -cp1 -cs -di2
335
-ndj -nfc1 -nfca -hnl -i2 -ip5 -lp -pcs -nprs -psl -saf -sai
336
-saw -nsc -nsob
337
</pre></td></tr></table></P><P>
338
339
The GNU coding style is that preferred by the GNU project. It is the
340
style that the GNU Emacs C mode encourages and which is used in the C
341
portions of GNU Emacs. (People interested in writing programs for
342
Project GNU should get a copy of <CITE>The GNU Coding Standards</CITE>, which
343
also covers semantic and portability issues such as memory usage, the
344
size of integers, etc.)
345
</P><P>
346
347
<A NAME="IDX17"></A>
348
<A NAME="IDX18"></A>
349
<A NAME="IDX19"></A>
350
The Kernighan & Ritchie style is used throughout their well-known book
351
<CITE>The C Programming Language</CITE>. It is enabled with the `<SAMP>-kr</SAMP>'
352
option. The Kernighan & Ritchie style corresponds to the following set
353
of options:
354
</P><P>
355
356
<TABLE><tr><td> </td><td class=example><pre>-nbad -bap -bbo -nbc -br -brs -c33 -cd33 -ncdb -ce -ci4 -cli0
357
-cp33 -cs -d0 -di1 -nfc1 -nfca -hnl -i4 -ip0 -l75 -lp -npcs
358
-nprs -npsl -saf -sai -saw -nsc -nsob -nss
359
</pre></td></tr></table></P><P>
360
361
Kernighan & Ritchie style does not put comments to the right of code in
362
the same column at all times (nor does it use only one space to the
363
right of the code), so for this style <CODE>indent</CODE> has arbitrarily
364
chosen column 33.
365
</P><P>
366
367
<A NAME="IDX20"></A>
368
<A NAME="IDX21"></A>
369
<A NAME="IDX22"></A>
370
<A NAME="IDX23"></A>
371
The style of the original Berkeley <CODE>indent</CODE> may be obtained by
372
specifying `<SAMP>-orig</SAMP>' (or by specifying `<SAMP>--original</SAMP>', using the
373
long option name). This style is equivalent to the following settings:
374
</P><P>
375
376
<TABLE><tr><td> </td><td class=example><pre>-nbad -nbap -bbo -bc -br -brs -c33 -cd33 -cdb -ce -ci4 -cli0
377
-cp33 -di16 -fc1 -fca -hnl -i4 -ip4 -l75 -lp -npcs -nprs -psl
378
-saf -sai -saw -sc -nsob -nss -ts8
379
</pre></td></tr></table></P><P>
380
381
<A NAME="Blank lines"></A>
382
<HR SIZE="6">
383
<A NAME="SEC5"></A>
384
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
385
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC4"> < </A>]</TD>
386
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC6"> > </A>]</TD>
387
<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC1"> << </A>]</TD>
388
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC1"> Up </A>]</TD>
389
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC8"> >> </A>]</TD>
390
<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC_Top">Top</A>]</TD>
391
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC_Contents">Contents</A>]</TD>
392
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC19">Index</A>]</TD>
393
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC_About"> ? </A>]</TD>
394
</TR></TABLE>
395
<H2> 1.4 Blank lines </H2>
396
<!--docid::SEC5::-->
397
<P>
398
399
Various programming styles use blank lines in different places.
400
<CODE>indent</CODE> has a number of options to insert or delete blank lines in
401
specific places.
402
</P><P>
403
404
The `<SAMP>-bad</SAMP>' option causes <CODE>indent</CODE> to force a blank line after
405
every block of declarations. The `<SAMP>-nbad</SAMP>' option causes
406
<CODE>indent</CODE> not to force such blank lines.
407
</P><P>
408
409
The `<SAMP>-bap</SAMP>' option forces a blank line after every procedure body.
410
The `<SAMP>-nbap</SAMP>' option forces no such blank line.
411
</P><P>
412
413
<A NAME="IDX24"></A>
414
<A NAME="IDX25"></A>
415
<A NAME="IDX26"></A>
416
<A NAME="IDX27"></A>
417
The `<SAMP>-bbb</SAMP>' option forces a blank line before every boxed comment
418
(See section <A HREF="indent.html#SEC8">1.5 Comments</A>.)
419
The `<SAMP>-nbbb</SAMP>' option does not force such blank lines.
420
</P><P>
421
422
<A NAME="IDX28"></A>
423
<A NAME="IDX29"></A>
424
<A NAME="IDX30"></A>
425
<A NAME="IDX31"></A>
426
The `<SAMP>-sob</SAMP>' option causes <CODE>indent</CODE> to swallow optional blank
427
lines (that is, any optional blank lines present in the input will be
428
removed from the output). If the `<SAMP>-nsob</SAMP>' is specified, any blank
429
lines present in the input file will be copied to the output file.
430
</P><P>
431
432
<BLOCKQUOTE><TABLE BORDER=0 CELLSPACING=0>
433
<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="indent.html#SEC6">1.4.1 --blank-lines-after-declarations</A></TD><TD> </TD><TD ALIGN="left" VALIGN="TOP">More on the `<SAMP>-bad</SAMP>' option.</TD></TR>
434
<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="indent.html#SEC7">1.4.2 --blank-lines-after-procedures</A></TD><TD> </TD><TD ALIGN="left" VALIGN="TOP">More on the `<SAMP>-bap</SAMP>' option.</TD></TR>
435
</TABLE></BLOCKQUOTE>
436
<P>
437
438
<A NAME="-bad"></A>
439
<HR SIZE="6">
440
<A NAME="SEC6"></A>
441
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
442
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC5"> < </A>]</TD>
443
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC7"> > </A>]</TD>
444
<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC4"> << </A>]</TD>
445
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC5"> Up </A>]</TD>
446
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC8"> >> </A>]</TD>
447
<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC_Top">Top</A>]</TD>
448
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC_Contents">Contents</A>]</TD>
449
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC19">Index</A>]</TD>
450
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC_About"> ? </A>]</TD>
451
</TR></TABLE>
452
<H3> 1.4.1 --blank-lines-after-declarations </H3>
453
<!--docid::SEC6::-->
454
<P>
455
456
The `<SAMP>-bad</SAMP>' option forces a blank line after every block of
457
declarations. The `<SAMP>-nbad</SAMP>' option does not add any such blank
458
lines.
459
</P><P>
460
461
For example, given the input
462
<TABLE><tr><td> </td><td class=example><pre>char *foo;
463
char *bar;
464
/* This separates blocks of declarations. */
465
int baz;
466
</pre></td></tr></table></P><P>
467
468
<A NAME="IDX32"></A>
469
<A NAME="IDX33"></A>
470
<A NAME="IDX34"></A>
471
<A NAME="IDX35"></A>
472
<CODE>indent -bad</CODE> produces
473
</P><P>
474
475
<TABLE><tr><td> </td><td class=example><pre>char *foo;
476
char *bar;
477
478
/* This separates blocks of declarations. */
479
int baz;
480
</pre></td></tr></table></P><P>
481
482
and <CODE>indent -nbad</CODE> produces
483
</P><P>
484
485
<TABLE><tr><td> </td><td class=example><pre>char *foo;
486
char *bar;
487
/* This separates blocks of declarations. */
488
int baz;
489
</pre></td></tr></table></P><P>
490
491
<A NAME="-bap"></A>
492
<HR SIZE="6">
493
<A NAME="SEC7"></A>
494
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
495
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC6"> < </A>]</TD>
496
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC8"> > </A>]</TD>
497
<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC4"> << </A>]</TD>
498
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC5"> Up </A>]</TD>
499
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC8"> >> </A>]</TD>
500
<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC_Top">Top</A>]</TD>
501
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC_Contents">Contents</A>]</TD>
502
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC19">Index</A>]</TD>
503
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC_About"> ? </A>]</TD>
504
</TR></TABLE>
505
<H3> 1.4.2 --blank-lines-after-procedures </H3>
506
<!--docid::SEC7::-->
507
<P>
508
509
<A NAME="IDX36"></A>
510
<A NAME="IDX37"></A>
511
<A NAME="IDX38"></A>
512
<A NAME="IDX39"></A>
513
The `<SAMP>-bap</SAMP>' option forces a blank line after every procedure body.
514
</P><P>
515
516
For example, given the input
517
</P><P>
518
519
<TABLE><tr><td> </td><td class=example><pre>int
520
foo ()
521
{
522
puts("Hi");
523
}
524
/* The procedure bar is even less interesting. */
525
char *
526
bar ()
527
{
528
puts("Hello");
529
}
530
</pre></td></tr></table></P><P>
531
532
<CODE>indent -bap</CODE> produces
533
</P><P>
534
535
<TABLE><tr><td> </td><td class=example><pre>int
536
foo ()
537
{
538
puts ("Hi");
539
}
540
541
/* The procedure bar is even less interesting. */
542
char *
543
bar ()
544
{
545
puts ("Hello");
546
}
547
</pre></td></tr></table></P><P>
548
549
and <CODE>indent -nbap</CODE> produces
550
</P><P>
551
552
<TABLE><tr><td> </td><td class=example><pre>int
553
foo ()
554
{
555
puts ("Hi");
556
}
557
/* The procedure bar is even less interesting. */
558
char *
559
bar ()
560
{
561
puts ("Hello");
562
}
563
</pre></td></tr></table></P><P>
564
565
No blank line will be added after the procedure <CODE>foo</CODE>.
566
</P><P>
567
568
<A NAME="Comments"></A>
569
<HR SIZE="6">
570
<A NAME="SEC8"></A>
571
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
572
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC7"> < </A>]</TD>
573
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC9"> > </A>]</TD>
574
<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC5"> << </A>]</TD>
575
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC1"> Up </A>]</TD>
576
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC17"> >> </A>]</TD>
577
<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC_Top">Top</A>]</TD>
578
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC_Contents">Contents</A>]</TD>
579
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC19">Index</A>]</TD>
580
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC_About"> ? </A>]</TD>
581
</TR></TABLE>
582
<H2> 1.5 Comments </H2>
583
<!--docid::SEC8::-->
584
<P>
585
586
<CODE>indent</CODE> formats both C and C++ comments. C comments are begun with
587
`<SAMP>/*</SAMP>', terminated with `<SAMP>*/</SAMP>' and may contain newline characters.
588
C++ comments begin with the delimiter `<SAMP>//</SAMP>' and end at the newline.
589
</P><P>
590
591
<CODE>indent</CODE> handles comments differently depending upon their context.
592
<CODE>indent</CODE> attempts to distinguish between comments which follow
593
statements, comments which follow declarations, comments following
594
preprocessor directives, and comments which are not preceded by code of
595
any sort, i.e., they begin the text of the line (although not
596
neccessarily in column 1).
597
</P><P>
598
599
<CODE>indent</CODE> further distinguishes between comments found outside of
600
procedures and aggregates, and those found within them. In particular,
601
comments beginning a line found within a procedure will be indented to
602
the column at which code is currently indented. The exception to this a
603
comment beginning in the leftmost column; such a comment is output
604
at that column.
605
</P><P>
606
607
<CODE>indent</CODE> attempts to leave <EM>boxed comments</EM> unmodified. The
608
general idea of such a comment is that it is enclosed in a rectangle or
609
"box" of stars or dashes to visually set it apart. More precisely,
610
boxed comments are defined as those in which the initial `<SAMP>/*</SAMP>' is
611
followed immediately by the character `<SAMP>*</SAMP>', `<SAMP>=</SAMP>', `<SAMP>_</SAMP>', or
612
`<SAMP>-</SAMP>', or those in which the beginning comment delimiter (`<SAMP>/*</SAMP>')
613
is on a line by itself, and the following line begins with a `<SAMP>*</SAMP>' in
614
the same column as the star of the opening delimiter.
615
</P><P>
616
617
Examples of boxed comments are:
618
</P><P>
619
620
<TABLE><tr><td> </td><td class=example><pre>/**********************
621
* Comment in a box!! *
622
**********************/
623
624
/*
625
* A different kind of scent,
626
* for a different kind of comment.
627
*/
628
</pre></td></tr></table></P><P>
629
630
<CODE>indent</CODE> attempts to leave boxed comments exactly as they are found
631
in the source file. Thus the indentation of the comment is unchanged,
632
and its length is not checked in any way. The only alteration made is
633
that an embedded tab character may be converted into the appropriate
634
number of spaces.
635
</P><P>
636
637
If the `<SAMP>-bbb</SAMP>' option is specified, all such boxed comments will be
638
preceded by a blank line, unless such a comment is preceded by code.
639
</P><P>
640
641
<A NAME="IDX40"></A>
642
<A NAME="IDX41"></A>
643
<A NAME="IDX42"></A>
644
<A NAME="IDX43"></A>
645
<A NAME="IDX44"></A>
646
<A NAME="IDX45"></A>
647
<A NAME="IDX46"></A>
648
<A NAME="IDX47"></A>
649
Comments which are not boxed comments may be formatted, which means that
650
the line is broken to fit within a right margin and left-filled with
651
whitespace. Single newlines are equivalent to a space, but blank lines
652
(two or more newlines in a row) are taken to mean a paragraph break.
653
Formatting of comments which begin after the first column is enabled
654
with the `<SAMP>-fca</SAMP>' option. To format those beginning in column one,
655
specify `<SAMP>-fc1</SAMP>'. Such formatting is disabled by default.
656
</P><P>
657
658
The right margin for formatting defaults to 78, but may be changed with
659
the `<SAMP>-lc</SAMP>' option. If the margin specified does not allow the
660
comment to be printed, the margin will be automatically extended for the
661
duration of that comment. The margin is not respected if the comment is
662
not being formatted.
663
</P><P>
664
665
<A NAME="IDX48"></A>
666
<A NAME="IDX49"></A>
667
If the comment begins a line (i.e., there is no program text to its
668
left), it will be indented to the column it was found in unless the
669
comment is within a block of code. In that case, such a comment will be
670
aligned with the indented code of that block (unless the comment began
671
in the first column). This alignment may be affected by the `<SAMP>-d</SAMP>'
672
option, which specifies an amount by which such comments are moved to
673
the <EM>left</EM>, or unindented. For example, `<SAMP>-d2</SAMP>' places comments
674
two spaces to the left of code. By default, comments are aligned with
675
code, unless they begin in the first column, in which case they are left
676
there by default -- to get them aligned with the code, specify `<SAMP>-fc1</SAMP>'.
677
</P><P>
678
679
<A NAME="IDX50"></A>
680
<A NAME="IDX51"></A>
681
<A NAME="IDX52"></A>
682
<A NAME="IDX53"></A>
683
<A NAME="IDX54"></A>
684
<A NAME="IDX55"></A>
685
Comments to the right of code will appear by default in column 33.
686
This may be changed with one of three options. `<SAMP>-c</SAMP>' will specify
687
the column for comments following code, `<SAMP>-cd</SAMP>' specifies the
688
column for comments following declarations, and `<SAMP>-cp</SAMP>' specifies
689
the column for comments following preprocessor directives <CODE>#else</CODE>
690
and <CODE>#endif</CODE>.
691
</P><P>
692
693
If the code to the left of the comment exceeds the beginning column,
694
the comment column will be extended to the next tabstop column past
695
the end of the code, or in the case of preprocessor directives, to one
696
space past the end of the directive. This extension lasts only for
697
the output of that particular comment.
698
</P><P>
699
700
<A NAME="IDX56"></A>
701
<A NAME="IDX57"></A>
702
<A NAME="IDX58"></A>
703
<A NAME="IDX59"></A>
704
The `<SAMP>-cdb</SAMP>' option places the comment delimiters on blank lines.
705
Thus, a single line comment like <CODE>/* Loving hug */</CODE> can be
706
transformed into:
707
</P><P>
708
709
<TABLE><tr><td> </td><td class=example><pre>/*
710
Loving hug
711
*/
712
</pre></td></tr></table></P><P>
713
714
<A NAME="IDX60"></A>
715
<A NAME="IDX61"></A>
716
<A NAME="IDX62"></A>
717
<A NAME="IDX63"></A>
718
Stars can be placed at the beginning of multi-line comments with the
719
`<SAMP>-sc</SAMP>' option. Thus, the single-line comment above can be
720
transformed (with `<SAMP>-cdb -sc</SAMP>') into:
721
</P><P>
722
723
<TABLE><tr><td> </td><td class=example><pre>/*
724
* Loving hug
725
*/
726
</pre></td></tr></table></P><P>
727
728
<A NAME="Statements"></A>
729
<HR SIZE="6">
730
<A NAME="SEC9"></A>
731
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
732
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC8"> < </A>]</TD>
733
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC10"> > </A>]</TD>
734
<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC1"> << </A>]</TD>
735
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC1"> Up </A>]</TD>
736
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC17"> >> </A>]</TD>
737
<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC_Top">Top</A>]</TD>
738
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC_Contents">Contents</A>]</TD>
739
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC19">Index</A>]</TD>
740
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC_About"> ? </A>]</TD>
741
</TR></TABLE>
742
<H2> 1.6 Statements </H2>
743
<!--docid::SEC9::-->
744
<P>
745
746
<A NAME="IDX64"></A>
747
<A NAME="IDX65"></A>
748
<A NAME="IDX66"></A>
749
<A NAME="IDX67"></A>
750
The `<SAMP>-br</SAMP>' or `<SAMP>-bl</SAMP>' option specifies how to format braces.
751
</P><P>
752
753
The `<SAMP>-br</SAMP>' option formats statement braces like this:
754
</P><P>
755
756
<TABLE><tr><td> </td><td class=example><pre>if (x > 0) {
757
x--;
758
}
759
</pre></td></tr></table></P><P>
760
761
The `<SAMP>-bl</SAMP>' option formats them like this:
762
</P><P>
763
764
<TABLE><tr><td> </td><td class=example><pre>if (x > 0)
765
{
766
x--;
767
}
768
</pre></td></tr></table></P><P>
769
770
<A NAME="IDX68"></A>
771
<A NAME="IDX69"></A>
772
If you use the `<SAMP>-bl</SAMP>' option, you may also want to specify the
773
`<SAMP>-bli</SAMP>' option. This option specifies the number of spaces by
774
which braces are indented. `<SAMP>-bli2</SAMP>', the default, gives the
775
result shown above. `<SAMP>-bli0</SAMP>' results in the following:
776
</P><P>
777
778
<TABLE><tr><td> </td><td class=example><pre>if (x > 0)
779
{
780
x--;
781
}
782
</pre></td></tr></table></P><P>
783
784
<A NAME="IDX70"></A>
785
<A NAME="IDX71"></A>
786
<A NAME="IDX72"></A>
787
<A NAME="IDX73"></A>
788
If you are using the `<SAMP>-br</SAMP>' option, you probably want to also use
789
the `<SAMP>-ce</SAMP>' option. This causes the <CODE>else</CODE> in an if-then-else
790
construct to cuddle up to the immediately preceding `<SAMP>}</SAMP>'. For
791
example, with `<SAMP>-br -ce</SAMP>' you get the following:
792
</P><P>
793
794
<TABLE><tr><td> </td><td class=example><pre>if (x > 0) {
795
x--;
796
} else {
797
fprintf (stderr, "...something wrong?\n");
798
}
799
</pre></td></tr></table></P><P>
800
801
With `<SAMP>-br -nce</SAMP>' that code would appear as
802
</P><P>
803
804
<TABLE><tr><td> </td><td class=example><pre>if (x > 0) {
805
x--;
806
}
807
else {
808
fprintf (stderr, "...something wrong?\n");
809
}
810
</pre></td></tr></table></P><P>
811
812
<A NAME="IDX74"></A>
813
<A NAME="IDX75"></A>
814
<A NAME="IDX76"></A>
815
<A NAME="IDX77"></A>
816
This causes the <CODE>while</CODE> in a do-while
817
loop to cuddle up to the immediately preceding `<SAMP>}</SAMP>'. For
818
example, with `<SAMP>-cdw</SAMP>' you get the following:
819
</P><P>
820
821
<TABLE><tr><td> </td><td class=example><pre>do {
822
x--;
823
} while (x);
824
</pre></td></tr></table></P><P>
825
826
With `<SAMP>-ncdw</SAMP>' that code would appear as
827
</P><P>
828
829
<TABLE><tr><td> </td><td class=example><pre>do {
830
x--;
831
}
832
while (x);
833
</pre></td></tr></table></P><P>
834
835
<A NAME="IDX78"></A>
836
<A NAME="IDX79"></A>
837
The `<SAMP>-cli</SAMP>' option specifies the number of spaces that case labels
838
should be indented to the right of the containing <CODE>switch</CODE>
839
statement.
840
</P><P>
841
842
The default gives code like:
843
</P><P>
844
845
<TABLE><tr><td> </td><td class=example><pre>switch (i)
846
{
847
case 0:
848
break;
849
case 1:
850
{
851
++i;
852
}
853
default:
854
break;
855
}
856
</pre></td></tr></table></P><P>
857
858
Using the `<SAMP>-cli2</SAMP>' that would become:
859
</P><P>
860
861
<TABLE><tr><td> </td><td class=example><pre>switch (i)
862
{
863
case 0:
864
break;
865
case 1:
866
{
867
++i;
868
}
869
default:
870
break;
871
}
872
</pre></td></tr></table></P><P>
873
874
<A NAME="IDX80"></A>
875
<A NAME="IDX81"></A>
876
The indentation of the braces below a case statement can be
877
controlled with the `<SAMP>-cbi<VAR>n</VAR></SAMP>' option. For example,
878
using `<SAMP>-cli2 -cbi0</SAMP>' results in:
879
</P><P>
880
881
<TABLE><tr><td> </td><td class=example><pre>switch (i)
882
{
883
case 0:
884
break;
885
case 1:
886
{
887
++i;
888
}
889
default:
890
break;
891
}
892
</pre></td></tr></table></P><P>
893
894
<A NAME="IDX82"></A>
895
<A NAME="IDX83"></A>
896
<A NAME="IDX84"></A>
897
<A NAME="IDX85"></A>
898
If a semicolon is on the same line as a <CODE>for</CODE> or <CODE>while</CODE>
899
statement, the `<SAMP>-ss</SAMP>' option will cause a space to be placed before
900
the semicolon. This emphasizes the semicolon, making it clear that the
901
body of the <CODE>for</CODE> or <CODE>while</CODE> statement is an empty statement.
902
`<SAMP>-nss</SAMP>' disables this feature.
903
</P><P>
904
905
<A NAME="IDX86"></A>
906
<A NAME="IDX87"></A>
907
<A NAME="IDX88"></A>
908
<A NAME="IDX89"></A>
909
The `<SAMP>-pcs</SAMP>' option causes a space to be placed between the name of
910
the procedure being called and the `<SAMP>(</SAMP>' (for example, <CODE>puts
911
("Hi");</CODE>. The `<SAMP>-npcs</SAMP>' option would give <CODE>puts("Hi");</CODE>).
912
</P><P>
913
914
<A NAME="IDX90"></A>
915
<A NAME="IDX91"></A>
916
<A NAME="IDX92"></A>
917
<A NAME="IDX93"></A>
918
If the `<SAMP>-cs</SAMP>' option is specified, <CODE>indent</CODE> puts a space after
919
a cast operator.
920
</P><P>
921
922
<A NAME="IDX94"></A>
923
<A NAME="IDX95"></A>
924
The `<SAMP>-bs</SAMP>' option ensures that there is a space between the
925
keyword <CODE>sizeof</CODE> and its argument. In some versions, this is
926
known as the `<SAMP>Bill_Shannon</SAMP>' option.
927
</P><P>
928
929
<A NAME="IDX96"></A>
930
<A NAME="IDX97"></A>
931
<A NAME="IDX98"></A>
932
<A NAME="IDX99"></A>
933
The `<SAMP>-saf</SAMP>' option forces a space between an <CODE>for</CODE>
934
and the following parenthesis. This is the default.
935
</P><P>
936
937
<A NAME="IDX100"></A>
938
<A NAME="IDX101"></A>
939
<A NAME="IDX102"></A>
940
<A NAME="IDX103"></A>
941
The `<SAMP>-sai</SAMP>' option forces a space between an <CODE>if</CODE>
942
and the following parenthesis. This is the default.
943
</P><P>
944
945
<A NAME="IDX104"></A>
946
<A NAME="IDX105"></A>
947
<A NAME="IDX106"></A>
948
<A NAME="IDX107"></A>
949
The `<SAMP>-saw</SAMP>' option forces a space between an <CODE>while</CODE>
950
and the following parenthesis. This is the default.
951
</P><P>
952
953
<A NAME="IDX108"></A>
954
<A NAME="IDX109"></A>
955
The `<SAMP>-prs</SAMP>' option causes all parentheses to be seperated with
956
a space from the what is between them. For example, using `<SAMP>-prs</SAMP>'
957
results in code like:
958
</P><P>
959
960
<TABLE><tr><td> </td><td class=example><pre> while ( ( e_code - s_code ) < ( dec_ind - 1 ) )
961
{
962
set_buf_break ( bb_dec_ind );
963
*e_code++ = ' ';
964
}
965
</pre></td></tr></table></P><P>
966
967
<A NAME="Declarations"></A>
968
<HR SIZE="6">
969
<A NAME="SEC10"></A>
970
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
971
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC9"> < </A>]</TD>
972
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC11"> > </A>]</TD>
973
<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC1"> << </A>]</TD>
974
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC1"> Up </A>]</TD>
975
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC17"> >> </A>]</TD>
976
<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC_Top">Top</A>]</TD>
977
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC_Contents">Contents</A>]</TD>
978
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC19">Index</A>]</TD>
979
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC_About"> ? </A>]</TD>
980
</TR></TABLE>
981
<H2> 1.7 Declarations </H2>
982
<!--docid::SEC10::-->
983
<P>
984
985
<A NAME="IDX110"></A>
986
<A NAME="IDX111"></A>
987
By default <CODE>indent</CODE> will line up identifiers, in the column
988
specified by the `<SAMP>-di</SAMP>' option. For example, `<SAMP>-di16</SAMP>' makes
989
things look like:
990
</P><P>
991
992
<TABLE><tr><td> </td><td class=example><pre>int foo;
993
char *bar;
994
</pre></td></tr></table></P><P>
995
996
Using a small value (such as one or two) for the `<SAMP>-di</SAMP>' option can
997
be used to cause the identifiers to be placed in the first available
998
position; for example:
999
</P><P>
1000
1001
<TABLE><tr><td> </td><td class=example><pre>int foo;
1002
char *bar;
1003
</pre></td></tr></table></P><P>
1004
1005
The value given to the `<SAMP>-di</SAMP>' option will still affect variables
1006
which are put on separate lines from their types, for example
1007
`<SAMP>-di2</SAMP>' will lead to:
1008
</P><P>
1009
1010
<TABLE><tr><td> </td><td class=example><pre>int
1011
foo;
1012
</pre></td></tr></table></P><P>
1013
1014
<A NAME="IDX112"></A>
1015
<A NAME="IDX113"></A>
1016
<A NAME="IDX114"></A>
1017
<A NAME="IDX115"></A>
1018
If the `<SAMP>-bc</SAMP>' option is specified, a newline is forced after each
1019
comma in a declaration. For example,
1020
</P><P>
1021
1022
<TABLE><tr><td> </td><td class=example><pre>int a,
1023
b,
1024
c;
1025
</pre></td></tr></table></P><P>
1026
1027
With the `<SAMP>-nbc</SAMP>' option this would look like
1028
</P><P>
1029
1030
<TABLE><tr><td> </td><td class=example><pre>int a, b, c;
1031
</pre></td></tr></table></P><P>
1032
1033
<A NAME="IDX116"></A>
1034
<A NAME="IDX117"></A>
1035
<A NAME="IDX118"></A>
1036
<A NAME="IDX119"></A>
1037
The `<SAMP>-bfda</SAMP>' option causes a newline to be forced after the comma
1038
separating the arguments of a function declaration. The arguments will
1039
appear at the current indention level matching the opening paren. This
1040
is particularly helpful for functions with long argument lists. For
1041
example,
1042
</P><P>
1043
1044
<TABLE><tr><td> </td><td class=example><pre>void foo (int arg1, char arg2, int *arg3, long arg4, char arg5);
1045
</pre></td></tr></table>With the `<SAMP>-bfda</SAMP>' option this would look like
1046
</P><P>
1047
1048
<TABLE><tr><td> </td><td class=example><pre>void foo (int arg1,
1049
char arg2,
1050
int *arg3,
1051
long arg4,
1052
char arg5);
1053
</pre></td></tr></table></P><P>
1054
1055
<A NAME="IDX120"></A>
1056
<A NAME="IDX121"></A>
1057
<A NAME="IDX122"></A>
1058
<A NAME="IDX123"></A>
1059
<A NAME="IDX124"></A>
1060
The `<SAMP>-psl</SAMP>' option causes the type of a procedure being defined to
1061
be placed on the line before the name of the procedure. This style is
1062
required for the <CODE>etags</CODE> program to work correctly, as well as some
1063
of the <CODE>c-mode</CODE> functions of Emacs.
1064
</P><P>
1065
1066
<A NAME="IDX125"></A>
1067
<A NAME="IDX126"></A>
1068
<A NAME="IDX127"></A>
1069
You must use the `<SAMP>-T</SAMP>'
1070
option to tell <CODE>indent</CODE> the name of all the typenames in your
1071
program that are defined by <CODE>typedef</CODE>. `<SAMP>-T</SAMP>' can be specified
1072
more than once, and all names specified are used. For example, if your
1073
program contains
1074
</P><P>
1075
1076
<TABLE><tr><td> </td><td class=example><pre>typedef unsigned long CODE_ADDR;
1077
typedef enum {red, blue, green} COLOR;
1078
</pre></td></tr></table></P><P>
1079
1080
you would use the options `<SAMP>-T CODE_ADDR -T COLOR</SAMP>'.
1081
</P><P>
1082
1083
The `<SAMP>-brs</SAMP>' or `<SAMP>-bls</SAMP>' option specifies how to format braces
1084
in struct declarations. The `<SAMP>-brs</SAMP>' option formats braces like
1085
this:
1086
</P><P>
1087
1088
<TABLE><tr><td> </td><td class=example><pre>struct foo {
1089
int x;
1090
};
1091
</pre></td></tr></table></P><P>
1092
1093
The `<SAMP>-bls</SAMP>' option formats them like this:
1094
</P><P>
1095
1096
<TABLE><tr><td> </td><td class=example><pre>struct foo
1097
{
1098
int x;
1099
};
1100
</pre></td></tr></table></P><P>
1101
1102
<A NAME="Indentation"></A>
1103
<HR SIZE="6">
1104
<A NAME="SEC11"></A>
1105
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
1106
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC10"> < </A>]</TD>
1107
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC12"> > </A>]</TD>
1108
<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC1"> << </A>]</TD>
1109
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC1"> Up </A>]</TD>
1110
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC17"> >> </A>]</TD>
1111
<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC_Top">Top</A>]</TD>
1112
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC_Contents">Contents</A>]</TD>
1113
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC19">Index</A>]</TD>
1114
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC_About"> ? </A>]</TD>
1115
</TR></TABLE>
1116
<H2> 1.8 Indentation </H2>
1117
<!--docid::SEC11::-->
1118
<P>
1119
1120
<A NAME="IDX128"></A>
1121
<A NAME="IDX129"></A>
1122
<A NAME="IDX130"></A>
1123
<A NAME="IDX131"></A>
1124
<A NAME="IDX132"></A>
1125
<A NAME="IDX133"></A>
1126
<A NAME="IDX134"></A>
1127
<A NAME="IDX135"></A>
1128
One issue in the formatting of code is how far each line should be
1129
indented from the left margin. When the beginning of a statement such
1130
as <CODE>if</CODE> or <CODE>for</CODE> is encountered, the indentation level is
1131
increased by the value specified by the `<SAMP>-i</SAMP>' option. For example,
1132
use `<SAMP>-i8</SAMP>' to specify an eight character indentation for each
1133
level. When a statement is broken across two lines, the second line is
1134
indented by a number of additional spaces specified by the `<SAMP>-ci</SAMP>'
1135
option. `<SAMP>-ci</SAMP>' defaults to 0. However, if the `<SAMP>-lp</SAMP>' option is
1136
specified, and a line has a left parenthesis which is not closed on that
1137
line, then continuation lines will be lined up to start at the character
1138
position just after the left parenthesis. This processing also applies
1139
to `<SAMP>[</SAMP>' and applies to `<SAMP>{</SAMP>' when it occurs in initialization
1140
lists. For example, a piece of continued code might look like this with
1141
`<SAMP>-nlp -ci3</SAMP>' in effect:
1142
</P><P>
1143
1144
<TABLE><tr><td> </td><td class=example><pre> p1 = first_procedure (second_procedure (p2, p3),
1145
third_procedure (p4, p5));
1146
</pre></td></tr></table></P><P>
1147
1148
With `<SAMP>-lp</SAMP>' in effect the code looks somewhat clearer:
1149
</P><P>
1150
1151
<TABLE><tr><td> </td><td class=example><pre> p1 = first_procedure (second_procedure (p2, p3),
1152
third_procedure (p4, p5));
1153
</pre></td></tr></table></P><P>
1154
1155
<A NAME="IDX136"></A>
1156
<A NAME="IDX137"></A>
1157
When a statement is broken in between two or more paren pairs (...),
1158
each extra pair causes the indentation level extra indentation:
1159
</P><P>
1160
1161
<TABLE><tr><td> </td><td class=example><pre>if ((((i < 2 &&
1162
k > 0) || p == 0) &&
1163
q == 1) ||
1164
n = 0)
1165
</pre></td></tr></table></P><P>
1166
1167
The option `<SAMP>-ip<VAR>N</VAR></SAMP>' can be used to set the extra offset per paren.
1168
For instance, `<SAMP>-ip0</SAMP>' would format the above as:
1169
</P><P>
1170
1171
<TABLE><tr><td> </td><td class=example><pre>if ((((i < 2 &&
1172
k > 0) || p == 0) &&
1173
q == 1) ||
1174
n = 0)
1175
</pre></td></tr></table></P><P>
1176
1177
<CODE>indent</CODE> assumes that tabs are placed at regular intervals of both
1178
input and output character streams. These intervals are by default 8
1179
columns wide, but (as of version 1.2) may be changed by the `<SAMP>-ts</SAMP>'
1180
option. Tabs are treated as the equivalent number of spaces.
1181
</P><P>
1182
1183
<A NAME="IDX138"></A>
1184
<A NAME="IDX139"></A>
1185
<A NAME="IDX140"></A>
1186
<A NAME="IDX141"></A>
1187
The indentation of type declarations in old-style function definitions
1188
is controlled by the `<SAMP>-ip</SAMP>' parameter. This is a numeric parameter
1189
specifying how many spaces to indent type declarations. For example,
1190
the default `<SAMP>-ip5</SAMP>' makes definitions look like this:
1191
</P><P>
1192
1193
<TABLE><tr><td> </td><td class=example><pre>char *
1194
create_world (x, y, scale)
1195
int x;
1196
int y;
1197
float scale;
1198
{
1199
. . .
1200
}
1201
</pre></td></tr></table></P><P>
1202
1203
For compatibility with other versions of indent, the option `<SAMP>-nip</SAMP>'
1204
is provided, which is equivalent to `<SAMP>-ip0</SAMP>'.
1205
</P><P>
1206
1207
<A NAME="IDX142"></A>
1208
<A NAME="IDX143"></A>
1209
<A NAME="IDX144"></A>
1210
<A NAME="IDX145"></A>
1211
ANSI C allows white space to be placed on preprocessor command lines
1212
between the character `<SAMP>#</SAMP>' and the command name. By default,
1213
<CODE>indent</CODE> removes this space, but specifying the `<SAMP>-lps</SAMP>' option
1214
directs <CODE>indent</CODE> to leave this space unmodified.
1215
</P><P>
1216
1217
<A NAME="Breaking long lines"></A>
1218
<HR SIZE="6">
1219
<A NAME="SEC12"></A>
1220
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
1221
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC11"> < </A>]</TD>
1222
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC13"> > </A>]</TD>
1223
<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC1"> << </A>]</TD>
1224
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC1"> Up </A>]</TD>
1225
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC17"> >> </A>]</TD>
1226
<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC_Top">Top</A>]</TD>
1227
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC_Contents">Contents</A>]</TD>
1228
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC19">Index</A>]</TD>
1229
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC_About"> ? </A>]</TD>
1230
</TR></TABLE>
1231
<H2> 1.9 Breaking long lines </H2>
1232
<!--docid::SEC12::-->
1233
<P>
1234
1235
<A NAME="IDX146"></A>
1236
<A NAME="IDX147"></A>
1237
With the option `<SAMP>-l<VAR>n</VAR></SAMP>', or `<SAMP>--line-length<VAR>n</VAR></SAMP>', it is
1238
possible to specify the maximum length of a line of C code, not including
1239
possible comments that follow it.
1240
</P><P>
1241
1242
When lines become longer then the specified line length, GNU <CODE>indent</CODE>
1243
tries to break the line at a logical place. This is new as of version 2.1
1244
however and not very intelligent or flexible yet.
1245
</P><P>
1246
1247
<A NAME="IDX148"></A>
1248
<A NAME="IDX149"></A>
1249
<A NAME="IDX150"></A>
1250
<A NAME="IDX151"></A>
1251
<A NAME="IDX152"></A>
1252
<A NAME="IDX153"></A>
1253
<A NAME="IDX154"></A>
1254
<A NAME="IDX155"></A>
1255
Currently there are two options that allows one to interfere with the
1256
algorithm that determines where to break a line.
1257
</P><P>
1258
1259
The `<SAMP>-bbo</SAMP>' option causes GNU <CODE>indent</CODE> to prefer to break
1260
long lines before the boolean operators <CODE>&&</CODE> and <CODE>||</CODE>. The
1261
`<SAMP>-nbbo</SAMP>' option causes GNU <CODE>indent</CODE> not have that
1262
preference. For example, the default option `<SAMP>-bbo</SAMP>' (together
1263
with `<SAMP>--line-length60</SAMP>' and `<SAMP>--ignore-newlines</SAMP>') makes code
1264
look like this:
1265
</P><P>
1266
1267
<TABLE><tr><td> </td><td class=example><pre> if (mask
1268
&& ((mask[0] == '\0')
1269
|| (mask[1] == '\0'
1270
&& ((mask[0] == '0') || (mask[0] == '*')))))
1271
</pre></td></tr></table></P><P>
1272
1273
Using the option `<SAMP>-nbbo</SAMP>' will make it look like this:
1274
</P><P>
1275
1276
<TABLE><tr><td> </td><td class=example><pre> if (mask &&
1277
((mask[0] == '\0') ||
1278
(mask[1] == '\0' &&
1279
((mask[0] == '0') || (mask[0] == '*')))))
1280
</pre></td></tr></table></P><P>
1281
1282
The default `<SAMP>-hnl</SAMP>', however, honours newlines in the input file by
1283
giving them the highest possible priority to break lines at. For example,
1284
when the input file looks like this:
1285
</P><P>
1286
1287
<TABLE><tr><td> </td><td class=example><pre> if (mask
1288
&& ((mask[0] == '\0')
1289
|| (mask[1] == '\0' && ((mask[0] == '0') || (mask[0] == '*')))))
1290
</pre></td></tr></table></P><P>
1291
1292
then using the option `<SAMP>-hnl</SAMP>', or `<SAMP>--honour-newlines</SAMP>',
1293
together with the previously mentioned `<SAMP>-nbbo</SAMP>' and
1294
`<SAMP>--line-length60</SAMP>', will cause the output not to be what is given
1295
in the last example but instead will prefer to break at the positions
1296
where the code was broken in the input file:
1297
</P><P>
1298
1299
<TABLE><tr><td> </td><td class=example><pre> if (mask
1300
&& ((mask[0] == '\0')
1301
|| (mask[1] == '\0' &&
1302
((mask[0] == '0') || (mask[0] == '*')))))
1303
</pre></td></tr></table></P><P>
1304
1305
The idea behind this option is that lines which are too long, but are already
1306
broken up, will not be touched by GNU <CODE>indent</CODE>. Really messy code
1307
should be run through <CODE>indent</CODE> at least once using the
1308
`<SAMP>--ignore-newlines</SAMP>' option though.
1309
</P><P>
1310
1311
<A NAME="Disabling Formatting"></A>
1312
<HR SIZE="6">
1313
<A NAME="SEC13"></A>
1314
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
1315
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC12"> < </A>]</TD>
1316
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC14"> > </A>]</TD>
1317
<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC1"> << </A>]</TD>
1318
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC1"> Up </A>]</TD>
1319
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC17"> >> </A>]</TD>
1320
<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC_Top">Top</A>]</TD>
1321
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC_Contents">Contents</A>]</TD>
1322
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC19">Index</A>]</TD>
1323
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC_About"> ? </A>]</TD>
1324
</TR></TABLE>
1325
<H2> 1.10 Disabling Formatting </H2>
1326
<!--docid::SEC13::-->
1327
<P>
1328
1329
Formatting of C code may be disabled for portions of a program by
1330
embedding special <EM>control comments</EM> in the program. To turn off
1331
formatting for a section of a program, place the disabling control
1332
comment <CODE>/* *INDENT-OFF* */</CODE> on a line by itself just before that
1333
section. Program text scanned after this control comment is output
1334
precisely as input with no modifications until the corresponding
1335
enabling comment is scanned on a line by itself. The disabling control
1336
comment is <CODE>/* *INDENT-ON* */</CODE>, and any text following the comment
1337
on the line is also output unformatted. Formatting begins again with
1338
the input line following the enabling control comment.
1339
</P><P>
1340
1341
More precisely, <CODE>indent</CODE> does not attempt to verify the closing
1342
delimiter (<CODE>*/</CODE>) for these C comments, and any whitespace on the
1343
line is totally transparent.
1344
</P><P>
1345
1346
These control comments also function in their C++ formats, namely
1347
<CODE>// *INDENT-OFF*</CODE> and <CODE>// *INDENT-ON*</CODE>.
1348
</P><P>
1349
1350
It should be noted that the internal state of <CODE>indent</CODE> remains
1351
unchanged over the course of the unformatted section. Thus, for
1352
example, turning off formatting in the middle of a function and
1353
continuing it after the end of the function may lead to bizarre
1354
results. It is therefore wise to be somewhat modular in selecting code
1355
to be left unformatted.
1356
</P><P>
1357
1358
As a historical note, some earlier versions of <CODE>indent</CODE> produced
1359
error messages beginning with <CODE>*INDENT**</CODE>. These versions of
1360
<CODE>indent</CODE> were written to ignore any input text lines which began
1361
with such error messages. I have removed this incestuous feature from
1362
GNU <CODE>indent</CODE>.
1363
</P><P>
1364
1365
<A NAME="Miscellaneous options"></A>
1366
<HR SIZE="6">
1367
<A NAME="SEC14"></A>
1368
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
1369
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC13"> < </A>]</TD>
1370
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC15"> > </A>]</TD>
1371
<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC1"> << </A>]</TD>
1372
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC1"> Up </A>]</TD>
1373
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC17"> >> </A>]</TD>
1374
<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC_Top">Top</A>]</TD>
1375
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC_Contents">Contents</A>]</TD>
1376
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC19">Index</A>]</TD>
1377
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC_About"> ? </A>]</TD>
1378
</TR></TABLE>
1379
<H2> 1.11 Miscellaneous options </H2>
1380
<!--docid::SEC14::-->
1381
<P>
1382
1383
<A NAME="IDX156"></A>
1384
To find out what version of <CODE>indent</CODE> you have, use the command
1385
<CODE>indent -version</CODE>. This will report the version number of
1386
<CODE>indent</CODE>, without doing any of the normal processing.
1387
</P><P>
1388
1389
<A NAME="IDX157"></A>
1390
<A NAME="IDX158"></A>
1391
<A NAME="IDX159"></A>
1392
<A NAME="IDX160"></A>
1393
The `<SAMP>-v</SAMP>' option can be used to turn on verbose mode. When in
1394
verbose mode, <CODE>indent</CODE> reports when it splits one line of input
1395
into two more more lines of output, and gives some size statistics at
1396
completion.
1397
</P><P>
1398
1399
<A NAME="IDX161"></A>
1400
<A NAME="IDX162"></A>
1401
<A NAME="IDX163"></A>
1402
The `<SAMP>-pmt</SAMP>' option causes <CODE>indent</CODE> to preserve the access
1403
and modification times on the output files. Using this option
1404
has the advantage that running indent on all source and header
1405
files in a project won't cause <CODE>make</CODE> to rebuild all targets.
1406
This option is only available on Operating Systems that have the
1407
POSIX <CODE>utime(2)</CODE> function.
1408
</P><P>
1409
1410
<A NAME="Bugs"></A>
1411
<HR SIZE="6">
1412
<A NAME="SEC15"></A>
1413
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
1414
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC14"> < </A>]</TD>
1415
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC16"> > </A>]</TD>
1416
<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC1"> << </A>]</TD>
1417
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC1"> Up </A>]</TD>
1418
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC17"> >> </A>]</TD>
1419
<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC_Top">Top</A>]</TD>
1420
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC_Contents">Contents</A>]</TD>
1421
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC19">Index</A>]</TD>
1422
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC_About"> ? </A>]</TD>
1423
</TR></TABLE>
1424
<H2> 1.12 Bugs </H2>
1425
<!--docid::SEC15::-->
1426
<P>
1427
1428
Please report any bugs to <A HREF="mailto:bug-indent@gnu.org">bug-indent@gnu.org</A>.
1429
</P><P>
1430
1431
When <CODE>indent</CODE> is run twice on a file, with the same profile,
1432
it should <EM>never</EM> change that file the second time. With the
1433
current design of <CODE>indent</CODE>, this can not be guaranteed, however,
1434
and it has not been extensively tested.
1435
</P><P>
1436
1437
<CODE>indent</CODE> does not understand C. In some cases this leads to
1438
the inability to join lines. The result is that running a file
1439
through <CODE>indent</CODE> is <EM>irreversible</EM>, even if the used input
1440
file was the result of running <CODE>indent</CODE> with a given profile
1441
(`<TT>.indent.pro</TT>').
1442
</P><P>
1443
1444
While an attempt was made to get <CODE>indent</CODE> working for C++, is
1445
will not do a good job on any C++ source except the very simple.
1446
</P><P>
1447
1448
<CODE>indent</CODE> does not look at the given `<SAMP>--line-length</SAMP>' option
1449
when writing comments to the output file. This results often in comments
1450
being put far to the right. In order to prohibit <CODE>indent</CODE> from
1451
joining a broken line that has a comment at the end, make sure that the
1452
comments start on the first line of the break.
1453
</P><P>
1454
1455
<CODE>indent</CODE> does not count lines and comments (see the `<SAMP>-v</SAMP>'
1456
option) when <CODE>indent</CODE> is turned off with
1457
<CODE>/* *INDENT-OFF* */</CODE>.
1458
</P><P>
1459
1460
Comments of the form <CODE>/*UPPERCASE*/</CODE> are not treated as comment but as an
1461
identifier, causing them to be joined with the next line. This renders
1462
comments of this type useless, unless they are embedded in the code to
1463
begin with.
1464
</P><P>
1465
1466
<A NAME="Copyright"></A>
1467
<HR SIZE="6">
1468
<A NAME="SEC16"></A>
1469
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
1470
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC15"> < </A>]</TD>
1471
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC17"> > </A>]</TD>
1472
<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC1"> << </A>]</TD>
1473
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC1"> Up </A>]</TD>
1474
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC17"> >> </A>]</TD>
1475
<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC_Top">Top</A>]</TD>
1476
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC_Contents">Contents</A>]</TD>
1477
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC19">Index</A>]</TD>
1478
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC_About"> ? </A>]</TD>
1479
</TR></TABLE>
1480
<H2> 1.13 Copyright </H2>
1481
<!--docid::SEC16::-->
1482
<P>
1483
1484
The following copyright notice applies to the <CODE>indent</CODE> program.
1485
The copyright and copying permissions for this manual appear near the
1486
beginning of `<TT>indent.texinfo</TT>' and `<TT>indent.info</TT>', and near the
1487
end of `<TT>indent.1</TT>'.
1488
</P><P>
1489
1490
<TABLE><tr><td> </td><td class=display><pre style="font-family: serif">Copyright © 2001 David Ingamells.
1491
Copyright © 1999 Carlo Wood.
1492
Copyright © 1995, 1996 Joseph Arceneaux.
1493
Copyright © 1989, 1992, 1993, 1994, 1995, 1996 Free Software Foundation
1494
Copyright © 1985 Sun Microsystems, Inc.
1495
Copyright © 1980 The Regents of the University of California.
1496
Copyright © 1976 Board of Trustees of the University of Illinois.
1497
All rights reserved.
1498
1499
Redistribution and use in source and binary forms are permitted
1500
provided that the above copyright notice and this paragraph are
1501
duplicated in all such forms and that any documentation,
1502
advertising materials, and other materials related to such
1503
distribution and use acknowledge that the software was developed
1504
by the University of California, Berkeley, the University of Illinois,
1505
Urbana, and Sun Microsystems, Inc. The name of either University
1506
or Sun Microsystems may not be used to endorse or promote products
1507
derived from this software without specific prior written permission.
1508
THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
1509
IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
1510
WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR
1511
PURPOSE.
1512
</pre></td></tr></table></P><P>
1513
1514
<A NAME="Option Summary"></A>
1515
<HR SIZE="6">
1516
<A NAME="SEC17"></A>
1517
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
1518
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC16"> < </A>]</TD>
1519
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC19"> > </A>]</TD>
1520
<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC1"> << </A>]</TD>
1521
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC_Top"> Up </A>]</TD>
1522
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC19"> >> </A>]</TD>
1523
<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC_Top">Top</A>]</TD>
1524
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC_Contents">Contents</A>]</TD>
1525
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC19">Index</A>]</TD>
1526
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC_About"> ? </A>]</TD>
1527
</TR></TABLE>
1528
<H1> A. Option Summary </H1>
1529
<!--docid::SEC17::-->
1530
<P>
1531
1532
Here is a list of all the options for <CODE>indent</CODE>, alphabetized by
1533
short option. It is followed by a cross key alphabetized by long option.
1534
</P><P>
1535
1536
<DL COMPACT>
1537
<DT>`<SAMP>-bad</SAMP>'
1538
<DD><DT>`<SAMP>--blank-lines-after-declarations</SAMP>'
1539
<DD>Force blank lines after the declarations.<BR>
1540
See section <A HREF="indent.html#SEC5">1.4 Blank lines</A>.
1541
<P>
1542
1543
<DT>`<SAMP>-bap</SAMP>'
1544
<DD><DT>`<SAMP>--blank-lines-after-procedures</SAMP>'
1545
<DD>Force blank lines after procedure bodies.<BR>
1546
See section <A HREF="indent.html#SEC5">1.4 Blank lines</A>.
1547
<P>
1548
1549
<DT>`<SAMP>-bbb</SAMP>'
1550
<DD><DT>`<SAMP>--blank-lines-before-block-comments</SAMP>'
1551
<DD>Force blank lines before block comments.<BR>
1552
See section <A HREF="indent.html#SEC5">1.4 Blank lines</A>.
1553
<P>
1554
1555
<DT>`<SAMP>-bbo</SAMP>'
1556
<DD><DT>`<SAMP>--break-before-boolean-operator</SAMP>'
1557
<DD>Prefer to break long lines before boolean operators.<BR>
1558
See section <A HREF="indent.html#SEC12">1.9 Breaking long lines</A>.
1559
<P>
1560
1561
<DT>`<SAMP>-bc</SAMP>'
1562
<DD><DT>`<SAMP>--blank-lines-after-commas</SAMP>'
1563
<DD>Force newline after comma in declaration.<BR>
1564
See section <A HREF="indent.html#SEC10">1.7 Declarations</A>.
1565
<P>
1566
1567
<DT>`<SAMP>-bl</SAMP>'
1568
<DD><DT>`<SAMP>--braces-after-if-line</SAMP>'
1569
<DD>Put braces on line after <CODE>if</CODE>, etc.<BR>
1570
See section <A HREF="indent.html#SEC9">1.6 Statements</A>.
1571
<P>
1572
1573
<DT>`<SAMP>-bli<VAR>n</VAR></SAMP>'
1574
<DD><DT>`<SAMP>--brace-indent<VAR>n</VAR></SAMP>'
1575
<DD>Indent braces <VAR>n</VAR> spaces.<BR>
1576
See section <A HREF="indent.html#SEC9">1.6 Statements</A>.
1577
<P>
1578
1579
<DT>`<SAMP>-bls</SAMP>'
1580
<DD><DT>`<SAMP>--braces-after-struct-decl-line</SAMP>'
1581
<DD>Put braces on the line after <CODE>struct</CODE> declaration lines.<BR>
1582
See section <A HREF="indent.html#SEC10">1.7 Declarations</A>.
1583
<P>
1584
1585
<DT>`<SAMP>-br</SAMP>'
1586
<DD><DT>`<SAMP>--braces-on-if-line</SAMP>'
1587
<DD>Put braces on line with <CODE>if</CODE>, etc.<BR>
1588
See section <A HREF="indent.html#SEC9">1.6 Statements</A>.
1589
<P>
1590
1591
<DT>`<SAMP>-brs</SAMP>'
1592
<DD><DT>`<SAMP>--braces-on-struct-decl-line</SAMP>'
1593
<DD>Put braces on <CODE>struct</CODE> declaration line.<BR>
1594
See section <A HREF="indent.html#SEC10">1.7 Declarations</A>.
1595
<P>
1596
1597
<DT>`<SAMP>-bs</SAMP>'
1598
<DD><DT>`<SAMP>--Bill-Shannon</SAMP>'
1599
<DD><DT>`<SAMP>--blank-before-sizeof</SAMP>'
1600
<DD>Put a space between <CODE>sizeof</CODE> and its argument.<BR>
1601
See section <A HREF="indent.html#SEC9">1.6 Statements</A>.
1602
<P>
1603
1604
<DT>`<SAMP>-c<VAR>n</VAR></SAMP>'
1605
<DD><DT>`<SAMP>--comment-indentation<VAR>n</VAR></SAMP>'
1606
<DD>Put comments to the right of code in column <VAR>n</VAR>.<BR>
1607
See section <A HREF="indent.html#SEC8">1.5 Comments</A>.
1608
<P>
1609
1610
<DT>`<SAMP>-cbi<VAR>n</VAR></SAMP>'
1611
<DD><DT>`<SAMP>--case-brace-indentation<VAR>n</VAR></SAMP>'
1612
<DD>Indent braces after a case label N spaces.<BR>
1613
See section <A HREF="indent.html#SEC9">1.6 Statements</A>.
1614
<P>
1615
1616
<DT>`<SAMP>-cd<VAR>n</VAR></SAMP>'
1617
<DD><DT>`<SAMP>--declaration-comment-column<VAR>n</VAR></SAMP>'
1618
<DD>Put comments to the right of the declarations in column <VAR>n</VAR>.<BR>
1619
See section <A HREF="indent.html#SEC8">1.5 Comments</A>.
1620
<P>
1621
1622
<DT>`<SAMP>-cdb</SAMP>'
1623
<DD><DT>`<SAMP>--comment-delimiters-on-blank-lines</SAMP>'
1624
<DD>Put comment delimiters on blank lines.<BR>
1625
See section <A HREF="indent.html#SEC8">1.5 Comments</A>.
1626
<P>
1627
1628
<DT>`<SAMP>-cdw</SAMP>'
1629
<DD><DT>`<SAMP>--cuddle-do-while</SAMP>'
1630
<DD>Cuddle while of <CODE>do {} while;</CODE> and preceeding `<SAMP>}</SAMP>'.<BR>
1631
See section <A HREF="indent.html#SEC8">1.5 Comments</A>.
1632
<P>
1633
1634
<DT>`<SAMP>-ce</SAMP>'
1635
<DD><DT>`<SAMP>--cuddle-else</SAMP>'
1636
<DD>Cuddle else and preceeding `<SAMP>}</SAMP>'.<BR>
1637
See section <A HREF="indent.html#SEC8">1.5 Comments</A>.
1638
<P>
1639
1640
<DT>`<SAMP>-ci<VAR>n</VAR></SAMP>'
1641
<DD><DT>`<SAMP>--continuation-indentation<VAR>n</VAR></SAMP>'
1642
<DD>Continuation indent of <VAR>n</VAR> spaces.<BR>
1643
See section <A HREF="indent.html#SEC9">1.6 Statements</A>.
1644
<P>
1645
1646
<DT>`<SAMP>-cli<VAR>n</VAR></SAMP>'
1647
<DD><DT>`<SAMP>--case-indentation<VAR>n</VAR></SAMP>'
1648
<DD>Case label indent of <VAR>n</VAR> spaces.<BR>
1649
See section <A HREF="indent.html#SEC9">1.6 Statements</A>.
1650
<P>
1651
1652
<DT>`<SAMP>-cp<VAR>n</VAR></SAMP>'
1653
<DD><DT>`<SAMP>--else-endif-column<VAR>n</VAR></SAMP>'
1654
<DD>Put comments to the right of <CODE>#else</CODE> and
1655
<CODE>#endif</CODE> statements in column <VAR>n</VAR>.<BR>
1656
See section <A HREF="indent.html#SEC8">1.5 Comments</A>.
1657
<P>
1658
1659
<DT>`<SAMP>-cs</SAMP>'
1660
<DD><DT>`<SAMP>--space-after-cast</SAMP>'
1661
<DD>Put a space after a cast operator.<BR>
1662
See section <A HREF="indent.html#SEC9">1.6 Statements</A>.
1663
<P>
1664
1665
<DT>`<SAMP>-d<VAR>n</VAR></SAMP>'
1666
<DD><DT>`<SAMP>--line-comments-indentation<VAR>n</VAR></SAMP>'
1667
<DD>Set indentation of comments not to the right
1668
of code to <VAR>n</VAR> spaces.<BR>
1669
See section <A HREF="indent.html#SEC8">1.5 Comments</A>.
1670
<P>
1671
1672
<DT>`<SAMP>-bfda</SAMP>'
1673
<DD><DT>`<SAMP>--break-function-decl-args</SAMP>'
1674
<DD>Align all arguments in a declaration with opening paren.<BR>
1675
See section <A HREF="indent.html#SEC10">1.7 Declarations</A>.
1676
<P>
1677
1678
<DT>`<SAMP>-di<VAR>n</VAR></SAMP>'
1679
<DD><DT>`<SAMP>--declaration-indentation<VAR>n</VAR></SAMP>'
1680
<DD>Put variables in column <VAR>n</VAR>.<BR>
1681
See section <A HREF="indent.html#SEC10">1.7 Declarations</A>.
1682
<P>
1683
1684
<DT>`<SAMP>-fc1</SAMP>'
1685
<DD><DT>`<SAMP>--format-first-column-comments</SAMP>'
1686
<DD>Format comments in the first column.<BR>
1687
See section <A HREF="indent.html#SEC8">1.5 Comments</A>.
1688
<P>
1689
1690
<DT>`<SAMP>-fca</SAMP>'
1691
<DD><DT>`<SAMP>--format-all-comments</SAMP>'
1692
<DD>Do not disable all formatting of comments.<BR>
1693
See section <A HREF="indent.html#SEC8">1.5 Comments</A>.
1694
<P>
1695
1696
<DT>`<SAMP>-gnu</SAMP>'
1697
<DD><DT>`<SAMP>--gnu-style</SAMP>'
1698
<DD>Use GNU coding style. This is the default.<BR>
1699
See section <A HREF="indent.html#SEC4">1.3 Common styles</A>.
1700
<P>
1701
1702
<DT>`<SAMP>-hnl</SAMP>'
1703
<DD><DT>`<SAMP>--honour-newlines</SAMP>'
1704
<DD>Prefer to break long lines at the position of newlines in the input.<BR>
1705
See section <A HREF="indent.html#SEC12">1.9 Breaking long lines</A>.
1706
<P>
1707
1708
<DT>`<SAMP>-i<VAR>n</VAR></SAMP>'
1709
<DD><DT>`<SAMP>--indent-level<VAR>n</VAR></SAMP>'
1710
<DD>Set indentation level to <VAR>n</VAR> spaces.<BR>
1711
See section <A HREF="indent.html#SEC11">1.8 Indentation</A>.
1712
<P>
1713
1714
<DT>`<SAMP>-ip<VAR>n</VAR></SAMP>'
1715
<DD><DT>`<SAMP>--parameter-indentation<VAR>n</VAR></SAMP>'
1716
<DD>Indent parameter types in old-style function
1717
definitions by <VAR>n</VAR> spaces.<BR>
1718
See section <A HREF="indent.html#SEC11">1.8 Indentation</A>.
1719
<P>
1720
1721
<DT>`<SAMP>-kr</SAMP>'
1722
<DD><DT>`<SAMP>--k-and-r-style</SAMP>'
1723
<DD>Use Kernighan & Ritchie coding style.<BR>
1724
See section <A HREF="indent.html#SEC4">1.3 Common styles</A>.
1725
<P>
1726
1727
<DT>`<SAMP>-l<VAR>n</VAR></SAMP>'
1728
<DD><DT>`<SAMP>--line-length<VAR>n</VAR></SAMP>'
1729
<DD>Set maximum line length for non-comment lines to <VAR>n</VAR>.<BR>
1730
See section <A HREF="indent.html#SEC12">1.9 Breaking long lines</A>.
1731
<P>
1732
1733
<DT>`<SAMP>-lc<VAR>n</VAR></SAMP>'
1734
<DD><DT>`<SAMP>--comment-line-length<VAR>n</VAR></SAMP>'
1735
<DD>Set maximum line length for comment formatting to <VAR>n</VAR>.<BR>
1736
See section <A HREF="indent.html#SEC8">1.5 Comments</A>.
1737
<P>
1738
1739
<DT>`<SAMP>-lp</SAMP>'
1740
<DD><DT>`<SAMP>--continue-at-parentheses</SAMP>'
1741
<DD>Line up continued lines at parentheses.<BR>
1742
See section <A HREF="indent.html#SEC11">1.8 Indentation</A>.
1743
<P>
1744
1745
<DT>`<SAMP>-lps</SAMP>'
1746
<DD><DT>`<SAMP>--leave-preprocessor-space</SAMP>'
1747
<DD>Leave space between `<SAMP>#</SAMP>' and preprocessor directive.<BR>
1748
See section <A HREF="indent.html#SEC11">1.8 Indentation</A>.
1749
<P>
1750
1751
<DT>`<SAMP>-nbad</SAMP>'
1752
<DD><DT>`<SAMP>--no-blank-lines-after-declarations</SAMP>'
1753
<DD>Do not force blank lines after declarations.<BR>
1754
See section <A HREF="indent.html#SEC5">1.4 Blank lines</A>.
1755
<P>
1756
1757
<DT>`<SAMP>-nbap</SAMP>'
1758
<DD><DT>`<SAMP>--no-blank-lines-after-procedures</SAMP>'
1759
<DD>Do not force blank lines after procedure bodies.<BR>
1760
See section <A HREF="indent.html#SEC5">1.4 Blank lines</A>.
1761
<P>
1762
1763
<DT>`<SAMP>-nbbo</SAMP>'
1764
<DD><DT>`<SAMP>--break-after-boolean-operator</SAMP>'
1765
<DD>Do not prefer to break long lines before boolean operators.<BR>
1766
See section <A HREF="indent.html#SEC12">1.9 Breaking long lines</A>.
1767
<P>
1768
1769
<DT>`<SAMP>-nbc</SAMP>'
1770
<DD><DT>`<SAMP>--no-blank-lines-after-commas</SAMP>'
1771
<DD>Do not force newlines after commas in declarations.<BR>
1772
See section <A HREF="indent.html#SEC10">1.7 Declarations</A>.
1773
<P>
1774
1775
<DT>`<SAMP>-nbfda</SAMP>'
1776
<DD><DT>`<SAMP>--dont-break-function-decl-args</SAMP>'
1777
<DD>Don't put each argument in a function declaration on a seperate line.<BR>
1778
See section <A HREF="indent.html#SEC10">1.7 Declarations</A>.
1779
<P>
1780
1781
<DT>`<SAMP>-ncdb</SAMP>'
1782
<DD><DT>`<SAMP>--no-comment-delimiters-on-blank-lines</SAMP>'
1783
<DD>Do not put comment delimiters on blank lines.<BR>
1784
See section <A HREF="indent.html#SEC8">1.5 Comments</A>.
1785
<P>
1786
1787
<DT>`<SAMP>-ncdw</SAMP>'
1788
<DD><DT>`<SAMP>--dont-cuddle-do-while</SAMP>'
1789
<DD>Do not cuddle <CODE>}</CODE> and the <CODE>while</CODE> of a <CODE>do {} while;</CODE>.<BR>
1790
See section <A HREF="indent.html#SEC9">1.6 Statements</A>.
1791
<P>
1792
1793
<DT>`<SAMP>-nce</SAMP>'
1794
<DD><DT>`<SAMP>--dont-cuddle-else</SAMP>'
1795
<DD>Do not cuddle <CODE>}</CODE> and <CODE>else</CODE>.<BR>
1796
See section <A HREF="indent.html#SEC9">1.6 Statements</A>.
1797
<P>
1798
1799
<DT>`<SAMP>-ncs</SAMP>'
1800
<DD><DT>`<SAMP>--no-space-after-casts</SAMP>'
1801
<DD>Do not put a space after cast operators.<BR>
1802
See section <A HREF="indent.html#SEC9">1.6 Statements</A>.
1803
<P>
1804
1805
<DT>`<SAMP>-nfc1</SAMP>'
1806
<DD><DT>`<SAMP>--dont-format-first-column-comments</SAMP>'
1807
<DD>Do not format comments in the first column as normal.<BR>
1808
See section <A HREF="indent.html#SEC8">1.5 Comments</A>.
1809
<P>
1810
1811
<DT>`<SAMP>-nfca</SAMP>'
1812
<DD><DT>`<SAMP>--dont-format-comments</SAMP>'
1813
<DD>Do not format any comments.<BR>
1814
See section <A HREF="indent.html#SEC8">1.5 Comments</A>.
1815
<P>
1816
1817
<DT>`<SAMP>-nhnl</SAMP>'
1818
<DD><DT>`<SAMP>--ignore-newlines</SAMP>'
1819
<DD>Do not prefer to break long lines at the position of newlines in the input.<BR>
1820
See section <A HREF="indent.html#SEC12">1.9 Breaking long lines</A>.
1821
<P>
1822
1823
<DT>`<SAMP>-nip</SAMP>'
1824
<DD><DT>`<SAMP>--no-parameter-indentation</SAMP>'
1825
<DD>Zero width indentation for parameters.<BR>
1826
See section <A HREF="indent.html#SEC11">1.8 Indentation</A>.
1827
<P>
1828
1829
<DT>`<SAMP>-nlp</SAMP>'
1830
<DD><DT>`<SAMP>--dont-line-up-parentheses</SAMP>'
1831
<DD>Do not line up parentheses.<BR>
1832
See section <A HREF="indent.html#SEC9">1.6 Statements</A>.
1833
<P>
1834
1835
<DT>`<SAMP>-npcs</SAMP>'
1836
<DD><DT>`<SAMP>--no-space-after-function-call-names</SAMP>'
1837
<DD>Do not put space after the function in function calls.<BR>
1838
See section <A HREF="indent.html#SEC9">1.6 Statements</A>.
1839
<P>
1840
1841
<DT>`<SAMP>-nprs</SAMP>'
1842
<DD><DT>`<SAMP>--no-space-after-parentheses</SAMP>'
1843
<DD>Do not put a space after every '(' and before every ')'.<BR>
1844
See section <A HREF="indent.html#SEC9">1.6 Statements</A>.
1845
<P>
1846
1847
<DT>`<SAMP>-npsl</SAMP>'
1848
<DD><DT>`<SAMP>--dont-break-procedure-type</SAMP>'
1849
<DD>Put the type of a procedure on the same line as its name.<BR>
1850
See section <A HREF="indent.html#SEC10">1.7 Declarations</A>.
1851
<P>
1852
1853
<DT>`<SAMP>-nsaf</SAMP>'
1854
<DD><DT>`<SAMP>--no-space-after-for</SAMP>'
1855
<DD>Do not put a space after every <CODE>for</CODE>.<BR>
1856
See section <A HREF="indent.html#SEC9">1.6 Statements</A>.
1857
<P>
1858
1859
<DT>`<SAMP>-nsai</SAMP>'
1860
<DD><DT>`<SAMP>--no-space-after-if</SAMP>'
1861
<DD>Do not put a space after every <CODE>if</CODE>.<BR>
1862
See section <A HREF="indent.html#SEC9">1.6 Statements</A>.
1863
<P>
1864
1865
<DT>`<SAMP>-nsaw</SAMP>'
1866
<DD><DT>`<SAMP>--no-space-after-while</SAMP>'
1867
<DD>Do not put a space after every <CODE>while</CODE>.<BR>
1868
See section <A HREF="indent.html#SEC9">1.6 Statements</A>.
1869
<P>
1870
1871
<DT>`<SAMP>-nsc</SAMP>'
1872
<DD><DT>`<SAMP>--dont-star-comments</SAMP>'
1873
<DD>Do not put the `<SAMP>*</SAMP>' character at the left of comments.<BR>
1874
See section <A HREF="indent.html#SEC8">1.5 Comments</A>.
1875
<P>
1876
1877
<DT>`<SAMP>-nsob</SAMP>'
1878
<DD><DT>`<SAMP>--leave-optional-blank-lines</SAMP>'
1879
<DD>Do not swallow optional blank lines.<BR>
1880
See section <A HREF="indent.html#SEC5">1.4 Blank lines</A>.
1881
<P>
1882
1883
<DT>`<SAMP>-nss</SAMP>'
1884
<DD><DT>`<SAMP>--dont-space-special-semicolon</SAMP>'
1885
<DD>Do not force a space before the semicolon after certain statements.
1886
Disables `<SAMP>-ss</SAMP>'.<BR>
1887
See section <A HREF="indent.html#SEC9">1.6 Statements</A>.
1888
<P>
1889
1890
<DT>`<SAMP>-nut</SAMP>'
1891
<DD><DT>`<SAMP>--no-tabs</SAMP>'
1892
<DD>Use spaces instead of tabs.<BR>
1893
See section <A HREF="indent.html#SEC11">1.8 Indentation</A>.
1894
<P>
1895
1896
<DT>`<SAMP>-nv</SAMP>'
1897
<DD><DT>`<SAMP>--no-verbosity</SAMP>'
1898
<DD>Disable verbose mode.<BR>
1899
See section <A HREF="indent.html#SEC14">1.11 Miscellaneous options</A>.
1900
<P>
1901
1902
<DT>`<SAMP>-orig</SAMP>'
1903
<DD><DT>`<SAMP>--original</SAMP>'
1904
<DD>Use the original Berkeley coding style.<BR>
1905
See section <A HREF="indent.html#SEC4">1.3 Common styles</A>.
1906
<P>
1907
1908
<DT>`<SAMP>-npro</SAMP>'
1909
<DD><DT>`<SAMP>--ignore-profile</SAMP>'
1910
<DD>Do not read `<TT>.indent.pro</TT>' files.<BR>
1911
See section <A HREF="indent.html#SEC2">1.1 Invoking <CODE>indent</CODE></A>.
1912
<P>
1913
1914
<DT>`<SAMP>-pcs</SAMP>'
1915
<DD><DT>`<SAMP>--space-after-procedure-calls</SAMP>'
1916
<DD>Insert a space between the name of the
1917
procedure being called and the `<SAMP>(</SAMP>'.<BR>
1918
See section <A HREF="indent.html#SEC9">1.6 Statements</A>.
1919
<P>
1920
1921
<DT>`<SAMP>-pi<VAR>n</VAR></SAMP>'
1922
<DD><DT>`<SAMP>--paren-indentation<VAR>n</VAR></SAMP>'
1923
<DD>Specify the extra indentation per open parentheses '(' when a
1924
statement is broken.
1925
See section <A HREF="indent.html#SEC9">1.6 Statements</A>.
1926
<P>
1927
1928
<DT>`<SAMP>-pmt</SAMP>'
1929
<DD><DT>`<SAMP>--preserve-mtime</SAMP>'
1930
<DD>Preserve access and modification times on output files.
1931
See section <A HREF="indent.html#SEC14">1.11 Miscellaneous options</A>.
1932
<P>
1933
1934
<DT>`<SAMP>-prs</SAMP>'
1935
<DD><DT>`<SAMP>--space-after-parentheses</SAMP>'
1936
<DD>Put a space after every '(' and before every ')'.<BR>
1937
See section <A HREF="indent.html#SEC9">1.6 Statements</A>.
1938
<P>
1939
1940
<DT>`<SAMP>-psl</SAMP>'
1941
<DD><DT>`<SAMP>--procnames-start-lines</SAMP>'
1942
<DD>Put the type of a procedure on the line before its name.<BR>
1943
See section <A HREF="indent.html#SEC10">1.7 Declarations</A>.
1944
<P>
1945
1946
<DT>`<SAMP>-saf</SAMP>'
1947
<DD><DT>`<SAMP>--space-after-for</SAMP>'
1948
<DD>Put a space after each <CODE>for</CODE>.<BR>
1949
See section <A HREF="indent.html#SEC9">1.6 Statements</A>.
1950
<P>
1951
1952
<DT>`<SAMP>-sai</SAMP>'
1953
<DD><DT>`<SAMP>--space-after-if</SAMP>'
1954
<DD>Put a space after each <CODE>if</CODE>.<BR>
1955
See section <A HREF="indent.html#SEC9">1.6 Statements</A>.
1956
<P>
1957
1958
<DT>`<SAMP>-saw</SAMP>'
1959
<DD><DT>`<SAMP>--space-after-while</SAMP>'
1960
<DD>Put a space after each <CODE>while</CODE>.<BR>
1961
See section <A HREF="indent.html#SEC9">1.6 Statements</A>.
1962
<P>
1963
1964
<DT>`<SAMP>-sbi<VAR>n</VAR></SAMP>'
1965
<DD><DT>`<SAMP>--struct-brace-indentation<VAR>n</VAR></SAMP>'
1966
<DD>Indent braces of a struct, union or enum N spaces.<BR>
1967
See section <A HREF="indent.html#SEC9">1.6 Statements</A>.
1968
<P>
1969
1970
<DT>`<SAMP>-sc</SAMP>'
1971
<DD><DT>`<SAMP>--start-left-side-of-comments</SAMP>'
1972
<DD>Put the `<SAMP>*</SAMP>' character at the left of comments.<BR>
1973
See section <A HREF="indent.html#SEC8">1.5 Comments</A>.
1974
<P>
1975
1976
<DT>`<SAMP>-sob</SAMP>'
1977
<DD><DT>`<SAMP>--swallow-optional-blank-lines</SAMP>'
1978
<DD>Swallow optional blank lines.<BR>
1979
See section <A HREF="indent.html#SEC5">1.4 Blank lines</A>.
1980
<P>
1981
1982
<DT>`<SAMP>-ss</SAMP>'
1983
<DD><DT>`<SAMP>--space-special-semicolon</SAMP>'
1984
<DD>On one-line <CODE>for</CODE> and <CODE>while</CODE> statments,
1985
force a blank before the semicolon.<BR>
1986
See section <A HREF="indent.html#SEC9">1.6 Statements</A>.
1987
<P>
1988
1989
<DT>`<SAMP>-st</SAMP>'
1990
<DD><DT>`<SAMP>--standard-output</SAMP>'
1991
<DD>Write to standard output.<BR>
1992
See section <A HREF="indent.html#SEC2">1.1 Invoking <CODE>indent</CODE></A>.
1993
<P>
1994
1995
<DT>`<SAMP>-T</SAMP>'
1996
<DD>Tell <CODE>indent</CODE> the name of typenames.<BR>
1997
See section <A HREF="indent.html#SEC10">1.7 Declarations</A>.
1998
<P>
1999
2000
<DT>`<SAMP>-ts<VAR>n</VAR></SAMP>'
2001
<DD><DT>`<SAMP>--tab-size<VAR>n</VAR></SAMP>'
2002
<DD>Set tab size to <VAR>n</VAR> spaces.<BR>
2003
See section <A HREF="indent.html#SEC11">1.8 Indentation</A>.
2004
<P>
2005
2006
<DT>`<SAMP>-ut</SAMP>'
2007
<DD><DT>`<SAMP>--use-tabs</SAMP>'
2008
<DD>Use tabs. This is the default.<BR>
2009
See section <A HREF="indent.html#SEC11">1.8 Indentation</A>.
2010
<P>
2011
2012
<DT>`<SAMP>-v</SAMP>'
2013
<DD><DT>`<SAMP>--verbose</SAMP>'
2014
<DD>Enable verbose mode.<BR>
2015
See section <A HREF="indent.html#SEC14">1.11 Miscellaneous options</A>.
2016
<P>
2017
2018
<DT>`<SAMP>-version</SAMP>'
2019
<DD>Output the version number of <CODE>indent</CODE>.<BR>
2020
See section <A HREF="indent.html#SEC14">1.11 Miscellaneous options</A>.
2021
</DL>
2022
<P>
2023
2024
<A NAME="SEC18"></A>
2025
<H3> Options' Cross Key </H3>
2026
<!--docid::SEC18::-->
2027
<P>
2028
2029
Here is a list of options alphabetized by long option, to help you find
2030
the corresponding short option.
2031
</P><P>
2032
2033
<TABLE><tr><td> </td><td class=example><pre>--blank-lines-after-commas -bc
2034
--blank-lines-after-declarations -bad
2035
--blank-lines-after-procedures -bap
2036
--blank-lines-before-block-comments -bbb
2037
--braces-after-if-line -bl
2038
--brace-indent -bli
2039
--braces-after-struct-decl-line -bls
2040
--braces-on-if-line -br
2041
--braces-on-struct-decl-line -brs
2042
--break-after-boolean-operator -nbbo
2043
--break-before-boolean-operator -bbo
2044
--break-function-decl-args -bfda
2045
--case-indentation -cli<VAR>n</VAR>
2046
--case-brace-indentation -cbi<VAR>n</VAR>
2047
--comment-delimiters-on-blank-lines -cdb
2048
--comment-indentation -c<VAR>n</VAR>
2049
--continuation-indentation -ci<VAR>n</VAR>
2050
--continue-at-parentheses -lp
2051
--cuddle-do-while -cdw
2052
--cuddle-else -ce
2053
--declaration-comment-column -cd<VAR>n</VAR>
2054
--declaration-indentation -di<VAR>n</VAR>
2055
--dont-break-function-decl-args -nbfda
2056
--dont-break-procedure-type -npsl
2057
--dont-cuddle-do-while -ncdw
2058
--dont-cuddle-else -nce
2059
--dont-format-comments -nfca
2060
--dont-format-first-column-comments -nfc1
2061
--dont-line-up-parentheses -nlp
2062
--dont-space-special-semicolon -nss
2063
--dont-star-comments -nsc
2064
--else-endif-column -cp<VAR>n</VAR>
2065
--format-all-comments -fca
2066
--format-first-column-comments -fc1
2067
--gnu-style -gnu
2068
--honour-newlines -hnl
2069
--ignore-newlines -nhnl
2070
--ignore-profile -npro
2071
--indent-level -i<VAR>n</VAR>
2072
--k-and-r-style -kr
2073
--leave-optional-blank-lines -nsob
2074
--leave-preprocessor-space -lps
2075
--line-comments-indentation -d<VAR>n</VAR>
2076
--line-length -l<VAR>n</VAR>
2077
--no-blank-lines-after-commas -nbc
2078
--no-blank-lines-after-declarations -nbad
2079
--no-blank-lines-after-procedures -nbap
2080
--no-blank-lines-before-block-comments -nbbb
2081
--no-comment-delimiters-on-blank-lines -ncdb
2082
--no-space-after-casts -ncs
2083
--no-parameter-indentation -nip
2084
--no-space-after-for -nsaf
2085
--no-space-after-function-call-names -npcs
2086
--no-space-after-if -nsai
2087
--no-space-after-parentheses -nprs
2088
--no-space-after-while -nsaw
2089
--no-tabs -nut
2090
--no-verbosity -nv
2091
--original -orig
2092
--parameter-indentation -ip<VAR>n</VAR>
2093
--paren-indentation -pi<VAR>n</VAR>
2094
--preserve-mtime -pmt
2095
--procnames-start-lines -psl
2096
--space-after-cast -cs
2097
--space-after-for -saf
2098
--space-after-if -sai
2099
--space-after-parentheses -prs
2100
--space-after-procedure-calls -pcs
2101
--space-after-while -saw
2102
--space-special-semicolon -ss
2103
--standard-output -st
2104
--start-left-side-of-comments -sc
2105
--struct-brace-indentation -sbi<VAR>n</VAR>
2106
--swallow-optional-blank-lines -sob
2107
--tab-size -ts<VAR>n</VAR>
2108
--use-tabs -ut
2109
--verbose -v
2110
</pre></td></tr></table></P><P>
2111
2112
<A NAME="Index"></A>
2113
<HR SIZE="6">
2114
<A NAME="SEC19"></A>
2115
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
2116
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC17"> < </A>]</TD>
2117
<TD VALIGN="MIDDLE" ALIGN="LEFT">[ > ]</TD>
2118
<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC17"> << </A>]</TD>
2119
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC_Top"> Up </A>]</TD>
2120
<TD VALIGN="MIDDLE" ALIGN="LEFT">[ >> ]</TD>
2121
<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC_Top">Top</A>]</TD>
2122
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC_Contents">Contents</A>]</TD>
2123
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC19">Index</A>]</TD>
2124
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC_About"> ? </A>]</TD>
2125
</TR></TABLE>
2126
<H1> Index </H1>
2127
<!--docid::SEC19::-->
2128
<P>
2129
2130
<table><tr><th valign=top>Jump to: </th><td><A HREF="indent.html#ky_-" style="text-decoration:none"><b>-</b></A>
2131
2132
<A HREF="indent.html#ky_." style="text-decoration:none"><b>.</b></A>
2133
2134
<BR>
2135
<A HREF="indent.html#ky_B" style="text-decoration:none"><b>B</b></A>
2136
2137
<A HREF="indent.html#ky_C" style="text-decoration:none"><b>C</b></A>
2138
2139
<A HREF="indent.html#ky_E" style="text-decoration:none"><b>E</b></A>
2140
2141
<A HREF="indent.html#ky_G" style="text-decoration:none"><b>G</b></A>
2142
2143
<A HREF="indent.html#ky_I" style="text-decoration:none"><b>I</b></A>
2144
2145
<A HREF="indent.html#ky_K" style="text-decoration:none"><b>K</b></A>
2146
2147
<A HREF="indent.html#ky_L" style="text-decoration:none"><b>L</b></A>
2148
2149
<A HREF="indent.html#ky_O" style="text-decoration:none"><b>O</b></A>
2150
2151
<A HREF="indent.html#ky_S" style="text-decoration:none"><b>S</b></A>
2152
2153
<A HREF="indent.html#ky_T" style="text-decoration:none"><b>T</b></A>
2154
2155
<A HREF="indent.html#ky_U" style="text-decoration:none"><b>U</b></A>
2156
2157
</td></tr></table><br><P></P>
2158
<TABLE border=0>
2159
<TR><TD></TD><TH ALIGN=LEFT>Index Entry</TH><TH ALIGN=LEFT> Section</TH></TR>
2160
<TR><TD COLSPAN=3> <HR></TD></TR>
2161
<TR><TH><A NAME="ky_-"></A>-</TH><TD></TD><TD></TD></TR>
2162
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX95"><CODE>--blank-after-sizeof</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC9">1.6 Statements</A></TD></TR>
2163
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX113"><CODE>--blank-lines-after-commas</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC10">1.7 Declarations</A></TD></TR>
2164
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX33"><CODE>--blank-lines-after-declarations</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC6">1.4.1 --blank-lines-after-declarations</A></TD></TR>
2165
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX37"><CODE>--blank-lines-after-procedures</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC7">1.4.2 --blank-lines-after-procedures</A></TD></TR>
2166
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX25"><CODE>--blank-lines-before-block-comments</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC5">1.4 Blank lines</A></TD></TR>
2167
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX69"><CODE>--brace-indent<VAR>n</VAR></CODE></A></TD><TD valign=top><A HREF="indent.html#SEC9">1.6 Statements</A></TD></TR>
2168
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX67"><CODE>--braces-after-if-line</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC9">1.6 Statements</A></TD></TR>
2169
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX65"><CODE>--braces-on-if-line</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC9">1.6 Statements</A></TD></TR>
2170
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX151"><CODE>--break-after-boolean-operator</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC12">1.9 Breaking long lines</A></TD></TR>
2171
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX149"><CODE>--break-before-boolean-operator</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC12">1.9 Breaking long lines</A></TD></TR>
2172
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX117"><CODE>--break-function-decl-args</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC10">1.7 Declarations</A></TD></TR>
2173
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX81"><CODE>--case-brace-indentation<VAR>n</VAR></CODE></A></TD><TD valign=top><A HREF="indent.html#SEC9">1.6 Statements</A></TD></TR>
2174
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX79"><CODE>--case-indentation<VAR>n</VAR></CODE></A></TD><TD valign=top><A HREF="indent.html#SEC9">1.6 Statements</A></TD></TR>
2175
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX57"><CODE>--comment-delimiters-on-blank-lines</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC8">1.5 Comments</A></TD></TR>
2176
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX51"><CODE>--comment-indentation<VAR>n</VAR></CODE></A></TD><TD valign=top><A HREF="indent.html#SEC8">1.5 Comments</A></TD></TR>
2177
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX131"><CODE>--continuation-indentation<VAR>n</VAR></CODE></A></TD><TD valign=top><A HREF="indent.html#SEC11">1.8 Indentation</A></TD></TR>
2178
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX133"><CODE>--continue-at-parentheses</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC11">1.8 Indentation</A></TD></TR>
2179
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX75"><CODE>--cuddle-do-while</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC9">1.6 Statements</A></TD></TR>
2180
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX71"><CODE>--cuddle-else</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC9">1.6 Statements</A></TD></TR>
2181
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX53"><CODE>--declaration-comment-column<VAR>n</VAR></CODE></A></TD><TD valign=top><A HREF="indent.html#SEC8">1.5 Comments</A></TD></TR>
2182
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX111"><CODE>--declaration-indentation<VAR>n</VAR></CODE></A></TD><TD valign=top><A HREF="indent.html#SEC10">1.7 Declarations</A></TD></TR>
2183
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX119"><CODE>--dont-break-function-decl-args</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC10">1.7 Declarations</A></TD></TR>
2184
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX123"><CODE>--dont-break-procedure-type</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC10">1.7 Declarations</A></TD></TR>
2185
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX77"><CODE>--dont-cuddle-do-while</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC9">1.6 Statements</A></TD></TR>
2186
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX73"><CODE>--dont-cuddle-else</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC9">1.6 Statements</A></TD></TR>
2187
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX43"><CODE>--dont-format-comments</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC8">1.5 Comments</A></TD></TR>
2188
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX47"><CODE>--dont-format-first-column-comments</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC8">1.5 Comments</A></TD></TR>
2189
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX135"><CODE>--dont-line-up-parentheses</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC11">1.8 Indentation</A></TD></TR>
2190
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX85"><CODE>--dont-space-special-semicolon</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC9">1.6 Statements</A></TD></TR>
2191
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX63"><CODE>--dont-star-comments</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC8">1.5 Comments</A></TD></TR>
2192
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX55"><CODE>--else-endif-column<VAR>n</VAR></CODE></A></TD><TD valign=top><A HREF="indent.html#SEC8">1.5 Comments</A></TD></TR>
2193
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX41"><CODE>--format-all-comments</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC8">1.5 Comments</A></TD></TR>
2194
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX45"><CODE>--format-first-column-comments</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC8">1.5 Comments</A></TD></TR>
2195
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX16"><CODE>--gnu-style</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC4">1.3 Common styles</A></TD></TR>
2196
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX153"><CODE>--honour-newlines</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC12">1.9 Breaking long lines</A></TD></TR>
2197
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX155"><CODE>--ignore-newlines</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC12">1.9 Breaking long lines</A></TD></TR>
2198
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX12"><CODE>--ignore-profile</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC2">1.1 Invoking <CODE>indent</CODE></A></TD></TR>
2199
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX129"><CODE>--indent-level<VAR>n</VAR></CODE></A></TD><TD valign=top><A HREF="indent.html#SEC11">1.8 Indentation</A></TD></TR>
2200
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX19"><CODE>--k-and-r-style</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC4">1.3 Common styles</A></TD></TR>
2201
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX31"><CODE>--leave-optional-blank-lines</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC5">1.4 Blank lines</A></TD></TR>
2202
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX143"><CODE>--leave-preprocessor-space</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC11">1.8 Indentation</A></TD></TR>
2203
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX49"><CODE>--line-comments-indentation<VAR>n</VAR></CODE></A></TD><TD valign=top><A HREF="indent.html#SEC8">1.5 Comments</A></TD></TR>
2204
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX147"><CODE>--line-length<VAR>n</VAR></CODE></A></TD><TD valign=top><A HREF="indent.html#SEC12">1.9 Breaking long lines</A></TD></TR>
2205
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX115"><CODE>--no-blank-lines-after-commas</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC10">1.7 Declarations</A></TD></TR>
2206
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX35"><CODE>--no-blank-lines-after-declarations</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC6">1.4.1 --blank-lines-after-declarations</A></TD></TR>
2207
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX39"><CODE>--no-blank-lines-after-procedures</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC7">1.4.2 --blank-lines-after-procedures</A></TD></TR>
2208
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX27"><CODE>--no-blank-lines-before-block-comments</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC5">1.4 Blank lines</A></TD></TR>
2209
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX59"><CODE>--no-comment-delimiters-on-blank-lines</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC8">1.5 Comments</A></TD></TR>
2210
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX141"><CODE>--no-parameter-indentation</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC11">1.8 Indentation</A></TD></TR>
2211
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX93"><CODE>--no-space-after-casts</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC9">1.6 Statements</A></TD></TR>
2212
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX99"><CODE>--no-space-after-for</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC9">1.6 Statements</A></TD></TR>
2213
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX89"><CODE>--no-space-after-function-call-names</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC9">1.6 Statements</A></TD></TR>
2214
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX103"><CODE>--no-space-after-if</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC9">1.6 Statements</A></TD></TR>
2215
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX107"><CODE>--no-space-after-while</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC9">1.6 Statements</A></TD></TR>
2216
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX160"><CODE>--no-verbosity</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC14">1.11 Miscellaneous options</A></TD></TR>
2217
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX23"><CODE>--original</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC4">1.3 Common styles</A></TD></TR>
2218
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX3"><CODE>--output-file</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC2">1.1 Invoking <CODE>indent</CODE></A></TD></TR>
2219
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX139"><CODE>--parameter-indentation<VAR>n</VAR></CODE></A></TD><TD valign=top><A HREF="indent.html#SEC11">1.8 Indentation</A></TD></TR>
2220
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX162"><CODE>--preserve-mtime</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC14">1.11 Miscellaneous options</A></TD></TR>
2221
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX121"><CODE>--procnames-start-lines</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC10">1.7 Declarations</A></TD></TR>
2222
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX145"><CODE>--remove-preprocessor-space</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC11">1.8 Indentation</A></TD></TR>
2223
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX91"><CODE>--space-after-cast</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC9">1.6 Statements</A></TD></TR>
2224
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX97"><CODE>--space-after-for</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC9">1.6 Statements</A></TD></TR>
2225
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX101"><CODE>--space-after-if</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC9">1.6 Statements</A></TD></TR>
2226
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX109"><CODE>--space-after-parentheses</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC9">1.6 Statements</A></TD></TR>
2227
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX87"><CODE>--space-after-procedure-calls</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC9">1.6 Statements</A></TD></TR>
2228
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX105"><CODE>--space-after-while</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC9">1.6 Statements</A></TD></TR>
2229
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX83"><CODE>--space-special-semicolon</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC9">1.6 Statements</A></TD></TR>
2230
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX6"><CODE>--standard-output</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC2">1.1 Invoking <CODE>indent</CODE></A></TD></TR>
2231
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX61"><CODE>--star-left-side-of-comments</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC8">1.5 Comments</A></TD></TR>
2232
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX29"><CODE>--swallow-optional-blank-lines</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC5">1.4 Blank lines</A></TD></TR>
2233
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX137"><CODE>--tab-size<VAR>n</VAR></CODE></A></TD><TD valign=top><A HREF="indent.html#SEC11">1.8 Indentation</A></TD></TR>
2234
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX158"><CODE>--verbose</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC14">1.11 Miscellaneous options</A></TD></TR>
2235
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX32"><CODE>-bad</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC6">1.4.1 --blank-lines-after-declarations</A></TD></TR>
2236
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX36"><CODE>-bap</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC7">1.4.2 --blank-lines-after-procedures</A></TD></TR>
2237
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX24"><CODE>-bbb</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC5">1.4 Blank lines</A></TD></TR>
2238
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX148"><CODE>-bbo</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC12">1.9 Breaking long lines</A></TD></TR>
2239
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX112"><CODE>-bc</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC10">1.7 Declarations</A></TD></TR>
2240
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX116"><CODE>-bfda</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC10">1.7 Declarations</A></TD></TR>
2241
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX66"><CODE>-bl</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC9">1.6 Statements</A></TD></TR>
2242
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX68"><CODE>-bli<VAR>n</VAR></CODE></A></TD><TD valign=top><A HREF="indent.html#SEC9">1.6 Statements</A></TD></TR>
2243
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX64"><CODE>-br</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC9">1.6 Statements</A></TD></TR>
2244
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX94"><CODE>-bs</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC9">1.6 Statements</A></TD></TR>
2245
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX80"><CODE>-cbi<VAR>n</VAR></CODE></A></TD><TD valign=top><A HREF="indent.html#SEC9">1.6 Statements</A></TD></TR>
2246
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX56"><CODE>-cdb</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC8">1.5 Comments</A></TD></TR>
2247
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX52"><CODE>-cd<VAR>n</VAR></CODE></A></TD><TD valign=top><A HREF="indent.html#SEC8">1.5 Comments</A></TD></TR>
2248
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX74"><CODE>-cdw</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC9">1.6 Statements</A></TD></TR>
2249
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX70"><CODE>-ce</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC9">1.6 Statements</A></TD></TR>
2250
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX130"><CODE>-ci<VAR>n</VAR></CODE></A></TD><TD valign=top><A HREF="indent.html#SEC11">1.8 Indentation</A></TD></TR>
2251
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX78"><CODE>-cli<VAR>n</VAR></CODE></A></TD><TD valign=top><A HREF="indent.html#SEC9">1.6 Statements</A></TD></TR>
2252
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX50"><CODE>-c<VAR>n</VAR></CODE></A></TD><TD valign=top><A HREF="indent.html#SEC8">1.5 Comments</A></TD></TR>
2253
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX54"><CODE>-cp<VAR>n</VAR></CODE></A></TD><TD valign=top><A HREF="indent.html#SEC8">1.5 Comments</A></TD></TR>
2254
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX90"><CODE>-cs</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC9">1.6 Statements</A></TD></TR>
2255
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX72"><CODE>-dce</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC9">1.6 Statements</A></TD></TR>
2256
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX110"><CODE>-di<VAR>n</VAR></CODE></A></TD><TD valign=top><A HREF="indent.html#SEC10">1.7 Declarations</A></TD></TR>
2257
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX48"><CODE>-d<VAR>n</VAR></CODE></A></TD><TD valign=top><A HREF="indent.html#SEC8">1.5 Comments</A></TD></TR>
2258
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX44"><CODE>-fc1</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC8">1.5 Comments</A></TD></TR>
2259
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX40"><CODE>-fca</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC8">1.5 Comments</A></TD></TR>
2260
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX15"><CODE>-gnu</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC4">1.3 Common styles</A></TD></TR>
2261
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX152"><CODE>-hnl</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC12">1.9 Breaking long lines</A></TD></TR>
2262
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX128"><CODE>-i<VAR>n</VAR></CODE></A></TD><TD valign=top><A HREF="indent.html#SEC11">1.8 Indentation</A></TD></TR>
2263
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX138"><CODE>-ip<VAR>n</VAR></CODE></A></TD><TD valign=top><A HREF="indent.html#SEC11">1.8 Indentation</A></TD></TR>
2264
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX18"><CODE>-kr</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC4">1.3 Common styles</A></TD></TR>
2265
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX146"><CODE>-l<VAR>n</VAR></CODE></A></TD><TD valign=top><A HREF="indent.html#SEC12">1.9 Breaking long lines</A></TD></TR>
2266
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX132"><CODE>-lp</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC11">1.8 Indentation</A></TD></TR>
2267
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX142"><CODE>-lps</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC11">1.8 Indentation</A></TD></TR>
2268
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX34"><CODE>-nbad</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC6">1.4.1 --blank-lines-after-declarations</A></TD></TR>
2269
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX38"><CODE>-nbap</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC7">1.4.2 --blank-lines-after-procedures</A></TD></TR>
2270
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX26"><CODE>-nbbb</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC5">1.4 Blank lines</A></TD></TR>
2271
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX150"><CODE>-nbbo</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC12">1.9 Breaking long lines</A></TD></TR>
2272
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX114"><CODE>-nbc</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC10">1.7 Declarations</A></TD></TR>
2273
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX118"><CODE>-nbfda</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC10">1.7 Declarations</A></TD></TR>
2274
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX58"><CODE>-ncdb</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC8">1.5 Comments</A></TD></TR>
2275
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX76"><CODE>-ncdw</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC9">1.6 Statements</A></TD></TR>
2276
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX92"><CODE>-ncs</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC9">1.6 Statements</A></TD></TR>
2277
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX46"><CODE>-nfc1</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC8">1.5 Comments</A></TD></TR>
2278
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX42"><CODE>-nfca</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC8">1.5 Comments</A></TD></TR>
2279
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX154"><CODE>-nhnl</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC12">1.9 Breaking long lines</A></TD></TR>
2280
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX140"><CODE>-nip</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC11">1.8 Indentation</A></TD></TR>
2281
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX134"><CODE>-nlp</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC11">1.8 Indentation</A></TD></TR>
2282
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX144"><CODE>-nlps</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC11">1.8 Indentation</A></TD></TR>
2283
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX88"><CODE>-npcs</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC9">1.6 Statements</A></TD></TR>
2284
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX163"><CODE>-npmt</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC14">1.11 Miscellaneous options</A></TD></TR>
2285
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX11"><CODE>-npro</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC2">1.1 Invoking <CODE>indent</CODE></A></TD></TR>
2286
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX122"><CODE>-npsl</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC10">1.7 Declarations</A></TD></TR>
2287
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX98"><CODE>-nsaf</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC9">1.6 Statements</A></TD></TR>
2288
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX102"><CODE>-nsai</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC9">1.6 Statements</A></TD></TR>
2289
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX106"><CODE>-nsaw</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC9">1.6 Statements</A></TD></TR>
2290
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX62"><CODE>-nsc</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC8">1.5 Comments</A></TD></TR>
2291
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX30"><CODE>-nsob</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC5">1.4 Blank lines</A></TD></TR>
2292
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX84"><CODE>-nss</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC9">1.6 Statements</A></TD></TR>
2293
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX159"><CODE>-nv</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC14">1.11 Miscellaneous options</A></TD></TR>
2294
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX2"><CODE>-o</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC2">1.1 Invoking <CODE>indent</CODE></A></TD></TR>
2295
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX22"><CODE>-orig</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC4">1.3 Common styles</A></TD></TR>
2296
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX86"><CODE>-pcs</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC9">1.6 Statements</A></TD></TR>
2297
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX161"><CODE>-pmt</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC14">1.11 Miscellaneous options</A></TD></TR>
2298
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX108"><CODE>-prs</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC9">1.6 Statements</A></TD></TR>
2299
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX120"><CODE>-psl</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC10">1.7 Declarations</A></TD></TR>
2300
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX96"><CODE>-saf</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC9">1.6 Statements</A></TD></TR>
2301
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX100"><CODE>-sai</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC9">1.6 Statements</A></TD></TR>
2302
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX104"><CODE>-saw</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC9">1.6 Statements</A></TD></TR>
2303
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX60"><CODE>-sc</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC8">1.5 Comments</A></TD></TR>
2304
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX28"><CODE>-sob</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC5">1.4 Blank lines</A></TD></TR>
2305
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX82"><CODE>-ss</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC9">1.6 Statements</A></TD></TR>
2306
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX5"><CODE>-st</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC2">1.1 Invoking <CODE>indent</CODE></A></TD></TR>
2307
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX125"><CODE>-T</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC10">1.7 Declarations</A></TD></TR>
2308
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX136"><CODE>-ts<VAR>n</VAR></CODE></A></TD><TD valign=top><A HREF="indent.html#SEC11">1.8 Indentation</A></TD></TR>
2309
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX157"><CODE>-v</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC14">1.11 Miscellaneous options</A></TD></TR>
2310
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX156"><CODE>-version</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC14">1.11 Miscellaneous options</A></TD></TR>
2311
<TR><TD COLSPAN=3> <HR></TD></TR>
2312
<TR><TH><A NAME="ky_."></A>.</TH><TD></TD><TD></TD></TR>
2313
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX9">`<TT>.indent.pro</TT>' file</A></TD><TD valign=top><A HREF="indent.html#SEC2">1.1 Invoking <CODE>indent</CODE></A></TD></TR>
2314
<TR><TD COLSPAN=3> <HR></TD></TR>
2315
<TR><TH><A NAME="ky_B"></A>B</TH><TD></TD><TD></TD></TR>
2316
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX13">backup files</A></TD><TD valign=top><A HREF="indent.html#SEC3">1.2 Backup Files</A></TD></TR>
2317
<TR><TD></TD><TD valign=top><A HREF="indent.html#SEC2">Beginning <CODE>indent</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC2">1.1 Invoking <CODE>indent</CODE></A></TD></TR>
2318
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX20">Berkeley style</A></TD><TD valign=top><A HREF="indent.html#SEC4">1.3 Common styles</A></TD></TR>
2319
<TR><TD></TD><TD valign=top><A HREF="indent.html#SEC5">Blank lines</A></TD><TD valign=top><A HREF="indent.html#SEC5">1.4 Blank lines</A></TD></TR>
2320
<TR><TD COLSPAN=3> <HR></TD></TR>
2321
<TR><TH><A NAME="ky_C"></A>C</TH><TD></TD><TD></TD></TR>
2322
<TR><TD></TD><TD valign=top><A HREF="indent.html#SEC8">Comments</A></TD><TD valign=top><A HREF="indent.html#SEC8">1.5 Comments</A></TD></TR>
2323
<TR><TD COLSPAN=3> <HR></TD></TR>
2324
<TR><TH><A NAME="ky_E"></A>E</TH><TD></TD><TD></TD></TR>
2325
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX124"><CODE>etags</CODE> requires `<SAMP>-psl</SAMP>'</A></TD><TD valign=top><A HREF="indent.html#SEC10">1.7 Declarations</A></TD></TR>
2326
<TR><TD COLSPAN=3> <HR></TD></TR>
2327
<TR><TH><A NAME="ky_G"></A>G</TH><TD></TD><TD></TD></TR>
2328
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX14">GNU style</A></TD><TD valign=top><A HREF="indent.html#SEC4">1.3 Common styles</A></TD></TR>
2329
<TR><TD COLSPAN=3> <HR></TD></TR>
2330
<TR><TH><A NAME="ky_I"></A>I</TH><TD></TD><TD></TD></TR>
2331
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX10">Initialization file</A></TD><TD valign=top><A HREF="indent.html#SEC2">1.1 Invoking <CODE>indent</CODE></A></TD></TR>
2332
<TR><TD></TD><TD valign=top><A HREF="indent.html#SEC2">Invoking <CODE>indent</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC2">1.1 Invoking <CODE>indent</CODE></A></TD></TR>
2333
<TR><TD COLSPAN=3> <HR></TD></TR>
2334
<TR><TH><A NAME="ky_K"></A>K</TH><TD></TD><TD></TD></TR>
2335
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX17">Kernighan & Ritchie style</A></TD><TD valign=top><A HREF="indent.html#SEC4">1.3 Common styles</A></TD></TR>
2336
<TR><TD COLSPAN=3> <HR></TD></TR>
2337
<TR><TH><A NAME="ky_L"></A>L</TH><TD></TD><TD></TD></TR>
2338
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX8">Long options, use of</A></TD><TD valign=top><A HREF="indent.html#SEC2">1.1 Invoking <CODE>indent</CODE></A></TD></TR>
2339
<TR><TD COLSPAN=3> <HR></TD></TR>
2340
<TR><TH><A NAME="ky_O"></A>O</TH><TD></TD><TD></TD></TR>
2341
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX21">Original Berkeley style</A></TD><TD valign=top><A HREF="indent.html#SEC4">1.3 Common styles</A></TD></TR>
2342
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX1">Output File Specification</A></TD><TD valign=top><A HREF="indent.html#SEC2">1.1 Invoking <CODE>indent</CODE></A></TD></TR>
2343
<TR><TD COLSPAN=3> <HR></TD></TR>
2344
<TR><TH><A NAME="ky_S"></A>S</TH><TD></TD><TD></TD></TR>
2345
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX4">Standard Output</A></TD><TD valign=top><A HREF="indent.html#SEC2">1.1 Invoking <CODE>indent</CODE></A></TD></TR>
2346
<TR><TD></TD><TD valign=top><A HREF="indent.html#SEC2">Starting <CODE>indent</CODE></A></TD><TD valign=top><A HREF="indent.html#SEC2">1.1 Invoking <CODE>indent</CODE></A></TD></TR>
2347
<TR><TD COLSPAN=3> <HR></TD></TR>
2348
<TR><TH><A NAME="ky_T"></A>T</TH><TD></TD><TD></TD></TR>
2349
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX127">typedef</A></TD><TD valign=top><A HREF="indent.html#SEC10">1.7 Declarations</A></TD></TR>
2350
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX126">Typenames</A></TD><TD valign=top><A HREF="indent.html#SEC10">1.7 Declarations</A></TD></TR>
2351
<TR><TD COLSPAN=3> <HR></TD></TR>
2352
<TR><TH><A NAME="ky_U"></A>U</TH><TD></TD><TD></TD></TR>
2353
<TR><TD></TD><TD valign=top><A HREF="indent.html#IDX7">Using Standard Input</A></TD><TD valign=top><A HREF="indent.html#SEC2">1.1 Invoking <CODE>indent</CODE></A></TD></TR>
2354
<TR><TD COLSPAN=3> <HR></TD></TR>
2355
</TABLE><P></P><table><tr><th valign=top>Jump to: </th><td><A HREF="indent.html#ky_-" style="text-decoration:none"><b>-</b></A>
2356
2357
<A HREF="indent.html#ky_." style="text-decoration:none"><b>.</b></A>
2358
2359
<BR>
2360
<A HREF="indent.html#ky_B" style="text-decoration:none"><b>B</b></A>
2361
2362
<A HREF="indent.html#ky_C" style="text-decoration:none"><b>C</b></A>
2363
2364
<A HREF="indent.html#ky_E" style="text-decoration:none"><b>E</b></A>
2365
2366
<A HREF="indent.html#ky_G" style="text-decoration:none"><b>G</b></A>
2367
2368
<A HREF="indent.html#ky_I" style="text-decoration:none"><b>I</b></A>
2369
2370
<A HREF="indent.html#ky_K" style="text-decoration:none"><b>K</b></A>
2371
2372
<A HREF="indent.html#ky_L" style="text-decoration:none"><b>L</b></A>
2373
2374
<A HREF="indent.html#ky_O" style="text-decoration:none"><b>O</b></A>
2375
2376
<A HREF="indent.html#ky_S" style="text-decoration:none"><b>S</b></A>
2377
2378
<A HREF="indent.html#ky_T" style="text-decoration:none"><b>T</b></A>
2379
2380
<A HREF="indent.html#ky_U" style="text-decoration:none"><b>U</b></A>
2381
2382
</td></tr></table><br></P><P>
2383
2384
<HR SIZE="6">
2385
<A NAME="indent.html"></A>
2386
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
2387
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC_Top">Top</A>]</TD>
2388
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC_Contents">Contents</A>]</TD>
2389
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC19">Index</A>]</TD>
2390
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC_About"> ? </A>]</TD>
2391
</TR></TABLE>
2392
<H1>Footnotes</H1>
2393
<H3><A NAME="FOOT1" HREF="indent.html#DOCF1">(1)</A></H3>
2394
<P> `<SAMP>+</SAMP>' is being superseded by `<SAMP>--</SAMP>' to
2395
maintain consistency with the POSIX standard.
2396
<HR SIZE=1>
2397
<A NAME="SEC_Contents"></A>
2398
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
2399
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC_Top">Top</A>]</TD>
2400
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC_Contents">Contents</A>]</TD>
2401
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC19">Index</A>]</TD>
2402
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC_About"> ? </A>]</TD>
2403
</TR></TABLE>
2404
<H1>Table of Contents</H1>
2405
<BLOCKQUOTE>
2406
<A NAME="TOC1" HREF="indent.html#SEC1">1. The <CODE>indent</CODE> Program</A>
2407
<BR>
2408
<BLOCKQUOTE>
2409
<A NAME="TOC2" HREF="indent.html#SEC2">1.1 Invoking <CODE>indent</CODE></A>
2410
<BR>
2411
<A NAME="TOC3" HREF="indent.html#SEC3">1.2 Backup Files</A>
2412
<BR>
2413
<A NAME="TOC4" HREF="indent.html#SEC4">1.3 Common styles</A>
2414
<BR>
2415
<A NAME="TOC5" HREF="indent.html#SEC5">1.4 Blank lines</A>
2416
<BR>
2417
<BLOCKQUOTE>
2418
<A NAME="TOC6" HREF="indent.html#SEC6">1.4.1 --blank-lines-after-declarations</A>
2419
<BR>
2420
<A NAME="TOC7" HREF="indent.html#SEC7">1.4.2 --blank-lines-after-procedures</A>
2421
<BR>
2422
</BLOCKQUOTE>
2423
<A NAME="TOC8" HREF="indent.html#SEC8">1.5 Comments</A>
2424
<BR>
2425
<A NAME="TOC9" HREF="indent.html#SEC9">1.6 Statements</A>
2426
<BR>
2427
<A NAME="TOC10" HREF="indent.html#SEC10">1.7 Declarations</A>
2428
<BR>
2429
<A NAME="TOC11" HREF="indent.html#SEC11">1.8 Indentation</A>
2430
<BR>
2431
<A NAME="TOC12" HREF="indent.html#SEC12">1.9 Breaking long lines</A>
2432
<BR>
2433
<A NAME="TOC13" HREF="indent.html#SEC13">1.10 Disabling Formatting</A>
2434
<BR>
2435
<A NAME="TOC14" HREF="indent.html#SEC14">1.11 Miscellaneous options</A>
2436
<BR>
2437
<A NAME="TOC15" HREF="indent.html#SEC15">1.12 Bugs</A>
2438
<BR>
2439
<A NAME="TOC16" HREF="indent.html#SEC16">1.13 Copyright</A>
2440
<BR>
2441
</BLOCKQUOTE>
2442
<A NAME="TOC17" HREF="indent.html#SEC17">A. Option Summary</A>
2443
<BR>
2444
<A NAME="TOC19" HREF="indent.html#SEC19">Index</A>
2445
<BR>
2446
</BLOCKQUOTE>
2447
<HR SIZE=1>
2448
<A NAME="SEC_OVERVIEW"></A>
2449
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
2450
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC_Top">Top</A>]</TD>
2451
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC_Contents">Contents</A>]</TD>
2452
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC19">Index</A>]</TD>
2453
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC_About"> ? </A>]</TD>
2454
</TR></TABLE>
2455
<H1>Short Table of Contents</H1>
2456
<BLOCKQUOTE>
2457
<A NAME="TOC1" HREF="indent.html#SEC1">1. The <CODE>indent</CODE> Program</A>
2458
<BR>
2459
<A NAME="TOC17" HREF="indent.html#SEC17">A. Option Summary</A>
2460
<BR>
2461
<A NAME="TOC19" HREF="indent.html#SEC19">Index</A>
2462
<BR>
2463
2464
</BLOCKQUOTE>
2465
<HR SIZE=1>
2466
<A NAME="SEC_About"></A>
2467
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
2468
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC_Top">Top</A>]</TD>
2469
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC_Contents">Contents</A>]</TD>
2470
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC19">Index</A>]</TD>
2471
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="indent.html#SEC_About"> ? </A>]</TD>
2472
</TR></TABLE>
2473
<H1>About this document</H1>
2474
This document was generated
2475
using <A HREF="http://www.mathematik.uni-kl.de/~obachman/Texi2html
2476
"><I>texi2html</I></A>
2477
<P></P>
2478
The buttons in the navigation panels have the following meaning:
2479
<P></P>
2480
<table border = "1">
2481
<TR>
2482
<TH> Button </TH>
2483
<TH> Name </TH>
2484
<TH> Go to </TH>
2485
<TH> From 1.2.3 go to</TH>
2486
</TR>
2487
<TR>
2488
<TD ALIGN="CENTER">
2489
[ < ] </TD>
2490
<TD ALIGN="CENTER">
2491
Back
2492
</TD>
2493
<TD>
2494
previous section in reading order
2495
</TD>
2496
<TD>
2497
1.2.2
2498
</TD>
2499
</TR>
2500
<TR>
2501
<TD ALIGN="CENTER">
2502
[ > ] </TD>
2503
<TD ALIGN="CENTER">
2504
Forward
2505
</TD>
2506
<TD>
2507
next section in reading order
2508
</TD>
2509
<TD>
2510
1.2.4
2511
</TD>
2512
</TR>
2513
<TR>
2514
<TD ALIGN="CENTER">
2515
[ << ] </TD>
2516
<TD ALIGN="CENTER">
2517
FastBack
2518
</TD>
2519
<TD>
2520
previous or up-and-previous section
2521
</TD>
2522
<TD>
2523
1.1
2524
</TD>
2525
</TR>
2526
<TR>
2527
<TD ALIGN="CENTER">
2528
[ Up ] </TD>
2529
<TD ALIGN="CENTER">
2530
Up
2531
</TD>
2532
<TD>
2533
up section
2534
</TD>
2535
<TD>
2536
1.2
2537
</TD>
2538
</TR>
2539
<TR>
2540
<TD ALIGN="CENTER">
2541
[ >> ] </TD>
2542
<TD ALIGN="CENTER">
2543
FastForward
2544
</TD>
2545
<TD>
2546
next or up-and-next section
2547
</TD>
2548
<TD>
2549
1.3
2550
</TD>
2551
</TR>
2552
<TR>
2553
<TD ALIGN="CENTER">
2554
[Top] </TD>
2555
<TD ALIGN="CENTER">
2556
Top
2557
</TD>
2558
<TD>
2559
cover (top) of document
2560
</TD>
2561
<TD>
2562
2563
</TD>
2564
</TR>
2565
<TR>
2566
<TD ALIGN="CENTER">
2567
[Contents] </TD>
2568
<TD ALIGN="CENTER">
2569
Contents
2570
</TD>
2571
<TD>
2572
table of contents
2573
</TD>
2574
<TD>
2575
2576
</TD>
2577
</TR>
2578
<TR>
2579
<TD ALIGN="CENTER">
2580
[Index] </TD>
2581
<TD ALIGN="CENTER">
2582
Index
2583
</TD>
2584
<TD>
2585
concept index
2586
</TD>
2587
<TD>
2588
2589
</TD>
2590
</TR>
2591
<TR>
2592
<TD ALIGN="CENTER">
2593
[ ? ] </TD>
2594
<TD ALIGN="CENTER">
2595
About
2596
</TD>
2597
<TD>
2598
this page
2599
</TD>
2600
<TD>
2601
2602
</TD>
2603
</TR>
2604
</TABLE>
2605
<P></P>
2606
where the <STRONG> Example </STRONG> assumes that the current position
2607
is at <STRONG> Subsubsection One-Two-Three </STRONG> of a document of
2608
the following structure:
2609
<UL>
2610
<LI> 1. Section One </LI>
2611
<UL>
2612
<LI>1.1 Subsection One-One</LI>
2613
<UL>
2614
<LI> ... </LI>
2615
</UL>
2616
<LI>1.2 Subsection One-Two</LI>
2617
<UL>
2618
<LI>1.2.1 Subsubsection One-Two-One
2619
</LI><LI>1.2.2 Subsubsection One-Two-Two
2620
</LI><LI>1.2.3 Subsubsection One-Two-Three <STRONG>
2621
<== Current Position </STRONG>
2622
</LI><LI>1.2.4 Subsubsection One-Two-Four
2623
</LI></UL>
2624
<LI>1.3 Subsection One-Three</LI>
2625
<UL>
2626
<LI> ... </LI>
2627
</UL>
2628
<LI>1.4 Subsection One-Four</LI>
2629
</UL>
2630
</UL>
2631
2632
<HR SIZE=1>
2633
<BR>
2634
<FONT SIZE="-1">
2635
This document was generated
2636
by <I>david ingamells</I> on <I>December, 18 2001</I>
2637
using <A HREF="http://www.mathematik.uni-kl.de/~obachman/Texi2html
2638
"><I>texi2html</I></A>
2639
</FONT>
2640
2641
</BODY>
2642
</HTML>
Loggerhead is a web-based interface for Breezy
Version: 2.0.1