NAME¶
falconeer.fal - Falcon skeleton module startup configurator script
SYNOPSIS¶
falconeer.fal -n moduleName [options]
DESCRIPTION¶
The
falconeer.fal script configures a directory containing the Falcon
Skeleton Module so that it becomes ready for compilation under all the systems
supported by Falcon.
Although not mandatory, a developer willing to write native modules for Falcon
may use this facility to speed up the startup phase and begin with an already
compilable module.
The configuration consists in the renaming of the module files into the module
name specified in the command line, and in the update of the makefiles and
project files provided for the various development platform Falcon can be
built on.
Other than the project name, the script allows one to configure other options,
that will affect the template variables that will be substituted in the
modified files.
Once configured and built, the skeleton module provides already a
skeleton() symbol that is exported to the VM, and a service that
exports that function (defined in the fskelmod_mod.cpp file) to C++
applications.
OPTIONS¶
- -a <author>
- Specifies the author name.
- -c "<copyright owner>"
- Indicates the copyright owner, if different from the author, to be set on
the copyright line, right beside the copyright year.
- -d <Description>
- Sets a brief description of the project.
- -l <File>
- Loads a license plate (a long statement indicating the license under which
the files are distributed) from a template file. If not given, the
standard FPLL license plate is applied to the generated files.
- -n <name>
- Sets the (short) name of the project. Files will be renamed accordingly to
this value, and also the final module name will be configured using this
setting.
- -p <name>
- Sets the main project hood under which the file is created. Usually,
modules are part of wider projects, or can be distributed as sets. If not
set, the text "The Falcon Programming Language" will be used
instead.
BUGS¶
The file
version.h cannot currently be properly configured. Edit it by
hand.
NOTES¶
On some systems, falconeer.fal script can be "proxied" with a
falconeer pseudo command (shell script, batch file and so on).
AUTHOR¶
Giancarlo Niccolai <gc@falconpl.org>
SEE ALSO¶
falcon(1)
LICENSE¶
This document is released under the "GNU Free Documentation License,
version 1.2". On Debian systems, the complete text of the Free
Documentation License, version 1.2, can be found in
/usr/share/common-licenses/.