From patchwork Fri Mar 1 16:49:36 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Georg-Johann Lay X-Patchwork-Id: 208942 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a05:7301:fa17:b0:10a:f01:a869 with SMTP id ju23csp6538dyc; Fri, 1 Mar 2024 08:50:51 -0800 (PST) X-Forwarded-Encrypted: i=4; AJvYcCXG4Xqd8c28nuGxyBQFQFJNKq6HshyByEJqeKX1B1RKD8/bxvSswvx5ImK9rXXHOjNWmli2imH1SVdPIR0JapzUDuR5gg== X-Google-Smtp-Source: AGHT+IGTTYq4Fu6Z2SpYWrNvxnPtAr9IfUx5TiMVALuRBzvxrGe5Y5tEcaxyh/f/T9rwDFdzlry7 X-Received: by 2002:a05:6214:180d:b0:690:4e5e:4351 with SMTP id o13-20020a056214180d00b006904e5e4351mr2124732qvw.41.1709311850964; Fri, 01 Mar 2024 08:50:50 -0800 (PST) ARC-Seal: i=3; a=rsa-sha256; t=1709311850; cv=pass; d=google.com; s=arc-20160816; b=c+56SNKxCqxBCNpMPJsyhFX4ePlBGbc6HfF1pw3vEQS5U1hA+/SUWoxw//NdYDGoTa 5Hv/BgDhnAo5skySGCZ4zXsHZNswM2yntG48UsFD3Axitoch+ReZepCTU/MgjrsBpbCK u9yZ+WTFOlqJd0DK/iXUu7MPVc9JIfcNVMCECgJYF6mLiXE8BmHRSMuapf/fSU/l/XIO 9uo9KlR+H2bbQq0I0mnOGbENQMENTHaCnNPO4PY5r53hKfK1xM1lU0VsLrSPipEAYNEt VK7YW5DQ7mmeG1kHfvOYJfnRAIXF2udZd0iFIzbWSWTM0u+WAeooAhb4OUxlWG2WTzFz JogQ== ARC-Message-Signature: i=3; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=errors-to:list-subscribe:list-help:list-post:list-archive :list-unsubscribe:list-id:precedence:content-transfer-encoding :subject:to:from:content-language:user-agent:mime-version:date :message-id:dkim-signature:dkim-signature:arc-filter:dmarc-filter :delivered-to; bh=yd0ZJPLYErIlRYdJ86HgNPjOhkBIL961s9HRz16K3/w=; fh=XNn3asQvIblazGK92GBt13dVv+YmGV3pBS0JC29ZQco=; b=Fkt84XQerxUpy625yYj3+9eU4VZesDxlOhnDxAIcN/oHupU8oIHQUQMKxobTxJ2w95 Mzsl1eIsgSEwvPONMj/GcW127CPO5ppRK+sN2NasBThif7hAdG9xAVBoL1pVCRR8/UAy 298pYaTZglaWvkXC83caD9w7a4UKqeWPz+fDs6BNSBjBoZd+HzuKsEwpih1g4QkAkFcI xWt1u9GIWDrwgnF2nFO/LR0otvrEAH5nKEKAS1Criz2Pvrpi0mhcOrgnXGgaufauZ2Zb lJORKWrXwlgHK9bLQTQF+nyomxPkId5lXQ/ymw/HHq4LsdpYnxF6Ys3F1SnF6q1Gw/6L ZiFw==; dara=google.com ARC-Authentication-Results: i=3; mx.google.com; dkim=pass header.i=@gjlay.de header.s=strato-dkim-0002 header.b=AUfwWhX9; dkim=neutral (no key) header.i=@gjlay.de header.s=strato-dkim-0003; arc=pass (i=2); spf=pass (google.com: domain of gcc-patches-bounces+ouuuleilei=gmail.com@gcc.gnu.org designates 8.43.85.97 as permitted sender) smtp.mailfrom="gcc-patches-bounces+ouuuleilei=gmail.com@gcc.gnu.org" Received: from server2.sourceware.org (server2.sourceware.org. [8.43.85.97]) by mx.google.com with ESMTPS id eo13-20020ad4594d000000b0069017323b96si3884781qvb.208.2024.03.01.08.50.50 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 01 Mar 2024 08:50:50 -0800 (PST) Received-SPF: pass (google.com: domain of gcc-patches-bounces+ouuuleilei=gmail.com@gcc.gnu.org designates 8.43.85.97 as permitted sender) client-ip=8.43.85.97; Authentication-Results: mx.google.com; dkim=pass header.i=@gjlay.de header.s=strato-dkim-0002 header.b=AUfwWhX9; dkim=neutral (no key) header.i=@gjlay.de header.s=strato-dkim-0003; arc=pass (i=2); spf=pass (google.com: domain of gcc-patches-bounces+ouuuleilei=gmail.com@gcc.gnu.org designates 8.43.85.97 as permitted sender) smtp.mailfrom="gcc-patches-bounces+ouuuleilei=gmail.com@gcc.gnu.org" Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id 9E0973858417 for ; Fri, 1 Mar 2024 16:50:50 +0000 (GMT) X-Original-To: gcc-patches@gcc.gnu.org Delivered-To: gcc-patches@gcc.gnu.org Received: from mo4-p00-ob.smtp.rzone.de (mo4-p00-ob.smtp.rzone.de [81.169.146.162]) by sourceware.org (Postfix) with ESMTPS id 0DFFB3858C66 for ; Fri, 1 Mar 2024 16:49:38 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org 0DFFB3858C66 Authentication-Results: sourceware.org; dmarc=none (p=none dis=none) header.from=gjlay.de Authentication-Results: sourceware.org; spf=none smtp.mailfrom=gjlay.de ARC-Filter: OpenARC Filter v1.0.0 sourceware.org 0DFFB3858C66 Authentication-Results: server2.sourceware.org; arc=pass smtp.remote-ip=81.169.146.162 ARC-Seal: i=2; a=rsa-sha256; d=sourceware.org; s=key; t=1709311795; cv=pass; b=GXFt4ck/4QP3poZZbFiSigg4eMeTwKW63oyqu44pPP7edEMoiBO5XANFa4V4WkdDzF7yxsl0bNzDgUrUpZe5fW9Hh3QX4K/9biVp2GdnhaMwAtQp9cFwGYMjfzOnKjGSRHBmXrPQLPE3sMaeouWyyxq2TNJEUXiGSRn0xnoWABM= ARC-Message-Signature: i=2; a=rsa-sha256; d=sourceware.org; s=key; t=1709311795; c=relaxed/simple; bh=D5cwt3Zhutthd0dq7CBHqwvfCLQj4fGynfLXfOpvpPQ=; h=DKIM-Signature:DKIM-Signature:Message-ID:Date:MIME-Version:From: To:Subject; b=JzxbIqNkl6s6fTF7iBoLsqd24+ABuJkwaAPHl3ajDUrNOjgqQeVo8TBvdlZMpe3cht+Q8rAj6BwBCjCVj4PqD3uCRe9GxFH4D+txHHXU+f7u/XgpOmoL8jE5lmu95FmzamHGgrGkP0h6swRlXgpvqpDpecKYDVAVXB82qCAa0LE= ARC-Authentication-Results: i=2; server2.sourceware.org ARC-Seal: i=1; a=rsa-sha256; t=1709311777; cv=none; d=strato.com; s=strato-dkim-0002; b=YgBXmQ4wV+2YXPEgloHWpLBzTkryYjuSRGpYa/Am1AJOl4ehxw/OquLl/g+L6xYH3K qc8OAkPweMUsgM8/AoZ5PJnGy5i7iqdmpFHYLHjGVIwg3Dy4GrfghdvqIOSq2KJOSSJs TcwwxOctnohKl/2gpjxDtjIgYhTJUZ38mEWUrnJXbeoDeAYcMTDj45jkwQsutz1fTh0i ry1LK4OgkqCX8TRCw58UmzfKulaLWmyfnxDOu6uzUupQXWKrISWf5+a2pduFRbOHksQj JjhEx7uEqpQtTyenZNfc94OXn9UR0ESWtzyijxrmZV4hzh+3ZdofjF1ZRS8SFBOkPWgP zo1w== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; t=1709311777; s=strato-dkim-0002; d=strato.com; h=Subject:To:From:Date:Message-ID:Cc:Date:From:Subject:Sender; bh=yd0ZJPLYErIlRYdJ86HgNPjOhkBIL961s9HRz16K3/w=; b=GIv3IKC7es29mm/iwFDmhCPR3aGz6JuYzitnQqanFomFDh5C0HlfY6+wjSkasNPuUH NJ6EoEi1KrnDLYcmEu7vrO7U/GVF/k1u32ayoLDIE0sSF9GRXmqlSjCNqE+7e93FJsgK ffor4MKHFum3GHM5hBV5QILWtekD5FibDxi732QfR5Hax3eVbO4bhEBnigm5h/T4gE8n x08/e8Az79sTOl+u5Q09s49XVeJTguEGbE4VoXuS1h1uBcpdT1KO6oQZa88smA5X38Ic Np7mtaJe1y2SdrEEBMm6BQGcuszGt/UgsOcFTfwCVqnJMe4cu6Alphuh+9dMira+RlvT +OQQ== ARC-Authentication-Results: i=1; strato.com; arc=none; dkim=none X-RZG-CLASS-ID: mo00 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; t=1709311777; s=strato-dkim-0002; d=gjlay.de; h=Subject:To:From:Date:Message-ID:Cc:Date:From:Subject:Sender; bh=yd0ZJPLYErIlRYdJ86HgNPjOhkBIL961s9HRz16K3/w=; b=AUfwWhX9qijqiFNLNaMSwNL8K7RfqC8BhkxGg1Ogu8kAw3JPmNaTMfCj6xUjrYzMTC Hu9VBEEi6+T+Fxij8IcKimFTSj8cK6jMAkDX3WK9fSPeByGanyXeZV81iz7Tm7t7ubm+ vXRiF1MbkRE7kYMLrK8M6Hbv5JxDWnKgs/S81TFWMd3kllVOSv5CyhQYVN8mQ3IsyYqo DQCCopScE+mCOgpqpAHF9oDXpk2TDduDcW7zcqE1gKGPhSdBGYCbZ6hmTZLBwuaHoCX7 2qkdfqUFqkPGd/w9tctRLuvjeJCW9W5XUtVLKzG725o7V7xac1JHRqYTMYU8j6fzW1mP Y8uA== DKIM-Signature: v=1; a=ed25519-sha256; c=relaxed/relaxed; t=1709311777; s=strato-dkim-0003; d=gjlay.de; h=Subject:To:From:Date:Message-ID:Cc:Date:From:Subject:Sender; bh=yd0ZJPLYErIlRYdJ86HgNPjOhkBIL961s9HRz16K3/w=; b=gjlVQLZHt8dVi862zrh0ZSVHDbEBR0TBHy/Qf3GLaw8IUAznCyjwbD4/Y4lceB3tIg 9ISo9uR3fHFFXq5DugCg== X-RZG-AUTH: ":LXoWVUeid/7A29J/hMvvT3koxZnKT7Qq0xotTetVnKkSgcSjpmy9KwoMJ/K0VA==" Received: from [192.168.2.102] by smtp.strato.de (RZmta 50.2.0 DYNA|AUTH) with ESMTPSA id Jdfd10021Gnb0NU (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256 bits)) (Client did not present a certificate) for ; Fri, 1 Mar 2024 17:49:37 +0100 (CET) Message-ID: <9fa86540-94c4-4668-9f62-5bd0324a7a7a@gjlay.de> Date: Fri, 1 Mar 2024 17:49:36 +0100 MIME-Version: 1.0 User-Agent: Mozilla Thunderbird Content-Language: en-US From: Georg-Johann Lay To: "gcc-patches@gcc.gnu.org" Subject: [patch,avr,applied] Adjust help messages. X-Spam-Status: No, score=-11.0 required=5.0 tests=BAYES_00, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, DKIM_VALID_EF, GIT_PATCH_0, RCVD_IN_DNSWL_NONE, RCVD_IN_MSPIKE_H3, RCVD_IN_MSPIKE_WL, SPF_HELO_PASS, SPF_NONE, TXREP, T_SCC_BODY_TEXT_LINE 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.30 Precedence: list List-Id: Gcc-patches mailing list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: gcc-patches-bounces+ouuuleilei=gmail.com@gcc.gnu.org X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: 1792343383015283290 X-GMAIL-MSGID: 1792343383015283290 This patch unifies help screen messages. Johann --- AVR: Overhaul help screen gcc/ * config/avr/avr.opt: Overhaul help screen. diff --git a/gcc/config/avr/avr.opt b/gcc/config/avr/avr.opt index ea35b7d5b4e..c3ca8379ee3 100644 --- a/gcc/config/avr/avr.opt +++ b/gcc/config/avr/avr.opt @@ -20,27 +20,27 @@ mcall-prologues Target Mask(CALL_PROLOGUES) Optimization -Use subroutines for function prologues and epilogues. +Optimization. Use subroutines for function prologues and epilogues. mmcu= Target RejectNegative Joined Var(avr_mmcu) MissingArgError(missing device or architecture after %qs) --mmcu=MCU Select the target MCU. +-mmcu= Select the target MCU. mgas-isr-prologues Target Var(avr_gasisr_prologues) UInteger Init(0) Optimization -Allow usage of __gcc_isr pseudo instructions in ISR prologues and epilogues. +Optimization. Allow usage of __gcc_isr pseudo instructions in ISR prologues and epilogues. mn-flash= Target RejectNegative Joined Var(avr_n_flash) UInteger Init(-1) -Set the number of 64 KiB flash segments. +This option is used internally. Set the number of 64 KiB flash segments. mskip-bug Target Mask(SKIP_BUG) -Indicate presence of a processor erratum. +This option is used internally. Indicate presence of a processor erratum. Do not skip 32-bit instructions. mrmw Target Mask(RMW) -Enable Read-Modify-Write (RMW) instructions support/use. +This option is used internally. Enable Read-Modify-Write (RMW) instructions support/use. mdeb Target Undocumented Mask(ALL_DEBUG) @@ -50,7 +50,7 @@ Target RejectNegative Joined Undocumented Var(avr_log_details) mshort-calls Target RejectNegative Mask(SHORT_CALLS) -Use RJMP / RCALL even though CALL / JMP are available. +This option is used internally for multilib generation and selection. Assume RJMP / RCALL can target all program memory. mint8 Target Mask(INT8) @@ -62,11 +62,11 @@ Change the stack pointer without disabling interrupts. mbranch-cost= Target Joined RejectNegative UInteger Var(avr_branch_cost) Init(0) Optimization -Set the branch costs for conditional branch instructions. Reasonable values are small, non-negative integers. The default branch cost is 0. +-mbranch-cost= Optimization. Set the branch costs for conditional branch instructions. Reasonable values are small, non-negative integers. The default branch cost is 0. mmain-is-OS_task Target Mask(MAIN_IS_OS_TASK) Optimization -Treat main as if it had attribute OS_task. +Optimization. Treat main as if it had attribute OS_task. morder1 Target Undocumented Mask(ORDER_1) @@ -80,7 +80,7 @@ Change only the low 8 bits of the stack pointer. mrelax Target Optimization -Relax branches. +Optimization. Relax branches. mpmem-wrap-around Target @@ -88,15 +88,15 @@ Make the linker relaxation machine assume that a program counter wrap-around occ maccumulate-args Target Mask(ACCUMULATE_OUTGOING_ARGS) Optimization -Accumulate outgoing function arguments and acquire/release the needed stack space for outgoing function arguments in function prologue/epilogue. Without this option, outgoing arguments are pushed before calling a function and popped afterwards. This option can lead to reduced code size for functions that call many functions that get their arguments on the stack like, for example printf. +Optimization. Accumulate outgoing function arguments and acquire/release the needed stack space for outgoing function arguments in function prologue/epilogue. Without this option, outgoing arguments are pushed before calling a function and popped afterwards. This option can lead to reduced code size for functions that call many functions that get their arguments on the stack like, for example printf. mstrict-X Target Var(avr_strict_X) Init(0) Optimization -When accessing RAM, use X as imposed by the hardware, i.e. just use pre-decrement, post-increment and indirect addressing with the X register. Without this option, the compiler may assume that there is an addressing mode X+const similar to Y+const and Z+const and emit instructions to emulate such an addressing mode for X. +Optimization. When accessing RAM, use X as imposed by the hardware, i.e. just use pre-decrement, post-increment and indirect addressing with the X register. Without this option, the compiler may assume that there is an addressing mode X+const similar to Y+const and Z+const and emit instructions to emulate such an addressing mode for X. mflmap Target Var(avr_flmap) Init(0) -The device has the bitfield NVMCTRL_CTRLB.FLMAP. This option is used internally. +This option is used internally. The device has the bitfield NVMCTRL_CTRLB.FLMAP. mrodata-in-ram Target Var(avr_rodata_in_ram) Init(-1) @@ -105,15 +105,15 @@ The device has the .rodata section located in the RAM area. ;; For rationale behind -msp8 see explanation in avr.h. msp8 Target RejectNegative Var(avr_sp8) Init(0) -The device has no SPH special function register. This option will be overridden by the compiler driver with the correct setting if presence/absence of SPH can be deduced from -mmcu=MCU. +This option is used internally for multilib generation and selection. The device has no SPH special function register. mfuse-add -Target Alias(mfuse-add=, 1, 0) Optimization -Split register additions from load/store instructions. Most useful on Reduced Tiny. +Target Alias(mfuse-add=, 2, 0) Optimization +Optimization. Split register additions from load/store instructions. Most useful on Reduced Tiny. mfuse-add= Target Joined RejectNegative UInteger Var(avr_fuse_add) Init(0) Optimization IntegerRange(0, 3) -Split register additions from load/store instructions. Most useful on Reduced Tiny. +-mfuse-add=<0,2> Optimization. Split register additions from load/store instructions. Most useful on Reduced Tiny. Waddr-space-convert Warning C Var(avr_warn_addr_space_convert) Init(0) @@ -129,7 +129,7 @@ Allow to use truncation instead of rounding towards zero for fractional fixed-po mabsdata Target Mask(ABSDATA) -Assume that all data in static storage can be accessed by LDS / STS. This option is only useful for reduced Tiny devices. +Assume that all data in static storage can be accessed by LDS / STS instructions. This option is only useful for reduced Tiny devices like ATtiny40. mdouble= Target Joined RejectNegative Var(avr_double) Init(0) Enum(avr_bits_e) Save