From patchwork Sat Jul 15 01:52:13 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Mauro Carvalho Chehab X-Patchwork-Id: 788834 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from bombadil.infradead.org (bombadil.infradead.org [65.50.211.133]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 3x8XdQ21rMz9s81 for ; Sat, 15 Jul 2017 11:53:14 +1000 (AEST) Authentication-Results: ozlabs.org; dkim=pass (2048-bit key; unprotected) header.d=lists.infradead.org header.i=@lists.infradead.org header.b="k7G9QtTA"; dkim-atps=neutral DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=bombadil.20170209; h=Sender: Content-Transfer-Encoding:Content-Type:Cc:List-Subscribe:List-Help:List-Post: List-Archive:List-Unsubscribe:List-Id:MIME-Version:References:In-Reply-To: Message-ID:Subject:To:From:Date:Reply-To:Content-ID:Content-Description: Resent-Date:Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID: List-Owner; bh=nE99JWrmtALZvDEGe8BfqPU7bjzemlhnXrpmZkeigkk=; b=k7G9QtTATGOCd/ A0N9jiNyN/nvR0WO9cmHI6o4lTV1n26RHalTyyOaEYIEwUNWNHdpNuPa4zWeJCZJAClwyDy2cjW7x G39Lu98U/mrjr1dSrHwAWZX/LK/XjZyc+3IEGQl1D98NOME4JrJQFQgHQmNqGhlnnwrSOxCRK8ZYt CzOTF/aU2ZlGz3YR820mex9crBWJenPlvaGl9Bf7MQCHWS8O40F6vEDEkXgy1e3uQOX/oHVgiV5hU YOeMzT9QIS7RCBy8NbrrtxVkwypr1kImpzYylSYXYSN7iDVaiZBQoPGh9a3oSnuWLWY3viIHKwh7R 3o7m972LB52gcAojYrrQ==; Received: from localhost ([127.0.0.1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.87 #1 (Red Hat Linux)) id 1dWCGO-0006tV-Ow; Sat, 15 Jul 2017 01:52:56 +0000 Received: from ec2-52-27-115-49.us-west-2.compute.amazonaws.com ([52.27.115.49] helo=osg.samsung.com) by bombadil.infradead.org with esmtp (Exim 4.87 #1 (Red Hat Linux)) id 1dWCGK-0006UJ-QC for linux-mtd@lists.infradead.org; Sat, 15 Jul 2017 01:52:55 +0000 Received: from localhost (localhost [127.0.0.1]) by osg.samsung.com (Postfix) with ESMTP id 9A607A0D4D; Sat, 15 Jul 2017 01:52:54 +0000 (UTC) X-Virus-Scanned: amavisd-new at osg.samsung.com Received: from osg.samsung.com ([127.0.0.1]) by localhost (s-opensource.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id y3ZvYit3LT6r; Sat, 15 Jul 2017 01:52:53 +0000 (UTC) Received: from vento.lan (unknown [189.61.49.22]) by osg.samsung.com (Postfix) with ESMTPSA id C5DADA0CAD; Sat, 15 Jul 2017 01:52:47 +0000 (UTC) Date: Fri, 14 Jul 2017 22:52:13 -0300 From: Mauro Carvalho Chehab To: Jim Davis Subject: Re: [PATCH v2 00/53] Get rid of Docbook Message-ID: <20170714225213.0a6dba4f@vento.lan> In-Reply-To: References: <20170518112608.4f355068@lwn.net> <20170518200140.11982b12@vento.lan> <386A482A-26F9-4C82-871D-E03E9F6401D8@darmarit.de> Organization: Samsung X-Mailer: Claws Mail 3.14.1 (GTK+ 2.24.31; x86_64-redhat-linux-gnu) MIME-Version: 1.0 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20170714_185252_932794_E6130FC8 X-CRM114-Status: UNSURE ( 9.50 ) X-CRM114-Notice: Please train this message. X-Spam-Score: 1.1 (+) X-Spam-Report: SpamAssassin version 3.4.1 on bombadil.infradead.org summary: Content analysis details: (1.1 points) pts rule name description ---- ---------------------- -------------------------------------------------- -0.0 SPF_HELO_PASS SPF: HELO matches SPF record -1.9 BAYES_00 BODY: Bayes spam probability is 0 to 1% [score: 0.0000] 1.0 RDNS_DYNAMIC Delivered to internal network by host with dynamic-looking rDNS 2.0 LONGWORDS Long string of long words X-BeenThere: linux-mtd@lists.infradead.org X-Mailman-Version: 2.1.21 Precedence: list List-Id: Linux MTD discussion mailing list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Markus Heiser , Linux Doc Mailing List , Jani Nikula , Boris Brezillon , Jonathan Corbet , "linux-kernel@vger.kernel.org org List" , Mauro Carvalho Chehab , Marek Vasut , linux-mtd@lists.infradead.org, Richard Weinberger , Cyrille Pitchen , Brian Norris , David Woodhouse Sender: "linux-mtd" Errors-To: linux-mtd-bounces+incoming=patchwork.ozlabs.org@lists.infradead.org Em Fri, 14 Jul 2017 16:15:23 -0700 Jim Davis escreveu: > On Thu, Jul 6, 2017 at 1:54 AM, Markus Heiser wrote: > > > 52b3f23 Docs: clean up some DocBook loose ends > > Speaking of minor loose ends, > > make SPHINXDIRS=userspace-api pdfdocs > > works -- though now that it's all sphinx, wouldn't just DIRS be better? -- and Hmm... I don't like the idea of just DIRS, as there are other paths used on Makefile (INSTALL_PATH, INSTALL_MOD_PATH, INSTALL_HDR_PATH). > > make DOCBOOKS=userspace-api pdfdocs > > still works too. But that generates all of the pdf files, and not > just the userspace-api.pdf. It will just ignore it. The same happens if you do: make FOO=bar htmldocs Yet, it could make sense to either warn or make it equivalent to SPHINXDIRS at the Documentation/Makefile. > And running now-dead targets like "make > ps" or "make sgmldocs" or "make mandocs" just returns with no output. Yeah. We need to get rid of those targets from Documentation/Makefile: sgmldocs: psdocs: mandocs: installmandocs: I guess the enclosed patch should do the trick. Thanks, Mauro - docs: Makefile: remove no-ops targets After removal of DocBook, those targets are bogus. Reported-by: Jim Davis Signed-off-by: Mauro Carvalho Chehab diff --git a/Documentation/Makefile b/Documentation/Makefile index a42320385df3..d75c00e3aadb 100644 --- a/Documentation/Makefile +++ b/Documentation/Makefile @@ -95,16 +95,6 @@ endif # HAVE_SPHINX # The following targets are independent of HAVE_SPHINX, and the rules should # work or silently pass without Sphinx. -# no-ops for the Sphinx toolchain -sgmldocs: - @: -psdocs: - @: -mandocs: - @: -installmandocs: - @: - cleandocs: $(Q)rm -rf $(BUILDDIR) $(Q)$(MAKE) BUILDDIR=$(abspath $(BUILDDIR)) $(build)=Documentation/media clean diff --git a/Documentation/translations/zh_CN/HOWTO b/Documentation/translations/zh_CN/HOWTO index 11be075ba5fa..5f6d09edc9ac 100644 --- a/Documentation/translations/zh_CN/HOWTO +++ b/Documentation/translations/zh_CN/HOWTO @@ -149,9 +149,7 @@ Linux内核代码中包含有大量的文档。这些文档对于学习如何与 核源码的主目录中使用以下不同命令将会分别生成PDF、Postscript、HTML和手册 页等不同格式的文档： make pdfdocs - make psdocs make htmldocs - make mandocs 如何成为内核开发者 diff --git a/Makefile b/Makefile index 547947ff87de..5db9c669e541 100644 --- a/Makefile +++ b/Makefile @@ -1459,7 +1459,7 @@ $(help-board-dirs): help-%: # Documentation targets # --------------------------------------------------------------------------- -DOC_TARGETS := xmldocs sgmldocs psdocs latexdocs pdfdocs htmldocs mandocs installmandocs epubdocs cleandocs linkcheckdocs +DOC_TARGETS := xmldocs latexdocs pdfdocs htmldocs epubdocs cleandocs linkcheckdocs PHONY += $(DOC_TARGETS) $(DOC_TARGETS): scripts_basic FORCE $(Q)$(MAKE) $(build)=Documentation $@