关于注视

yangff

04、为方法说明。简要说明一下方法的用途和参数的相关信息，这会简化开发，当然，如果你愿意打这些字的话：

( V" p+ o7 R# k; X# u- r+ V0 u. I$ p' A
  ]( q/ R8 c6 R; @: e0 A, U
  T, Q4 @; T' F  [* R3 G#------------------------------------------------------
! F0 Z/ }/ k& {8 i1 P$ E9 \
9 c0 ], S2 b5 |2 t0 C  U2 y$ ~# ● 判定技能可否使用（需要的物品是否满足）

+ F! D2 [$ \, X* d5 m0 s#     skill  : 技能

#------------------------------------------------------

4 K; Q3 H$ G" l3 f- T9 c+ x
类似这样的注释我希望能够 符合标准的summary之类的各种
这样方便编辑器的扩展，同时也方便使用……
7 v4 H  B0 ]: j6 R3 Y

yangff

主要是这样的注释不好读取。
做成一定格式的内容才有办法去读啊……
) r3 H, e) {) Q3 Y4 Z1 L+ [1 \8 a. {不然有人
#Func:xxx
#Takes:xxx integer
$ k' U5 l' F8 G, ~+ u#xxx string => 名字
#returns string => 菊花
# ^- M5 W$ ], ^/ _4 u  F' S( n2 n有人
7 I% o, \2 [1 X) }2 R#====================(20个=)
4 F8 F3 q/ t+ z) X% ^) p9 _#  ● 一个函数
9 N4 F2 J+ z6 f. f9 E! U* _#  判定技能
( Z4 M' R1 ]. c#====================
有人
# <summary> //典型的C# 啊混蛋
#   蛋疼中……
# </summary>
# <returns>混蛋混蛋</retuens>
( [9 l7 Q# J8 q那不是很悲剧= =

DeathKing

FSL是版权协议，注释是另外一个标准，为了以后的Fibrary打基础。
+ g, Z; r$ T! L# R$ R# d: M$ z
这样来说，注释可以统一（比如Ruby的注释服务于RDoc一样）