Skip to main content



      Home
Home » Archived » Lua Development Tools » How to Document Module's Local Function(Asking Documentation Language of Koneki/LDT)
How to Document Module's Local Function [message #966311] Wed, 31 October 2012 18:55 Go to next message
Eclipse UserFriend
I am new in Koneki/LDT and am insterested that I can make Lua "strict" with Documentation Language of Koneki/LDT.

In http://wiki.eclipse.org/Koneki/LDT/Technical_Documentation/Documentation_Language#Function_comment_block, it said that:
Quote:
The function comment block has to be attached to a type.

So, how do I write documentation for local function? For example, how to fill "???" in codes like this:
---
-- @module supermodule.mymodule
local mymodule = {}


---
-- Actually I'm not sure whether to write `#(supermodule.mymodule)` or
-- just `#supermodule.mymodule`.
--
-- @function [parent=#(supermodule.mymodule)] interface
function mymodule.interface( foo )
end


---
-- @function [parent=???] internal
local function internal( bar )
end


return mymodule



Thank you
Re: How to Document Module's Local Function [message #972066 is a reply to message #966311] Mon, 05 November 2012 05:26 Go to previous messageGo to next message
Eclipse UserFriend
Hi,

For the parent type name it is:
---
-- Actually, write `#supermodule.mymodule`.
-- 
-- @function [parent=#supermodule.mymodule] interface
-- @param foo
function mymodule.interface( foo )
end

I updated the documentation which was not clear enough about this.
The aim of LDD is to let you describe the API exposed by your module.
So far there is no way to document for an "inside-module only" use, but I get your need.
We will keep you posted as soon as we have something about this purpose.

Kevin
Re: How to Document Module's Local Function [message #973160 is a reply to message #972066] Tue, 06 November 2012 00:44 Go to previous message
Eclipse UserFriend
Thank you Kevin.
I think documentation for internal function/field is good to make Eclipse's Outline tree cleaner, and helps me too Smile.
Previous Topic:Gideros Code Assist
Next Topic:External Lib : Lua LOOP not running
Goto Forum:
  


Current Time: Sun Jul 13 17:57:04 EDT 2025

Powered by FUDForum. Page generated in 0.03022 seconds
.:: Contact :: Home ::.

Powered by: FUDforum 3.0.2.
Copyright ©2001-2010 FUDforum Bulletin Board Software

Back to the top