version 1.5, 1998/09/26 19:54:53 |
version 1.6, 1999/06/05 01:21:27 |
|
|
.\" |
.\" |
.Dd July 24, 1991 |
.Dd July 24, 1991 |
.Dt INDENT 1 |
.Dt INDENT 1 |
.Os BSD 4.2 |
.Os |
.Sh NAME |
.Sh NAME |
.Nm indent |
.Nm indent |
.Nd indent and format C program source |
.Nd indent and format C program source |
|
|
Enables (disables) forcing `else's to cuddle up to the immediately preceding |
Enables (disables) forcing `else's to cuddle up to the immediately preceding |
`}'. The default is |
`}'. The default is |
.Fl \&ce . |
.Fl \&ce . |
.It Fl \&ci Ns Ar n |
.It Fl \&ci Ns Ar n |
Sets the continuation indent to be |
Sets the continuation indent to be |
.Ar n . |
.Ar n . |
Continuation |
Continuation |
|
|
.Fl \&ci |
.Fl \&ci |
defaults to the same value as |
defaults to the same value as |
.Fl i . |
.Fl i . |
.It Fl cli Ns Ar n |
.It Fl cli Ns Ar n |
Causes case labels to be indented |
Causes case labels to be indented |
.Ar n |
.Ar n |
tab stops to the right of the containing |
tab stops to the right of the containing |
|
|
causes case labels to be indented half a tab stop. The |
causes case labels to be indented half a tab stop. The |
default is |
default is |
.Fl cli0 . |
.Fl cli0 . |
.It Fl d Ns Ar n |
.It Fl d Ns Ar n |
Controls the placement of comments which are not to the |
Controls the placement of comments which are not to the |
right of code. The default |
right of code. The default |
.Fl \&d\&1 |
.Fl \&d\&1 |
|
|
.Fl \&d\&0 |
.Fl \&d\&0 |
lines up these comments with the code. See the section on comment |
lines up these comments with the code. See the section on comment |
indentation below. |
indentation below. |
.It Fl \&di Ns Ar n |
.It Fl \&di Ns Ar n |
Specifies the indentation, in character positions, from a declaration keyword |
Specifies the indentation, in character positions, from a declaration keyword |
to the following identifier. The default is |
to the following identifier. The default is |
.Fl di16 . |
.Fl di16 . |
|
|
should be |
should be |
used. The default is |
used. The default is |
.Fl fc1 . |
.Fl fc1 . |
.It Fl i Ns Ar n |
.It Fl i Ns Ar n |
The number of spaces for one indentation level. The default is 8. |
The number of spaces for one indentation level. The default is 8. |
.It Fl \&ip , nip |
.It Fl \&ip , nip |
Enables (disables) the indentation of parameter declarations from the left |
Enables (disables) the indentation of parameter declarations from the left |
margin. The default is |
margin. The default is |
.Fl \&ip . |
.Fl \&ip . |
.It Fl l Ns Ar n |
.It Fl l Ns Ar n |
Maximum length of an output line. The default is 75. |
Maximum length of an output line. The default is 75. |
.It Fl \&lp , nlp |
.It Fl \&lp , nlp |
Lines up code surrounded by parenthesis in continuation lines. If a line |
Lines up code surrounded by parenthesis in continuation lines. If a line |
|
|
Causes |
Causes |
.Nm indent |
.Nm indent |
to take its input from stdin, and put its output to stdout. |
to take its input from stdin, and put its output to stdout. |
.It Fl T Ns Ar typename |
.It Fl T Ns Ar typename |
Adds |
Adds |
.Ar typename |
.Ar typename |
to the list of type keywords. Names accumulate: |
to the list of type keywords. Names accumulate: |
|
|
.Ss Comment indentation |
.Ss Comment indentation |
If a comment is on a line with code it is started in the `comment column', |
If a comment is on a line with code it is started in the `comment column', |
which is set by the |
which is set by the |
.Fl c Ns Ns Ar n |
.Fl c Ns Ns Ar n |
command line parameter. Otherwise, the comment is started at |
command line parameter. Otherwise, the comment is started at |
.Ar n |
.Ar n |
indentation levels less than where code is currently being placed, where |
indentation levels less than where code is currently being placed, where |
.Ar n |
.Ar n |
is specified by the |
is specified by the |
.Fl d Ns Ns Ar n |
.Fl d Ns Ns Ar n |
command line parameter. If the code on a line extends past the comment |
command line parameter. If the code on a line extends past the comment |
column, the comment starts further to the right, and the right margin may be |
column, the comment starts further to the right, and the right margin may be |
automatically extended in extreme cases. |
automatically extended in extreme cases. |