28:
29:CG ENDS
30: END START
第一条的 PAGE 是供列印用的「保留指令」,表示每页所印的行数及列数。其后之 60,132 即为60行, 132个字符。
第二条的 TITLE 为供查阅之「保留指令」。
前述REM 注记栏中,应说明该段程式的功能、应用条件,以便其他程式师共同使用。
三、注记
注记的目的在于日后自己或他人能很容易地做程式修改、维护。因此所做描述当力求详尽。不幸的是,不论多么精彩的文句,总有不足之处。因此,注记时需把握重点,大体说来,程式需加以说明的,不外:
1,功能:做什么工作,需要何种先决条件。
2,参数:设些什么数据,以供本段程式处理。
3,缓冲器:用什么缓冲器,其工作特性如何。
4,结果:执行后所产生的结果。
5,子程式调用:在本段程式中,所需调用的子程式名。
6,重要声明:如暂存器是否被破坏,或其他注意的事项。
如:
【功能】:读键盘缓冲区输入码,依性质返回ASCII+扫
瞄码或中文内码
【参数】: AH = 00H
【返回】: 11AL< 80H,AH = 扫瞄码,AL = ASCII
12AL≧80H,AL = 四字元中文内码之一
【破坏暂存器】:AX
【备注】:以本功能取中文内码,须连取4次,依序得
到一中文4字元内码。
当然,如果时间充足,最好能有程式的全部说明,以及制作、修改的细部记录。
问题在于任何程式发展之初,一定乏善可陈。再加上不断的修改、增补,其间变化复杂无比。程式师又要全神贯注,解决问题,又要考虑如何注记,一心两用,必然谈不到效率。
那么怎样做才对呢?我建议先让程式师自由发挥,在初期有无注记无关紧要。待程式完成了,大致上没有错误,这时,就应该停下来,从头到尾,将程式彻底整理一番。
这样不仅加注记容易,而且程式师有机会重新「欣赏」自己的心血结晶,该改的改,该合并的合并,该删的删。最后,程式师经过反思,研究,技术将会大幅度进步,程式更精简,注记也正确无误,工作也达到最高效率。