[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
www manual/manual.html software/indent/indent.h...
From: |
D E Evans |
Subject: |
www manual/manual.html software/indent/indent.h... |
Date: |
Thu, 18 Sep 2008 15:15:16 +0000 |
CVSROOT: /web/www
Module name: www
Changes by: D E Evans <sinuhe> 08/09/18 15:15:16
Modified files:
manual : manual.html
software/indent: indent.html
Added files:
software/indent/manual: indent.dvi.gz indent.html.gz
indent.html_node.tar.gz
indent.info.tar.gz indent.pdf
indent.ps.gz indent.texi.tar.gz
indent.txt indent.txt.gz index.html
software/indent/manual/html_node: Backup-files.html
Blank-lines.html
Breaking-long-lines.html
Bugs.html Comments.html
Common-styles.html
Copyright.html
Declarations.html
Disabling-Formatting.html
Indent-Program.html
Indentation.html Index.html
Invoking-indent.html
Miscellaneous-options.html
Option-Summary.html
Statements.html _002dbad.html
_002dbap.html
Log message:
Update indent project page with template and manual directory.
CVSWeb URLs:
http://web.cvs.savannah.gnu.org/viewcvs/www/manual/manual.html?cvsroot=www&r1=1.108&r2=1.109
http://web.cvs.savannah.gnu.org/viewcvs/www/software/indent/indent.html?cvsroot=www&r1=1.3&r2=1.4
http://web.cvs.savannah.gnu.org/viewcvs/www/software/indent/manual/indent.dvi.gz?cvsroot=www&rev=1.1
http://web.cvs.savannah.gnu.org/viewcvs/www/software/indent/manual/indent.html.gz?cvsroot=www&rev=1.1
http://web.cvs.savannah.gnu.org/viewcvs/www/software/indent/manual/indent.html_node.tar.gz?cvsroot=www&rev=1.1
http://web.cvs.savannah.gnu.org/viewcvs/www/software/indent/manual/indent.info.tar.gz?cvsroot=www&rev=1.1
http://web.cvs.savannah.gnu.org/viewcvs/www/software/indent/manual/indent.pdf?cvsroot=www&rev=1.1
http://web.cvs.savannah.gnu.org/viewcvs/www/software/indent/manual/indent.ps.gz?cvsroot=www&rev=1.1
http://web.cvs.savannah.gnu.org/viewcvs/www/software/indent/manual/indent.texi.tar.gz?cvsroot=www&rev=1.1
http://web.cvs.savannah.gnu.org/viewcvs/www/software/indent/manual/indent.txt?cvsroot=www&rev=1.1
http://web.cvs.savannah.gnu.org/viewcvs/www/software/indent/manual/indent.txt.gz?cvsroot=www&rev=1.1
http://web.cvs.savannah.gnu.org/viewcvs/www/software/indent/manual/index.html?cvsroot=www&rev=1.1
http://web.cvs.savannah.gnu.org/viewcvs/www/software/indent/manual/html_node/Backup-files.html?cvsroot=www&rev=1.1
http://web.cvs.savannah.gnu.org/viewcvs/www/software/indent/manual/html_node/Blank-lines.html?cvsroot=www&rev=1.1
http://web.cvs.savannah.gnu.org/viewcvs/www/software/indent/manual/html_node/Breaking-long-lines.html?cvsroot=www&rev=1.1
http://web.cvs.savannah.gnu.org/viewcvs/www/software/indent/manual/html_node/Bugs.html?cvsroot=www&rev=1.1
http://web.cvs.savannah.gnu.org/viewcvs/www/software/indent/manual/html_node/Comments.html?cvsroot=www&rev=1.1
http://web.cvs.savannah.gnu.org/viewcvs/www/software/indent/manual/html_node/Common-styles.html?cvsroot=www&rev=1.1
http://web.cvs.savannah.gnu.org/viewcvs/www/software/indent/manual/html_node/Copyright.html?cvsroot=www&rev=1.1
http://web.cvs.savannah.gnu.org/viewcvs/www/software/indent/manual/html_node/Declarations.html?cvsroot=www&rev=1.1
http://web.cvs.savannah.gnu.org/viewcvs/www/software/indent/manual/html_node/Disabling-Formatting.html?cvsroot=www&rev=1.1
http://web.cvs.savannah.gnu.org/viewcvs/www/software/indent/manual/html_node/Indent-Program.html?cvsroot=www&rev=1.1
http://web.cvs.savannah.gnu.org/viewcvs/www/software/indent/manual/html_node/Indentation.html?cvsroot=www&rev=1.1
http://web.cvs.savannah.gnu.org/viewcvs/www/software/indent/manual/html_node/Index.html?cvsroot=www&rev=1.1
http://web.cvs.savannah.gnu.org/viewcvs/www/software/indent/manual/html_node/Invoking-indent.html?cvsroot=www&rev=1.1
http://web.cvs.savannah.gnu.org/viewcvs/www/software/indent/manual/html_node/Miscellaneous-options.html?cvsroot=www&rev=1.1
http://web.cvs.savannah.gnu.org/viewcvs/www/software/indent/manual/html_node/Option-Summary.html?cvsroot=www&rev=1.1
http://web.cvs.savannah.gnu.org/viewcvs/www/software/indent/manual/html_node/Statements.html?cvsroot=www&rev=1.1
http://web.cvs.savannah.gnu.org/viewcvs/www/software/indent/manual/html_node/_002dbad.html?cvsroot=www&rev=1.1
http://web.cvs.savannah.gnu.org/viewcvs/www/software/indent/manual/html_node/_002dbap.html?cvsroot=www&rev=1.1
Patches:
Index: manual/manual.html
===================================================================
RCS file: /web/www/www/manual/manual.html,v
retrieving revision 1.108
retrieving revision 1.109
diff -u -b -r1.108 -r1.109
--- manual/manual.html 6 Sep 2008 22:00:42 -0000 1.108
+++ manual/manual.html 18 Sep 2008 15:14:48 -0000 1.109
@@ -1285,12 +1285,10 @@
<td>Identifier database utilities.</td>
</tr>
-<!--
<tr>
<td>* <a href="/software/indent/manual/">indent</a></td>
-<td>Foo.</td>
+<td>Indent Code Formatter</td>
</tr>
--->
<tr>
<td>* <a href="/software/kawa">Kawa</a></td>
@@ -2179,7 +2177,7 @@
<p>
Updated:
<!-- timestamp start -->
-$Date: 2008/09/06 22:00:42 $
+$Date: 2008/09/18 15:14:48 $
<!-- timestamp end -->
</p>
</div>
Index: software/indent/indent.html
===================================================================
RCS file: /web/www/www/software/indent/indent.html,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -b -r1.3 -r1.4
--- software/indent/indent.html 4 Sep 2007 22:16:02 -0000 1.3
+++ software/indent/indent.html 18 Sep 2008 15:14:52 -0000 1.4
@@ -1,69 +1,114 @@
-<!DOCTYPE html PUBLIC "-//IETF//DTD HTML 2.0//EN">
-<HTML>
-<HEAD>
-<TITLE>indent - GNU Project - Free Software Foundation (FSF)</TITLE>
-<LINK REV="made" HREF="mailto:address@hidden">
-<META NAME="keywords" CONTENT="indent">
-</HEAD>
-<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#1F00FF" ALINK="#FF0000"
VLINK="#9900DD">
-<H3>indent</H3>
-<A HREF="/graphics/gnu-head-sm.jpg"><IMG SRC="/graphics/gnu-head-sm.jpg"
-ALT=" [image of the Head of a GNU] "
-WIDTH="129" HEIGHT="122"></A>
-
-<P>
-<HR>
-
-<H4>Introduction to Indent</H4>
-<P>
-
-<P>
-The `indent' program can be used to make code easier to read.
-It can also convert from one style of writing C to another.
-
-<P>
-`indent' understands a substantial amount about the syntax of C,
-but it also attempts to cope with incomplete and misformed syntax.
-
-</P>
-
-<H4>Downloading Indent</H4>
-<P>
-
-Indent can be found on in the subdirectory <CODE>/gnu/indent/</CODE>
-on your favorite <A HREF="/prep/ftp.html">GNU mirror</A>. For other
-ways to obtain Indent, please read <A
-HREF="/software/software.html#HowToGetSoftware">How to get GNU
-Software</A>
-
-<HR>
-
-Return to <A HREF="/home.html">GNU's home page</A>.
-
-<P>
-Please send FSF & GNU inquiries & questions to
-
-<A HREF="mailto:address@hidden"><EM>address@hidden</EM></A>.
-There are also <A HREF="/home.html#ContactInfo">other ways to contact</A> the
FSF.
-
-<P>
-Please send comments on these web pages to
-<A HREF="mailto:address@hidden"><EM>address@hidden</EM></A>,
-send other questions to
-<A HREF="mailto:address@hidden"><EM>address@hidden</EM></A>.
-
-<P>
-Copyright (C) 2007 Free Software Foundation, Inc.,
-59 Temple Place - Suite 330, Boston, MA 02111, USA
-
-<P>
-Verbatim copying and distribution of this entire article is
-permitted in any medium, provided this notice is preserved.
-<P>
+<!--#include virtual="/server/header.html" -->
+<title>Indent - GNU Project - Free Software Foundation</title>
+<!--#include virtual="/server/banner.html" -->
+<h1>Indent</h1>
+
+<h2>Introduction to Indent/h2>
+
+<p>
+The <i>indent</i> program can be used to make code easier to read. It
+can also convert from one style of writing C to another. <i>indent</i>
+understands a substantial amount about the syntax of C, but it also
+attempts to cope with incomplete and misformed syntax.
+</p>
+
+<h2>Downloading FOO</h2>
+
+<p>
+<i>indent<i> can be found on in the subdirectory
+<var>/gnu/indent/</var> on your favorite <a href="/prep/ftp.html">GNU
+mirror</a>. For other ways to obtain Indent, please read
+<a href="/software/software.html#HowToGetSoftware">How to get GNU
+Software</a>
+</p>
+
+<h3>Documentation</h3>
+
+<p>
+indent documentation can be found at
+<a
href="/software/indent/manual/">http://www.gnu.org/software/indent/manual/</a>.
+You may also find more information about indent by
+running <kbd>info foo</kbd>, <kbd>man foo</kbd>,
+or looking at <var>/usr/share/doc/indent/</var> or
+<var>/usr/local/share/doc/indent/</var> on your system.
+</p>
+
+<h3>Mailing Lists/Newsgroups</h3>
+
+<p>
+Email the indent bug and help list at
+<a href="mailto:address@hidden"><address@hidden></a>.
+See
+<a
href="http://lists.gnu.org/mailman/listinfo/bug-indent">http://lists.gnu.org/mailman/listinfo/bug-indent</a>
+for subscription information.
+</p>
+
+<p>
+Announcements about indent and most other GNU software are made on
+<a href="mailto:address@hidden"><address@hidden></a>.
+</p>
+
+</div><!-- for id="content", starts in the include above -->
+<!--#include virtual="/server/footer.html" -->
+<div id="footer">
+
+<p>
+Please send FSF & GNU inquiries to
+<a href="mailto:address@hidden"><em>address@hidden</em></a>.
+There are also <a href="/contact/">other ways to contact</a>
+the FSF.
+<br />
+Please send broken links and other corrections or suggestions to
+<a href="mailto:address@hidden"><em>address@hidden</em></a>.
+</p>
+
+<p>
+Please see the
+<a href="/server/standards/README.translations.html">Translations
+README</a> for information on coordinating and submitting
+translations of this article.
+</p>
+
+<p>
+Copyright © 2007, 2008 Free Software Foundation, Inc.,
+</p>
+<address>51 Franklin St, Fifth Floor, Boston, MA 02110, USA</address>
+<p>Verbatim copying and distribution of this entire article are
+permitted worldwide, without royalty, in any medium, provided this
+notice, and the copyright notice, are preserved.
+</p>
+
+<p>
Updated:
-<!-- hhmts start -->
-15 May 2000 bkuhn
-<!-- hhmts end -->
-<HR>
-</BODY>
-</HTML>
+<!-- timestamp start -->
+$Date: 2008/09/18 15:14:52 $
+<!-- timestamp end -->
+</p>
+</div>
+
+<div id="translations">
+<h4>Translations of this page</h4>
+
+<!-- Please keep this list alphabetical by language code. -->
+<!-- Comment what the language is for each type, i.e. de is German. -->
+<!-- Write the language name in its own language (Deutsch) in the text. -->
+<!-- If you add a new language here, please -->
+<!-- advise address@hidden and add it to -->
+<!-- - /home/www/html/server/standards/README.translations.html -->
+<!-- - one of the lists under the section "Translations Underway" -->
+<!-- - if there is a translation team, you also have to add an alias -->
+<!-- to mail.gnu.org:/com/mailer/aliases -->
+<!-- Please also check you have the language code right; see: -->
+<!-- http://www.loc.gov/standards/iso639-2/php/code_list.php -->
+<!-- If the 2-letter ISO 639-1 code is not available, -->
+<!-- use the 3-letter ISO 639-2. -->
+<!-- Please use W3C normative character entities. -->
+
+<ul class="translations-list">
+<!-- English -->
+<li><a href="/software/indent">English</a> [en]</li>
+</ul>
+</div>
+</div>
+</body>
+</html>
Index: software/indent/manual/indent.dvi.gz
===================================================================
RCS file: software/indent/manual/indent.dvi.gz
diff -N software/indent/manual/indent.dvi.gz
Binary files /dev/null and /tmp/cvsipji43 differ
Index: software/indent/manual/indent.html.gz
===================================================================
RCS file: software/indent/manual/indent.html.gz
diff -N software/indent/manual/indent.html.gz
Index: software/indent/manual/indent.html_node.tar.gz
===================================================================
RCS file: software/indent/manual/indent.html_node.tar.gz
diff -N software/indent/manual/indent.html_node.tar.gz
Binary files /dev/null and /tmp/cvssr4sG2 differ
Index: software/indent/manual/indent.info.tar.gz
===================================================================
RCS file: software/indent/manual/indent.info.tar.gz
diff -N software/indent/manual/indent.info.tar.gz
Binary files /dev/null and /tmp/cvs5ajIQ2 differ
Index: software/indent/manual/indent.pdf
===================================================================
RCS file: software/indent/manual/indent.pdf
diff -N software/indent/manual/indent.pdf
Binary files /dev/null and /tmp/cvsmfCQz3 differ
Index: software/indent/manual/indent.ps.gz
===================================================================
RCS file: software/indent/manual/indent.ps.gz
diff -N software/indent/manual/indent.ps.gz
Binary files /dev/null and /tmp/cvs3g6Pl6 differ
Index: software/indent/manual/indent.texi.tar.gz
===================================================================
RCS file: software/indent/manual/indent.texi.tar.gz
diff -N software/indent/manual/indent.texi.tar.gz
Binary files /dev/null and /tmp/cvsuUeRG5 differ
Index: software/indent/manual/indent.txt
===================================================================
RCS file: software/indent/manual/indent.txt
diff -N software/indent/manual/indent.txt
--- /dev/null 1 Jan 1970 00:00:00 -0000
+++ software/indent/manual/indent.txt 18 Sep 2008 15:14:57 -0000 1.1
@@ -0,0 +1,1619 @@
+This is Edition 2.2.9 of `The `indent' Manual', for Indent Version
+2.2.9, last updated 10 November 2002.
+
+ Copyright (C) 1989, 1992, 1993, 1994, 1995, 1996 Free Software
+Foundation, Inc. Copyright (C) 1995, 1996 Joseph Arceneaux. Copyright
+(C) 1999 Carlo Wood. Copyright (C) 2001 David Ingamells.
+
+ Permission is granted to make and distribute verbatim copies of this
+manual provided the copyright notice and this permission notice are
+preserved on all copies.
+
+`indent': Indent and Format C Program Source
+*********************************************
+
+The `indent' program changes the appearance of a C program by inserting
+or deleting whitespace.
+
+ This is Edition 2.2.9, 10 November 2002, of `The `indent' Manual',
+for Indent Version 2.2.9.
+
+1 The `indent' Program
+**********************
+
+The `indent' program can be used to make code easier to read. It can
+also convert from one style of writing C to another.
+
+`indent' understands a substantial amount about the syntax of C, but it
+also attempts to cope with incomplete and misformed syntax.
+
+ In version 1.2 and more recent versions, the GNU style of indenting
+is the default.
+
+1.1 Invoking `indent'
+=====================
+
+As of version 1.3, the format of the `indent' command is:
+
+
+ indent [OPTIONS] [INPUT-FILES]
+
+ indent [OPTIONS] [SINGLE-INPUT-FILE] [-o OUTPUT-FILE]
+
+ This format is different from earlier versions and other versions of
+`indent'.
+
+ In the first form, one or more input files are specified. `indent'
+makes a backup copy of each file, and the original file is replaced with
+its indented version. *Note Backup files::, for an explanation of how
+backups are made.
+
+ In the second form, only one input file is specified. In this case,
+or when the standard input is used, you may specify an output file after
+the `-o' option.
+
+ To cause `indent' to write to standard output, use the `-st' option.
+This is only allowed when there is only one input file, or when the
+standard input is used.
+
+ If no input files are named, the standard input is read for input.
+Also, if a filename named `-' is specified, then the standard input is
+read.
+
+ As an example, each of the following commands will input the program
+`slithy_toves.c' and write its indented text to `slithy_toves.out':
+
+
+ indent slithy_toves.c -o slithy_toves.out
+
+ indent -st slithy_toves.c > slithy_toves.out
+
+ cat slithy_toves.c | indent -o slithy_toves.out
+
+ Most other options to `indent' control how programs are formatted.
+As of version 1.2, `indent' also recognizes a long name for each option
+name. Long options are prefixed by either `--' or `+'. (1) In most
+of this document, the traditional, short names are used for the sake of
+brevity. *Note Option Summary::, for a list of options, including both
+long and short names.
+
+ Here is another example:
+
+ indent -br test/metabolism.c -l85
+
+ This will indent the program `test/metabolism.c' using the `-br' and
+`-l85' options, write the output back to `test/metabolism.c', and write
+the original contents of `test/metabolism.c' to a backup file in the
+directory `test'.
+
+ Equivalent invocations using long option names for this example would
+be:
+
+
+ indent --braces-on-if-line --line-length185 test/metabolism.c
+
+ indent +braces-on-if-line +line-length185 test/metabolism.c
+
+ If you find that you often use `indent' with the same options, you
+may put those options into a file named `.indent.pro'. `indent' will
+look for a profile file in three places. First it will check the
+environment variable `INDENT_PROFILE'. If that exists its value is
+expected to name the file that is to be used. If the environment
+variable does not exist, indent looks for `.indent.pro' in the current
+directory and use that if found. Finally `indent' will search your
+home directory for `.indent.pro' and use that file if it is found.
+This behaviour is different from that of other versions of `indent',
+which load both files if they both exist.
+
+ The format of `.indent.pro' is simply a list of options, just as
+they would appear on the command line, separated by white space (tabs,
+spaces, and newlines). Options in `.indent.pro' may be surrounded by C
+or C++ comments, in which case they are ignored.
+
+ Command line switches are handled _after_ processing `.indent.pro'.
+Options specified later override arguments specified earlier, with one
+exception: Explicitly specified options always override background
+options (*note Common styles::). You can prevent `indent' from reading
+an `.indent.pro' file by specifying the `-npro' option.
+
+ ---------- Footnotes ----------
+
+ (1) `+' is being superseded by `--' to maintain consistency with
+the POSIX standard.
+
+1.2 Backup Files
+================
+
+As of version 1.3, GNU `indent' makes GNU-style backup files, the same
+way GNU Emacs does. This means that either "simple" or "numbered"
+backup filenames may be made.
+
+ Simple backup file names are generated by appending a suffix to the
+original file name. The default for this suffix is the one-character
+string `~' (tilde). Thus, the backup file for `python.c' would be
+`python.c~'.
+
+ Instead of the default, you may specify any string as a suffix by
+setting the environment variable `SIMPLE_BACKUP_SUFFIX' to your
+preferred suffix.
+
+ Numbered backup versions of a file `momeraths.c' look like
+`momeraths.c.~23~', where 23 is the version of this particular backup.
+When making a numbered backup of the file `src/momeraths.c', the backup
+file will be named `src/momeraths.c.~V~', where V is one greater than
+the highest version currently existing in the directory `src'. The
+environment variable `VERSION_WIDTH' controls the number of digits,
+using left zero padding when necessary. For instance, setting this
+variable to "2" will lead to the backup file being named
+`momeraths.c.~04~'.
+
+ The type of backup file made is controlled by the value of the
+environment variable `VERSION_CONTROL'. If it is the string `simple',
+then only simple backups will be made. If its value is the string
+`numbered', then numbered backups will be made. If its value is
+`numbered-existing', then numbered backups will be made if there
+_already exist_ numbered backups for the file being indented;
+otherwise, a simple backup is made. If `VERSION_CONTROL' is not set,
+then `indent' assumes the behaviour of `numbered-existing'.
+
+ Other versions of `indent' use the suffix `.BAK' in naming backup
+files. This behaviour can be emulated by setting
+`SIMPLE_BACKUP_SUFFIX' to `.BAK'.
+
+ Note also that other versions of `indent' make backups in the
+current directory, rather than in the directory of the source file as
+GNU `indent' now does.
+
+1.3 Common styles
+=================
+
+There are several common styles of C code, including the GNU style, the
+Kernighan & Ritchie style, and the original Berkeley style. A style may
+be selected with a single "background" option, which specifies a set of
+values for all other options. However, explicitly specified options
+always override options implied by a background option.
+
+ As of version 1.2, the default style of GNU `indent' is the GNU
+style. Thus, it is no longer necessary to specify the option `-gnu' to
+obtain this format, although doing so will not cause an error. Option
+settings which correspond to the GNU style are:
+
+ -nbad -bap -nbc -bbo -bl -bli2 -bls -ncdb -nce -cp1 -cs -di2
+ -ndj -nfc1 -nfca -hnl -i2 -ip5 -lp -pcs -nprs -psl -saf -sai
+ -saw -nsc -nsob
+
+ The GNU coding style is that preferred by the GNU project. It is the
+style that the GNU Emacs C mode encourages and which is used in the C
+portions of GNU Emacs. (People interested in writing programs for
+Project GNU should get a copy of `The GNU Coding Standards', which also
+covers semantic and portability issues such as memory usage, the size
+of integers, etc.)
+
+ The Kernighan & Ritchie style is used throughout their well-known
+book `The C Programming Language'. It is enabled with the `-kr'
+option. The Kernighan & Ritchie style corresponds to the following set
+of options:
+
+ -nbad -bap -bbo -nbc -br -brs -c33 -cd33 -ncdb -ce -ci4 -cli0
+ -cp33 -cs -d0 -di1 -nfc1 -nfca -hnl -i4 -ip0 -l75 -lp -npcs
+ -nprs -npsl -saf -sai -saw -nsc -nsob -nss
+
+Kernighan & Ritchie style does not put comments to the right of code in
+the same column at all times (nor does it use only one space to the
+right of the code), so for this style `indent' has arbitrarily chosen
+column 33.
+
+ The style of the original Berkeley `indent' may be obtained by
+specifying `-orig' (or by specifying `--original', using the long
+option name). This style is equivalent to the following settings:
+
+ -nbad -nbap -bbo -bc -br -brs -c33 -cd33 -cdb -ce -ci4 -cli0
+ -cp33 -di16 -fc1 -fca -hnl -i4 -ip4 -l75 -lp -npcs -nprs -psl
+ -saf -sai -saw -sc -nsob -nss -ts8
+
+1.4 Blank lines
+===============
+
+Various programming styles use blank lines in different places.
+`indent' has a number of options to insert or delete blank lines in
+specific places.
+
+ The `-bad' option causes `indent' to force a blank line after every
+block of declarations. The `-nbad' option causes `indent' not to force
+such blank lines.
+
+ The `-bap' option forces a blank line after every procedure body.
+The `-nbap' option forces no such blank line.
+
+ The `-bbb' option forces a blank line before every boxed comment
+(*Note Comments::.) The `-nbbb' option does not force such blank lines.
+
+ The `-sob' option causes `indent' to swallow optional blank lines
+(that is, any optional blank lines present in the input will be removed
+from the output). If the `-nsob' is specified, any blank lines present
+in the input file will be copied to the output file.
+
+1.4.1 -blank-lines-after-declarations
+-------------------------------------
+
+The `-bad' option forces a blank line after every block of
+declarations. The `-nbad' option does not add any such blank lines.
+
+ For example, given the input
+ char *foo;
+ char *bar;
+ /* This separates blocks of declarations. */
+ int baz;
+
+`indent -bad' produces
+
+ char *foo;
+ char *bar;
+
+ /* This separates blocks of declarations. */
+ int baz;
+
+and `indent -nbad' produces
+
+ char *foo;
+ char *bar;
+ /* This separates blocks of declarations. */
+ int baz;
+
+1.4.2 -blank-lines-after-procedures
+-----------------------------------
+
+The `-bap' option forces a blank line after every procedure body.
+
+ For example, given the input
+
+ int
+ foo ()
+ {
+ puts("Hi");
+ }
+ /* The procedure bar is even less interesting. */
+ char *
+ bar ()
+ {
+ puts("Hello");
+ }
+
+`indent -bap' produces
+
+ int
+ foo ()
+ {
+ puts ("Hi");
+ }
+
+ /* The procedure bar is even less interesting. */
+ char *
+ bar ()
+ {
+ puts ("Hello");
+ }
+
+and `indent -nbap' produces
+
+ int
+ foo ()
+ {
+ puts ("Hi");
+ }
+ /* The procedure bar is even less interesting. */
+ char *
+ bar ()
+ {
+ puts ("Hello");
+ }
+
+No blank line will be added after the procedure `foo'.
+
+1.5 Comments
+============
+
+`indent' formats both C and C++ comments. C comments are begun with
+`/*', terminated with `*/' and may contain newline characters. C++
+comments begin with the delimiter `//' and end at the newline.
+
+ `indent' handles comments differently depending upon their context.
+`indent' attempts to distinguish between comments which follow
+statements, comments which follow declarations, comments following
+preprocessor directives, and comments which are not preceded by code of
+any sort, i.e., they begin the text of the line (although not
+neccessarily in column 1).
+
+ `indent' further distinguishes between comments found outside of
+procedures and aggregates, and those found within them. In particular,
+comments beginning a line found within a procedure will be indented to
+the column at which code is currently indented. The exception to this a
+comment beginning in the leftmost column; such a comment is output at
+that column.
+
+ `indent' attempts to leave "boxed comments" unmodified. The general
+idea of such a comment is that it is enclosed in a rectangle or "box"
+of stars or dashes to visually set it apart. More precisely, boxed
+comments are defined as those in which the initial `/*' is followed
+immediately by the character `*', `=', `_', or `-', or those in which
+the beginning comment delimiter (`/*') is on a line by itself, and the
+following line begins with a `*' in the same column as the star of the
+opening delimiter.
+
+ Examples of boxed comments are:
+
+ /**********************
+ * Comment in a box!! *
+ **********************/
+
+ /*
+ * A different kind of scent,
+ * for a different kind of comment.
+ */
+
+ `indent' attempts to leave boxed comments exactly as they are found
+in the source file. Thus the indentation of the comment is unchanged,
+and its length is not checked in any way. The only alteration made is
+that an embedded tab character may be converted into the appropriate
+number of spaces.
+
+ If the `-bbb' option is specified, all such boxed comments will be
+preceded by a blank line, unless such a comment is preceded by code.
+
+ Comments which are not boxed comments may be formatted, which means
+that the line is broken to fit within a right margin and left-filled
+with whitespace. Single newlines are equivalent to a space, but blank
+lines (two or more newlines in a row) are taken to mean a paragraph
+break. Formatting of comments which begin after the first column is
+enabled with the `-fca' option. To format those beginning in column
+one, specify `-fc1'. Such formatting is disabled by default.
+
+ The right margin for formatting defaults to 78, but may be changed
+with the `-lc' option. If the margin specified does not allow the
+comment to be printed, the margin will be automatically extended for the
+duration of that comment. The margin is not respected if the comment is
+not being formatted.
+
+ If the comment begins a line (i.e., there is no program text to its
+left), it will be indented to the column it was found in unless the
+comment is within a block of code. In that case, such a comment will be
+aligned with the indented code of that block (unless the comment began
+in the first column). This alignment may be affected by the `-d'
+option, which specifies an amount by which such comments are moved to
+the _left_, or unindented. For example, `-d2' places comments two
+spaces to the left of code. By default, comments are aligned with
+code, unless they begin in the first column, in which case they are left
+there by default -- to get them aligned with the code, specify `-fc1'.
+
+ Comments to the right of code will appear by default in column 33.
+This may be changed with one of three options. `-c' will specify the
+column for comments following code, `-cd' specifies the column for
+comments following declarations, and `-cp' specifies the column for
+comments following preprocessor directives `#else' and `#endif'.
+
+ If the code to the left of the comment exceeds the beginning column,
+the comment column will be extended to the next tabstop column past the
+end of the code, or in the case of preprocessor directives, to one
+space past the end of the directive. This extension lasts only for the
+output of that particular comment.
+
+ The `-cdb' option places the comment delimiters on blank lines.
+Thus, a single line comment like `/* Loving hug */' can be transformed
+into:
+
+ /*
+ Loving hug
+ */
+
+ Stars can be placed at the beginning of multi-line comments with the
+`-sc' option. Thus, the single-line comment above can be transformed
+(with `-cdb -sc') into:
+
+ /*
+ * Loving hug
+ */
+
+1.6 Statements
+==============
+
+The `-br' or `-bl' option specifies how to format braces.
+
+ The `-br' option formats statement braces like this:
+
+ if (x > 0) {
+ x--;
+ }
+
+The `-bl' option formats them like this:
+
+ if (x > 0)
+ {
+ x--;
+ }
+
+ If you use the `-bl' option, you may also want to specify the `-bli'
+option. This option specifies the number of spaces by which braces are
+indented. `-bli2', the default, gives the result shown above. `-bli0'
+results in the following:
+
+ if (x > 0)
+ {
+ x--;
+ }
+
+ If you are using the `-br' option, you probably want to also use the
+`-ce' option. This causes the `else' in an if-then-else construct to
+cuddle up to the immediately preceding `}'. For example, with `-br
+-ce' you get the following:
+
+ if (x > 0) {
+ x--;
+ } else {
+ fprintf (stderr, "...something wrong?\n");
+ }
+
+With `-br -nce' that code would appear as
+
+ if (x > 0) {
+ x--;
+ }
+ else {
+ fprintf (stderr, "...something wrong?\n");
+ }
+
+ This causes the `while' in a do-while loop to cuddle up to the
+immediately preceding `}'. For example, with `-cdw' you get the
+following:
+
+ do {
+ x--;
+ } while (x);
+
+With `-ncdw' that code would appear as
+
+ do {
+ x--;
+ }
+ while (x);
+
+ The `-cli' option specifies the number of spaces that case labels
+should be indented to the right of the containing `switch' statement.
+
+The default gives code like:
+
+ switch (i)
+ {
+ case 0:
+ break;
+ case 1:
+ {
+ ++i;
+ }
+ default:
+ break;
+ }
+
+ Using the `-cli2' that would become:
+
+ switch (i)
+ {
+ case 0:
+ break;
+ case 1:
+ {
+ ++i;
+ }
+ default:
+ break;
+ }
+
+ The indentation of the braces below a case statement can be
+controlled with the `-cbiN' option. For example, using `-cli2 -cbi0'
+results in:
+
+ switch (i)
+ {
+ case 0:
+ break;
+ case 1:
+ {
+ ++i;
+ }
+ default:
+ break;
+ }
+
+ If a semicolon is on the same line as a `for' or `while' statement,
+the `-ss' option will cause a space to be placed before the semicolon.
+This emphasizes the semicolon, making it clear that the body of the
+`for' or `while' statement is an empty statement. `-nss' disables this
+feature.
+
+ The `-pcs' option causes a space to be placed between the name of
+the procedure being called and the `(' (for example, `puts ("Hi");'.
+The `-npcs' option would give `puts("Hi");').
+
+ If the `-cs' option is specified, `indent' puts a space after a cast
+operator.
+
+ The `-bs' option ensures that there is a space between the keyword
+`sizeof' and its argument. In some versions, this is known as the
+`Bill_Shannon' option.
+
+ The `-saf' option forces a space between an `for' and the following
+parenthesis. This is the default.
+
+ The `-sai' option forces a space between an `if' and the following
+parenthesis. This is the default.
+
+ The `-saw' option forces a space between an `while' and the
+following parenthesis. This is the default.
+
+ The `-prs' option causes all parentheses to be seperated with a
+space from the what is between them. For example, using `-prs' results
+in code like:
+
+ while ( ( e_code - s_code ) < ( dec_ind - 1 ) )
+ {
+ set_buf_break ( bb_dec_ind );
+ *e_code++ = ' ';
+ }
+
+1.7 Declarations
+================
+
+By default `indent' will line up identifiers, in the column specified
+by the `-di' option. For example, `-di16' makes things look like:
+
+ int foo;
+ char *bar;
+
+ Using a small value (such as one or two) for the `-di' option can be
+used to cause the identifiers to be placed in the first available
+position; for example:
+
+ int foo;
+ char *bar;
+
+ The value given to the `-di' option will still affect variables
+which are put on separate lines from their types, for example `-di2'
+will lead to:
+
+ int
+ foo;
+
+ If the `-bc' option is specified, a newline is forced after each
+comma in a declaration. For example,
+
+ int a,
+ b,
+ c;
+
+With the `-nbc' option this would look like
+
+ int a, b, c;
+
+ The `-bfda' option causes a newline to be forced after the comma
+separating the arguments of a function declaration. The arguments will
+appear at one indention level deeper than the function declaration.
+This is particularly helpful for functions with long argument lists.
+The option `-bfde' causes a newline to be forced before the closing
+bracket of the function declaration. For both options the 'n' setting
+is the default: -nbdfa and -nbdfe.
+
+ For example,
+
+ void foo (int arg1, char arg2, int *arg3, long arg4, char arg5);
+With the `-bfda' option this would look like
+
+ void foo (
+ int arg1,
+ char arg2,
+ int *arg3,
+ long arg4,
+ char arg5);
+
+ With, in addition, the `-bfde' option this would look like
+
+ void foo (
+ int arg1,
+ char arg2,
+ int *arg3,
+ long arg4,
+ char arg5
+ );
+
+ The `-psl' option causes the type of a procedure being defined to be
+placed on the line before the name of the procedure. This style is
+required for the `etags' program to work correctly, as well as some of
+the `c-mode' functions of Emacs.
+
+ You must use the `-T' option to tell `indent' the name of all the
+typenames in your program that are defined by `typedef'. `-T' can be
+specified more than once, and all names specified are used. For
+example, if your program contains
+
+ typedef unsigned long CODE_ADDR;
+ typedef enum {red, blue, green} COLOR;
+
+you would use the options `-T CODE_ADDR -T COLOR'.
+
+ The `-brs' or `-bls' option specifies how to format braces in struct
+declarations. The `-brs' option formats braces like this:
+
+ struct foo {
+ int x;
+ };
+
+The `-bls' option formats them like this:
+
+ struct foo
+ {
+ int x;
+ };
+
+1.8 Indentation
+===============
+
+One issue in the formatting of code is how far each line should be
+indented from the left margin. When the beginning of a statement such
+as `if' or `for' is encountered, the indentation level is increased by
+the value specified by the `-i' option. For example, use `-i8' to
+specify an eight character indentation for each level. When a
+statement is broken across two lines, the second line is indented by a
+number of additional spaces specified by the `-ci' option. `-ci'
+defaults to 0. However, if the `-lp' option is specified, and a line
+has a left parenthesis which is not closed on that line, then
+continuation lines will be lined up to start at the character position
+just after the left parenthesis. This processing also applies to `['
+and applies to `{' when it occurs in initialization lists. For
+example, a piece of continued code might look like this with `-nlp
+-ci3' in effect:
+
+ p1 = first_procedure (second_procedure (p2, p3),
+ third_procedure (p4, p5));
+
+With `-lp' in effect the code looks somewhat clearer:
+
+ p1 = first_procedure (second_procedure (p2, p3),
+ third_procedure (p4, p5));
+
+ When a statement is broken in between two or more paren pairs (...),
+each extra pair causes the indentation level extra indentation:
+
+ if ((((i < 2 &&
+ k > 0) || p == 0) &&
+ q == 1) ||
+ n = 0)
+
+The option `-ipN' can be used to set the extra offset per paren. For
+instance, `-ip0' would format the above as:
+
+ if ((((i < 2 &&
+ k > 0) || p == 0) &&
+ q == 1) ||
+ n = 0)
+
+`indent' assumes that tabs are placed at regular intervals of both
+input and output character streams. These intervals are by default 8
+columns wide, but (as of version 1.2) may be changed by the `-ts'
+option. Tabs are treated as the equivalent number of spaces.
+
+ The indentation of type declarations in old-style function
+definitions is controlled by the `-ip' parameter. This is a numeric
+parameter specifying how many spaces to indent type declarations. For
+example, the default `-ip5' makes definitions look like this:
+
+ char *
+ create_world (x, y, scale)
+ int x;
+ int y;
+ float scale;
+ {
+ . . .
+ }
+
+ For compatibility with other versions of indent, the option `-nip'
+is provided, which is equivalent to `-ip0'.
+
+ ANSI C allows white space to be placed on preprocessor command lines
+between the character `#' and the command name. By default, `indent'
+removes this space, but specifying the `-lps' option directs `indent'
+to leave this space unmodified. The option `-ppi' overrides `-nlps'
+and `-lps'.
+
+ This option can be used to request that preprocessor conditional
+statements can be indented by to given number of spaces, for example
+with the option `-ppi 3'
+
+ #if X
+ #if Y
+ #define Z 1
+ #else
+ #define Z 0
+ #endif
+ #endif
+becomes
+ #if X
+ # if Y
+ # define Z 1
+ # else
+ # define Z 0
+ # endif
+ #endif
+
+1.9 Breaking long lines
+=======================
+
+With the option `-lN', or `--line-lengthN', it is possible to specify
+the maximum length of a line of C code, not including possible comments
+that follow it.
+
+ When lines become longer then the specified line length, GNU `indent'
+tries to break the line at a logical place. This is new as of version
+2.1 however and not very intelligent or flexible yet.
+
+ Currently there are two options that allows one to interfere with the
+algorithm that determines where to break a line.
+
+ The `-bbo' option causes GNU `indent' to prefer to break long lines
+before the boolean operators `&&' and `||'. The `-nbbo' option causes
+GNU `indent' not have that preference. For example, the default option
+`-bbo' (together with `--line-length60' and `--ignore-newlines') makes
+code look like this:
+
+ if (mask
+ && ((mask[0] == '\0')
+ || (mask[1] == '\0'
+ && ((mask[0] == '0') || (mask[0] == '*')))))
+
+ Using the option `-nbbo' will make it look like this:
+
+ if (mask &&
+ ((mask[0] == '\0') ||
+ (mask[1] == '\0' &&
+ ((mask[0] == '0') || (mask[0] == '*')))))
+
+ The default `-hnl', however, honours newlines in the input file by
+giving them the highest possible priority to break lines at. For
+example, when the input file looks like this:
+
+ if (mask
+ && ((mask[0] == '\0')
+ || (mask[1] == '\0' && ((mask[0] == '0') || (mask[0] == '*')))))
+
+then using the option `-hnl', or `--honour-newlines', together with the
+previously mentioned `-nbbo' and `--line-length60', will cause the
+output not to be what is given in the last example but instead will
+prefer to break at the positions where the code was broken in the input
+file:
+
+ if (mask
+ && ((mask[0] == '\0')
+ || (mask[1] == '\0' &&
+ ((mask[0] == '0') || (mask[0] == '*')))))
+
+ The idea behind this option is that lines which are too long, but
+are already broken up, will not be touched by GNU `indent'. Really
+messy code should be run through `indent' at least once using the
+`--ignore-newlines' option though.
+
+1.10 Disabling Formatting
+=========================
+
+Formatting of C code may be disabled for portions of a program by
+embedding special "control comments" in the program. To turn off
+formatting for a section of a program, place the disabling control
+comment `/* *INDENT-OFF* */' on a line by itself just before that
+section. Program text scanned after this control comment is output
+precisely as input with no modifications until the corresponding
+enabling comment is scanned on a line by itself. The disabling control
+comment is `/* *INDENT-ON* */', and any text following the comment on
+the line is also output unformatted. Formatting begins again with the
+input line following the enabling control comment.
+
+ More precisely, `indent' does not attempt to verify the closing
+delimiter (`*/') for these C comments, and any whitespace on the line
+is totally transparent.
+
+ These control comments also function in their C++ formats, namely
+`// *INDENT-OFF*' and `// *INDENT-ON*'.
+
+ It should be noted that the internal state of `indent' remains
+unchanged over the course of the unformatted section. Thus, for
+example, turning off formatting in the middle of a function and
+continuing it after the end of the function may lead to bizarre
+results. It is therefore wise to be somewhat modular in selecting code
+to be left unformatted.
+
+ As a historical note, some earlier versions of `indent' produced
+error messages beginning with `*INDENT**'. These versions of `indent'
+were written to ignore any input text lines which began with such error
+messages. I have removed this incestuous feature from GNU `indent'.
+
+1.11 Miscellaneous options
+==========================
+
+To find out what version of `indent' you have, use the command `indent
+-version'. This will report the version number of `indent', without
+doing any of the normal processing.
+
+ The `-v' option can be used to turn on verbose mode. When in
+verbose mode, `indent' reports when it splits one line of input into
+two more more lines of output, and gives some size statistics at
+completion.
+
+ The `-pmt' option causes `indent' to preserve the access and
+modification times on the output files. Using this option has the
+advantage that running indent on all source and header files in a
+project won't cause `make' to rebuild all targets. This option is only
+available on Operating Systems that have the POSIX `utime(2)' function.
+
+1.12 Bugs
+=========
+
+Please report any bugs to <address@hidden>.
+
+ When `indent' is run twice on a file, with the same profile, it
+should _never_ change that file the second time. With the current
+design of `indent', this can not be guaranteed, and it has not been
+extensively tested.
+
+ `indent' does not understand C. In some cases this leads to the
+inability to join lines. The result is that running a file through
+`indent' is _irreversible_, even if the used input file was the result
+of running `indent' with a given profile (`.indent.pro').
+
+ While an attempt was made to get `indent' working for C++, it will
+not do a good job on any C++ source except the very simplest.
+
+ `indent' does not look at the given `--line-length' option when
+writing comments to the output file. This results often in comments
+being put far to the right. In order to prohibit `indent' from joining
+a broken line that has a comment at the end, make sure that the
+comments start on the first line of the break.
+
+ `indent' does not count lines and comments (see the `-v' option)
+when `indent' is turned off with `/* *INDENT-OFF* */'.
+
+ Comments of the form `/*UPPERCASE*/' are not treated as comment but
+as an identifier, causing them to be joined with the next line. This
+renders comments of this type useless, unless they are embedded in the
+code to begin with.
+
+1.13 Copyright
+==============
+
+The following copyright notice applies to the `indent' program. The
+copyright and copying permissions for this manual appear near the
+beginning of `indent.texinfo' and `indent.info', and near the end of
+`indent.1'.
+
+ Copyright (C) 2001 David Ingamells.
+ Copyright (C) 1999 Carlo Wood.
+ Copyright (C) 1995, 1996 Joseph Arceneaux.
+ Copyright (C) 1989, 1992, 1993, 1994, 1995, 1996 Free Software Foundation
+ Copyright (C) 1985 Sun Microsystems, Inc.
+ Copyright (C) 1980 The Regents of the University of California.
+ Copyright (C) 1976 Board of Trustees of the University of Illinois.
+ All rights reserved.
+
+ Redistribution and use in source and binary forms are permitted
+ provided that the above copyright notice and this paragraph are
+ duplicated in all such forms and that any documentation,
+ advertising materials, and other materials related to such
+ distribution and use acknowledge that the software was developed
+ by the University of California, Berkeley, the University of Illinois,
+ Urbana, and Sun Microsystems, Inc. The name of either University
+ or Sun Microsystems may not be used to endorse or promote products
+ derived from this software without specific prior written permission.
+ THIS SOFTWARE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR
+ IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
+ WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR
+ PURPOSE.
+
+Appendix A Option Summary
+*************************
+
+Here is a list of all the options for `indent', alphabetized by short
+option. It is followed by a cross key alphabetized by long option.
+
+`-bad'
+`--blank-lines-after-declarations'
+ Force blank lines after the declarations.
+ *Note Blank lines::.
+
+`-bap'
+`--blank-lines-after-procedures'
+ Force blank lines after procedure bodies.
+ *Note Blank lines::.
+
+`-bbb'
+`--blank-lines-before-block-comments'
+ Force blank lines before block comments.
+ *Note Blank lines::.
+
+`-bbo'
+`--break-before-boolean-operator'
+ Prefer to break long lines before boolean operators.
+ *Note Breaking long lines::.
+
+`-bc'
+`--blank-lines-after-commas'
+ Force newline after comma in declaration.
+ *Note Declarations::.
+
+`-bl'
+`--braces-after-if-line'
+ Put braces on line after `if', etc.
+ *Note Statements::.
+
+`-bliN'
+`--brace-indentN'
+ Indent braces N spaces.
+ *Note Statements::.
+
+`-bls'
+`--braces-after-struct-decl-line'
+ Put braces on the line after `struct' declaration lines.
+ *Note Declarations::.
+
+`-br'
+`--braces-on-if-line'
+ Put braces on line with `if', etc.
+ *Note Statements::.
+
+`-brs'
+`--braces-on-struct-decl-line'
+ Put braces on `struct' declaration line.
+ *Note Declarations::.
+
+`-bs'
+`--Bill-Shannon'
+`--blank-before-sizeof'
+ Put a space between `sizeof' and its argument.
+ *Note Statements::.
+
+`-cN'
+`--comment-indentationN'
+ Put comments to the right of code in column N.
+ *Note Comments::.
+
+`-cbiN'
+`--case-brace-indentationN'
+ Indent braces after a case label N spaces.
+ *Note Statements::.
+
+`-cdN'
+`--declaration-comment-columnN'
+ Put comments to the right of the declarations in column N.
+ *Note Comments::.
+
+`-cdb'
+`--comment-delimiters-on-blank-lines'
+ Put comment delimiters on blank lines.
+ *Note Comments::.
+
+`-cdw'
+`--cuddle-do-while'
+ Cuddle while of `do {} while;' and preceeding `}'.
+ *Note Comments::.
+
+`-ce'
+`--cuddle-else'
+ Cuddle else and preceeding `}'.
+ *Note Comments::.
+
+`-ciN'
+`--continuation-indentationN'
+ Continuation indent of N spaces.
+ *Note Statements::.
+
+`-cliN'
+`--case-indentationN'
+ Case label indent of N spaces.
+ *Note Statements::.
+
+`-cpN'
+`--else-endif-columnN'
+ Put comments to the right of `#else' and `#endif' statements in
+ column N.
+ *Note Comments::.
+
+`-cs'
+`--space-after-cast'
+ Put a space after a cast operator.
+ *Note Statements::.
+
+`-dN'
+`--line-comments-indentationN'
+ Set indentation of comments not to the right of code to N spaces.
+ *Note Comments::.
+
+`-bfda'
+`--break-function-decl-args'
+ Break the line before all arguments in a declaration.
+ *Note Declarations::.
+
+`-bfde'
+`--break-function-decl-args'
+ Break the line after the last argument in a declaration.
+ *Note Declarations::.
+
+`-diN'
+`--declaration-indentationN'
+ Put variables in column N.
+ *Note Declarations::.
+
+`-fc1'
+`--format-first-column-comments'
+ Format comments in the first column.
+ *Note Comments::.
+
+`-fca'
+`--format-all-comments'
+ Do not disable all formatting of comments.
+ *Note Comments::.
+
+`-gnu'
+`--gnu-style'
+ Use GNU coding style. This is the default.
+ *Note Common styles::.
+
+`-hnl'
+`--honour-newlines'
+ Prefer to break long lines at the position of newlines in the
+ input.
+ *Note Breaking long lines::.
+
+`-iN'
+`--indent-levelN'
+ Set indentation level to N spaces.
+ *Note Indentation::.
+
+`-ipN'
+`--parameter-indentationN'
+ Indent parameter types in old-style function definitions by N
+ spaces.
+ *Note Indentation::.
+
+`-kr'
+`--k-and-r-style'
+ Use Kernighan & Ritchie coding style.
+ *Note Common styles::.
+
+`-lN'
+`--line-lengthN'
+ Set maximum line length for non-comment lines to N.
+ *Note Breaking long lines::.
+
+`-lcN'
+`--comment-line-lengthN'
+ Set maximum line length for comment formatting to N.
+ *Note Comments::.
+
+`-lp'
+`--continue-at-parentheses'
+ Line up continued lines at parentheses.
+ *Note Indentation::.
+
+`-lps'
+`--leave-preprocessor-space'
+ Leave space between `#' and preprocessor directive.
+ *Note Indentation::.
+
+`-nbad'
+`--no-blank-lines-after-declarations'
+ Do not force blank lines after declarations.
+ *Note Blank lines::.
+
+`-nbap'
+`--no-blank-lines-after-procedures'
+ Do not force blank lines after procedure bodies.
+ *Note Blank lines::.
+
+`-nbbo'
+`--break-after-boolean-operator'
+ Do not prefer to break long lines before boolean operators.
+ *Note Breaking long lines::.
+
+`-nbc'
+`--no-blank-lines-after-commas'
+ Do not force newlines after commas in declarations.
+ *Note Declarations::.
+
+`-nbfda'
+`--dont-break-function-decl-args'
+ Don't put each argument in a function declaration on a seperate
+ line.
+ *Note Declarations::.
+
+`-ncdb'
+`--no-comment-delimiters-on-blank-lines'
+ Do not put comment delimiters on blank lines.
+ *Note Comments::.
+
+`-ncdw'
+`--dont-cuddle-do-while'
+ Do not cuddle `}' and the `while' of a `do {} while;'.
+ *Note Statements::.
+
+`-nce'
+`--dont-cuddle-else'
+ Do not cuddle `}' and `else'.
+ *Note Statements::.
+
+`-ncs'
+`--no-space-after-casts'
+ Do not put a space after cast operators.
+ *Note Statements::.
+
+`-nfc1'
+`--dont-format-first-column-comments'
+ Do not format comments in the first column as normal.
+ *Note Comments::.
+
+`-nfca'
+`--dont-format-comments'
+ Do not format any comments.
+ *Note Comments::.
+
+`-nhnl'
+`--ignore-newlines'
+ Do not prefer to break long lines at the position of newlines in
+ the input.
+ *Note Breaking long lines::.
+
+`-nip'
+`--no-parameter-indentation'
+ Zero width indentation for parameters.
+ *Note Indentation::.
+
+`-nlp'
+`--dont-line-up-parentheses'
+ Do not line up parentheses.
+ *Note Statements::.
+
+`-npcs'
+`--no-space-after-function-call-names'
+ Do not put space after the function in function calls.
+ *Note Statements::.
+
+`-nprs'
+`--no-space-after-parentheses'
+ Do not put a space after every '(' and before every ')'.
+ *Note Statements::.
+
+`-npsl'
+`--dont-break-procedure-type'
+ Put the type of a procedure on the same line as its name.
+ *Note Declarations::.
+
+`-nsaf'
+`--no-space-after-for'
+ Do not put a space after every `for'.
+ *Note Statements::.
+
+`-nsai'
+`--no-space-after-if'
+ Do not put a space after every `if'.
+ *Note Statements::.
+
+`-nsaw'
+`--no-space-after-while'
+ Do not put a space after every `while'.
+ *Note Statements::.
+
+`-nsc'
+`--dont-star-comments'
+ Do not put the `*' character at the left of comments.
+ *Note Comments::.
+
+`-nsob'
+`--leave-optional-blank-lines'
+ Do not swallow optional blank lines.
+ *Note Blank lines::.
+
+`-nss'
+`--dont-space-special-semicolon'
+ Do not force a space before the semicolon after certain statements.
+ Disables `-ss'.
+ *Note Statements::.
+
+`-nut'
+`--no-tabs'
+ Use spaces instead of tabs.
+ *Note Indentation::.
+
+`-nv'
+`--no-verbosity'
+ Disable verbose mode.
+ *Note Miscellaneous options::.
+
+`-orig'
+`--original'
+ Use the original Berkeley coding style.
+ *Note Common styles::.
+
+`-npro'
+`--ignore-profile'
+ Do not read `.indent.pro' files.
+ *Note Invoking indent::.
+
+`-pcs'
+`--space-after-procedure-calls'
+ Insert a space between the name of the procedure being called and
+ the `('.
+ *Note Statements::.
+
+`-piN'
+`--paren-indentationN'
+ Specify the extra indentation per open parentheses '(' when a
+ statement is broken. *Note Statements::.
+
+`-pmt'
+`--preserve-mtime'
+ Preserve access and modification times on output files. *Note
+ Miscellaneous options::.
+
+`-prs'
+`--space-after-parentheses'
+ Put a space after every '(' and before every ')'.
+ *Note Statements::.
+
+`-psl'
+`--procnames-start-lines'
+ Put the type of a procedure on the line before its name.
+ *Note Declarations::.
+
+`-saf'
+`--space-after-for'
+ Put a space after each `for'.
+ *Note Statements::.
+
+`-sai'
+`--space-after-if'
+ Put a space after each `if'.
+ *Note Statements::.
+
+`-saw'
+`--space-after-while'
+ Put a space after each `while'.
+ *Note Statements::.
+
+`-sbiN'
+`--struct-brace-indentationN'
+ Indent braces of a struct, union or enum N spaces.
+ *Note Statements::.
+
+`-sc'
+`--start-left-side-of-comments'
+ Put the `*' character at the left of comments.
+ *Note Comments::.
+
+`-sob'
+`--swallow-optional-blank-lines'
+ Swallow optional blank lines.
+ *Note Blank lines::.
+
+`-ss'
+`--space-special-semicolon'
+ On one-line `for' and `while' statments, force a blank before the
+ semicolon.
+ *Note Statements::.
+
+`-st'
+`--standard-output'
+ Write to standard output.
+ *Note Invoking indent::.
+
+`-T'
+ Tell `indent' the name of typenames.
+ *Note Declarations::.
+
+`-tsN'
+`--tab-sizeN'
+ Set tab size to N spaces.
+ *Note Indentation::.
+
+`-ut'
+`--use-tabs'
+ Use tabs. This is the default.
+ *Note Indentation::.
+
+`-v'
+`--verbose'
+ Enable verbose mode.
+ *Note Miscellaneous options::.
+
+`-version'
+ Output the version number of `indent'.
+ *Note Miscellaneous options::.
+
+Options' Cross Key
+------------------
+
+Here is a list of options alphabetized by long option, to help you find
+the corresponding short option.
+
+ --blank-lines-after-commas -bc
+ --blank-lines-after-declarations -bad
+ --blank-lines-after-procedures -bap
+ --blank-lines-before-block-comments -bbb
+ --braces-after-if-line -bl
+ --brace-indent -bli
+ --braces-after-struct-decl-line -bls
+ --braces-on-if-line -br
+ --braces-on-struct-decl-line -brs
+ --break-after-boolean-operator -nbbo
+ --break-before-boolean-operator -bbo
+ --break-function-decl-args -bfda
+ --break-function-decl-args-end -bfde
+ --case-indentation -cliN
+ --case-brace-indentation -cbiN
+ --comment-delimiters-on-blank-lines -cdb
+ --comment-indentation -cN
+ --continuation-indentation -ciN
+ --continue-at-parentheses -lp
+ --cuddle-do-while -cdw
+ --cuddle-else -ce
+ --declaration-comment-column -cdN
+ --declaration-indentation -diN
+ --dont-break-function-decl-args -nbfda
+ --dont-break-function-decl-args-end -nbfde
+ --dont-break-procedure-type -npsl
+ --dont-cuddle-do-while -ncdw
+ --dont-cuddle-else -nce
+ --dont-format-comments -nfca
+ --dont-format-first-column-comments -nfc1
+ --dont-line-up-parentheses -nlp
+ --dont-space-special-semicolon -nss
+ --dont-star-comments -nsc
+ --else-endif-column -cpN
+ --format-all-comments -fca
+ --format-first-column-comments -fc1
+ --gnu-style -gnu
+ --honour-newlines -hnl
+ --ignore-newlines -nhnl
+ --ignore-profile -npro
+ --indent-level -iN
+ --k-and-r-style -kr
+ --leave-optional-blank-lines -nsob
+ --leave-preprocessor-space -lps
+ --line-comments-indentation -dN
+ --line-length -lN
+ --no-blank-lines-after-commas -nbc
+ --no-blank-lines-after-declarations -nbad
+ --no-blank-lines-after-procedures -nbap
+ --no-blank-lines-before-block-comments -nbbb
+ --no-comment-delimiters-on-blank-lines -ncdb
+ --no-space-after-casts -ncs
+ --no-parameter-indentation -nip
+ --no-space-after-for -nsaf
+ --no-space-after-function-call-names -npcs
+ --no-space-after-if -nsai
+ --no-space-after-parentheses -nprs
+ --no-space-after-while -nsaw
+ --no-tabs -nut
+ --no-verbosity -nv
+ --original -orig
+ --parameter-indentation -ipN
+ --paren-indentation -piN
+ --preserve-mtime -pmt
+ --procnames-start-lines -psl
+ --space-after-cast -cs
+ --space-after-for -saf
+ --space-after-if -sai
+ --space-after-parentheses -prs
+ --space-after-procedure-calls -pcs
+ --space-after-while -saw
+ --space-special-semicolon -ss
+ --standard-output -st
+ --start-left-side-of-comments -sc
+ --struct-brace-indentation -sbiN
+ --swallow-optional-blank-lines -sob
+ --tab-size -tsN
+ --use-tabs -ut
+ --verbose -v
+
+Index
+*****
+
+--blank-after-sizeof: See 1.6. (line 539)
+--blank-lines-after-commas: See 1.7. (line 585)
+--blank-lines-after-declarations: See 1.4.1. (line 248)
+--blank-lines-after-procedures: See 1.4.2. (line 266)
+--blank-lines-before-block-comments: See 1.4. (line 228)
+--brace-indentN: See 1.6. (line 434)
+--braces-after-if-line: See 1.6. (line 419)
+--braces-on-if-line: See 1.6. (line 419)
+--break-after-boolean-operator: See 1.9. (line 756)
+--break-before-boolean-operator: See 1.9. (line 756)
+--break-function-decl-args: See 1.7. (line 596)
+--break-function-decl-args-end: See 1.7. (line 596)
+--case-brace-indentationN: See 1.6. (line 510)
+--case-indentationN: See 1.6. (line 479)
+--comment-delimiters-on-blank-lines: See 1.5. (line 400)
+--comment-indentationN: See 1.5. (line 388)
+--continuation-indentationN: See 1.8. (line 658)
+--continue-at-parentheses: See 1.8. (line 658)
+--cuddle-do-while: See 1.6. (line 464)
+--cuddle-else: See 1.6. (line 444)
+--declaration-comment-columnN: See 1.5. (line 388)
+--declaration-indentationN: See 1.7. (line 565)
+--dont-break-function-decl-args: See 1.7. (line 596)
+--dont-break-function-decl-args-end: See 1.7. (line 596)
+--dont-break-procedure-type: See 1.7. (line 626)
+--dont-cuddle-do-while: See 1.6. (line 464)
+--dont-cuddle-else: See 1.6. (line 444)
+--dont-format-comments: See 1.5. (line 363)
+--dont-format-first-column-comments: See 1.5. (line 363)
+--dont-line-up-parentheses: See 1.8. (line 658)
+--dont-space-special-semicolon: See 1.6. (line 526)
+--dont-star-comments: See 1.5. (line 408)
+--else-endif-columnN: See 1.5. (line 388)
+--format-all-comments: See 1.5. (line 363)
+--format-first-column-comments: See 1.5. (line 363)
+--gnu-style: See 1.3. (line 176)
+--honour-newlines: See 1.9. (line 756)
+--ignore-newlines: See 1.9. (line 756)
+--ignore-profile: See 1.1. (line 97)
+--indent-levelN: See 1.8. (line 658)
+--k-and-r-style: See 1.3. (line 192)
+--leave-optional-blank-lines: See 1.4. (line 231)
+--leave-preprocessor-space: See 1.8. (line 719)
+--line-comments-indentationN: See 1.5. (line 377)
+--line-lengthN: See 1.9. (line 748)
+--no-blank-lines-after-commas: See 1.7. (line 585)
+--no-blank-lines-after-declarations: See 1.4.1. (line 248)
+--no-blank-lines-after-procedures: See 1.4.2. (line 266)
+--no-blank-lines-before-block-comments: See 1.4. (line 228)
+--no-comment-delimiters-on-blank-lines: See 1.5. (line 400)
+--no-parameter-indentation: See 1.8. (line 702)
+--no-space-after-casts: See 1.6. (line 536)
+--no-space-after-for: See 1.6. (line 543)
+--no-space-after-function-call-names: See 1.6. (line 532)
+--no-space-after-if: See 1.6. (line 546)
+--no-space-after-while: See 1.6. (line 549)
+--no-verbosity: See 1.11. (line 841)
+--original: See 1.3. (line 206)
+--output-file: See 1.1. (line 51)
+--parameter-indentationN: See 1.8. (line 702)
+--preprocessor-indentationN: See 1.8. (line 725)
+--preserve-mtime: See 1.11. (line 846)
+--procnames-start-lines: See 1.7. (line 626)
+--remove-preprocessor-space: See 1.8. (line 719)
+--space-after-cast: See 1.6. (line 536)
+--space-after-for: See 1.6. (line 543)
+--space-after-if: See 1.6. (line 546)
+--space-after-parentheses: See 1.6. (line 552)
+--space-after-procedure-calls: See 1.6. (line 532)
+--space-after-while: See 1.6. (line 549)
+--space-special-semicolon: See 1.6. (line 526)
+--standard-output: See 1.1. (line 55)
+--star-left-side-of-comments: See 1.5. (line 408)
+--swallow-optional-blank-lines: See 1.4. (line 231)
+--tab-sizeN: See 1.8. (line 681)
+--verbose: See 1.11. (line 841)
+-bad: See 1.4.1. (line 248)
+-bap: See 1.4.2. (line 266)
+-bbb: See 1.4. (line 228)
+-bbo: See 1.9. (line 756)
+-bc: See 1.7. (line 585)
+-bfda: See 1.7. (line 596)
+-bfde: See 1.7. (line 596)
+-bl: See 1.6. (line 419)
+-bliN: See 1.6. (line 434)
+-br: See 1.6. (line 419)
+-bs: See 1.6. (line 539)
+-cbiN: See 1.6. (line 510)
+-cdb: See 1.5. (line 400)
+-cdN: See 1.5. (line 388)
+-cdw: See 1.6. (line 464)
+-ce: See 1.6. (line 444)
+-ciN: See 1.8. (line 658)
+-cliN: See 1.6. (line 479)
+-cN: See 1.5. (line 388)
+-cpN: See 1.5. (line 388)
+-cs: See 1.6. (line 536)
+-dce: See 1.6. (line 444)
+-diN: See 1.7. (line 565)
+-dN: See 1.5. (line 377)
+-fc1: See 1.5. (line 363)
+-fca: See 1.5. (line 363)
+-gnu: See 1.3. (line 176)
+-hnl: See 1.9. (line 756)
+-iN: See 1.8. (line 658)
+-ipN: See 1.8. (line 702)
+-kr: See 1.3. (line 192)
+-lN: See 1.9. (line 748)
+-lp: See 1.8. (line 658)
+-lps: See 1.8. (line 719)
+-nbad: See 1.4.1. (line 248)
+-nbap: See 1.4.2. (line 266)
+-nbbb: See 1.4. (line 228)
+-nbbo: See 1.9. (line 756)
+-nbc: See 1.7. (line 585)
+-nbfda: See 1.7. (line 596)
+-nbfde: See 1.7. (line 596)
+-ncdb: See 1.5. (line 400)
+-ncdw: See 1.6. (line 464)
+-ncs: See 1.6. (line 536)
+-nfc1: See 1.5. (line 363)
+-nfca: See 1.5. (line 363)
+-nhnl: See 1.9. (line 756)
+-nip: See 1.8. (line 702)
+-nlp: See 1.8. (line 658)
+-nlps: See 1.8. (line 719)
+-npcs: See 1.6. (line 532)
+-npmt: See 1.11. (line 846)
+-npro: See 1.1. (line 97)
+-npsl: See 1.7. (line 626)
+-nsaf: See 1.6. (line 543)
+-nsai: See 1.6. (line 546)
+-nsaw: See 1.6. (line 549)
+-nsc: See 1.5. (line 408)
+-nsob: See 1.4. (line 231)
+-nss: See 1.6. (line 526)
+-nv: See 1.11. (line 841)
+-o: See 1.1. (line 51)
+-orig: See 1.3. (line 206)
+-pcs: See 1.6. (line 532)
+-pmt: See 1.11. (line 846)
+-ppiN: See 1.8. (line 725)
+-prs: See 1.6. (line 552)
+-psl: See 1.7. (line 626)
+-saf: See 1.6. (line 543)
+-sai: See 1.6. (line 546)
+-saw: See 1.6. (line 549)
+-sc: See 1.5. (line 408)
+-sob: See 1.4. (line 231)
+-ss: See 1.6. (line 526)
+-st: See 1.1. (line 55)
+-T: See 1.7. (line 631)
+-tsN: See 1.8. (line 681)
+-v: See 1.11. (line 841)
+-version: See 1.11. (line 837)
+.indent.pro file: See 1.1. (line 97)
+backup files: See 1.2. (line 127)
+Beginning indent: See 1.1. (line 36)
+Berkeley style: See 1.3. (line 206)
+Blank lines: See 1.4. (line 217)
+Comments: See 1.5. (line 316)
+etags requires -psl: See 1.7. (line 626)
+GNU style: See 1.3. (line 176)
+Initialization file: See 1.1. (line 97)
+Invoking indent: See 1.1. (line 36)
+Kernighan & Ritchie style: See 1.3. (line 192)
+Long options, use of: See 1.1. (line 73)
+Original Berkeley style: See 1.3. (line 206)
+Output File Specification: See 1.1. (line 51)
+Standard Output: See 1.1. (line 55)
+Starting indent: See 1.1. (line 36)
+typedef: See 1.7. (line 631)
+Typenames: See 1.7. (line 631)
+Using Standard Input: See 1.1. (line 59)
+Table of Contents
+*****************
+
+`indent': Indent and Format C Program Source
+1 The `indent' Program
+ 1.1 Invoking `indent'
+ 1.2 Backup Files
+ 1.3 Common styles
+ 1.4 Blank lines
+ 1.4.1 -blank-lines-after-declarations
+ 1.4.2 -blank-lines-after-procedures
+ 1.5 Comments
+ 1.6 Statements
+ 1.7 Declarations
+ 1.8 Indentation
+ 1.9 Breaking long lines
+ 1.10 Disabling Formatting
+ 1.11 Miscellaneous options
+ 1.12 Bugs
+ 1.13 Copyright
+Appendix A Option Summary
+Index
+
+
Index: software/indent/manual/indent.txt.gz
===================================================================
RCS file: software/indent/manual/indent.txt.gz
diff -N software/indent/manual/indent.txt.gz
Binary files /dev/null and /tmp/cvsGLPvq7 differ
Index: software/indent/manual/index.html
===================================================================
RCS file: software/indent/manual/index.html
diff -N software/indent/manual/index.html
--- /dev/null 1 Jan 1970 00:00:00 -0000
+++ software/indent/manual/index.html 18 Sep 2008 15:14:57 -0000 1.1
@@ -0,0 +1,82 @@
+<!--#include virtual="/server/header.html" -->
+<title>Indent Code Formatter - GNU Project - Free Software Foundation
(FSF)</title>
+<!--#include virtual="/server/banner.html" -->
+<h2>Indent Code Formatter</h2>
+
+<!-- This document is in XML, and xhtml 1.0 -->
+<!-- Please make sure to properly nest your tags -->
+<!-- and ensure that your final document validates -->
+<!-- consistent with W3C xhtml 1.0 and CSS standards -->
+<!-- See validator.w3.org -->
+
+<address>Free Software Foundation</address>
+<address>last updated September 18, 2008</address>
+
+<p>This manual (indent) is available in the following formats:</p>
+
+<ul>
+<li><a href="indent.html">HTML
+ (K bytes)</a> - entirely on one web page.</li>
+<li><a href="html_node/index.html">HTML</a> - with one web page per
+ node.</li>
+<li><a href="indent.html.gz">HTML compressed
+ (0K gzipped characters)</a> - entirely on
+ one web page.</li>
+<li><a href="indent.html_node.tar.gz">HTML compressed
+ (24K gzipped tar file)</a> -
+ with one web page per node.</li>
+<li><a href="indent.info.tar.gz">Info document
+ (16K bytes gzipped tar file)</a>.</li>
+<li><a href="indent.txt">ASCII text
+ (64K bytes)</a>.</li>
+<li><a href="indent.txt.gz">ASCII text compressed
+ (16K bytes gzipped)</a>.</li>
+<li><a href="indent.dvi.gz">TeX dvi file
+ (28K bytes gzipped)</a>.</li>
+<li><a href="indent.ps.gz">PostScript file
+ (124K bytes gzipped)</a>.</li>
+<li><a href="indent.pdf">PDF file
+ (220K bytes)</a>.</li>
+<li><a href="indent.texi.tar.gz">Texinfo source
+ (20K bytes gzipped tar file).</a></li>
+</ul>
+
+<p>You can <a href="http://shop.fsf.org/">buy printed copies of
+some manuals</a> (among other items) from the Free Software Foundation;
+this helps support FSF activities.</p>
+
+<p>(This page generated by the <a
href="http://savannah.gnu.org/cgi-bin/viewcvs/~checkout~/texinfo/texinfo/util/gendocs.sh">gendocs.sh
+script</a>.)</p>
+
+<!-- If needed, change the copyright block at the bottom. In general, -->
+<!-- all pages on the GNU web server should have the section about -->
+<!-- verbatim copying. Please do NOT remove this without talking -->
+<!-- with the webmasters first. -->
+<!-- Please make sure the copyright date is consistent with the document -->
+<!-- and that it is like this "2001, 2002" not this "2001-2002." -->
+</div><!-- for id="content", starts in the include above -->
+<!--#include virtual="/server/footer.html" -->
+<div id="footer">
+
+<p>
+Please send FSF & GNU inquiries to
+<a href="mailto:address@hidden"><em>address@hidden</em></a>.
+There are also <a href="/contact/">other ways to contact</a>
+the FSF.
+<br />
+Please send broken links and other corrections or suggestions to
+<a href="mailto:address@hidden"><em>address@hidden</em></a>.
+</p>
+
+<p>
+Copyright © 2008 Free Software Foundation, Inc.,
+</p>
+<address>51 Franklin Street, Fifth Floor, Boston, MA 02111, USA</address>
+<p>Verbatim copying and distribution of this entire article is
+permitted in any medium, provided this notice is preserved.
+</p>
+
+</div>
+</div>
+</body>
+</html>
Index: software/indent/manual/html_node/Backup-files.html
===================================================================
RCS file: software/indent/manual/html_node/Backup-files.html
diff -N software/indent/manual/html_node/Backup-files.html
--- /dev/null 1 Jan 1970 00:00:00 -0000
+++ software/indent/manual/html_node/Backup-files.html 18 Sep 2008 15:15:01
-0000 1.1
@@ -0,0 +1,80 @@
+<html lang="en">
+<head>
+<title>Backup files - `indent': Indent and Format C Program Source</title>
+<meta http-equiv="Content-Type" content="text/html">
+<meta name="description" content="`indent': Indent and Format C Program
Source">
+<meta name="generator" content="makeinfo 4.11">
+<link title="Top" rel="start" href="index.html#Top">
+<link rel="up" href="Indent-Program.html#Indent-Program" title="Indent
Program">
+<link rel="prev" href="Invoking-indent.html#Invoking-indent" title="Invoking
indent">
+<link rel="next" href="Common-styles.html#Common-styles" title="Common styles">
+<link href="http://www.gnu.org/software/texinfo/" rel="generator-home"
title="Texinfo Homepage">
+<meta http-equiv="Content-Style-Type" content="text/css">
+<style type="text/css"><!--
+ pre.display { font-family:inherit }
+ pre.format { font-family:inherit }
+ pre.smalldisplay { font-family:inherit; font-size:smaller }
+ pre.smallformat { font-family:inherit; font-size:smaller }
+ pre.smallexample { font-size:smaller }
+ pre.smalllisp { font-size:smaller }
+ span.sc { font-variant:small-caps }
+ span.roman { font-family:serif; font-weight:normal; }
+ span.sansserif { font-family:sans-serif; font-weight:normal; }
+--></style>
+</head>
+<body>
+<div class="node">
+<p>
+<a name="Backup-files"></a>
+Next: <a rel="next" accesskey="n"
href="Common-styles.html#Common-styles">Common styles</a>,
+Previous: <a rel="previous" accesskey="p"
href="Invoking-indent.html#Invoking-indent">Invoking indent</a>,
+Up: <a rel="up" accesskey="u"
href="Indent-Program.html#Indent-Program">Indent Program</a>
+<hr>
+</div>
+
+<!-- node-name, next, previous, up -->
+<h3 class="section">1.2 Backup Files</h3>
+
+<p><a name="index-backup-files-16"></a>As of version 1.3, GNU <samp><span
class="command">indent</span></samp> makes GNU-style backup files, the
+same way GNU Emacs does. This means that either <dfn>simple</dfn> or
+<dfn>numbered</dfn> backup filenames may be made.
+
+ <p>Simple backup file names are generated by appending a suffix to the
+original file name. The default for this suffix is the
+one-character string <samp><span class="file">~</span></samp> (tilde). Thus,
the backup file for
+<samp><span class="file">python.c</span></samp> would be <samp><span
class="file">python.c~</span></samp>.
+
+ <p>Instead of the default, you may specify any string as a suffix by
+setting the environment variable <samp><span
class="env">SIMPLE_BACKUP_SUFFIX</span></samp> to
+your preferred suffix.
+
+ <p>Numbered backup versions of a file <samp><span
class="file">momeraths.c</span></samp> look like
+<samp><span class="file">momeraths.c.~23~</span></samp>, where 23 is the
version of this particular
+backup. When making a numbered backup of the file <samp><span
class="file">src/momeraths.c</span></samp>,
+the backup file will be named <samp><span
class="file">src/momeraths.c.~</span><var>V</var><span
class="file">~</span></samp>, where
+<var>V</var> is one greater than the highest version currently existing in
+the directory <samp><span class="file">src</span></samp>. The environment
variable <samp><span class="env">VERSION_WIDTH</span></samp>
+controls the number of digits, using left zero padding when necessary.
+For instance, setting this variable to "2" will lead to the backup
+file being named <samp><span class="file">momeraths.c.~04~</span></samp>.
+
+ <p>The type of backup file made is controlled by the value of the
+environment variable <samp><span class="env">VERSION_CONTROL</span></samp>.
If it is the string
+‘<samp><span class="samp">simple</span></samp>’, then only simple
backups will be made. If its value is
+the string ‘<samp><span class="samp">numbered</span></samp>’, then
numbered backups will be made. If its
+value is ‘<samp><span
class="samp">numbered-existing</span></samp>’, then numbered backups will
be made if
+there <em>already exist</em> numbered backups for the file being indented;
+otherwise, a simple backup is made. If <samp><span
class="env">VERSION_CONTROL</span></samp> is not
+set, then <samp><span class="command">indent</span></samp> assumes the
behaviour of
+‘<samp><span class="samp">numbered-existing</span></samp>’.
+
+ <p>Other versions of <samp><span class="command">indent</span></samp> use
the suffix <samp><span class="file">.BAK</span></samp> in naming
+backup files. This behaviour can be emulated by setting
+<samp><span class="env">SIMPLE_BACKUP_SUFFIX</span></samp> to
‘<samp><span class="samp">.BAK</span></samp>’.
+
+ <p>Note also that other versions of <samp><span
class="command">indent</span></samp> make backups in the
+current directory, rather than in the directory of the source file as
+GNU <samp><span class="command">indent</span></samp> now does.
+
+ </body></html>
+
Index: software/indent/manual/html_node/Blank-lines.html
===================================================================
RCS file: software/indent/manual/html_node/Blank-lines.html
diff -N software/indent/manual/html_node/Blank-lines.html
--- /dev/null 1 Jan 1970 00:00:00 -0000
+++ software/indent/manual/html_node/Blank-lines.html 18 Sep 2008 15:15:01
-0000 1.1
@@ -0,0 +1,60 @@
+<html lang="en">
+<head>
+<title>Blank lines - `indent': Indent and Format C Program Source</title>
+<meta http-equiv="Content-Type" content="text/html">
+<meta name="description" content="`indent': Indent and Format C Program
Source">
+<meta name="generator" content="makeinfo 4.11">
+<link title="Top" rel="start" href="index.html#Top">
+<link rel="up" href="Indent-Program.html#Indent-Program" title="Indent
Program">
+<link rel="prev" href="Common-styles.html#Common-styles" title="Common styles">
+<link rel="next" href="Comments.html#Comments" title="Comments">
+<link href="http://www.gnu.org/software/texinfo/" rel="generator-home"
title="Texinfo Homepage">
+<meta http-equiv="Content-Style-Type" content="text/css">
+<style type="text/css"><!--
+ pre.display { font-family:inherit }
+ pre.format { font-family:inherit }
+ pre.smalldisplay { font-family:inherit; font-size:smaller }
+ pre.smallformat { font-family:inherit; font-size:smaller }
+ pre.smallexample { font-size:smaller }
+ pre.smalllisp { font-size:smaller }
+ span.sc { font-variant:small-caps }
+ span.roman { font-family:serif; font-weight:normal; }
+ span.sansserif { font-family:sans-serif; font-weight:normal; }
+--></style>
+</head>
+<body>
+<div class="node">
+<p>
+<a name="Blank-lines"></a>
+Next: <a rel="next" accesskey="n"
href="Comments.html#Comments">Comments</a>,
+Previous: <a rel="previous" accesskey="p"
href="Common-styles.html#Common-styles">Common styles</a>,
+Up: <a rel="up" accesskey="u"
href="Indent-Program.html#Indent-Program">Indent Program</a>
+<hr>
+</div>
+
+<!-- node-name, next, previous, up -->
+<h3 class="section">1.4 Blank lines</h3>
+
+<p><a name="index-Blank-lines-27"></a>
+Various programming styles use blank lines in different places.
+<samp><span class="command">indent</span></samp> has a number of options to
insert or delete blank lines in
+specific places.
+
+ <p>The <samp><span class="option">-bad</span></samp> option causes
<samp><span class="command">indent</span></samp> to force a blank line after
+every block of declarations. The <samp><span
class="option">-nbad</span></samp> option causes
+<samp><span class="command">indent</span></samp> not to force such blank lines.
+
+ <p>The <samp><span class="option">-bap</span></samp> option forces a blank
line after every procedure body.
+The <samp><span class="option">-nbap</span></samp> option forces no such blank
line.
+
+ <p><a name="index-g_t_002dbbb-28"></a><a
name="index-g_t_002d_002dblank_002dlines_002dbefore_002dblock_002dcomments-29"></a><a
name="index-g_t_002dnbbb-30"></a><a
name="index-g_t_002d_002dno_002dblank_002dlines_002dbefore_002dblock_002dcomments-31"></a>The
<samp><span class="option">-bbb</span></samp> option forces a blank line
before every boxed comment
+(See <a href="Comments.html#Comments">Comments</a>.)
+The <samp><span class="option">-nbbb</span></samp> option does not force such
blank lines.
+
+ <p><a name="index-g_t_002dsob-32"></a><a
name="index-g_t_002d_002dswallow_002doptional_002dblank_002dlines-33"></a><a
name="index-g_t_002dnsob-34"></a><a
name="index-g_t_002d_002dleave_002doptional_002dblank_002dlines-35"></a>The
<samp><span class="option">-sob</span></samp> option causes <samp><span
class="command">indent</span></samp> to swallow optional blank
+lines (that is, any optional blank lines present in the input will be
+removed from the output). If the <samp><span
class="option">-nsob</span></samp> is specified, any blank
+lines present in the input file will be copied to the output file.
+
+ </body></html>
+
Index: software/indent/manual/html_node/Breaking-long-lines.html
===================================================================
RCS file: software/indent/manual/html_node/Breaking-long-lines.html
diff -N software/indent/manual/html_node/Breaking-long-lines.html
--- /dev/null 1 Jan 1970 00:00:00 -0000
+++ software/indent/manual/html_node/Breaking-long-lines.html 18 Sep 2008
15:15:02 -0000 1.1
@@ -0,0 +1,93 @@
+<html lang="en">
+<head>
+<title>Breaking long lines - `indent': Indent and Format C Program
Source</title>
+<meta http-equiv="Content-Type" content="text/html">
+<meta name="description" content="`indent': Indent and Format C Program
Source">
+<meta name="generator" content="makeinfo 4.11">
+<link title="Top" rel="start" href="index.html#Top">
+<link rel="up" href="Indent-Program.html#Indent-Program" title="Indent
Program">
+<link rel="prev" href="Indentation.html#Indentation" title="Indentation">
+<link rel="next" href="Disabling-Formatting.html#Disabling-Formatting"
title="Disabling Formatting">
+<link href="http://www.gnu.org/software/texinfo/" rel="generator-home"
title="Texinfo Homepage">
+<meta http-equiv="Content-Style-Type" content="text/css">
+<style type="text/css"><!--
+ pre.display { font-family:inherit }
+ pre.format { font-family:inherit }
+ pre.smalldisplay { font-family:inherit; font-size:smaller }
+ pre.smallformat { font-family:inherit; font-size:smaller }
+ pre.smallexample { font-size:smaller }
+ pre.smalllisp { font-size:smaller }
+ span.sc { font-variant:small-caps }
+ span.roman { font-family:serif; font-weight:normal; }
+ span.sansserif { font-family:sans-serif; font-weight:normal; }
+--></style>
+</head>
+<body>
+<div class="node">
+<p>
+<a name="Breaking-long-lines"></a>
+Next: <a rel="next" accesskey="n"
href="Disabling-Formatting.html#Disabling-Formatting">Disabling Formatting</a>,
+Previous: <a rel="previous" accesskey="p"
href="Indentation.html#Indentation">Indentation</a>,
+Up: <a rel="up" accesskey="u"
href="Indent-Program.html#Indent-Program">Indent Program</a>
+<hr>
+</div>
+
+<!-- node-name, next, previous, up -->
+<h3 class="section">1.9 Breaking long lines</h3>
+
+<p><a name="index-g_t_002dl_0040var_007bn_007d-157"></a><a
name="index-g_t_002d_002dline_002dlength_0040var_007bn_007d-158"></a>With the
option <samp><span class="option">-l</span><var>n</var></samp>, or <samp><span
class="option">--line-length</span><var>n</var></samp>, it is
+possible to specify the maximum length of a line of C code, not including
+possible comments that follow it.
+
+ <p>When lines become longer then the specified line length, GNU <samp><span
class="command">indent</span></samp>
+tries to break the line at a logical place. This is new as of version 2.1
+however and not very intelligent or flexible yet.
+
+ <p><a name="index-g_t_002dbbo-159"></a><a
name="index-g_t_002d_002dbreak_002dbefore_002dboolean_002doperator-160"></a><a
name="index-g_t_002dnbbo-161"></a><a
name="index-g_t_002d_002dbreak_002dafter_002dboolean_002doperator-162"></a><a
name="index-g_t_002dhnl-163"></a><a
name="index-g_t_002d_002dhonour_002dnewlines-164"></a><a
name="index-g_t_002dnhnl-165"></a><a
name="index-g_t_002d_002dignore_002dnewlines-166"></a>Currently there are two
options that allows one to interfere with the
+algorithm that determines where to break a line.
+
+ <p>The <samp><span class="option">-bbo</span></samp> option causes GNU
<samp><span class="command">indent</span></samp> to prefer to break
+long lines before the boolean operators <code>&&</code> and
<code>||</code>. The
+<samp><span class="option">-nbbo</span></samp> option causes GNU <samp><span
class="command">indent</span></samp> not have that
+preference. For example, the default option <samp><span
class="option">-bbo</span></samp> (together
+with <samp><span class="option">--line-length60</span></samp> and <samp><span
class="option">--ignore-newlines</span></samp>) makes code
+look like this:
+
+<pre class="example"> if (mask
+ && ((mask[0] == '\0')
+ || (mask[1] == '\0'
+ && ((mask[0] == '0') || (mask[0] == '*')))))
+</pre>
+ <p>Using the option <samp><span class="option">-nbbo</span></samp> will
make it look like this:
+
+<pre class="example"> if (mask &&
+ ((mask[0] == '\0') ||
+ (mask[1] == '\0' &&
+ ((mask[0] == '0') || (mask[0] == '*')))))
+</pre>
+ <p>The default <samp><span class="option">-hnl</span></samp>, however,
honours newlines in the input file by
+giving them the highest possible priority to break lines at. For example,
+when the input file looks like this:
+
+<pre class="example"> if (mask
+ && ((mask[0] == '\0')
+ || (mask[1] == '\0' && ((mask[0] == '0') || (mask[0] ==
'*')))))
+</pre>
+ <p class="noindent">then using the option <samp><span
class="option">-hnl</span></samp>, or <samp><span
class="option">--honour-newlines</span></samp>,
+together with the previously mentioned <samp><span
class="option">-nbbo</span></samp> and
+<samp><span class="option">--line-length60</span></samp>, will cause the
output not to be what is given
+in the last example but instead will prefer to break at the positions
+where the code was broken in the input file:
+
+<pre class="example"> if (mask
+ && ((mask[0] == '\0')
+ || (mask[1] == '\0' &&
+ ((mask[0] == '0') || (mask[0] == '*')))))
+</pre>
+ <p>The idea behind this option is that lines which are too long, but are
already
+broken up, will not be touched by GNU <samp><span
class="command">indent</span></samp>. Really messy code
+should be run through <samp><span class="command">indent</span></samp> at
least once using the
+<samp><span class="option">--ignore-newlines</span></samp> option though.
+
+ </body></html>
+
Index: software/indent/manual/html_node/Bugs.html
===================================================================
RCS file: software/indent/manual/html_node/Bugs.html
diff -N software/indent/manual/html_node/Bugs.html
--- /dev/null 1 Jan 1970 00:00:00 -0000
+++ software/indent/manual/html_node/Bugs.html 18 Sep 2008 15:15:03 -0000
1.1
@@ -0,0 +1,70 @@
+<html lang="en">
+<head>
+<title>Bugs - `indent': Indent and Format C Program Source</title>
+<meta http-equiv="Content-Type" content="text/html">
+<meta name="description" content="`indent': Indent and Format C Program
Source">
+<meta name="generator" content="makeinfo 4.11">
+<link title="Top" rel="start" href="index.html#Top">
+<link rel="up" href="Indent-Program.html#Indent-Program" title="Indent
Program">
+<link rel="prev" href="Miscellaneous-options.html#Miscellaneous-options"
title="Miscellaneous options">
+<link rel="next" href="Copyright.html#Copyright" title="Copyright">
+<link href="http://www.gnu.org/software/texinfo/" rel="generator-home"
title="Texinfo Homepage">
+<meta http-equiv="Content-Style-Type" content="text/css">
+<style type="text/css"><!--
+ pre.display { font-family:inherit }
+ pre.format { font-family:inherit }
+ pre.smalldisplay { font-family:inherit; font-size:smaller }
+ pre.smallformat { font-family:inherit; font-size:smaller }
+ pre.smallexample { font-size:smaller }
+ pre.smalllisp { font-size:smaller }
+ span.sc { font-variant:small-caps }
+ span.roman { font-family:serif; font-weight:normal; }
+ span.sansserif { font-family:sans-serif; font-weight:normal; }
+--></style>
+</head>
+<body>
+<div class="node">
+<p>
+<a name="Bugs"></a>
+Next: <a rel="next" accesskey="n"
href="Copyright.html#Copyright">Copyright</a>,
+Previous: <a rel="previous" accesskey="p"
href="Miscellaneous-options.html#Miscellaneous-options">Miscellaneous
options</a>,
+Up: <a rel="up" accesskey="u"
href="Indent-Program.html#Indent-Program">Indent Program</a>
+<hr>
+</div>
+
+<!-- node-name, next, previous, up -->
+<h3 class="section">1.12 Bugs</h3>
+
+<p>Please report any bugs to <a
href="mailto:address@hidden">address@hidden</a>.
+
+ <p>When <samp><span class="command">indent</span></samp> is run twice on a
file, with the same profile,
+it should <em>never</em> change that file the second time. With the
+current design of <samp><span class="command">indent</span></samp>, this can
not be guaranteed,
+and it has not been extensively tested.
+
+ <p><samp><span class="command">indent</span></samp> does not understand C.
In some cases this leads to
+the inability to join lines. The result is that running a file
+through <samp><span class="command">indent</span></samp> is
<em>irreversible</em>, even if the used input
+file was the result of running <samp><span
class="command">indent</span></samp> with a given profile
+(<samp><span class="file">.indent.pro</span></samp>).
+
+ <p>While an attempt was made to get <samp><span
class="command">indent</span></samp> working for C++, it
+will not do a good job on any C++ source except the very simplest.
+
+ <p><samp><span class="command">indent</span></samp> does not look at the
given <samp><span class="option">--line-length</span></samp> option
+when writing comments to the output file. This results often in comments
+being put far to the right. In order to prohibit <samp><span
class="command">indent</span></samp> from
+joining a broken line that has a comment at the end, make sure that the
+comments start on the first line of the break.
+
+ <p><samp><span class="command">indent</span></samp> does not count lines
and comments (see the <samp><span class="option">-v</span></samp>
+option) when <samp><span class="command">indent</span></samp> is turned off
with
+<code>/* *INDENT-OFF* */</code>.
+
+ <p>Comments of the form <code>/*UPPERCASE*/</code> are not treated as
comment but as an
+identifier, causing them to be joined with the next line. This renders
+comments of this type useless, unless they are embedded in the code to
+begin with.
+
+ </body></html>
+
Index: software/indent/manual/html_node/Comments.html
===================================================================
RCS file: software/indent/manual/html_node/Comments.html
diff -N software/indent/manual/html_node/Comments.html
--- /dev/null 1 Jan 1970 00:00:00 -0000
+++ software/indent/manual/html_node/Comments.html 18 Sep 2008 15:15:04
-0000 1.1
@@ -0,0 +1,141 @@
+<html lang="en">
+<head>
+<title>Comments - `indent': Indent and Format C Program Source</title>
+<meta http-equiv="Content-Type" content="text/html">
+<meta name="description" content="`indent': Indent and Format C Program
Source">
+<meta name="generator" content="makeinfo 4.11">
+<link title="Top" rel="start" href="index.html#Top">
+<link rel="up" href="Indent-Program.html#Indent-Program" title="Indent
Program">
+<link rel="prev" href="Blank-lines.html#Blank-lines" title="Blank lines">
+<link rel="next" href="Statements.html#Statements" title="Statements">
+<link href="http://www.gnu.org/software/texinfo/" rel="generator-home"
title="Texinfo Homepage">
+<meta http-equiv="Content-Style-Type" content="text/css">
+<style type="text/css"><!--
+ pre.display { font-family:inherit }
+ pre.format { font-family:inherit }
+ pre.smalldisplay { font-family:inherit; font-size:smaller }
+ pre.smallformat { font-family:inherit; font-size:smaller }
+ pre.smallexample { font-size:smaller }
+ pre.smalllisp { font-size:smaller }
+ span.sc { font-variant:small-caps }
+ span.roman { font-family:serif; font-weight:normal; }
+ span.sansserif { font-family:sans-serif; font-weight:normal; }
+--></style>
+</head>
+<body>
+<div class="node">
+<p>
+<a name="Comments"></a>
+Next: <a rel="next" accesskey="n"
href="Statements.html#Statements">Statements</a>,
+Previous: <a rel="previous" accesskey="p"
href="Blank-lines.html#Blank-lines">Blank lines</a>,
+Up: <a rel="up" accesskey="u"
href="Indent-Program.html#Indent-Program">Indent Program</a>
+<hr>
+</div>
+
+<!-- node-name, next, previous, up -->
+<h3 class="section">1.5 Comments</h3>
+
+<p><a name="index-Comments-44"></a>
+<samp><span class="command">indent</span></samp> formats both C and C++
comments. C comments are begun with
+‘<samp><span class="samp">/*</span></samp>’, terminated with
‘<samp><span class="samp">*/</span></samp>’ and may contain newline
characters.
+C++ comments begin with the delimiter ‘<samp><span
class="samp">//</span></samp>’ and end at the newline.
+
+ <p><samp><span class="command">indent</span></samp> handles comments
differently depending upon their context.
+<samp><span class="command">indent</span></samp> attempts to distinguish
between comments which follow
+statements, comments which follow declarations, comments following
+preprocessor directives, and comments which are not preceded by code of
+any sort, i.e., they begin the text of the line (although not
+neccessarily in column 1).
+
+ <p><samp><span class="command">indent</span></samp> further distinguishes
between comments found outside of
+procedures and aggregates, and those found within them. In particular,
+comments beginning a line found within a procedure will be indented to
+the column at which code is currently indented. The exception to this a
+comment beginning in the leftmost column; such a comment is output
+at that column.
+
+ <p><samp><span class="command">indent</span></samp> attempts to leave
<dfn>boxed comments</dfn> unmodified. The
+general idea of such a comment is that it is enclosed in a rectangle or
+“box” of stars or dashes to visually set it apart. More precisely,
+boxed comments are defined as those in which the initial ‘<samp><span
class="samp">/*</span></samp>’ is
+followed immediately by the character ‘<samp><span
class="samp">*</span></samp>’, ‘<samp><span
class="samp">=</span></samp>’, ‘<samp><span
class="samp">_</span></samp>’, or
+‘<samp><span class="samp">-</span></samp>’, or those in which the
beginning comment delimiter (‘<samp><span
class="samp">/*</span></samp>’)
+is on a line by itself, and the following line begins with a
‘<samp><span class="samp">*</span></samp>’ in
+the same column as the star of the opening delimiter.
+
+ <p>Examples of boxed comments are:
+
+<pre class="example"> /**********************
+ * Comment in a box!! *
+ **********************/
+
+ /*
+ * A different kind of scent,
+ * for a different kind of comment.
+ */
+</pre>
+ <p><samp><span class="command">indent</span></samp> attempts to leave boxed
comments exactly as they are found
+in the source file. Thus the indentation of the comment is unchanged,
+and its length is not checked in any way. The only alteration made is
+that an embedded tab character may be converted into the appropriate
+number of spaces.
+
+ <p>If the <samp><span class="option">-bbb</span></samp> option is
specified, all such boxed comments will be
+preceded by a blank line, unless such a comment is preceded by code.
+
+ <p><a name="index-g_t_002dfca-45"></a><a
name="index-g_t_002d_002dformat_002dall_002dcomments-46"></a><a
name="index-g_t_002dnfca-47"></a><a
name="index-g_t_002d_002ddont_002dformat_002dcomments-48"></a><a
name="index-g_t_002dfc1-49"></a><a
name="index-g_t_002d_002dformat_002dfirst_002dcolumn_002dcomments-50"></a><a
name="index-g_t_002dnfc1-51"></a><a
name="index-g_t_002d_002ddont_002dformat_002dfirst_002dcolumn_002dcomments-52"></a>Comments
which are not boxed comments may be formatted, which means that
+the line is broken to fit within a right margin and left-filled with
+whitespace. Single newlines are equivalent to a space, but blank lines
+(two or more newlines in a row) are taken to mean a paragraph break.
+Formatting of comments which begin after the first column is enabled
+with the <samp><span class="option">-fca</span></samp> option. To format
those beginning in column one,
+specify <samp><span class="option">-fc1</span></samp>. Such formatting is
disabled by default.
+
+ <p>The right margin for formatting defaults to 78, but may be changed with
+the <samp><span class="option">-lc</span></samp> option. If the margin
specified does not allow the
+comment to be printed, the margin will be automatically extended for the
+duration of that comment. The margin is not respected if the comment is
+not being formatted.
+
+ <p><a name="index-g_t_002dd_0040var_007bn_007d-53"></a><a
name="index-g_t_002d_002dline_002dcomments_002dindentation_0040var_007bn_007d-54"></a>If
the comment begins a line (i.e., there is no program text to its
+left), it will be indented to the column it was found in unless the
+comment is within a block of code. In that case, such a comment will be
+aligned with the indented code of that block (unless the comment began
+in the first column). This alignment may be affected by the <samp><span
class="option">-d</span></samp>
+option, which specifies an amount by which such comments are moved to
+the <em>left</em>, or unindented. For example, <samp><span
class="option">-d2</span></samp> places comments
+two spaces to the left of code. By default, comments are aligned with
+code, unless they begin in the first column, in which case they are left
+there by default — to get them aligned with the code, specify
<samp><span class="option">-fc1</span></samp>.
+
+ <p><a name="index-g_t_002dc_0040var_007bn_007d-55"></a><a
name="index-g_t_002d_002dcomment_002dindentation_0040var_007bn_007d-56"></a><a
name="index-g_t_002dcd_0040var_007bn_007d-57"></a><a
name="index-g_t_002d_002ddeclaration_002dcomment_002dcolumn_0040var_007bn_007d-58"></a><a
name="index-g_t_002dcp_0040var_007bn_007d-59"></a><a
name="index-g_t_002d_002delse_002dendif_002dcolumn_0040var_007bn_007d-60"></a>Comments
to the right of code will appear by default in column 33.
+This may be changed with one of three options. <samp><span
class="option">-c</span></samp> will specify
+the column for comments following code, <samp><span
class="option">-cd</span></samp> specifies the
+column for comments following declarations, and <samp><span
class="option">-cp</span></samp> specifies
+the column for comments following preprocessor directives <code>#else</code>
+and <code>#endif</code>.
+
+ <p>If the code to the left of the comment exceeds the beginning column,
+the comment column will be extended to the next tabstop column past
+the end of the code, or in the case of preprocessor directives, to one
+space past the end of the directive. This extension lasts only for
+the output of that particular comment.
+
+ <p><a name="index-g_t_002dcdb-61"></a><a
name="index-g_t_002d_002dcomment_002ddelimiters_002don_002dblank_002dlines-62"></a><a
name="index-g_t_002dncdb-63"></a><a
name="index-g_t_002d_002dno_002dcomment_002ddelimiters_002don_002dblank_002dlines-64"></a>The
<samp><span class="option">-cdb</span></samp> option places the comment
delimiters on blank lines.
+Thus, a single line comment like <code>/* Loving hug */</code> can be
+transformed into:
+
+<pre class="example"> /*
+ Loving hug
+ */
+</pre>
+ <p><a name="index-g_t_002dsc-65"></a><a
name="index-g_t_002d_002dstar_002dleft_002dside_002dof_002dcomments-66"></a><a
name="index-g_t_002dnsc-67"></a><a
name="index-g_t_002d_002ddont_002dstar_002dcomments-68"></a>Stars can be placed
at the beginning of multi-line comments with the
+<samp><span class="option">-sc</span></samp> option. Thus, the single-line
comment above can be
+transformed (with <samp><span class="option">-cdb -sc</span></samp>) into:
+
+<pre class="example"> /*
+ * Loving hug
+ */
+</pre>
+ </body></html>
+
Index: software/indent/manual/html_node/Common-styles.html
===================================================================
RCS file: software/indent/manual/html_node/Common-styles.html
diff -N software/indent/manual/html_node/Common-styles.html
--- /dev/null 1 Jan 1970 00:00:00 -0000
+++ software/indent/manual/html_node/Common-styles.html 18 Sep 2008 15:15:04
-0000 1.1
@@ -0,0 +1,85 @@
+<html lang="en">
+<head>
+<title>Common styles - `indent': Indent and Format C Program Source</title>
+<meta http-equiv="Content-Type" content="text/html">
+<meta name="description" content="`indent': Indent and Format C Program
Source">
+<meta name="generator" content="makeinfo 4.11">
+<link title="Top" rel="start" href="index.html#Top">
+<link rel="up" href="Indent-Program.html#Indent-Program" title="Indent
Program">
+<link rel="prev" href="Backup-files.html#Backup-files" title="Backup files">
+<link rel="next" href="Blank-lines.html#Blank-lines" title="Blank lines">
+<link href="http://www.gnu.org/software/texinfo/" rel="generator-home"
title="Texinfo Homepage">
+<meta http-equiv="Content-Style-Type" content="text/css">
+<style type="text/css"><!--
+ pre.display { font-family:inherit }
+ pre.format { font-family:inherit }
+ pre.smalldisplay { font-family:inherit; font-size:smaller }
+ pre.smallformat { font-family:inherit; font-size:smaller }
+ pre.smallexample { font-size:smaller }
+ pre.smalllisp { font-size:smaller }
+ span.sc { font-variant:small-caps }
+ span.roman { font-family:serif; font-weight:normal; }
+ span.sansserif { font-family:sans-serif; font-weight:normal; }
+--></style>
+</head>
+<body>
+<div class="node">
+<p>
+<a name="Common-styles"></a>
+Next: <a rel="next" accesskey="n"
href="Blank-lines.html#Blank-lines">Blank lines</a>,
+Previous: <a rel="previous" accesskey="p"
href="Backup-files.html#Backup-files">Backup files</a>,
+Up: <a rel="up" accesskey="u"
href="Indent-Program.html#Indent-Program">Indent Program</a>
+<hr>
+</div>
+
+<!-- node-name, next, previous, up -->
+<h3 class="section">1.3 Common styles</h3>
+
+<p>There are several common styles of C code, including the GNU style, the
+Kernighan & Ritchie style, and the original Berkeley style. A style may
+be selected with a single <dfn>background</dfn> option, which specifies a set
+of values for all other options. However, explicitly specified options
+always override options implied by a background option.
+
+ <p><a name="index-GNU-style-17"></a><a name="index-g_t_002dgnu-18"></a><a
name="index-g_t_002d_002dgnu_002dstyle-19"></a>As of version 1.2, the default
style of GNU <samp><span class="command">indent</span></samp> is the GNU
+style. Thus, it is no longer necessary to specify the option
+<samp><span class="option">-gnu</span></samp> to obtain this format, although
doing so will not cause an
+error. Option settings which correspond to the GNU style are:
+
+<pre class="example"> -nbad -bap -nbc -bbo -bl -bli2 -bls -ncdb -nce -cp1
-cs -di2
+ -ndj -nfc1 -nfca -hnl -i2 -ip5 -lp -pcs -nprs -psl -saf -sai
+ -saw -nsc -nsob
+</pre>
+ <p>The GNU coding style is that preferred by the GNU project. It is the
+style that the GNU Emacs C mode encourages and which is used in the C
+portions of GNU Emacs. (People interested in writing programs for
+Project GNU should get a copy of <cite>The GNU Coding Standards</cite>, which
+also covers semantic and portability issues such as memory usage, the
+size of integers, etc.)
+
+ <p><a name="index-Kernighan-_0026-Ritchie-style-20"></a><a
name="index-g_t_002dkr-21"></a><a
name="index-g_t_002d_002dk_002dand_002dr_002dstyle-22"></a><!--
kernighan-and-ritchie-style works, too, as does -->
+<!-- kernighan-and-ritchie. Which is most intuitive? -->
+The Kernighan & Ritchie style is used throughout their well-known book
+<cite>The C Programming Language</cite>. It is enabled with the <samp><span
class="option">-kr</span></samp>
+option. The Kernighan & Ritchie style corresponds to the following set
+of options:
+
+<pre class="example"> -nbad -bap -bbo -nbc -br -brs -c33 -cd33 -ncdb -ce
-ci4 -cli0
+ -cp33 -cs -d0 -di1 -nfc1 -nfca -hnl -i4 -ip0 -l75 -lp -npcs
+ -nprs -npsl -saf -sai -saw -nsc -nsob -nss
+</pre>
+ <p class="noindent">Kernighan & Ritchie style does not put comments to
the right of code in
+the same column at all times (nor does it use only one space to the
+right of the code), so for this style <samp><span
class="command">indent</span></samp> has arbitrarily
+chosen column 33.
+
+ <p><a name="index-Berkeley-style-23"></a><a
name="index-Original-Berkeley-style-24"></a><a
name="index-g_t_002dorig-25"></a><a
name="index-g_t_002d_002doriginal-26"></a>The style of the original Berkeley
<samp><span class="command">indent</span></samp> may be obtained by
+specifying <samp><span class="option">-orig</span></samp> (or by specifying
<samp><span class="option">--original</span></samp>, using the
+long option name). This style is equivalent to the following settings:
+
+<pre class="example"> -nbad -nbap -bbo -bc -br -brs -c33 -cd33 -cdb -ce
-ci4 -cli0
+ -cp33 -di16 -fc1 -fca -hnl -i4 -ip4 -l75 -lp -npcs -nprs -psl
+ -saf -sai -saw -sc -nsob -nss -ts8
+</pre>
+ </body></html>
+
Index: software/indent/manual/html_node/Copyright.html
===================================================================
RCS file: software/indent/manual/html_node/Copyright.html
diff -N software/indent/manual/html_node/Copyright.html
--- /dev/null 1 Jan 1970 00:00:00 -0000
+++ software/indent/manual/html_node/Copyright.html 18 Sep 2008 15:15:05
-0000 1.1
@@ -0,0 +1,66 @@
+<html lang="en">
+<head>
+<title>Copyright - `indent': Indent and Format C Program Source</title>
+<meta http-equiv="Content-Type" content="text/html">
+<meta name="description" content="`indent': Indent and Format C Program
Source">
+<meta name="generator" content="makeinfo 4.11">
+<link title="Top" rel="start" href="index.html#Top">
+<link rel="up" href="Indent-Program.html#Indent-Program" title="Indent
Program">
+<link rel="prev" href="Bugs.html#Bugs" title="Bugs">
+<link href="http://www.gnu.org/software/texinfo/" rel="generator-home"
title="Texinfo Homepage">
+<meta http-equiv="Content-Style-Type" content="text/css">
+<style type="text/css"><!--
+ pre.display { font-family:inherit }
+ pre.format { font-family:inherit }
+ pre.smalldisplay { font-family:inherit; font-size:smaller }
+ pre.smallformat { font-family:inherit; font-size:smaller }
+ pre.smallexample { font-size:smaller }
+ pre.smalllisp { font-size:smaller }
+ span.sc { font-variant:small-caps }
+ span.roman { font-family:serif; font-weight:normal; }
+ span.sansserif { font-family:sans-serif; font-weight:normal; }
+--></style>
+</head>
+<body>
+<div class="node">
+<p>
+<a name="Copyright"></a>
+Previous: <a rel="previous" accesskey="p" href="Bugs.html#Bugs">Bugs</a>,
+Up: <a rel="up" accesskey="u"
href="Indent-Program.html#Indent-Program">Indent Program</a>
+<hr>
+</div>
+
+<!-- node-name, next, previous, up -->
+<h3 class="section">1.13 Copyright</h3>
+
+<p>The following copyright notice applies to the <samp><span
class="command">indent</span></samp> program.
+The copyright and copying permissions for this manual appear near the
+beginning of <samp><span class="file">indent.texinfo</span></samp> and
<samp><span class="file">indent.info</span></samp>, and near the
+end of <samp><span class="file">indent.1</span></samp>.
+
+<pre class="display"> Copyright © 2001 David Ingamells.
+ Copyright © 1999 Carlo Wood.
+ Copyright © 1995, 1996 Joseph Arceneaux.
+ Copyright © 1989, 1992, 1993, 1994, 1995, 1996 Free Software
Foundation
+ Copyright © 1985 Sun Microsystems, Inc.
+ Copyright © 1980 The Regents of the University of California.
+ Copyright © 1976 Board of Trustees of the University of Illinois.
+ All rights reserved.
+
+ Redistribution and use in source and binary forms are permitted
+ provided that the above copyright notice and this paragraph are
+ duplicated in all such forms and that any documentation,
+ advertising materials, and other materials related to such
+ distribution and use acknowledge that the software was developed
+ by the University of California, Berkeley, the University of Illinois,
+ Urbana, and Sun Microsystems, Inc. The name of either University
+ or Sun Microsystems may not be used to endorse or promote products
+ derived from this software without specific prior written permission.
+ THIS SOFTWARE IS PROVIDED “AS IS” AND WITHOUT ANY EXPRESS OR
+ IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
+ WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR
+ PURPOSE.
+</pre>
+ <!-- !END THEREST -->
+ </body></html>
+
Index: software/indent/manual/html_node/Declarations.html
===================================================================
RCS file: software/indent/manual/html_node/Declarations.html
diff -N software/indent/manual/html_node/Declarations.html
--- /dev/null 1 Jan 1970 00:00:00 -0000
+++ software/indent/manual/html_node/Declarations.html 18 Sep 2008 15:15:06
-0000 1.1
@@ -0,0 +1,134 @@
+<html lang="en">
+<head>
+<title>Declarations - `indent': Indent and Format C Program Source</title>
+<meta http-equiv="Content-Type" content="text/html">
+<meta name="description" content="`indent': Indent and Format C Program
Source">
+<meta name="generator" content="makeinfo 4.11">
+<link title="Top" rel="start" href="index.html#Top">
+<link rel="up" href="Indent-Program.html#Indent-Program" title="Indent
Program">
+<link rel="prev" href="Statements.html#Statements" title="Statements">
+<link rel="next" href="Indentation.html#Indentation" title="Indentation">
+<link href="http://www.gnu.org/software/texinfo/" rel="generator-home"
title="Texinfo Homepage">
+<meta http-equiv="Content-Style-Type" content="text/css">
+<style type="text/css"><!--
+ pre.display { font-family:inherit }
+ pre.format { font-family:inherit }
+ pre.smalldisplay { font-family:inherit; font-size:smaller }
+ pre.smallformat { font-family:inherit; font-size:smaller }
+ pre.smallexample { font-size:smaller }
+ pre.smalllisp { font-size:smaller }
+ span.sc { font-variant:small-caps }
+ span.roman { font-family:serif; font-weight:normal; }
+ span.sansserif { font-family:sans-serif; font-weight:normal; }
+--></style>
+</head>
+<body>
+<div class="node">
+<p>
+<a name="Declarations"></a>
+Next: <a rel="next" accesskey="n"
href="Indentation.html#Indentation">Indentation</a>,
+Previous: <a rel="previous" accesskey="p"
href="Statements.html#Statements">Statements</a>,
+Up: <a rel="up" accesskey="u"
href="Indent-Program.html#Indent-Program">Indent Program</a>
+<hr>
+</div>
+
+<!-- node-name, next, previous, up -->
+<h3 class="section">1.7 Declarations</h3>
+
+<p><a name="index-g_t_002ddi_0040var_007bn_007d-115"></a><a
name="index-g_t_002d_002ddeclaration_002dindentation_0040var_007bn_007d-116"></a>By
default <samp><span class="command">indent</span></samp> will line up
identifiers, in the column
+specified by the <samp><span class="option">-di</span></samp> option. For
example, <samp><span class="option">-di16</span></samp> makes
+things look like:
+
+<pre class="example"> int foo;
+ char *bar;
+</pre>
+ <p>Using a small value (such as one or two) for the <samp><span
class="option">-di</span></samp> option can
+be used to cause the identifiers to be placed in the first available
+position; for example:
+
+<pre class="example"> int foo;
+ char *bar;
+</pre>
+ <p>The value given to the <samp><span class="option">-di</span></samp>
option will still affect variables
+which are put on separate lines from their types, for example
+<samp><span class="option">-di2</span></samp> will lead to:
+
+<pre class="example"> int
+ foo;
+</pre>
+ <p><a name="index-g_t_002dbc-117"></a><a
name="index-g_t_002d_002dblank_002dlines_002dafter_002dcommas-118"></a><a
name="index-g_t_002dnbc-119"></a><a
name="index-g_t_002d_002dno_002dblank_002dlines_002dafter_002dcommas-120"></a>If
the <samp><span class="option">-bc</span></samp> option is specified, a
newline is forced after each
+comma in a declaration. For example,
+
+<pre class="example"> int a,
+ b,
+ c;
+</pre>
+ <p class="noindent">With the <samp><span class="option">-nbc</span></samp>
option this would look like
+
+<pre class="example"> int a, b, c;
+</pre>
+ <p><a name="index-g_t_002dbfda-121"></a><a
name="index-g_t_002d_002dbreak_002dfunction_002ddecl_002dargs-122"></a><a
name="index-g_t_002dnbfda-123"></a><a
name="index-g_t_002d_002ddont_002dbreak_002dfunction_002ddecl_002dargs-124"></a><a
name="index-g_t_002dbfde-125"></a><a
name="index-g_t_002d_002dbreak_002dfunction_002ddecl_002dargs_002dend-126"></a><a
name="index-g_t_002dnbfde-127"></a><a
name="index-g_t_002d_002ddont_002dbreak_002dfunction_002ddecl_002dargs_002dend-128"></a>The
<samp><span class="option">-bfda</span></samp> option causes a newline to be
forced after the comma
+separating the arguments of a function declaration. The arguments will
+appear at one indention level deeper than the function declaration. This
+is particularly helpful for functions with long argument lists.
+The option <samp><span class="option">-bfde</span></samp> causes a newline to
be forced before the closing
+bracket of the function declaration. For both options the 'n' setting is the
default:
+-nbdfa and -nbdfe.
+
+ <p>For
+example,
+
+<pre class="example"> void foo (int arg1, char arg2, int *arg3, long arg4,
char arg5);
+</pre>
+ <p class="noindent">With the <samp><span class="option">-bfda</span></samp>
option this would look like
+
+<pre class="example"> void foo (
+ int arg1,
+ char arg2,
+ int *arg3,
+ long arg4,
+ char arg5);
+</pre>
+ <p>With, in addition, the <samp><span class="option">-bfde</span></samp>
option this would look like
+
+<pre class="example"> void foo (
+ int arg1,
+ char arg2,
+ int *arg3,
+ long arg4,
+ char arg5
+ );
+</pre>
+ <p><a name="index-g_t_002dpsl-129"></a><a
name="index-g_t_002d_002dprocnames_002dstart_002dlines-130"></a><a
name="index-g_t_002dnpsl-131"></a><a
name="index-g_t_002d_002ddont_002dbreak_002dprocedure_002dtype-132"></a><a
name="index-g_t_0040command_007betags_007d-requires-_0040option_007b_002dpsl_007d-133"></a>The
<samp><span class="option">-psl</span></samp> option causes the type of a
procedure being defined to
+be placed on the line before the name of the procedure. This style is
+required for the <samp><span class="command">etags</span></samp> program to
work correctly, as well as some
+of the <code>c-mode</code> functions of Emacs.
+
+ <p><a name="index-g_t_002dT-134"></a><a name="index-Typenames-135"></a><a
name="index-typedef-136"></a>You must use the <samp><span
class="option">-T</span></samp>
+option to tell <samp><span class="command">indent</span></samp> the name of
all the typenames in your
+program that are defined by <code>typedef</code>. <samp><span
class="option">-T</span></samp> can be specified
+more than once, and all names specified are used. For example, if your
+program contains
+
+<pre class="example"> typedef unsigned long CODE_ADDR;
+ typedef enum {red, blue, green} COLOR;
+</pre>
+ <p class="noindent">you would use the options <samp><span class="option">-T
CODE_ADDR -T COLOR</span></samp>.
+
+ <p>The <samp><span class="option">-brs</span></samp> or <samp><span
class="option">-bls</span></samp> option specifies how to format braces
+in struct declarations. The <samp><span class="option">-brs</span></samp>
option formats braces like
+this:
+
+<pre class="example"> struct foo {
+ int x;
+ };
+</pre>
+ <p class="noindent">The <samp><span class="option">-bls</span></samp>
option formats them like this:
+
+<pre class="example"> struct foo
+ {
+ int x;
+ };
+</pre>
+ </body></html>
+
Index: software/indent/manual/html_node/Disabling-Formatting.html
===================================================================
RCS file: software/indent/manual/html_node/Disabling-Formatting.html
diff -N software/indent/manual/html_node/Disabling-Formatting.html
--- /dev/null 1 Jan 1970 00:00:00 -0000
+++ software/indent/manual/html_node/Disabling-Formatting.html 18 Sep 2008
15:15:06 -0000 1.1
@@ -0,0 +1,70 @@
+<html lang="en">
+<head>
+<title>Disabling Formatting - `indent': Indent and Format C Program
Source</title>
+<meta http-equiv="Content-Type" content="text/html">
+<meta name="description" content="`indent': Indent and Format C Program
Source">
+<meta name="generator" content="makeinfo 4.11">
+<link title="Top" rel="start" href="index.html#Top">
+<link rel="up" href="Indent-Program.html#Indent-Program" title="Indent
Program">
+<link rel="prev" href="Breaking-long-lines.html#Breaking-long-lines"
title="Breaking long lines">
+<link rel="next" href="Miscellaneous-options.html#Miscellaneous-options"
title="Miscellaneous options">
+<link href="http://www.gnu.org/software/texinfo/" rel="generator-home"
title="Texinfo Homepage">
+<meta http-equiv="Content-Style-Type" content="text/css">
+<style type="text/css"><!--
+ pre.display { font-family:inherit }
+ pre.format { font-family:inherit }
+ pre.smalldisplay { font-family:inherit; font-size:smaller }
+ pre.smallformat { font-family:inherit; font-size:smaller }
+ pre.smallexample { font-size:smaller }
+ pre.smalllisp { font-size:smaller }
+ span.sc { font-variant:small-caps }
+ span.roman { font-family:serif; font-weight:normal; }
+ span.sansserif { font-family:sans-serif; font-weight:normal; }
+--></style>
+</head>
+<body>
+<div class="node">
+<p>
+<a name="Disabling-Formatting"></a>
+Next: <a rel="next" accesskey="n"
href="Miscellaneous-options.html#Miscellaneous-options">Miscellaneous
options</a>,
+Previous: <a rel="previous" accesskey="p"
href="Breaking-long-lines.html#Breaking-long-lines">Breaking long lines</a>,
+Up: <a rel="up" accesskey="u"
href="Indent-Program.html#Indent-Program">Indent Program</a>
+<hr>
+</div>
+
+<!-- node-name, next, previous, up -->
+<h3 class="section">1.10 Disabling Formatting</h3>
+
+<p>Formatting of C code may be disabled for portions of a program by
+embedding special <dfn>control comments</dfn> in the program. To turn off
+formatting for a section of a program, place the disabling control
+comment <code>/* *INDENT-OFF* */</code> on a line by itself just before that
+section. Program text scanned after this control comment is output
+precisely as input with no modifications until the corresponding
+enabling comment is scanned on a line by itself. The disabling control
+comment is <code>/* *INDENT-ON* */</code>, and any text following the comment
+on the line is also output unformatted. Formatting begins again with
+the input line following the enabling control comment.
+
+ <p>More precisely, <samp><span class="command">indent</span></samp> does
not attempt to verify the closing
+delimiter (<code>*/</code>) for these C comments, and any whitespace on the
+line is totally transparent.
+
+ <p>These control comments also function in their C++ formats, namely
+<code>// *INDENT-OFF*</code> and <code>// *INDENT-ON*</code>.
+
+ <p>It should be noted that the internal state of <samp><span
class="command">indent</span></samp> remains
+unchanged over the course of the unformatted section. Thus, for
+example, turning off formatting in the middle of a function and
+continuing it after the end of the function may lead to bizarre
+results. It is therefore wise to be somewhat modular in selecting code
+to be left unformatted.
+
+ <p>As a historical note, some earlier versions of <samp><span
class="command">indent</span></samp> produced
+error messages beginning with <code>*INDENT**</code>. These versions of
+<samp><span class="command">indent</span></samp> were written to ignore any
input text lines which began
+with such error messages. I have removed this incestuous feature from
+GNU <samp><span class="command">indent</span></samp>.
+
+ </body></html>
+
Index: software/indent/manual/html_node/Indent-Program.html
===================================================================
RCS file: software/indent/manual/html_node/Indent-Program.html
diff -N software/indent/manual/html_node/Indent-Program.html
--- /dev/null 1 Jan 1970 00:00:00 -0000
+++ software/indent/manual/html_node/Indent-Program.html 18 Sep 2008
15:15:07 -0000 1.1
@@ -0,0 +1,65 @@
+<html lang="en">
+<head>
+<title>Indent Program - `indent': Indent and Format C Program Source</title>
+<meta http-equiv="Content-Type" content="text/html">
+<meta name="description" content="`indent': Indent and Format C Program
Source">
+<meta name="generator" content="makeinfo 4.11">
+<link title="Top" rel="start" href="index.html#Top">
+<link rel="prev" href="index.html#Top" title="Top">
+<link rel="next" href="Option-Summary.html#Option-Summary" title="Option
Summary">
+<link href="http://www.gnu.org/software/texinfo/" rel="generator-home"
title="Texinfo Homepage">
+<meta http-equiv="Content-Style-Type" content="text/css">
+<style type="text/css"><!--
+ pre.display { font-family:inherit }
+ pre.format { font-family:inherit }
+ pre.smalldisplay { font-family:inherit; font-size:smaller }
+ pre.smallformat { font-family:inherit; font-size:smaller }
+ pre.smallexample { font-size:smaller }
+ pre.smalllisp { font-size:smaller }
+ span.sc { font-variant:small-caps }
+ span.roman { font-family:serif; font-weight:normal; }
+ span.sansserif { font-family:sans-serif; font-weight:normal; }
+--></style>
+</head>
+<body>
+<div class="node">
+<p>
+<a name="Indent-Program"></a>
+Next: <a rel="next" accesskey="n"
href="Option-Summary.html#Option-Summary">Option Summary</a>,
+Previous: <a rel="previous" accesskey="p" href="index.html#Top">Top</a>,
+Up: <a rel="up" accesskey="u" href="index.html#Top">Top</a>
+<hr>
+</div>
+
+<h2 class="chapter">1 The <samp><span class="command">indent</span></samp>
Program</h2>
+
+<!-- !BEGIN DESCRIPTION -->
+<p>can be used to make code easier to read. It can also convert from one
+style of writing C to another.
+
+ <p><samp><span class="command">indent</span></samp> understands a
substantial amount about the syntax of C,
+but it also attempts to cope with incomplete and misformed syntax.
+
+ <p>In version 1.2 and more recent versions, the GNU style of indenting is
+the default.
+<!-- !END DESCRIPTION -->
+
+<ul class="menu">
+<li><a accesskey="1" href="Invoking-indent.html#Invoking-indent">Invoking
indent</a>: Invoking <samp><span
class="command">indent</span></samp>
+<li><a accesskey="2" href="Backup-files.html#Backup-files">Backup files</a>:
Backup Files
+<li><a accesskey="3" href="Common-styles.html#Common-styles">Common
styles</a>: Common styles
+<li><a accesskey="4" href="Blank-lines.html#Blank-lines">Blank lines</a>:
Blank lines
+<li><a accesskey="5" href="Comments.html#Comments">Comments</a>:
Comments
+<li><a accesskey="6" href="Statements.html#Statements">Statements</a>:
Statements
+<li><a accesskey="7" href="Declarations.html#Declarations">Declarations</a>:
Declarations
+<li><a accesskey="8" href="Indentation.html#Indentation">Indentation</a>:
Indentation
+<li><a accesskey="9"
href="Breaking-long-lines.html#Breaking-long-lines">Breaking long lines</a>:
Breaking long lines
+<li><a href="Disabling-Formatting.html#Disabling-Formatting">Disabling
Formatting</a>: Disabling Formatting
+<li><a href="Miscellaneous-options.html#Miscellaneous-options">Miscellaneous
options</a>: Miscellaneous options
+<li><a href="Bugs.html#Bugs">Bugs</a>: Bugs
+<li><a href="Copyright.html#Copyright">Copyright</a>:
Copyright
+</ul>
+
+<!-- !BEGIN THEREST -->
+ </body></html>
+
Index: software/indent/manual/html_node/Indentation.html
===================================================================
RCS file: software/indent/manual/html_node/Indentation.html
diff -N software/indent/manual/html_node/Indentation.html
--- /dev/null 1 Jan 1970 00:00:00 -0000
+++ software/indent/manual/html_node/Indentation.html 18 Sep 2008 15:15:07
-0000 1.1
@@ -0,0 +1,126 @@
+<html lang="en">
+<head>
+<title>Indentation - `indent': Indent and Format C Program Source</title>
+<meta http-equiv="Content-Type" content="text/html">
+<meta name="description" content="`indent': Indent and Format C Program
Source">
+<meta name="generator" content="makeinfo 4.11">
+<link title="Top" rel="start" href="index.html#Top">
+<link rel="up" href="Indent-Program.html#Indent-Program" title="Indent
Program">
+<link rel="prev" href="Declarations.html#Declarations" title="Declarations">
+<link rel="next" href="Breaking-long-lines.html#Breaking-long-lines"
title="Breaking long lines">
+<link href="http://www.gnu.org/software/texinfo/" rel="generator-home"
title="Texinfo Homepage">
+<meta http-equiv="Content-Style-Type" content="text/css">
+<style type="text/css"><!--
+ pre.display { font-family:inherit }
+ pre.format { font-family:inherit }
+ pre.smalldisplay { font-family:inherit; font-size:smaller }
+ pre.smallformat { font-family:inherit; font-size:smaller }
+ pre.smallexample { font-size:smaller }
+ pre.smalllisp { font-size:smaller }
+ span.sc { font-variant:small-caps }
+ span.roman { font-family:serif; font-weight:normal; }
+ span.sansserif { font-family:sans-serif; font-weight:normal; }
+--></style>
+</head>
+<body>
+<div class="node">
+<p>
+<a name="Indentation"></a>
+Next: <a rel="next" accesskey="n"
href="Breaking-long-lines.html#Breaking-long-lines">Breaking long lines</a>,
+Previous: <a rel="previous" accesskey="p"
href="Declarations.html#Declarations">Declarations</a>,
+Up: <a rel="up" accesskey="u"
href="Indent-Program.html#Indent-Program">Indent Program</a>
+<hr>
+</div>
+
+<!-- node-name, next, previous, up -->
+<h3 class="section">1.8 Indentation</h3>
+
+<p><a name="index-g_t_002di_0040var_007bn_007d-137"></a><a
name="index-g_t_002d_002dindent_002dlevel_0040var_007bn_007d-138"></a><a
name="index-g_t_002dci_0040var_007bn_007d-139"></a><a
name="index-g_t_002d_002dcontinuation_002dindentation_0040var_007bn_007d-140"></a><a
name="index-g_t_002dlp-141"></a><a
name="index-g_t_002d_002dcontinue_002dat_002dparentheses-142"></a><a
name="index-g_t_002dnlp-143"></a><a
name="index-g_t_002d_002ddont_002dline_002dup_002dparentheses-144"></a>One
issue in the formatting of code is how far each line should be
+indented from the left margin. When the beginning of a statement such
+as <code>if</code> or <code>for</code> is encountered, the indentation level is
+increased by the value specified by the <samp><span
class="option">-i</span></samp> option. For example,
+use <samp><span class="option">-i8</span></samp> to specify an eight character
indentation for each
+level. When a statement is broken across two lines, the second line is
+indented by a number of additional spaces specified by the <samp><span
class="option">-ci</span></samp>
+option. <samp><span class="option">-ci</span></samp> defaults to 0. However,
if the <samp><span class="option">-lp</span></samp> option is
+specified, and a line has a left parenthesis which is not closed on that
+line, then continuation lines will be lined up to start at the character
+position just after the left parenthesis. This processing also applies
+to ‘<samp><span class="samp">[</span></samp>’ and applies to
‘<samp><span class="samp">{</span></samp>’ when it occurs in
initialization
+lists. For example, a piece of continued code might look like this with
+<samp><span class="option">-nlp -ci3</span></samp> in effect:
+
+<pre class="example"> p1 = first_procedure (second_procedure (p2, p3),
+ third_procedure (p4, p5));
+</pre>
+ <p class="noindent">With <samp><span class="option">-lp</span></samp> in
effect the code looks somewhat clearer:
+
+<pre class="example"> p1 = first_procedure (second_procedure (p2, p3),
+ third_procedure (p4, p5));
+</pre>
+ <p><a name="index-g_t_002dts_0040var_007bn_007d-145"></a><a
name="index-g_t_002d_002dtab_002dsize_0040var_007bn_007d-146"></a>When a
statement is broken in between two or more paren pairs (...),
+each extra pair causes the indentation level extra indentation:
+
+<pre class="example"> if ((((i < 2 &&
+ k > 0) || p == 0) &&
+ q == 1) ||
+ n = 0)
+</pre>
+ <p class="noindent">The option <samp><span
class="option">-ip</span><var>N</var></samp> can be used to set the extra
offset per paren.
+For instance, <samp><span class="option">-ip0</span></samp> would format the
above as:
+
+<pre class="example"> if ((((i < 2 &&
+ k > 0) || p == 0) &&
+ q == 1) ||
+ n = 0)
+</pre>
+ <p class="noindent"><samp><span class="command">indent</span></samp>
assumes that tabs are placed at regular intervals of both
+input and output character streams. These intervals are by default 8
+columns wide, but (as of version 1.2) may be changed by the <samp><span
class="option">-ts</span></samp>
+option. Tabs are treated as the equivalent number of spaces.
+
+ <p><a name="index-g_t_002dip_0040var_007bn_007d-147"></a><a
name="index-g_t_002d_002dparameter_002dindentation_0040var_007bn_007d-148"></a><a
name="index-g_t_002dnip-149"></a><a
name="index-g_t_002d_002dno_002dparameter_002dindentation-150"></a>The
indentation of type declarations in old-style function definitions
+is controlled by the <samp><span class="option">-ip</span></samp> parameter.
This is a numeric parameter
+specifying how many spaces to indent type declarations. For example,
+the default <samp><span class="option">-ip5</span></samp><!-- /@w --> makes
definitions look like this:
+
+<pre class="example"> char *
+ create_world (x, y, scale)
+ int x;
+ int y;
+ float scale;
+ {
+ . . .
+ }
+</pre>
+ <p>For compatibility with other versions of indent, the option <samp><span
class="option">-nip</span></samp>
+is provided, which is equivalent to <samp><span
class="option">-ip0</span></samp>.
+
+ <p><a name="index-g_t_002dlps-151"></a><a
name="index-g_t_002d_002dleave_002dpreprocessor_002dspace-152"></a><a
name="index-g_t_002dnlps-153"></a><a
name="index-g_t_002d_002dremove_002dpreprocessor_002dspace-154"></a>ANSI C
allows white space to be placed on preprocessor command lines
+between the character ‘<samp><span class="samp">#</span></samp>’
and the command name. By default,
+<samp><span class="command">indent</span></samp> removes this space, but
specifying the <samp><span class="option">-lps</span></samp> option
+directs <samp><span class="command">indent</span></samp> to leave this space
unmodified. The option <samp><span class="option">-ppi</span></samp>
+overrides <samp><span class="option">-nlps</span></samp> and <samp><span
class="option">-lps</span></samp>.
+
+ <p><a name="index-g_t_002dppi_0040var_007bn_007d-155"></a><a
name="index-g_t_002d_002dpreprocessor_002dindentation_0040var_007bn_007d-156"></a>This
option can be used to request that preprocessor conditional statements can
+be indented by to given number of spaces, for example with the option
<samp><span class="option">-ppi 3</span></samp>
+
+<pre class="example"> #if X
+ #if Y
+ #define Z 1
+ #else
+ #define Z 0
+ #endif
+ #endif
+</pre>
+ <p>becomes
+<pre class="example"> #if X
+ # if Y
+ # define Z 1
+ # else
+ # define Z 0
+ # endif
+ #endif
+</pre>
+ </body></html>
+
Index: software/indent/manual/html_node/Index.html
===================================================================
RCS file: software/indent/manual/html_node/Index.html
diff -N software/indent/manual/html_node/Index.html
--- /dev/null 1 Jan 1970 00:00:00 -0000
+++ software/indent/manual/html_node/Index.html 18 Sep 2008 15:15:08 -0000
1.1
@@ -0,0 +1,239 @@
+<html lang="en">
+<head>
+<title>Index - `indent': Indent and Format C Program Source</title>
+<meta http-equiv="Content-Type" content="text/html">
+<meta name="description" content="`indent': Indent and Format C Program
Source">
+<meta name="generator" content="makeinfo 4.11">
+<link title="Top" rel="start" href="index.html#Top">
+<link rel="prev" href="Option-Summary.html#Option-Summary" title="Option
Summary">
+<link href="http://www.gnu.org/software/texinfo/" rel="generator-home"
title="Texinfo Homepage">
+<meta http-equiv="Content-Style-Type" content="text/css">
+<style type="text/css"><!--
+ pre.display { font-family:inherit }
+ pre.format { font-family:inherit }
+ pre.smalldisplay { font-family:inherit; font-size:smaller }
+ pre.smallformat { font-family:inherit; font-size:smaller }
+ pre.smallexample { font-size:smaller }
+ pre.smalllisp { font-size:smaller }
+ span.sc { font-variant:small-caps }
+ span.roman { font-family:serif; font-weight:normal; }
+ span.sansserif { font-family:sans-serif; font-weight:normal; }
+--></style>
+</head>
+<body>
+<div class="node">
+<p>
+<a name="Index"></a>
+Previous: <a rel="previous" accesskey="p"
href="Option-Summary.html#Option-Summary">Option Summary</a>,
+Up: <a rel="up" accesskey="u" href="index.html#Top">Top</a>
+<hr>
+</div>
+
+<h2 class="unnumbered">Index</h2>
+
+<ul class="index-ky" compact>
+<li><a
href="Statements.html#index-g_t_002d_002dblank_002dafter_002dsizeof-100"><code>--blank-after-sizeof</code></a>:
<a href="Statements.html#Statements">Statements</a></li>
+<li><a
href="Declarations.html#index-g_t_002d_002dblank_002dlines_002dafter_002dcommas-118"><code>--blank-lines-after-commas</code></a>:
<a href="Declarations.html#Declarations">Declarations</a></li>
+<li><a
href="_002dbad.html#index-g_t_002d_002dblank_002dlines_002dafter_002ddeclarations-37"><code>--blank-lines-after-declarations</code></a>:
<a href="_002dbad.html#g_t_002dbad">-bad</a></li>
+<li><a
href="_002dbap.html#index-g_t_002d_002dblank_002dlines_002dafter_002dprocedures-41"><code>--blank-lines-after-procedures</code></a>:
<a href="_002dbap.html#g_t_002dbap">-bap</a></li>
+<li><a
href="Blank-lines.html#index-g_t_002d_002dblank_002dlines_002dbefore_002dblock_002dcomments-29"><code>--blank-lines-before-block-comments</code></a>:
<a href="Blank-lines.html#Blank-lines">Blank lines</a></li>
+<li><a
href="Statements.html#index-g_t_002d_002dbrace_002dindent_0040var_007bn_007d-74"><code>--brace-indent</code><var>n</var></a>:
<a href="Statements.html#Statements">Statements</a></li>
+<li><a
href="Statements.html#index-g_t_002d_002dbraces_002dafter_002dif_002dline-72"><code>--braces-after-if-line</code></a>:
<a href="Statements.html#Statements">Statements</a></li>
+<li><a
href="Statements.html#index-g_t_002d_002dbraces_002don_002dif_002dline-70"><code>--braces-on-if-line</code></a>:
<a href="Statements.html#Statements">Statements</a></li>
+<li><a
href="Breaking-long-lines.html#index-g_t_002d_002dbreak_002dafter_002dboolean_002doperator-162"><code>--break-after-boolean-operator</code></a>:
<a href="Breaking-long-lines.html#Breaking-long-lines">Breaking long
lines</a></li>
+<li><a
href="Breaking-long-lines.html#index-g_t_002d_002dbreak_002dbefore_002dboolean_002doperator-160"><code>--break-before-boolean-operator</code></a>:
<a href="Breaking-long-lines.html#Breaking-long-lines">Breaking long
lines</a></li>
+<li><a
href="Declarations.html#index-g_t_002d_002dbreak_002dfunction_002ddecl_002dargs-122"><code>--break-function-decl-args</code></a>:
<a href="Declarations.html#Declarations">Declarations</a></li>
+<li><a
href="Declarations.html#index-g_t_002d_002dbreak_002dfunction_002ddecl_002dargs_002dend-126"><code>--break-function-decl-args-end</code></a>:
<a href="Declarations.html#Declarations">Declarations</a></li>
+<li><a
href="Statements.html#index-g_t_002d_002dcase_002dbrace_002dindentation_0040var_007bn_007d-86"><code>--case-brace-indentation</code><var>n</var></a>:
<a href="Statements.html#Statements">Statements</a></li>
+<li><a
href="Statements.html#index-g_t_002d_002dcase_002dindentation_0040var_007bn_007d-84"><code>--case-indentation</code><var>n</var></a>:
<a href="Statements.html#Statements">Statements</a></li>
+<li><a
href="Comments.html#index-g_t_002d_002dcomment_002ddelimiters_002don_002dblank_002dlines-62"><code>--comment-delimiters-on-blank-lines</code></a>:
<a href="Comments.html#Comments">Comments</a></li>
+<li><a
href="Comments.html#index-g_t_002d_002dcomment_002dindentation_0040var_007bn_007d-56"><code>--comment-indentation</code><var>n</var></a>:
<a href="Comments.html#Comments">Comments</a></li>
+<li><a
href="Indentation.html#index-g_t_002d_002dcontinuation_002dindentation_0040var_007bn_007d-140"><code>--continuation-indentation</code><var>n</var></a>:
<a href="Indentation.html#Indentation">Indentation</a></li>
+<li><a
href="Indentation.html#index-g_t_002d_002dcontinue_002dat_002dparentheses-142"><code>--continue-at-parentheses</code></a>:
<a href="Indentation.html#Indentation">Indentation</a></li>
+<li><a
href="Statements.html#index-g_t_002d_002dcuddle_002ddo_002dwhile-80"><code>--cuddle-do-while</code></a>:
<a href="Statements.html#Statements">Statements</a></li>
+<li><a
href="Statements.html#index-g_t_002d_002dcuddle_002delse-76"><code>--cuddle-else</code></a>:
<a href="Statements.html#Statements">Statements</a></li>
+<li><a
href="Comments.html#index-g_t_002d_002ddeclaration_002dcomment_002dcolumn_0040var_007bn_007d-58"><code>--declaration-comment-column</code><var>n</var></a>:
<a href="Comments.html#Comments">Comments</a></li>
+<li><a
href="Declarations.html#index-g_t_002d_002ddeclaration_002dindentation_0040var_007bn_007d-116"><code>--declaration-indentation</code><var>n</var></a>:
<a href="Declarations.html#Declarations">Declarations</a></li>
+<li><a
href="Declarations.html#index-g_t_002d_002ddont_002dbreak_002dfunction_002ddecl_002dargs-124"><code>--dont-break-function-decl-args</code></a>:
<a href="Declarations.html#Declarations">Declarations</a></li>
+<li><a
href="Declarations.html#index-g_t_002d_002ddont_002dbreak_002dfunction_002ddecl_002dargs_002dend-128"><code>--dont-break-function-decl-args-end</code></a>:
<a href="Declarations.html#Declarations">Declarations</a></li>
+<li><a
href="Declarations.html#index-g_t_002d_002ddont_002dbreak_002dprocedure_002dtype-132"><code>--dont-break-procedure-type</code></a>:
<a href="Declarations.html#Declarations">Declarations</a></li>
+<li><a
href="Statements.html#index-g_t_002d_002ddont_002dcuddle_002ddo_002dwhile-82"><code>--dont-cuddle-do-while</code></a>:
<a href="Statements.html#Statements">Statements</a></li>
+<li><a
href="Statements.html#index-g_t_002d_002ddont_002dcuddle_002delse-78"><code>--dont-cuddle-else</code></a>:
<a href="Statements.html#Statements">Statements</a></li>
+<li><a
href="Comments.html#index-g_t_002d_002ddont_002dformat_002dcomments-48"><code>--dont-format-comments</code></a>:
<a href="Comments.html#Comments">Comments</a></li>
+<li><a
href="Comments.html#index-g_t_002d_002ddont_002dformat_002dfirst_002dcolumn_002dcomments-52"><code>--dont-format-first-column-comments</code></a>:
<a href="Comments.html#Comments">Comments</a></li>
+<li><a
href="Indentation.html#index-g_t_002d_002ddont_002dline_002dup_002dparentheses-144"><code>--dont-line-up-parentheses</code></a>:
<a href="Indentation.html#Indentation">Indentation</a></li>
+<li><a
href="Statements.html#index-g_t_002d_002ddont_002dspace_002dspecial_002dsemicolon-90"><code>--dont-space-special-semicolon</code></a>:
<a href="Statements.html#Statements">Statements</a></li>
+<li><a
href="Comments.html#index-g_t_002d_002ddont_002dstar_002dcomments-68"><code>--dont-star-comments</code></a>:
<a href="Comments.html#Comments">Comments</a></li>
+<li><a
href="Comments.html#index-g_t_002d_002delse_002dendif_002dcolumn_0040var_007bn_007d-60"><code>--else-endif-column</code><var>n</var></a>:
<a href="Comments.html#Comments">Comments</a></li>
+<li><a
href="Comments.html#index-g_t_002d_002dformat_002dall_002dcomments-46"><code>--format-all-comments</code></a>:
<a href="Comments.html#Comments">Comments</a></li>
+<li><a
href="Comments.html#index-g_t_002d_002dformat_002dfirst_002dcolumn_002dcomments-50"><code>--format-first-column-comments</code></a>:
<a href="Comments.html#Comments">Comments</a></li>
+<li><a
href="Common-styles.html#index-g_t_002d_002dgnu_002dstyle-19"><code>--gnu-style</code></a>:
<a href="Common-styles.html#Common-styles">Common styles</a></li>
+<li><a
href="Breaking-long-lines.html#index-g_t_002d_002dhonour_002dnewlines-164"><code>--honour-newlines</code></a>:
<a href="Breaking-long-lines.html#Breaking-long-lines">Breaking long
lines</a></li>
+<li><a
href="Breaking-long-lines.html#index-g_t_002d_002dignore_002dnewlines-166"><code>--ignore-newlines</code></a>:
<a href="Breaking-long-lines.html#Breaking-long-lines">Breaking long
lines</a></li>
+<li><a
href="Invoking-indent.html#index-g_t_002d_002dignore_002dprofile-15"><code>--ignore-profile</code></a>:
<a href="Invoking-indent.html#Invoking-indent">Invoking indent</a></li>
+<li><a
href="Indentation.html#index-g_t_002d_002dindent_002dlevel_0040var_007bn_007d-138"><code>--indent-level</code><var>n</var></a>:
<a href="Indentation.html#Indentation">Indentation</a></li>
+<li><a
href="Common-styles.html#index-g_t_002d_002dk_002dand_002dr_002dstyle-22"><code>--k-and-r-style</code></a>:
<a href="Common-styles.html#Common-styles">Common styles</a></li>
+<li><a
href="Blank-lines.html#index-g_t_002d_002dleave_002doptional_002dblank_002dlines-35"><code>--leave-optional-blank-lines</code></a>:
<a href="Blank-lines.html#Blank-lines">Blank lines</a></li>
+<li><a
href="Indentation.html#index-g_t_002d_002dleave_002dpreprocessor_002dspace-152"><code>--leave-preprocessor-space</code></a>:
<a href="Indentation.html#Indentation">Indentation</a></li>
+<li><a
href="Comments.html#index-g_t_002d_002dline_002dcomments_002dindentation_0040var_007bn_007d-54"><code>--line-comments-indentation</code><var>n</var></a>:
<a href="Comments.html#Comments">Comments</a></li>
+<li><a
href="Breaking-long-lines.html#index-g_t_002d_002dline_002dlength_0040var_007bn_007d-158"><code>--line-length</code><var>n</var></a>:
<a href="Breaking-long-lines.html#Breaking-long-lines">Breaking long
lines</a></li>
+<li><a
href="Declarations.html#index-g_t_002d_002dno_002dblank_002dlines_002dafter_002dcommas-120"><code>--no-blank-lines-after-commas</code></a>:
<a href="Declarations.html#Declarations">Declarations</a></li>
+<li><a
href="_002dbad.html#index-g_t_002d_002dno_002dblank_002dlines_002dafter_002ddeclarations-39"><code>--no-blank-lines-after-declarations</code></a>:
<a href="_002dbad.html#g_t_002dbad">-bad</a></li>
+<li><a
href="_002dbap.html#index-g_t_002d_002dno_002dblank_002dlines_002dafter_002dprocedures-43"><code>--no-blank-lines-after-procedures</code></a>:
<a href="_002dbap.html#g_t_002dbap">-bap</a></li>
+<li><a
href="Blank-lines.html#index-g_t_002d_002dno_002dblank_002dlines_002dbefore_002dblock_002dcomments-31"><code>--no-blank-lines-before-block-comments</code></a>:
<a href="Blank-lines.html#Blank-lines">Blank lines</a></li>
+<li><a
href="Comments.html#index-g_t_002d_002dno_002dcomment_002ddelimiters_002don_002dblank_002dlines-64"><code>--no-comment-delimiters-on-blank-lines</code></a>:
<a href="Comments.html#Comments">Comments</a></li>
+<li><a
href="Indentation.html#index-g_t_002d_002dno_002dparameter_002dindentation-150"><code>--no-parameter-indentation</code></a>:
<a href="Indentation.html#Indentation">Indentation</a></li>
+<li><a
href="Statements.html#index-g_t_002d_002dno_002dspace_002dafter_002dcasts-98"><code>--no-space-after-casts</code></a>:
<a href="Statements.html#Statements">Statements</a></li>
+<li><a
href="Statements.html#index-g_t_002d_002dno_002dspace_002dafter_002dfor-104"><code>--no-space-after-for</code></a>:
<a href="Statements.html#Statements">Statements</a></li>
+<li><a
href="Statements.html#index-g_t_002d_002dno_002dspace_002dafter_002dfunction_002dcall_002dnames-94"><code>--no-space-after-function-call-names</code></a>:
<a href="Statements.html#Statements">Statements</a></li>
+<li><a
href="Statements.html#index-g_t_002d_002dno_002dspace_002dafter_002dif-108"><code>--no-space-after-if</code></a>:
<a href="Statements.html#Statements">Statements</a></li>
+<li><a
href="Statements.html#index-g_t_002d_002dno_002dspace_002dafter_002dwhile-112"><code>--no-space-after-while</code></a>:
<a href="Statements.html#Statements">Statements</a></li>
+<li><a
href="Miscellaneous-options.html#index-g_t_002d_002dno_002dverbosity-171"><code>--no-verbosity</code></a>:
<a href="Miscellaneous-options.html#Miscellaneous-options">Miscellaneous
options</a></li>
+<li><a
href="Common-styles.html#index-g_t_002d_002doriginal-26"><code>--original</code></a>:
<a href="Common-styles.html#Common-styles">Common styles</a></li>
+<li><a
href="Invoking-indent.html#index-g_t_002d_002doutput_002dfile-6"><code>--output-file</code></a>:
<a href="Invoking-indent.html#Invoking-indent">Invoking indent</a></li>
+<li><a
href="Indentation.html#index-g_t_002d_002dparameter_002dindentation_0040var_007bn_007d-148"><code>--parameter-indentation</code><var>n</var></a>:
<a href="Indentation.html#Indentation">Indentation</a></li>
+<li><a
href="Indentation.html#index-g_t_002d_002dpreprocessor_002dindentation_0040var_007bn_007d-156"><code>--preprocessor-indentation</code><var>n</var></a>:
<a href="Indentation.html#Indentation">Indentation</a></li>
+<li><a
href="Miscellaneous-options.html#index-g_t_002d_002dpreserve_002dmtime-173"><code>--preserve-mtime</code></a>:
<a href="Miscellaneous-options.html#Miscellaneous-options">Miscellaneous
options</a></li>
+<li><a
href="Declarations.html#index-g_t_002d_002dprocnames_002dstart_002dlines-130"><code>--procnames-start-lines</code></a>:
<a href="Declarations.html#Declarations">Declarations</a></li>
+<li><a
href="Indentation.html#index-g_t_002d_002dremove_002dpreprocessor_002dspace-154"><code>--remove-preprocessor-space</code></a>:
<a href="Indentation.html#Indentation">Indentation</a></li>
+<li><a
href="Statements.html#index-g_t_002d_002dspace_002dafter_002dcast-96"><code>--space-after-cast</code></a>:
<a href="Statements.html#Statements">Statements</a></li>
+<li><a
href="Statements.html#index-g_t_002d_002dspace_002dafter_002dfor-102"><code>--space-after-for</code></a>:
<a href="Statements.html#Statements">Statements</a></li>
+<li><a
href="Statements.html#index-g_t_002d_002dspace_002dafter_002dif-106"><code>--space-after-if</code></a>:
<a href="Statements.html#Statements">Statements</a></li>
+<li><a
href="Statements.html#index-g_t_002d_002dspace_002dafter_002dparentheses-114"><code>--space-after-parentheses</code></a>:
<a href="Statements.html#Statements">Statements</a></li>
+<li><a
href="Statements.html#index-g_t_002d_002dspace_002dafter_002dprocedure_002dcalls-92"><code>--space-after-procedure-calls</code></a>:
<a href="Statements.html#Statements">Statements</a></li>
+<li><a
href="Statements.html#index-g_t_002d_002dspace_002dafter_002dwhile-110"><code>--space-after-while</code></a>:
<a href="Statements.html#Statements">Statements</a></li>
+<li><a
href="Statements.html#index-g_t_002d_002dspace_002dspecial_002dsemicolon-88"><code>--space-special-semicolon</code></a>:
<a href="Statements.html#Statements">Statements</a></li>
+<li><a
href="Invoking-indent.html#index-g_t_002d_002dstandard_002doutput-9"><code>--standard-output</code></a>:
<a href="Invoking-indent.html#Invoking-indent">Invoking indent</a></li>
+<li><a
href="Comments.html#index-g_t_002d_002dstar_002dleft_002dside_002dof_002dcomments-66"><code>--star-left-side-of-comments</code></a>:
<a href="Comments.html#Comments">Comments</a></li>
+<li><a
href="Blank-lines.html#index-g_t_002d_002dswallow_002doptional_002dblank_002dlines-33"><code>--swallow-optional-blank-lines</code></a>:
<a href="Blank-lines.html#Blank-lines">Blank lines</a></li>
+<li><a
href="Indentation.html#index-g_t_002d_002dtab_002dsize_0040var_007bn_007d-146"><code>--tab-size</code><var>n</var></a>:
<a href="Indentation.html#Indentation">Indentation</a></li>
+<li><a
href="Miscellaneous-options.html#index-g_t_002d_002dverbose-169"><code>--verbose</code></a>:
<a href="Miscellaneous-options.html#Miscellaneous-options">Miscellaneous
options</a></li>
+<li><a href="_002dbad.html#index-g_t_002dbad-36"><code>-bad</code></a>: <a
href="_002dbad.html#g_t_002dbad">-bad</a></li>
+<li><a href="_002dbap.html#index-g_t_002dbap-40"><code>-bap</code></a>: <a
href="_002dbap.html#g_t_002dbap">-bap</a></li>
+<li><a href="Blank-lines.html#index-g_t_002dbbb-28"><code>-bbb</code></a>: <a
href="Blank-lines.html#Blank-lines">Blank lines</a></li>
+<li><a
href="Breaking-long-lines.html#index-g_t_002dbbo-159"><code>-bbo</code></a>: <a
href="Breaking-long-lines.html#Breaking-long-lines">Breaking long lines</a></li>
+<li><a href="Declarations.html#index-g_t_002dbc-117"><code>-bc</code></a>: <a
href="Declarations.html#Declarations">Declarations</a></li>
+<li><a href="Declarations.html#index-g_t_002dbfda-121"><code>-bfda</code></a>:
<a href="Declarations.html#Declarations">Declarations</a></li>
+<li><a href="Declarations.html#index-g_t_002dbfde-125"><code>-bfde</code></a>:
<a href="Declarations.html#Declarations">Declarations</a></li>
+<li><a href="Statements.html#index-g_t_002dbl-71"><code>-bl</code></a>: <a
href="Statements.html#Statements">Statements</a></li>
+<li><a
href="Statements.html#index-g_t_002dbli_0040var_007bn_007d-73"><code>-bli</code><var>n</var></a>:
<a href="Statements.html#Statements">Statements</a></li>
+<li><a href="Statements.html#index-g_t_002dbr-69"><code>-br</code></a>: <a
href="Statements.html#Statements">Statements</a></li>
+<li><a href="Statements.html#index-g_t_002dbs-99"><code>-bs</code></a>: <a
href="Statements.html#Statements">Statements</a></li>
+<li><a
href="Statements.html#index-g_t_002dcbi_0040var_007bn_007d-85"><code>-cbi</code><var>n</var></a>:
<a href="Statements.html#Statements">Statements</a></li>
+<li><a href="Comments.html#index-g_t_002dcdb-61"><code>-cdb</code></a>: <a
href="Comments.html#Comments">Comments</a></li>
+<li><a
href="Comments.html#index-g_t_002dcd_0040var_007bn_007d-57"><code>-cd</code><var>n</var></a>:
<a href="Comments.html#Comments">Comments</a></li>
+<li><a href="Statements.html#index-g_t_002dcdw-79"><code>-cdw</code></a>: <a
href="Statements.html#Statements">Statements</a></li>
+<li><a href="Statements.html#index-g_t_002dce-75"><code>-ce</code></a>: <a
href="Statements.html#Statements">Statements</a></li>
+<li><a
href="Indentation.html#index-g_t_002dci_0040var_007bn_007d-139"><code>-ci</code><var>n</var></a>:
<a href="Indentation.html#Indentation">Indentation</a></li>
+<li><a
href="Statements.html#index-g_t_002dcli_0040var_007bn_007d-83"><code>-cli</code><var>n</var></a>:
<a href="Statements.html#Statements">Statements</a></li>
+<li><a
href="Comments.html#index-g_t_002dc_0040var_007bn_007d-55"><code>-c</code><var>n</var></a>:
<a href="Comments.html#Comments">Comments</a></li>
+<li><a
href="Comments.html#index-g_t_002dcp_0040var_007bn_007d-59"><code>-cp</code><var>n</var></a>:
<a href="Comments.html#Comments">Comments</a></li>
+<li><a href="Statements.html#index-g_t_002dcs-95"><code>-cs</code></a>: <a
href="Statements.html#Statements">Statements</a></li>
+<li><a href="Statements.html#index-g_t_002ddce-77"><code>-dce</code></a>: <a
href="Statements.html#Statements">Statements</a></li>
+<li><a
href="Declarations.html#index-g_t_002ddi_0040var_007bn_007d-115"><code>-di</code><var>n</var></a>:
<a href="Declarations.html#Declarations">Declarations</a></li>
+<li><a
href="Comments.html#index-g_t_002dd_0040var_007bn_007d-53"><code>-d</code><var>n</var></a>:
<a href="Comments.html#Comments">Comments</a></li>
+<li><a href="Comments.html#index-g_t_002dfc1-49"><code>-fc1</code></a>: <a
href="Comments.html#Comments">Comments</a></li>
+<li><a href="Comments.html#index-g_t_002dfca-45"><code>-fca</code></a>: <a
href="Comments.html#Comments">Comments</a></li>
+<li><a href="Common-styles.html#index-g_t_002dgnu-18"><code>-gnu</code></a>:
<a href="Common-styles.html#Common-styles">Common styles</a></li>
+<li><a
href="Breaking-long-lines.html#index-g_t_002dhnl-163"><code>-hnl</code></a>: <a
href="Breaking-long-lines.html#Breaking-long-lines">Breaking long lines</a></li>
+<li><a
href="Indentation.html#index-g_t_002di_0040var_007bn_007d-137"><code>-i</code><var>n</var></a>:
<a href="Indentation.html#Indentation">Indentation</a></li>
+<li><a
href="Indentation.html#index-g_t_002dip_0040var_007bn_007d-147"><code>-ip</code><var>n</var></a>:
<a href="Indentation.html#Indentation">Indentation</a></li>
+<li><a href="Common-styles.html#index-g_t_002dkr-21"><code>-kr</code></a>: <a
href="Common-styles.html#Common-styles">Common styles</a></li>
+<li><a
href="Breaking-long-lines.html#index-g_t_002dl_0040var_007bn_007d-157"><code>-l</code><var>n</var></a>:
<a href="Breaking-long-lines.html#Breaking-long-lines">Breaking long
lines</a></li>
+<li><a href="Indentation.html#index-g_t_002dlp-141"><code>-lp</code></a>: <a
href="Indentation.html#Indentation">Indentation</a></li>
+<li><a href="Indentation.html#index-g_t_002dlps-151"><code>-lps</code></a>: <a
href="Indentation.html#Indentation">Indentation</a></li>
+<li><a href="_002dbad.html#index-g_t_002dnbad-38"><code>-nbad</code></a>: <a
href="_002dbad.html#g_t_002dbad">-bad</a></li>
+<li><a href="_002dbap.html#index-g_t_002dnbap-42"><code>-nbap</code></a>: <a
href="_002dbap.html#g_t_002dbap">-bap</a></li>
+<li><a href="Blank-lines.html#index-g_t_002dnbbb-30"><code>-nbbb</code></a>:
<a href="Blank-lines.html#Blank-lines">Blank lines</a></li>
+<li><a
href="Breaking-long-lines.html#index-g_t_002dnbbo-161"><code>-nbbo</code></a>:
<a href="Breaking-long-lines.html#Breaking-long-lines">Breaking long
lines</a></li>
+<li><a href="Declarations.html#index-g_t_002dnbc-119"><code>-nbc</code></a>:
<a href="Declarations.html#Declarations">Declarations</a></li>
+<li><a
href="Declarations.html#index-g_t_002dnbfda-123"><code>-nbfda</code></a>: <a
href="Declarations.html#Declarations">Declarations</a></li>
+<li><a
href="Declarations.html#index-g_t_002dnbfde-127"><code>-nbfde</code></a>: <a
href="Declarations.html#Declarations">Declarations</a></li>
+<li><a href="Comments.html#index-g_t_002dncdb-63"><code>-ncdb</code></a>: <a
href="Comments.html#Comments">Comments</a></li>
+<li><a href="Statements.html#index-g_t_002dncdw-81"><code>-ncdw</code></a>: <a
href="Statements.html#Statements">Statements</a></li>
+<li><a href="Statements.html#index-g_t_002dncs-97"><code>-ncs</code></a>: <a
href="Statements.html#Statements">Statements</a></li>
+<li><a href="Comments.html#index-g_t_002dnfc1-51"><code>-nfc1</code></a>: <a
href="Comments.html#Comments">Comments</a></li>
+<li><a href="Comments.html#index-g_t_002dnfca-47"><code>-nfca</code></a>: <a
href="Comments.html#Comments">Comments</a></li>
+<li><a
href="Breaking-long-lines.html#index-g_t_002dnhnl-165"><code>-nhnl</code></a>:
<a href="Breaking-long-lines.html#Breaking-long-lines">Breaking long
lines</a></li>
+<li><a href="Indentation.html#index-g_t_002dnip-149"><code>-nip</code></a>: <a
href="Indentation.html#Indentation">Indentation</a></li>
+<li><a href="Indentation.html#index-g_t_002dnlp-143"><code>-nlp</code></a>: <a
href="Indentation.html#Indentation">Indentation</a></li>
+<li><a href="Indentation.html#index-g_t_002dnlps-153"><code>-nlps</code></a>:
<a href="Indentation.html#Indentation">Indentation</a></li>
+<li><a href="Statements.html#index-g_t_002dnpcs-93"><code>-npcs</code></a>: <a
href="Statements.html#Statements">Statements</a></li>
+<li><a
href="Miscellaneous-options.html#index-g_t_002dnpmt-174"><code>-npmt</code></a>:
<a href="Miscellaneous-options.html#Miscellaneous-options">Miscellaneous
options</a></li>
+<li><a
href="Invoking-indent.html#index-g_t_002dnpro-14"><code>-npro</code></a>: <a
href="Invoking-indent.html#Invoking-indent">Invoking indent</a></li>
+<li><a href="Declarations.html#index-g_t_002dnpsl-131"><code>-npsl</code></a>:
<a href="Declarations.html#Declarations">Declarations</a></li>
+<li><a href="Statements.html#index-g_t_002dnsaf-103"><code>-nsaf</code></a>:
<a href="Statements.html#Statements">Statements</a></li>
+<li><a href="Statements.html#index-g_t_002dnsai-107"><code>-nsai</code></a>:
<a href="Statements.html#Statements">Statements</a></li>
+<li><a href="Statements.html#index-g_t_002dnsaw-111"><code>-nsaw</code></a>:
<a href="Statements.html#Statements">Statements</a></li>
+<li><a href="Comments.html#index-g_t_002dnsc-67"><code>-nsc</code></a>: <a
href="Comments.html#Comments">Comments</a></li>
+<li><a href="Blank-lines.html#index-g_t_002dnsob-34"><code>-nsob</code></a>:
<a href="Blank-lines.html#Blank-lines">Blank lines</a></li>
+<li><a href="Statements.html#index-g_t_002dnss-89"><code>-nss</code></a>: <a
href="Statements.html#Statements">Statements</a></li>
+<li><a
href="Miscellaneous-options.html#index-g_t_002dnv-170"><code>-nv</code></a>: <a
href="Miscellaneous-options.html#Miscellaneous-options">Miscellaneous
options</a></li>
+<li><a href="Invoking-indent.html#index-g_t_002do-5"><code>-o</code></a>: <a
href="Invoking-indent.html#Invoking-indent">Invoking indent</a></li>
+<li><a href="Common-styles.html#index-g_t_002dorig-25"><code>-orig</code></a>:
<a href="Common-styles.html#Common-styles">Common styles</a></li>
+<li><a href="Statements.html#index-g_t_002dpcs-91"><code>-pcs</code></a>: <a
href="Statements.html#Statements">Statements</a></li>
+<li><a
href="Miscellaneous-options.html#index-g_t_002dpmt-172"><code>-pmt</code></a>:
<a href="Miscellaneous-options.html#Miscellaneous-options">Miscellaneous
options</a></li>
+<li><a
href="Indentation.html#index-g_t_002dppi_0040var_007bn_007d-155"><code>-ppi</code><var>n</var></a>:
<a href="Indentation.html#Indentation">Indentation</a></li>
+<li><a href="Statements.html#index-g_t_002dprs-113"><code>-prs</code></a>: <a
href="Statements.html#Statements">Statements</a></li>
+<li><a href="Declarations.html#index-g_t_002dpsl-129"><code>-psl</code></a>:
<a href="Declarations.html#Declarations">Declarations</a></li>
+<li><a href="Statements.html#index-g_t_002dsaf-101"><code>-saf</code></a>: <a
href="Statements.html#Statements">Statements</a></li>
+<li><a href="Statements.html#index-g_t_002dsai-105"><code>-sai</code></a>: <a
href="Statements.html#Statements">Statements</a></li>
+<li><a href="Statements.html#index-g_t_002dsaw-109"><code>-saw</code></a>: <a
href="Statements.html#Statements">Statements</a></li>
+<li><a href="Comments.html#index-g_t_002dsc-65"><code>-sc</code></a>: <a
href="Comments.html#Comments">Comments</a></li>
+<li><a href="Blank-lines.html#index-g_t_002dsob-32"><code>-sob</code></a>: <a
href="Blank-lines.html#Blank-lines">Blank lines</a></li>
+<li><a href="Statements.html#index-g_t_002dss-87"><code>-ss</code></a>: <a
href="Statements.html#Statements">Statements</a></li>
+<li><a href="Invoking-indent.html#index-g_t_002dst-8"><code>-st</code></a>: <a
href="Invoking-indent.html#Invoking-indent">Invoking indent</a></li>
+<li><a href="Declarations.html#index-g_t_002dT-134"><code>-T</code></a>: <a
href="Declarations.html#Declarations">Declarations</a></li>
+<li><a
href="Indentation.html#index-g_t_002dts_0040var_007bn_007d-145"><code>-ts</code><var>n</var></a>:
<a href="Indentation.html#Indentation">Indentation</a></li>
+<li><a
href="Miscellaneous-options.html#index-g_t_002dv-168"><code>-v</code></a>: <a
href="Miscellaneous-options.html#Miscellaneous-options">Miscellaneous
options</a></li>
+<li><a
href="Miscellaneous-options.html#index-g_t_002dversion-167"><code>-version</code></a>:
<a href="Miscellaneous-options.html#Miscellaneous-options">Miscellaneous
options</a></li>
+<li><a
href="Invoking-indent.html#index-g_t_0040file_007b_002eindent_002epro_007d-file-12"><samp><span
class="file">.indent.pro</span></samp> file</a>: <a
href="Invoking-indent.html#Invoking-indent">Invoking indent</a></li>
+<li><a href="Backup-files.html#index-backup-files-16">backup files</a>: <a
href="Backup-files.html#Backup-files">Backup files</a></li>
+<li><a
href="Invoking-indent.html#index-Beginning-_0040command_007bindent_007d-3">Beginning
<samp><span class="command">indent</span></samp></a>: <a
href="Invoking-indent.html#Invoking-indent">Invoking indent</a></li>
+<li><a href="Common-styles.html#index-Berkeley-style-23">Berkeley style</a>:
<a href="Common-styles.html#Common-styles">Common styles</a></li>
+<li><a href="Blank-lines.html#index-Blank-lines-27">Blank lines</a>: <a
href="Blank-lines.html#Blank-lines">Blank lines</a></li>
+<li><a href="Comments.html#index-Comments-44">Comments</a>: <a
href="Comments.html#Comments">Comments</a></li>
+<li><a
href="Declarations.html#index-g_t_0040command_007betags_007d-requires-_0040option_007b_002dpsl_007d-133"><samp><span
class="command">etags</span></samp> requires <samp><span
class="option">-psl</span></samp></a>: <a
href="Declarations.html#Declarations">Declarations</a></li>
+<li><a href="Common-styles.html#index-GNU-style-17">GNU style</a>: <a
href="Common-styles.html#Common-styles">Common styles</a></li>
+<li><a href="Invoking-indent.html#index-Initialization-file-13">Initialization
file</a>: <a href="Invoking-indent.html#Invoking-indent">Invoking
indent</a></li>
+<li><a
href="Invoking-indent.html#index-Invoking-_0040command_007bindent_007d-1">Invoking
<samp><span class="command">indent</span></samp></a>: <a
href="Invoking-indent.html#Invoking-indent">Invoking indent</a></li>
+<li><a
href="Common-styles.html#index-Kernighan-_0026-Ritchie-style-20">Kernighan
& Ritchie style</a>: <a href="Common-styles.html#Common-styles">Common
styles</a></li>
+<li><a href="Invoking-indent.html#index-Long-options_002c-use-of-11">Long
options, use of</a>: <a href="Invoking-indent.html#Invoking-indent">Invoking
indent</a></li>
+<li><a href="Common-styles.html#index-Original-Berkeley-style-24">Original
Berkeley style</a>: <a href="Common-styles.html#Common-styles">Common
styles</a></li>
+<li><a href="Invoking-indent.html#index-Output-File-Specification-4">Output
File Specification</a>: <a href="Invoking-indent.html#Invoking-indent">Invoking
indent</a></li>
+<li><a href="Invoking-indent.html#index-Standard-Output-7">Standard
Output</a>: <a href="Invoking-indent.html#Invoking-indent">Invoking
indent</a></li>
+<li><a
href="Invoking-indent.html#index-Starting-_0040command_007bindent_007d-2">Starting
<samp><span class="command">indent</span></samp></a>: <a
href="Invoking-indent.html#Invoking-indent">Invoking indent</a></li>
+<li><a href="Declarations.html#index-typedef-136">typedef</a>: <a
href="Declarations.html#Declarations">Declarations</a></li>
+<li><a href="Declarations.html#index-Typenames-135">Typenames</a>: <a
href="Declarations.html#Declarations">Declarations</a></li>
+<li><a href="Invoking-indent.html#index-Using-Standard-Input-10">Using
Standard Input</a>: <a href="Invoking-indent.html#Invoking-indent">Invoking
indent</a></li>
+</ul>
+<div class="contents">
+<h2>Table of Contents</h2>
+<ul>
+<li><a name="toc_Indent-Program" href="Indent-Program.html#Indent-Program">1
The <samp><span class="command">indent</span></samp> Program</a>
+<ul>
+<li><a href="Invoking-indent.html#Invoking-indent">1.1 Invoking <samp><span
class="command">indent</span></samp></a>
+<li><a href="Backup-files.html#Backup-files">1.2 Backup Files</a>
+<li><a href="Common-styles.html#Common-styles">1.3 Common styles</a>
+<li><a href="Blank-lines.html#Blank-lines">1.4 Blank lines</a>
+<ul>
+<li><a href="_002dbad.html#_002dbad">1.4.1
–blank-lines-after-declarations</a>
+<li><a href="_002dbap.html#_002dbap">1.4.2
–blank-lines-after-procedures</a>
+</li></ul>
+<li><a href="Comments.html#Comments">1.5 Comments</a>
+<li><a href="Statements.html#Statements">1.6 Statements</a>
+<li><a href="Declarations.html#Declarations">1.7 Declarations</a>
+<li><a href="Indentation.html#Indentation">1.8 Indentation</a>
+<li><a href="Breaking-long-lines.html#Breaking-long-lines">1.9 Breaking long
lines</a>
+<li><a href="Disabling-Formatting.html#Disabling-Formatting">1.10 Disabling
Formatting</a>
+<li><a href="Miscellaneous-options.html#Miscellaneous-options">1.11
Miscellaneous options</a>
+<li><a href="Bugs.html#Bugs">1.12 Bugs</a>
+<li><a href="Copyright.html#Copyright">1.13 Copyright</a>
+</li></ul>
+<li><a name="toc_Option-Summary"
href="Option-Summary.html#Option-Summary">Appendix A Option Summary</a>
+<li><a name="toc_Index" href="Index.html#Index">Index</a>
+</li></ul>
+</div>
+
+</body></html>
+
Index: software/indent/manual/html_node/Invoking-indent.html
===================================================================
RCS file: software/indent/manual/html_node/Invoking-indent.html
diff -N software/indent/manual/html_node/Invoking-indent.html
--- /dev/null 1 Jan 1970 00:00:00 -0000
+++ software/indent/manual/html_node/Invoking-indent.html 18 Sep 2008
15:15:09 -0000 1.1
@@ -0,0 +1,132 @@
+<html lang="en">
+<head>
+<title>Invoking indent - `indent': Indent and Format C Program Source</title>
+<meta http-equiv="Content-Type" content="text/html">
+<meta name="description" content="`indent': Indent and Format C Program
Source">
+<meta name="generator" content="makeinfo 4.11">
+<link title="Top" rel="start" href="index.html#Top">
+<link rel="up" href="Indent-Program.html#Indent-Program" title="Indent
Program">
+<link rel="next" href="Backup-files.html#Backup-files" title="Backup files">
+<link href="http://www.gnu.org/software/texinfo/" rel="generator-home"
title="Texinfo Homepage">
+<meta http-equiv="Content-Style-Type" content="text/css">
+<style type="text/css"><!--
+ pre.display { font-family:inherit }
+ pre.format { font-family:inherit }
+ pre.smalldisplay { font-family:inherit; font-size:smaller }
+ pre.smallformat { font-family:inherit; font-size:smaller }
+ pre.smallexample { font-size:smaller }
+ pre.smalllisp { font-size:smaller }
+ span.sc { font-variant:small-caps }
+ span.roman { font-family:serif; font-weight:normal; }
+ span.sansserif { font-family:sans-serif; font-weight:normal; }
+--></style>
+</head>
+<body>
+<div class="node">
+<p>
+<a name="Invoking-indent"></a>
+Next: <a rel="next" accesskey="n"
href="Backup-files.html#Backup-files">Backup files</a>,
+Up: <a rel="up" accesskey="u"
href="Indent-Program.html#Indent-Program">Indent Program</a>
+<hr>
+</div>
+
+<h3 class="section">1.1 Invoking <samp><span
class="command">indent</span></samp></h3>
+
+<p><a name="index-Invoking-_0040command_007bindent_007d-1"></a><a
name="index-Starting-_0040command_007bindent_007d-2"></a><a
name="index-Beginning-_0040command_007bindent_007d-3"></a>
+As of version 1.3, the format of the <samp><span
class="command">indent</span></samp> command is:
+
+<pre class="example">
+ indent [<var>options</var>] [<var>input-files</var>]
+
+ indent [<var>options</var>] [<var>single-input-file</var>] [-o
<var>output-file</var>]
+</pre>
+ <p>This format is different from earlier versions and other versions of
+<samp><span class="command">indent</span></samp>.
+
+ <p>In the first form, one or more input files are specified. <samp><span
class="command">indent</span></samp>
+makes a backup copy of each file, and the original file is replaced with
+its indented version. See <a href="Backup-files.html#Backup-files">Backup
files</a>, for an explanation of how
+backups are made.
+
+ <p><a name="index-Output-File-Specification-4"></a><a
name="index-g_t_002do-5"></a><a
name="index-g_t_002d_002doutput_002dfile-6"></a>In the second form, only one
input file is specified. In this case, or
+when the standard input is used, you may specify an output file after
+the <samp><span class="option">-o</span></samp> option.
+
+ <p><a name="index-Standard-Output-7"></a><a
name="index-g_t_002dst-8"></a><a
name="index-g_t_002d_002dstandard_002doutput-9"></a>To cause <samp><span
class="command">indent</span></samp> to write to standard output, use the
<samp><span class="option">-st</span></samp>
+option. This is only allowed when there is only one input file, or when
+the standard input is used.
+
+ <p><a name="index-Using-Standard-Input-10"></a>If no input files are named,
the standard input is read for input.
+Also, if a filename named <samp><span class="option">-</span></samp> is
specified, then the standard input
+is read.
+
+ <p>As an example, each of the following commands will input the program
+<samp><span class="file">slithy_toves.c</span></samp> and write its indented
text to
+<samp><span class="file">slithy_toves.out</span></samp>:
+
+<pre class="example">
+ indent slithy_toves.c -o slithy_toves.out
+
+ indent -st slithy_toves.c > slithy_toves.out
+
+ cat slithy_toves.c | indent -o slithy_toves.out
+</pre>
+ <p><a name="index-Long-options_002c-use-of-11"></a>Most other options to
<samp><span class="command">indent</span></samp> control how programs are
formatted.
+As of version 1.2, <samp><span class="command">indent</span></samp> also
recognizes a long name for each
+option name. Long options are prefixed by either <samp><span
class="option">--</span></samp> or
+<samp><span class="option">+</span></samp>.
+<a rel="footnote" href="#fn-1" name="fnd-1"><sup>1</sup></a>
+ In most of this document,
+the traditional, short names are used for the sake of brevity.
+See <a href="Option-Summary.html#Option-Summary">Option Summary</a>, for a
list of options, including both long and
+short names.
+
+ <p>Here is another example:
+
+<pre class="example"> indent -br test/metabolism.c -l85
+</pre>
+ <p>This will indent the program <samp><span
class="file">test/metabolism.c</span></samp> using the
+<samp><span class="option">-br</span></samp> and <samp><span
class="option">-l85</span></samp> options, write the output back to
+<samp><span class="file">test/metabolism.c</span></samp>, and write the
original contents of
+<samp><span class="file">test/metabolism.c</span></samp> to a backup file in
the directory <samp><span class="file">test</span></samp>.
+
+ <p>Equivalent invocations using long option names for this example would
+be:
+
+<pre class="example">
+ indent --braces-on-if-line --line-length185 test/metabolism.c
+
+ indent +braces-on-if-line +line-length185 test/metabolism.c
+</pre>
+ <p><a name="index-g_t_0040file_007b_002eindent_002epro_007d-file-12"></a><a
name="index-Initialization-file-13"></a><a name="index-g_t_002dnpro-14"></a><a
name="index-g_t_002d_002dignore_002dprofile-15"></a>If you find that you often
use <samp><span class="command">indent</span></samp> with the same options, you
+may put those options into a file named <samp><span
class="file">.indent.pro</span></samp>.
+<samp><span class="command">indent</span></samp> will look for a profile file
in three places. First it will check
+the environment variable <samp><span class="env">INDENT_PROFILE</span></samp>.
If that exists its value
+is expected to name the file that is to be used. If the environment variable
does
+not exist, indent looks for <samp><span class="file">.indent.pro</span></samp>
in the current directory
+ and use that if found. Finally <samp><span
class="command">indent</span></samp> will search
+your home directory for <samp><span class="file">.indent.pro</span></samp> and
use that file if it is
+found. This behaviour is different from that of other versions of
+<samp><span class="command">indent</span></samp>, which load both files if
they both exist.
+
+ <p>The format of <samp><span class="file">.indent.pro</span></samp> is
simply a list of options, just as
+they would appear on the command line, separated by white space (tabs,
+spaces, and newlines). Options in <samp><span
class="file">.indent.pro</span></samp> may be surrounded by C
+or C++ comments, in which case they are ignored.
+
+ <p>Command line switches are handled <em>after</em> processing
+<samp><span class="file">.indent.pro</span></samp>. Options specified later
override arguments
+specified earlier, with one exception: Explicitly specified options
+always override background options (see <a
href="Common-styles.html#Common-styles">Common styles</a>). You can
+prevent <samp><span class="command">indent</span></samp> from reading an
<samp><span class="file">.indent.pro</span></samp> file by
+specifying the <samp><span class="option">-npro</span></samp> option.
+
+ <div class="footnote">
+<hr>
+<h4>Footnotes</h4><p class="footnote"><small>[<a name="fn-1"
href="#fnd-1">1</a>]</small> <samp><span class="option">+</span></samp> is
being superseded by <samp><span class="option">--</span></samp> to
+maintain consistency with the POSIX standard.</p>
+
+ <hr></div>
+
+ </body></html>
+
Index: software/indent/manual/html_node/Miscellaneous-options.html
===================================================================
RCS file: software/indent/manual/html_node/Miscellaneous-options.html
diff -N software/indent/manual/html_node/Miscellaneous-options.html
--- /dev/null 1 Jan 1970 00:00:00 -0000
+++ software/indent/manual/html_node/Miscellaneous-options.html 18 Sep 2008
15:15:09 -0000 1.1
@@ -0,0 +1,57 @@
+<html lang="en">
+<head>
+<title>Miscellaneous options - `indent': Indent and Format C Program
Source</title>
+<meta http-equiv="Content-Type" content="text/html">
+<meta name="description" content="`indent': Indent and Format C Program
Source">
+<meta name="generator" content="makeinfo 4.11">
+<link title="Top" rel="start" href="index.html#Top">
+<link rel="up" href="Indent-Program.html#Indent-Program" title="Indent
Program">
+<link rel="prev" href="Disabling-Formatting.html#Disabling-Formatting"
title="Disabling Formatting">
+<link rel="next" href="Bugs.html#Bugs" title="Bugs">
+<link href="http://www.gnu.org/software/texinfo/" rel="generator-home"
title="Texinfo Homepage">
+<meta http-equiv="Content-Style-Type" content="text/css">
+<style type="text/css"><!--
+ pre.display { font-family:inherit }
+ pre.format { font-family:inherit }
+ pre.smalldisplay { font-family:inherit; font-size:smaller }
+ pre.smallformat { font-family:inherit; font-size:smaller }
+ pre.smallexample { font-size:smaller }
+ pre.smalllisp { font-size:smaller }
+ span.sc { font-variant:small-caps }
+ span.roman { font-family:serif; font-weight:normal; }
+ span.sansserif { font-family:sans-serif; font-weight:normal; }
+--></style>
+</head>
+<body>
+<div class="node">
+<p>
+<a name="Miscellaneous-options"></a>
+Next: <a rel="next" accesskey="n" href="Bugs.html#Bugs">Bugs</a>,
+Previous: <a rel="previous" accesskey="p"
href="Disabling-Formatting.html#Disabling-Formatting">Disabling Formatting</a>,
+Up: <a rel="up" accesskey="u"
href="Indent-Program.html#Indent-Program">Indent Program</a>
+<hr>
+</div>
+
+<!-- node-name, next, previous, up -->
+<h3 class="section">1.11 Miscellaneous options</h3>
+
+<p><a name="index-g_t_002dversion-167"></a>To find out what version of
<samp><span class="command">indent</span></samp> you have, use the command
+<code>indent -version</code>. This will report the version number of
+<samp><span class="command">indent</span></samp>, without doing any of the
normal processing.
+
+ <p><a name="index-g_t_002dv-168"></a><a
name="index-g_t_002d_002dverbose-169"></a><a name="index-g_t_002dnv-170"></a><a
name="index-g_t_002d_002dno_002dverbosity-171"></a><!-- Would -terse be better?
I think not, but perhaps accepting -->
+<!-- no-verbose would avoid error messages. -->
+The <samp><span class="option">-v</span></samp> option can be used to turn on
verbose mode. When in
+verbose mode, <samp><span class="command">indent</span></samp> reports when it
splits one line of input
+into two more more lines of output, and gives some size statistics at
+completion.
+
+ <p><a name="index-g_t_002dpmt-172"></a><a
name="index-g_t_002d_002dpreserve_002dmtime-173"></a><a
name="index-g_t_002dnpmt-174"></a>The <samp><span
class="option">-pmt</span></samp> option causes <samp><span
class="command">indent</span></samp> to preserve the access
+and modification times on the output files. Using this option
+has the advantage that running indent on all source and header
+files in a project won't cause <code>make</code> to rebuild all targets.
+This option is only available on Operating Systems that have the
+POSIX <code>utime(2)</code> function.
+
+ </body></html>
+
Index: software/indent/manual/html_node/Option-Summary.html
===================================================================
RCS file: software/indent/manual/html_node/Option-Summary.html
diff -N software/indent/manual/html_node/Option-Summary.html
--- /dev/null 1 Jan 1970 00:00:00 -0000
+++ software/indent/manual/html_node/Option-Summary.html 18 Sep 2008
15:15:10 -0000 1.1
@@ -0,0 +1,303 @@
+<html lang="en">
+<head>
+<title>Option Summary - `indent': Indent and Format C Program Source</title>
+<meta http-equiv="Content-Type" content="text/html">
+<meta name="description" content="`indent': Indent and Format C Program
Source">
+<meta name="generator" content="makeinfo 4.11">
+<link title="Top" rel="start" href="index.html#Top">
+<link rel="prev" href="Indent-Program.html#Indent-Program" title="Indent
Program">
+<link rel="next" href="Index.html#Index" title="Index">
+<link href="http://www.gnu.org/software/texinfo/" rel="generator-home"
title="Texinfo Homepage">
+<meta http-equiv="Content-Style-Type" content="text/css">
+<style type="text/css"><!--
+ pre.display { font-family:inherit }
+ pre.format { font-family:inherit }
+ pre.smalldisplay { font-family:inherit; font-size:smaller }
+ pre.smallformat { font-family:inherit; font-size:smaller }
+ pre.smallexample { font-size:smaller }
+ pre.smalllisp { font-size:smaller }
+ span.sc { font-variant:small-caps }
+ span.roman { font-family:serif; font-weight:normal; }
+ span.sansserif { font-family:sans-serif; font-weight:normal; }
+--></style>
+</head>
+<body>
+<div class="node">
+<p>
+<a name="Option-Summary"></a>
+Next: <a rel="next" accesskey="n" href="Index.html#Index">Index</a>,
+Previous: <a rel="previous" accesskey="p"
href="Indent-Program.html#Indent-Program">Indent Program</a>,
+Up: <a rel="up" accesskey="u" href="index.html#Top">Top</a>
+<hr>
+</div>
+
+<h2 class="appendix">Appendix A Option Summary</h2>
+
+<p>Here is a list of all the options for <samp><span
class="command">indent</span></samp>, alphabetized by
+short option. It is followed by a cross key alphabetized by long option.
+
+<!-- !BEGIN OPTIONS -->
+<!-- The cross references are all on lines by themselves because this -->
+<!-- looks better in both printed output and Info. 4 Feb 1992 -rjc -->
+ <dl>
+<dt>‘<samp><span
class="samp">-bad</span></samp>’<dt>‘<samp><span
class="samp">--blank-lines-after-declarations</span></samp>’<dd>Force
blank lines after the declarations.<br>
+See <a href="Blank-lines.html#Blank-lines">Blank lines</a>.
+
+ <br><dt>‘<samp><span
class="samp">-bap</span></samp>’<dt>‘<samp><span
class="samp">--blank-lines-after-procedures</span></samp>’<dd>Force blank
lines after procedure bodies.<br>
+See <a href="Blank-lines.html#Blank-lines">Blank lines</a>.
+
+ <br><dt>‘<samp><span
class="samp">-bbb</span></samp>’<dt>‘<samp><span
class="samp">--blank-lines-before-block-comments</span></samp>’<dd>Force
blank lines before block comments.<br>
+See <a href="Blank-lines.html#Blank-lines">Blank lines</a>.
+
+ <br><dt>‘<samp><span
class="samp">-bbo</span></samp>’<dt>‘<samp><span
class="samp">--break-before-boolean-operator</span></samp>’<dd>Prefer to
break long lines before boolean operators.<br>
+See <a href="Breaking-long-lines.html#Breaking-long-lines">Breaking long
lines</a>.
+
+ <br><dt>‘<samp><span
class="samp">-bc</span></samp>’<dt>‘<samp><span
class="samp">--blank-lines-after-commas</span></samp>’<dd>Force newline
after comma in declaration.<br>
+See <a href="Declarations.html#Declarations">Declarations</a>.
+
+ <br><dt>‘<samp><span
class="samp">-bl</span></samp>’<dt>‘<samp><span
class="samp">--braces-after-if-line</span></samp>’<dd>Put braces on line
after <code>if</code>, etc.<br>
+See <a href="Statements.html#Statements">Statements</a>.
+
+ <br><dt>‘<samp><span
class="samp">-bli</span><var>n</var></samp>’<dt>‘<samp><span
class="samp">--brace-indent</span><var>n</var></samp>’<dd>Indent braces
<var>n</var> spaces.<br>
+See <a href="Statements.html#Statements">Statements</a>.
+
+ <br><dt>‘<samp><span
class="samp">-bls</span></samp>’<dt>‘<samp><span
class="samp">--braces-after-struct-decl-line</span></samp>’<dd>Put braces
on the line after <code>struct</code> declaration lines.<br>
+See <a href="Declarations.html#Declarations">Declarations</a>.
+
+ <br><dt>‘<samp><span
class="samp">-br</span></samp>’<dt>‘<samp><span
class="samp">--braces-on-if-line</span></samp>’<dd>Put braces on line
with <code>if</code>, etc.<br>
+See <a href="Statements.html#Statements">Statements</a>.
+
+ <br><dt>‘<samp><span
class="samp">-brs</span></samp>’<dt>‘<samp><span
class="samp">--braces-on-struct-decl-line</span></samp>’<dd>Put braces on
<code>struct</code> declaration line.<br>
+See <a href="Declarations.html#Declarations">Declarations</a>.
+
+ <br><dt>‘<samp><span
class="samp">-bs</span></samp>’<dt>‘<samp><span
class="samp">--Bill-Shannon</span></samp>’<dt>‘<samp><span
class="samp">--blank-before-sizeof</span></samp>’<dd>Put a space between
<code>sizeof</code> and its argument.<br>
+See <a href="Statements.html#Statements">Statements</a>.
+
+ <br><dt>‘<samp><span
class="samp">-c</span><var>n</var></samp>’<dt>‘<samp><span
class="samp">--comment-indentation</span><var>n</var></samp>’<dd>Put
comments to the right of code in column <var>n</var>.<br>
+See <a href="Comments.html#Comments">Comments</a>.
+
+ <br><dt>‘<samp><span
class="samp">-cbi</span><var>n</var></samp>’<dt>‘<samp><span
class="samp">--case-brace-indentation</span><var>n</var></samp>’<dd>Indent
braces after a case label N spaces.<br>
+See <a href="Statements.html#Statements">Statements</a>.
+
+ <br><dt>‘<samp><span
class="samp">-cd</span><var>n</var></samp>’<dt>‘<samp><span
class="samp">--declaration-comment-column</span><var>n</var></samp>’<dd>Put
comments to the right of the declarations in column <var>n</var>.<br>
+See <a href="Comments.html#Comments">Comments</a>.
+
+ <br><dt>‘<samp><span
class="samp">-cdb</span></samp>’<dt>‘<samp><span
class="samp">--comment-delimiters-on-blank-lines</span></samp>’<dd>Put
comment delimiters on blank lines.<br>
+See <a href="Comments.html#Comments">Comments</a>.
+
+ <br><dt>‘<samp><span
class="samp">-cdw</span></samp>’<dt>‘<samp><span
class="samp">--cuddle-do-while</span></samp>’<dd>Cuddle while of <code>do
{} while;</code> and preceeding ‘<samp><span
class="samp">}</span></samp>’.<br>
+See <a href="Comments.html#Comments">Comments</a>.
+
+ <br><dt>‘<samp><span
class="samp">-ce</span></samp>’<dt>‘<samp><span
class="samp">--cuddle-else</span></samp>’<dd>Cuddle else and preceeding
‘<samp><span class="samp">}</span></samp>’.<br>
+See <a href="Comments.html#Comments">Comments</a>.
+
+ <br><dt>‘<samp><span
class="samp">-ci</span><var>n</var></samp>’<dt>‘<samp><span
class="samp">--continuation-indentation</span><var>n</var></samp>’<dd>Continuation
indent of <var>n</var> spaces.<br>
+See <a href="Statements.html#Statements">Statements</a>.
+
+ <br><dt>‘<samp><span
class="samp">-cli</span><var>n</var></samp>’<dt>‘<samp><span
class="samp">--case-indentation</span><var>n</var></samp>’<dd>Case label
indent of <var>n</var> spaces.<br>
+See <a href="Statements.html#Statements">Statements</a>.
+
+ <br><dt>‘<samp><span
class="samp">-cp</span><var>n</var></samp>’<dt>‘<samp><span
class="samp">--else-endif-column</span><var>n</var></samp>’<dd>Put
comments to the right of <code>#else</code> and
+<code>#endif</code> statements in column <var>n</var>.<br>
+See <a href="Comments.html#Comments">Comments</a>.
+
+ <br><dt>‘<samp><span
class="samp">-cs</span></samp>’<dt>‘<samp><span
class="samp">--space-after-cast</span></samp>’<dd>Put a space after a
cast operator.<br>
+See <a href="Statements.html#Statements">Statements</a>.
+
+ <br><dt>‘<samp><span
class="samp">-d</span><var>n</var></samp>’<dt>‘<samp><span
class="samp">--line-comments-indentation</span><var>n</var></samp>’<dd>Set
indentation of comments not to the right
+of code to <var>n</var> spaces.<br>
+See <a href="Comments.html#Comments">Comments</a>.
+
+ <br><dt>‘<samp><span
class="samp">-bfda</span></samp>’<dt>‘<samp><span
class="samp">--break-function-decl-args</span></samp>’<dd>Break the line
before all arguments in a declaration.<br>
+See <a href="Declarations.html#Declarations">Declarations</a>.
+
+ <br><dt>‘<samp><span
class="samp">-bfde</span></samp>’<dt>‘<samp><span
class="samp">--break-function-decl-args</span></samp>’<dd>Break the line
after the last argument in a declaration.<br>
+See <a href="Declarations.html#Declarations">Declarations</a>.
+
+ <br><dt>‘<samp><span
class="samp">-di</span><var>n</var></samp>’<dt>‘<samp><span
class="samp">--declaration-indentation</span><var>n</var></samp>’<dd>Put
variables in column <var>n</var>.<br>
+See <a href="Declarations.html#Declarations">Declarations</a>.
+
+ <br><dt>‘<samp><span
class="samp">-fc1</span></samp>’<dt>‘<samp><span
class="samp">--format-first-column-comments</span></samp>’<dd>Format
comments in the first column.<br>
+See <a href="Comments.html#Comments">Comments</a>.
+
+ <br><dt>‘<samp><span
class="samp">-fca</span></samp>’<dt>‘<samp><span
class="samp">--format-all-comments</span></samp>’<dd>Do not disable all
formatting of comments.<br>
+See <a href="Comments.html#Comments">Comments</a>.
+
+ <br><dt>‘<samp><span
class="samp">-gnu</span></samp>’<dt>‘<samp><span
class="samp">--gnu-style</span></samp>’<dd>Use GNU coding style. This is
the default.<br>
+See <a href="Common-styles.html#Common-styles">Common styles</a>.
+
+ <br><dt>‘<samp><span
class="samp">-hnl</span></samp>’<dt>‘<samp><span
class="samp">--honour-newlines</span></samp>’<dd>Prefer to break long
lines at the position of newlines in the input.<br>
+See <a href="Breaking-long-lines.html#Breaking-long-lines">Breaking long
lines</a>.
+
+ <br><dt>‘<samp><span
class="samp">-i</span><var>n</var></samp>’<dt>‘<samp><span
class="samp">--indent-level</span><var>n</var></samp>’<dd>Set indentation
level to <var>n</var> spaces.<br>
+See <a href="Indentation.html#Indentation">Indentation</a>.
+
+ <br><dt>‘<samp><span
class="samp">-ip</span><var>n</var></samp>’<dt>‘<samp><span
class="samp">--parameter-indentation</span><var>n</var></samp>’<dd>Indent
parameter types in old-style function
+definitions by <var>n</var> spaces.<br>
+See <a href="Indentation.html#Indentation">Indentation</a>.
+
+ <br><dt>‘<samp><span
class="samp">-kr</span></samp>’<dt>‘<samp><span
class="samp">--k-and-r-style</span></samp>’<dd>Use Kernighan &
Ritchie coding style.<br>
+See <a href="Common-styles.html#Common-styles">Common styles</a>.
+
+ <br><dt>‘<samp><span
class="samp">-l</span><var>n</var></samp>’<dt>‘<samp><span
class="samp">--line-length</span><var>n</var></samp>’<dd>Set maximum line
length for non-comment lines to <var>n</var>.<br>
+See <a href="Breaking-long-lines.html#Breaking-long-lines">Breaking long
lines</a>.
+
+ <br><dt>‘<samp><span
class="samp">-lc</span><var>n</var></samp>’<dt>‘<samp><span
class="samp">--comment-line-length</span><var>n</var></samp>’<dd>Set
maximum line length for comment formatting to <var>n</var>.<br>
+See <a href="Comments.html#Comments">Comments</a>.
+
+ <br><dt>‘<samp><span
class="samp">-lp</span></samp>’<dt>‘<samp><span
class="samp">--continue-at-parentheses</span></samp>’<dd>Line up
continued lines at parentheses.<br>
+See <a href="Indentation.html#Indentation">Indentation</a>.
+
+ <br><dt>‘<samp><span
class="samp">-lps</span></samp>’<dt>‘<samp><span
class="samp">--leave-preprocessor-space</span></samp>’<dd>Leave space
between ‘<samp><span class="samp">#</span></samp>’ and preprocessor
directive.<br>
+See <a href="Indentation.html#Indentation">Indentation</a>.
+
+ <br><dt>‘<samp><span
class="samp">-nbad</span></samp>’<dt>‘<samp><span
class="samp">--no-blank-lines-after-declarations</span></samp>’<dd>Do not
force blank lines after declarations.<br>
+See <a href="Blank-lines.html#Blank-lines">Blank lines</a>.
+
+ <br><dt>‘<samp><span
class="samp">-nbap</span></samp>’<dt>‘<samp><span
class="samp">--no-blank-lines-after-procedures</span></samp>’<dd>Do not
force blank lines after procedure bodies.<br>
+See <a href="Blank-lines.html#Blank-lines">Blank lines</a>.
+
+ <br><dt>‘<samp><span
class="samp">-nbbo</span></samp>’<dt>‘<samp><span
class="samp">--break-after-boolean-operator</span></samp>’<dd>Do not
prefer to break long lines before boolean operators.<br>
+See <a href="Breaking-long-lines.html#Breaking-long-lines">Breaking long
lines</a>.
+
+ <br><dt>‘<samp><span
class="samp">-nbc</span></samp>’<dt>‘<samp><span
class="samp">--no-blank-lines-after-commas</span></samp>’<dd>Do not force
newlines after commas in declarations.<br>
+See <a href="Declarations.html#Declarations">Declarations</a>.
+
+ <br><dt>‘<samp><span
class="samp">-nbfda</span></samp>’<dt>‘<samp><span
class="samp">--dont-break-function-decl-args</span></samp>’<dd>Don't put
each argument in a function declaration on a seperate line.<br>
+See <a href="Declarations.html#Declarations">Declarations</a>.
+
+ <br><dt>‘<samp><span
class="samp">-ncdb</span></samp>’<dt>‘<samp><span
class="samp">--no-comment-delimiters-on-blank-lines</span></samp>’<dd>Do
not put comment delimiters on blank lines.<br>
+See <a href="Comments.html#Comments">Comments</a>.
+
+ <br><dt>‘<samp><span
class="samp">-ncdw</span></samp>’<dt>‘<samp><span
class="samp">--dont-cuddle-do-while</span></samp>’<dd>Do not cuddle
<code>}</code> and the <code>while</code> of a <code>do {} while;</code>.<br>
+See <a href="Statements.html#Statements">Statements</a>.
+
+ <br><dt>‘<samp><span
class="samp">-nce</span></samp>’<dt>‘<samp><span
class="samp">--dont-cuddle-else</span></samp>’<dd>Do not cuddle
<code>}</code> and <code>else</code>.<br>
+See <a href="Statements.html#Statements">Statements</a>.
+
+ <br><dt>‘<samp><span
class="samp">-ncs</span></samp>’<dt>‘<samp><span
class="samp">--no-space-after-casts</span></samp>’<dd>Do not put a space
after cast operators.<br>
+See <a href="Statements.html#Statements">Statements</a>.
+
+ <br><dt>‘<samp><span
class="samp">-nfc1</span></samp>’<dt>‘<samp><span
class="samp">--dont-format-first-column-comments</span></samp>’<dd>Do not
format comments in the first column as normal.<br>
+See <a href="Comments.html#Comments">Comments</a>.
+
+ <br><dt>‘<samp><span
class="samp">-nfca</span></samp>’<dt>‘<samp><span
class="samp">--dont-format-comments</span></samp>’<dd>Do not format any
comments.<br>
+See <a href="Comments.html#Comments">Comments</a>.
+
+ <br><dt>‘<samp><span
class="samp">-nhnl</span></samp>’<dt>‘<samp><span
class="samp">--ignore-newlines</span></samp>’<dd>Do not prefer to break
long lines at the position of newlines in the input.<br>
+See <a href="Breaking-long-lines.html#Breaking-long-lines">Breaking long
lines</a>.
+
+ <br><dt>‘<samp><span
class="samp">-nip</span></samp>’<dt>‘<samp><span
class="samp">--no-parameter-indentation</span></samp>’<dd>Zero width
indentation for parameters.<br>
+See <a href="Indentation.html#Indentation">Indentation</a>.
+
+ <br><dt>‘<samp><span
class="samp">-nlp</span></samp>’<dt>‘<samp><span
class="samp">--dont-line-up-parentheses</span></samp>’<dd>Do not line up
parentheses.<br>
+See <a href="Statements.html#Statements">Statements</a>.
+
+ <br><dt>‘<samp><span
class="samp">-npcs</span></samp>’<dt>‘<samp><span
class="samp">--no-space-after-function-call-names</span></samp>’<dd>Do
not put space after the function in function calls.<br>
+See <a href="Statements.html#Statements">Statements</a>.
+
+ <br><dt>‘<samp><span
class="samp">-nprs</span></samp>’<dt>‘<samp><span
class="samp">--no-space-after-parentheses</span></samp>’<dd>Do not put a
space after every '(' and before every ')'.<br>
+See <a href="Statements.html#Statements">Statements</a>.
+
+ <br><dt>‘<samp><span
class="samp">-npsl</span></samp>’<dt>‘<samp><span
class="samp">--dont-break-procedure-type</span></samp>’<dd>Put the type
of a procedure on the same line as its name.<br>
+See <a href="Declarations.html#Declarations">Declarations</a>.
+
+ <br><dt>‘<samp><span
class="samp">-nsaf</span></samp>’<dt>‘<samp><span
class="samp">--no-space-after-for</span></samp>’<dd>Do not put a space
after every <code>for</code>.<br>
+See <a href="Statements.html#Statements">Statements</a>.
+
+ <br><dt>‘<samp><span
class="samp">-nsai</span></samp>’<dt>‘<samp><span
class="samp">--no-space-after-if</span></samp>’<dd>Do not put a space
after every <code>if</code>.<br>
+See <a href="Statements.html#Statements">Statements</a>.
+
+ <br><dt>‘<samp><span
class="samp">-nsaw</span></samp>’<dt>‘<samp><span
class="samp">--no-space-after-while</span></samp>’<dd>Do not put a space
after every <code>while</code>.<br>
+See <a href="Statements.html#Statements">Statements</a>.
+
+ <br><dt>‘<samp><span
class="samp">-nsc</span></samp>’<dt>‘<samp><span
class="samp">--dont-star-comments</span></samp>’<dd>Do not put the
‘<samp><span class="samp">*</span></samp>’ character at the left of
comments.<br>
+See <a href="Comments.html#Comments">Comments</a>.
+
+ <br><dt>‘<samp><span
class="samp">-nsob</span></samp>’<dt>‘<samp><span
class="samp">--leave-optional-blank-lines</span></samp>’<dd>Do not
swallow optional blank lines.<br>
+See <a href="Blank-lines.html#Blank-lines">Blank lines</a>.
+
+ <br><dt>‘<samp><span
class="samp">-nss</span></samp>’<dt>‘<samp><span
class="samp">--dont-space-special-semicolon</span></samp>’<dd>Do not
force a space before the semicolon after certain statements.
+Disables <samp><span class="option">-ss</span></samp>.<br>
+See <a href="Statements.html#Statements">Statements</a>.
+
+ <br><dt>‘<samp><span
class="samp">-nut</span></samp>’<dt>‘<samp><span
class="samp">--no-tabs</span></samp>’<dd>Use spaces instead of tabs.<br>
+See <a href="Indentation.html#Indentation">Indentation</a>.
+
+ <br><dt>‘<samp><span
class="samp">-nv</span></samp>’<dt>‘<samp><span
class="samp">--no-verbosity</span></samp>’<dd>Disable verbose mode.<br>
+See <a href="Miscellaneous-options.html#Miscellaneous-options">Miscellaneous
options</a>.
+
+ <br><dt>‘<samp><span
class="samp">-orig</span></samp>’<dt>‘<samp><span
class="samp">--original</span></samp>’<dd>Use the original Berkeley
coding style.<br>
+See <a href="Common-styles.html#Common-styles">Common styles</a>.
+
+ <br><dt>‘<samp><span
class="samp">-npro</span></samp>’<dt>‘<samp><span
class="samp">--ignore-profile</span></samp>’<dd>Do not read <samp><span
class="file">.indent.pro</span></samp> files.<br>
+See <a href="Invoking-indent.html#Invoking-indent">Invoking indent</a>.
+
+ <br><dt>‘<samp><span
class="samp">-pcs</span></samp>’<dt>‘<samp><span
class="samp">--space-after-procedure-calls</span></samp>’<dd>Insert a
space between the name of the
+procedure being called and the ‘<samp><span
class="samp">(</span></samp>’.<br>
+See <a href="Statements.html#Statements">Statements</a>.
+
+ <br><dt>‘<samp><span
class="samp">-pi</span><var>n</var></samp>’<dt>‘<samp><span
class="samp">--paren-indentation</span><var>n</var></samp>’<dd>Specify
the extra indentation per open parentheses '(' when a
+statement is broken.
+See <a href="Statements.html#Statements">Statements</a>.
+
+ <br><dt>‘<samp><span
class="samp">-pmt</span></samp>’<dt>‘<samp><span
class="samp">--preserve-mtime</span></samp>’<dd>Preserve access and
modification times on output files.
+See <a href="Miscellaneous-options.html#Miscellaneous-options">Miscellaneous
options</a>.
+
+ <br><dt>‘<samp><span
class="samp">-prs</span></samp>’<dt>‘<samp><span
class="samp">--space-after-parentheses</span></samp>’<dd>Put a space
after every '(' and before every ')'.<br>
+See <a href="Statements.html#Statements">Statements</a>.
+
+ <br><dt>‘<samp><span
class="samp">-psl</span></samp>’<dt>‘<samp><span
class="samp">--procnames-start-lines</span></samp>’<dd>Put the type of a
procedure on the line before its name.<br>
+See <a href="Declarations.html#Declarations">Declarations</a>.
+
+ <br><dt>‘<samp><span
class="samp">-saf</span></samp>’<dt>‘<samp><span
class="samp">--space-after-for</span></samp>’<dd>Put a space after each
<code>for</code>.<br>
+See <a href="Statements.html#Statements">Statements</a>.
+
+ <br><dt>‘<samp><span
class="samp">-sai</span></samp>’<dt>‘<samp><span
class="samp">--space-after-if</span></samp>’<dd>Put a space after each
<code>if</code>.<br>
+See <a href="Statements.html#Statements">Statements</a>.
+
+ <br><dt>‘<samp><span
class="samp">-saw</span></samp>’<dt>‘<samp><span
class="samp">--space-after-while</span></samp>’<dd>Put a space after each
<code>while</code>.<br>
+See <a href="Statements.html#Statements">Statements</a>.
+
+ <br><dt>‘<samp><span
class="samp">-sbi</span><var>n</var></samp>’<dt>‘<samp><span
class="samp">--struct-brace-indentation</span><var>n</var></samp>’<dd>Indent
braces of a struct, union or enum N spaces.<br>
+See <a href="Statements.html#Statements">Statements</a>.
+
+ <br><dt>‘<samp><span
class="samp">-sc</span></samp>’<dt>‘<samp><span
class="samp">--start-left-side-of-comments</span></samp>’<dd>Put the
‘<samp><span class="samp">*</span></samp>’ character at the left of
comments.<br>
+See <a href="Comments.html#Comments">Comments</a>.
+
+ <br><dt>‘<samp><span
class="samp">-sob</span></samp>’<dt>‘<samp><span
class="samp">--swallow-optional-blank-lines</span></samp>’<dd>Swallow
optional blank lines.<br>
+See <a href="Blank-lines.html#Blank-lines">Blank lines</a>.
+
+ <br><dt>‘<samp><span
class="samp">-ss</span></samp>’<dt>‘<samp><span
class="samp">--space-special-semicolon</span></samp>’<dd>On one-line
<code>for</code> and <code>while</code> statments,
+force a blank before the semicolon.<br>
+See <a href="Statements.html#Statements">Statements</a>.
+
+ <br><dt>‘<samp><span
class="samp">-st</span></samp>’<dt>‘<samp><span
class="samp">--standard-output</span></samp>’<dd>Write to standard
output.<br>
+See <a href="Invoking-indent.html#Invoking-indent">Invoking indent</a>.
+
+ <br><dt>‘<samp><span class="samp">-T</span></samp>’<dd>Tell
<samp><span class="command">indent</span></samp> the name of typenames.<br>
+See <a href="Declarations.html#Declarations">Declarations</a>.
+
+ <br><dt>‘<samp><span
class="samp">-ts</span><var>n</var></samp>’<dt>‘<samp><span
class="samp">--tab-size</span><var>n</var></samp>’<dd>Set tab size to
<var>n</var> spaces.<br>
+See <a href="Indentation.html#Indentation">Indentation</a>.
+
+ <br><dt>‘<samp><span
class="samp">-ut</span></samp>’<dt>‘<samp><span
class="samp">--use-tabs</span></samp>’<dd>Use tabs. This is the
default.<br>
+See <a href="Indentation.html#Indentation">Indentation</a>.
+
+ <br><dt>‘<samp><span
class="samp">-v</span></samp>’<dt>‘<samp><span
class="samp">--verbose</span></samp>’<dd>Enable verbose mode.<br>
+See <a href="Miscellaneous-options.html#Miscellaneous-options">Miscellaneous
options</a>.
+
+ <br><dt>‘<samp><span
class="samp">-version</span></samp>’<dd>Output the version number of
<samp><span class="command">indent</span></samp>.<br>
+See <a href="Miscellaneous-options.html#Miscellaneous-options">Miscellaneous
options</a>.
+</dl>
+ <!-- !END OPTIONS -->
+
+<!-- !BEGIN CROSSREF -->
+<h4 class="subheading">Options' Cross Key</h4>
+
+<p>Here is a list of options alphabetized by long option, to help you find
+the corresponding short option.
+
+<!-- !END CROSSREF -->
+ </body></html>
+
Index: software/indent/manual/html_node/Statements.html
===================================================================
RCS file: software/indent/manual/html_node/Statements.html
diff -N software/indent/manual/html_node/Statements.html
--- /dev/null 1 Jan 1970 00:00:00 -0000
+++ software/indent/manual/html_node/Statements.html 18 Sep 2008 15:15:10
-0000 1.1
@@ -0,0 +1,183 @@
+<html lang="en">
+<head>
+<title>Statements - `indent': Indent and Format C Program Source</title>
+<meta http-equiv="Content-Type" content="text/html">
+<meta name="description" content="`indent': Indent and Format C Program
Source">
+<meta name="generator" content="makeinfo 4.11">
+<link title="Top" rel="start" href="index.html#Top">
+<link rel="up" href="Indent-Program.html#Indent-Program" title="Indent
Program">
+<link rel="prev" href="Comments.html#Comments" title="Comments">
+<link rel="next" href="Declarations.html#Declarations" title="Declarations">
+<link href="http://www.gnu.org/software/texinfo/" rel="generator-home"
title="Texinfo Homepage">
+<meta http-equiv="Content-Style-Type" content="text/css">
+<style type="text/css"><!--
+ pre.display { font-family:inherit }
+ pre.format { font-family:inherit }
+ pre.smalldisplay { font-family:inherit; font-size:smaller }
+ pre.smallformat { font-family:inherit; font-size:smaller }
+ pre.smallexample { font-size:smaller }
+ pre.smalllisp { font-size:smaller }
+ span.sc { font-variant:small-caps }
+ span.roman { font-family:serif; font-weight:normal; }
+ span.sansserif { font-family:sans-serif; font-weight:normal; }
+--></style>
+</head>
+<body>
+<div class="node">
+<p>
+<a name="Statements"></a>
+Next: <a rel="next" accesskey="n"
href="Declarations.html#Declarations">Declarations</a>,
+Previous: <a rel="previous" accesskey="p"
href="Comments.html#Comments">Comments</a>,
+Up: <a rel="up" accesskey="u"
href="Indent-Program.html#Indent-Program">Indent Program</a>
+<hr>
+</div>
+
+<!-- node-name, next, previous, up -->
+<h3 class="section">1.6 Statements</h3>
+
+<p><a name="index-g_t_002dbr-69"></a><a
name="index-g_t_002d_002dbraces_002don_002dif_002dline-70"></a><a
name="index-g_t_002dbl-71"></a><a
name="index-g_t_002d_002dbraces_002dafter_002dif_002dline-72"></a>The
<samp><span class="option">-br</span></samp> or <samp><span
class="option">-bl</span></samp> option specifies how to format braces.
+
+<!-- another paragraph that needs to be attached to its example. -->
+ <p>The <samp><span class="option">-br</span></samp> option formats
statement braces like this:
+
+<pre class="example"> if (x > 0) {
+ x--;
+ }
+</pre>
+ <p class="noindent">The <samp><span class="option">-bl</span></samp> option
formats them like this:
+
+<pre class="example"> if (x > 0)
+ {
+ x--;
+ }
+</pre>
+ <p><a name="index-g_t_002dbli_0040var_007bn_007d-73"></a><a
name="index-g_t_002d_002dbrace_002dindent_0040var_007bn_007d-74"></a>If you use
the <samp><span class="option">-bl</span></samp> option, you may also want to
specify the
+<samp><span class="option">-bli</span></samp> option. This option specifies
the number of spaces by
+which braces are indented. <samp><span class="option">-bli2</span></samp>,
the default, gives the
+result shown above. <samp><span class="option">-bli0</span></samp> results in
the following:
+
+<pre class="example"> if (x > 0)
+ {
+ x--;
+ }
+</pre>
+ <p><a name="index-g_t_002dce-75"></a><a
name="index-g_t_002d_002dcuddle_002delse-76"></a><a
name="index-g_t_002ddce-77"></a><a
name="index-g_t_002d_002ddont_002dcuddle_002delse-78"></a>If you are using the
<samp><span class="option">-br</span></samp> option, you probably want to also
use
+the <samp><span class="option">-ce</span></samp> option. This causes the
<code>else</code> in an if-then-else
+construct to cuddle up to the immediately preceding ‘<samp><span
class="samp">}</span></samp>’. For
+example, with <samp><span class="option">-br -ce</span></samp> you get the
following:
+
+<pre class="example"> if (x > 0) {
+ x--;
+ } else {
+ fprintf (stderr, "...something wrong?\n");
+ }
+</pre>
+ <p class="noindent">With <samp><span class="option">-br -nce</span></samp>
that code would appear as
+
+<pre class="example"> if (x > 0) {
+ x--;
+ }
+ else {
+ fprintf (stderr, "...something wrong?\n");
+ }
+</pre>
+ <p><a name="index-g_t_002dcdw-79"></a><a
name="index-g_t_002d_002dcuddle_002ddo_002dwhile-80"></a><a
name="index-g_t_002dncdw-81"></a><a
name="index-g_t_002d_002ddont_002dcuddle_002ddo_002dwhile-82"></a>This causes
the <code>while</code> in a do-while
+loop to cuddle up to the immediately preceding ‘<samp><span
class="samp">}</span></samp>’. For
+example, with <samp><span class="option">-cdw</span></samp> you get the
following:
+
+<pre class="example"> do {
+ x--;
+ } while (x);
+</pre>
+ <p class="noindent">With <samp><span class="option">-ncdw</span></samp>
that code would appear as
+
+<pre class="example"> do {
+ x--;
+ }
+ while (x);
+</pre>
+ <p><a name="index-g_t_002dcli_0040var_007bn_007d-83"></a><a
name="index-g_t_002d_002dcase_002dindentation_0040var_007bn_007d-84"></a>The
<samp><span class="option">-cli</span></samp> option specifies the number of
spaces that case labels
+should be indented to the right of the containing <code>switch</code>
+statement.
+
+<p class="noindent">The default gives code like:
+
+<pre class="example"> switch (i)
+ {
+ case 0:
+ break;
+ case 1:
+ {
+ ++i;
+ }
+ default:
+ break;
+ }
+</pre>
+ <p>Using the <samp><span class="option">-cli2</span></samp> that would
become:
+
+<pre class="example"> switch (i)
+ {
+ case 0:
+ break;
+ case 1:
+ {
+ ++i;
+ }
+ default:
+ break;
+ }
+</pre>
+ <p><a name="index-g_t_002dcbi_0040var_007bn_007d-85"></a><a
name="index-g_t_002d_002dcase_002dbrace_002dindentation_0040var_007bn_007d-86"></a>The
indentation of the braces below a case statement can be
+controlled with the <samp><span class="option">-cbi</span><var>n</var></samp>
option. For example,
+using <samp><span class="option">-cli2 -cbi0</span></samp> results in:
+
+<pre class="example"> switch (i)
+ {
+ case 0:
+ break;
+ case 1:
+ {
+ ++i;
+ }
+ default:
+ break;
+ }
+</pre>
+ <p><a name="index-g_t_002dss-87"></a><a
name="index-g_t_002d_002dspace_002dspecial_002dsemicolon-88"></a><a
name="index-g_t_002dnss-89"></a><a
name="index-g_t_002d_002ddont_002dspace_002dspecial_002dsemicolon-90"></a>If a
semicolon is on the same line as a <code>for</code> or <code>while</code>
+statement, the <samp><span class="option">-ss</span></samp> option will cause
a space to be placed before
+the semicolon. This emphasizes the semicolon, making it clear that the
+body of the <code>for</code> or <code>while</code> statement is an empty
statement.
+<samp><span class="option">-nss</span></samp> disables this feature.
+
+ <p><a name="index-g_t_002dpcs-91"></a><a
name="index-g_t_002d_002dspace_002dafter_002dprocedure_002dcalls-92"></a><a
name="index-g_t_002dnpcs-93"></a><a
name="index-g_t_002d_002dno_002dspace_002dafter_002dfunction_002dcall_002dnames-94"></a>The
<samp><span class="option">-pcs</span></samp> option causes a space to be
placed between the name of
+the procedure being called and the ‘<samp><span
class="samp">(</span></samp>’ (for example,
<code>puts ("Hi");</code><!-- /@w -->. The <samp><span
class="option">-npcs</span></samp> option would give <code>puts("Hi");</code>).
+
+ <p><a name="index-g_t_002dcs-95"></a><a
name="index-g_t_002d_002dspace_002dafter_002dcast-96"></a><a
name="index-g_t_002dncs-97"></a><a
name="index-g_t_002d_002dno_002dspace_002dafter_002dcasts-98"></a>If the
<samp><span class="option">-cs</span></samp> option is specified, <samp><span
class="command">indent</span></samp> puts a space after
+a cast operator.
+
+ <p><a name="index-g_t_002dbs-99"></a><a
name="index-g_t_002d_002dblank_002dafter_002dsizeof-100"></a>The <samp><span
class="option">-bs</span></samp> option ensures that there is a space between
the
+keyword <code>sizeof</code> and its argument. In some versions, this is
+known as the ‘<samp><span class="samp">Bill_Shannon</span></samp>’
option.
+
+ <p><a name="index-g_t_002dsaf-101"></a><a
name="index-g_t_002d_002dspace_002dafter_002dfor-102"></a><a
name="index-g_t_002dnsaf-103"></a><a
name="index-g_t_002d_002dno_002dspace_002dafter_002dfor-104"></a>The
<samp><span class="option">-saf</span></samp> option forces a space between an
<code>for</code>
+and the following parenthesis. This is the default.
+
+ <p><a name="index-g_t_002dsai-105"></a><a
name="index-g_t_002d_002dspace_002dafter_002dif-106"></a><a
name="index-g_t_002dnsai-107"></a><a
name="index-g_t_002d_002dno_002dspace_002dafter_002dif-108"></a>The <samp><span
class="option">-sai</span></samp> option forces a space between an
<code>if</code>
+and the following parenthesis. This is the default.
+
+ <p><a name="index-g_t_002dsaw-109"></a><a
name="index-g_t_002d_002dspace_002dafter_002dwhile-110"></a><a
name="index-g_t_002dnsaw-111"></a><a
name="index-g_t_002d_002dno_002dspace_002dafter_002dwhile-112"></a>The
<samp><span class="option">-saw</span></samp> option forces a space between an
<code>while</code>
+and the following parenthesis. This is the default.
+
+ <p><a name="index-g_t_002dprs-113"></a><a
name="index-g_t_002d_002dspace_002dafter_002dparentheses-114"></a>The
<samp><span class="option">-prs</span></samp> option causes all parentheses to
be seperated with
+a space from the what is between them. For example, using <samp><span
class="option">-prs</span></samp>
+results in code like:
+
+<pre class="example"> while ( ( e_code - s_code ) < ( dec_ind - 1 ) )
+ {
+ set_buf_break ( bb_dec_ind );
+ *e_code++ = ' ';
+ }
+</pre>
+ </body></html>
+
Index: software/indent/manual/html_node/_002dbad.html
===================================================================
RCS file: software/indent/manual/html_node/_002dbad.html
diff -N software/indent/manual/html_node/_002dbad.html
--- /dev/null 1 Jan 1970 00:00:00 -0000
+++ software/indent/manual/html_node/_002dbad.html 18 Sep 2008 15:15:11
-0000 1.1
@@ -0,0 +1,63 @@
+<html lang="en">
+<head>
+<title>-bad - `indent': Indent and Format C Program Source</title>
+<meta http-equiv="Content-Type" content="text/html">
+<meta name="description" content="`indent': Indent and Format C Program
Source">
+<meta name="generator" content="makeinfo 4.11">
+<link title="Top" rel="start" href="index.html#Top">
+<link rel="up" href="Blank-lines.html#Blank-lines" title="Blank lines">
+<link rel="next" href="_002dbap.html#g_t_002dbap" title="-bap">
+<link href="http://www.gnu.org/software/texinfo/" rel="generator-home"
title="Texinfo Homepage">
+<meta http-equiv="Content-Style-Type" content="text/css">
+<style type="text/css"><!--
+ pre.display { font-family:inherit }
+ pre.format { font-family:inherit }
+ pre.smalldisplay { font-family:inherit; font-size:smaller }
+ pre.smallformat { font-family:inherit; font-size:smaller }
+ pre.smallexample { font-size:smaller }
+ pre.smalllisp { font-size:smaller }
+ span.sc { font-variant:small-caps }
+ span.roman { font-family:serif; font-weight:normal; }
+ span.sansserif { font-family:sans-serif; font-weight:normal; }
+--></style>
+</head>
+<body>
+<div class="node">
+<p>
+<a name="-bad"></a>
+<a name="g_t_002dbad"></a>
+Next: <a rel="next" accesskey="n"
href="_002dbap.html#g_t_002dbap">-bap</a>,
+Up: <a rel="up" accesskey="u" href="Blank-lines.html#Blank-lines">Blank
lines</a>
+<hr>
+</div>
+
+<!-- node-name, next, previous, up -->
+<h4 class="subsection">1.4.1 –blank-lines-after-declarations</h4>
+
+<p>The <samp><span class="option">-bad</span></samp> option forces a blank
line after every block of
+declarations. The <samp><span class="option">-nbad</span></samp> option does
not add any such blank
+lines.
+
+ <p>For example, given the input
+<pre class="example"> char *foo;
+ char *bar;
+ /* This separates blocks of declarations. */
+ int baz;
+</pre>
+ <p><a name="index-g_t_002dbad-36"></a><a
name="index-g_t_002d_002dblank_002dlines_002dafter_002ddeclarations-37"></a><a
name="index-g_t_002dnbad-38"></a><a
name="index-g_t_002d_002dno_002dblank_002dlines_002dafter_002ddeclarations-39"></a><code>indent
-bad</code> produces
+
+<pre class="example"> char *foo;
+ char *bar;
+
+ /* This separates blocks of declarations. */
+ int baz;
+</pre>
+ <p class="noindent">and <code>indent -nbad</code> produces
+
+<pre class="example"> char *foo;
+ char *bar;
+ /* This separates blocks of declarations. */
+ int baz;
+</pre>
+ </body></html>
+
Index: software/indent/manual/html_node/_002dbap.html
===================================================================
RCS file: software/indent/manual/html_node/_002dbap.html
diff -N software/indent/manual/html_node/_002dbap.html
--- /dev/null 1 Jan 1970 00:00:00 -0000
+++ software/indent/manual/html_node/_002dbap.html 18 Sep 2008 15:15:11
-0000 1.1
@@ -0,0 +1,86 @@
+<html lang="en">
+<head>
+<title>-bap - `indent': Indent and Format C Program Source</title>
+<meta http-equiv="Content-Type" content="text/html">
+<meta name="description" content="`indent': Indent and Format C Program
Source">
+<meta name="generator" content="makeinfo 4.11">
+<link title="Top" rel="start" href="index.html#Top">
+<link rel="up" href="Blank-lines.html#Blank-lines" title="Blank lines">
+<link rel="prev" href="_002dbad.html#g_t_002dbad" title="-bad">
+<link href="http://www.gnu.org/software/texinfo/" rel="generator-home"
title="Texinfo Homepage">
+<meta http-equiv="Content-Style-Type" content="text/css">
+<style type="text/css"><!--
+ pre.display { font-family:inherit }
+ pre.format { font-family:inherit }
+ pre.smalldisplay { font-family:inherit; font-size:smaller }
+ pre.smallformat { font-family:inherit; font-size:smaller }
+ pre.smallexample { font-size:smaller }
+ pre.smalllisp { font-size:smaller }
+ span.sc { font-variant:small-caps }
+ span.roman { font-family:serif; font-weight:normal; }
+ span.sansserif { font-family:sans-serif; font-weight:normal; }
+--></style>
+</head>
+<body>
+<div class="node">
+<p>
+<a name="-bap"></a>
+<a name="g_t_002dbap"></a>
+Previous: <a rel="previous" accesskey="p"
href="_002dbad.html#g_t_002dbad">-bad</a>,
+Up: <a rel="up" accesskey="u" href="Blank-lines.html#Blank-lines">Blank
lines</a>
+<hr>
+</div>
+
+<!-- node-name, next, previous, up -->
+<h4 class="subsection">1.4.2 –blank-lines-after-procedures</h4>
+
+<p><a name="index-g_t_002dbap-40"></a><a
name="index-g_t_002d_002dblank_002dlines_002dafter_002dprocedures-41"></a><a
name="index-g_t_002dnbap-42"></a><a
name="index-g_t_002d_002dno_002dblank_002dlines_002dafter_002dprocedures-43"></a>The
<samp><span class="option">-bap</span></samp> option forces a blank line after
every procedure body.
+
+ <p>For example, given the input
+
+<pre class="example"> int
+ foo ()
+ {
+ puts("Hi");
+ }
+ /* The procedure bar is even less interesting. */
+ char *
+ bar ()
+ {
+ puts("Hello");
+ }
+</pre>
+ <p class="noindent"><code>indent -bap</code> produces
+
+<pre class="example"> int
+ foo ()
+ {
+ puts ("Hi");
+ }
+
+ /* The procedure bar is even less interesting. */
+ char *
+ bar ()
+ {
+ puts ("Hello");
+ }
+</pre>
+ <p class="noindent"><!-- A better `group' would be better than `need'. -->
+and <code>indent -nbap</code> produces
+
+<pre class="example"> int
+ foo ()
+ {
+ puts ("Hi");
+ }
+ /* The procedure bar is even less interesting. */
+ char *
+ bar ()
+ {
+ puts ("Hello");
+ }
+</pre>
+ <p class="noindent">No blank line will be added after the procedure
<code>foo</code>.
+
+ </body></html>
+
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- www manual/manual.html software/indent/indent.h...,
D E Evans <=