Skip to content

lc-compile.1.md

Latest commit

 

History

History
89 lines (63 loc) · 3.15 KB

lc-compile.1.md

File metadata and controls

89 lines (63 loc) · 3.15 KB

lc-compile(1) -- compile LiveCode Builder source code

SYNOPSIS

lc-compile [OPTION ...] --output OUTFILE [--] LCBFILE

lc-compile [OPTION ...] --outputc OUTFILE [--] LCBFILE

lc-compile [OPTION ...] --deps [DEPSMODE] [--] LCBFILE...

DESCRIPTION

lc-compile compiles the named input LCBFILE to bytecode, saving the resulting bytecode to OUTFILE.

If one or more --modulepath options are provided, lc-compile may additionally generate an interface (.lci) file in the first --modulepath specified.

OPTIONS

  • --modulepath PATH: Search for interface (.lci) files in PATH, which should be a directory. The first --modulepath option specified determines the directory in which an interface file may be created for LCBFILE.

  • --output OUTFILE: Generate LiveCode bytecode in OUTFILE, which should be the path to a .lcm file. If OUTFILE already exists, it will be overwritten.

  • --outputc OUTFILE: Generate LiveCode bytecode as a static array embedded in C source code in OUTFILE, which should be the path to a .c file. If OUTFILE already exists, it will be overwritten.

  • --deps [DEPSMODE]: Generate dependency information on standard output. DEPSMODE may be order, changed-order, or make. If DEPSMODE is omitted, make is assumed. See also the DEPENDENCY INFORMATION section below.

  • --manifest MANIFEST: Generate a module manifest in MANIFEST. This is used by the LiveCode IDE.

  • -Werror: Turn all warnings into errors.

  • -h, --help: Print some basic usage information.

  • --: Stop processing options. This is useful in case LCBFILE begins with --.

The --output and --outputc options cannot be used together.

DEPENDENCY INFORMATION

lc-compile's --deps mode is used to assist in compiling multiple .lcb source files that depend on each other in the correct order. In this mode, you should usually specify all of the source files for a project as command-line parameters; lc-compile will output the dependency information between them on standard output.

If DEPSMODE is order, the output is a list of input files in the order in which they need to be compiled in order to satisfy all dependencies. If DEPSMODE is changed-order, the output is the same list, but with all input files that are up-to-date omitted. Input files are considered up-to-date if the corresponding interface file is newer than its dependencies.

If DEPSMODE is make, or is not specified, then the output is a Makefile fragment declaring the dependencies between the input files and any interface files that they depend on. --deps make can also be used with a single input file and the --output option. In this mode, lc-compile the output is a Makefile fragment that declares the dependencies between the input file, the output file, and the corresponding interface file.

COPYRIGHT

Copyright 2014-2015 LiveCode Ltd.

This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHATABILITY or FITNESS FOR A PARTICULAR PURPOSE.

SEE ALSO

lc-run(1), make(1).