1CPPI(1) User Commands CPPI(1)
2
3
4
6 cppi - indent the C preprocessor directives in FILE to reflect their
7 nesting
8
10 cppi [FILE]
11 cppi -c [OPTION] [FILE]...
12
14 Indent the C preprocessor directives in FILE to reflect their nesting
15 and ensure that there is exactly one space character between each #if,
16 #elif, #define directive and the following token, and write the result
17 to standard output. The number of spaces between the `#' and the fol‐
18 lowing directive must correspond to the level of nesting of that direc‐
19 tive. With no FILE, or when FILE is -, read standard input.
20
21 -a, --ansi
22 when checking, fail if text follows #else or #endif
23
24 -c, --check
25 set exit code, but don't produce any output
26
27 -l, --list-files-only
28 don't generate diagnostics about indentation; print to stdout
29 only the names of files that are not properly indented
30
31 -m, --max-string-length=LENGTH
32 fail if there is a double-quoted string longer than LENGTH; if
33 LENGTH is 0 (the default), then there is no limit
34
35 --help display this help and exit
36
37 --version
38 output version information and exit
39
40 With the -c option, don't write to stdout. Instead, check the indenta‐
41 tion of the specified files giving diagnostics for preprocessor lines
42 that aren't properly indented or are otherwise invalid.
43
44 Note that --ansi without --check does not correct the problem of
45 non-ANSI text following #else and #endif directives.
46
47 The exit code will be one of these:
48 0 all directives properly indented
49
50 1 some cpp directive(s) improperly indented, or text follows
51 #else/#endif (enabled with --check --ansi), or a double-quoted
52 string is longer than the specified maximum
53
54 2 #if/#endif mismatch, EOF in comment or string
55
56 3 file (e.g. open/read/write) error
57
58 A pragma directive may have its `#' indented.
59
61 Written by Jim Meyering.
62
64 Report bugs to <bug-cppi@gnu.org>.
65
67 Copyright © 2013 Free Software Foundation, Inc. License GPLv3+: GNU
68 GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
69 This is free software: you are free to change and redistribute it.
70 There is NO WARRANTY, to the extent permitted by law.
71
73 The full documentation for cppi is maintained as a Texinfo manual. If
74 the info and cppi programs are properly installed at your site, the
75 command
76
77 info cppi
78
79 should give you access to the complete manual.
80
81
82
83cppi 1.18 March 2013 CPPI(1)