Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1754176AbdGNQM5 (ORCPT ); Fri, 14 Jul 2017 12:12:57 -0400 Received: from smtp1.goneo.de ([85.220.129.30]:54078 "EHLO smtp1.goneo.de" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1753565AbdGNQM4 (ORCPT ); Fri, 14 Jul 2017 12:12:56 -0400 X-Spam-Flag: NO X-Spam-Score: -2.762 Content-Type: text/plain; charset=us-ascii Mime-Version: 1.0 (Mac OS X Mail 10.3 \(3273\)) Subject: Re: [PATCH 2/6] docs-rst: update Sphinx install instructions From: Markus Heiser In-Reply-To: <20170714094402.37c0a2a2@lwn.net> Date: Fri, 14 Jul 2017 18:11:41 +0200 Cc: Mauro Carvalho Chehab , Linux Doc Mailing List , Mauro Carvalho Chehab , linux-kernel@vger.kernel.org, Daniel Vetter , SeongJae Park , Greg Kroah-Hartman , Masahiro Yamada , Nicholas Piggin Content-Transfer-Encoding: 7bit Message-Id: <4AEAC025-AC80-4134-8F16-41633A27EABE@darmarit.de> References: <015df5b51df69c8a9f13c79e139ee99ba8667973.1500030250.git.mchehab@s-opensource.com> <20170714094402.37c0a2a2@lwn.net> To: Jonathan Corbet X-Mailer: Apple Mail (2.3273) Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Length: 682 Lines: 18 > Am 14.07.2017 um 17:44 schrieb Jonathan Corbet : > > On Fri, 14 Jul 2017 08:08:19 -0300 > Mauro Carvalho Chehab wrote: > >> +Please see :ref:`sphinx_install` at the doc-guide for details about >> +Sphinx requirements. > > One small comment here: formatting things this way assumes that people are > reading the documentation in a web browser. Can we replace "at the > doc-guide" with "in Documentation/doc-guide/sphinx.rst" to improve the > usability of the plain-text files? Hm .. I suppose there is a plain text builder for sphinx .. but building plain-text before reading sources seems not an acceptable option ;) -- Markus --