Received: by 10.223.185.116 with SMTP id b49csp1040482wrg; Fri, 16 Feb 2018 11:18:13 -0800 (PST) X-Google-Smtp-Source: AH8x225t7B4ikNQ7BJo2LRjn9cIMH7UwHWFzQbp1TLK8EPByzT7lKVQRYq5HFAYu4ED7jIPwOpQP X-Received: by 10.98.210.70 with SMTP id c67mr2804423pfg.164.1518808693718; Fri, 16 Feb 2018 11:18:13 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1518808693; cv=none; d=google.com; s=arc-20160816; b=CVcdXD//ZoH8x9JuF5uVDypP1SY9LpeoWAK3MzDWDb0o/av96An7KIgWQUvSMNSweh 3HTFQL5Cchc2/HImbmsV8eL6vPthJJ2OxNWS1wPIQjRE6sy0yPfNx0QRuJegAwCMYR1t mQSP/Iy+B6opfqQRHZi+QuRJ1heNNYC8N/W2SdTZUraA7mmplRvV6qSPEbRQ5EKOEllF 0eB1C//dc6tHpORt7iNIm6R32OdmVvyr2tHn+b0R2xwmtHqspy7W1qXuX9P2+qAQW/uS URQRPcGiAhEKZZtahXR5Xf65bY+Gxcq+DwzDRPLuFjkXM9WVC+8tqrd0yRrvt6nt8eb9 5UjQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:to:references:message-id :content-transfer-encoding:cc:date:in-reply-to:from:subject :mime-version:arc-authentication-results; bh=j0wLXmzuVpCvaU823F3Tga0V6Rv6BOUCb5BlbNXQI70=; b=s5u8vMU8U87S1qrO4F2l4vtbnqPaDhn2JngujKVskEl7+aVjdHQs7b0QE/Y42S873z 7uG2D7/R/VsbQQsuIOCXEXKCMNgTNzJM/utEoXQA3o3Pd5W+lgbw0l2N6UziEgtpAqTE R9SZXyU6t4v8HupoP1el6a8zOJobGAbavl6RxqSUOrthrt3t9d3FfoQS3ffrfOdAPLdl Wil4t0EbELc4EGNZgn/407pXqzOLW0lNxrN4PknYoLhUxcWSCaFacqiL+5ZPe/S3R63s yO3gO/WjDerjMipqXXwhwcRAX1GtBnAFyxhO9AF7r1DiFfmAjOfGngm62AImbH/XCMM1 MCVA== 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 y8-v6si1486528plk.535.2018.02.16.11.17.59; Fri, 16 Feb 2018 11:18:13 -0800 (PST) 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 S1758500AbeBPQLG convert rfc822-to-8bit (ORCPT + 99 others); Fri, 16 Feb 2018 11:11:06 -0500 Received: from smtp2.goneo.de ([85.220.129.33]:47538 "EHLO smtp2.goneo.de" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1756775AbeBPQLE (ORCPT ); Fri, 16 Feb 2018 11:11:04 -0500 Received: from localhost (localhost [127.0.0.1]) by smtp2.goneo.de (Postfix) with ESMTP id 618D323F16C; Fri, 16 Feb 2018 17:11:02 +0100 (CET) X-Virus-Scanned: by goneo X-Spam-Flag: NO X-Spam-Score: -2.767 X-Spam-Level: X-Spam-Status: No, score=-2.767 tagged_above=-999 tests=[ALL_TRUSTED=-1, AWL=0.133, BAYES_00=-1.9] autolearn=ham Received: from smtp2.goneo.de ([127.0.0.1]) by localhost (smtp2.goneo.de [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id rVQbUtgECojw; Fri, 16 Feb 2018 17:11:01 +0100 (CET) Received: from [192.168.1.112] (dyndsl-031-150-100-249.ewe-ip-backbone.de [31.150.100.249]) by smtp2.goneo.de (Postfix) with ESMTPSA id DA53623F0DD; Fri, 16 Feb 2018 17:11:00 +0100 (CET) Content-Type: text/plain; charset=us-ascii Mime-Version: 1.0 (Mac OS X Mail 10.3 \(3273\)) Subject: Re: [PATCH 4/6] scripts: kernel-doc: support in-line comments on nested structs/unions From: Markus Heiser In-Reply-To: <20180216125651.45401575@vento.lan> Date: Fri, 16 Feb 2018 17:11:00 +0100 Cc: Linux Doc Mailing List , Mauro Carvalho Chehab , LKML , Jonathan Corbet , Jani Nikula Content-Transfer-Encoding: 8BIT Message-Id: <0BE9A02B-4870-4AA0-9165-44B98295EC07@darmarit.de> References: <54EF06CB-C31F-476D-B674-579E9385D635@darmarit.de> <20180216125651.45401575@vento.lan> To: Mauro Carvalho Chehab X-Mailer: Apple Mail (2.3273) Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org > Am 16.02.2018 um 15:56 schrieb Mauro Carvalho Chehab : > > Em Fri, 16 Feb 2018 15:52:33 +0100 > Markus Heiser escreveu: > >>> Am 16.02.2018 um 14:48 schrieb Mauro Carvalho Chehab : >>> >>> The parser at kernel-doc rejects names with dots in the middle. >>> Fix it, in order to support nested structs/unions. >>> >>> Tested-by: Jani Nikula >>> Signed-off-by: Mauro Carvalho Chehab >>> --- >>> scripts/kernel-doc | 2 +- >>> 1 file changed, 1 insertion(+), 1 deletion(-) >>> >>> diff --git a/scripts/kernel-doc b/scripts/kernel-doc >>> index fee8952037b1..06d7f3f2c094 100755 >>> --- a/scripts/kernel-doc >>> +++ b/scripts/kernel-doc >>> @@ -363,7 +363,7 @@ my $doc_sect = $doc_com . >>> my $doc_content = $doc_com_body . '(.*)'; >>> my $doc_block = $doc_com . 'DOC:\s*(.*)?'; >>> my $doc_inline_start = '^\s*/\*\*\s*$'; >>> -my $doc_inline_sect = '\s*\*\s*(@[\w\s]+):(.*)'; >>> +my $doc_inline_sect = '\s*\*\s*(@\s*[\w][\w\.]*\s*):(.*)'; >> >> Thanks! >> >> FWIW: added similar patch to python variant of kernel-doc: >> >> https://github.com/return42/linuxdoc/commit/5c5da9a >> >> rendered example: >> >> https://return42.github.io/linuxdoc/linuxdoc-howto/all-in-a-tumble.html#struct-my-long-struct > > On a quick look, on your example, bar2.barbar description looks different > than what we get from the perl version. > > There, it generates it as: > > ``bar2.barbar`` > Description for **barbar** inside **foo.bar2** very attentive, thanks a lot! When I implemented support for nested data types, I missed to fix the highlighting pattern of those. https://github.com/return42/linuxdoc/commit/4b43f419 rendered: https://return42.github.io/linuxdoc/linuxdoc-howto/all-in-a-tumble.html#struct-my-long-struct -- Markus --