File 0384-erts-Move-doc-since-after-option-descriptions.patch of Package erlang
From 10d9d735a8faf1813e94314775b307669dfc5d04 Mon Sep 17 00:00:00 2001
From: Wojtek Mach <wojtek@wojtekmach.pl>
Date: Wed, 26 Feb 2025 11:22:41 +0100
Subject: [PATCH 2/2] erts: Move doc since after option descriptions
---
erts/doc/references/erl_cmd.md | 21 +++++++++++++--------
erts/preloaded/src/erlang.erl | 15 ++++++++-------
2 files changed, 21 insertions(+), 15 deletions(-)
diff --git a/erts/doc/references/erl_cmd.md b/erts/doc/references/erl_cmd.md
index 0053afd2b2..3991175229 100644
--- a/erts/doc/references/erl_cmd.md
+++ b/erts/doc/references/erl_cmd.md
@@ -705,7 +705,7 @@ behavior of earlier flags.
scheduling latency for individual file descriptor input events.
- **`+JPcover true|false|function|function_counters|line|line_counters`{:
- #+JPcover }** - Since: OTP 27.0
+ #+JPcover }**
Enables or disables support for coverage when running with the JIT. Defaults
to false.
@@ -742,6 +742,8 @@ behavior of earlier flags.
- **`false`** - Disables coverage.
+ Since: OTP 27.0
+
- **`+JPperf true|false|dump|map|fp|no_fp`{: #+JPperf }** - Enables or disables
support for the `perf` profiler when running with the JIT on Linux. Defaults
to false.
@@ -768,15 +770,17 @@ behavior of earlier flags.
[perf support](BeamAsm.md#linux-perf-support) section in the BeamAsm internal
documentation.
-- **`+JMsingle true|false`{: #+JMsingle }** - Since: OTP-26.0
+- **`+JMsingle true|false`{: #+JMsingle }** - Enables or disables the use of
+ single-mapped RWX memory for JIT code.
- Enables or disables the use of single-mapped RWX memory for JIT code. The
- default is to map JIT:ed machine code into two regions sharing the same
+ The default is to map JIT:ed machine code into two regions sharing the same
physical pages, where one region is executable but not writable, and the other
writable but not executable. As some tools, such as QEMU user mode emulation,
cannot deal with the dual mapping, this flags allows it to be disabled. This
flag is automatically enabled by the [`+JPperf`](#%2BJPperf) flag.
+ Since: OTP 26.0
+
- **`+L`** - Prevents loading information about source filenames and line
numbers. This saves some memory, but exceptions do not contain information
about the filenames and line numbers.
@@ -784,16 +788,17 @@ behavior of earlier flags.
- **`+MFlag Value`{: #erts_alloc }** - Memory allocator-specific flags. For more
information, see [`erts_alloc(3)`](erts_alloc.md).
-- **`+pad true|false`{: #+pad }** - Since: OTP 25.3
+- **`+pad true|false`{: #+pad }** - The boolean value used with the `+pad`
+ parameter determines the default value of the [`async_dist`](`m:erlang#process_flag_async_dist`) process flag of newly spawned processes.
- The boolean value used with the `+pad` parameter determines the default value
- of the [`async_dist`](`m:erlang#process_flag_async_dist`) process flag of
- newly spawned processes. By default, if no `+pad` command line option is
+ By default, if no `+pad` command line option is
passed, the `async_dist` flag will be set to `false`.
The value used in runtime can be inspected by calling
[`erlang:system_info(async_dist)`](`m:erlang#system_info_async_dist`).
+ Since: OTP 25.3
+
- **[](){: #%2Bpc } `+pc Range`{: #printable_character_range }** -
Sets the range of characters that the system considers printable in heuristic
detection of strings. This typically affects the shell, debugger, and
diff --git a/erts/preloaded/src/erlang.erl b/erts/preloaded/src/erlang.erl
index 443e3cf753..b1a38875ef 100644
--- a/erts/preloaded/src/erlang.erl
+++ b/erts/preloaded/src/erlang.erl
@@ -7992,10 +7992,10 @@ Reference Manual_.
Valid `InfoTuple`s with corresponding `Item`s:
-- **`{async_dist, Enabled}`{: #process_info_async_dist }** - Since: OTP 25.3
+- **`{async_dist, Enabled}`{: #process_info_async_dist }** - Current value of the
+ [`async_dist`](#process_flag_async_dist) process flag.
- Current value of the [`async_dist`](#process_flag_async_dist)
- process flag.
+ Since: OTP 25.3
- **`{backtrace, Bin}`** - Binary `Bin` contains the same information as the
output from `erlang:process_display(Pid, backtrace)`. Use
@@ -10476,11 +10476,12 @@ Options:
information, see the documentation of
[`process_flag(message_queue_data, MQD)`](#process_flag_message_queue_data).
-- **`{async_dist, Enabled}`{: #spawn_opt_async_dist }** - Since: OTP 25.3
+- **`{async_dist, Enabled}`{: #spawn_opt_async_dist }** - Sets the
+ [`async_dist`](#process_flag_async_dist) process flag of the spawned process.
+ This option will override the default value set by the command line argument
+ [`+pad <boolean>`](erl_cmd.md#%2Bpad).
- Set the [`async_dist`](#process_flag_async_dist) process flag of the
- spawned process. This option will override the default value set by the
- command line argument [`+pad <boolean>`](erl_cmd.md#%2Bpad).
+ Since: OTP 25.3
""".
-doc #{ group => processes }.
-spec spawn_opt(Module, Function, Args, Options) ->
--
2.43.0