logo
Free, unlimited AI code reviews that run on commit
git-lrc git-lrc GitHub Install Now We'd appreciate a star git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt

ldoc - A LuaDoc-compatible documentation generation system

Author

       This manpage was written for Debian by Julian Wollrath and may be used by others.

ldoc                                             02 October 2023                                         ldoc(1)

Description

       LDoc, a documentation generator for Lua compatible to LuaDoc.

Examples

ldoc. reads options from a config.ld file in the same directory

       ldoc-cpath/to/myconfig.ld.
              reads options from path/to/myconfig.ld

Name

ldoc - A LuaDoc-compatible documentation generation system

Options

-d,--dir
              (default docs) output directory

       -o,--output
              (default 'index') output name

       -v,--verbose
              be verbose during doc generation

       -a,--all
              show local functions, etc, in docs

       -q,--quiet
              suppress output

       -m,--module
              module docs as text

       -s,--style
              (default !) directory for style sheet (ldoc.css)

       -l,--template
              (default !) directory for template (ldoc.ltp)

       -p,--project
              (default ldoc) project name

       -t,--title
              (default Reference) page title

       -f,--format
              (default  plain)  formatting, valid options are markdown, discount or plain

       -b,--package
              (default .) top-level package basename (needed for module(...))

       -x,--ext
              (default html) output file extension

       -c,--config
              (default config.ld) configuration name

       -u,--unqualified
              don't show package name in sidebar links

       -i,--ignore
              ignore any 'no doc comment or no module' warnings

       -X,--not_luadoc
              break LuaDoc compatibility. Descriptions may continue after tags.

       -D,--define
              (default none) set a flag to be used in config.ld

       -C,--colon
              use colon style

       -N,--no_args_infer
              don't infer arguments from source

       -B,--boilerplate
              ignore first comment in source files

       -M,--merge
              allow module merging

       -S,--simple
              no return or params, no summary

       -O,--one
              one-column output layout

       --date (default system) use this date in generated doc

       --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

See Also