Astyle编程语言格式化工具的中文说明

Artistic Style 1.23
Maintained by: Jim Pattee
Original Author: Tal Davidson

Usage  :  astyle [options] Source1.cpp Source2.cpp  [...]
          astyle [options] < Original > Beautified

When indenting a specific file, the resulting indented file RETAINS the
original file-name. The original pre-indented file is renamed, with a
suffix of ".orig" added to the original filename.

Wildcards (* and ?) may be used in the filename.
A 'recursive' option can process directories recursively.
可以用通配符指定要处理的文件,用-r递归处理子目录

By default, astyle is set up to indent C/C++/C#/Java files, with 4 spaces
per indent, a maximal indentation of 40 spaces inside continuous statements,
and NO formatting.

Option's Format:
----------------
    Long options (starting with '--') must be written one at a time.
    Short options (starting with '-') may be appended together.
    Thus, -bps4 is the same as -b -p -s4.

风格:
-------------------------
    --style=allman  OR  --style=bsd  OR  -A1
    allman风格
    Allman style formatting/indenting.
    Broken brackets.

--style=java  OR  -A2
    java风格
    Java style formatting/indenting.
    Attached brackets.

--style=k&r  OR  --style=k/r  OR  -A3
    k&r风格
    Kernighan & Ritchie style formatting/indenting.
    Linux brackets.

--style=stroustrup  OR  -A4
    stroustrup风格
    Stroustrup style formatting/indenting.
    Stroustrup brackets.

--style=whitesmith  OR  -A5
    whitesmith风格
    Whitesmith style formatting/indenting.
    Broken, indented brackets.
    Indented class blocks and switch blocks.

--style=banner  OR  -A6
    banner风格
    Banner style formatting/indenting.
    Attached, indented brackets.
    Indented class blocks and switch blocks.

--style=gnu  OR  -A7
    gnu风格
    GNU style formatting/indenting.
    Broken brackets, indented blocks, indent is 2 spaces.

--style=linux  OR  -A8
    linux风格
    GNU style formatting/indenting.
    Linux brackets, indent is 8 spaces.

Tab and Bracket Options:
------------------------
tab选项:
    默认tab是4个空格.

--indent=spaces=#  OR  -s#
    默认行缩进为4个空格,可以将#替换为缩进量

--indent=tab  OR  --indent=tab=#  OR  -t  OR  -t#
    行缩进用tab,默认tab长度与4个空格相等

--indent=force-tab=#  OR  -T#
    优先采用空格缩进

大括号选项:
    If no brackets option is set,
    the brackets will not be changed.

--brackets=break  OR  -b
    大括号与前一块隔开为两行
    Break brackets from pre-block code (i.e. ANSI C/C++ style).

--brackets=attach  OR  -a
    大括号前一个与上一行在同一行
    Attach brackets to pre-block code (i.e. Java/K&R style).

--brackets=linux  OR  -l
    定义块 和 函数块中的大括号都被处理
    Break definition-block brackets and attach command-block
    brackets.

--brackets=stroustrup  OR  -u
    只处理函数中的大括号
    Attach all brackets except function definition brackets.

Indentation options:
--------------------
    --indent-classes  OR  -C
    缩进类定义中的public private protected标签.
    Indent 'class' blocks, so that the inner 'public:',
    'protected:' and 'private: headers are indented in
    relation to the class block.

--indent-switches  OR  -S
    缩进switch中的case块,case和switch不在同一列
    Indent 'switch' blocks, so that the inner 'case XXX:'
    headers are indented in relation to the switch block.

--indent-cases  OR  -K
    缩进case下面的语句
    Indent case blocks from the 'case XXX:' headers.
    Case statements not enclosed in blocks are NOT indented.

--indent-blocks  OR  -G
    给块添加缩进,包括大括号
    Add extra indentation entire blocks (including brackets).

--indent-brackets  OR  -B
    给大括号添加缩进
    Add extra indentation to '{' and '}' block brackets.

--indent-namespaces  OR  -N
    缩进命名空间定义行
    Indent the contents of namespace blocks.

--indent-labels  OR  -L
    标签缩进
    Indent labels so that they appear one indent less than
    the current indentation level, rather than being
    flushed completely to the left (which is the default).

--indent-preprocessor  OR  -w
    多行宏定义缩进
    Indent multi-line #define statements.

--max-instatement-indent=#  OR  -M#
    跨行缩进,比如函数定义中的参数处在多行,那么参数缩进到同一列
    Indent a maximal # spaces in a continuous statement,
    relative to the previous line.

--min-conditional-indent=#  OR  -m#
    Indent a minimal # spaces in a continuous conditional
    belonging to a conditional header.

Formatting options:
-------------------
    --break-blocks  OR  -f
    空行分隔没有关系的块,类,标签(不包括函数块)
    Insert empty lines around unrelated blocks, labels, classes, ...

