源代码格式化使用 4 列制表间隔,并且保留制表符(即制表符不会被扩展成空格)。每一个逻辑缩进层就是一个额外的制表位。
布局规则(大括号位置等)遵循BSD约定。特别是,if
、
while
、switch
等控制块的大括号放在自己的行上。
限制行长度,这样在 80 列窗口中代码也是可读的(这并不意味着你不能超过 80 列。例如,为了保持代码在 80 列以内而在任意位置打断一段长的错误消息字符串可能不会给可读性带来什么好处)。
要保持一致的编码风格,请勿使用C++风格注释(//
comments)。pgindent 会用 /* ... */
替换它们。
多行注释块更好的风格是
/* * 注释文本从这里开始 * 延续到这里 */
注意从列 1 开始的注释块将被pgindent原样保留,但是它将重新对缩进的注释块断行,好像它们是纯文本一样。如果你想要保留一个缩进块中的换行,可以像这样增加破折号:
/*---------- * 注释文本从这里开始 * 延续到这里 *---------- */
虽然在提交补丁时并不是一定要遵守这些格式化规则,但是最好能遵守。在下一次发行前你提交的代码将会通过pgindent,因此使用某种其他格式化习惯无法使代码被编排得很好。对于补丁,一种比较好的经验规则是“让新代码看起来像它周围的原有代码”。
src/tools/editors
目录包含可用于Emacs、
xemacs或vim编辑器的示例设置文件,
以确保它们根据这些约定格式化代码。
如果您想在本地运行pgindent来帮助使您的代码符合项目风格,
请参阅src/tools/pgindent
目录。
可以这样调用文本浏览工具more和less:
more -x4 less -x4
来让它们以合适的方式显示制表符。