bug-indent
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

indent(1): fix the programm that generated this man page


From: Bjarni Ingi Gislason
Subject: indent(1): fix the programm that generated this man page
Date: Thu, 14 Sep 2023 00:27:43 +0000

The file is from Debian testing version 2.2.13-3.

  The program generating man-pages from "texinfo" files needs to be fixed.

  Generated man pages should show in a comment at the beginnig of the
file, with what program and version they were created.

.SH "DESCRIPTION"
This man page is generated from the file \fIindent.texinfo\fR.
This is Edition  of "The \fBindent\fR Manual",
for Indent Version , last updated .

-.-

The difference between the formatted outputs can be seen with:

  nroff -man <file1> > <out1>
  nroff -man <file2> > <out2>
  diff -u <out1> <out2>

and for groff, using

"printf '%s\n%s\n' '.kern 0' '.ss 12 0' | groff -man -Z - "

instead of "nroff -man"

  Add the option "-t", if the file contains a table.

  Read the output of "diff -u" with "less -R" or similar.

-.-.

  If "man" (man-db) is used to check the manual for warnings,
the following must be set:

  The option "-warnings=w"

  The environmental variable:

export MAN_KEEP_STDERR=yes (or any non-empty value)

  or

  (produce only warnings):

export MANROFFOPT="-ww -z"

export MAN_KEEP_STDERR=yes (or any non-empty value)

-.-.

Output from "mandoc -T lint indent.1":

