关于注视

yangff

04、为方法说明。简要说明一下方法的用途和参数的相关信息，这会简化开发，当然，如果你愿意打这些字的话：
, D0 u  q9 ~5 U
% C5 E2 x) `5 o" U1 b

#------------------------------------------------------
. q5 `( Q+ J$ V% l- G+ Y6 |
8 ~8 k3 {9 j  R' o) i# ● 判定技能可否使用（需要的物品是否满足）
1 g* n) u! S4 n& r  `
#     skill  : 技能
4 O* }0 A4 ?3 b4 y- l2 o' U
#------------------------------------------------------
$ J% Q1 I# @! P: o, `

类似这样的注释我希望能够 符合标准的summary之类的各种
这样方便编辑器的扩展，同时也方便使用……

yangff

主要是这样的注释不好读取。
; Z1 \$ d1 e+ t做成一定格式的内容才有办法去读啊……
- U5 T  q  W5 h. R不然有人
#Func:xxx
#Takes:xxx integer
#xxx string => 名字
' d, Z# S# L8 S6 W#returns string => 菊花
有人
#====================(20个=)
, T( `1 a5 D; y( _# h+ C  W# C#  ● 一个函数
* W- z; q7 L0 i; [! P7 K- ~$ Z#  判定技能
# g8 \, m9 Q0 }; a#====================
有人
# x/ o: S. }& H6 l# <summary> //典型的C# 啊混蛋
#   蛋疼中……
" k3 V& y  E( o/ H) m) I2 i# </summary>
# <returns>混蛋混蛋</retuens>
那不是很悲剧= =

DeathKing

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

# ]! ?# v+ f! b( o; p) ^* Y这样来说，注释可以统一（比如Ruby的注释服务于RDoc一样）