LFORTRAN(1)

📦
version 0.64.0 · 10 versions
, in ubuntu stonking

💖 LFORTRAN(1) 💖

okay bestie, welcome to the manual page for LFortran, section 1 of the manual. Yeah, the header line up top was literally just () and () — no version, no date, the girlies left it blank — but the vibe is immaculate and the compiler is real. Let's get into it. ✨

🌸 NAME 🌸

LFortran — a modern, interactive, LLVM-based Fortran compiler. she's giving compiler but make it cunty, no cap.

🎀 SYNOPSIS 🎀

lfortran OPTIONS [files...]  [SUBCOMMAND]

so you give her options, you give her files, and if you're feeling extra you hand her a subcommand too. that's the whole shape of it. periodt.

🦋 DESCRIPTION 🦋

LFortran is a modern interactive Fortran compiler based on LLVM. that's the entire description, she's a woman of few words and I respect it so much. 💅

✨ OPTIONS ✨

every single one, bestie. I did not skip a single flag because I love you.

  • -h, --help — prints this help message and dips out. classic.
  • -S — emit assembly, and do not assemble or link. just the assembly, nothing else, she's stopping early.
  • -c — compile and assemble, but do not link. almost there but not quite.
  • -o TEXT — tell her which file to put the compiler's output into.
  • -v — be more verbose. she'll talk more.
  • -E — preprocess only. no compiling, no assembling, no linking. just preprocessing, that's it.
  • -l TEXT ... — link library option.
  • -L TEXT ... — library path option.
  • -I TEXT ... — include path.
  • -J TEXT — where to save the mod files.
  • -g — compile with debugging information. debug girlies rise.
  • -D TEXT ... — define <macro>=<value> (or just 1 if <value> is omitted).
  • --version — display compiler version information.
  • -W TEXT ... — linker flags.
  • -f TEXT ... — all the -f* flags live here (only -fPIC is supported for now, fyi 🫶).
  • --cpp — enable C preprocessing.
  • --fixed-form — use fixed form Fortran source parsing.
  • --fixed-form-infer — use heuristics to figure out if a file is in fixed form.
  • --no-prescan — turn off prescan.
  • --show-prescan — show tokens for the given file and exit.
  • --show-tokens — show tokens for the given file and exit.
  • --show-ast — show AST for the given file and exit.
  • --show-asr — show ASR for the given file and exit.
  • --with-intrinsic-mods — show intrinsic modules in ASR.
  • --show-ast-f90 — show Fortran from AST for the given file and exit.
  • --no-color — turn off colored AST/ASR. (sad, but okay.)
  • --no-indent — turn off indented print for ASR/AST.
  • --tree — tree structure print ASR/AST.
  • --json — print ASR/AST in Json format.
  • --clojure — print ASR in clojure format.
  • --no-loc — skip location information in ASR/AST Json format.
  • --visualize — print ASR/AST Visualization.
  • --pass TEXT — apply the ASR pass and show ASR (this implies --show-asr, so don't say I didn't warn you).
  • --skip-pass TEXT — skip an ASR pass in the default pipeline.
  • --show-llvm — show LLVM IR for the given file and exit.
  • --show-cpp — show C++ translation source for the given file and exit.
  • --show-c — show C translation source for the given file and exit.
  • --show-asm — show assembly for the given file and exit.
  • --show-wat — show WAT (WebAssembly Text Format) and exit.
  • --show-julia — show Julia translation source for the given file and exit.
  • --show-fortran — show Fortran translation source for the given file and exit.
  • --show-stacktrace — show internal stacktrace on compiler errors. (the tea ☕)
  • --symtab-only — only create symbol tables in ASR (skip executable stmt).
  • --time-report — show compilation time report.
  • --static — create a static executable.
  • --no-warnings — turn off all warnings. live your truth I guess.
  • --no-style-suggestions — turn off style suggestions.
  • --no-error-banner — turn off the error banner.
  • --continue-compilation — collect error messages and keep compiling after hitting semantic errors.
  • --error-format TEXT=human — control how errors are produced (options: human, short). defaults to human.
  • --backend TEXT=llvm — select a backend (options: llvm, cpp, x86, wasm, fortran). defaults to llvm.
  • --openmp — enable OpenMP.
  • --separate-compilation — generate object code into .o files.
  • --rtlib — include the full runtime library in the LLVM output.
  • --use-loop-variable-after-loop — allow using the loop variable after the loop. chaotic, but permitted.
  • --fast — best performance (it disables strict standard compliance, so know that going in 👀).
  • --link-with-gcc — calls GCC for linking instead of clang.
  • --target TEXT — generate code for the given target.
  • --print-targets — print the registered targets.
  • --implicit-typing — allow implicit typing.
  • --implicit-interface — allow implicit interface.
  • --implicit-argument-casting — allow implicit argument casting.
  • --print-leading-space — print leading white space if format is unspecified.
  • --interactive-parse — use interactive parse.
  • --verbose — print debugging statements.
  • --dump-all-passes — apply all the passes and dump the ASR into a file.
  • --dump-all-passes-fortran — apply all passes and dump the ASR after each pass into a Fortran file.
  • --cumulative — apply all the passes cumulatively till the given pass.
  • --realloc-lhs-arrays — reallocate left hand side automatically for arrays.
  • --disable-realloc-lhs-arrays — disables reallocating left hand side automatically for arrays.
  • --module-mangling — mangles the module name.
  • --global-mangling — mangles all the global symbols.
  • --intrinsic-mangling — mangles all the intrinsic symbols.
  • --all-mangling — mangles all possible symbols.
  • --bindc-mangling — mangles functions with ABI bind(c).
  • --apply-fortran-mangling — mangle symbols with Fortran supported syntax.
  • --mangle-underscore — mangles with underscore.
  • --legacy-array-sections — enables passing array items as sections if required.
  • --ignore-pragma — ignores all the pragmas.
  • --stack-arrays — allocate memory for arrays on stack.

that's 72 flags btw. I counted. she ate. 🔥

👑 SUBCOMMANDS 👑

  • fmt — format Fortran source files. (glow-up for your code 💅)
  • kernel — run in Jupyter kernel mode.
  • mod — Fortran mod file utilities.
  • pywrap — Python wrapper generator.

🌈 SEE ALSO 🌈

for more information, visit the official LFortran documentation at https://docs.lfortran.org/. she's got lore, go read it. iykyk.

and that's the whole page, bestie 💜 the footer line was, again, just (), so no source, no version, no date — the mystery stays unsolved and honestly? iconic. go compile something cute. 🎀✨

📦 where this page comes from