From patchwork Wed Dec 28 09:18:57 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: =?utf-8?q?Martin_Li=C5=A1ka?= X-Patchwork-Id: 37152 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a5d:4e01:0:0:0:0:0 with SMTP id p1csp1796724wrt; Wed, 28 Dec 2022 01:19:27 -0800 (PST) X-Google-Smtp-Source: AMrXdXvoTpCl281kTDyKSnH/Lckh06/VPDpUxWVVPmL5f4hqDxS/7nmtjEl3unxIHleJyoJ3airI X-Received: by 2002:a17:906:944c:b0:7c0:bd68:ce30 with SMTP id z12-20020a170906944c00b007c0bd68ce30mr20401557ejx.54.1672219166979; Wed, 28 Dec 2022 01:19:26 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1672219166; cv=none; d=google.com; s=arc-20160816; b=Ul4rLu/frZ23iWYAPAjaq918sGQy3NOINNRELQYjdGKg8SQB1aJDEfb6DtxNETZMCk cheShAJ42JYknCZzsvghZBHAKSpCJOmnO6sl9GgyvaixsVA716VGn0++QX4bXs+Q8GvY 3E4ylrEmYr2E46/LxNba1sRgk1G3EQJ1sMhIaTTHeKMB7uM1rAsNRBr3qAw+XGp4qtv7 to4AUn4h4jdjfvX9/BNjITTa2015+VH2n14YdRyUNmP+8UvNPrMoI/ZCgsiGsMwNhis4 wVcwchOw1uYpEBHn90b2868NW/40+xbkmVpxqjBYiwdVu2pGRnsycwP2b0DHs9h1OMVH rUkw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=sender:errors-to:list-subscribe:list-help:list-post:list-archive :list-unsubscribe:list-id:precedence:content-transfer-encoding:cc :content-language:to:subject:from:user-agent:mime-version:date :message-id:dkim-signature:dkim-signature:dmarc-filter:delivered-to; bh=+/NWhmq8GRQeynbG7+eUaWHVkq6eVxf7AtjjIzFvr5k=; b=FptD6n8Oy49+9qJnx8+bj/xmz15OHymCK4YYHZ0ED5CX/vPOsu8YqHIeF383KmXNIY DTrTfuCoBfXvLfEpvI1u9qsPHw/MWHO57u4GOq7N6eHoTGvgc8wJoK3EgJ/7Qfe2x7eI 0zloJ0tejmFFFXaxIXUKRlDc2EInarNRxBs5GmJ6ncbI9QyBmZoGRGiqPx6oVfYZur8P 657ZvD3HahpZQdD+ugWSRiRbRusqnsIgTflFM1g3fIkEGxLUTzdII5h7O/u8gbImUZfL Rm4srz1k4NPE9fAmrP/jc93j6Zh/E00H9Ky6iBZEyb267Cik2ExS0TsRTLMoSZzsWBV6 BK5Q== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@suse.cz header.s=susede2_rsa header.b=JZVM6TJJ; dkim=neutral (no key) header.i=@suse.cz header.s=susede2_ed25519 header.b=zmmR1wyK; 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 sourceware.org (ip-8-43-85-97.sourceware.org. [8.43.85.97]) by mx.google.com with ESMTPS id oz10-20020a1709077d8a00b007c17420be5bsi13758618ejc.178.2022.12.28.01.19.26 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 28 Dec 2022 01:19:26 -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=@suse.cz header.s=susede2_rsa header.b=JZVM6TJJ; dkim=neutral (no key) header.i=@suse.cz header.s=susede2_ed25519 header.b=zmmR1wyK; 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 1FE3E3858428 for ; Wed, 28 Dec 2022 09:19:24 +0000 (GMT) X-Original-To: gcc-patches@gcc.gnu.org Delivered-To: gcc-patches@gcc.gnu.org Received: from smtp-out1.suse.de (smtp-out1.suse.de [IPv6:2001:67c:2178:6::1c]) by sourceware.org (Postfix) with ESMTPS id 6D80E3858D39 for ; Wed, 28 Dec 2022 09:19:00 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.1 sourceware.org 6D80E3858D39 Authentication-Results: sourceware.org; dmarc=none (p=none dis=none) header.from=suse.cz Authentication-Results: sourceware.org; spf=fail smtp.mailfrom=suse.cz Received: from imap2.suse-dmz.suse.de (imap2.suse-dmz.suse.de [192.168.254.74]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature ECDSA (P-521) server-digest SHA512) (No client certificate requested) by smtp-out1.suse.de (Postfix) with ESMTPS id E4A9E21A95; Wed, 28 Dec 2022 09:18:58 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=suse.cz; s=susede2_rsa; t=1672219138; h=from:from:reply-to:date:date:message-id:message-id:to:to:cc:cc: mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=+/NWhmq8GRQeynbG7+eUaWHVkq6eVxf7AtjjIzFvr5k=; b=JZVM6TJJcTDgvEPZKG6KCyFg7Xuw8SH4ApkMtgzhMXtr8JdcgpZsQtK33eLfw8MD868JiW +dUvqEzuWU9tqADQ5sEoOxPAl1cOKwu4QKW0qaNMlZPfaknSXyH5GQWZIbTw3rcj+wUDbc 0WCjSQfb5i0dZH/P6FuMnw0jAmlZvJk= DKIM-Signature: v=1; a=ed25519-sha256; c=relaxed/relaxed; d=suse.cz; s=susede2_ed25519; t=1672219138; h=from:from:reply-to:date:date:message-id:message-id:to:to:cc:cc: mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=+/NWhmq8GRQeynbG7+eUaWHVkq6eVxf7AtjjIzFvr5k=; b=zmmR1wyKXaGtGBy7geqyvrvPkxFmQnE7/MasJ6X4n771J2NOJol5ziJ+yxhxMNPFo2LBWn WpLBdnapxjvYteAA== Received: from imap2.suse-dmz.suse.de (imap2.suse-dmz.suse.de [192.168.254.74]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature ECDSA (P-521) server-digest SHA512) (No client certificate requested) by imap2.suse-dmz.suse.de (Postfix) with ESMTPS id CD771134F5; Wed, 28 Dec 2022 09:18:58 +0000 (UTC) Received: from dovecot-director2.suse.de ([192.168.254.65]) by imap2.suse-dmz.suse.de with ESMTPSA id Nsk4MQIKrGNlUgAAMHmgww (envelope-from ); Wed, 28 Dec 2022 09:18:58 +0000 Message-ID: Date: Wed, 28 Dec 2022 10:18:57 +0100 MIME-Version: 1.0 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:102.0) Gecko/20100101 Thunderbird/102.6.1 From: =?utf-8?q?Martin_Li=C5=A1ka?= Subject: [PATCH] docs: fix Var documentation for .opt files To: gcc-patches@gcc.gnu.org Content-Language: en-US Cc: Gerald Pfeifer , Andrew Pinski X-Spam-Status: No, score=-11.5 required=5.0 tests=BAYES_00, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, DKIM_VALID_EF, GIT_PATCH_0, SPF_HELO_NONE, SPF_SOFTFAIL, 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 List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: gcc-patches-bounces+ouuuleilei=gmail.com@gcc.gnu.org Sender: "Gcc-patches" X-getmail-retrieved-from-mailbox: =?utf-8?q?INBOX?= X-GMAIL-THRID: =?utf-8?q?1753448885470936725?= X-GMAIL-MSGID: =?utf-8?q?1753448885470936725?= The Var documentation was somehow wrongly split into 2 pieces. PR middle-end/107966 gcc/ChangeLog: * doc/options.texi: Fix Var documentation in internal manual. --- gcc/doc/options.texi | 26 +++++++++++++------------- 1 file changed, 13 insertions(+), 13 deletions(-) diff --git a/gcc/doc/options.texi b/gcc/doc/options.texi index 17ba923890e..39a2d1a0d43 100644 --- a/gcc/doc/options.texi +++ b/gcc/doc/options.texi @@ -340,19 +340,6 @@ The state of this option should be stored in variable @var{var} (actually a macro for @code{global_options.x_@var{var}}). The way that the state is stored depends on the type of option: -@item WarnRemoved -The option is removed and every usage of such option will -result in a warning. We use it option backward compatibility. - -@item Var(@var{var}, @var{set}) -The option controls an integer variable @var{var} and is active when -@var{var} equals @var{set}. The option parser will set @var{var} to -@var{set} when the positive form of the option is used and @code{!@var{set}} -when the ``no-'' form is used. - -@var{var} is declared in the same way as for the single-argument form -described above. - @itemize @bullet @item If the option uses the @code{Mask} or @code{InverseMask} properties, @@ -390,11 +377,24 @@ and wasn't given. The option-processing script will usually zero-initialize @var{var}. You can modify this behavior using @code{Init}. +@item Var(@var{var}, @var{set}) +The option controls an integer variable @var{var} and is active when +@var{var} equals @var{set}. The option parser will set @var{var} to +@var{set} when the positive form of the option is used and @code{!@var{set}} +when the ``no-'' form is used. + +@var{var} is declared in the same way as for the single-argument form +described above. + @item Init(@var{value}) The variable specified by the @code{Var} property should be statically initialized to @var{value}. If more than one option using the same variable specifies @code{Init}, all must specify the same initializer. +@item WarnRemoved +The option is removed and every usage of such option will +result in a warning. We use it option backward compatibility. + @item Mask(@var{name}) The option is associated with a bit in the @code{target_flags} variable (@pxref{Run-time Target}) and is active when that bit is set.