评论：行业软件开发，要靠“抄”？（五）

 
用“手册”规范开发

写任何程序离不开平台和环境，样本程序应该对“通用”开发和运行环境有所描述。对开发程序所使用的“语言平台”归纳成具体的“使用手册”和“参考手册”。

“参考手册”是该语言的语法结构及使用说明，它是以“面向对象”为主的方式表达的。“使用手册”是如何使用该语言的说明，它是以“面向过程”为主的方式表达的。从学习的技巧角度来看，我们一般是先看“使用手册”，发现细节不清楚时，再查看“参考手册”。在做样本程序的时候，为了使关键的文档量下降，往往直接说明引用的参考文献和网站，这样相当于我们用引文的方式介绍了“参考手册”，以此减少我们的文档量。

样本程序实质上是以“参考手册”为基础，把单纯面向编程语言的“使用手册”中所举的“范例”，变成我们开发组结合具体应用背景的范例，即样本。由于我们使用的编程语言考虑更多的是“通用”特征，所以我们应该针对我们的具体情况编出一些新的样本程序的“语句”，即基本组件。在一些局部条件已知或缺省的条件下，也可能使用一定的生成代码工具，去生成组件或组装脚本。对这些整体环境的讨论我们又可以结合一个IDE(集成开发环境工具)工具进行，在样本程序的介绍中，我们应该可以感到Eclipse、Jbuilder之类工具的使用并说明引用它们的具体版本及文档出处。总之，在做样本程序时我们应当看到对IDE工具、开发语言、基础通用函数等方面的介绍，从而使大家感到这样的样本程序是可以实际运行的。