Exp Lua
 |
||
|
Exp Lua |
|
最新的 explua 压缩包可以在 Wiki 上找到：Files:wiki_insecure/users/miller/explua.tar.gz 请注意，这是一个公共网站，因此代码本质上是不可信的。首先，包中**只能**包含 lua 文件。
LaTeX（后来使用我自己的宏等转换为 PS）内容的示例可以在 Files:wiki_insecure/users/miller/concur.ps.gz 找到。
On Sunday 19 October 2003 20:32, Reuben Thomas wrote: > I intend to fix on a system to use soonish (to make the libraries more > easily usable), so it would be nice to know how ExpLua works even if it's > not ready yet.好的。我一直在以一种自适应、渐进、迭代细化的方式处理整个系统——也就是说，有时会花 20 分钟进行拼凑，有时会整晚设计/构建/测试一大堆东西——主要针对我的论文自动记录函数和模块（它有很多函数和模块，我不想写两次并维护两个版本）。
我一开始尝试使用其他可用的系统（例如 LuaDoc?、JavaDoc?，甚至文学编程），但发现它们往往会妨碍我的糟糕编程习惯。不幸的是，它们对我来说不够强大和令人满意，无法让我放弃我的弱点并开始正确设计——我只会厌倦输入 @param 标签，并完全停止注释。
因此，我想我想要一个注释系统，它在编程时更易于输入，即使你不理解特定的注释格式也易于阅读。我选择了一个这样的符号系统
对于整个文件
--| Begins a module/file comment, e.g., "this file does *this*". --by Pedro Miller Rabinovitch <[email protected]> --$Id: myfile.lua,v 1.12 2003/10/17 00:13:56 miller Exp $ --TODO lots of stuff.
在每个函数之前
--% This is the purpose of the function, i.e., what it *does*. --- And this is the second line, which will concatenated to --- the others. --@ first (string) Text of the first parameter --@ what (table) The second parameter is the table used for an --- example --@ [...] (any) Optional parameters to the called whatever --: (number) Number of whatevers done or nil if an error occured function Module:MyFunction( first, what, ... )
目前就这些了。我正在计划一些更进一步的东西（比如 --& 和 --. 分别用于重要的表格和字段，我还需要某种类型定义），但重要的东西都在这里了。
最棒的是，现在它变得如此简单，我正在记录更多代码。我拥有的文档越多，我就越想提取它并生成东西……
够了。我还有更多要讨论的，但现在没时间了。
