From nobody Sat May 4 07:03:35 2024 Delivered-To: importer@patchew.org Authentication-Results: mx.zohomail.com; dkim=fail; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=fail(p=none dis=none) header.from=linaro.org ARC-Seal: i=1; a=rsa-sha256; t=1604939245; cv=none; d=zohomail.com; s=zohoarc; b=mRpTq+NxwRddrCjVYjDeIeHo9L9M1p1mGeBsV9cjd0cy6dKMkfAouBBrPFZB1SqhYlaKBhbPhvyfJqb/wjp3aGhwgMQqfmFlmXOHRkGAeGAjlld13GBHJtUq3zFegQ0KMWyFb6GPCVpHwOMsgkbCa4sHRIrUHayk+iEdzJZGPes= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1604939245; h=Content-Transfer-Encoding:Cc:Date:From:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:Sender:Subject:To; bh=2Kp5G6NAl/4Ozn39Fuzw1TyeEONDPWC9AzDa/Y76zzs=; b=SJkCSZ/5TMdVL6C3dzTzLdDzHSGE/gxYh5DQXVPdD2z9vVW1t5X41s1O6jGBqkP7mNlL4Ov7ywxqZAK0uEYEi9WLaT01OO2aQn5doqyiezAAlx0aWyu+0B8c5vmy88DV5D478zE40mvvslexsHhS+V6DscX50Kj02Bli3TAcZtI= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=fail; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=fail header.from= (p=none dis=none) header.from= Return-Path: Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) by mx.zohomail.com with SMTPS id 1604939245498747.8666818293966; Mon, 9 Nov 2020 08:27:25 -0800 (PST) Received: from localhost ([::1]:58186 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kcA0p-0006IE-Mw for importer@patchew.org; Mon, 09 Nov 2020 11:27:23 -0500 Received: from eggs.gnu.org ([2001:470:142:3::10]:48810) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kc9zv-0005qB-BI for qemu-devel@nongnu.org; Mon, 09 Nov 2020 11:26:27 -0500 Received: from mail-wr1-x432.google.com ([2a00:1450:4864:20::432]:34560) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1kc9zt-00013m-D9 for qemu-devel@nongnu.org; Mon, 09 Nov 2020 11:26:26 -0500 Received: by mail-wr1-x432.google.com with SMTP id r17so5417615wrw.1 for ; Mon, 09 Nov 2020 08:26:24 -0800 (PST) Received: from orth.archaic.org.uk (orth.archaic.org.uk. [81.2.115.148]) by smtp.gmail.com with ESMTPSA id j127sm14168976wma.31.2020.11.09.08.26.22 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 09 Nov 2020 08:26:22 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; h=from:to:cc:subject:date:message-id:mime-version :content-transfer-encoding; bh=2Kp5G6NAl/4Ozn39Fuzw1TyeEONDPWC9AzDa/Y76zzs=; b=QRTcLLmOWTaORQ5GaVmNXspbSP5lxiAUNlETusbxcfF+m1xiFkZljiQq/SKui9BQrg wR9E8R4Oot8ijhhhC4Tc8ZNFmVg2TiYNZPNVFkrHTRDXSmh/c3LyUPIm0amnG1xIGdD4 ZLmftP0Pczz7jYZea2gMM/WvQ8RxJrsPbaG3uDrthezFcTFQOkpdxmDkOGno2xgb3yNB 4iUot0d/dZnYmXwCjVZlskKNc9PD1mOe09A+lAENKtElekCsoBjICQ5+Gukh+b4bL6AJ 1i6f0EXXSRldZm+ADU25RvyP1Lmjn3PInEfUt1lolqAmm6pmbunmaX5vjVIy7jzCwMt1 xacQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:mime-version :content-transfer-encoding; bh=2Kp5G6NAl/4Ozn39Fuzw1TyeEONDPWC9AzDa/Y76zzs=; b=qzTDd3x/ypcUNvh8yNoAAAi8QU7vzP6ZuPNaJj4METYWCUmjLA9ew5psHtBY5VpdCB UIPnLPJ6iQhtHOMtxNW1+1eYYsplYM+15DK0LYyiLyRxYiRmiySvXYEZJ/1wTSuoGMHC ns8BuKUCwwMWHKfET4yCCkeCiU2ff+AtpIlzecZN2fdF9g5wHRNrRzUOWfp1YdlI32wo yVYTQciDI0a13eojqEW9UEG6cgCq3aeu1fBlSAPvHaEu+sZbMr8z7sWyWkxW+eU2LR3B 6N1Yo/aHHP16nulZzL56qbdImhVocfFJiLcuGclAh6FlGaRwIDgyFNtU/OIDu0NSfoCO 9vHA== X-Gm-Message-State: AOAM532NIxyLSyzPlx7+DBZhY1VXfMeLHoYKJS+TXpdWXDXU1HFtc17v kIUhTBoJqGh56Ha9Xa2u9/16CNKnyHAzSw== X-Google-Smtp-Source: ABdhPJw3xp8EgAP+2O+P2qlivMoY6H97SrKAEgGTUo57ZMV7zw4ly/GN642OUUVS6Z7cOBNOiAdVlQ== X-Received: by 2002:adf:f24b:: with SMTP id b11mr4316680wrp.342.1604939183496; Mon, 09 Nov 2020 08:26:23 -0800 (PST) From: Peter Maydell To: qemu-devel@nongnu.org Subject: [PATCH] qtest: Update references to parse_escape() in comments Date: Mon, 9 Nov 2020 16:26:21 +0000 Message-Id: <20201109162621.18885-1-peter.maydell@linaro.org> X-Mailer: git-send-email 2.20.1 MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists.gnu.org; Received-SPF: pass client-ip=2a00:1450:4864:20::432; envelope-from=peter.maydell@linaro.org; helo=mail-wr1-x432.google.com X-detected-operating-system: by eggs.gnu.org: No matching host in p0f cache. That's all we know. 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, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Laurent Vivier , Paolo Bonzini , Thomas Huth , Markus Armbruster Errors-To: qemu-devel-bounces+importer=patchew.org@nongnu.org Sender: "Qemu-devel" X-ZohoMail-DKIM: fail (Header signature does not verify) Content-Type: text/plain; charset="utf-8" In commit 61030280ca2d67bd in 2018 we renamed the parse_escape() function to parse_interpolation(), but we didn't catch the references to this function in doc comments in libqtest.h. Update them. Signed-off-by: Peter Maydell Reviewed-by: Thomas Huth --- Side note: ideally we would document somewhere the accepted %-escapes rather than requiring people to read the source code to parse_interpolation to determine them... "The argument to %p is qobject_unref()ed" is particularly non-obvious. --- tests/qtest/libqos/libqtest.h | 18 +++++++++--------- tests/qtest/libqtest-single.h | 2 +- 2 files changed, 10 insertions(+), 10 deletions(-) diff --git a/tests/qtest/libqos/libqtest.h b/tests/qtest/libqos/libqtest.h index 5c959f18535..724f65aa947 100644 --- a/tests/qtest/libqos/libqtest.h +++ b/tests/qtest/libqos/libqtest.h @@ -88,7 +88,7 @@ void qtest_quit(QTestState *s); * @fds: array of file descriptors * @fds_num: number of elements in @fds * @fmt: QMP message to send to qemu, formatted like - * qobject_from_jsonf_nofail(). See parse_escape() for what's + * qobject_from_jsonf_nofail(). See parse_interpolation() for what's * supported after '%'. * * Sends a QMP message to QEMU with fds and returns the response. @@ -101,7 +101,7 @@ QDict *qtest_qmp_fds(QTestState *s, int *fds, size_t fd= s_num, * qtest_qmp: * @s: #QTestState instance to operate on. * @fmt: QMP message to send to qemu, formatted like - * qobject_from_jsonf_nofail(). See parse_escape() for what's + * qobject_from_jsonf_nofail(). See parse_interpolation() for what's * supported after '%'. * * Sends a QMP message to QEMU and returns the response. @@ -113,7 +113,7 @@ QDict *qtest_qmp(QTestState *s, const char *fmt, ...) * qtest_qmp_send: * @s: #QTestState instance to operate on. * @fmt: QMP message to send to qemu, formatted like - * qobject_from_jsonf_nofail(). See parse_escape() for what's + * qobject_from_jsonf_nofail(). See parse_interpolation() for what's * supported after '%'. * * Sends a QMP message to QEMU and leaves the response in the stream. @@ -138,7 +138,7 @@ void qtest_qmp_send_raw(QTestState *s, const char *fmt,= ...) * @fds: array of file descriptors * @fds_num: number of elements in @fds * @fmt: QMP message to send to QEMU, formatted like - * qobject_from_jsonf_nofail(). See parse_escape() for what's + * qobject_from_jsonf_nofail(). See parse_interpolation() for what's * supported after '%'. * @ap: QMP message arguments * @@ -152,7 +152,7 @@ QDict *qtest_vqmp_fds(QTestState *s, int *fds, size_t f= ds_num, * qtest_vqmp: * @s: #QTestState instance to operate on. * @fmt: QMP message to send to QEMU, formatted like - * qobject_from_jsonf_nofail(). See parse_escape() for what's + * qobject_from_jsonf_nofail(). See parse_interpolation() for what's * supported after '%'. * @ap: QMP message arguments * @@ -167,7 +167,7 @@ QDict *qtest_vqmp(QTestState *s, const char *fmt, va_li= st ap) * @fds: array of file descriptors * @fds_num: number of elements in @fds * @fmt: QMP message to send to QEMU, formatted like - * qobject_from_jsonf_nofail(). See parse_escape() for what's + * qobject_from_jsonf_nofail(). See parse_interpolation() for what's * supported after '%'. * @ap: QMP message arguments * @@ -181,7 +181,7 @@ void qtest_qmp_vsend_fds(QTestState *s, int *fds, size_= t fds_num, * qtest_qmp_vsend: * @s: #QTestState instance to operate on. * @fmt: QMP message to send to QEMU, formatted like - * qobject_from_jsonf_nofail(). See parse_escape() for what's + * qobject_from_jsonf_nofail(). See parse_interpolation() for what's * supported after '%'. * @ap: QMP message arguments * @@ -636,7 +636,7 @@ void qtest_add_abrt_handler(GHookFunc fn, const void *d= ata); * qtest_qmp_assert_success: * @qts: QTestState instance to operate on * @fmt: QMP message to send to qemu, formatted like - * qobject_from_jsonf_nofail(). See parse_escape() for what's + * qobject_from_jsonf_nofail(). See parse_interpolation() for what's * supported after '%'. * * Sends a QMP message to QEMU and asserts that a 'return' key is present = in @@ -683,7 +683,7 @@ void qtest_qmp_device_add_qdict(QTestState *qts, const = char *drv, * @driver: Name of the device that should be added * @id: Identification string * @fmt: QMP message to send to qemu, formatted like - * qobject_from_jsonf_nofail(). See parse_escape() for what's + * qobject_from_jsonf_nofail(). See parse_interpolation() for what's * supported after '%'. * * Generic hot-plugging test via the device_add QMP command. diff --git a/tests/qtest/libqtest-single.h b/tests/qtest/libqtest-single.h index 176979a2ce9..0d7f568678e 100644 --- a/tests/qtest/libqtest-single.h +++ b/tests/qtest/libqtest-single.h @@ -47,7 +47,7 @@ static inline void qtest_end(void) /** * qmp: * @fmt...: QMP message to send to qemu, formatted like - * qobject_from_jsonf_nofail(). See parse_escape() for what's + * qobject_from_jsonf_nofail(). See parse_interpolation() for what's * supported after '%'. * * Sends a QMP message to QEMU and returns the response. --=20 2.20.1