■
docstr( gcc.build_index_type );
で、出力が、
build_index_type(maxval,) Create a type of integers to be the TYPE_DOMAIN of an ARRAY_TYPE. MAXVAL should be the maximum value in the domain (one less than the length of the array). The maximum value that MAXVAL can have is INT_MAX for a HOST_WIDE_INT. We don't enforce this limit, that is up to caller (e.g. language front end). The limit exists because the result is a signed type and we don't handle sizes that use more than one HOST_WIDE_INT. maxval - index max value.
大分前からやろうと思ってた埋め込みドキュメントまわりを。まだ途中だけど。
だーいぶ昔にもちょろっとだけ書いたような気がするけど、それなりの言語をつくるのであれば、Elispやら、Pythonのように、埋め込みドキュメントを機能として入れておくのは良いと思う。ほら、機能があったら使ってしまうのがプログラマの癖だったりするわけで、普段はコメントなんて書かないのに、Elispでプログラム書いてると、何故かdocstr入れちゃうよ、っていうのは結構あるよね。いや、僕だけかもしれんが。
まあいいや。大分前といえば、ILogScriptも書き始めてから一年経ってんだよな。だらだら。
ちなみに、上の説明文はGCCソースのコメントから頂戴したもので、自分で書いたわけではない。