From patchwork Fri Dec 13 10:00:35 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Jan Beulich X-Patchwork-Id: 102989 Return-Path: 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 F16483858403 for ; Fri, 13 Dec 2024 10:01:31 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org F16483858403 Authentication-Results: sourceware.org; dkim=pass (2048-bit key, unprotected) header.d=suse.com header.i=@suse.com header.a=rsa-sha256 header.s=google header.b=NzxMKSZZ X-Original-To: binutils@sourceware.org Delivered-To: binutils@sourceware.org Received: from mail-wr1-x434.google.com (mail-wr1-x434.google.com [IPv6:2a00:1450:4864:20::434]) by sourceware.org (Postfix) with ESMTPS id E54D83858D35 for ; Fri, 13 Dec 2024 10:00:37 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org E54D83858D35 Authentication-Results: sourceware.org; dmarc=pass (p=quarantine dis=none) header.from=suse.com Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=suse.com ARC-Filter: OpenARC Filter v1.0.0 sourceware.org E54D83858D35 Authentication-Results: server2.sourceware.org; arc=none smtp.remote-ip=2a00:1450:4864:20::434 ARC-Seal: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1734084038; cv=none; b=nSjEvEsI8M3Qao4WjUdG6l6bGeAzTXTZXAdfQBRAv8+/1wc0yuSnub1f4EiIFKBFzlo0Rp9znx5nsV/DQuZnG/tJ7v6qL6R4Gx+33Xxey7xX6wwGhlJlhonXExvhe6zdAkDyaK0SiPAm5qisj5yEAi0qlv6YB6xqnhrpGBYpxIo= ARC-Message-Signature: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1734084038; c=relaxed/simple; bh=YjZg+CyR06Ms4NBYlrnZ4cpg98QybBgQq0zWmm49KmM=; h=DKIM-Signature:Message-ID:Date:MIME-Version:To:From:Subject; b=sM811LosmJMN32nxN0yN0ZexZMkOMXFhv8Y1xIF4NQ4YhBu2XTfSnfbrzlODP9pRNFFF269mkULRXLxaUm/JhBOcxmIk3XY2ZvYmr7zr5LZ7Atr+maTdQwrsHjR3IIMU87i0U4qcPQabOA6EU3nH7NdeJxdaiQj+VsqnYZkjjkQ= ARC-Authentication-Results: i=1; server2.sourceware.org DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org E54D83858D35 Received: by mail-wr1-x434.google.com with SMTP id ffacd0b85a97d-3862df95f92so785310f8f.2 for ; Fri, 13 Dec 2024 02:00:37 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=suse.com; s=google; t=1734084036; x=1734688836; darn=sourceware.org; h=content-transfer-encoding:autocrypt:subject:from:cc:to :content-language:user-agent:mime-version:date:message-id:from:to:cc :subject:date:message-id:reply-to; bh=YbW0mcALW0NNWsIf3dzrsnRSveusl04tORWAGk4aJXA=; b=NzxMKSZZd5n0hzzfIq66v0HVEFN3cBuJQo6ke8jCIg0utBhAIIUk+5eJltt/igbjJQ vzsjjBHzTZSod3oO95qrb1kujuFjToM9qXKkNsbigi5KAyALq7sCeTtMgUQ0qW2k8tD5 5ohb8QqX1W4ecsTguoWgf1SNz1hYbg0N9nb478LGJv90juPY8AvrMulW8ujuabVCmBu+ N3vPzXI3emFEWWaj5fflGcdnPwnlwwKcP7WWVcB+SIy3yXWdysEqnQcW9QUwh35Kqdbr x8LRPnJpF24TQHd9u+RHwHLCmvOMP2Hjr8rVoM+J1rl+lFs50kF6ci3HrIUFelovbXFF oGFA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1734084036; x=1734688836; h=content-transfer-encoding:autocrypt:subject:from:cc:to :content-language:user-agent:mime-version:date:message-id :x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=YbW0mcALW0NNWsIf3dzrsnRSveusl04tORWAGk4aJXA=; b=bb8H7ZLqohBlg02qATcdvU8kLZVhkM+FRlHkpHZdZWvJcLPHk5qy/VBm5CkBPb0lD7 wLQMf0e4PLIJi3qY8dT82vTMAflS9YJ8w4z81msWVyluewvtJuqxWOKE9b4YAjCp67rv oVD+u4cLMpO2JQG3ClbalmAVuumU3QokSw/0vDVPIC5ljbRm/FnED0TxBv0masm0qHng YpqgAAf1LcaJ1+k7EzpXRPOTgLVGYvEHkY4HYEsn4CFwEWV6gs9FtqfZBCMZ3wPZMxO4 CONhk/Wva+iiOsV5ezi3rxhr+AP7w2URuLt0Zo2jtQuiH0VwmquwkAR6Zm4C9IhsR6St UzDg== X-Gm-Message-State: AOJu0YwNPQykfiwg5qbX1d0SJzmjqv37Bbg6q5o9jXYJY37mN5IEjxG0 pVaAURHoYwZFC9eXtAUp7VLdE3oeUPoospI05qyFU/1v+K2AfrDwdruzPdcibEfxnaQkfb/xjB4 = X-Gm-Gg: ASbGncuNLLbJe22SfVD6vIrnvIUldLhOH9fijlZ9skQW0jCq+/1GJSe9S2clPYcN90Z 9VJkB+LFMa68S/zTqKaUq7wWF+6g9a+yLmFM+BzwAhjR77Ba0WWCpB+0tgJ5H+OR716PC9XXUHt jki0ff/VrcV+jqpi4DOZcIn4YRyaGUu98jdr8u0c3Ab3BmMR1lg+Nr3J2s2S52r0w8i0jWPhvDW o28eGCHjYb4kskYT5tRGzM3LayWNv+1oopFD4uqgnN1XlrDWNihlDL0hjdLa+cTG0zhAqynql7S EHm/zMffsyRXnrLqJkPXZ68RJuxDrpe4744W+D3+Hw== X-Google-Smtp-Source: AGHT+IGfgzIS2AWAA/yn3COsmNgfKgcghq012fKeQzsK8dq20LQyrkhE7bFJ406X/2VOummhvHX1dw== X-Received: by 2002:a5d:64eb:0:b0:385:ed1e:2105 with SMTP id ffacd0b85a97d-38880ada764mr1125975f8f.26.1734084036170; Fri, 13 Dec 2024 02:00:36 -0800 (PST) Received: from [10.156.60.236] (ip-037-024-206-209.um08.pools.vodafone-ip.de. [37.24.206.209]) by smtp.gmail.com with ESMTPSA id ffacd0b85a97d-38782514d35sm6712591f8f.74.2024.12.13.02.00.35 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Fri, 13 Dec 2024 02:00:35 -0800 (PST) Message-ID: Date: Fri, 13 Dec 2024 11:00:35 +0100 MIME-Version: 1.0 User-Agent: Mozilla Thunderbird Content-Language: en-US To: Binutils Cc: Matthieu Longo From: Jan Beulich Subject: [PATCH] ld/doc: properly separate @samp from @item Autocrypt: addr=jbeulich@suse.com; keydata= xsDiBFk3nEQRBADAEaSw6zC/EJkiwGPXbWtPxl2xCdSoeepS07jW8UgcHNurfHvUzogEq5xk hu507c3BarVjyWCJOylMNR98Yd8VqD9UfmX0Hb8/BrA+Hl6/DB/eqGptrf4BSRwcZQM32aZK 7Pj2XbGWIUrZrd70x1eAP9QE3P79Y2oLrsCgbZJfEwCgvz9JjGmQqQkRiTVzlZVCJYcyGGsD /0tbFCzD2h20ahe8rC1gbb3K3qk+LpBtvjBu1RY9drYk0NymiGbJWZgab6t1jM7sk2vuf0Py O9Hf9XBmK0uE9IgMaiCpc32XV9oASz6UJebwkX+zF2jG5I1BfnO9g7KlotcA/v5ClMjgo6Gl MDY4HxoSRu3i1cqqSDtVlt+AOVBJBACrZcnHAUSuCXBPy0jOlBhxPqRWv6ND4c9PH1xjQ3NP nxJuMBS8rnNg22uyfAgmBKNLpLgAGVRMZGaGoJObGf72s6TeIqKJo/LtggAS9qAUiuKVnygo 3wjfkS9A3DRO+SpU7JqWdsveeIQyeyEJ/8PTowmSQLakF+3fote9ybzd880fSmFuIEJldWxp Y2ggPGpiZXVsaWNoQHN1c2UuY29tPsJgBBMRAgAgBQJZN5xEAhsDBgsJCAcDAgQVAggDBBYC AwECHgECF4AACgkQoDSui/t3IH4J+wCfQ5jHdEjCRHj23O/5ttg9r9OIruwAn3103WUITZee e7Sbg12UgcQ5lv7SzsFNBFk3nEQQCACCuTjCjFOUdi5Nm244F+78kLghRcin/awv+IrTcIWF hUpSs1Y91iQQ7KItirz5uwCPlwejSJDQJLIS+QtJHaXDXeV6NI0Uef1hP20+y8qydDiVkv6l IreXjTb7DvksRgJNvCkWtYnlS3mYvQ9NzS9PhyALWbXnH6sIJd2O9lKS1Mrfq+y0IXCP10eS FFGg+Av3IQeFatkJAyju0PPthyTqxSI4lZYuJVPknzgaeuJv/2NccrPvmeDg6Coe7ZIeQ8Yj t0ARxu2xytAkkLCel1Lz1WLmwLstV30g80nkgZf/wr+/BXJW/oIvRlonUkxv+IbBM3dX2OV8 AmRv1ySWPTP7AAMFB/9PQK/VtlNUJvg8GXj9ootzrteGfVZVVT4XBJkfwBcpC/XcPzldjv+3 HYudvpdNK3lLujXeA5fLOH+Z/G9WBc5pFVSMocI71I8bT8lIAzreg0WvkWg5V2WZsUMlnDL9 mpwIGFhlbM3gfDMs7MPMu8YQRFVdUvtSpaAs8OFfGQ0ia3LGZcjA6Ik2+xcqscEJzNH+qh8V m5jjp28yZgaqTaRbg3M/+MTbMpicpZuqF4rnB0AQD12/3BNWDR6bmh+EkYSMcEIpQmBM51qM EKYTQGybRCjpnKHGOxG0rfFY1085mBDZCH5Kx0cl0HVJuQKC+dV2ZY5AqjcKwAxpE75MLFkr wkkEGBECAAkFAlk3nEQCGwwACgkQoDSui/t3IH7nnwCfcJWUDUFKdCsBH/E5d+0ZnMQi+G0A nAuWpQkjM1ASeQwSHEeAWPgskBQL X-Spam-Status: No, score=-3022.7 required=5.0 tests=BAYES_00, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, DKIM_VALID_EF, RCVD_IN_DNSWL_NONE, SPF_HELO_NONE, SPF_NONE, 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: binutils@sourceware.org X-Mailman-Version: 2.1.30 Precedence: list List-Id: Binutils mailing list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: binutils-bounces~patchwork=sourceware.org@sourceware.org At least makeinfo 4.13 doesn't tolerate @item@samp, considering it a single command. --- a/ld/ld.texi +++ b/ld/ld.texi @@ -8207,10 +8207,10 @@ property. By default, if the option is omitted and @samp{-z force-bti} is provided, warnings are emitted. @itemize -@item@samp{none} disables any warning messages. -@item@samp{warning} (the default value) emits warning messages when input objects +@item @samp{none} disables any warning messages. +@item @samp{warning} (the default value) emits warning messages when input objects composing the link unit are missing BTI markings. -@item@samp{error} turns the warning messages into errors. +@item @samp{error} turns the warning messages into errors. @end itemize If issues are found, a maximum of 20 messages will be emitted, and then a summary with the total number of issues will be displayed at the end. @@ -8225,11 +8225,11 @@ The @samp{-z gcs} option controls the ve markings on input objects and marks the output with GCS if all conditions are validated. @itemize -@item@samp{implicit} (default if @samp{-z gcs} is omitted) enables GCS marking +@item @samp{implicit} (default if @samp{-z gcs} is omitted) enables GCS marking on the output if, and only if, all input objects composing the link unit are marked with GCS. -@item@samp{always} forces the marking of the output with GCS. -@item@samp{never} ignores any GCS marking on the input objects, and does not +@item @samp{always} forces the marking of the output with GCS. +@item @samp{never} ignores any GCS marking on the input objects, and does not mark the output with GCS. @end itemize @@ -8240,11 +8240,11 @@ GCS markings on inputs, i.e. the GNU_PRO By default, if the option is omitted and @samp{-z gcs} is provided, warnings are emitted. @itemize -@item@samp{none} disables any warning messages. -@item@samp{warning} (the default value) emits warning messages when input objects +@item @samp{none} disables any warning messages. +@item @samp{warning} (the default value) emits warning messages when input objects composing the link unit are missing GCS markings, or dynamic objects containing external symbols used in the link unit. -@item@samp{error} turns the warning messages into errors. +@item @samp{error} turns the warning messages into errors. @end itemize If issues are found, a maximum of 20 messages will be emitted, and then a summary with the total number of issues will be displayed at the end.