Steve J Donovan
21eff88c05
Merge pull request #142 from JonasT/patch-3
...
Major reordering and renaming of sections of documentation
2013-12-31 01:02:25 -08:00
Steve J Donovan
2d6cddce44
Merge pull request #141 from JonasT/patch-2
...
Rewrite of first introductory paragraph
2013-12-31 00:59:22 -08:00
JonasT
ffec76bd56
Removing inconsistent header colon
2013-12-31 09:01:14 +01:00
JonasT
e38a1b1402
Better section naming, some hints for C code
2013-12-31 09:00:30 +01:00
JonasT
e3c9f5336a
Fixing tag introduction example (hopefully?)
2013-12-31 08:54:56 +01:00
JonasT
2061b5fc11
Some more reordering, introducing tags more explicitly
2013-12-31 08:53:59 +01:00
JonasT
2bd0c3f760
Getting all the sections in a more beginner's friendly, logical order
2013-12-31 08:40:50 +01:00
JonasT
721d626b70
Rewrite of first introductory paragraph
...
A suggested rewrite of first introductory paragraph. It does drop some information (e.g. second generation) in favor of being more beginner's friendly and more basic in what this is actually about. The followup LDoc-referring paragraphs seem sufficient to cater the needs of advanced doc tool users, while the first paragraph possibly stumps and scares away beginners in its current form.
2013-12-31 08:18:33 +01:00
JonasT
a870f91e59
Being more direct on how tags look like when introducing them first
2013-12-31 08:07:41 +01:00
Steve J Donovan
2db76970ab
Merge pull request #138 from dirkfeytons/master
...
Fix issue #123 : override 'boilerplate' was done too late
2013-12-24 05:52:12 -08:00
Dirk Feytons
b16e85af7d
Fix issue #123 : override 'boilerplate' was done too late
2013-12-24 11:30:56 +01:00
Steve J Donovan
bbc3183e35
Merge pull request #136 from hishamhm/master
...
Give command-line flags priority over the config file (plus minor fixes)
2013-12-21 00:15:30 -08:00
Hisham Muhammad
8b48e1d256
Don't call function when missing. Tweak needed for ldoc to build its own documentation files.
2013-12-21 00:50:07 -02:00
Hisham Muhammad
9b40e03e3a
Command-line flags that were explicitly passed by the user should take precedence over config file defaults.
2013-12-21 00:41:41 -02:00
Hisham Muhammad
41a0d9b009
Add entries missing in rockspec.
2013-12-21 00:41:34 -02:00
Steve J Donovan
c93c14709f
Merge pull request #130 from mooffie/fix_prettifier_last_lines
...
Fix minor issues with the "prettify" facility.
2013-12-12 22:52:07 -08:00
Mooffie
67a78ee0a5
Fix minor issues with the "prettify" facility.
2013-12-12 18:04:16 +02:00
Gary V. Vaughan
d5e623e8d7
doc: improve match pattern for manual page references with custom_see_handler.
...
* doc/doc.md: Use '[%w_]+' instead of '%a+' so that references
to, say, _exit(2) and dup2(2) work too.
Signed-off-by: Gary V. Vaughan <gary@gnu.org>
2013-12-12 09:42:44 +13:00
Steve Donovan
f60e6d4197
Pull #121 applied manually - custom tags may be hidden
2013-12-09 15:13:00 +02:00
Steve J Donovan
d96eee4605
Merge pull request #122 from mooffie/custom_display_name_handler
...
Custom display_name handler.
2013-12-09 05:07:09 -08:00
Mooffie
3053079fee
Custom display_name handler.
2013-12-09 12:23:27 +02:00
Steve J Donovan
94433da88f
Merge pull request #116 from abadc0de/master
...
Custom tags
2013-11-28 23:58:04 -08:00
abadc0de
89854e1537
Custom tags
...
Custom tags
2013-11-28 10:46:59 -05:00
Steve Donovan
4294b2e2da
Issue #114 : trying harder to resolve references by unqualified method name
2013-11-28 11:57:13 +02:00
Steve Donovan
63e3618c05
Issue #110 ; use '-u' or 'unqualified' explicitly to strip package names on sidebar (thanks to abadc0de)
2013-11-27 09:50:38 +02:00
Steve Donovan
46515b2411
Issue #113 , borked classmod: now custom sections are always respected. Automatic sections are generated for 'Metamethods' and 'Methods'
2013-11-27 09:46:37 +02:00
Steve Donovan
4fac99406c
try match single names against fully qualified names of module funtions
2013-11-21 16:06:34 +02:00
Steve Donovan
feabf5c91a
when using export tag, decide whether function is meant to be a class method from 'self' formal arg, otherwise it becomes static.
2013-11-18 14:54:28 +02:00
Steve Donovan
8081e5b43c
option to use Markdown titles instead of file names with 'use_markdown_titles' (otherwise drop the .md extension on display)
2013-11-18 10:26:40 +02:00
steve donovan
9ef1f08784
can resolve references to local class; no longer have 'Topic: ' for readme documents
2013-11-17 19:48:35 +02:00
steve donovan
9fc5697cff
Issue #108 : sorting modules etc is off by default, switch back on using 'sort_modules=true'. Section lookup in docs was borked, fixed by stripping any extra whitespace before section titles
2013-11-17 10:38:24 +02:00
steve donovan
4666e464cc
no more fooling with globals in LDoc; the class ModuleMap is no longer global, but inserted into doc module so it can use it
2013-11-16 21:03:43 +02:00
steve donovan
fd323aa286
Issue #105 ; can switch off auto-linking to Lua manual with 'no_lua_ref' variable. This also happens if plain C documentation is being generated
2013-11-16 20:36:53 +02:00
steve donovan
955802e07b
Issue #93 : can define fields/properties of objects; the 'readonly' modifier is now special. See tests/styles/type.lua
2013-11-16 19:21:50 +02:00
Steve Donovan
7e2e6e975c
Issue #96 : was expecting a space after ## in markdown documents; better support for C types
2013-09-27 15:37:46 +02:00
Steve Donovan
7a7865f300
Issue 95: strip leading stars in C block comments; improvements in identifying typenames within type expressions
2013-09-26 16:05:45 +02:00
Steve Donovan
531a7d34de
Issue 81 'example' tag raises more explicit error, exclude more 'accidental' doc comments
2013-09-26 15:34:53 +02:00
Steve Donovan
20ff72cd35
add changes document
2013-09-20 13:52:18 +02:00
Steve Donovan
d2e40e2f2f
basic support for documenting C. If you put 'parse_extra={C=true}' in config.ld, then it will attempt to extract function name, arguments and types from the source
2013-09-20 13:33:06 +02:00
Steve Donovan
47e6a2094e
CSS errors fixed
2013-08-27 15:16:10 +02:00
Steve Donovan
8e3e211716
fixup selected module item
2013-08-27 14:16:21 +02:00
Steve Donovan
1d1ed6d0f0
on left-hand side all module names go through doc.module_name. This strips off package part currently
2013-08-27 13:17:11 +02:00
Steve Donovan
df72613e57
structure return needs 'typename'; by default merge_error_groups will combine different error tag texts
2013-08-27 12:47:47 +02:00
Steve Donovan
f33a09e4d3
issue #76 auto-scroll to avoid breaking identifiers
2013-08-27 12:44:04 +02:00
Steve Donovan
8395d6d9d7
inline error comments starting to work
2013-08-26 14:22:52 +02:00
Steve Donovan
a825a316a1
error tag now auto-groups; refactorings
2013-08-26 13:37:41 +02:00
Steve Donovan
0d79e16706
PL utils.unpack compatibility; refactoring error 'tag'
2013-08-26 09:59:10 +02:00
steve donovan
85dbd3d731
no-compat 5.2/5.3 compatible; line endings for markdown.lua
2013-08-25 21:01:30 +02:00
steve donovan
7da46268dc
'pale' template added; interpretation of --style and --template extended
2013-08-25 19:38:01 +02:00
steve donovan
ad909d683b
Can prettify C files as well as Lua with built-in prettifier
2013-08-25 14:29:30 +02:00