From patchwork Wed Jun 26 17:28:58 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Jonathan Corbet X-Patchwork-Id: 167852 Delivered-To: patch@linaro.org Received: by 2002:a92:4782:0:0:0:0:0 with SMTP id e2csp1228735ilk; Wed, 26 Jun 2019 10:36:16 -0700 (PDT) X-Google-Smtp-Source: APXvYqyeK5yqObbS591trdpOisDHMf1ERSmmm4l13YCLmF1GyElxeY+O5rzf8VyWx5rWhRcY2n/1 X-Received: by 2002:a63:292:: with SMTP id 140mr3973733pgc.88.1561570576245; Wed, 26 Jun 2019 10:36:16 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1561570576; cv=none; d=google.com; s=arc-20160816; b=Fh1GQh+/LFOp8LTIBEkTBzsuweZBSJW+pSI2+m9CAmmEdShWIdm8HiRHlphosI+hSy AH/yYyNgbSvJ85jIiOrVBGmjV5Xs8qUUdtNpBfdJWMyczKKRa2ps/7siwI/nphicQztd iM9JGil6K4SFvM5RgBzYy9iN6w51Ea3hlv5yDiCM0J8NpY7Roaf2TJPCgUG2Vwpm8r9n VNhah++W8yDIJYOLfRp092fDsSuI/RoCEscMyzfQKKh22NF3AhHHufBRrCYEldl+pBIA a5zvVH1gqxMuxAFpfKJmtuo97MLRDeTALaYnGY7eDMDlrLpH+tpSaT7uKxomwQSXhuHt +HXA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from; bh=x6nrbAj8Hvi0rQQuCqn8cngYjqBqIRJSBPDvRsOZ0g0=; b=V8xEABW4dYRoVHMAcKigljZnp9ambqfgOu4sD3eXcPhPs4x3k7jgmtlzA34bc7j7ZT Q8J2YImTdbOGDFrTZsqmrGugEfILEnDjlE+9cud2zdADJjEtO4ke7CupFqvn8KKGdUmL aVyFZn5LF1Rb6Xd5d1Lxc/HARtksd2t8eOCAo/FvUC+v7QirnFW7KVJXrQ2ApvYNZ38s FaSdNMwMKrA+T8GopH3eakuE0gEr4ZDo2tLaxUDApMlh4Ey/yhNE/pVMyyaRc8zT3xxz LJsvE6DBMJcBS45A0eoNvkmsOPw8RL79V5rUAWYubsm3D1ld/LKwS+iatLcJl0rHCIXJ MMNA== ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Return-Path: Received: from vger.kernel.org (vger.kernel.org. [209.132.180.67]) by mx.google.com with ESMTP id v24si3690589ply.101.2019.06.26.10.36.15; Wed, 26 Jun 2019 10:36:16 -0700 (PDT) Received-SPF: pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) client-ip=209.132.180.67; Authentication-Results: mx.google.com; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1726667AbfFZRgO (ORCPT + 30 others); Wed, 26 Jun 2019 13:36:14 -0400 Received: from ms.lwn.net ([45.79.88.28]:40902 "EHLO ms.lwn.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1726481AbfFZRf4 (ORCPT ); Wed, 26 Jun 2019 13:35:56 -0400 Received: from meer.lwn.net (localhost [127.0.0.1]) by ms.lwn.net (Postfix) with ESMTPA id 7A3E65A0; Wed, 26 Jun 2019 17:29:11 +0000 (UTC) From: Jonathan Corbet To: linux-doc@vger.kernel.org Cc: Mauro Carvalho Chehab , Jani Nikula , linux-kernel@vger.kernel.org, Jonathan Corbet Subject: [PATCH v3 3/4] kernel-doc: Don't try to mark up function names Date: Wed, 26 Jun 2019 11:28:58 -0600 Message-Id: <20190626172859.16113-4-corbet@lwn.net> X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190626172859.16113-1-corbet@lwn.net> References: <20190626172859.16113-1-corbet@lwn.net> MIME-Version: 1.0 Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org We now have better automarkup in sphinx itself and, besides, this markup was incorrect and left :c:func: gunk in the processed docs. Sort of discouraging that nobody ever noticed...:) As a first step toward the removal of impenetrable regex magic from kernel-doc it's a tiny one, but you have to start somewhere. Signed-off-by: Jonathan Corbet --- scripts/kernel-doc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) -- 2.21.0 diff --git a/scripts/kernel-doc b/scripts/kernel-doc index c0cb41e65b9b..6b03012750da 100755 --- a/scripts/kernel-doc +++ b/scripts/kernel-doc @@ -249,7 +249,7 @@ my @highlights_rst = ( [$type_member_func, "\\:c\\:type\\:`\$1\$2\$3\\\\(\\\\) <\$1>`"], [$type_member, "\\:c\\:type\\:`\$1\$2\$3 <\$1>`"], [$type_fp_param, "**\$1\\\\(\\\\)**"], - [$type_func, "\\:c\\:func\\:`\$1()`"], + [$type_func, "\$1()"], [$type_enum, "\\:c\\:type\\:`\$1 <\$2>`"], [$type_struct, "\\:c\\:type\\:`\$1 <\$2>`"], [$type_typedef, "\\:c\\:type\\:`\$1 <\$2>`"],