Commit Graph

530 Commits

Author SHA1 Message Date
steve donovan 788d8f24bd Topics working with section references; cross-references starting to work 2011-07-11 15:40:44 +02:00
steve donovan ebc7c4e22f ldoc.files and ldoc.examples can have field 2011-07-11 09:59:10 +02:00
steve donovan d864e49f47 lexer would hang on an empty file 2011-07-11 09:34:18 +02:00
steve donovan 2e016bbe65 all output is UTF-8 encoded 2011-07-11 09:29:37 +02:00
steve donovan 42cb80be25 examples starting to work: factoring looking-up addresses out of template 2011-07-10 19:12:35 +02:00
steve donovan 7839a791ae code reformat 4 to 3 spaces per indent 2011-07-10 19:10:53 +02:00
steve donovan 6935affe05 one-column stylesheet by Lorenzo; initial prettification for examples 2011-07-08 16:01:05 +02:00
steve donovan acaa57c6b6 handling of strings was borked 2011-07-08 16:00:21 +02:00
steve donovan 684b5f350e provision for looking up class method names; only explicit modules have their names adjusted for package.mod 2011-07-08 15:59:56 +02:00
steve donovan 7ae455c006 implement --one: refactoring for examples support 2011-07-08 15:58:40 +02:00
steve donovan daa5780916 provision in template not to show contents 2011-07-08 15:58:01 +02:00
steve donovan 4d718d3e86 Inline references are now @{ref}, not <ref> 2011-07-07 14:29:27 +02:00
steve donovan c727f0106c can specify configuration file with --config parameter 2011-07-07 14:28:41 +02:00
steve donovan cfe818ae35 don't use nowrap on name table cells 2011-07-07 14:27:55 +02:00
steve donovan e786e6beac generalizations: <ref> can also be used w/out Markdown. Options to switch off various parts of the template 2011-07-06 15:24:05 +02:00
steve donovan c1c507c2a7 examples updated 2011-07-06 11:49:50 +02:00
steve donovan efd03cccb3 Markdown preprocess: consistently indented blocks are given paragraph break lines around them. Use ldoc.classic_markdown to switch off 2011-07-06 11:49:24 +02:00
steve donovan 67c4a795af ldoc.no_summary switches to functions-down-side, no upfront tables; useful for single-module projects 2011-07-06 11:47:41 +02:00
steve donovan cd0c64475b no top margin for sublist <ul>, <ol> 2011-07-06 11:46:38 +02:00
steve donovan 8e791b8be6 new md test 2011-07-05 20:19:48 +02:00
steve donovan 99cfca7643 attempt to tame markdown.lua's need for blank lines around lists; it is not doing nested lists correctly (throwing in <p> inside <li>) 2011-07-05 18:53:28 +02:00
steve donovan 5e891d8d7c Can now have <<REF>> inside Markdown-flavoured ldoc, which use the same rules for
REF as with @see references. References within a single module document must be
to the name of the document from args.output, not the module name.
2011-07-05 18:19:49 +02:00
steve donovan e21db67984 factoring out custom markup processing 2011-07-05 16:30:49 +02:00
steve donovan 2810c4804a conditional fix for Penlight 0.9.5; uses loadin() if available 2011-07-05 13:33:27 +02:00
steve donovan 3169b6482f the new name for index (args.output) will be used for index refernces as well 2011-07-03 18:22:45 +02:00
steve donovan fb98cc767d (1) pattern for @see references did not include underscore (2) hack for grabbing block comment foiled by '--]]' 2011-07-03 10:26:24 +02:00
steve donovan 2a07ffc7d0 refactored file processing so that args.file can be set from config as a list of files or directories 2011-07-03 10:24:14 +02:00
steve donovan 20498f3ad7 making better error messages 2011-06-21 18:39:38 +02:00
steve donovan 3ca03ea818 lexer could not cope with zero length file 2011-06-21 18:30:57 +02:00
steve donovan 4fd3c78388 more useful message if template is not found: utils.quit() borked 2011-06-21 18:02:21 +02:00
steve donovan 7b69e259fd workaround for PL bug on Windows with relative paths: path.normcase is borked 2011-06-21 17:47:48 +02:00
steve donovan f2fc6f1604 can now use package field in config.ld. tests/luadoc contains a suitable setup for processing LuaDoc itself correctly 2011-06-20 19:04:21 +02:00
steve donovan 5387084565 if a function is explicitly tagged as such, then don't try to further parse the function definition in Lua 2011-06-20 13:16:05 +02:00
steve donovan 1ee35487dc updated version number 2011-06-19 18:22:48 +02:00
steve donovan b7e1270b63 doc fixes 2011-06-19 18:13:36 +02:00
steve donovan 7fe67090a9 split readme.md; actual 'manual' is docs/doc.md. Another example added 2011-06-19 17:58:15 +02:00
steve donovan c4ccfd99b5 --filter implemented, plus some clean-up 2011-06-19 17:53:05 +02:00
steve donovan f55838ede0 keep a table of globals; used for ldoc -m and for resolving @see references to Lua standard library functions and tables 2011-06-19 17:52:02 +02:00
steve donovan 5c8a9d1e72 nasty typo caused crash on table definitions. (borked commit) 2011-06-18 11:45:45 +02:00
steve donovan 41cb7417a8 fixed up booboo when dumping out module list in index 2011-06-18 11:26:57 +02:00
steve donovan 98b0617d34 module name inference (1) 'mod/init.lua' is 'mod' (2) either M or _M are used as default alias values for 'new-style' modules 2011-06-16 16:44:46 +02:00
steve donovan ad2a350806 separate out language-specific parsing strategies 2011-06-16 11:09:24 +02:00
steve donovan 7c02820692 initial implementation of -all flag; default is to hide local functions from documentation 2011-06-15 16:33:13 +02:00
steve donovan c57c364335 @local tag to flag a function explicitly as local 2011-06-15 16:12:56 +02:00
steve donovan c9e972c989 spoke too soon. Now using _initial_ global state to determine whether to look in Lua global builtin functions 2011-06-14 15:04:14 +02:00
steve donovan 451528ddce ldoc -m with builtin finally working properly 2011-06-14 15:00:36 +02:00
steve donovan 2487dea7fa global lookup hack for -m was over-hasty 2011-06-14 12:24:20 +02:00
steve donovan d4c04661ba ldoc -m now falls back on the Lua documentation in builtin directory; concept of 'doc path' introduced. 2011-06-14 11:36:05 +02:00
steve donovan 2a7cad7be5 complete moving template and stylesheet to html 2011-06-14 10:58:44 +02:00
steve donovan e62bec5b81 complete moving source 2011-06-14 10:54:51 +02:00