mandoc: indent.1:1:2: WARNING: missing date, using "": TH
mandoc: indent.1:3:86: STYLE: input text line longer than 80 bytes: indent \- 
changes th...
mandoc: indent.1:3:86: STYLE: whitespace at end of input line
mandoc: indent.1:20:32: STYLE: whitespace at end of input line
mandoc: indent.1:152:45: STYLE: whitespace at end of input line
mandoc: indent.1:199:85: STYLE: input text line longer than 80 bytes: Treat 
gettext \fB_("...
mandoc: indent.1:219:45: STYLE: whitespace at end of input line
mandoc: indent.1:305:52: STYLE: whitespace at end of input line
mandoc: indent.1:321:91: STYLE: input text line longer than 80 bytes: Treat 
gettext \fB_("...
mandoc: indent.1:420:39: STYLE: whitespace at end of input line
mandoc: indent.1:430:90: STYLE: input text line longer than 80 bytes: Preserve 
access and ...
mandoc: indent.1:433:88: STYLE: input text line longer than 80 bytes: Specify 
the indentat...
mandoc: indent.1:487:50: STYLE: whitespace at end of input line
mandoc: indent.1:620:72: STYLE: whitespace at end of input line
mandoc: indent.1:621:82: STYLE: input text line longer than 80 bytes: is 
expected to name ...
mandoc: indent.1:621:82: STYLE: whitespace at end of input line
mandoc: indent.1:634:6: UNSUPP: unsupported control character: 0x8
mandoc: indent.1:747:67: STYLE: whitespace at end of input line
mandoc: indent.1:748:63: STYLE: whitespace at end of input line
mandoc: indent.1:912:71: STYLE: whitespace at end of input line
mandoc: indent.1:986:76: STYLE: whitespace at end of input line
mandoc: indent.1:987:84: STYLE: input text line longer than 80 bytes: comment 
to follow on...
mandoc: indent.1:1102:72: STYLE: whitespace at end of input line
mandoc: indent.1:1103:70: STYLE: whitespace at end of input line
mandoc: indent.1:1104:71: STYLE: whitespace at end of input line
mandoc: indent.1:1105:71: STYLE: whitespace at end of input line
mandoc: indent.1:1233:136: STYLE: input text line longer than 80 bytes: the 
procedure being ...
mandoc: indent.1:1237:79: STYLE: whitespace at end of input line
mandoc: indent.1:1239:85: STYLE: input text line longer than 80 bytes: only 
knows about the...
mandoc: indent.1:1337:74: STYLE: whitespace at end of input line
mandoc: indent.1:1338:64: STYLE: whitespace at end of input line
mandoc: indent.1:1339:74: STYLE: whitespace at end of input line
mandoc: indent.1:1340:91: STYLE: input text line longer than 80 bytes: bracket 
of the funct...
mandoc: indent.1:1344:4: STYLE: whitespace at end of input line
mandoc: indent.1:1701:77: STYLE: whitespace at end of input line
mandoc: indent.1:1705:84: STYLE: input text line longer than 80 bytes: be 
indented by to gi...
mandoc: indent.1:1736:82: STYLE: input text line longer than 80 bytes: will be 
positioned. ...
mandoc: indent.1:1736:82: STYLE: whitespace at end of input line
mandoc: indent.1:1737:80: STYLE: whitespace at end of input line
mandoc: indent.1:1738:79: STYLE: whitespace at end of input line
mandoc: indent.1:1739:84: STYLE: input text line longer than 80 bytes: The 
default setting ...
mandoc: indent.1:1875:88: STYLE: input text line longer than 80 bytes: The 
\(oq-gts\(cq opt...
mandoc: indent.1:1876:82: STYLE: input text line longer than 80 bytes: are 
treated.  The de...
mandoc: indent.1:1876:82: STYLE: whitespace at end of input line
mandoc: indent.1:1877:89: STYLE: input text line longer than 80 bytes: treat 
them as it doe...
mandoc: indent.1:1892:88: STYLE: input text line longer than 80 bytes: With the 
\(oq-gts\(c...
mandoc: indent.1:1893:86: STYLE: input text line longer than 80 bytes: it tied 
to the strin...
mandoc: indent.1:1894:88: STYLE: input text line longer than 80 bytes: a 
localized string. ...
mandoc: indent.1:1951:12: STYLE: whitespace at end of input line
mandoc: indent.1:1985:45: STYLE: whitespace at end of input line
mandoc: indent.1:2139:82: STYLE: input text line longer than 80 bytes: of the 
formatting, b...
mandoc: indent.1:2143:81: STYLE: input text line longer than 80 bytes: 3 is 
returned if for...
mandoc: indent.1:2144:83: STYLE: input text line longer than 80 bytes: which 
prevents compl...
mandoc: indent.1:2155:2: WARNING: skipping paragraph macro: br after SH
mandoc: indent.1:2161:2: WARNING: skipping paragraph macro: br after SH
mandoc: indent.1:2174:91: STYLE: input text line longer than 80 bytes: 
Copyright (C) 1989, ...

-.-.

Input file is indent.1

Remove space characters at the end of lines.

Use "git apply ... --whitespace=fix" to fix extra space issues, or use
global configuration "core.whitespace".

3:indent \- changes the appearance of a C program by inserting or deleting 
whitespace.  
20:style of writing C to another.  
152:Set indentation of comments not to the right 
219:Indent parameter types in old-style function 
305:Comments after declarations are treated the same as 
420:Insert a space between the name of the 
487:On one-line \fBfor\fR and \fBwhile\fR statements, 
620:the environment variable \fBINDENT_PROFILE\fR. If that exists its value 
621:is expected to name the file that is to be used. If the environment 
variable does 
747:The Linux style is used in the linux kernel code and drivers. Code 
748:generally has to follow the Linux coding style to be accepted. 
754:-nbad -bap -nbc -bbo -hnl -br -brs -c33 -cd33 -ncdb -ce -ci4 
912:the column at which code is currently indented.  The exception to this 
986:to suppress alignment of comments to the right of declarations, causing the 
1102:An exception to the behavior occurs when there is a comment between the 
1103:right brace and the subsequent else statement.  While the \(oq-br\(cq 
1104:option will cause a left brace to jump over the comment, the else does 
1105:not jump over the comment to cuddle because it has a strong likelihood 
1237:a cast operator and the object to be cast. The \(oq-ncs\(cq ensures that 
there 
1337:appear at one indention level deeper than the function declaration.  This 
1338:is particularly helpful for functions with long argument lists. 
1339:The option \(oq-bfde\(cq causes a newline to be forced before the closing 
1344:For 
1701:directs \fBindent\fR to leave this space unmodified. The option 
\(oq-ppi\(cq 
1736:will be positioned. If it is set to zero or a positive number, this 
indicates how 
1737:far from the left margin to indent a label.  If it is set to a negative 
number, 
1738:this indicates how far back from the current indent level to place the 
label.  
1876:are treated.  The default behavior (or the use of \(oq-ngts\(cq) causes 
indent to 
1902:      warning 
1951:completion. 
1985:option) when \fBindent\fR is turned off with 
2038:--blank-lines-after-commas                      -bc             
2039:--blank-lines-after-declarations                -bad            
2040:--blank-lines-after-procedures                  -bap            
2041:--blank-lines-before-block-comments             -bbb            
2042:--braces-after-if-line                          -bl             
2046:--braces-on-if-line                             -br             
2053:--case-indentation                              -cli\fIn\fR     
2055:--comment-delimiters-on-blank-lines             -cdb            
2056:--comment-indentation                           -c\fIn\fR       
2057:--continuation-indentation                      -ci\fIn\fR      
2058:--continue-at-parentheses                       -lp             
2060:--cuddle-else                                   -ce             
2061:--declaration-comment-column                    -cd\fIn\fR      
2062:--declaration-indentation                       -di\fIn\fR      
2065:--dont-break-procedure-type                     -npsl           
2067:--dont-cuddle-else                              -nce            
2068:--dont-format-comments                          -nfca           
2069:--dont-format-first-column-comments             -nfc1           
2070:--dont-line-up-parentheses                      -nlp            
2071:--dont-left-justify-declarations                -ndj  
2073:--dont-star-comments                            -nsc            
2076:--format-all-comments                           -fca            
2077:--format-first-column-comments                  -fc1            
2078:--gnu-style                                     -gnu            
2081:--ignore-profile                                -npro           
2082:--indent-label                                  -il\fIn\fR       
2083:--indent-level                                  -i\fIn\fR       
2084:--k-and-r-style                                 -kr             
2085:--leave-optional-blank-lines                    -nsob           
2087:--left-justify-declarations                     -dj 
2088:--line-comments-indentation                     -d\fIn\fR       
2089:--line-length                                   -l\fIn\fR       
2090:--linux-style                                   -linux             
2091:--no-blank-lines-after-commas                   -nbc            
2092:--no-blank-lines-after-declarations             -nbad           
2093:--no-blank-lines-after-procedures               -nbap           
2094:--no-blank-lines-before-block-comments          -nbbb           
2095:--no-comment-delimiters-on-blank-lines          -ncdb           
2096:--no-space-after-casts                          -ncs            
2097:--no-parameter-indentation                      -nip            
2099:--no-space-after-function-call-names            -npcs           
2104:--no-verbosity                                  -nv             
2106:--parameter-indentation                         -ip\fIn\fR      
2110:--procnames-start-lines                         -psl            
2113:--space-after-cast                              -cs             
2117:--space-after-procedure-calls                   -pcs            
2119:--space-special-semicolon                       -ss             
2121:--standard-output                               -st             
2122:--start-left-side-of-comments                   -sc             
2124:--swallow-optional-blank-lines                  -sob            
2125:--tab-size                                      -ts\fIn\fR      
2127:--verbose                                       -v              

-.-.

Change -- in x--y to \(em (em-dash), or, if an
option, to \-\-

30:.B -as\fR, \fB--align-with-spaces\fR
35:.B -bad\fR, \fB--blank-lines-after-declarations\fR
40:.B -bap\fR, \fB--blank-lines-after-procedures\fR
45:.B -bbb\fR, \fB--blank-lines-before-block-comments\fR
50:.B -bbo\fR, \fB--break-before-boolean-operator\fR
55:.B -bc\fR, \fB--blank-lines-after-commas\fR
60:.B -bl\fR, \fB--braces-after-if-line\fR
65:.B -blf\fR, \fB--braces-after-func-def-line\fR
70:.B -bli\fIn\fB\fR, \fB--brace-indent\fIn\fB\fR
75:.B -bls\fR, \fB--braces-after-struct-decl-line\fR
80:.B -br\fR, \fB--braces-on-if-line\fR
85:.B -brf\fR, \fB--braces-on-func-def-line\fR
90:.B -brs\fR, \fB--braces-on-struct-decl-line\fR
95:.B -bs\fR, \fB--Bill-Shannon\fR, \fB--blank-before-sizeof\fR
100:.B -c\fIn\fB\fR, \fB--comment-indentation\fIn\fB\fR
105:.B -cbi\fIn\fB\fR, \fB--case-brace-indentation\fIn\fB\fR
110:.B -cd\fIn\fB\fR, \fB--declaration-comment-column\fIn\fB\fR
115:.B -cdb\fR, \fB--comment-delimiters-on-blank-lines\fR
120:.B -cdw\fR, \fB--cuddle-do-while\fR
125:.B -ce\fR, \fB--cuddle-else\fR
130:.B -ci\fIn\fB\fR, \fB--continuation-indentation\fIn\fB\fR
135:.B -cli\fIn\fB\fR, \fB--case-indentation\fIn\fB\fR
140:.B -cp\fIn\fB\fR, \fB--else-endif-column\fIn\fB\fR
146:.B -cs\fR, \fB--space-after-cast\fR
151:.B -d\fIn\fB\fR, \fB--line-comments-indentation\fIn\fB\fR
157:.B -bfda\fR, \fB--break-function-decl-args\fR
162:.B -bfde\fR, \fB--break-function-decl-args-end\fR
167:.B -dj\fR, \fB--left-justify-declarations\fR
173:.B -di\fIn\fB\fR, \fB--declaration-indentation\fIn\fB\fR
178:.B -fc1\fR, \fB--format-first-column-comments\fR
183:.B -fca\fR, \fB--format-all-comments\fR
188:.B -fnc\fR, \fB--fix-nested-comments\fR
193:.B -gnu\fR, \fB--gnu-style\fR
198:.B -gts\fR, \fB--gettext-strings\fR
203:.B -hnl\fR, \fB--honour-newlines\fR
208:.B -i\fIn\fB\fR, \fB--indent-level\fIn\fB\fR
213:.B -il\fIn\fB\fR, \fB--indent-label\fIn\fB\fR
218:.B -ip\fIn\fB\fR, \fB--parameter-indentation\fIn\fB\fR
224:.B -kr\fR, \fB--k-and-r-style\fR
229:.B -l\fIn\fB\fR, \fB--line-length\fIn\fB\fR
234:.B -lc\fIn\fB\fR, \fB--comment-line-length\fIn\fB\fR
239:.B -linux\fR, \fB--linux-style\fR
244:.B -lp\fR, \fB--continue-at-parentheses\fR
249:.B -lps\fR, \fB--leave-preprocessor-space\fR
254:.B -nlps\fR, \fB--remove-preprocessor-space\fR
259:.B -nbad\fR, \fB--no-blank-lines-after-declarations\fR
264:.B -nbap\fR, \fB--no-blank-lines-after-procedures\fR
269:.B -nbbo\fR, \fB--break-after-boolean-operator\fR
274:.B -nbc\fR, \fB--no-blank-lines-after-commas\fR
279:.B -nbfda\fR, \fB--dont-break-function-decl-args\fR
284:.B -ncdb\fR, \fB--no-comment-delimiters-on-blank-lines\fR
289:.B -ncdw\fR, \fB--dont-cuddle-do-while\fR
294:.B -nce\fR, \fB--dont-cuddle-else\fR
299:.B -ncs\fR, \fB--no-space-after-casts\fR
304:.B -ndj\fIn\fB\fR, \fB--dont-left-justify-declarations\fR
310:.B -nfc1\fR, \fB--dont-format-first-column-comments\fR
315:.B -nfca\fR, \fB--dont-format-comments\fR
320:.B -ngts\fR, \fB--no-gettext-strings\fR
325:.B -nhnl\fR, \fB--ignore-newlines\fR
330:.B -nip\fR, \fB--no-parameter-indentation\fR
335:.B -nlp\fR, \fB--dont-line-up-parentheses\fR
340:.B -npcs\fR, \fB--no-space-after-function-call-names\fR
345:.B -nprs\fR, \fB--no-space-after-parentheses\fR
350:.B -npsl\fR, \fB--dont-break-procedure-type\fR
355:.B -nsaf\fR, \fB--no-space-after-for\fR
360:.B -nsai\fR, \fB--no-space-after-if\fR
365:.B -nsaw\fR, \fB--no-space-after-while\fR
370:.B -nsc\fR, \fB--dont-star-comments\fR
375:.B -nsob\fR, \fB--leave-optional-blank-lines\fR
380:.B -nss\fR, \fB--dont-space-special-semicolon\fR
386:.B -ntac\fR, \fB--dont-tab-align-comments\fR
391:.B -nut\fR, \fB--no-tabs\fR
396:.B -nv\fR, \fB--no-verbosity\fR
401:.B -orig\fR, \fB--original\fR
406:.B -npro\fR, \fB--ignore-profile\fR
411:.B -pal\fR, \fB--pointer-align-left\fR
415:.B -par\fR, \fB--pointer-align-right\fR
419:.B -pcs\fR, \fB--space-after-procedure-calls\fR
425:.B -pi\fIn\fB\fR, \fB--paren-indentation\fIn\fB\fR
429:.B -pmt\fR, \fB--preserve-mtime\fR
432:.B -ppi\fIn\fB\fR, \fB--preprocessor-indentation\fIn\fB\fR
435:.B -prs\fR, \fB--space-after-parentheses\fR
440:.B -psl\fR, \fB--procnames-start-lines\fR
445:.B -saf\fR, \fB--space-after-for\fR
450:.B -sai\fR, \fB--space-after-if\fR
455:.B -sar\fR, \fB--spaces-around-initializers\fR
460:.B -saw\fR, \fB--space-after-while\fR
465:.B -sbi\fIn\fB\fR, \fB--struct-brace-indentation\fIn\fB\fR
470:.B -sc\fR, \fB--start-left-side-of-comments\fR
475:.B -slc\fR, \fB--single-line-conditionals\fR
481:.B -sob\fR, \fB--swallow-optional-blank-lines\fR
486:.B -ss\fR, \fB--space-special-semicolon\fR
492:.B -st\fR, \fB--standard-output\fR
502:.B -ts\fIn\fB\fR, \fB--tab-size\fIn\fB\fR
507:.B -ut\fR, \fB--use-tabs\fR
512:.B -v\fR, \fB--verbose\fR
609:indent --braces-on-if-line --line-length185 test/metabolism.c
734:specifying \(oq-orig\(cq (or by specifying \(oq--original\(cq, using the
1797:With the option \(oq-l\fIn\fR\(cq, or \(oq--line-length\fIn\fR\(cq, it is
1812:with \(oq--line-length60\(cq and \(oq--ignore-newlines\(cq) makes code
1853:then using the option \(oq-hnl\(cq, or \(oq--honour-newlines\(cq,
1855:\(oq--line-length60\(cq, will cause the output not to be what is given
1873:\(oq--ignore-newlines\(cq option though.
1978:.B indent\fR does not look at the given \(oq--line-length\(cq option

-.-.

Remove space in the first column, if not indented.
Use ".in +<number>n" and ".in", ".nf" and ".fi" for an extra indention.

indent.1:582: In most of this document,
indent.1:623: and use that if found.  Finally \fBindent\fR will search
indent.1:1437: the function brace options \(oq-brf\(cq or \(oq-blf\(cq specify 
how to format the braces

-.-.

Change a HYPHEN-MINUS (code 0x55, 2D) to a minus (\-), if in front of a
name for an option.

30:.B -as\fR, \fB--align-with-spaces\fR
35:.B -bad\fR, \fB--blank-lines-after-declarations\fR
40:.B -bap\fR, \fB--blank-lines-after-procedures\fR
45:.B -bbb\fR, \fB--blank-lines-before-block-comments\fR
50:.B -bbo\fR, \fB--break-before-boolean-operator\fR
55:.B -bc\fR, \fB--blank-lines-after-commas\fR
60:.B -bl\fR, \fB--braces-after-if-line\fR
65:.B -blf\fR, \fB--braces-after-func-def-line\fR
70:.B -bli\fIn\fB\fR, \fB--brace-indent\fIn\fB\fR
75:.B -bls\fR, \fB--braces-after-struct-decl-line\fR
80:.B -br\fR, \fB--braces-on-if-line\fR
85:.B -brf\fR, \fB--braces-on-func-def-line\fR
90:.B -brs\fR, \fB--braces-on-struct-decl-line\fR
95:.B -bs\fR, \fB--Bill-Shannon\fR, \fB--blank-before-sizeof\fR
100:.B -c\fIn\fB\fR, \fB--comment-indentation\fIn\fB\fR
105:.B -cbi\fIn\fB\fR, \fB--case-brace-indentation\fIn\fB\fR
110:.B -cd\fIn\fB\fR, \fB--declaration-comment-column\fIn\fB\fR
115:.B -cdb\fR, \fB--comment-delimiters-on-blank-lines\fR
120:.B -cdw\fR, \fB--cuddle-do-while\fR
125:.B -ce\fR, \fB--cuddle-else\fR
130:.B -ci\fIn\fB\fR, \fB--continuation-indentation\fIn\fB\fR
135:.B -cli\fIn\fB\fR, \fB--case-indentation\fIn\fB\fR
140:.B -cp\fIn\fB\fR, \fB--else-endif-column\fIn\fB\fR
146:.B -cs\fR, \fB--space-after-cast\fR
151:.B -d\fIn\fB\fR, \fB--line-comments-indentation\fIn\fB\fR
157:.B -bfda\fR, \fB--break-function-decl-args\fR
162:.B -bfde\fR, \fB--break-function-decl-args-end\fR
167:.B -dj\fR, \fB--left-justify-declarations\fR
168:If -cd 0 is used then comments after declarations are left justified
173:.B -di\fIn\fB\fR, \fB--declaration-indentation\fIn\fB\fR
178:.B -fc1\fR, \fB--format-first-column-comments\fR
183:.B -fca\fR, \fB--format-all-comments\fR
188:.B -fnc\fR, \fB--fix-nested-comments\fR
193:.B -gnu\fR, \fB--gnu-style\fR
198:.B -gts\fR, \fB--gettext-strings\fR
203:.B -hnl\fR, \fB--honour-newlines\fR
208:.B -i\fIn\fB\fR, \fB--indent-level\fIn\fB\fR
213:.B -il\fIn\fB\fR, \fB--indent-label\fIn\fB\fR
218:.B -ip\fIn\fB\fR, \fB--parameter-indentation\fIn\fB\fR
224:.B -kr\fR, \fB--k-and-r-style\fR
229:.B -l\fIn\fB\fR, \fB--line-length\fIn\fB\fR
234:.B -lc\fIn\fB\fR, \fB--comment-line-length\fIn\fB\fR
239:.B -linux\fR, \fB--linux-style\fR
244:.B -lp\fR, \fB--continue-at-parentheses\fR
249:.B -lps\fR, \fB--leave-preprocessor-space\fR
254:.B -nlps\fR, \fB--remove-preprocessor-space\fR
259:.B -nbad\fR, \fB--no-blank-lines-after-declarations\fR
264:.B -nbap\fR, \fB--no-blank-lines-after-procedures\fR
269:.B -nbbo\fR, \fB--break-after-boolean-operator\fR
274:.B -nbc\fR, \fB--no-blank-lines-after-commas\fR
279:.B -nbfda\fR, \fB--dont-break-function-decl-args\fR
284:.B -ncdb\fR, \fB--no-comment-delimiters-on-blank-lines\fR
289:.B -ncdw\fR, \fB--dont-cuddle-do-while\fR
294:.B -nce\fR, \fB--dont-cuddle-else\fR
299:.B -ncs\fR, \fB--no-space-after-casts\fR
304:.B -ndj\fIn\fB\fR, \fB--dont-left-justify-declarations\fR
310:.B -nfc1\fR, \fB--dont-format-first-column-comments\fR
315:.B -nfca\fR, \fB--dont-format-comments\fR
320:.B -ngts\fR, \fB--no-gettext-strings\fR
325:.B -nhnl\fR, \fB--ignore-newlines\fR
330:.B -nip\fR, \fB--no-parameter-indentation\fR
335:.B -nlp\fR, \fB--dont-line-up-parentheses\fR
340:.B -npcs\fR, \fB--no-space-after-function-call-names\fR
345:.B -nprs\fR, \fB--no-space-after-parentheses\fR
350:.B -npsl\fR, \fB--dont-break-procedure-type\fR
355:.B -nsaf\fR, \fB--no-space-after-for\fR
360:.B -nsai\fR, \fB--no-space-after-if\fR
365:.B -nsaw\fR, \fB--no-space-after-while\fR
370:.B -nsc\fR, \fB--dont-star-comments\fR
375:.B -nsob\fR, \fB--leave-optional-blank-lines\fR
380:.B -nss\fR, \fB--dont-space-special-semicolon\fR
386:.B -ntac\fR, \fB--dont-tab-align-comments\fR
391:.B -nut\fR, \fB--no-tabs\fR
396:.B -nv\fR, \fB--no-verbosity\fR
401:.B -orig\fR, \fB--original\fR
406:.B -npro\fR, \fB--ignore-profile\fR
411:.B -pal\fR, \fB--pointer-align-left\fR
415:.B -par\fR, \fB--pointer-align-right\fR
419:.B -pcs\fR, \fB--space-after-procedure-calls\fR
425:.B -pi\fIn\fB\fR, \fB--paren-indentation\fIn\fB\fR
429:.B -pmt\fR, \fB--preserve-mtime\fR
432:.B -ppi\fIn\fB\fR, \fB--preprocessor-indentation\fIn\fB\fR
435:.B -prs\fR, \fB--space-after-parentheses\fR
440:.B -psl\fR, \fB--procnames-start-lines\fR
445:.B -saf\fR, \fB--space-after-for\fR
450:.B -sai\fR, \fB--space-after-if\fR
455:.B -sar\fR, \fB--spaces-around-initializers\fR
460:.B -saw\fR, \fB--space-after-while\fR
465:.B -sbi\fIn\fB\fR, \fB--struct-brace-indentation\fIn\fB\fR
470:.B -sc\fR, \fB--start-left-side-of-comments\fR
475:.B -slc\fR, \fB--single-line-conditionals\fR
481:.B -sob\fR, \fB--swallow-optional-blank-lines\fR
486:.B -ss\fR, \fB--space-special-semicolon\fR
492:.B -st\fR, \fB--standard-output\fR
497:.B -T\fR
502:.B -ts\fIn\fB\fR, \fB--tab-size\fIn\fB\fR
507:.B -ut\fR, \fB--use-tabs\fR
512:.B -v\fR, \fB--verbose\fR
517:.B -version\fR
532:indent [\fIoptions\fR] [\fIsingle-input-file\fR] [-o \fIoutput-file\fR]
566:indent slithy_toves.c -o slithy_toves.out
568:indent -st slithy_toves.c > slithy_toves.out
570:cat slithy_toves.c | indent -o slithy_toves.out
592:indent -br test/metabolism.c -l85
699:-nbad -bap -nbc -bbo -bl -bli2 -bls -ncdb -nce -cp1 -cs -di2
700:-ndj -nfc1 -nfca -hnl -i2 -ip5 -lp -pcs -nprs -psl -saf -sai
701:-saw -nsc -nsob
721:-nbad -bap -bbo -nbc -br -brs -c33 -cd33 -ncdb -ce -ci4 -cli0
722:-cp33 -cs -d0 -di1 -nfc1 -nfca -hnl -i4 -ip0 -l75 -lp -npcs
723:-nprs -npsl -saf -sai -saw -nsc -nsob -nss -par
740:-nbad -nbap -bbo -bc -br -brs -c33 -cd33 -cdb -ce -ci4 -cli0
741:-cp33 -di16 -fc1 -fca -hnl -i4 -ip4 -l75 -lp -npcs -nprs -psl
742:-saf -sai -saw -sc -nsob -nss -ts8
754:-nbad -bap -nbc -bbo -hnl -br -brs -c33 -cd33 -ncdb -ce -ci4 
755:-cli0 -d0 -di1 -nfc1 -i8 -ip0 -l80 -lp -npcs -nprs -npsl -sai
756:-saf -saw -ncs -nsc -sob -nfca -cp33 -ss -ts8 -il1
784:.SH "--blank-lines-after-declarations"
802:.B indent -bad\fR produces
816:and \fBindent -nbad\fR produces
829:.SH "--blank-lines-after-procedures"
853:.B indent -bap\fR produces
874:and \fBindent -nbap\fR produces
1013:transformed (with \(oq-cdb -sc\(cq) into:
1073:example, with \(oq-br -ce\(cq you get the following:
1087:With \(oq-br -nce\(cq that code would appear as
1206:using \(oq-cli2 -cbi0\(cq results in:
1341:-nbfda and -nbfde.
1405:you would use the options \(oq-T CODE_ADDR -T COLOR\(cq.
1554:\(oq-nlp -ci3\(cq in effect:
1945:.B indent -version\fR.  This will report the version number of
2037:--align-with-spaces                             -as
2038:--blank-lines-after-commas                      -bc             
2039:--blank-lines-after-declarations                -bad            
2040:--blank-lines-after-procedures                  -bap            
2041:--blank-lines-before-block-comments             -bbb            
2042:--braces-after-if-line                          -bl             
2043:--braces-after-func-def-line                    -blf
2044:--brace-indent                                  -bli
2045:--braces-after-struct-decl-line                 -bls
2046:--braces-on-if-line                             -br             
2047:--braces-on-func-def-line                       -brf
2048:--braces-on-struct-decl-line                    -brs
2049:--break-after-boolean-operator                  -nbbo
2050:--break-before-boolean-operator                 -bbo
2051:--break-function-decl-args                      -bfda
2052:--break-function-decl-args-end                  -bfde
2053:--case-indentation                              -cli\fIn\fR     
2054:--case-brace-indentation                        -cbi\fIn\fR
2055:--comment-delimiters-on-blank-lines             -cdb            
2056:--comment-indentation                           -c\fIn\fR       
2057:--continuation-indentation                      -ci\fIn\fR      
2058:--continue-at-parentheses                       -lp             
2059:--cuddle-do-while                               -cdw
2060:--cuddle-else                                   -ce             
2061:--declaration-comment-column                    -cd\fIn\fR      
2062:--declaration-indentation                       -di\fIn\fR      
2063:--dont-break-function-decl-args                 -nbfda
2064:--dont-break-function-decl-args-end             -nbfde
2065:--dont-break-procedure-type                     -npsl           
2066:--dont-cuddle-do-while                          -ncdw
2067:--dont-cuddle-else                              -nce            
2068:--dont-format-comments                          -nfca           
2069:--dont-format-first-column-comments             -nfc1           
2070:--dont-line-up-parentheses                      -nlp            
2071:--dont-left-justify-declarations                -ndj  
2072:--dont-space-special-semicolon                  -nss
2073:--dont-star-comments                            -nsc            
2074:--dont-tab-align-comments                       -ntac
2075:--else-endif-column                             -cp\fIn\fR
2076:--format-all-comments                           -fca            
2077:--format-first-column-comments                  -fc1            
2078:--gnu-style                                     -gnu            
2079:--honour-newlines                               -hnl
2080:--ignore-newlines                               -nhnl
2081:--ignore-profile                                -npro           
2082:--indent-label                                  -il\fIn\fR       
2083:--indent-level                                  -i\fIn\fR       
2084:--k-and-r-style                                 -kr             
2085:--leave-optional-blank-lines                    -nsob           
2086:--leave-preprocessor-space                      -lps
2087:--left-justify-declarations                     -dj 
2088:--line-comments-indentation                     -d\fIn\fR       
2089:--line-length                                   -l\fIn\fR       
2090:--linux-style                                   -linux             
2091:--no-blank-lines-after-commas                   -nbc            
2092:--no-blank-lines-after-declarations             -nbad           
2093:--no-blank-lines-after-procedures               -nbap           
2094:--no-blank-lines-before-block-comments          -nbbb           
2095:--no-comment-delimiters-on-blank-lines          -ncdb           
2096:--no-space-after-casts                          -ncs            
2097:--no-parameter-indentation                      -nip            
2099:--no-space-after-function-call-names            -npcs           
2101:--no-space-after-parentheses                    -nprs
2103:--no-tabs                                       -nut
2104:--no-verbosity                                  -nv             
2105:--original                                      -orig
2106:--parameter-indentation                         -ip\fIn\fR      
2107:--paren-indentation                             -pi\fIn\fR
2109:--preprocessor-indentation                      -ppi\fIn\fR
2110:--procnames-start-lines                         -psl            
2111:--remove-preprocessor-space                     -nlps
2112:--single-line-conditionals                      -slc
2113:--space-after-cast                              -cs             
2116:--space-after-parentheses                       -prs
2117:--space-after-procedure-calls                   -pcs            
2119:--space-special-semicolon                       -ss             
2120:--spaces-around-initializers                    -sar
2121:--standard-output                               -st             
2122:--start-left-side-of-comments                   -sc             
2123:--struct-brace-indentation                      -sbi\fIn\fR
2124:--swallow-optional-blank-lines                  -sob            
2125:--tab-size                                      -ts\fIn\fR      
2126:--use-tabs                                      -ut
2127:--verbose                                       -v              

-.-.

Find a repeated word

! 993 --> to
! 1950 --> more

-.-.


Wrong distance between sentences.

  Separate the sentences and subordinate clauses; each begins on a new
line.  See man-pages(7) ("Conventions for source file layout") and
"info groff" ("Input Conventions").

  The best procedure is to always start a new sentence on a new line,
at least, if you are typing on a computer.

Remember coding: Only one command ("sentence") on each (logical) line.

E-mail: Easier to quote exactly the relevant lines.

Generally: Easier to edit the sentence.

Patches: Less unaffected text.

Search for two adjacent words is easier, when they belong to the same line,
and the same phrase.

  The amount of space between sentences in the output can then be
controlled with the ".ss" request.

N.B

  The number of lines affected is too large to be in the patch.


417:variable names: \(oq\(oqchar *p\(cq\(cq. This is the default behavior.
476:Allow for unbraced conditionals (\fBif\fR, \fBelse\fR, etc.) to have
508:Use tabs. This is the default.
620:the environment variable \fBINDENT_PROFILE\fR. If that exists its value 
621:is expected to name the file that is to be used. If the environment 
variable does 
747:The Linux style is used in the linux kernel code and drivers. Code 
931: * Comment in a box!! *
985:and \fB#endif\fR. \(oq-dj\(cq together with \(oq-cd0\(cq can be used
987:comment to follow one tabstop from the end of the declaration. Normally 
\(oq-cd0\(cq
1136:statement to appear on the same line. For example:
1237:a cast operator and the object to be cast. The \(oq-ncs\(cq ensures that 
there 
1238:is no space between the cast operator and the object. Remember that 
\fBindent\fR
1240:in casts. Thus \fB(mytype)thing\fR is not treated as a cast.
1340:bracket of the function declaration. For both options the \(cqn\(cq 
setting is the default:
1466:lists. Without \(oq-sar\(cq they are formatted like this:
1509:specified by the \(oq-ut\(cq option. Assuming the default tab size of
1526:\(oq-nut\(cq option. The same code would look like this:
1610:and then pad with spaces until the desired position is reached. However,
1612:the current indentation level. By default, assuming \(oq-lp\(cq is
1634:your assumption of 8-space tabs. If the reader was using 4-space tabs,
1655:regardless of what tab size the user users to read the code. This looks
1689:  . . .
1701:directs \fBindent\fR to leave this space unmodified. The option 
\(oq-ppi\(cq 
1736:will be positioned. If it is set to zero or a positive number, this 
indicates how 
1741:\(oq-cli\(cq parameter for that. For example with the option \(oq-il 1\(cq
1989:identifier, causing them to be joined with the next line. This renders
2139:of the formatting, but which appear to be  manifested by incorrect code 
(i.e. code
2144:which prevents completion of formatting. If more than one input file was 
specified,

-.-.

Split lines longer than 80 characters into two or more lines.
Appropriate break points are the end of a sentence and a subordinate
clause; after punctuation marks.

indent.1: line 3        length 86
indent \- changes the appearance of a C program by inserting or deleting 
whitespace.  

indent.1: line 199      length 85
Treat gettext \fB_("...")\fR and \fBN_("...")\fR as strings rather than as 
functions.

indent.1: line 321      length 91
Treat gettext \fB_("...")\fR and \fBN_("...")\fR as normal functions.  This is 
the default.

indent.1: line 430      length 90
Preserve access and modification times on output files.See \fB\ MISCELLANEOUS\ 
OPTIONS\fR.

indent.1: line 433      length 88
Specify the indentation for preprocessor conditional statements.See \fB\ 
INDENTATION\fR.

indent.1: line 621      length 82
is expected to name the file that is to be used. If the environment variable 
does 

indent.1: line 918      length 81
\(oq\(oqbox\(cq\(cq of stars or dashes to visually set it apart.  More 
precisely,

indent.1: line 987      length 84
comment to follow one tabstop from the end of the declaration. Normally 
\(oq-cd0\(cq

indent.1: line 1233     length 136
the procedure being called and the \(oq(\(cq (for example, \fBputs\ ("Hi");\fR. 
 The \(oq-npcs\(cq option would give \fBputs("Hi");\fR).

indent.1: line 1239     length 85
only knows about the standard C data types and so cannot recognise user-defined 
types

indent.1: line 1340     length 91
bracket of the function declaration. For both options the \(cqn\(cq setting is 
the default:

indent.1: line 1437     length 89
 the function brace options \(oq-brf\(cq or \(oq-blf\(cq specify how to format 
the braces

indent.1: line 1705     length 84
be indented by to given number of spaces, for example with the option \(oq-ppi 
3\(cq

indent.1: line 1736     length 82
will be positioned. If it is set to zero or a positive number, this indicates 
how 

indent.1: line 1739     length 84
The default setting is -2 which matches the behaviour of earlier versions of 
indent.

indent.1: line 1848     length 89
      || (mask[1] == \(cq\\0\(cq && ((mask[0] == \(cq0\(cq) || (mask[0] == 
\(cq*\(cq)))))

indent.1: line 1875     length 88
The \(oq-gts\(cq option affects how the gettext standard macros \fB_()\fR and 
\fBN_()\fR

indent.1: line 1876     length 82
are treated.  The default behavior (or the use of \(oq-ngts\(cq) causes indent 
to 

indent.1: line 1877     length 89
treat them as it does other functions, so that a long string is broken like the 
following

indent.1: line 1892     length 88
With the \(oq-gts\(cq option, the underscore is treated as a part of the 
string, keeping

indent.1: line 1893     length 86
it tied to the string, and respecting the fact that gettext is unobtrusively 
providing

indent.1: line 1894     length 88
a localized string.  This only works if \fB_("\fR is together as a unit at the 
beginning

indent.1: line 2139     length 82
of the formatting, but which appear to be  manifested by incorrect code (i.e. 
code

indent.1: line 2143     length 81
3 is returned if formatting of a file is halted because of an error with the 
file

indent.1: line 2144     length 83
which prevents completion of formatting. If more than one input file was 
specified,

indent.1: line 2174     length 91
Copyright (C) 1989, 1992, 1993, 1994, 1995, 1996, 2014, 2015 Free Software 
Foundation, Inc.


-.-.

Use \- for a minus

indent.1:1262:  while ( ( e_code - s_code ) < ( dec_ind - 1 ) )

-.-.

'Use a font macro to change to another font, instead of "\f...",
if possible (see man-pages(7)).

-.-



reply via email to

[Prev in Thread] Current Thread [Next in Thread]