From nobody Tue Feb 10 19:09:49 2026 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of _spf.google.com designates 209.85.221.53 as permitted sender) client-ip=209.85.221.53; envelope-from=philippe.mathieu.daude@gmail.com; helo=mail-wr1-f53.google.com; Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of _spf.google.com designates 209.85.221.53 as permitted sender) smtp.mailfrom=philippe.mathieu.daude@gmail.com ARC-Seal: i=1; a=rsa-sha256; t=1639832686; cv=none; d=zohomail.com; s=zohoarc; b=lbp5NjDIS6+mS0TXlXP9OCGxsNx2wg7BWEZdtzZTfG/IN+tiNX0dPbHoubZiR8nreIlLWagUOfw4ZzEA/V10BA5vHZQ5bARv0JZZ5/ZtsyaC1ZFR0iaatqP3xKOArw9wWyG60dIrXRAASPksdkpIWrXEDSaLOJFygOEzGNtKIwk= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1639832686; h=Content-Type:Content-Transfer-Encoding:Cc:Date:From:In-Reply-To:MIME-Version:Message-ID:References:Sender:Subject:To; bh=nYRF7Ay5OmCxJuygY/6kEra6OgWNJoLw6b9JAs3k8BU=; b=O5v5JR/Egi4ncrecWtKv1Wx2nO8xX61HLWvS+gqDp4rMrMkpVdZalSkfy82upzaF5e555VfV4ib0SqnCzBeXTsG49AyPZIzkmlANu5s1mlkY6hcSYkGCobdZCwGWLrH2JdWlSxTzMmI34aSX2FhwbtmRl0wPrSN0P4ClP8SpreQ= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of _spf.google.com designates 209.85.221.53 as permitted sender) smtp.mailfrom=philippe.mathieu.daude@gmail.com Received: from mail-wr1-f53.google.com (mail-wr1-f53.google.com [209.85.221.53]) by mx.zohomail.com with SMTPS id 1639832686097394.4361598431823; Sat, 18 Dec 2021 05:04:46 -0800 (PST) Received: by mail-wr1-f53.google.com with SMTP id v11so9344423wrw.10 for ; Sat, 18 Dec 2021 05:04:45 -0800 (PST) Return-Path: Return-Path: Received: from x1w.. (174.red-83-50-185.dynamicip.rima-tde.net. [83.50.185.174]) by smtp.gmail.com with ESMTPSA id n1sm12456386wrc.54.2021.12.18.05.04.43 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 18 Dec 2021 05:04:44 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=sender:from:to:cc:subject:date:message-id:in-reply-to:references :mime-version:content-transfer-encoding; bh=nYRF7Ay5OmCxJuygY/6kEra6OgWNJoLw6b9JAs3k8BU=; b=Shd/zgl3ELASaHx9wYSpKSpYkTvs9+mfYx8Zs1hReJVHtAkLgsaC4VCZX/62bHNpYx bcj1eIlZynEEPlR44NHnZirUCNq5Snpm9GcNG2Ac0UE3KD/uwy5Kwg+SGrsgVtlMNyZC qyOE1WCt7ZGA5kXjvfo+0xsDIezMmvoZmJPJ+/ioRq511m2WEAJZca+Cw+5cDaUiTeoC L8yN1ZstmBSRzOeGR35qPvZmLjATm1e2pyG6eyqXBJLQmy2QJJ9dNI5iB/lps6nGa91o nkaoz8hkvs15im8aFY1tc0vDR1Dv+epQAOMzMNXe1/M9F81bVNBdp5GYbBDSPpBewp5d u+3w== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:sender:from:to:cc:subject:date:message-id :in-reply-to:references:mime-version:content-transfer-encoding; bh=nYRF7Ay5OmCxJuygY/6kEra6OgWNJoLw6b9JAs3k8BU=; b=nc0B5eVtKZIRSkL631pAqFiY3j0fNpUvOCFTQHB/eOC0a1e/8ppHIm3tnvtUSWUd4m /nCBqkXo3X7dbshOSdXp1t/u9ccwQl16Tf9Zsn9ey760oN2JGyaWApizdVdryo8RG64k M7PUwdw7obMyFcuRak26Lf3cyq+wHIbEhUHme79b822RnueAuJgrCTxccdLCDb2K929y RilLku7Za2n90cE+3b7XXcSSyCWc1fuk3l+G3B9EYoIa+r8vx3VYu5xgL2Pn4mtdjfij TksWi+tf+agfbA6E0AdA01mlEf0PgpmyABdPkJ8VTgNrFxfdcrt3/6nBTlTR6DFb8zVs 7umw== X-Gm-Message-State: AOAM533VJPUaONldWgWUOYoQ9fdbtrlvZ4Ypmq84qi0Fg9YSEJZgwbt3 +c5qYLLSmAauCJ47ahxHP64= X-Google-Smtp-Source: ABdhPJze2AoGxcaNhhLfnqvIHl4vgbhOWKltiE50QHLnG110Iwfpjyxn5rdDtpz2b5jJZbN0nRWfnw== X-Received: by 2002:a05:6000:1aca:: with SMTP id i10mr6427715wry.407.1639832684399; Sat, 18 Dec 2021 05:04:44 -0800 (PST) Sender: =?UTF-8?Q?Philippe_Mathieu=2DDaud=C3=A9?= From: =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= To: qemu-devel@nongnu.org Cc: Yanan Wang , Richard Henderson , Eduardo Habkost , qemu-trivial@nongnu.org, Peter Maydell , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= Subject: [PATCH v2 1/5] hw/qdev: Cosmetic around documentation Date: Sat, 18 Dec 2021 14:04:33 +0100 Message-Id: <20211218130437.1516929-2-f4bug@amsat.org> X-Mailer: git-send-email 2.33.1 In-Reply-To: <20211218130437.1516929-1-f4bug@amsat.org> References: <20211218130437.1516929-1-f4bug@amsat.org> MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable X-ZohoMail-DKIM: pass (identity @gmail.com) X-ZM-MESSAGEID: 1639832687381100001 Add empty lines to have a clearer distinction between different functions declarations. Signed-off-by: Philippe Mathieu-Daud=C3=A9 Reviewed-by: Yanan Wang --- include/hw/qdev-core.h | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/include/hw/qdev-core.h b/include/hw/qdev-core.h index 20d3066595e..59a822ffceb 100644 --- a/include/hw/qdev-core.h +++ b/include/hw/qdev-core.h @@ -321,6 +321,7 @@ compat_props_add(GPtrArray *arr, * The returned object has a reference count of 1. */ DeviceState *qdev_new(const char *name); + /** * qdev_try_new: Try to create a device on the heap * @name: device type to create @@ -329,6 +330,7 @@ DeviceState *qdev_new(const char *name); * does not exist, rather than asserting. */ DeviceState *qdev_try_new(const char *name); + /** * qdev_realize: Realize @dev. * @dev: device to realize @@ -347,6 +349,7 @@ DeviceState *qdev_try_new(const char *name); * qdev_realize_and_unref() instead. */ bool qdev_realize(DeviceState *dev, BusState *bus, Error **errp); + /** * qdev_realize_and_unref: Realize @dev and drop a reference * @dev: device to realize @@ -372,6 +375,7 @@ bool qdev_realize(DeviceState *dev, BusState *bus, Erro= r **errp); * would be incorrect. For that use case you want qdev_realize(). */ bool qdev_realize_and_unref(DeviceState *dev, BusState *bus, Error **errp); + /** * qdev_unrealize: Unrealize a device * @dev: device to unrealize @@ -450,6 +454,7 @@ typedef enum { * For named input GPIO lines, use qdev_get_gpio_in_named(). */ qemu_irq qdev_get_gpio_in(DeviceState *dev, int n); + /** * qdev_get_gpio_in_named: Get one of a device's named input GPIO lines * @dev: Device whose GPIO we want @@ -497,6 +502,7 @@ qemu_irq qdev_get_gpio_in_named(DeviceState *dev, const= char *name, int n); * For named output GPIO lines, use qdev_connect_gpio_out_named(). */ void qdev_connect_gpio_out(DeviceState *dev, int n, qemu_irq pin); + /** * qdev_connect_gpio_out: Connect one of a device's anonymous output GPIO = lines * @dev: Device whose GPIO to connect @@ -524,6 +530,7 @@ void qdev_connect_gpio_out(DeviceState *dev, int n, qem= u_irq pin); */ void qdev_connect_gpio_out_named(DeviceState *dev, const char *name, int n, qemu_irq pin); + /** * qdev_get_gpio_out_connector: Get the qemu_irq connected to an output GP= IO * @dev: Device whose output GPIO we are interested in @@ -541,6 +548,7 @@ void qdev_connect_gpio_out_named(DeviceState *dev, cons= t char *name, int n, * by the platform-bus subsystem. */ qemu_irq qdev_get_gpio_out_connector(DeviceState *dev, const char *name, i= nt n); + /** * qdev_intercept_gpio_out: Intercept an existing GPIO connection * @dev: Device to intercept the outbound GPIO line from @@ -582,6 +590,7 @@ BusState *qdev_get_child_bus(DeviceState *dev, const ch= ar *name); * hold of an input GPIO line to manipulate it. */ void qdev_init_gpio_in(DeviceState *dev, qemu_irq_handler handler, int n); + /** * qdev_init_gpio_out: create an array of anonymous output GPIO lines * @dev: Device to create output GPIOs for @@ -610,6 +619,7 @@ void qdev_init_gpio_in(DeviceState *dev, qemu_irq_handl= er handler, int n); * handler. */ void qdev_init_gpio_out(DeviceState *dev, qemu_irq *pins, int n); + /** * qdev_init_gpio_out: create an array of named output GPIO lines * @dev: Device to create output GPIOs for @@ -623,6 +633,7 @@ void qdev_init_gpio_out(DeviceState *dev, qemu_irq *pin= s, int n); */ void qdev_init_gpio_out_named(DeviceState *dev, qemu_irq *pins, const char *name, int n); + /** * qdev_init_gpio_in_named_with_opaque: create an array of input GPIO lines * for the specified device --=20 2.33.1