{"id":2219852,"url":"http://patchwork.ozlabs.org/api/1.2/patches/2219852/?format=json","web_url":"http://patchwork.ozlabs.org/project/gcc/patch/20260404234813.676699-3-sloosemore@baylibre.com/","project":{"id":17,"url":"http://patchwork.ozlabs.org/api/1.2/projects/17/?format=json","name":"GNU Compiler Collection","link_name":"gcc","list_id":"gcc-patches.gcc.gnu.org","list_email":"gcc-patches@gcc.gnu.org","web_url":null,"scm_url":null,"webscm_url":null,"list_archive_url":"","list_archive_url_format":"","commit_url_format":""},"msgid":"<20260404234813.676699-3-sloosemore@baylibre.com>","list_archive_url":null,"date":"2026-04-04T23:48:13","name":"[PUSHED,3/3] doc: Copy-edit Picolibc option documentation","commit_ref":null,"pull_url":null,"state":"new","archived":false,"hash":"65fe08a5a794ab013d135aa15250d45dd8ee1c32","submitter":{"id":87955,"url":"http://patchwork.ozlabs.org/api/1.2/people/87955/?format=json","name":"Sandra Loosemore","email":"sloosemore@baylibre.com"},"delegate":null,"mbox":"http://patchwork.ozlabs.org/project/gcc/patch/20260404234813.676699-3-sloosemore@baylibre.com/mbox/","series":[{"id":498754,"url":"http://patchwork.ozlabs.org/api/1.2/series/498754/?format=json","web_url":"http://patchwork.ozlabs.org/project/gcc/list/?series=498754","date":"2026-04-04T23:48:11","name":"[PUSHED,1/3] doc: Rename \"Submodel Options\"","version":1,"mbox":"http://patchwork.ozlabs.org/series/498754/mbox/"}],"comments":"http://patchwork.ozlabs.org/api/patches/2219852/comments/","check":"pending","checks":"http://patchwork.ozlabs.org/api/patches/2219852/checks/","tags":{},"related":[],"headers":{"Return-Path":"","X-Original-To":["incoming@patchwork.ozlabs.org","gcc-patches@gcc.gnu.org"],"Delivered-To":["patchwork-incoming@legolas.ozlabs.org","gcc-patches@gcc.gnu.org"],"Authentication-Results":["legolas.ozlabs.org;\n\tdkim=pass (2048-bit key;\n unprotected) header.d=baylibre-com.20251104.gappssmtp.com\n header.i=@baylibre-com.20251104.gappssmtp.com header.a=rsa-sha256\n header.s=20251104 header.b=c/QsjfZw;\n\tdkim-atps=neutral","legolas.ozlabs.org;\n spf=pass (sender SPF authorized) smtp.mailfrom=gcc.gnu.org\n (client-ip=2620:52:6:3111::32; helo=vm01.sourceware.org;\n envelope-from=gcc-patches-bounces~incoming=patchwork.ozlabs.org@gcc.gnu.org;\n receiver=patchwork.ozlabs.org)","sourceware.org;\n\tdkim=pass (2048-bit key,\n unprotected) header.d=baylibre-com.20251104.gappssmtp.com\n header.i=@baylibre-com.20251104.gappssmtp.com header.a=rsa-sha256\n header.s=20251104 header.b=c/QsjfZw","sourceware.org;\n dmarc=none (p=none dis=none) header.from=baylibre.com","sourceware.org; spf=pass smtp.mailfrom=baylibre.com","server2.sourceware.org;\n arc=none smtp.remote-ip=209.85.161.54"],"Received":["from vm01.sourceware.org (vm01.sourceware.org\n [IPv6:2620:52:6:3111::32])\n\t(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)\n\t key-exchange x25519 server-signature ECDSA (secp384r1) server-digest SHA384)\n\t(No client certificate requested)\n\tby legolas.ozlabs.org (Postfix) with ESMTPS id 4fpC614nygz1xtJ\n\tfor ; Sun, 05 Apr 2026 09:51:05 +1000 (AEST)","from vm01.sourceware.org (localhost [127.0.0.1])\n\tby sourceware.org (Postfix) with ESMTP id 9B4954BA2E36\n\tfor ; Sat, 4 Apr 2026 23:51:03 +0000 (GMT)","from mail-oo1-f54.google.com (mail-oo1-f54.google.com\n [209.85.161.54])\n by sourceware.org (Postfix) with ESMTPS id 37B524BA2E29\n for ; Sat, 4 Apr 2026 23:48:28 +0000 (GMT)","by mail-oo1-f54.google.com with SMTP id\n 006d021491bc7-662efd1bdd4so1775032eaf.0\n for ; Sat, 04 Apr 2026 16:48:28 -0700 (PDT)","from nenufar.hsd1.co.comcast.net ([2601:281:d901:97c0::9a27])\n by smtp.gmail.com with ESMTPSA id\n 006d021491bc7-680a63c7fd1sm6100242eaf.8.2026.04.04.16.48.24\n (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256);\n Sat, 04 Apr 2026 16:48:26 -0700 (PDT)"],"DKIM-Filter":["OpenDKIM Filter v2.11.0 sourceware.org 9B4954BA2E36","OpenDKIM Filter v2.11.0 sourceware.org 37B524BA2E29"],"DMARC-Filter":"OpenDMARC Filter v1.4.2 sourceware.org 37B524BA2E29","ARC-Filter":"OpenARC Filter v1.0.0 sourceware.org 37B524BA2E29","ARC-Seal":"i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1775346508; cv=none;\n b=SZ2dKTsxYjzDcT8KNEYv5oofci9UvaLNzTm8OnirRp9AvX1cWI/B1lterGQngvfF8lpaff8U03g4Iy6AVf7Nk2DUd06kfDb4AkdDoDFSLuHC7AUlSHgnO5ji5pj6LAYWQNNCK8VOH8WVM/TxljpfW+D+n53OG1KUoxsvdl97iOI=","ARC-Message-Signature":"i=1; a=rsa-sha256; d=sourceware.org; s=key;\n t=1775346508; c=relaxed/simple;\n bh=rZsc2y+FQ5pZ2ieLPvlU+G4fToL/qZH7502CyZyTkec=;\n h=DKIM-Signature:From:To:Subject:Date:Message-Id:MIME-Version;\n b=S71WG5mli+Or1ZhNUCEPjiCARPQo4DRgqJbjNBgKg5jYEKtG+CceAmkBCeUlUmO8uJXa935aezUeyFgV4FBDbogQzfvH13BhJyompU/PaZsARZh9pi4re1CvJFgOJrEZP+3IKlIedjf+ZUo3w/nmSsuqhBeBYcFLtc7CQuCGG1g=","ARC-Authentication-Results":"i=1; server2.sourceware.org","DKIM-Signature":"v=1; a=rsa-sha256; c=relaxed/relaxed;\n d=baylibre-com.20251104.gappssmtp.com; s=20251104; t=1775346507;\n x=1775951307;\n darn=gcc.gnu.org;\n h=content-transfer-encoding:mime-version:references:in-reply-to\n :message-id:date:subject:to:from:from:to:cc:subject:date:message-id\n :reply-to; bh=CI6Eswd8t5RxpFVnRrCWL5MHN6atFwxS7uf0iRQDZfA=;\n b=c/QsjfZwg5UUlJHWOubUHJkpNQBncqGw4wJPn4JqTxhiUelU0ob0QZ9ipDPXyMuZPh\n f/7Uw/x3gN2aAaDPgEy234jliE+Hu9Inl1CC4S+TdElGAS+UutKpOwHQEFUxbS/S+7M7\n pGG9Emhy9FJw0fwRjsNttlvkjGpFd+XTQy2lRhyOJSjL/7DLylq14oBsd+Nhqq2t+NiC\n qlZly4BhtOpY0XLe9XRtbSIgSGM19SkwPdDwbkIbrDUtP+QCyZkHeM+toVDqTwj7B1/0\n K+OZQw9XzNe27BkbuDBhJinjmfB4CjZ4oS636NMES1rqbNnYhLa2yufCGyeETO9t4dDz\n Cqow==","X-Google-DKIM-Signature":"v=1; a=rsa-sha256; c=relaxed/relaxed;\n d=1e100.net; s=20251104; t=1775346507; x=1775951307;\n h=content-transfer-encoding:mime-version:references:in-reply-to\n :message-id:date:subject:to:from:x-gm-gg:x-gm-message-state:from:to\n :cc:subject:date:message-id:reply-to;\n bh=CI6Eswd8t5RxpFVnRrCWL5MHN6atFwxS7uf0iRQDZfA=;\n b=nerMyiCGoQ4iCdTVmIvzZZRxsvN0DYu6Cz5F7ruMCvtRB93h2zbvopWWAGH4qVGnMl\n qM8otIDvNvAM6Or+8kvQW5nP8Xbni/Z5GVPs8uMEyZxbFAoybWnTMwEhMQY5SHnPkqJ+\n I3YKXm9cgoPmxG5BzdgdByfm2elAbcNGmSlvnBblvkjfTSxO42SSZCvZG7Le31OGuVtU\n Ww7NSDwYYg0tfIaDdT2YIpGv0JTxh2Q+qA5gdUjjSfzLtRLZiXI9J2i1KWOH83/wqIpA\n dqEmSCbeqmNso3VnizukMbG93+X+fIamcNKKe+3sitCMU0p29E1bI1dGb35mYzBIthve\n 8llQ==","X-Gm-Message-State":"AOJu0YyASkQ8rc8pVhhV2CCsbXZD5c6Jzy7Uv8HuiOBySB2aSyO6RbPT\n e/hliyfJ9doAL1o1ngK4MbO+6yBCCxyqo75StWdXsDTP8kjzrtIsG05k5R9ZhjTCJYczk+bi1hC\n 9cDQL","X-Gm-Gg":"AeBDieuyN69luN4pqr4fFPAF9IxwxgxouY2rQifpMyRThX9fdTDruJ2a6qr+BKnQq5i\n kuu0cdF32WDg5CKoVs3LJ93XZJk7dZR6RlCfU4Q1QOCxtKF23uuOnPs1s5jMroH+/3no8Z05jOh\n BFm3ee50HzPyOolMPqQUUM76WPEbp3DEquVYdroqnrBnNmXXjsQjGTtP8hX20IfuMt4P54fVLY2\n NCkzVIO4Poogf/bUoQX1ycbkaYO5Ez+HkoXyy7aBLl8lU9wVIL7tAfwpY7Dss7/76gasYoPwyc7\n lAk9VX0VaACP5ZmaVrC2nsNeCY+fREsUTVZNy9yCdtwrZaZysIR1oiW9RBxTK2J6xU6kDhxMqZz\n H+tL2PVqVxiSgt0gHFgVxZvBg2AxyU3Cr4Jv0O6AZ9Kf5emSr6aI/H+jKRxNdjjDzykUs/VmB0e\n uX56AuqjhU0aa0k+R1nrOY+BnF+13w8n7D","X-Received":"by 2002:a05:6820:4b0d:b0:67e:432a:9c9 with SMTP id\n 006d021491bc7-6822152ac23mr3777281eaf.31.1775346507224;\n Sat, 04 Apr 2026 16:48:27 -0700 (PDT)","From":"Sandra Loosemore ","To":"gcc-patches@gcc.gnu.org","Subject":"[PUSHED 3/3] doc: Copy-edit Picolibc option documentation","Date":"Sat, 4 Apr 2026 17:48:13 -0600","Message-Id":"<20260404234813.676699-3-sloosemore@baylibre.com>","X-Mailer":"git-send-email 2.34.1","In-Reply-To":"<20260404234813.676699-1-sloosemore@baylibre.com>","References":"<20260404234813.676699-1-sloosemore@baylibre.com>","MIME-Version":"1.0","Content-Transfer-Encoding":"8bit","X-BeenThere":"gcc-patches@gcc.gnu.org","X-Mailman-Version":"2.1.30","Precedence":"list","List-Id":"Gcc-patches mailing list ","List-Unsubscribe":",\n ","List-Archive":"","List-Post":"","List-Help":"","List-Subscribe":",\n ","Errors-To":"gcc-patches-bounces~incoming=patchwork.ozlabs.org@gcc.gnu.org"},"content":"gcc/ChangeLog\n\t* doc/invoke.texi (Picolibc Options): Copy-edit for markup, use\n\tof proper names, etc.\n---\n gcc/doc/invoke.texi | 26 ++++++++++++++------------\n 1 file changed, 14 insertions(+), 12 deletions(-)","diff":"diff --git a/gcc/doc/invoke.texi b/gcc/doc/invoke.texi\nindex 68f0b3b2270..4b208344398 100644\n--- a/gcc/doc/invoke.texi\n+++ b/gcc/doc/invoke.texi\n@@ -30853,10 +30853,10 @@ allocator is used.\n \n @node Picolibc Options\n @subsection Picolibc Options\n-@cindex picolibc options\n-@cindex options, picolibc\n+@cindex Picolibc options\n+@cindex options, Picolibc\n \n-These options control compilation and linking when using picolibc:\n+These options control compilation and linking when using Picolibc:\n \n @table @gcctabopt\n @opindex oslib\n@@ -30865,7 +30865,7 @@ Search the library named @var{library} after the C library, permitting\n symbols undefined by the C library to be defined by this library. The\n C library, libgcc and this library are placed between\n @option{--start-group} and @option{--end-group} flags so that each can\n-refer to symbols in the others. For many targets, picolibc provides a\n+refer to symbols in the others. For many targets, Picolibc provides a\n @samp{semihost} variant (specified with @option{--oslib=semihost})\n which provides enough basic OS functionality to support console and\n file I/O when run in an emulator or when using an in-circuit debugger.\n@@ -30874,29 +30874,30 @@ file I/O when run in an emulator or when using an in-circuit debugger.\n @item --crt0=@r{[}none@r{|}minimal@r{|}hosted@r{|}semihost@r{]}\n Replace the default @file{crt0.o} name with\n @file{crt0-@var{variant}.o}. The @samp{none} variant provides no\n-startup code at all, allowing the user to supply their\n+startup code at all, allowing you to supply your\n own. @samp{minimal} performs basic memory setup but does not invoke\n any constructors. When no @option{-crt0} option is provided, the\n default initialization code adds calls to all\n constructors. @samp{hosted} adds a call to @code{exit} when\n-@code{main} returns. @samp{semihost} accesses a command line parameter\n+@code{main} returns. @samp{semihost} accesses a command-line parameter\n supplied via the semihosting interface and splits that into arguments\n at whitespace boundaries, passing the resulting array of strings to\n-main in @code{argc} and @code{argv}. On some targets, including\n-aarch64, arc, arm, loongarch, m68k, riscv, super-h and x86,\n+@code{main} in @code{argc} and @code{argv}. On some targets, including\n+AArch64, ARC, ARM, LoongArch, M680x0, RISC-V, SH, and x86,\n @samp{semihost} also traps hardware exceptions and prints information\n to the console. Note that @option{--crt0=semihost} depends upon APIs\n provided by @option{--oslib=semihost}.\n \n @opindex printf\n @item --printf=@r{[}d@r{|}f@r{|}l@r{|}i@r{|}m@r{]}\n-Select the printf variant. Picolibc provides five different printf\n+Select the @code{printf} variant.\n+Picolibc provides five different @code{printf}\n variants which offer decreasing levels of functionality along with\n decreasing code size. @samp{d} is the default level, offering full C17\n and POSIX.1-2024 conformance. @samp{f} provides the same feature set,\n but supports @code{float} values instead of @code{double} which are\n passed using the @code{printf_float} macro. @samp{l} elides all\n-floating point and POSIX positional parameter support. @samp{i} limits\n+floating-point and POSIX positional parameter support. @samp{i} limits\n integers to those no larger than @code{long}. @samp{m} removes support\n for most formatting options including width and precision. The formats\n and arguments are still parsed correctly, but output does not respect\n@@ -30904,13 +30905,14 @@ those parameters.\n \n @opindex scanf\n @item --scanf=@r{[}d@r{|}f@r{|}l@r{|}i@r{|}m@r{]}\n-Select the scanf variant. Picolibc provides five different scanf\n+Select the @code{scanf} variant.\n+Picolibc provides five different @code{scanf}\n variants which offer decreasing levels of functionality along with\n decreasing code size. @samp{d} is the default level, offering full C17\n and POSIX.1-2024 conformance. @samp{f} removes support for\n @code{double} values. @samp{l} elides all floating point\n support. @samp{i} limits integers to those no larger than\n-@code{long}. @samp{m} removes support for @code{%[} conversion specifiers.\n+@code{long}. @samp{m} removes support for @samp{%[} conversion specifiers.\n \n @end table\n \n","prefixes":["PUSHED","3/3"]}