luaDoc試用心得
1625 ワード
luaDoc試用心得
luaの専属注釈を使って文書作成ツールluaDocを作ってみました.基本モードはdoxygenと同じです.でも、もっと簡単な感じがします.
1.前期準備作業及びコンパイル方法
luaDocはlua FileSystemとluaLoggに依存する必要がありますので、私が使っているのは統合パッケージです.http://luaforwindows.luaforge.net/
使い始めるには、5.1\luaの下でluadoc_を見つけます.start.luaファイルは、このファイルがluadocの起動ファイルです.
あなたが作成したいluaファイルのカタログを見つけて、このようなbatを作ります.
lua「d:\Program Files\Lua\5.1\luadoc.lua」xxx.lua
ここで注意してください.luaはシステムパスに登録されています.もし統合パッケージがインストールされていないなら、手動で追加してください.
一括生成が必要なら、*.luaだけでも大丈夫です.
作成したウェブページのファイルをソースディレクトリに置いて、index.で確認します.
2.luaDocにプログラムのコメントを認識させる
基本的な注釈構造を見てください.
luaの専属注釈を使って文書作成ツールluaDocを作ってみました.基本モードはdoxygenと同じです.でも、もっと簡単な感じがします.
1.前期準備作業及びコンパイル方法
luaDocはlua FileSystemとluaLoggに依存する必要がありますので、私が使っているのは統合パッケージです.http://luaforwindows.luaforge.net/
使い始めるには、5.1\luaの下でluadoc_を見つけます.start.luaファイルは、このファイルがluadocの起動ファイルです.
あなたが作成したいluaファイルのカタログを見つけて、このようなbatを作ります.
lua「d:\Program Files\Lua\5.1\luadoc.lua」xxx.lua
ここで注意してください.luaはシステムパスに登録されています.もし統合パッケージがインストールされていないなら、手動で追加してください.
一括生成が必要なら、*.luaだけでも大丈夫です.
作成したウェブページのファイルをソースディレクトリに置いて、index.で確認します.
2.luaDocにプログラムのコメントを認識させる
基本的な注釈構造を見てください.
--- table
-- @param selfclass table
-- @param parentclass table
-- @return
-- @usage local _widgetnotebox = _Inherit( {}, WIDGET_BASE )
function _Inherit( selfclass, parentclass )
if not parentclass then
error("parentclass null", 2 )
end
return setmetatable( selfclass,
{
__index = function( t, k )
local ret = parentclass[k]
selfclass[k]= ret
return ret
end
} )
end
luaDoc --- ,
@param ,selfclass
@return
@usage