Compiler Options (F#)

This topic describes compiler command-line options for the F# compiler, fsc.exe. The compilation environment can also be controlled by setting the project properties.

Compiler Options Listed Alphabetically

The following table shows compiler options listed alphabetically. Some of the F# compiler options are similar to the C# compiler options. If that is the case, a link to the C# compiler options topic is given.

Compiler Option	Description
-a <output-filename>	Used to generate a library and specify its filename. This option is a short form of --target:library <filename>.
--baseaddress:<string>	Used to specify the base address of the library to be built. This compiler option is equivalent to the C# compiler option of the same name. For more information, see /baseaddress (C# Compiler Options).
--codepage:<int>	Used to specify the codepage used to read source files. This compiler option is equivalent to the C# compiler option of the same name. For more information, see /codepage (C# Compiler Options).
--crossoptimize[+|-]	Enable or disable cross-module optimizations.
--delaysign[+|-]	Used to delay-sign the assembly using only the public portion of the strong name key This compiler option is equivalent to the C# compiler option of the same name. For more information, see /delaysign (C# Compiler Options).
--checked[+|-]	Used to enable or disable generation of overflow checks. This compiler option is equivalent to the C# compiler option of the same name. For more information, see /checked (C# Compiler Options).
--debug[+|-] -g[+|-] --debug:[full|pdbonly] -g: [full|pdbonly]	Used to enable or disable the generation of debug information, or to specify the type of debug information to generate. The default is full, which allows attaching to a running program. Choose pdbonly to get limited debugging information stored in a pdb (program database) file. This compiler option is equivalent to the C# compiler option of the same name. For more information, see /debug (C# Compiler Options).
--define:<string> -d:<string>	Used to define a symbol for use in conditional compilation.
--doc:<xmldoc-filename>	Used to instruct the compiler generate XML documentation comments to the file specified. For more information, see XML Documentation (F#). This compiler option is equivalent to the C# compiler option of the same name. For more information, see /doc (C# Compiler Options).
--fullpaths	Used to instruct the compiler to generate fully qualified paths. This compiler option is equivalent to the C# compiler option of the same name. For more information, see /fullpaths (C# Compiler Options).
--help -?	Used to display usage information, including a brief description of all the compiler options.
--keycontainer:<string>	Used to specify a strong name key container.
--keyfile:<filename>	Used to specify the name of a public key file to use to sign the generated assembly.
--lib:<folder-name> -I:<folder-name>	Used to specify a directory to be searched for assemblies that are referenced. This compiler option is equivalent to the C# compiler option of the same name. For more information, see /lib (C# Compiler Options)
--linkresource:<resource-info>	Used to link a specified resource to the assembly. The format of resource-info is filename[,name[,public|private]] Linking a single resource with this option is an alternative to embedded an entire resource file with the --resource option. This compiler option is equivalent to the C# compiler option of the same name. For more information, see /linkresource (C# Compiler Options).
--mlcompatibility	Used to ignore warnings that appear when you use features that are designed for compatibility with other versions of ML.
--noframework	Used to disable the default reference to the .NET Framework assembly.
--nointerfacedata	Used to instruct the compiler to omit the resource it normally adds to an assembly that includes F#-specific metadata.
--nologo	Don't show the banner text when launching the compiler.
--nooptimizationdata	Used to instruct the compiler to only include optimization essential for implementing inlined constructs. Inhibits cross-module inlining but improves binary compatibility.
--nowin32manifest	Used to instruct the compiler to omit the default Win32 manifest.
--nowarn:<int-list>	Disable specific warnings listed by number. Separate each warning number by a comma. You can discover the warning number for any warning from the compilation output. This compiler option is equivalent to the C# compiler option of the same name. For more information, see /nowarn (C# Compiler Options).
--optimize[+|-] [<string-list>] -O[+|-] [<string-list>]	Used to enable or disable optimizations. Some optimization options can be disabled or enabled selectively by listing them. These are: nojitoptimize, nojittracking, nolocaloptimize, nocrossoptimize, notailcalls.
--out:<output-filename> -o:<output-filename>	Used to specify the name of the compiled assembly or module. This compiler option is equivalent to the C# compiler option of the same name. For more information, see /out (C# Compiler Options).
--pdb:<pdb-filename>	Name the output debug PDB (program database) file. This option only applies when --debug is also enabled. This compiler option is equivalent to the C# compiler option of the same name. For more information, see /pdb (C# Compiler Options).
--platform:<platform-name>	Used to specify that the generated code will only run on the specified platform (x86, Itanium, or x64), or, if the platform-name anycpu is chosen, specifies that the generated code can run on any platform. This compiler option is equivalent to the C# compiler option of the same name. For more information, see /platform (C# Compiler Options).
--reference:<assembly-filename> -r <assembly-filename>	Used to make code from an F# or .NET assembly available to the code being compiled. This compiler option is equivalent to the C# compiler option of the same name. For more information, see /reference (C# Compiler Options).
--resource:<resource-filename>	Used to embed a managed resource file into the generated assembly. This compiler option is equivalent to the C# compiler option of the same name. For more information, see /resource (C# Compiler Options).
--sig:<signature-filename>	Used to generate a signature file based on the generated assembly. For more information about signature files, see Signatures (F#).
--simpleresolution	Used to specify that assembly references should be resolved using directory-based Mono rules rather than MSBuild resolution. The default is to use MSBuild resolution except when running under Mono.
--standalone	Specifies to statically link the F# library and all referenced DLLs that the code being compiled depends on into the assembly being generated.
--staticlink:<assembly-name>	Used to statically link the given assembly and all referenced DLLs that depend on this assembly. Use the assembly name, not the DLL name.
--tailcalls[+|-]	Enable or disable the use of the tail IL instruction, which causes the stack frame to be reused for tail recursive functions. This option is enabled by default.
--target:[exe | winexe | library | module ] <output-filename>	Used to specify the type and file name of the generated compiled code. exe means a console application winexe means a Windows application, which differs from the console application in that it does not have standard input/output streams (stdin, stdout, and stderr) defined library is an assembly without an entry point module is a .NET module (.netmodule), which can later be combined with other modules into an assembly This compiler option is equivalent to the C# compiler option of the same name. For more information, see /target (C# Compiler Options).
--times	Display timing information for compilation.
--utf8output	Used to enable printing compiler output in the UTF-8 encoding.
--warn:<warning-level>	Set a warning level (0 to 4). Each warning is given a level based on its severity. Level 4 gives more, but less severe, warnings, than level 0. This compiler option is equivalent to the C# compiler option of the same name. For more information, see /warn (C# Compiler Options).
--warnaserror[+|-] [<int-list>]	Used to enable or disable the option to report warnings as errors. You can provide specific warning numbers to be disabled or enabled. This compiler option is equivalent to the C# compiler option of the same name. For more information, see /warnaserror (C# Compiler Options).
--win32res:resource-filename	Used to add a Win32 resource file to the compilation. This compiler option is equivalent to the C# compiler option of the same name. For more information, see /win32res (C# Compiler Options).

Related Topics

Title	Description
F# Interactive Options	Describes command-line options supported by the F# interpreter, fsi.exe.
Projects, User Interface Elements	Describes the UI for projects, including project property pages that provide build options.