Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1754498AbdGNPoH (ORCPT ); Fri, 14 Jul 2017 11:44:07 -0400 Received: from ms.lwn.net ([45.79.88.28]:54478 "EHLO ms.lwn.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1754051AbdGNPoF (ORCPT ); Fri, 14 Jul 2017 11:44:05 -0400 Date: Fri, 14 Jul 2017 09:44:02 -0600 From: Jonathan Corbet To: Mauro Carvalho Chehab Cc: Linux Doc Mailing List , Mauro Carvalho Chehab , linux-kernel@vger.kernel.org, Daniel Vetter , Markus Heiser , SeongJae Park , Greg Kroah-Hartman , Masahiro Yamada , Nicholas Piggin Subject: Re: [PATCH 2/6] docs-rst: update Sphinx install instructions Message-ID: <20170714094402.37c0a2a2@lwn.net> In-Reply-To: <015df5b51df69c8a9f13c79e139ee99ba8667973.1500030250.git.mchehab@s-opensource.com> References: <015df5b51df69c8a9f13c79e139ee99ba8667973.1500030250.git.mchehab@s-opensource.com> Organization: LWN.net MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 8bit Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Length: 490 Lines: 14 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? Otherwise the series looks good to me, thanks. jon