On Tue, 4 Mar 2025, Wilco Dijkstra wrote:
> I've updated the documentation for -mcmodel=large so it's a little
> closer to reality.
:
> gcc:
> PR target/112465
> * config/aarch64/aarch64.cc (aarch64_override_options_after_change_1):
> Turn off outline atomics with -mcmodel=large.
> (initialize_aarch64_code_model): Report incompatible use of large
> model
> and outline atomics.
> * doc/invoke.texi (-mcmodel=large): Update description.
Here is a follow-up patch for the docs, which I just pushed.
Essentially elsewhere in these docs we mark up sections with @code{...}.
Gerald
commit 4ac9d5cb3e05e084ac4718c961abc035a532655f
Author: Gerald Pfeifer <[email protected]>
Date: Sat Oct 24 21:48:37 2026 +0200
doc: Improve markup for AArch64's -mcmodel=large
gcc:
* doc/invoke.texi (AArch64 Options): Improve markup
for -mcmodel=large.
diff --git a/gcc/doc/invoke.texi b/gcc/doc/invoke.texi
index 41824c4cf98..41be82cb8a5 100644
--- a/gcc/doc/invoke.texi
+++ b/gcc/doc/invoke.texi
@@ -21508,8 +21508,9 @@ dynamically linked. This is the default code model.
@opindex mcmodel=large
@item -mcmodel=large
-Generate code for the large code model. This allows large .bss and .data
-sections, however .text and .rodata must still be < 2GiB in total.
+Generate code for the large code model. This allows large @code{.bss}
+and @code{.data} sections, whereas @code{.text} and @code{.rodata}
+must still be < 2GiB in total.
The @option{-moutline-atomics} is turned off by default. Static linking
with small/tiny model object files is not supported.
