STDLIB(Application)

🎀 NAME 🎀

Okay so the name is STDLIB Application, and the manual page is STDLIB(Application) — brought to you by Ericsson AB. That's the header tea, bestie. 💖

💖 DESCRIPTION 💖

🌸 Description 🌸

The STDLIB application is mandatory in the sense that the minimal system based on Erlang/OTP consists of Kernel and STDLIB. The STDLIB application contains no services. Not a single one — it's giving backstage crew energy, and honestly we respect it. 💅

No services here, bestie. Zero. None. Periodt. ✨

✨ Configuration ✨

The following configuration parameters are defined for the STDLIB application. For more information about configuration parameters, see the app(4) module in Kernel. 🫶

• shell_esc = icl | abort — can be used to change the behavior of the Erlang shell when ^G is pressed (Ctrl+G, iykyk). 🎀
• restricted_shell = module() — can be used to run the Erlang shell in restricted mode. 🔒
• shell_catch_exception = boolean() — can be used to set the exception handling of the evaluator process of the Erlang shell. 🫧
• shell_docs_columns = pos_integer() — configures how wide the documentation should be rendered in the shell. See also shell_docs:config/0. 📚
• shell_expand_location = above | below — sets where the tab expansion text should appear in the shell. The default is below. This will open a pager below the cursor that is scrollable one line at a time with Up/Down arrow keys or 5 lines at a time with PgUp/PgDn. 🦋
• shell_history_length = integer() >= 0 — can be used to determine how many commands are saved by the Erlang shell. See edlin for more. 🧾
• shell_keymap = #{} — can be used to override the default keymap configuration for the shell. ⌨️
• format_shell_func = {Mod, Func} | string() | default — can be used to set the formatting of the Erlang shell output. This has an effect on commands that have been submitted and how it is saved in history or if the formatting hotkey is pressed while editing an expression (Alt+F by default). You can specify a Mod:Func/1 that expects the whole expression as a string and returns a formatted expression as a string. See shell:format_shell_func/1 for how to set it from inside the shell.

If instead a string is provided, it will be used as a shell command. Your command must include ${file} somewhere in the string, for the shell to know where the file goes in the command. Example vibes:

-stdlib format_shell_func "\"emacs -batch \${file} -l ~/erlang-format/emacs-format-file -f emacs-format-function\""

-stdlib format_shell_func "{shell, erl_pp_format_func}"

• shell_prompt_func = {Mod, Func} | default — can be used to set a customized Erlang shell prompt function, where:
  • Mod = atom()
  • Func = atom()
• shell_multiline_prompt = {Mod, Func} | string() | default — can be used to set a customized multiline shell prompt function, where:
  • Mod = atom()
  • Func = atom()

The multiline prompt function takes the main prompt as its only parameter. 🌈

• shell_saved_results = integer() >= 0 — can be used to determine how many results are saved by the Erlang shell. 💾
• shell_session_slogan = string() | fun() -> string()) — the slogan printed when starting an Erlang shell. Example:

$ erl -stdlib shell_session_slogan '"Test slogan"'
Erlang/OTP 26 [DEVELOPMENT] [erts-13.0.2] [source] [64-bit] [smp:8:8] [ds:8:8:10] [async-threads:1] [jit:ns]

Test slogan
1>

• shell_slogan = string() | fun(() -> string()) — the slogan printed when starting the Erlang shell subsystem. Example:

$ erl -stdlib shell_slogan '"Test slogan"'
Test slogan
Eshell V13.0.2  (abort with ^G)
1>

The default is the return value of erlang:system_info(system_version). ⭐

• shell_strings = boolean() — can be used to determine how the Erlang shell outputs lists of integers. 🔢
• shell_hints = boolean() — can be used to enable/disable printing of helpful hints in the shell. 💡

🦋 See Also 🦋

app(4), application, shell — go read those too, bestie. 🫶

---

💌 Cute little sign-off: this page is from stdlib 8.1, with the footer's 6 date/page marker, and it's STDLIB(Application). Periodt. 💅