]> git.ipfire.org Git - thirdparty/binutils-gdb.git/commitdiff
gas: improve --gsframe documentation
authorSam James <sam@gentoo.org>
Wed, 16 Jul 2025 05:59:14 +0000 (06:59 +0100)
committerSam James <sam@gentoo.org>
Wed, 16 Jul 2025 08:10:12 +0000 (09:10 +0100)
I omitted documentation in 8aad677a12832885acd5be1de8f41e740b8e713d in
error. Rectify that with:
1) changing ---help to mention bare `--gsframe` too, as we're not
   getting rid of that;

2) adding the new --gsframe=[no|yes] form to as.texi.

PR gas/33125
* gas/as.c (parse_args): Tweak --gsframe= help text.
* gas/doc/as.texi: Document --gsframe=[no|yes].

gas/as.c
gas/doc/as.texi

index acdf6bb74fd5499cf8876921a92bc867e6e1802c..bc38cdf93c45f1c14ef249599fc1182433f841ea 100644 (file)
--- a/gas/as.c
+++ b/gas/as.c
@@ -311,7 +311,7 @@ Options:\n\
   fprintf (stream, _("\
                           generate GNU Build notes if none are present in the input\n"));
   fprintf (stream, _("\
-  --gsframe=[no|yes]      whether to generate SFrame stack trace information\n\
+  --gsframe[={no|yes}]    whether to generate SFrame stack trace information\n\
                           (default: no)\n"));
 # if defined (TARGET_USE_SCFI) && defined (TARGET_USE_GINSN)
   fprintf (stream, _("\
index 70c25405f874766b932b2c142492bc981fa0ab8b..1cb1fd879a44d6b35ebd0b20900b1658cc0a7a02 100644 (file)
@@ -240,7 +240,7 @@ gcc(1), ld(1), and the Info entries for @file{binutils} and @file{ld}.
  [@b{--gdwarf-<N>}] [@b{--gdwarf-sections}]
  [@b{--gdwarf-cie-version}=@var{VERSION}]
  [@b{--generate-missing-build-notes=[no|yes]}]
- [@b{--gsframe}]
+ [@b{--gsframe}] [@b{--gsframe=[no|yes]}]
  [@b{--hash-size}=@var{N}]
  [@b{--help}] [@b{--target-help}]
  [@b{--info}] [@b{--no-info}]
@@ -860,7 +860,11 @@ configure option.
 
 @item --gsframe
 @itemx --gsframe
-Create @var{.sframe} section from CFI directives.
+@itemx --gsframe=no
+@itemx --gsframe=yes
+Create @var{.sframe} section from CFI directives.  The explicit
+@option{--gsframe=yes} option behaves the same as @option{--gsframe}.
+Generation can be suppressed with @option{--gsframe=no}.
 
 @end ifset