FSHARPC(1)

📦 version 4.0.0.4, in ubuntu jammy, ubuntu noble

✨ NAME ✨

okay so bestie, this is the manual page for fsharpc — that's section 1 of the User Commands manual, iykyk — and it's literally the F# 3.0 Compiler (Open Source Edition). 🦋

💅 DESCRIPTION 💅

It's the compiler for the F# language, version 3.0. That's the whole vibe. It takes your F# and it makes it go. ✨

🎀 SYNOPSIS 🎀

fsharpc [options...] file [file...]

like, options first, then as many files as your heart desires. no cap. 🫶

👑 OPTIONS 👑

🌸 OUTPUT FILES 🌸

  • --out:file, -o file — names your output file. that's it, that's the whole job. 💖
  • --target:exe — builds a console executable 🖥️
  • --target:winexe — builds a Windows executable 🪟
  • --target:library, -a — builds a library 📚
  • --target:module — builds a module that can be added to another assembly 🧩
  • --delaysign[+|-] — delay-signs the assembly using only the public portion of the strong name key 👀
  • --doc:file — writes the xmldoc of the assembly to the given file 📝
  • --keyfile:file — specifies a strong name key file 🔑
  • --keycontainer:string — specifies a strong name key container 🗝️
  • --platform:string — limits which platforms this code can run on: x86, Itanium, x64, anycpu32bitpreferred, or anycpu.

the default is anycpu. periodt.

  • --nooptimizationdata — only includes optimization information essential for implementing inlined constructs. it inhibits cross-module inlining but improves binary compatibility. it's giving tradeoff energy. ⚖️
  • --nointerfacedata — doesn't add a resource to the generated assembly containing F#-specific metadata 🙈
  • --sig:file — prints the inferred interface of the assembly to a file 🖨️

🍓 INPUT FILES 🍓

  • --reference:file, -r file — references an assembly 🔗

🧚 RESOURCES 🧚

  • --win32res:file — specifies a Win32 resource file (.res) 🗂️
  • --win32manifest:file — specifies a Win32 manifest file 📄
  • --nowin32manifest — do NOT include the default Win32 manifest 🚫
  • --resource:file[,string_name[,public|private]] — embeds the specified managed resource 📦
  • --linkresource:file[,string_name[,public|private]] — links the specified resource to this assembly 🪢

💜 CODE GENERATION 💜

  • --debug[+|-], -g — emits debug information 🐛
  • --debug:[full|pdbonly] — specifies debugging type: full, pdbonly. full is the default and enables attaching a debugger to a running program. main character debugger energy fr fr 🔍
  • --optimize[+|-], -O — enables optimizations ⚡
  • --tailcalls[+|-] — enables tailcalls 🌀
  • --crossoptimize[+|-] — enables cross-module optimizations 🌈

💀 ERRORS AND WARNINGS 💀

  • --warnaserror[+|-] — reports ALL warnings as errors. every single one. no survivors 😭
  • --warnaserror[+|-]:warn[;warn[;...]] — reports specific warnings as errors 🎯
  • --warn:n — sets a warning level (0-5) 📊
  • --nowarn:warn[;warn[;...]] — disables specific warning messages 🔇
  • --warnon:warn[;warn[;...]] — enables specific warnings that may be off by default 🔔
  • --consolecolors[+|-] — outputs warning and error messages in color 🌈 (yes bestie, the errors are pretty now)

🦋 LANGUAGE 🦋

  • --checked[+|-] — generates overflow checks 🧮
  • --define:string, -d string — defines conditional compilation symbols 🏷️
  • --mlcompatibility — ignores ML compatibility warnings 🤝

⭐ MISCELLANEOUS ⭐

  • --nologo — suppresses the compiler copyright message 🙊
  • --help, -? — displays this usage message 🆘

🔥 ADVANCED 🔥

  • --codepage:n — specifies the codepage used to read source files 🔤
  • --utf8output — outputs messages in UTF-8 encoding 🌍
  • --fullpaths — outputs messages with fully qualified paths 🛣️
  • --lib:dir[;dir[;...]], -I dir[;dir[;...]] — specifies a directory for the include path, which is used to resolve source files and assemblies 📁
  • --baseaddress:address — base address for the library to be built 🏠
  • --noframework — does not reference the default CLI assemblies by default 🚷
  • --standalone — statically links the F# library and all referenced DLLs that depend on it into the assembly being generated 🧷
  • --staticlink:assembly — statically links the given assembly and all referenced DLLs that depend on this assembly. use an assembly name e.g. mylib, not a DLL name. ⚠️ (like, actually, use the assembly name, not the DLL name — the manpage is being so serious about this)
bestie if you pass a DLL name here you're gonna have a bad time, the page literally says assembly name, ok? 💖
  • --resident — uses a resident background compilation service to improve compiler startup times 🏃♀️
  • --pdb:file — names the output debug file 🐞
  • --simpleresolution — resolves assembly references using directory-based rules rather than MSBuild resolution 🧭
  • --highentropyva[+|-] — enables high-entropy ASLR 🎲
  • --subsystemversion:string — specifies subsystem version of this assembly 🏗️

and that's the whole page, bestie. every flag, every default, every little detail — preserved with love, no cap. 💅

this was fsharpc 3.0.34, dated February 2014 — shoutout to the iconique FSHARPC(1) era, you ate and left no crumbs. 🫶✨🎀

📦 where this page comes from