From patchwork Wed Aug 14 10:53:59 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Masahiro Yamada X-Patchwork-Id: 171268 Delivered-To: patch@linaro.org Received: by 2002:a92:d204:0:0:0:0:0 with SMTP id y4csp657239ily; Wed, 14 Aug 2019 03:54:44 -0700 (PDT) X-Google-Smtp-Source: APXvYqzibuBvrNU4m8oZZZzCJVY1maX/xKKP3jg5tf0k7u2CUx7bFfD8m0ABAZ0SaWxAZIqBuIvv X-Received: by 2002:a17:90a:de02:: with SMTP id m2mr6633490pjv.18.1565780084168; Wed, 14 Aug 2019 03:54:44 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1565780084; cv=none; d=google.com; s=arc-20160816; b=MjsY57ca3oJHZ+uGkJyH7Ep0VnDxYWtenxSUww6UGEbKrKlbIdpAwpI71/FIkhH58S yWR0cDM0MYlU382bR94RpL2uTSsADb2OCpiZ+MOebQ4OnRK989PtqNyg+AvLLL52P4lf g5CsE/JCf1k3PZ3B17D7HL1XQKefSbGw3fk6zoad0VsALHLCgBeWxF3dt9dHI5Ck2RIm sUgXCsgO1L6fc9K/m9LyXuvds8ijVKSPqWgzFzpJx74609wBjo0MXzbMkkF8ZTjUY47E 5I+At304lCgDQgiYjqbGf7VCwHOBqAH29sL0LYAm2Ke/kl6eJxlrY08NSk+fjpw25NO/ v4ag== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:references:in-reply-to:message-id:date :subject:cc:to:from:dkim-signature:dkim-filter; bh=KNIkl3BaVdtuV4S46GHgiFB1XPYspoKpIq3NRC3qoAc=; b=DEylrrZFBDJlkekzrdXCa75KxDaLsefii0ZZCJxenah3+qiuEUyx8+VPKWkn/QeBIE 3HuKM2UJMJ/grROE9HyE8eRJczTmLhW0gqsqbRFnPP/UKJlAuu0BCYG35JYrLVlzGq1R 52uQKjMWx610ae2ReK0yE8d4h+/OGrWIjmP6UkIK5E4kQYwYjIbmoF4UGAMQ7clU8IpL 5P8e1rHPGX6U5Kf7uMT28gSqi5nXA+LBZZ/8M5alUX/DsNyQfuSG4goKCHzRnj5n8cDV /ypacFo1W3DekEVmihCSXvnwci8aWZMBiKV0UblFV4YCf0PdItWgJEkDaKlvePTyYPbc pPsg== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@nifty.com header.s=dec2015msa header.b=TDbpOJbv; 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 66si6081206pff.223.2019.08.14.03.54.43; Wed, 14 Aug 2019 03:54:44 -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; dkim=pass header.i=@nifty.com header.s=dec2015msa header.b=TDbpOJbv; 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 S1727754AbfHNKym (ORCPT + 28 others); Wed, 14 Aug 2019 06:54:42 -0400 Received: from conuserg-12.nifty.com ([210.131.2.79]:52498 "EHLO conuserg-12.nifty.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1726383AbfHNKyf (ORCPT ); Wed, 14 Aug 2019 06:54:35 -0400 Received: from grover.flets-west.jp (softbank126125143222.bbtec.net [126.125.143.222]) (authenticated) by conuserg-12.nifty.com with ESMTP id x7EAs34Y024567; Wed, 14 Aug 2019 19:54:04 +0900 DKIM-Filter: OpenDKIM Filter v2.10.3 conuserg-12.nifty.com x7EAs34Y024567 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=nifty.com; s=dec2015msa; t=1565780045; bh=KNIkl3BaVdtuV4S46GHgiFB1XPYspoKpIq3NRC3qoAc=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=TDbpOJbvMqNT0bpf/NUssvpsQHzkNV6FB4VdlAUtvotQm1rWW8tDgDAUe7tkK1F9R 1g4GtGTWqs3yNSOUlzFCWeE7K/t7fBkPfIwvOh/j9W90tSmmljVautvqFrUHCi3x7S Jo0CuOD3N+WSHdPil+YAmNpmnq1yqD5Ax2agYtiTfKdoYAFe18dSMOv6pQcDNmHqnS dil2G4VDtBBlj28TTw4HyBEEsdTNTKB1lcCWl5BuqipeMjdDj/25FIrTGn9SRNx6Xg 1efOCbkA0C1RC04xLqLyvceuq+jOrpaMTdkmlI0HOsbG+2kcsQDnF8CwOJpmWoXwm4 cVQ1FslrsnCdQ== X-Nifty-SrcIP: [126.125.143.222] From: Masahiro Yamada To: Jonathan Corbet , linux-doc@vger.kernel.org Cc: Masahiro Yamada , Michal Marek , linux-kbuild@vger.kernel.org, linux-kernel@vger.kernel.org Subject: [PATCH 1/2] docs: kbuild: fix invalid ReST syntax Date: Wed, 14 Aug 2019 19:53:59 +0900 Message-Id: <20190814105400.1339-2-yamada.masahiro@socionext.com> X-Mailer: git-send-email 2.17.1 In-Reply-To: <20190814105400.1339-1-yamada.masahiro@socionext.com> References: <20190814105400.1339-1-yamada.masahiro@socionext.com> Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org I see the following warnings when I open this document with a ReST viewer, retext: /home/masahiro/ref/linux/Documentation/kbuild/makefiles.rst:1142: (WARNING/2) Inline emphasis start-string without end-string. /home/masahiro/ref/linux/Documentation/kbuild/makefiles.rst:1152: (WARNING/2) Inline emphasis start-string without end-string. /home/masahiro/ref/linux/Documentation/kbuild/makefiles.rst:1154: (WARNING/2) Inline emphasis start-string without end-string. These hunks were added by commit e846f0dc57f4 ("kbuild: add support for ensuring headers are self-contained") and commit 1e21cbfada87 ("kbuild: support header-test-pattern-y"), respectively. They were written not for ReST but for the plain text, and merged via the kbuild tree. In the same development cycle, this document was converted to ReST by commit cd238effefa2 ("docs: kbuild: convert docs to ReST and rename to *.rst"), and merged via the doc sub-system. Merging them together into Linus' tree resulted in the current situation. To fix the syntax, surround the asterisks with back-quotes, and use :: for the code sample. Fixes: 39ceda5ce1b0 ("Merge tag 'kbuild-v5.3' of git://git.kernel.org/pub/scm/linux/kernel/git/masahiroy/linux-kbuild") Signed-off-by: Masahiro Yamada --- Documentation/kbuild/makefiles.rst | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) -- 2.17.1 diff --git a/Documentation/kbuild/makefiles.rst b/Documentation/kbuild/makefiles.rst index f4f0f7ffde2b..b4c28c543d72 100644 --- a/Documentation/kbuild/makefiles.rst +++ b/Documentation/kbuild/makefiles.rst @@ -1139,7 +1139,7 @@ When kbuild executes, the following steps are followed (roughly): header-test-y - header-test-y specifies headers (*.h) in the current directory that + header-test-y specifies headers (`*.h`) in the current directory that should be compile tested to ensure they are self-contained, i.e. compilable as standalone units. If CONFIG_HEADER_TEST is enabled, this builds them as part of extra-y. @@ -1147,11 +1147,11 @@ When kbuild executes, the following steps are followed (roughly): header-test-pattern-y This works as a weaker version of header-test-y, and accepts wildcard - patterns. The typical usage is: + patterns. The typical usage is:: - header-test-pattern-y += *.h + header-test-pattern-y += *.h - This specifies all the files that matches to '*.h' in the current + This specifies all the files that matches to `*.h` in the current directory, but the files in 'header-test-' are excluded. 6.7 Commands useful for building a boot image