Skip to content
This repository was archived by the owner on Aug 31, 2021. It is now read-only.

lc-compile.1.md

Latest commit

 

History

History
100 lines (72 loc) · 3.72 KB

lc-compile.1.md

File metadata and controls

100 lines (72 loc) · 3.72 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, and the --interface option is not specified, then 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. If the --interface option is not specified, then 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(s) embedded in C source code in OUTFILE, which should be the path to a .c file. If OUTFILE already exists, it will be overwritten.

  • --outputauxc OUTFILE: Generate LiveCode bytecode as a static array(s) embedded in C source code in OUTFILE, which should be the path to a .c file. If OUTFILE already exists, it will be overwritten. This is the same as --outputc mode, except that it does not emit the 'builtin' module (so should be used for additional sets of C embedded modules).

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

  • --interface INTERFACE: Generate the module interface file in INTERFACE.

  • -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 / --outputauxc 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).