Linux代码风格整理

scaoping

Linux代码风格整理
　　在Linux内核源代码中有一个脚本用于整理代码的格式（风格），该脚本的内容如下：
　　

#!/bin/sh　　
PARAM="-npro -kr -i8 -ts8 -sob -l80 -ss -ncs -cp1"
　　
RES=`indent --version`
　　
V1=`echo $RES | cut -d' ' -f3 | cut -d'.' -f1`
　　
V2=`echo $RES | cut -d' ' -f3 | cut -d'.' -f2`
　　
V3=`echo $RES | cut -d' ' -f3 | cut -d'.' -f3`
　　
if [ $V1 -gt 2 ]; then
　　PARAM="$PARAM -il0"
　　
elif [ $V1 -eq 2 ]; then
　　if [ $V2 -gt 2 ]; then
　　PARAM="$PARAM -il0";
　　elif [ $V2 -eq 2 ]; then
　　if [ $V3 -ge 10 ]; then
　　PARAM="$PARAM -il0"
　　fi
　　fi
　　
fi
　　
indent $PARAM "$@"
　　

　　作者所安装操作系统的脚本位置如下：
　　/usr/src/kernels/linux-3.10.9/scripts/Lindent
　　通过执行如下命令可以将所有源文件安装内核格式要求进行代码整理。
　　/usr/src/kernels/linux-3.10.9/scripts/Lindent *.c
　　实际上该脚本调用了一个系统命令，也即indent，该命令实现代码整理的具体工作。通常情况下，该命令的设置如下：
　　indent -npro -kr -i8 -ts8 -sob -l80 -ss -bl -bli 0
　　该命令的参数说明：
　　-npro或--ignore-profile 　不要读取indent的配置文件.indent.pro。
　　-kr 　指定使用Kernighan&Ritchie的格式。
　　-i8 　--indent-level 设置缩排的格数为8。
　　-ts8 设置tab的长度
　　-sob或--swallow-optional-blank-lines 　删除多余的空白行。
　　-l80 代码超过80换行
　　-ss或--space-special-semicolon 　若for区段只有一行时，在分号前加上空格。
　　-ncs或--no-space-after-casts 　不要在cast之后空一格。
　　-bl {分行显示
　　-bli 0 括号缩进为0
　　功能说明：调整C原始代码文件的格式。
　　语　　法：indent [参数][源文件] 或 indent [参数][源文件][-o 目标文件]
　　补充说明：indent可辨识C的原始代码文件，并加以格式化，以方便程序设计师阅读。
　　参　　数：
　　-bad或--blank-lines-after-declarations 　在声明区段或加上空白行。
　　-bap或--blank-lines-after-procedures 　在程序或加上空白行。
　　-bbb或--blank-lines-after-block-comments 　在注释区段后加上空白行。
　　-bc或--blank-lines-after-commas 　在声明区段中，若出现逗号即换行。
　　-bl或--braces-after-if-line 　if(或是else,for等等)与后面执行区段的"{"不同行，且"}"自成一行。
　　-bli或--brace-indent 　设置{ }缩排的格数。
　　-br或--braces-on-if-line 　if(或是else,for等等)与后面执行跛段的"{"不同行，且"}"自成一行。
　　-bs或--blank-before-sizeof 　在sizeof之后空一格。
　　-c或--comment-indentation 　将注释置于程序码右侧指定的栏位。
　　-cd或--declaration-comment-column 　将注释置于声明右侧指定的栏位。
　　-cdb或--comment-delimiters-on-blank-lines 　注释符号自成一行。
　　-ce或--cuddle-else 　将else置于"}"(if执行区段的结尾)之后。
　　-ci或--continuation-indentation 　叙述过长而换行时，指定换行后缩排的格数。
　　-cli或--case-indentation- 　使用case时，switch缩排的格数。
　　-cp或-else-endif-column 　将注释置于else与elseif叙述右侧定的栏位。
　　-cs或--space-after-cast 　在cast之后空一格。
　　-d或-line-comments-indentation 　针对不是放在程序码右侧的注释，设置其缩排格数。
　　-di或--declaration-indentation 　将声明区段的变量置于指定的栏位。
　　-fc1或--format-first-column-comments 　针对放在每行最前端的注释，设置其格式。
　　-fca或--format-all-comments 　设置所有注释的格式。
　　-gnu或--gnu-style. 　指定使用GNU的格式，此为预设值。
　　-i或--indent-level 　设置缩排的格数。
　　-ip或--parameter-indentation 　设置参数的缩排格数。
　　-kr或--k-and-r-style. 　指定使用Kernighan&Ritchie的格式。
　　-lp或--continue-at-parentheses 　叙述过长而换行，且叙述中包含了括弧时，将括弧中的每行起始栏位内容垂直对其排列。
　　-nbad或--no-blank-lines-after-declarations 　在声明区段后不要加上空白行。
　　-nbap或--no-blank-lines-after-procedures 　在程序后不要加上空白行。
　　-nbbb或--no-blank-lines-after-block-comments 　在注释区段后不要加上空白行。
　　-nbc或--no-blank-lines-after-commas 　在声明区段中，即使出现逗号，仍旧不要换行。
　　-ncdb或--no-comment-delimiters-on-blank-lines 　注释符号不要自成一行。
　　-nce或--dont-cuddle-else 　不要将else置于"}"之后。
　　-ncs或--no-space-after-casts 　不要在cast之后空一格。
　　-nfc1或--dont-format-first-column-comments 　不要格式化放在每行最前端的注释。
　　-nfca或--dont-format-comments 　不要格式化任何的注释。
　　-nip或--no-parameter-indentation 　参数不要缩排。
　　-nlp或--dont-line-up-parentheses 　叙述过长而换行，且叙述中包含了括弧时，不用将括弧中的每行起始栏位垂直对其排列。
　　-npcs或--no-space-after-function-call-names 　在调用的函数名称之后，不要加上空格。
　　-npro或--ignore-profile 　不要读取indent的配置文件.indent.pro。
　　-npsl或--dont-break-procedure-type 　程序类型与程序名称放在同一行。
　　-nsc或--dont-star-comments 　注解左侧不要加上星号()。
　　-nsob或--leave-optional-semicolon 　不用处理多余的空白行。
　　-nss或--dont-space-special-semicolon 　若for或while区段仅有一行时，在分号前不加上空格。
　　-nv或--no-verbosity 　不显示详细的信息。
　　-orig或--original 　使用Berkeley的格式。
　　-pcs或--space-after-procedure-calls 　在调用的函数名称与"{"之间加上空格。
　　-psl或--procnames-start-lines 　程序类型置于程序名称的前一行。
　　-sc或--start-left-side-of-comments 　在每行注释左侧加上星号()。
　　-sob或--swallow-optional-blank-lines 　删除多余的空白行。
　　-ss或--space-special-semicolon 　若for或swile区段今有一行时，在分号前加上空格。
　　-st或--standard-output 　将结果显示在标准输出设备。
　　-T 　数据类型名称缩排。
　　-ts或--tab-size 　设置tab的长度。
　　-v或--verbose 　执行时显示详细的信息。
　　-version 　显示版本信息。