Aire-One
/
LDoc2tl
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

Clean up 'usage' for clarity in terminal output

This commit is contained in:
Jordan Irwin 2017-08-10 13:18:58 -07:00
parent ceed3da428
commit 7a94466936
1 changed files with 34 additions and 30 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

64
ldoc.lua
View File

@ -39,36 +39,40 @@ app.require_here()
local usage = [[ local usage = [[
ldoc, a documentation generator for Lua, v]]..version..[[ ldoc, a documentation generator for Lua, v]]..version..[[
-d,--dir (default doc) output directory Invocation:
-o,--output (default 'index') output name ldoc [options] <file>
-v,--verbose verbose
-a,--all show local functions, etc, in docs Options:
-q,--quiet suppress output -d,--dir (default doc) output directory
-m,--module module docs as text -o,--output (default 'index') output name
-s,--style (default !) directory for style sheet (ldoc.css) -v,--verbose verbose
-l,--template (default !) directory for template (ldoc.ltp) -a,--all show local functions, etc, in docs
-p,--project (default ldoc) project name -q,--quiet suppress output
-t,--title (default Reference) page title -m,--module module docs as text
-f,--format (default plain) formatting - can be markdown, discount or plain -s,--style (default !) directory for style sheet (ldoc.css)
-b,--package (default .) top-level package basename (needed for module(...)) -l,--template (default !) directory for template (ldoc.ltp)
-x,--ext (default html) output file extension -p,--project (default ldoc) project name
-c,--config (default config.ld) configuration name -t,--title (default Reference) page title
-u,--unqualified don't show package name in sidebar links -f,--format (default plain) formatting - can be markdown, discount or plain
-i,--ignore ignore any 'no doc comment or no module' warnings -b,--package (default .) top-level package basename (needed for module(...))
-X,--not_luadoc break LuaDoc compatibility. Descriptions may continue after tags. -x,--ext (default html) output file extension
-D,--define (default none) set a flag to be used in config.ld -c,--config (default config.ld) configuration name
-C,--colon use colon style -u,--unqualified don't show package name in sidebar links
-N,--no_args_infer don't infer arguments from source -i,--ignore ignore any 'no doc comment or no module' warnings
-B,--boilerplate ignore first comment in source files -X,--not_luadoc break LuaDoc compatibility. Descriptions may continue after tags.
-M,--merge allow module merging -D,--define (default none) set a flag to be used in config.ld
-S,--simple no return or params, no summary -C,--colon use colon style
-O,--one one-column output layout -N,--no_args_infer don't infer arguments from source
--date (default system) use this date in generated doc -B,--boilerplate ignore first comment in source files
--dump debug output dump -M,--merge allow module merging
--filter (default none) filter output as Lua data (e.g pl.pretty.dump) -S,--simple no return or params, no summary
--tags (default none) show all references to given tags, comma-separated -O,--one one-column output layout
--fatalwarnings non-zero exit status on any warning --date (default system) use this date in generated doc
--testing reproducible build; no date or version on output --dump debug output dump
--filter (default none) filter output as Lua data (e.g pl.pretty.dump)
--tags (default none) show all references to given tags, comma-separated
--fatalwarnings non-zero exit status on any warning
--testing reproducible build; no date or version on output
<file> (string) source file or directory containing source <file> (string) source file or directory containing source