Message ID | 767f8ddc835151d62ce825b8fe7b2ff7b4e3d2e6.camel@xry111.site |
---|---|
State | New |
Headers |
Return-Path: <gcc-patches-bounces+patchwork=sourceware.org@gcc.gnu.org> X-Original-To: patchwork@sourceware.org Delivered-To: patchwork@sourceware.org Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id 1E949385734D for <patchwork@sourceware.org>; Wed, 27 Jul 2022 07:07:46 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 1E949385734D DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gcc.gnu.org; s=default; t=1658905666; bh=wOjFjnXU2K2Q/4Qyg+nHUa1KEb76PWXevMSJW8R/HgE=; h=Subject:To:Date:List-Id:List-Unsubscribe:List-Archive:List-Post: List-Help:List-Subscribe:From:Reply-To:Cc:From; b=OL2e3G/3P8MJaBidOnlwKmFQxB9sVnlvOy4J0NhuSqIN0SUFmJjTZlz+oelv63UtZ dU6mXRF5mJIoE3ug6Y/yJE5EOHZrsjp4XA5x6UxuMm9E/Mv8KMRP3iG463jivWlFiN UPnT6wMivyWzJ+yzNlaAo4dWubZuMxsmAvWs6fUE= X-Original-To: gcc-patches@gcc.gnu.org Delivered-To: gcc-patches@gcc.gnu.org Received: from xry111.site (xry111.site [IPv6:2001:470:683e::1]) by sourceware.org (Postfix) with ESMTPS id 5A8D03857429 for <gcc-patches@gcc.gnu.org>; Wed, 27 Jul 2022 07:07:16 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.1 sourceware.org 5A8D03857429 Received: from [IPv6:240e:358:1119:7700:dc73:854d:832e:3] (unknown [IPv6:240e:358:1119:7700:dc73:854d:832e:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange ECDHE (P-256) server-signature ECDSA (P-384) server-digest SHA384) (Client did not present a certificate) (Authenticated sender: xry111@xry111.site) by xry111.site (Postfix) with ESMTPSA id AADA9667AD; Wed, 27 Jul 2022 03:07:09 -0400 (EDT) Message-ID: <767f8ddc835151d62ce825b8fe7b2ff7b4e3d2e6.camel@xry111.site> Subject: [PATCH] LoongArch: document -m[no-]explicit-relocs To: Lulu Cheng <chenglulu@loongson.cn>, gcc-patches@gcc.gnu.org Date: Wed, 27 Jul 2022 15:06:59 +0800 Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable User-Agent: Evolution 3.44.3 MIME-Version: 1.0 X-Spam-Status: No, score=-6.5 required=5.0 tests=BAYES_00, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, DKIM_VALID_EF, FROM_SUSPICIOUS_NTLD, FROM_SUSPICIOUS_NTLD_FP, GIT_PATCH_0, LIKELY_SPAM_FROM, PDS_OTHER_BAD_TLD, SPF_HELO_PASS, SPF_PASS, TXREP autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on server2.sourceware.org X-BeenThere: gcc-patches@gcc.gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Gcc-patches mailing list <gcc-patches.gcc.gnu.org> List-Unsubscribe: <https://gcc.gnu.org/mailman/options/gcc-patches>, <mailto:gcc-patches-request@gcc.gnu.org?subject=unsubscribe> List-Archive: <https://gcc.gnu.org/pipermail/gcc-patches/> List-Post: <mailto:gcc-patches@gcc.gnu.org> List-Help: <mailto:gcc-patches-request@gcc.gnu.org?subject=help> List-Subscribe: <https://gcc.gnu.org/mailman/listinfo/gcc-patches>, <mailto:gcc-patches-request@gcc.gnu.org?subject=subscribe> From: Xi Ruoyao via Gcc-patches <gcc-patches@gcc.gnu.org> Reply-To: Xi Ruoyao <xry111@xry111.site> Cc: xuchenghua@loongson.cn, Wang Xuerui <i@xen0n.name> Errors-To: gcc-patches-bounces+patchwork=sourceware.org@gcc.gnu.org Sender: "Gcc-patches" <gcc-patches-bounces+patchwork=sourceware.org@gcc.gnu.org> |
Series |
LoongArch: document -m[no-]explicit-relocs
|
|
Commit Message
Xi Ruoyao
July 27, 2022, 7:06 a.m. UTC
Document newly introduced -m[no-]explicit-relocs options. Ok for trunk? -- >8 -- gcc/ChangeLog: * doc/invoke.texi: Document -m[no-]explicit-relocs for LoongArch. --- gcc/doc/invoke.texi | 12 ++++++++++++ 1 file changed, 12 insertions(+)
Comments
Hi, On 2022/7/27 15:06, Xi Ruoyao wrote: > Document newly introduced -m[no-]explicit-relocs options. Ok for trunk? > > -- >8 -- > > gcc/ChangeLog: > > * doc/invoke.texi: Document -m[no-]explicit-relocs for > LoongArch. > --- > gcc/doc/invoke.texi | 12 ++++++++++++ > 1 file changed, 12 insertions(+) > > diff --git a/gcc/doc/invoke.texi b/gcc/doc/invoke.texi > index 9a3f2d14c5a..04418f80428 100644 > --- a/gcc/doc/invoke.texi > +++ b/gcc/doc/invoke.texi > @@ -24939,6 +24939,18 @@ global symbol: The data got table must be within +/-8EiB addressing space. > @end itemize > @end table > The default code model is @code{normal}. > + > +@item -mexplicit-relocs > +@itemx -mno-explicit-relocs > +@opindex mexplicit-relocs > +@opindex mno-explicit-relocs > +Generate (do not generate) explicit symbol relocations instead of > +assembler macros. Using explicit relocations can improve code generation. > +GCC detects the capaiblities of the assembler when it is built and sets > +the default to @code{-mexplicit-relocs} if the assembler supports the > +syntax for explicit specification of relocations, and > +@code{-mno-explicit-relocs} otherwise. This option is mostly useful for > +debugging or using an assembler different from build-time. Some text massaging, along with some shameful copying from other (read: RISC-V) -mexplicit-relocs docs... "Use or do not use assembler relocation operators when dealing with symbolic addresses. The alternative is to use assembler macros instead, which may limit optimization. The default value for the option is determined during GCC build-time by detecting corresponding assembler support: @code{-mexplicit-relocs} if said support is present, @code{-mno-explicit-relocs} otherwise. This option is mostly useful for debugging, or interoperation with assemblers different from the build-time one." What do you think? > @end table > > @node M32C Options
在 2022/7/27 下午3:21, WANG Xuerui 写道: > Hi, > > On 2022/7/27 15:06, Xi Ruoyao wrote: >> Document newly introduced -m[no-]explicit-relocs options. Ok for trunk? >> >> -- >8 -- >> >> gcc/ChangeLog: >> >> * doc/invoke.texi: Document -m[no-]explicit-relocs for >> LoongArch. >> --- >> gcc/doc/invoke.texi | 12 ++++++++++++ >> 1 file changed, 12 insertions(+) >> >> diff --git a/gcc/doc/invoke.texi b/gcc/doc/invoke.texi >> index 9a3f2d14c5a..04418f80428 100644 >> --- a/gcc/doc/invoke.texi >> +++ b/gcc/doc/invoke.texi >> @@ -24939,6 +24939,18 @@ global symbol: The data got table must be >> within +/-8EiB addressing space. >> @end itemize >> @end table >> The default code model is @code{normal}. >> + >> +@item -mexplicit-relocs >> +@itemx -mno-explicit-relocs >> +@opindex mexplicit-relocs >> +@opindex mno-explicit-relocs >> +Generate (do not generate) explicit symbol relocations instead of >> +assembler macros. Using explicit relocations can improve code >> generation. >> +GCC detects the capaiblities of the assembler when it is built and sets >> +the default to @code{-mexplicit-relocs} if the assembler supports the >> +syntax for explicit specification of relocations, and >> +@code{-mno-explicit-relocs} otherwise. This option is mostly useful >> for >> +debugging or using an assembler different from build-time. > > Some text massaging, along with some shameful copying from other > (read: RISC-V) -mexplicit-relocs docs... > > "Use or do not use assembler relocation operators when dealing with > symbolic addresses. The alternative is to use assembler macros > instead, which may limit optimization. > > The default value for the option is determined during GCC build-time > by detecting corresponding assembler support: @code{-mexplicit-relocs} > if said support is present, @code{-mno-explicit-relocs} otherwise. > This option is mostly useful for debugging, or interoperation with > assemblers different from the build-time one." > > What do you think? > >> @end table >> @node M32C Options I agree with wangxuerui's idea. The same parameter and the same description information can reduce the user's time to learn how to use this parameter.
On Wed, 2022-07-27 at 16:47 +0800, Lulu Cheng wrote: > > "Use or do not use assembler relocation operators when dealing with > > symbolic addresses. The alternative is to use assembler macros > > instead, which may limit optimization. > > > > The default value for the option is determined during GCC build- > > time by detecting corresponding assembler support: @code{-mexplicit- > > relocs} if said support is present, @code{-mno-explicit-relocs} > > otherwise. This option is mostly useful for debugging, or > > interoperation with assemblers different from the build-time one." > > > I agree with wangxuerui's idea. > The same parameter and the same description information can reduce the > user's time to learn how to use this parameter. I agree it's better than my origin paragraph. If you agree I'll commit it with Xuerui as the commit author.
在 2022/7/27 下午5:15, Xi Ruoyao 写道: > On Wed, 2022-07-27 at 16:47 +0800, Lulu Cheng wrote: > >>> "Use or do not use assembler relocation operators when dealing with >>> symbolic addresses. The alternative is to use assembler macros >>> instead, which may limit optimization. >>> >>> The default value for the option is determined during GCC build- >>> time by detecting corresponding assembler support: @code{-mexplicit- >>> relocs} if said support is present, @code{-mno-explicit-relocs} >>> otherwise. This option is mostly useful for debugging, or >>> interoperation with assemblers different from the build-time one." >>> >> I agree with wangxuerui's idea. >> The same parameter and the same description information can reduce the >> user's time to learn how to use this parameter. > I agree it's better than my origin paragraph. > > If you agree I'll commit it with Xuerui as the commit author. > I have no opinion if wangxuerui agrees.
On 2022/7/27 17:28, Lulu Cheng wrote: > > > 在 2022/7/27 下午5:15, Xi Ruoyao 写道: >> On Wed, 2022-07-27 at 16:47 +0800, Lulu Cheng wrote: >> >>>> "Use or do not use assembler relocation operators when dealing with >>>> symbolic addresses. The alternative is to use assembler macros >>>> instead, which may limit optimization. >>>> >>>> The default value for the option is determined during GCC build- >>>> time by detecting corresponding assembler support: @code{-mexplicit- >>>> relocs} if said support is present, @code{-mno-explicit-relocs} >>>> otherwise. This option is mostly useful for debugging, or >>>> interoperation with assemblers different from the build-time one." >>>> >>> I agree with wangxuerui's idea. >>> The same parameter and the same description information can reduce the >>> user's time to learn how to use this parameter. >> I agree it's better than my origin paragraph. >> >> If you agree I'll commit it with Xuerui as the commit author. >> > > I have no opinion if wangxuerui agrees. Either is OK (if you really think the commit is effectively rewritten by me), thanks.
On Wed, 2022-07-27 at 17:57 +0800, WANG Xuerui wrote: > On 2022/7/27 17:28, Lulu Cheng wrote: > > > > > > 在 2022/7/27 下午5:15, Xi Ruoyao 写道: > > > On Wed, 2022-07-27 at 16:47 +0800, Lulu Cheng wrote: > > > > > > > > "Use or do not use assembler relocation operators when dealing with > > > > > symbolic addresses. The alternative is to use assembler macros > > > > > instead, which may limit optimization. > > > > > > > > > > The default value for the option is determined during GCC build- > > > > > time by detecting corresponding assembler support: @code{-mexplicit- > > > > > relocs} if said support is present, @code{-mno-explicit-relocs} > > > > > otherwise. This option is mostly useful for debugging, or > > > > > interoperation with assemblers different from the build-time one." > > > > > > > > > I agree with wangxuerui's idea. > > > > The same parameter and the same description information can reduce the > > > > user's time to learn how to use this parameter. > > > I agree it's better than my origin paragraph. > > > > > > If you agree I'll commit it with Xuerui as the commit author. > > > > > > > I have no opinion if wangxuerui agrees. > Either is OK (if you really think the commit is effectively rewritten by > me), thanks. Pushed r13-1859.
diff --git a/gcc/doc/invoke.texi b/gcc/doc/invoke.texi index 9a3f2d14c5a..04418f80428 100644 --- a/gcc/doc/invoke.texi +++ b/gcc/doc/invoke.texi @@ -24939,6 +24939,18 @@ global symbol: The data got table must be within +/-8EiB addressing space. @end itemize @end table The default code model is @code{normal}. + +@item -mexplicit-relocs +@itemx -mno-explicit-relocs +@opindex mexplicit-relocs +@opindex mno-explicit-relocs +Generate (do not generate) explicit symbol relocations instead of +assembler macros. Using explicit relocations can improve code generation. +GCC detects the capaiblities of the assembler when it is built and sets +the default to @code{-mexplicit-relocs} if the assembler supports the +syntax for explicit specification of relocations, and +@code{-mno-explicit-relocs} otherwise. This option is mostly useful for +debugging or using an assembler different from build-time. @end table @node M32C Options