关于注视

yangff

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

& t; b/ W6 e6 ]/ N. M3 w, a& W
  T* H/ V  R/ m
#------------------------------------------------------
! i) n: {" A1 d$ N" x- d7 Q
# ● 判定技能可否使用（需要的物品是否满足）
  A# C/ C5 m5 e1 R
#     skill  : 技能

2 Q, {" c6 C$ k; r& Z6 c/ l#------------------------------------------------------


& x/ B; g5 E7 P0 s0 _4 F6 T类似这样的注释我希望能够 符合标准的summary之类的各种
& w% b) y/ t- u( Y6 ^4 x% e* o1 ?( z这样方便编辑器的扩展，同时也方便使用……
' H# c9 E1 k, J/ J2 N

yangff

主要是这样的注释不好读取。
7 `5 ~# h% ]# Z做成一定格式的内容才有办法去读啊……
不然有人
#Func:xxx
/ _$ p- A  L5 I/ O2 ~#Takes:xxx integer
#xxx string => 名字
$ q: \: W. x6 m& @* f+ L#returns string => 菊花
3 Y+ m- c1 b* `0 G& _* v: z有人
#====================(20个=)
#  ● 一个函数
#  判定技能
#====================
有人
, Y2 t0 d' _' h9 C8 a8 b# <summary> //典型的C# 啊混蛋
#   蛋疼中……
8 @3 j; ?8 e8 m0 P- x% M# </summary>
# <returns>混蛋混蛋</retuens>
4 F" h5 D8 t5 x3 B5 ?那不是很悲剧= =

DeathKing

FSL是版权协议，注释是另外一个标准，为了以后的Fibrary打基础。

这样来说，注释可以统一（比如Ruby的注释服务于RDoc一样）