荔园在线

荔园之美,在春之萌芽,在夏之绽放,在秋之收获,在冬之沉淀

[回到开始] [上一篇][下一篇]


发信人: joyfire.bbs@bbs.sjtu.edu.cn (小地雷), 信区: Linux
标  题: 自由项目实施-4
发信站: 饮水思源 (Mon Jan 20 14:11:38 2003)
转信站: SZU!news.tiaozhan.com!news.neu.edu.cn!SJTU

make和tar

    程序某个阶段完成了,就需要发布。这时候就需要一些工具,例如tar、automake、
rpm等等

1. tar和rpm

    使用方法我不多说,需要注意一些细节,例如最好在压缩包文件名上带着版本号,确
保tar包解压时会创建一个独立的新目录。rpm是越来越常用的方式,尤其是那些对源代码
不关心的用户,最好能够花点时间,制作rpm版本。

2. automake

    如果用C写程序,要用autoconf/automake/autoheader工具来处理各种移植性的问题,
用这些工具完成系统配置信息的收集,创建makefile文件。客户编译源码时只需要按照标
准的“configure; make; make install”就可以干净利落编译安装。
    至少在每次发布之前要记得用 -Wall 编译选项重新编译一遍并去除编译中遇到的任何
错误。这么做可以帮助您发现不少没有想到的错误。要是想更彻底的检查,那就用
-pedantic 选项再编译一遍。

3. vi
    是的,是VI,你需要用它编写文档,一般随着压缩包一起会发布以下几个文件。它们
具体的内容我想经常使用UNIX或者GNU软件的人不会不知道。也不必非要这么全,但是用户
会在第一次使用的时候寻找这些东西。
    README
    INSTALL
    CREDITS
    NEWS
    HISTORY
    COPYING
    LICENSE
    MANIFEST
    FAQ
    TAGS

4. Texinfo、man、DocBook文档工具

    以上这些文档格式都是linux/unix比较流行的格式,也许还要加上PDF格式。它们的有
关工具和用法在一般的linux系统里都带,也可以去http://www.gnu.org和
http://www.docbook.org下载。Texinfo和DocBook都支持转化为HTML格式,所以也很容易
生成项目网站在线帮助文档。
    总之,项目文档应该和项目代码一起成长,而不应该在发布的前一天才被考虑。好的
程序员必须能写出优秀的文档。安装手册、用户手册和开发手册是吸引用户、打败竞争对
手的最好武器。


[回到开始] [上一篇][下一篇]

荔园在线首页 友情链接:深圳大学 深大招生 荔园晨风BBS S-Term软件 网络书店