关于注视

yangff

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

' U6 L+ W2 o3 G5 f+ K/ Y

#------------------------------------------------------
6 C& v( C& L/ K* v1 w+ {7 _* U  o, O
# ● 判定技能可否使用（需要的物品是否满足）

2 p. b9 S& o! H9 O#     skill  : 技能

) V+ m4 F- a8 }$ y6 ~, [* `5 r: I% }#------------------------------------------------------


类似这样的注释我希望能够 符合标准的summary之类的各种
9 J$ A) v! ~9 z% M0 U* |, W这样方便编辑器的扩展，同时也方便使用……
! i( W5 Z0 f+ A9 H9 i

yangff

主要是这样的注释不好读取。
4 X  P% Q' {+ B& \+ I! r做成一定格式的内容才有办法去读啊……
不然有人
#Func:xxx
#Takes:xxx integer
#xxx string => 名字
  [% R. {6 f* }) {#returns string => 菊花
有人
#====================(20个=)
#  ● 一个函数
: w, O0 P# V% @5 y5 N1 _#  判定技能
#====================
有人
7 {2 K6 C0 S# u, e0 G# <summary> //典型的C# 啊混蛋
#   蛋疼中……
" J9 y  j: w; N* A, y# </summary>
# <returns>混蛋混蛋</retuens>
那不是很悲剧= =

DeathKing

FSL是版权协议，注释是另外一个标准，为了以后的Fibrary打基础。
+ M( R  r% I  ~; V; ~) z
这样来说，注释可以统一（比如Ruby的注释服务于RDoc一样）