* [PATCH] doc: Document -fasm as the opposite of -fno-asm
@ 2024-07-01 9:37 Alejandro Colomar
2024-07-01 10:40 ` Jakub Jelinek
2024-07-02 9:54 ` Georg-Johann Lay
0 siblings, 2 replies; 4+ messages in thread
From: Alejandro Colomar @ 2024-07-01 9:37 UTC (permalink / raw)
To: gcc-patches; +Cc: Alejandro Colomar
[-- Attachment #1: Type: text/plain, Size: 1247 bytes --]
gcc/ChangeLog:
* doc/invoke.texi: Document -fasm.
Signed-off-by: Alejandro Colomar <alx@kernel.org>
---
gcc/doc/invoke.texi | 6 +++---
1 file changed, 3 insertions(+), 3 deletions(-)
diff --git a/gcc/doc/invoke.texi b/gcc/doc/invoke.texi
index 30c4b002d1f..2d55f2715b3 100644
--- a/gcc/doc/invoke.texi
+++ b/gcc/doc/invoke.texi
@@ -198,7 +198,7 @@ in the following sections.
@item C Language Options
@xref{C Dialect Options,,Options Controlling C Dialect}.
@gccoptlist{-ansi -std=@var{standard} -aux-info @var{filename}
--fno-asm
+-f@r{[}no-@r{]}asm
-fno-builtin -fno-builtin-@var{function} -fcond-mismatch
-ffreestanding -fgimple -fgnu-tm -fgnu89-inline -fhosted
-flax-vector-conversions -fms-extensions
@@ -2600,8 +2600,8 @@ comments, after the declaration.
@opindex fno-asm
@opindex fasm
-@item -fno-asm
-Do not recognize @code{asm}, @code{inline} or @code{typeof} as a
+@item -f@r{[}no-@r{]}asm
+Do (or do not) recognize @code{asm}, @code{inline} or @code{typeof} as a
keyword, so that code can use these words as identifiers. You can use
the keywords @code{__asm__}, @code{__inline__} and @code{__typeof__}
instead. In C, @option{-ansi} implies @option{-fno-asm}.
--
2.45.2
[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]
^ permalink raw reply [flat|nested] 4+ messages in thread
* Re: [PATCH] doc: Document -fasm as the opposite of -fno-asm
2024-07-01 9:37 [PATCH] doc: Document -fasm as the opposite of -fno-asm Alejandro Colomar
@ 2024-07-01 10:40 ` Jakub Jelinek
2024-07-01 10:44 ` Alejandro Colomar
2024-07-02 9:54 ` Georg-Johann Lay
1 sibling, 1 reply; 4+ messages in thread
From: Jakub Jelinek @ 2024-07-01 10:40 UTC (permalink / raw)
To: Alejandro Colomar; +Cc: gcc-patches
On Mon, Jul 01, 2024 at 11:37:40AM +0200, Alejandro Colomar wrote:
> gcc/ChangeLog:
>
> * doc/invoke.texi: Document -fasm.
Why? We have almost 1300 options which accept the negative forms
and we don't document any of them this way, the manual explicitly states
that:
Many options have long names starting with @samp{-f} or with
@samp{-W}---for example,
@option{-fmove-loop-invariants}, @option{-Wformat} and so on. Most of
these have both positive and negative forms; the negative form of
@option{-ffoo} is @option{-fno-foo}. This manual documents
only one of these two forms, whichever one is not the default.
> Signed-off-by: Alejandro Colomar <alx@kernel.org>
> ---
> gcc/doc/invoke.texi | 6 +++---
> 1 file changed, 3 insertions(+), 3 deletions(-)
>
> diff --git a/gcc/doc/invoke.texi b/gcc/doc/invoke.texi
> index 30c4b002d1f..2d55f2715b3 100644
> --- a/gcc/doc/invoke.texi
> +++ b/gcc/doc/invoke.texi
> @@ -198,7 +198,7 @@ in the following sections.
> @item C Language Options
> @xref{C Dialect Options,,Options Controlling C Dialect}.
> @gccoptlist{-ansi -std=@var{standard} -aux-info @var{filename}
> --fno-asm
> +-f@r{[}no-@r{]}asm
> -fno-builtin -fno-builtin-@var{function} -fcond-mismatch
> -ffreestanding -fgimple -fgnu-tm -fgnu89-inline -fhosted
> -flax-vector-conversions -fms-extensions
> @@ -2600,8 +2600,8 @@ comments, after the declaration.
>
> @opindex fno-asm
> @opindex fasm
> -@item -fno-asm
> -Do not recognize @code{asm}, @code{inline} or @code{typeof} as a
> +@item -f@r{[}no-@r{]}asm
> +Do (or do not) recognize @code{asm}, @code{inline} or @code{typeof} as a
> keyword, so that code can use these words as identifiers. You can use
> the keywords @code{__asm__}, @code{__inline__} and @code{__typeof__}
> instead. In C, @option{-ansi} implies @option{-fno-asm}.
> --
> 2.45.2
>
Jakub
^ permalink raw reply [flat|nested] 4+ messages in thread
* Re: [PATCH] doc: Document -fasm as the opposite of -fno-asm
2024-07-01 10:40 ` Jakub Jelinek
@ 2024-07-01 10:44 ` Alejandro Colomar
0 siblings, 0 replies; 4+ messages in thread
From: Alejandro Colomar @ 2024-07-01 10:44 UTC (permalink / raw)
To: Jakub Jelinek; +Cc: gcc-patches
[-- Attachment #1: Type: text/plain, Size: 2154 bytes --]
On Mon, Jul 01, 2024 at 12:40:45PM GMT, Jakub Jelinek wrote:
> On Mon, Jul 01, 2024 at 11:37:40AM +0200, Alejandro Colomar wrote:
> > gcc/ChangeLog:
> >
> > * doc/invoke.texi: Document -fasm.
>
> Why? We have almost 1300 options which accept the negative forms
> and we don't document any of them this way, the manual explicitly states
> that:
>
> Many options have long names starting with @samp{-f} or with
> @samp{-W}---for example,
> @option{-fmove-loop-invariants}, @option{-Wformat} and so on. Most of
> these have both positive and negative forms; the negative form of
> @option{-ffoo} is @option{-fno-foo}. This manual documents
> only one of these two forms, whichever one is not the default.
Ahh; hadn't seen that. Thanks!
>
> > Signed-off-by: Alejandro Colomar <alx@kernel.org>
> > ---
> > gcc/doc/invoke.texi | 6 +++---
> > 1 file changed, 3 insertions(+), 3 deletions(-)
> >
> > diff --git a/gcc/doc/invoke.texi b/gcc/doc/invoke.texi
> > index 30c4b002d1f..2d55f2715b3 100644
> > --- a/gcc/doc/invoke.texi
> > +++ b/gcc/doc/invoke.texi
> > @@ -198,7 +198,7 @@ in the following sections.
> > @item C Language Options
> > @xref{C Dialect Options,,Options Controlling C Dialect}.
> > @gccoptlist{-ansi -std=@var{standard} -aux-info @var{filename}
> > --fno-asm
> > +-f@r{[}no-@r{]}asm
> > -fno-builtin -fno-builtin-@var{function} -fcond-mismatch
> > -ffreestanding -fgimple -fgnu-tm -fgnu89-inline -fhosted
> > -flax-vector-conversions -fms-extensions
> > @@ -2600,8 +2600,8 @@ comments, after the declaration.
> >
> > @opindex fno-asm
> > @opindex fasm
> > -@item -fno-asm
> > -Do not recognize @code{asm}, @code{inline} or @code{typeof} as a
> > +@item -f@r{[}no-@r{]}asm
> > +Do (or do not) recognize @code{asm}, @code{inline} or @code{typeof} as a
> > keyword, so that code can use these words as identifiers. You can use
> > the keywords @code{__asm__}, @code{__inline__} and @code{__typeof__}
> > instead. In C, @option{-ansi} implies @option{-fno-asm}.
> > --
> > 2.45.2
> >
>
>
>
> Jakub
>
--
<https://www.alejandro-colomar.es/>
[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]
^ permalink raw reply [flat|nested] 4+ messages in thread
* Re: [PATCH] doc: Document -fasm as the opposite of -fno-asm
2024-07-01 9:37 [PATCH] doc: Document -fasm as the opposite of -fno-asm Alejandro Colomar
2024-07-01 10:40 ` Jakub Jelinek
@ 2024-07-02 9:54 ` Georg-Johann Lay
1 sibling, 0 replies; 4+ messages in thread
From: Georg-Johann Lay @ 2024-07-02 9:54 UTC (permalink / raw)
To: Alejandro Colomar, gcc-patches
Am 01.07.24 um 11:37 schrieb Alejandro Colomar:
> gcc/ChangeLog:
>
> * doc/invoke.texi: Document -fasm.
>
> Signed-off-by: Alejandro Colomar <alx@kernel.org>
> ---
> gcc/doc/invoke.texi | 6 +++---
> 1 file changed, 3 insertions(+), 3 deletions(-)
>
> diff --git a/gcc/doc/invoke.texi b/gcc/doc/invoke.texi
> index 30c4b002d1f..2d55f2715b3 100644
> --- a/gcc/doc/invoke.texi
> +++ b/gcc/doc/invoke.texi
> @@ -198,7 +198,7 @@ in the following sections.
> @item C Language Options
> @xref{C Dialect Options,,Options Controlling C Dialect}.
> @gccoptlist{-ansi -std=@var{standard} -aux-info @var{filename}
> --fno-asm
> +-f@r{[}no-@r{]}asm
> -fno-builtin -fno-builtin-@var{function} -fcond-mismatch
> -ffreestanding -fgimple -fgnu-tm -fgnu89-inline -fhosted
> -flax-vector-conversions -fms-extensions
> @@ -2600,8 +2600,8 @@ comments, after the declaration.
>
> @opindex fno-asm
> @opindex fasm
> -@item -fno-asm
> -Do not recognize @code{asm}, @code{inline} or @code{typeof} as a
> +@item -f@r{[}no-@r{]}asm
> +Do (or do not) recognize @code{asm}, @code{inline} or @code{typeof} as a
> keyword, so that code can use these words as identifiers. You can use
> the keywords @code{__asm__}, @code{__inline__} and @code{__typeof__}
Also __asm can be used?
Johann
> instead. In C, @option{-ansi} implies @option{-fno-asm}.
^ permalink raw reply [flat|nested] 4+ messages in thread
end of thread, other threads:[~2024-07-02 9:54 UTC | newest]
Thread overview: 4+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2024-07-01 9:37 [PATCH] doc: Document -fasm as the opposite of -fno-asm Alejandro Colomar
2024-07-01 10:40 ` Jakub Jelinek
2024-07-01 10:44 ` Alejandro Colomar
2024-07-02 9:54 ` Georg-Johann Lay
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).