From patchwork Fri Jun 21 23:51:59 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Jonathan Corbet X-Patchwork-Id: 167422 Delivered-To: patch@linaro.org Received: by 2002:a92:4782:0:0:0:0:0 with SMTP id e2csp1345593ilk; Fri, 21 Jun 2019 16:52:17 -0700 (PDT) X-Google-Smtp-Source: APXvYqwFoGWkW+kdJBzOiLLh2JCFyX2A8wGJYLBZFpOgzWT8lIztUQEXBXQacQD2EAly168KRiqU X-Received: by 2002:a17:902:112c:: with SMTP id d41mr22398019pla.33.1561161137340; Fri, 21 Jun 2019 16:52:17 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1561161137; cv=none; d=google.com; s=arc-20160816; b=y6M6Q9T6rsH9YFCTHx6sorfjgUSpc5+db6092jW2PcILNTxeXjq23ks/vB3ASWFUyc U2LHZiqKufP6KP+oHrYMNz7piKuZTQhaJyo3sR6udZvx3EWQNITfRvfTjAWYsU8Phbct JhfOfLY19wdAbEHlj9nSXB6pNtPMtIeOaTvVPCcrcPVitkt6c9enLBUcvyuSfGQf4xcS enxt99ipsu54kW1f42V+K2RCh9TtWMZ6KkGcU1mo4ctgkpBoEjgMRgsSJb3itNrVcvw9 9rOUGltHVsHsNtKXdZ7749UpzLsTdhCwFbmcAtD8Jqbw+rU4/+Twy2ymMp19STcGvMNG XLmw== 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=Oa9+1xHetzpBDql6VMhl9F1f0yYZpn6g4DlnWuUCoaYQWQoYQ+Sy98pgyd7GrD0s4R 21KFRofX9ldmWlmS4P2Q4Vm6z3wrQXLKklJuhOFXLw1rDfj3NxsO+Uyldb5H6RzYkQMM 3GZGVGMrEy/WwKsHZSAWbcQlJ3FAom+2M9K6HDkVRYfBRxdUqLYe8XJXgFLiBUSz0ZOw e1Cj6FLN0OFoJbjh8Vio7EPmSCO40X4f5ok3kOxTmL9cTOMbABUo2h3YgVPAsYHGZ7mA mb89hzn8ZfOZP8/VLS3bi+XqoDVWyRoeH3McWrnET4HI2pj0bdEl9uf+ooqUFgzP872s NMXw== 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 o127si3794191pga.593.2019.06.21.16.52.17; Fri, 21 Jun 2019 16:52:17 -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 S1726231AbfFUXwP (ORCPT + 30 others); Fri, 21 Jun 2019 19:52:15 -0400 Received: from ms.lwn.net ([45.79.88.28]:55312 "EHLO ms.lwn.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1726194AbfFUXwM (ORCPT ); Fri, 21 Jun 2019 19:52:12 -0400 Received: from meer.lwn.net (localhost [127.0.0.1]) by ms.lwn.net (Postfix) with ESMTPA id AB32F537; Fri, 21 Jun 2019 23:52:11 +0000 (UTC) From: Jonathan Corbet To: linux-doc@vger.kernel.org Cc: Matthew Wilcox , Mauro Carvalho Chehab , Jani Nikula , linux-kernel@vger.kernel.org, Jonathan Corbet Subject: [PATCH 3/3] kernel-doc: Don't try to mark up function names Date: Fri, 21 Jun 2019 17:51:59 -0600 Message-Id: <20190621235159.6992-4-corbet@lwn.net> X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190621235159.6992-1-corbet@lwn.net> References: <20190621235159.6992-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>`"],