{"id":2237916,"url":"http://patchwork.ozlabs.org/api/patches/2237916/?format=json","web_url":"http://patchwork.ozlabs.org/project/qemu-devel/patch/20260513-error-v1-1-49fa04bc5c22@9elements.com/","project":{"id":14,"url":"http://patchwork.ozlabs.org/api/projects/14/?format=json","name":"QEMU Development","link_name":"qemu-devel","list_id":"qemu-devel.nongnu.org","list_email":"qemu-devel@nongnu.org","web_url":"","scm_url":"","webscm_url":"","list_archive_url":"","list_archive_url_format":"","commit_url_format":""},"msgid":"<20260513-error-v1-1-49fa04bc5c22@9elements.com>","list_archive_url":null,"date":"2026-05-13T15:06:40","name":"docs/devel: Fix formatting of `Error **`","commit_ref":null,"pull_url":null,"state":"new","archived":false,"hash":"51548ba7af6488cf525a9e5161d7943614071904","submitter":{"id":93413,"url":"http://patchwork.ozlabs.org/api/people/93413/?format=json","name":"J. Neuschäfer","email":"j.neuschaefer@9elements.com"},"delegate":null,"mbox":"http://patchwork.ozlabs.org/project/qemu-devel/patch/20260513-error-v1-1-49fa04bc5c22@9elements.com/mbox/","series":[{"id":504178,"url":"http://patchwork.ozlabs.org/api/series/504178/?format=json","web_url":"http://patchwork.ozlabs.org/project/qemu-devel/list/?series=504178","date":"2026-05-13T15:06:40","name":"docs/devel: Fix formatting of `Error **`","version":1,"mbox":"http://patchwork.ozlabs.org/series/504178/mbox/"}],"comments":"http://patchwork.ozlabs.org/api/patches/2237916/comments/","check":"pending","checks":"http://patchwork.ozlabs.org/api/patches/2237916/checks/","tags":{},"related":[],"headers":{"Return-Path":"","X-Original-To":"incoming@patchwork.ozlabs.org","Delivered-To":"patchwork-incoming@legolas.ozlabs.org","Authentication-Results":["legolas.ozlabs.org;\n\tdkim=pass (2048-bit key;\n secure) header.d=9elements.com header.i=@9elements.com header.a=rsa-sha256\n header.s=google header.b=HRyuJ86K;\n\tdkim-atps=neutral","legolas.ozlabs.org;\n spf=pass (sender SPF authorized) smtp.mailfrom=nongnu.org\n (client-ip=209.51.188.17; helo=lists1p.gnu.org;\n envelope-from=qemu-devel-bounces+incoming=patchwork.ozlabs.org@nongnu.org;\n receiver=patchwork.ozlabs.org)"],"Received":["from lists1p.gnu.org (lists1p.gnu.org [209.51.188.17])\n\t(using TLSv1.2 with cipher ECDHE-ECDSA-AES256-GCM-SHA384 (256/256 bits))\n\t(No client certificate requested)\n\tby legolas.ozlabs.org (Postfix) with ESMTPS id 4gFy5Y3cw4z1yKH\n\tfor ; Thu, 14 May 2026 01:27:59 +1000 (AEST)","from localhost ([::1] helo=lists1p.gnu.org)\n\tby lists1p.gnu.org with esmtp (Exim 4.90_1)\n\t(envelope-from )\n\tid 1wNBTx-0005qp-2u; Wed, 13 May 2026 11:26:45 -0400","from eggs.gnu.org ([2001:470:142:3::10])\n by lists1p.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)\n (Exim 4.90_1) (envelope-from )\n id 1wNBAs-0007Lg-Qh\n for qemu-devel@nongnu.org; Wed, 13 May 2026 11:07:02 -0400","from mail-wm1-x32c.google.com ([2a00:1450:4864:20::32c])\n by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128)\n (Exim 4.90_1) (envelope-from )\n id 1wNBAp-0004o4-71\n for qemu-devel@nongnu.org; Wed, 13 May 2026 11:07:01 -0400","by mail-wm1-x32c.google.com with SMTP id\n 5b1f17b1804b1-488af96f6b2so82805455e9.0\n for ; Wed, 13 May 2026 08:06:57 -0700 (PDT)","from [127.0.1.1]\n (2a0a-a54a-ed40-0-9db4-bb9-3f9b-5d0a.ipv6dyn.netcologne.de.\n [2a0a:a54a:ed40:0:9db4:bb9:3f9b:5d0a])\n by smtp.gmail.com with ESMTPSA id\n 5b1f17b1804b1-48fc8d74536sm84562975e9.15.2026.05.13.08.06.55\n (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256);\n Wed, 13 May 2026 08:06:55 -0700 (PDT)"],"DKIM-Signature":"v=1; a=rsa-sha256; c=relaxed/relaxed;\n d=9elements.com; s=google; t=1778684816; x=1779289616; darn=nongnu.org;\n h=cc:to:message-id:content-transfer-encoding:mime-version:subject\n :date:from:from:to:cc:subject:date:message-id:reply-to;\n bh=My9t1yQ3RBTsiolupNmLSZbb/0fb6M5VMt5LGJLo5m8=;\n b=HRyuJ86Ka6SLHWveB7sRVyTpfiv7fKqb4SuSwaC7d940V2MIhBLXPIwL/5CQQ2HU9J\n 4QR1H3BgMzPLsagj6W/sGDf7nv+ukri49XYRNw+0gXUXuwcAUxamh7uhZ3n0pP1ic4cS\n n80WddMV5hqMGPd1eXTvAbNzW1+GH15waR5zs/SN6GGUdl5Bd1XjDnmtNlcgnM3oDtRH\n mcK/eMDTYk9o5KfYeiuqUU26haH8Ld6fKlLniJPWEtcFTvWN4NgqhEojq0eIEDDucY/E\n OBW4f0s5udijnXolYkmWTl1J+48uE1vTjYe5xyt5ayESxktwG+QdiTEEk8E+unzAdp5G\n 6kkg==","X-Google-DKIM-Signature":"v=1; a=rsa-sha256; c=relaxed/relaxed;\n d=1e100.net; s=20251104; t=1778684816; x=1779289616;\n h=cc:to:message-id:content-transfer-encoding:mime-version:subject\n :date:from:x-gm-gg:x-gm-message-state:from:to:cc:subject:date\n :message-id:reply-to;\n bh=My9t1yQ3RBTsiolupNmLSZbb/0fb6M5VMt5LGJLo5m8=;\n b=pVduuY0RM0fzF7BhUAdz4lmg9Wxl7rBUp2XTFyd1ZqPKY1bRmTLY6P9PPPICJgH8f2\n Fx3MI6n5I1bAz1S3oGGAPW6jme+qvvzKsCKYRjaLKOrqFKBykzmw3YH6D1I2k5xx9Umo\n BYmjNfo//VTOyGOBrcAi35JlHRyMQA4p9OAqQRaC5m5OYvwLg3eT3qAj9NM/J9YwabvH\n ecVtotIftiMerjI59IZU+0AvbmvVOBLuJPHf2eGswoZEuMkXxZTtKOcxMtrMN2rYa3a9\n 1TkNPgLPoG17S7EXJZo45FACCCIIceKPcaO5gSwLc4rOqqxQWr7eabyGXyEVBgsjO3Jq\n O/hg==","X-Gm-Message-State":"AOJu0YzkgYmTYJNvmxGl9jnVTou04oiZX/xew1IwE4wQuupAdk2PHh9k\n nnOewykHotP6UyW6mRU//dvzIA/cPJCiIQhV0Ye3ITlT7Y53BFmBIfxn1wwOnsiIgBM=","X-Gm-Gg":"Acq92OGAZZSNiKrQsCXoa9M4wYBMZYRf9IxpAvxOakbx1XafhVfeRY4Vp9hdBNPd/H+\n uEFtE6pADyDGYZW/x8nLU0mWAJreaXtfQtsstepHnTHa1hcFc9UMEULJwsOwh97Zo06s+OeahVe\n h2NUnTouAGjkNmCdPXY+JPaDTw8ZZUL9JWJYqW83FarriuqU5nhbxCKZ5tUP4B/DZwYe87eY3NG\n P+qwpDbxst2JofnivwgD4oKDt1XWMAh/fWfeV5j6U0AfqjIgTBX/I/F0oG9YxiQxGIMkIZgIpDP\n xW5kBuZFWMPeXrrwDIWTdG0tHdyp2ygXJWOs6xNHYD+Y8kSS0eXOdUEquoL9i2VUkbLvR0Py7WI\n ZINDLsNSyhQtUbLMsH5cjrhssJ3Tv65fRky4RiRA7LRmpXZ2dMDihjw+ktvBjNep7YNB+j9nULT\n gXpyrU53CIZOdgF8nfofbBdbmySebyd8ACSrigfl5MKF1rr37SzIKXuA/tUQEQVV+w73WrfW3cJ\n Q6r8BtFAzaW77HGEVoBuE/vRuE=","X-Received":"by 2002:a05:600c:45cd:b0:489:1ff1:74d3 with SMTP id\n 5b1f17b1804b1-48fc9a3abcdmr57148545e9.20.1778684816149;\n Wed, 13 May 2026 08:06:56 -0700 (PDT)","From":"=?utf-8?q?J=2E_Neusch=C3=A4fer?= ","Date":"Wed, 13 May 2026 17:06:40 +0200","Subject":"[PATCH] docs/devel: Fix formatting of `Error **`","MIME-Version":"1.0","Content-Type":"text/plain; charset=\"utf-8\"","Content-Transfer-Encoding":"8bit","Message-Id":"<20260513-error-v1-1-49fa04bc5c22@9elements.com>","X-B4-Tracking":"v=1; b=H4sIAH+TBGoC/6tWKk4tykwtVrJSqFYqSi3LLM7MzwNyDHUUlJIzE\n vPSU3UzU4B8JSMDIzMDU0Nj3dSiovwiXTNzkzQL8zSDFGMLQyWg2oKi1LTMCrA50bG1tQC9TLF\n fVwAAAA==","X-Change-ID":"20260513-error-674f87f0d381","To":"qemu-devel@nongnu.org","Cc":"=?utf-8?q?Alex_Benn=C3=A9e?= , =?utf-8?q?Daniel_?=\n\t=?utf-8?q?P=2E_Berrang=C3=A9?= ,\n Markus Armbruster , =?utf-8?q?Philippe_Mathieu-Daud?=\n\t=?utf-8?q?=C3=A9?= ,\n Pierrick Bouvier , =?utf-8?q?J=2E_Neusch?=\n\t=?utf-8?q?=C3=A4fer?= ","X-Mailer":"b4 0.14.2","X-Developer-Signature":"v=1; a=ed25519-sha256; t=1778684815; l=1641;\n i=j.neuschaefer@9elements.com; s=20260513; h=from:subject:message-id;\n bh=j9+BX6VljcD6t2FOsgbZCaYWSkniTu2UUrB14j+SD0U=;\n b=2p7GtFEuTY4y7EcvUq1okqv2+bJx7zYGyFV5iucqNR78NensT//vCdFXjtT50y3dLSeTrdL7B\n cw+Gz5cH8ddAwx5brhXkNgoPD5xjRTtcXXuAMTiqQtOUM6M34IVhKBY","X-Developer-Key":"i=j.neuschaefer@9elements.com; a=ed25519;\n pk=mytxDu9ALv0FsWdexvpDMisghxetVpsZ8NdmY/FGsgY=","Received-SPF":"pass client-ip=2a00:1450:4864:20::32c;\n envelope-from=j.neuschaefer@9elements.com; helo=mail-wm1-x32c.google.com","X-Spam_score_int":"-20","X-Spam_score":"-2.1","X-Spam_bar":"--","X-Spam_report":"(-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1,\n DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1,\n RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001,\n SPF_PASS=-0.001 autolearn=ham autolearn_force=no","X-Spam_action":"no action","X-Mailman-Approved-At":"Wed, 13 May 2026 11:26:43 -0400","X-BeenThere":"qemu-devel@nongnu.org","X-Mailman-Version":"2.1.29","Precedence":"list","List-Id":"qemu development ","List-Unsubscribe":",\n ","List-Archive":"","List-Post":"","List-Help":"","List-Subscribe":",\n ","Errors-To":"qemu-devel-bounces+incoming=patchwork.ozlabs.org@nongnu.org","Sender":"qemu-devel-bounces+incoming=patchwork.ozlabs.org@nongnu.org"},"content":"Since the ReST conversion, Error ** is expressed as Error ``*````*``, which is\nrendered in HTML as Error *````*. Fix it so the HTML output resembles the\nintended C syntax.\n\nFixes: 336a7451e8 (\"docs: convert README, CODING_STYLE and HACKING to RST syntax\")\nSigned-off-by: J. Neuschäfer \n---\n docs/devel/style.rst | 4 ++--\n 1 file changed, 2 insertions(+), 2 deletions(-)\n\n\n---\nbase-commit: 45cad8beca3ad75ebe63a36fdc60c98395fd2df1\nchange-id: 20260513-error-674f87f0d381\n\nBest regards,","diff":"diff --git a/docs/devel/style.rst b/docs/devel/style.rst\nindex 12e509d10de0b8c044c8429aaaee8855bde1deb5..b8edcf9316f059fe15415543098118b28fcaf99c 100644\n--- a/docs/devel/style.rst\n+++ b/docs/devel/style.rst\n@@ -784,10 +784,10 @@ error, non-negative / -errno, non-null / null, or Error objects.\n Example: when a function returns a non-null pointer on success, and it\n can fail only in one way (as far as the caller is concerned), returning\n null on failure is just fine, and certainly simpler and a lot easier on\n-the eyes than propagating an Error object through an Error ``*````*`` parameter.\n+the eyes than propagating an Error object through an ``Error **`` parameter.\n \n Example: when a function's callers need to report details on failure\n-only the function really knows, use Error ``*````*``, and set suitable errors.\n+only the function really knows, use ``Error **``, and set suitable errors.\n \n Do not report an error to the user when you're also returning an error\n for somebody else to handle. Leave the reporting to the place that\n","prefixes":[]}