Pierre Chapuis
0fb4b257ba
support Lua 5.3
2016-05-22 14:58:04 +02:00
Pierre Chapuis
260034ec5c
use HTTPS URLs for the manual
2016-05-22 14:57:53 +02:00
Ingo Struck
bba78586d4
support both available flavors of ldoc
2016-04-20 20:10:10 +02:00
steve donovan
2ddb9c64c7
Merge branch 'master' of github.com:stevedonovan/LDoc
2016-04-10 18:02:59 +02:00
steve donovan
bbbcb1a59f
--fatalwarnings flag to force ldoc to return non-zero exit code if there are any warnings; issue #255 @psychon
2016-04-10 18:02:09 +02:00
Steve J Donovan
75a108e0f8
Merge pull request #228 from Alloyed/fix-comment-highlighting
...
Fix end-of-block comments not highlighting
2016-04-10 16:55:57 +02:00
steve donovan
1ebd148291
allow [int] in table documentation - http://stackoverflow.com/questions/36419386/lua-ldoc-documentation-of-a-table
2016-04-10 16:54:33 +02:00
Kyle Buller
3dada49e07
Fix @within
2016-04-06 01:50:14 -05:00
Kyle McLamb
6fc556eb41
Fix end-of-block comments not highlighting
...
Originally, comments in code blocks were highlighted by looking for
their starting token at the beginning and a newline at the end.
This PR adds two new comment patterns that look for the end-of-string
instead of a newline, so that comments on the last line of a block are
still highlighted.
2016-02-07 00:52:21 -05:00
Chad Phillips
d8ff44f626
add custom_css configuration param.
2015-12-30 21:32:21 -05:00
Thomas Weber
3e4bb302da
Avoid return documentation slipping into preceding function documenation
2015-12-23 14:20:49 +01:00
Thomas Weber
b5e02a655b
Allow "]" in description after tag modifiers
2015-12-11 08:56:45 +01:00
cjtallman
b9803db8ff
Adding module-level see reference support.
2015-10-16 13:34:31 -07:00
Steve Donovan
b248a2e035
Modifications to pull #207 ; enable backward compatibility and fixed spelling mistake
2015-09-28 15:33:18 +02:00
Steve J Donovan
26b9a79384
Merge pull request #207 from zjarkov/master
...
Using ldoc.prettify_files the same way as for example ldoc.examples
2015-09-28 14:41:39 +02:00
Steve J Donovan
0577744bef
Merge pull request #198 from xelivous/patch-1
...
add missing parenthesis in ldoc_ltp.lua
2015-09-28 13:56:36 +02:00
Jaroslav Vaculik
9f6c84f8bc
Using ldoc.prettify_files the same way as for example ldoc.examples
2015-07-24 17:18:13 +02:00
Thijs Schreijer
5da1fa11d4
update rockspecs in repo, fix css
2015-04-28 11:55:19 +02:00
xelivous
134313e9a0
add missing parenthesis in ldoc_ltp.lua
2015-03-28 23:31:42 -05:00
Mooffie
205f72b313
Fix @{error} links
...
For some reason "error" was missing from the global functions list.
2014-12-29 13:30:47 +02:00
Mooffie
22e7055f03
Have postprocess_html
2014-12-24 17:51:05 +02:00
Steve J Donovan
e6fb2fedd2
Merge pull request #187 from mooffie/section_css
...
Have CSS classes for section header and description
2014-12-21 09:50:24 +02:00
Mooffie
5f5c55cca9
CSS cleanup
...
Two changes in this patch:
(1) Two repeating CSS chunks were moved to their own files:
- Yahoo's "reset" styles were moved to '_reset_css.lua'.
- The code prettifier's styles were moved to '_code_css.lua'.
(The underscore at the filename's start is to show that it's not an
independent file but intended to be embedded in another.)
(2) Everything in "pre.example" that's already in "pre" was removed
(leaving just the font-size).
CAVEAT: the two new files need to be added to the 'rockspec' file.
2014-12-20 22:50:44 +02:00
Mooffie
24a6b27338
Have CSS classes for section header and description
2014-12-16 12:08:08 +02:00
Steve J Donovan
ec97770051
Merge pull request #185 from mooffie/user_keywords
...
Support used-defined keywords (in prettified code).
2014-12-15 18:58:04 +02:00
Steve J Donovan
69a4419420
Merge pull request #184 from mooffie/custom_display_name_for_project_level_items_too
...
Make custom_display_name work for project-level items
2014-12-15 18:57:37 +02:00
Mooffie
3313e78b44
Support used-defined keywords (in prettified code).
2014-12-15 10:05:50 +02:00
Mooffie
fc768df17e
Make custom_display_name work for project-level items
...
This lets users customize the way module/topic/file/etc names are shown.
2014-12-14 16:32:16 +02:00
Michal Cichra
eef66575d6
Fix undefined quote in Item:build_return_groups
2014-11-19 19:55:45 +01:00
steve donovan
25fd0b6bed
escape <> for HTML; uniform 14em navbar; uppercase C
2014-11-01 16:45:08 +02:00
Steve Donovan
c23e2a9b6f
changed prettify keyword colour to make it more distinct from link; pushed up <code> size; cleaned up style-sheet-found-error
2014-10-28 15:40:32 +02:00
steve donovan
d56252b762
fixed style sheet added
2014-10-26 21:15:29 +02:00
steve donovan
c516eebd12
version bump; underscore escaping fix for backticks; horrible workaround for deficiencies of C lexer
2014-10-25 12:01:48 +02:00
steve donovan
2fbe566039
Bumped version to 1.4.3; doc updates; C lexer ignores strings (which it handles badly)
2014-10-21 17:57:26 +02:00
steve donovan
3117f6f791
fix for underscore escape when using markdown.lua; do not use in prettified code blocks
2014-10-15 18:48:39 +02:00
steve donovan
2639ddec9f
issue #172 spurious space; still cleaning out tab infestation
2014-10-13 19:38:11 +02:00
steve donovan
31ee8f5cbc
Issue #174 : @include tag for including processed documentation file into output; last item now has a distinct line number, and some nasty tabs have been removed
2014-10-12 18:35:19 +02:00
steve donovan
56ac2601c0
Tweaks to opt/optchain: (optional) is emitted after optional arguments without defaults. convert_opts (counter-intuitively) disables automatic opt->optchain promotion
2014-10-12 16:45:09 +02:00
steve donovan
cfdc6f8f53
new feature: prettify_files makes per-item links to source; unless this field is 'show', don't put in index
2014-10-12 16:09:09 +02:00
Steve Donovan
416b541a5c
issue #180 : make target function clearer with highlighting
2014-10-01 16:05:03 +02:00
Steve Donovan
2778e043ed
issue #169 : make sure ldoc is not nil before checking config
2014-10-01 16:02:38 +02:00
steve donovan
c34957cd16
issue #178 Allow class merging
2014-09-28 18:54:17 +02:00
Steve J Donovan
049945ce3d
Merge pull request #176 from hanxi/master
...
add update time to the footer of page
2014-09-26 10:48:04 +02:00
steve donovan
c979700ae6
Issue #177 : annotation rendering fixed
2014-09-15 20:02:28 +02:00
hanxi
609805a7a7
add update time to the page footer
2014-09-10 10:37:11 +08:00
Steve Donovan
160eda087e
Merge branch 'master' of github.com:stevedonovan/LDoc
2014-06-27 15:55:12 +02:00
Steve Donovan
9a5b556a2d
summary/description with type/section fixed
2014-06-27 15:50:21 +02:00
steve donovan
9bd5dd0ec7
dont_escape_underscore defaults to true if markdown.lua is not used; global_lookup defaults to true if parse_extra.C
2014-06-22 17:14:08 +02:00
Steve Donovan
acc6ed2ad3
prettify code blocks in module docstring. Two new ldoc flags: dont_escape_underscore (when not using markdown.lua) and global_lookup (when specifically wanting global lookup for single symbols
2014-06-20 15:11:40 +02:00
Steve Donovan
a0c780f093
allow Markdown headers in module docstring by stripping #..
2014-06-20 15:09:38 +02:00
steve donovan
bf0f1384b9
Updated pale theme
2014-05-26 17:58:43 +02:00
steve donovan
3f32313ced
#158 summary line lost with @type tag
2014-05-25 13:58:25 +02:00
Steve Donovan
6d29aef7f2
allow tags to contain digits
2014-04-25 15:59:54 +02:00
Steve Donovan
1f21b5efa3
workaround for Lua file methods #157
2014-04-23 13:38:58 +02:00
Steve Donovan
624ff11afd
parameter names which were List methods overwriting object - factor out as map field
2014-04-23 13:19:16 +02:00
Steve Donovan
251dc88f93
deterministic ordered file processing
2014-04-23 10:20:55 +02:00
steve donovan
511dfe7df0
ldoc.custom_references to create new @{KIND:NAME} reference schemes; doc updates
2014-01-21 19:51:55 +02:00
Steve Donovan
2c0d459a43
bumped version to 1.4.2
2014-01-16 09:53:29 +02:00
Gary V. Vaughan
fc0e6099fa
html: case sensitive file systems require matching require args.
...
* ldoc/html.lua: Make sure to `require 'pl.OrderedMap'` (with a
capital 'O') to match the filename installed by penlight.
Signed-off-by: Gary V. Vaughan <gary@gnu.org>
2014-01-08 16:55:32 +13:00
steve donovan
d367390c68
Issue #150 : 'info' section ordering is now consistent
2014-01-07 17:48:50 +02:00
Steve J Donovan
a8c4d9fa1e
Merge pull request #149 from vanzomerenc/master
...
Resolve issue #22 'In-line links with underscores are broken'
2014-01-07 01:19:37 -08:00
vanzomerenc
7c49337402
Resolve issue #22 'In-line links with underscores are broken'
2014-01-06 16:10:12 -05:00
steve donovan
04dc148df6
Issue #145 : do not expand annotations if there's no previous item
2014-01-06 15:03:09 +02:00
steve donovan
60c6e79dd9
Issue #137 boilerplate Lua block comment
2014-01-06 13:35:12 +02:00
steve donovan
86a3fde07e
issue #139 ; improved lookup for class methods; args override now only kicks if the argument does not have its default value
2014-01-05 14:55:20 +02:00
steve donovan
f507e36720
more general method of controlling visibility of local functions or items marked with @local
2014-01-02 18:45:04 +02: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
Mooffie
67a78ee0a5
Fix minor issues with the "prettify" facility.
2013-12-12 18:04:16 +02:00
Steve Donovan
f60e6d4197
Pull #121 applied manually - custom tags may be hidden
2013-12-09 15:13:00 +02:00
Mooffie
3053079fee
Custom display_name handler.
2013-12-09 12:23:27 +02: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
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
steve donovan
149ded81fc
composite return types experiment
2013-08-25 10:47:45 +02:00
steve donovan
45cb21bcc1
try harder with -m to resolve methods
2013-08-24 15:39:41 +02:00
steve donovan
3c72ea112e
ldoc.alias can specify a function which must return tag, value, modifiers like Item:check_tag. The alias error works with return groups
2013-08-24 15:19:45 +02:00