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 From patchwork Wed Aug 14 10:54:00 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Masahiro Yamada X-Patchwork-Id: 171267 Delivered-To: patch@linaro.org Received: by 2002:a92:d204:0:0:0:0:0 with SMTP id y4csp657175ily; Wed, 14 Aug 2019 03:54:39 -0700 (PDT) X-Google-Smtp-Source: APXvYqyOfQuIctsynxpTEXTlWU5XhERX+rcXR7guQdinzksI7Ea8FN0DRaIDZU+2LGBRyKUinSEa X-Received: by 2002:a17:902:141:: with SMTP id 59mr42931116plb.324.1565780079024; Wed, 14 Aug 2019 03:54:39 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1565780079; cv=none; d=google.com; s=arc-20160816; b=hRCkYKwC7EnsSgdFJ6g+TBEu9Hx9oQZYba1ZbadIXRfkAU292xCmLXVXDyr07NQbjI Haxt9Ekqzfe7bc3L4k5PJsqqopCH3B7vqojvofrpE/B/G6HCvbWGufDeMtZzM0xjD8Ra OYH2TfpT0z5stL5YpJAzonp0UKb7EhjsvKOcEY4QZcdstX9y05Ic3TzUIixpwYjx3gJm dgow0oql/tt0XncYm9KaiuvTHIajILxSyVGnVfVQzkoZN81S7BIwShl+17WA52Ma+6Nj kUrzvksWhIpkZhO6L5TVchLQ9RlfPMwDISSiZsvgKCUsHQk5MWikHR949mH7+dzNweJM Vj6w== 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=Hfj4V/SBxgMk8U6X1oeV3V2ByVnCtLeD3aXokuYTB1c=; b=zBLpIe15d7475D8HD+nt25H1qv/Y871Yk4RNl4VjTa4Au/1+LO0QkfQUt5oCwnmUme S9mQ45KjFvac003yJMQ+VwS3Xb4V7goiaVu6sHxmVhDRz7rjoM2Q0nm0PuReG6XMUqq/ sbx8kgeHaWNDh2i/rJIA3y8Jcrsd8zTwk5tVdQvGZYJL1bB/n+8XWGUAxKb38zEkBwD4 ETfZ0WHwS1bgjXv7wC1LkS3gE9iSQ0ie1HjRypiIR7pK1VP+PIFMAT/Ef3ZktTVGz0KQ mZpqaa2CmY0gedLVQPwWl/QYiASlygfrNuEk/wrhS91rrL3US0UpS9KgEb+MLT29lv5b c65g== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@nifty.com header.s=dec2015msa header.b=BUATFTtS; 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 u96si2764250pjb.34.2019.08.14.03.54.38; Wed, 14 Aug 2019 03:54:39 -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=BUATFTtS; 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 S1727692AbfHNKyh (ORCPT + 28 others); Wed, 14 Aug 2019 06:54:37 -0400 Received: from conuserg-12.nifty.com ([210.131.2.79]:52502 "EHLO conuserg-12.nifty.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1727110AbfHNKyf (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 x7EAs34Z024567; Wed, 14 Aug 2019 19:54:05 +0900 DKIM-Filter: OpenDKIM Filter v2.10.3 conuserg-12.nifty.com x7EAs34Z024567 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=nifty.com; s=dec2015msa; t=1565780045; bh=Hfj4V/SBxgMk8U6X1oeV3V2ByVnCtLeD3aXokuYTB1c=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=BUATFTtS5AvC8UcDPz6n9Zj9WT0D6gRgAi+/ewDBpRFbUUu08HiVa0LeFInEI4ylJ FR4qubC6Z2NH08PWOPzRKylDm+VaZS1qgpkO2PwPrPG6Zzyjry/vvyUi/dowm+0G/C Jy3o5wQWqOnJlNmC5B8gXJNn4gHgtzTfY51QYvV7EBpE8cOysywhvLLnUMEIxdSTbl HTID/JZomIaSP7c+lhSztnQSRWv6ngVNn/8jV9ZR4B7/o2E7Trh2/3z/MfF0sdy4hu bnle3vHXyJTPDu5Rfu4L2PEQEKl5hCMgPhalgJk6y4pEqumiEUPWPJ46Y/+a5e068n 1lhb9Sv0xLdgA== 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 2/2] docs: kbuild: remove cc-ldoption from document again Date: Wed, 14 Aug 2019 19:54:00 +0900 Message-Id: <20190814105400.1339-3-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 Commit 055efab3120b ("kbuild: drop support for cc-ldoption") correctly removed the cc-ldoption from Documentation/kbuild/makefiles.txt, but commit cd238effefa2 ("docs: kbuild: convert docs to ReST and rename to *.rst") revived it. I guess it was a rebase mistake. Remove it again. Fixes: cd238effefa2 ("docs: kbuild: convert docs to ReST and rename to *.rst") Signed-off-by: Masahiro Yamada --- Documentation/kbuild/makefiles.rst | 15 --------------- 1 file changed, 15 deletions(-) -- 2.17.1 diff --git a/Documentation/kbuild/makefiles.rst b/Documentation/kbuild/makefiles.rst index b4c28c543d72..7971729d1fd4 100644 --- a/Documentation/kbuild/makefiles.rst +++ b/Documentation/kbuild/makefiles.rst @@ -471,21 +471,6 @@ more details, with real examples. The second argument is optional, and if supplied will be used if first argument is not supported. - cc-ldoption - cc-ldoption is used to check if $(CC) when used to link object files - supports the given option. An optional second option may be - specified if first option are not supported. - - Example:: - - #arch/x86/kernel/Makefile - vsyscall-flags += $(call cc-ldoption, -Wl$(comma)--hash-style=sysv) - - In the above example, vsyscall-flags will be assigned the option - -Wl$(comma)--hash-style=sysv if it is supported by $(CC). - The second argument is optional, and if supplied will be used - if first argument is not supported. - as-instr as-instr checks if the assembler reports a specific instruction and then outputs either option1 or option2