indent进行格式化.docx

用 indent 进行代码格式化1. introduce indent2. Indent参数规范一个范例，胜过前言万语。用 indent 格式化代码，再从格式化前后的格式变化，来学习格式化规范。可以用不同的参数调用 indent，1.introduce indent1. What is IndentThe indent program can be used to make code easier to read. It can also convert from one style of writing C to another.2. DownloadCurrent Version: GNU indent 2.2.7。 Download :/gnu/indent/indent-2.2.7.tar.gz2.Indent参数规范我们参照GNU，Kernighan & Ritchie，Berkeley风格，制定了自己风格：1. indent命令参数：-bad -bap -bbb -bbo -nbc -bl -bli0 -bls -c33 -cd33 -ncdb -ncdw -nce -cli0 -cp33 -cs -d0 -nbfda -di2 -nfc1 -nfca -hnl -ip5 -l75 -lp -pcs -nprs -psl -saf -sai -saw -nsc -nsob -nss -i4 -ts4 -ut2. indent配置文件如上参数可写入用户目录下的文件：.，作为运行indent的确省参数。3. indent配置说明表1.Indent代码格式化说明使用的indent参数值含义-blank-lines-after-declarationsbad变量声明后加空行-blank-lines-after-proceduresbap函数结束后加空行-blank-lines-before-block-commentsbbb块注释前加空行-break-before-boolean-operatorbbo较长的行，在逻辑运算符前分行-blank-lines-after-commasnbc变量声明中，逗号分隔的变量不分行-braces-after-if-lineblif和分做两行-brace-indent 0bli0不继续缩进-braces-after-struct-decl-linebls定义结构，struct和分行-comment-indentationnc33语句后注释开始于行33-declaration-comment-columnncd33变量声明后注释开始于行33-comment-delimiters-on-blank-linesncdb不将单行注释变为块注释-cuddle-do-whilencdwdo - while的while和其前面的另起一行-cuddle-elsenceelse和其前面的另起一行-case-indentation 0cli0switch中的case语句所进0个空格-else-endif-columnncp33#else, #endif后面的注释开始于行33-space-after-castcs在类型转换后面加空格-line-comments-indentation nd0单行注释（不从1列开始的），不向左缩进-break-function-decl-argsnbfda关闭：函数的参数一个一行-declaration-indentationndi2变量声明，变量开始于2行，即不必对齐-format-first-column-commentsnfc1不格式化起于第一行的注释-format-all-commentsnfca不开启全部格式化注释的开关-honour-newlineshnlPrefer to break long lines at the position of newlines in the input.-indent-levelni4设置缩进多少字符，如果为tab的整数倍，用tab来缩进，否则用空格填充。-parameter-indentationnip5旧风格的函数定义中参数说明缩进5个空格-line-length 75l75非注释行最长75-continue-at-parentheseslp续行从上一行出现的括号开始-space-after-procedure-callspcs函数和(之间插入一个空格-space-after-parenthesesnprs在（后）前不插入空格-procnames-start-linespsl将函数名和返回类型放在两行定义-space-after-forsaffor后面有空格-space-after-ifsaiif后面有空格-space-after-whilesawwhile后面有空格-start-left-side-of-commentsnsc不在生成的块注释中加*-swallow-optional-blank-linesnsob不去掉可添加的空行-space-special-semicolonnss一行的for或while语句，在;前不加空。-tab-sizets4一个tab为4个空格（要能整除-in）-use-tabsut使用tab来缩进indent详细参数以及各种编程排版风格见:A.不同编程风格参考通过indent参数分析，比较自定义风格和GNU，KR，BSD编程风格。表A.1.自定义风格和GNU，KR，BSD风格比较参数含义我们的风格GNU风格KR风格BSD风格-bad-blank-lines-after-declarationsynnn-bap-blank-lines-after-proceduresyyyn-bbb-blank-lines-before-block-commentsy-bbo-break-before-boolean-operatoryyyy-bc-blank-lines-after-commasnnny-bl-braces-after-if-lineyy-blin-brace-indent n02-bls-braces-after-struct-decl-lineyy-br-braces-on-if-lineyy-brs-braces-on-struct-decl-lineyy-bs-blank-before-sizeof-cn-comment-indentationn333333-cbin-case-brace-indentationn-cdn-declaration-comment-columnn333333-cdb-comment-delimiters-on-blank-linesnnny-cdw-cuddle-do-while-ce-cuddle-elsennny-cin-continuation-indentationn44-clin-case-indentationn000-cpn-else-endif-columnn3313333-cs-space-after-castyyy-dn-line-comments-indentationn00-ndjindents declarations the same as codey-bfda-break-function-decl-argsn-din-declaration-indentationn22116-fc1-format-first-column-commentsnnny-fca-format-all-commentsnnny-gnu-gnu-style-hnl-honour-newlinesyyyy-in-indent-leveln4244-ipn-parameter-indentationn5504-kr-k-and-r-style-ln-line-lengthn757575-cs-space-after-cast-dn-line-comments-indentationn-bfda-break-function-decl-args-din-declaration-indentationn-fc1-format-first-column-comments-fca-format-all-comments-gnu-gnu-style-hnl-honour-newlines-in-indent-leveln-ipn-parameter-indentationn-kr-k-and-r-style-ln-line-lengthn-lcn-comment-line-lengthn-lp-continue-at-parenthesesyyy-lps-leave-preprocessor-space-orig-original-npro-ignore-profile-pcs-space-after-procedure-callsyynn-pin-paren-indentationn-pmt-preserve-mtime-prs-space-after-parenthesesnnnn-psl-procnames-start-linesyyny-saf-space-after-foryyyy-sai-space-after-ifyyyy-saw-space-after-whileyyyy-sbin-struct-brace-indentationn-sc-start-left-side-of-commentsnnny-sob-s