对于一个好的bash/ksh脚本模板,你有什么建议可以用作所有新创建的脚本的标准？
我通常#!使用带有文件名,概要,用法,返回值,作者,更改日志的注释掉头开始(在行之后)并且适合80-char行.
所有文档行我都以双哈希符号开头,##因此我可以轻松地为它们grep,本地var名称前面加上"__".
还有其他最佳做法吗？提示？命名约定？返回代码怎么样？
关于版本控制的评论:我们使用SVN可以,但企业中的另一个部门有一个单独的repo,这是他们的脚本.如果没有@author信息,我如何知道与Q联系的人？使用类似于javadocs的条目即使在shell上下文中也有一些优点,恕我直言,但我可能错了.