>>203
ローカル変数ってのは隠蔽されるべきものなので、
皆が読むドキュメントには書くべきではないと思われ。

実装者とか保守する人用に注意書き程度にコメント書くなら構わんと思うけど。