[Bug-gnulib] cppi-1.11 released

[Jim Meyering]

cppi is a tool for automatically indenting C preprocessor
directives to reflect their nesting.  See the --help output below.
Other than --help, documentation is nonexistent.
I'll set things up to use help2man generate cppi.1
for the next release.

I've just learned that indent-2.2.9 has a new option, -ppi,
to do much the same thing.

There's plenty of room for improvement.
For example, currently, the indentation width is hard-coded
at one space per nesting level.  Also, one cannot yet tell
cppi to ignore file-spanning directives like these:
  #ifndef FOO_H
  #define FOO_H
  ...
  #endif FOO_H

Note that the URLs for alpha.gnu.org below are invalid,
since I am currently unable to put files on that system.

Here are the compressed sources:
  ***INVALID ftp://alpha.gnu.org/gnu/cppi/cppi-1.11.tar.gz   (348KB)
  ***INVALID ftp://alpha.gnu.org/gnu/cppi/cppi-1.11.tar.bz2  (276KB)
  http://fetish.sf.net/cppi-1.11.tar.gz   (348KB)
  http://fetish.sf.net/cppi-1.11.tar.bz2  (276KB)

Here are GPG detached signatures:
  ftp://alpha.gnu.org/gnu/cppi/cppi-1.11.tar.gz.asc
  ftp://alpha.gnu.org/gnu/cppi/cppi-1.11.tar.bz2.asc
  http://fetish.sf.net/cppi-1.11.tar.gz.asc
  http://fetish.sf.net/cppi-1.11.tar.bz2.asc

Here are the MD5 and SHA1 signatures:

c2fe226e35f4e254ba8a5998d8f8444e  cppi-1.11.tar.gz
c36bd6447657f7ec8268a3da5e3015bb  cppi-1.11.tar.bz2
39f897ad3513da5800730dbe4740ca8872abf9cf  cppi-1.11.tar.gz
5685401b6ec0e4f08812419e00b871bab9f0eb7a  cppi-1.11.tar.bz2

NEWS

* Major changes in release 1.11:
  revamp infrastructure to use gnulib
------------

Here's its --help output:

Usage: cppi [FILE]
  or:  cppi -c [OPTION] [FILE]...

Indent the C preprocessor directives in FILE to reflect their nesting
and ensure that there is exactly one space character between each #if,
#elif, #define directive and the following token, and write the result
to standard output.  The number of spaces between the `#' and the following
directive must correspond to the level of nesting of that directive.
With no FILE, or when FILE is -, read standard input.

  -a, --ansi             when checking, fail if text follows #else or #endif
  -c, --check            set exit code, but don't produce any output
  -l, --list-files-only  don't generate diagnostics about indentation;
                           print to stdout only the names of files that
                           are not properly indented
  -m, --max-string-length=LENGTH
                         fail if there is a double-quoted string longer
                           than LENGTH;  if LENGTH is 0 (the default),
                           then there is no limit
      --help             print this help, then exit
      --version          print version information, then exit

With the -c option, don't write to stdout.  Instead, check the
indentation of the specified files giving diagnostics for preprocessor
lines that aren't properly indented or are otherwise invalid.

Note that --ansi without --check does not correct the problem of
non-ANSI text following #else and #endif directives.

The exit code will be one of these:
  0 all directives properly indented
  1 some cpp directive(s) improperly indented
  1 if text follows #else/#endif (enabled with --check --ansi)
  2 #if/#endif mismatch
  3 file (e.g. read/write) error
  4 found a double-quoted string longer than the specified maximum

A pragma directive may have its `#' indented.

Report bugs to <address@hidden>.

pgpbvjtvsUWZ_.pgp
Description: PGP signature