FLENG(1)

📦 version 23, in nixos 26.05, nixpkgs unstable

✨ fleng(1) — your fave FGHC, Strand, KL1, PCN and FLENG compiler, straight from the General Commands Manual ✨

🏷️ NAME 🏷️

fleng — A FGHC, Strand, KL1, PCN and FLENG compiler

🌸 SYNOPSIS 🌸

fleng [OPTION ...] [FILENAME] [OBJECTFILE ...]

💖 DESCRIPTION 💖

okay so fleng is a compiler and run-time system for FLENG, a concurrent logic programming language descended from Prolog. It translates source code written in FLENG, FGHC (Flat Guarded Horn Clauses) or Strand into executable code. iconic behavior, honestly ✨

FILENAME should name a FGHC, Strand, KL1, PCM or FLENG source file, or a file previously compiled to assembler or a binary object file. C/C++ source files given on the command line will be compiled to object files and linked to the final executable unless the -c option is given. no cap 🫶

OPTION should be one of the following:

  • -h — Show usage information and exit. 💅
  • --version — Show compiler version and exit.
  • -w — Disable compiler warnings.
  • -k — Keep intermediate files.
  • -c — Compile to object file, do not create an executable program.
  • -t — Show some internal compiler information.
  • -a — Show intermediate representation on standard output.
  • -e — Generate entry-point file for faster cross-module calls.
  • -link FILENAME — Make use of entry-point definitions from given file.
  • -p — Generate profiling information.
  • -l LANGUAGE — Specify source language to clarify or force the translation of the source file in a particular mode. LANGUAGE should be one of "fghc", "strand", "kl1", "pcn" or "fleng". If this option is not specified, the source language will be inferred from the source file name extension. 🎀
  • -check — Only perform syntactical and semantic checking, do not generate any output files.
  • -cc — Output the name of the C compiler used for building FLENG.
  • -cflags — Output C compiler options suitable for compiling C code interfacing to FLENG-compiled code.
  • -libs — Output libraries needed to be linked to compiled FLENG code.
  • -c++ — Compile generated foreign code with C++ compiler instead of C compiler and force linking in C++ mode.
  • -m MODULE — Specifies the name of the compiled module. If no module name is given the module name defaults to "" (empty), which designates a main module.
  • -I DIRECTORY — Prepends the given directory to the list of locations where FGHC or FLENG include files should be searched. Also applies to C compiler invocations for foreign code stubs.
  • -foreign BASENAME — Sets the basename of the file that will hold C/C++ wrappers and stubs for foreign code. The default is "NAME~foreign" where "NAME" is the basename of the compiled source file. 🦋
  • -o OUTFILE — Produce OUTFILE and exit. Depending on the file extension, the compilation process will stop after generating a FLENG source file (.fl or .fleng) an assembler file (.s), a binary object file (.o) or an executable (any other extension). As default output filename the basename of the source file is given and an executable file is created.
  • -d — Enable debug information, which shows slightly more information in debug logs and enables some additional error checking.
  • -i — Enables interactive debugging. When this option is given and the executable is invoked with the -+INTERACTIVE run-time option, a read-eval-print loop is started that allows invoking arbitrary program and library goals. 🔥
Note that options can not be combined — any unrecognized option is passed to the C linker in the linking stage. You can add binary object files or libraries to the invocation of fleng which will be linked to the final executable.

🌿 ENVIRONMENT 🌿

The following environment variables change the behaviour of fleng:

  • FLENG_PREFIX — Contains the directory where support binaries, include files and libraries are located. If this variable is not set, the files are located in the path specified during installation. 🍓

🚦 EXIT STATUS 🚦

The fleng utility exits 0 on success, and >0 if an error occurs. periodt 💅

🦋 SEE ALSO 🦋

👑 AUTHORS 👑

Felix L. Winkelmann

💀 BUGS 💀

Most certainly — please submit reports to felix@call-with-current-continuation.org

That's the whole page, bestie — FLENG(1), Debian edition, dated Jan 31, 2021. Go compile something iconic 💅✨

📦 where this page comes from