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, ... )
目前就这些了。我正在计划一些更进一步的东西(比如 --& 和 --. 分别用于重要的表格和字段,我还需要某种类型定义),但重要的东西都在这里了。
最棒的是,现在它变得如此简单,我正在记录更多代码。我拥有的文档越多,我就越想提取它并生成东西……
够了。我还有更多要讨论的,但现在没时间了。