fglcomp

The fglcomp tool compiles .4gl source files into .42m p-code modules.

Syntax

fglcomp [options] { module[.4gl] [...]
                   | pattern
                   | @argfile }
  1. options are described in Table 1.
  2. module.4gl is a source file to compile. The .4gl extension is optional.
  3. fglcomp can take several .4gl sources files as arguments.
  4. pattern is a MATCHES-style pattern to find files, like '[a-z]*.4gl'.
  5. argfile defines a file that contains a list of .4gl sources to be compiled. Each line must specify a filename or a pattern.

Options

Table 1. fglcomp options
Option Description
-V or --version Displays version information.
-h or --help Displays options for the tool.
-i [ mbcs ] Displays information about the current locale / character set settings. See Application locale.
-S Dump Static SQL statements found in the source to stdout.
-m Extract %"string" localized strings from source to stdout.
-M Write error messages to standard output instead of creating a .err error file.
--make Do not recompile .42m modules up-to-date with provided .4gl source. See Compiling in make mode.
--simulate Print the list of .4gl sources that would be compiled (can be used with or without --make). See Compiling in make mode.
--dependencies Print the makefile-style dependency rules for imported modules. See Producing make-style dependency rules.
-W warning-argument Produce warning messages.

The warning argument can be used as follows:

  • -W all enables all warning flags.
  • -W error makes the compiler stop, if any warning is raised, as if an error occurred.
  • -W to-err-file writes warnings to the .err file when this file is produced. By default warnings go to the stderr stream.
  • -W unused displays a message for all unused variables.
  • -W return displays a warning if the same function returns different number of values with several RETURN statements.
  • -W stdsql displays a message for all non-portable SQL statements or language instructions.
  • -W print displays a message when the PRINT instruction is used outside a REPORT.
  • -W implicit warns on references to undeclared functions. A function is undeclared if not defined in the current module or in any imported module.
  • -W apidoc prints a warning for invalid source documentation tags when using the --build-doc option.
The -W option also supports the negative form of arguments by using the no- prefix as in: no-return, no-unused, no-stdsql. You might need to use these negative forms in order to disable some warning when using the -W all option:
fglcomp -Wall -Wno-stdsql customers.4gl

Switches will be enabled/disabled in the order of appearance in the command line.

-E Preprocess only. See Source preprocessor for more details.
--format [ options ] Reformat the .4gl module source with specified options. Here options can be one of:
  • --fo-inplace
  • --fo-fallback-style=filename
  • --fo-column-limit=int
  • --fo-indent-width=int
  • --fo-continuation-indent-width=int
  • --fo-label-indent={0|1}
  • --fo-pack={0|1}
  • --fo-lowercase-keywords={0|1}
  • --fo-use-tab={0|1}
  • --fo-tab-width
  • --fo-lines=start-line:end-line
For more details, see Source code beautifier.
--timestamp Add compilation timestamp to build information in 42m header. See 42m module information.
--omit-source-name Omit the source file name in the build information of the 42m header. See 42m module information.
--tag=string Write a custom string in the build information of the 42m header. See 42m module information.
-p option

Preprocessing control, where option can be one of:

  • nopp: Disable preprocessing.
  • noli: No line number information (only with -E option).
  • fglpp: Use # syntax instead of & syntax.
  • auto: Detect # syntax or & syntax automatically.
--qualify-imports Parse the provided source file to add module prefixes to all imported symbols. See Qualifying imports for details.
-I path Provides a single path to search for include files. See Source preprocessor for more details.
-D ident[=value] Defines the macro 'ident' with an optional value (default is 1). See Source preprocessor for more details.
-U ident Undefines the macro 'ident'. See Source preprocessor for more details.
--build-doc Generate source documentation.
--doc-private When using the --build-doc option, include PRIVATE symbols to the documentation.
--build-rdd While compiling, generate the module.rdd Report Data Definition file (of REPORT routines).
--verbose Print detailed compilation information.
--implicit=type Specify whether or not to compile imported modules, if the .42m does not exist, or if the .4gl source is more recent as the .42m.

Here type can be one of:

-r or --resolve-calls

Throw an error on references to undeclared functions. Each external function must be made known to the compiler by IMPORT FGL. When using this option, the linking phase is no longer needed; a source (.4gl) file compiled with this option must not be linked. See IMPORT FGL module for more details.

--java-option=option

Passes Java runtime options when initializing the JNI interface.

See Java Interface for more details.

Usage

The fglcomp command line tool compiles a .4gl into a .42m p-code module:
fglcomp customers.4gl

If a compilation error occurs, the compiler generates an error file with an .err extension. The error file contains the original source code with error messages. Use the option -M to display the error messages to standard error instead of producing the .err file.