]> git.ipfire.org Git - thirdparty/gcc.git/commitdiff
doc, nvptx: Clean up documentation of Nvidia PTX Options [PR122243]
authorSandra Loosemore <sloosemore@baylibre.com>
Fri, 5 Dec 2025 17:07:31 +0000 (17:07 +0000)
committerSandra Loosemore <sloosemore@baylibre.com>
Sat, 13 Dec 2025 04:13:47 +0000 (04:13 +0000)
gcc/ChangeLog
PR other/122243
* doc/invoke.texi (Option Summary) <Nvidia PTX Options>: Add
several missing options.
(Nvidia PTX Options): Correct index entry for -march-map.  List
negative forms of -moptimize, muniform-simt, and -mgomp.  Fix some
Texinfo markup issues.

gcc/doc/invoke.texi

index 4d29875dc24ee109b63f45881f22c784d024637b..c2283d634e153f6771c086399fedcd535e34cd27 100644 (file)
@@ -1280,7 +1280,9 @@ Objective-C and Objective-C++ Dialects}.
 -mctor-dtor  -mrelax}
 
 @emph{Nvidia PTX Options} (@ref{Nvidia PTX Options})
-@gccoptlist{-m64  -mmainkernel  -moptimize}
+@gccoptlist{-m64  -march=@var{arch}  -misa=@var{arch}  -march-map=@var{arch}
+-mptx=@var{version}
+-mmainkernel  -moptimize  -msoft-stack  -muniform-simt  -mgomp}
 
 @emph{OpenRISC Options} (@ref{OpenRISC Options})
 @gccoptlist{-mboard=@var{name}  -mnewlib  -mhard-mul  -mhard-div
@@ -31515,7 +31517,7 @@ This option sets the value of the preprocessor macro
 @item -misa=@var{architecture-string}
 Alias of @option{-march=}.
 
-@opindex march
+@opindex march-map
 @item -march-map=@var{architecture-string}
 Select the closest available @option{-march=} value that is not more
 capable.  For instance, for @option{-march-map=sm_50} select
@@ -31546,9 +31548,11 @@ Link in code for a __main kernel.  This is for stand-alone instead of
 offloading execution.
 
 @opindex moptimize
+@opindex mno-optimize
 @item -moptimize
-Apply partitioned execution optimizations.  This is the default when any
-level of optimization is selected.
+@itemx -mno-optimize
+Enable/disable partitioned execution optimizations.  This option is enabled by
+default when any level of optimization is selected.
 
 @opindex msoft-stack
 @opindex mno-soft-stack
@@ -31574,11 +31578,15 @@ of testing the compiler; to generate code suitable for linking into programs
 using OpenMP offloading, use option @option{-mgomp}.
 
 @opindex muniform-simt
+@opindex mno-uniform-simt
 @item -muniform-simt
-Switch to code generation variant that allows to execute all threads in each
+@itemx -mno-uniform-simt
+Enable/disable code generation variant that allows execution of
+all threads in each
 warp, while maintaining memory state and side effects as if only one thread
 in each warp was active outside of OpenMP SIMD regions.  All atomic operations
-and calls to runtime (malloc, free, vprintf) are conditionally executed (iff
+and calls to runtime (@code{malloc}, @code{free}, @code{vprintf})
+are conditionally executed (iff
 current lane index equals the master lane index), and the register being
 assigned is copied via a shuffle instruction from the master lane.  Outside of
 SIMD regions lane 0 is the master; inside, each thread sees itself as the
@@ -31588,9 +31596,12 @@ regions).  Each thread can bitwise-and the bitmask at position @code{tid.y}
 with current lane index to compute the master lane index.
 
 @opindex mgomp
+@opindex mno-gomp
 @item -mgomp
-Generate code for use in OpenMP offloading: enables @option{-msoft-stack} and
-@option{-muniform-simt} options, and selects corresponding multilib variant.
+@itemx -mno-gomp
+Enable/disable generation of code for use in OpenMP offloading.
+@option{-mgomp} enables @option{-msoft-stack} and
+@option{-muniform-simt} options, and selects a corresponding multilib variant.
 
 @end table