FORTLS(1)

📦
version 3.2.2 · 6 versions
, in debian trixie, ubuntu questing

💅 FORTLS — bestie edition

okay so this is fortls, the Fortran Language Server for the Language Server Protocol, and it lives in section 1 of the manual (User Commands, iykyk). it's giving "your editor but it actually understands Fortran" and honestly? we're obsessed. 🦋

✨ NAME ✨

fortls — Fortran Language Server for the Language Server Protocol 💖

🎀 DESCRIPTION 🎀

the vibe:

usage: fortls [options] [debug options]

fortls — Fortran Language Server ✨ that's it, that's the whole thing. it's a language server. it speaks Fortran. it's iconic. 👑

🌸 options: 🌸

  • -h, --help — shows this help message and dips out. short and sweet, we love a queen who knows when to leave 🫶
  • -v, --version — prints the server version number and exits. no notes 💅
  • -c, --config CONFIG — the configuration options file. default file name is .fortlsrc, and the other default supported names are .fortls.json and .fortls (and if you wanna get fancy with other names/paths, that's what -c / --config are for) 🎀
  • -n, --nthreads INTEGER — how many threads to use while the workspace is initializing. default is 4. yes bestie, parallelize her 💅
  • --notify_init — sends a notification message when workspace initialization is complete. like a little "i'm done!! ✨" text
  • --incremental_sync — uses incremental document synchronization. it's beta, so act accordingly 😭
  • --recursion_limit INTEGER — sets the maximum recursion depth for the parser. default is 1000. we're going deep, no cap 🌀
  • --sort_keywords — displays variable keywords information, function/subroutine definitions, etc. in a consistent (sorted) manner. default: no sorting, display code as is. pick your fighter ✨
  • --disable_autoupdate — fortls automatically checks PyPi for newer versions and installs them. use this option to disable the autoupdate feature. (yes, it really does that unprompted. main character energy fr) 🙈
  • --preserve_keyword_order — DEPRECATED, this is now the default. to sort, use sort_keywords. she's retired but we still respect her 💀
  • --debug_log — generates a debug log in the project root folder 📝
  • --debug_help — displays options for debugging fortls 🐛

🦋 Sources file parsing options: 🦋

  • --source_dirs [DIRS ...] — folders containing source files. default: set(). empty set, empty heart 🥲
  • --incl_suffixes [SUFFIXES ...] — consider additional file extensions on top of the defaults. default: .F, .F77, .F90, .F95, .F03, .F08, .FOR, .FPP (lower & upper casing, she's bilingual 💅)
  • --excl_suffixes [SUFFIXES ...] — source file extensions to be excluded. default: set() ✋
  • --excl_paths [DIRS ...] — folders to exclude from parsing. not today, thank you 💖

🌈 Autocomplete options: 🌈

  • --autocomplete_no_prefix — do not filter autocomplete results by variable prefix
  • --autocomplete_no_snippets — do not use snippets with place holders in autocomplete results
  • --autocomplete_name_only — complete only the name of procedures and not the parameters. names only, we're being mysterious ✨
  • --lowercase_intrinsics — use lowercase for intrinsics and keywords in autocomplete requests
  • --use_signature_help — use signature help instead of subroutine/function snippets. this effectively sets --autocomplete_no_snippets 🫶

💜 Hover options: 💜

  • --variable_hover — DEPRECATED: this option is always on. shows hover information for variables. she's permanently on, bestie, no toggle 😭
  • --hover_signature — shows signature information in hover for arguments ✨
  • --hover_language HOVER_LANGUAGE — the language used for responses to hover requests, a VSCode language id. default: fortran90 🎀

🍓 Diagnostic options (error swigles): 🍓

(yes the original says "swigles", we're keeping it, it's iconic)

  • --max_line_length INTEGER — maximum line length. default: -1 📏
  • --max_comment_line_length INTEGER — maximum comment line length. default: -1 💬
  • --disable_diagnostics — disables diagnostics. ignorance is bliss, lowkey 🚫

🧚 Preprocessor options: 🧚

  • --pp_suffixes [SUFFIXES ...] — file extensions to be parsed ONLY for preprocessor commands. default: all uppercase source file suffixes 🎀
  • --include_dirs [DIRS ...] — folders containing preprocessor files with extensions PP_SUFFIXES
  • --pp_defs JSON — a dictionary with additional preprocessor definitions. preprocessor definitions are normally included via INCLUDE_DIRS ✨

👑 Symbols options: 👑

  • --symbol_skip_mem — do not include type members in document symbol results. keep the members to yourself, mysterious queen 💅

💀 CodeActions options [limited]: 💀

  • --enable_code_actions — enable experimental code actions. default: false. experimental, so proceed with caution bestie 🙈
all options starting with -- can also be set in a configuration file, by default named .fortlsrc, .fortls.json or .fortls (other names/paths can be specified via -c or --config). for more details see our documentation: https://fortls.fortran-lang.org/options.html#available-options

🌸 okay that's the whole page, you ate that. this is fortls 3.2.2+dfsg, from March 2025, and yeah, the manual page is literally called FORTLS(1). go forth and hover, bestie 💖✨🦋

📦 where this page comes from