doc fixes: manual_url is a function; the reference should be to List.moon not list.moon
Steve Donovan
8 years ago
721 | 721 | |
722 | 722 | 1.4 introduces basic support for [Moonscript](http://moonscript.org). Moonscript module |
723 | 723 | conventions are just the same as Lua, except for an explicit class construct. |
724 | @{list.moon} shows how **@classmod** can declare modules that export one class, with metamethods | |
724 | @{List.moon} shows how **@classmod** can declare modules that export one class, with metamethods | |
725 | 725 | and methods put implicitly into a separate section. |
726 | 726 | |
727 | 727 | ## Basic Usage |
1246 | 1246 | when using Markdown. When explicit will expand non-references in backticks into `<code>` elements |
1247 | 1247 | - `plain` set to true if `format` is set but you don't want code comments processed |
1248 | 1248 | - `wrap` set to true if you want to allow long names to wrap in the summaries |
1249 | - `manual_url` point to an alternative or local location for the Lua manual, e.g. | |
1250 | 'file:///D:/dev/lua/projects/lua-5.1.4/doc/manual.html' | |
1249 | - `manual_url(url)` point to an alternative or local location for the Lua manual, e.g. | |
1250 | 'manual_url file:///D:/dev/lua/projects/lua-5.1.4/doc/manual.html'. Remember it is a function! | |
1251 | 1251 | - `no_summary` suppress the Contents summary |
1252 | 1252 | - `custom_tags` define some new tags, which will be presented after the function description. |
1253 | 1253 | The format is `{<name>,[title=<name>,}{hidden=false,}{format=nil}}`. For instance |
1254 | 1254 | `custom_tags={'remark',title='Remarks'}` will add a little `Remarks` section to the docs for any function |
1255 | 1255 | containing this tag. `format` can be a function - if not present the default formatter will be used, |
1256 | 1256 | e.g. Markdown |
1257 | - `custom_see_handler` function that filters see-references | |
1258 | - `custom_display_name_handler` function that formats an item's name. The arguments are the item | |
1257 | - `custom_see_handler(pat,handler)` function that filters see-references | |
1258 | - `custom_display_name_handler(item, default_handler)` function that formats an item's name. The arguments are the item | |
1259 | 1259 | and the default function used to format the name. For example, to show an icon or label beside any |
1260 | 1260 | function tagged with a certain tag: |
1261 | 1261 |