From nobody Fri Dec 19 04:29:29 2025 Delivered-To: importer@patchew.org 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; Authentication-Results: mx.zohomail.com; dkim=pass; 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=pass(p=none dis=none) header.from=linaro.org ARC-Seal: i=1; a=rsa-sha256; t=1586882021; cv=none; d=zohomail.com; s=zohoarc; b=GEaTJtdWvvBGCBAZLI+kflRZAIjQ/sJf6U75CiJc2wlx8FV3cJQnMIqMJvm3fryKTWywI734hJj4VFCO5VSJ7wUiDPOZhMr/gmoFfQFK4Dz48d3uW0tPJ5KFxA6Hn+isHaASiEqfFM2FdQaX/LyW5AVSdtOS0bfTzS4anZiR/Uc= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1586882021; h=Content-Type:Content-Transfer-Encoding:Date:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:To; bh=CT6aAVcPUz2WZ3lRhtbSp2EjDloFUvZAespPdqcpC9E=; b=gEdB+WheT1R0H1b9MZFi7hlMf5h5P5uHqEYurymLKF1L6qixjIsUvvDqLZI7mIa22ufpJk2Y9XpP0y+kxVmI0841Cm+KTlKHljGvcNIQFvEMiKCWvQcS7HxrnCM1/PKjHodBCOOJ7/4i/BwU1ym86mNqxllqI9P6BzeWpDHXTM0= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; 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=pass 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 1586882021634294.62575241189177; Tue, 14 Apr 2020 09:33:41 -0700 (PDT) Received: from localhost ([::1]:34208 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jOOVI-0000y3-6j for importer@patchew.org; Tue, 14 Apr 2020 12:33:40 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:51699) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jOOOP-0005HI-2a for qemu-devel@nongnu.org; Tue, 14 Apr 2020 12:26:37 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1jOOOJ-0007D6-9J for qemu-devel@nongnu.org; Tue, 14 Apr 2020 12:26:32 -0400 Received: from mail-wr1-x42a.google.com ([2a00:1450:4864:20::42a]:40612) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1jOOOJ-0007Co-3g for qemu-devel@nongnu.org; Tue, 14 Apr 2020 12:26:27 -0400 Received: by mail-wr1-x42a.google.com with SMTP id h26so3664388wrb.7 for ; Tue, 14 Apr 2020 09:26:27 -0700 (PDT) Received: from orth.archaic.org.uk (orth.archaic.org.uk. [81.2.115.148]) by smtp.gmail.com with ESMTPSA id i129sm20003802wmi.20.2020.04.14.09.26.24 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 14 Apr 2020 09:26:24 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; h=from:to:subject:date:message-id:in-reply-to:references:mime-version :content-transfer-encoding; bh=CT6aAVcPUz2WZ3lRhtbSp2EjDloFUvZAespPdqcpC9E=; b=HjQ6P6C4yF4NvN7JhraDlJHbmOouFej0kqSeTCysuSkPPIAodUe+opKqEXLf7d/uAM 2M7mGudwijJGz4nh8k693y61Cvmt3fMk1cOsSHPl1UqwAFwZrf1IPLbOSVYKXKMC+aEr iO8Euh4aKpE/YtyBzKTBAHcxMPHk1BwL0fIJguzsG9PpZfDc/kPahwEK9HbVF6QzgMuV jwoDYz8yyesPd/Hy0fHOxiYN6z+jg3FrGqA286wXE9pGvxqbJnpJih7MD1tOXmk4LMcb E04EEv41YlhjN0X8gZmKk9jmdIupAXKpG0xffdD8V+31+WH6q0rQVW+/jC51eY9ueDQw Y0RA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:subject:date:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=CT6aAVcPUz2WZ3lRhtbSp2EjDloFUvZAespPdqcpC9E=; b=oFnW00WIO6XTN3aeEJdN0XxuD9BAa9HsphDjJFY+ywj5cMJAjhJlGOBWeibfNwjm/O VTI3lkZ7shoC7ouvR/5j4o8Ek26yNEzSHv9esOJUW2TXm0bk4eo3CKrYgkNEpOeD/cTv /tQNuhJtn9Kc9kizSkiUAZxXZfrVMmLrgVUP4vkhSovMpZ1fibZC26E8VLNOVbNybnjE EF4zwLpIo4FEBIr7630+xnCZ1eGR10Y5RxyoxHUxJBjLXVgh2Evwc4gqqS8iVLrYpPe+ 6bJU8VXgVP/KtXAvMxV6lcP9CHrgCplE/6bXE/MqtdIiqFpMMCYK1QLIDBeswc5sSiFc kp2Q== X-Gm-Message-State: AGi0PuYXD40x8p24psZ9hMggpSre+t0j6iRpoRUbMG+LW79XWSb11VJc 2IBrZuOL7KYgh8/rAlkO3UFCMceMvmq1zQ== X-Google-Smtp-Source: APiQypKG3C43RgNJcUN6r2R1h71f+0t8LnipJIHurLzluICiHimSkVNKstqNgTRbP9q6TIunNeH7sQ== X-Received: by 2002:adf:e691:: with SMTP id r17mr24723255wrm.421.1586881585571; Tue, 14 Apr 2020 09:26:25 -0700 (PDT) From: Peter Maydell To: qemu-devel@nongnu.org Subject: [PULL 09/12] scripts/kernel-doc: Add missing close-paren in c:function directives Date: Tue, 14 Apr 2020 17:26:10 +0100 Message-Id: <20200414162613.4479-10-peter.maydell@linaro.org> X-Mailer: git-send-email 2.20.1 In-Reply-To: <20200414162613.4479-1-peter.maydell@linaro.org> References: <20200414162613.4479-1-peter.maydell@linaro.org> MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-Received-From: 2a00:1450:4864:20::42a 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: , Errors-To: qemu-devel-bounces+importer=patchew.org@nongnu.org Sender: "Qemu-devel" X-ZohoMail-DKIM: pass (identity @linaro.org) When kernel-doc generates a 'c:function' directive for a function one of whose arguments is a function pointer, it fails to print the close-paren after the argument list of the function pointer argument, for instance in the memory API documentation: .. c:function:: void memory_region_init_resizeable_ram (MemoryRegion * mr= , struct Object * owner, const char * name, uint64_t size, uint64_t max_siz= e, void (*resized) (const char*, uint64_t length, void *host, Error ** errp) which should have a ')' after the 'void *host' which is the last argument to 'resized'. Older versions of Sphinx don't try to parse the argumnet to c:function, but Sphinx 3.0 does do this and will complain: /home/petmay01/linaro/qemu-from-laptop/qemu/docs/../include/exec/memory.h= :834: WARNING: Error in declarator or parameters Invalid C declaration: Expecting "," or ")" in parameters, got "EOF". [er= ror at 208] void memory_region_init_resizeable_ram (MemoryRegion * mr, struct Objec= t * owner, const char * name, uint64_t size, uint64_t max_size, void (*resi= zed) (const char*, uint64_t length, void *host, Error ** errp) -----------------------------------------------------------------------= ---------------------------------------------------------------------------= --------------------------------------------------------------^ Add the missing close-paren. Signed-off-by: Peter Maydell Reviewed-by: Richard Henderson Message-id: 20200411182934.28678-3-peter.maydell@linaro.org Reviewed-by: Alex Benn=C3=A9e --- scripts/kernel-doc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/scripts/kernel-doc b/scripts/kernel-doc index af470eb3211..8dc30e01e58 100755 --- a/scripts/kernel-doc +++ b/scripts/kernel-doc @@ -853,7 +853,7 @@ sub output_function_rst(%) { =20 if ($type =3D~ m/([^\(]*\(\*)\s*\)\s*\(([^\)]*)\)/) { # pointer-to-function - print $1 . $parameter . ") (" . $2; + print $1 . $parameter . ") (" . $2 . ")"; } else { print $type . " " . $parameter; } --=20 2.20.1