Update year range in copyright notice of binutils files

[thirdparty/binutils-gdb.git] / gas / doc / c-tic6x.texi

diff --git a/gas/doc/c-tic6x.texi b/gas/doc/c-tic6x.texi
index 12d70ba774fcb1ab3ffff16349e452ebb724b1e3..7897094de1cd69c64791359ad1533ef07b2a23d1 100644 (file)
--- a/gas/doc/c-tic6x.texi
+++ b/gas/doc/c-tic6x.texi
@@ -1,4 +1,4 @@
-@c Copyright 2010 Free Software Foundation, Inc.
+@c Copyright (C) 2010-2024 Free Software Foundation, Inc.
 @c This is part of the GAS manual.
 @c For copying conditions, see the file as.texinfo.
 @c man end
@@ -28,7 +28,7 @@
 @c man begin OPTIONS
 @table @gcctabopt
 
-@cindex @code{-march=} command line option, TIC6X
+@cindex @code{-march=} command-line option, TIC6X
 @item -march=@var{arch}
 Enable (only) instructions from architecture @var{arch}.  By default,
 all instructions are permitted.
@@ -36,22 +36,8 @@ all instructions are permitted.
 The following values of @var{arch} are accepted: @code{c62x},
 @code{c64x}, @code{c64x+}, @code{c67x}, @code{c67x+}, @code{c674x}.
 
-@cindex @code{-matomic} command line option, TIC6X
-@cindex @code{-mno-atomic} command line option, TIC6X
-@item -matomic
-@itemx -mno-atomic
-Enable or disable the optional C64x+ atomic operation instructions.
-By default, they are enabled if no @option{-march} option is given, or
-if an architecture is specified with @option{-march} that implies
-these instructions are present (currently, there are no such
-architectures); they are disabled if an architecture is specified with
-@option{-march} on which the instructions are optional or not
-present.  This option overrides such a default from the architecture,
-independent of the order in which the @option{-march} or
-@option{-matomic} or @option{-mno-atomic} options are passed.
-
-@cindex @code{-mdsbt} command line option, TIC6X
-@cindex @code{-mno-dsbt} command line option, TIC6X
+@cindex @code{-mdsbt} command-line option, TIC6X
+@cindex @code{-mno-dsbt} command-line option, TIC6X
 @item -mdsbt
 @itemx -mno-dsbt
 The @option{-mdsbt} option causes the assembler to generate the
@@ -61,7 +47,7 @@ default, causes the tag to have a value of 0, indicating that the code
 does not use DSBT addressing.  The linker will emit a warning if
 objects of different type (DSBT and non-DSBT) are linked together.
 
-@cindex @code{-mpid=} command line option, TIC6X
+@cindex @code{-mpid=} command-line option, TIC6X
 @item -mpid=no
 @itemx -mpid=near
 @itemx -mpid=far
@@ -75,8 +61,8 @@ addressing with GOT accesses using far DP addressing.  The linker will
 emit a warning if objects built with different settings of this option
 are linked together.
 
-@cindex @code{-mpic} command line option, TIC6X
-@cindex @code{-mno-pic} command line option, TIC6X
+@cindex @code{-mpic} command-line option, TIC6X
+@cindex @code{-mno-pic} command-line option, TIC6X
 @item -mpic
 @itemx -mno-pic
 The @option{-mpic} option causes the assembler to generate the
@@ -107,7 +93,10 @@ little-endian.
 The presence of a @samp{;} on a line indicates the start of a comment
 that extends to the end of the current line.  If a @samp{#} or
 @samp{*} appears as the first character of a line, the whole line is
-treated as a comment.
+treated as a comment.  Note that if a line starts with a @samp{#}
+character then it can also be a logical line number directive
+(@pxref{Comments}) or a preprocessor control command
+(@pxref{Preprocessing}).
 
 @cindex line separator, TIC6X
 @cindex statement separator, TIC6X
@@ -142,12 +131,13 @@ subsequent directive overriding it.
 @item .arch @var{arch}
 This has the same effect as @option{-march=@var{arch}}.
 
-@cindex @code{.atomic} directive, TIC6X
-@cindex @code{.noatomic} directive, TIC6X
-@item .atomic
-@itemx .noatomic
-These have the same effects as @option{-matomic} and
-@option{-mno-atomic}.
+@cindex @code{.cantunwind} directive, TIC6X
+@item .cantunwind
+Prevents unwinding through the current function.  No personality routine
+or exception table data is required or permitted.
+
+If this is not specified then frame unwinding information will be
+constructed from CFI directives. @pxref{CFI directives}.
 
 @cindex @code{.c6xabi_attribute} directive, TIC6X
 @item .c6xabi_attribute @var{tag}, @var{value}
@@ -164,9 +154,42 @@ The @var{tag} is either an attribute number or one of
 @var{value} is either a @code{number}, @code{"string"}, or
 @code{number, "string"} depending on the tag.
 
+@cindex @code{.ehtype} directive, TIC6X
+@item .ehtype @var{symbol}
+Output an exception type table reference to @var{symbol}.
+
+@cindex @code{.endp} directive, TIC6X
+@item .endp
+Marks the end of and exception table or function.  If preceded by a
+@code{.handlerdata} directive then this also switched back to the previous
+text section.
+
+@cindex @code{.handlerdata} directive, TIC6X
+@item .handlerdata
+Marks the end of the current function, and the start of the exception table
+entry for that function.  Anything between this directive and the
+@code{.endp} directive will be added to the exception table entry.
+
+Must be preceded by a CFI block containing a @code{.cfi_lsda} directive.
+
 @cindex @code{.nocmp} directive, TIC6X
 @item .nocmp
 Disallow use of C64x+ compact instructions in the current text
 section.
 
+@cindex @code{.personalityindex} directive, TIC6X
+@item .personalityindex @var{index}
+Sets the personality routine for the current function to the ABI specified
+compact routine number @var{index}
+
+@cindex @code{.personality} directive, TIC6X
+@item .personality @var{name}
+Sets the personality routine for the current function to @var{name}.
+
+@cindex @code{.scomm} directive, TIC6X
+@item .scomm @var{symbol}, @var{size}, @var{align}
+Like @code{.comm}, creating a common symbol @var{symbol} with size @var{size}
+and alignment @var{align}, but unlike when using @code{.comm}, this symbol
+will be placed into the small BSS section by the linker.
+
 @end table