--break-blocks=all  OR  -F
    空行分隔无关系的块,包括else catch等
    Like --break-blocks, except also insert empty lines
    around closing headers (e.g. 'else', 'catch', ...).

--break-closing-brackets  OR  -y
    else catch左边的大括号与else catch分隔
    Break brackets before closing headers (e.g. 'else', 'catch', ...).
    Use with --brackets=attach, --brackets=linux,
    or --brackets=stroustrup.

--break-elseifs  OR  -e
    else if()分隔为两行
    Break 'else if()' statements into two different lines.

--delete-empty-lines  OR  -x
    删除多余空行
    Delete empty lines within a function or method.
    It will NOT delete lines added by the break-blocks options.

--pad-oper  OR  -p
    操作符两端插入一个空格
    Insert space paddings around operators.

--pad-paren  OR  -P
    括号内外都插入空格
    Insert space padding around parenthesis on both the outside
    and the inside.

--pad-paren-out  OR  -d
    括号外部插入空格
    Insert space padding around parenthesis on the outside only.

--pad-paren-in  OR  -D
    括号外部插入空格
    Insert space padding around parenthesis on the inside only.

--unpad-paren  OR  -U
    移除括号两端多余空格
    Remove unnecessary space padding around parenthesis.  This
    can be used in combination with the 'pad' options above.

--keep-one-line-statements  OR  -o
    一行中的多个申明不分隔  int x;int y;int z不被分为3行
    Don't break lines containing multiple statements into
    multiple single-statement lines.

--keep-one-line-blocks  OR  -O
    大括号中的单行语句不被拆分
    Don't break blocks residing completely on one line.

--convert-tabs  OR  -c
    tab转换为空格
    Convert tabs to the appropriate number of spaces.

--fill-empty-lines  OR  -E
    块间空行的换行符前插入一个空格
    Fill empty lines with the white space of their
    previous lines.

--mode=c
    处理c文件
    Indent a C or C++ source file (this is the default).

--mode=java
    处理jave文件
    Indent a Java source file.

--mode=cs
    处理c#文件
    Indent a C# source file.

Other options:
--------------
    --suffix=####
    指定备份文件的后缀
    Append the suffix #### instead of '.orig' to original filename.

--suffix=none  OR  -n
    不备份文件
    Do not retain a backup of the original file.

--options=####
    指定从####文件读取选项信息
    Specify an options file #### to read and use.

--options=none
    禁止从文件读取选项信息
    Disable the default options file.
    Only the command-line parameters will be used.

--recursive  OR  -r  OR  -R
    递归处理子目录
    Process subdirectories recursively.

--exclude=####
    排除不处理的文件夹
    Specify a file or directory #### to be excluded from processing.

--errors-to-stdout  OR  -X
    Print errors and help information to standard-output rather than
    to standard-error.

--preserve-date  OR  -Z
    不修改时间
    The date and time modified will not be changed in the formatted file.

--verbose  OR  -v
    输出详细处理信息
    Verbose mode. Extra informational messages will be displayed.

--formatted  OR  -Q
    输出信息中只包括被修改的文件信息
    Formatted display mode. Display only the files that have been formatted.

--quiet  OR  -q
    忽略所有错误
    Quiet mode. Suppress all output except error messages.

--version  OR  -V
    输出astyle版本
    Print version number.

--help  OR  -h  OR  -?
    帮助信息
    Print this help message.

Default options file:
---------------------
    Artistic Style looks for a default options file in the
    following order:
    1. The contents of the ARTISTIC_STYLE_OPTIONS environment
       variable if it exists.
       从ARTISTIC_STYLE_OPTIONS环境变量读取选项
    2. The file called .astylerc in the directory pointed to by the
       HOME environment variable ( i.e. $HOME/.astylerc ).
       从/home文件夹中的.astylerc文件读取选项
    3. The file called astylerc in the directory pointed to by the
       USERPROFILE environment variable ( i.e. %USERPROFILE%\astylerc ).
       从USERPROFILE下的astylerc文件读取选项信息
    If a default options file is found, the options in this file
    will be parsed BEFORE the command-line options.
    Long options within the default option file may be written without
    the preliminary '--'.

--options的用法:

我的在source insight中的设置为   AStyle.exe --options=D:\TOOLS\AStyle\astyle.cfg  %f

astyle.cfg内容为:

-s4 -SKFxpUcnlaC
#井号表示是注释
#-s4 行缩进用4个空格
#-S  switch 与case不同列,case缩进
#-K  缩进case下面的语句
#-F  空行分隔无关块
#-x  删除多余空行
#-p  操作符两端出入空格
#-U  移除括号两端多余空格
#-c  tab转空格
#-n  不做备份
#-l  处理定义和函数中的大括号
#-a  大括号保留在上一行