binghelingxi 发表于 2008-1-14 19:59:48

使用googlecode提供的wiki写swilib函数说明

http://mobile.0110.cn/images/smilies/default/beg.gif

猛烈的兄台越来越多,http://mobile.0110.cn/images/smilies/default/you.gif,写swilib函数说明的呼声越来越热烈。。。
有人想到了发帖,。。。JPG还做了一个文件上传了。。。
早想看看googlecode提供的wiki。摸索。。。http://code.google.com/p/sieelf/w/list
基本上还可以满足我们的要求吧。而且也有些许特色。
——————————————————————————
要想编辑wiki,必须要是我们项目的成员,需要加入项目可以向我或者regspy(幻芯)申请,或跟帖说明。

简单的说明一下吧,很多东西我自己也不大清楚:
我们的做法是一个函数一个页面,页面名称(Page Name)为这个函数的16进制序号,一律这样吧,否则容易乱。
Summary为这个函数的名称。

Summary用“#summary”这个代码,如:
#summary void GetDateTime(TDate *, TTime *);
出来的Summary就是void GetDateTime(TDate *, TTime *);
一般建立一个新页面,它都已经提供给你了只要你修改就可以了。
接下来看大家发挥吧。。。反正wiki上大家是可以互相补充编辑的。

我自己比较喜欢这样的写法:
先用"{{{"和"}}}"吧我们的内容包括起来,防止wiki处理了我们的一些符号,尤其是指针用的*号。

接下来写这个函数在swilib.h中的内容,如:
#pragma swi_number=25
__swi   __arm   intstrcmp (const char *,const char *);

然后接下来写函数的作用,用法,再举例。

添加新页面点左上角的New Page按钮,编辑页面在打开页面后点右上角的Edit This Page按钮。
一些代码的使用可以看右边的“Wiki Markup Help”,或者看这里http://code.google.com/p/support/wiki/WikiSyntax

下面介绍一下googlecode提供的wiki很有的特色功能,svn管理:
只要你的wiki上有页面,你的svn目录下就会生成一个wiki文件夹,这里保存这wiki的源代码(即你编辑的时候写入的内容),这些都是以Page Name命名的.wiki文本文件。

那么你就可以在你的PC上用svn工具下载这些源码:https://sieelf.googlecode.com/svn/wiki
你可以直接编辑这些页面,也可以新增一个页面或删除一个页面,然后直接上传。
在http://code.google.com/p/sieelf/w/list你会看到相应的变化。

要注意的是:中文应使用UTF8编码。

[ 本帖最后由 binghelingxi 于 2008-1-14 20:06 编辑 ]

binghelingxi 发表于 2008-1-14 20:08:44

http://code.google.com/p/sieelf/w/list

我试着写了几个函数。

大家一起来补充吧。

函数名称使用0x022这样的三位16进制数吧,不足三位用0补全,这样易于排序。

[ 本帖最后由 binghelingxi 于 2008-1-14 20:18 编辑 ]

jpg001 发表于 2008-1-14 22:21:48

恩,共享是西友的一贯作风了

crack4000 发表于 2008-1-15 08:30:02

一直盼望这有这一天啊,写程序有资料说明可查,便于新手入门啊

lgkustlg_952000 发表于 2008-1-15 08:45:52

羡慕ing::\\shx

binghelingxi 发表于 2008-1-15 09:06:34

::/\dt

大家一起来写啊。。。要加入的赶紧申请啊。。。

我似乎条件不大允许啊。。。考试忙中。。。外加放假回家没得电脑玩了。

binghelingxi 发表于 2008-1-15 11:25:04

正在添加中,JPG做了很多,猛烈感谢一下。。。

希望更多的兄弟加进来。

一共差不多有600个函数

comerose 发表于 2008-1-16 01:46:25

发现ChangeVolume的函数在很多版本SWILIB中没有这个函数!

天外飞客 发表于 2008-1-16 19:56:45

很好呀。~
页: [1]
查看完整版本: 使用googlecode提供的wiki写swilib函数说明