
    ※※※※※※※※※※※※※※※※※※※※※※※※
    ※                                            ※
    ※          「北大侠客行」编程规范            ※
    ※                                            ※
    ※※※※※※※※※※※※※※※※※※※※※※※※



    ★  文件的起始部分

        // File          : 这里填入文件名（如：axe.c）
        // Created By    : 这里填入创建者的名字
        // Modified By   : 这里填入修改者的名字
        这些注释是为了方便以后的巫师了解做过什么修改，
    也是你的劳动成果的一种体现。这里的格式只是一种建议，
    包含了几个要素，当然如果你能把改了什么也大致描述一
    下就更好了。

    ★  声明部分

        把 #include 语句、inherit 语句、函数声明、全局变
    量分别归为一段，段与段之间用空行隔开。

    ★  定义变量

        定义变量时，最好在变量名前加入标识该变量的类型的
    标志，例如：

        int i, j, iSize, iFound_Flag;
        string sPath, sFile, *sLines;
        mixed mDict;
        mapping mpData;             

    不过此意见仅供参考，各人可以按自己的喜好，但必须注意
    的是当有多个同类型的变量在同一行声明的时候，各个变量
    之间要用空格分开，以使别人阅读时能够一目了然。

    ★  编写程序的格式

        ①  采用缩入格式编写程序，每个缩进可以使用四个或
    八个空格，但在一个程序文件内须保持一致；

        ②  采取分段的书写方式，把完成一个功能的若干条语
    句归为一段，段与段之间以空行隔开，以使程序条理清晰；

        ③  定义函数入口参数表时，以及给定函数的入口参数
    时，也要把各个参数以空格分开，以使人能清楚地分辨出函
    数参数的个数以及类型；

        ④  所有的运算符两边都要加空格，以使参与运算的变
    量能够清楚分清。

    ★  关于房间，物品及ＮＰＣ的描述

        ①  房间的名称及描述原则上要求使用缺省的颜色，长
    度以３～４行为宜，每行３０～３５个汉字，推荐使用控制
    宏 @LONG 和 LONG。由于系统会自动在第一行的前面空出两
    个汉字的位置，所以要求第一行顶头写，并要比以下的各行
    少两个字；

        ②  对于在房间的描述中给出的提示，一律要在房间的
    item_desc 中给予说明，长度为１～２行；

        ③  物品及ＮＰＣ的描述长度以１～２行为宜，特别要
    注意的是：如果不使用控制宏的话，在每行的末尾一定要加
    上“\n”；

        ④  物品及ＮＰＣ的ＩＤ尽量使用两个单词，另加一个
    一个单词的ＩＤ作为备选，推荐使用 set_name 来设置名字
    及ＩＤ；

        ⑤  另外，在所有的描述中，都要求使用全角符号，如
    果实在没法用全角，则必须在半角符号的后面加一个空格。
    又及：所有的描述都必须以标点符号结尾。

    ★  其他

        写出一个条理清晰、书写规范的程序，不仅对自己是一
    种享受，也是对他人的理解和帮助，同样是你编程水平的体
    现。一个好的程序可以让更多的人能够理解你的思想，能够
    让你的程序更容易地溶入到整个ＭＵＤ中来。


    ☆ 双儿 ☆ １９９８年９月１４日 ☆ （初稿） ☆
    ☆ iszt ☆ ２００７年１月２６日 ☆ （修改） ☆

