Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1751088AbdFSNq5 (ORCPT ); Mon, 19 Jun 2017 09:46:57 -0400 Received: from ms.lwn.net ([45.79.88.28]:47888 "EHLO ms.lwn.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1750992AbdFSNq4 (ORCPT ); Mon, 19 Jun 2017 09:46:56 -0400 Date: Mon, 19 Jun 2017 07:46:53 -0600 From: Jonathan Corbet To: Christoph Hellwig Cc: Mauro Carvalho Chehab , Linux Doc Mailing List , Mauro Carvalho Chehab , linux-kernel@vger.kernel.org, Greg Kroah-Hartman , SeongJae Park , Markus Heiser , Masahiro Yamada , Max Filippov Subject: Re: [PATCH] changes.rst: explain the usage of virtual environment Message-ID: <20170619074653.4fbcdd36@lwn.net> In-Reply-To: <20170619130837.GA25524@infradead.org> References: <736d4f4128feaf09f0de91e665dd0666ffa07a18.1497870046.git.mchehab@s-opensource.com> <20170619130837.GA25524@infradead.org> Organization: LWN.net X-Mailer: Claws Mail 3.14.1 (GTK+ 2.24.31; x86_64-redhat-linux-gnu) 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: 841 Lines: 20 On Mon, 19 Jun 2017 06:08:37 -0700 Christoph Hellwig wrote: > On Mon, Jun 19, 2017 at 08:24:10AM -0300, Mauro Carvalho Chehab wrote: > > As the Sphinx build seems very fragile, specially for > > PDF output, add a notice about how to use it on a virtual > > environment. > > Please don't. python venv are good at one thing only, and that is > making a mess of your python module path. Don't ever use them on a > system that has proper package management. Well, they are also good for running specific versions of a given package without disrupting the setup of your system as a whole, and when even a system with proper package management may not offer the version you need. I guess my question with the patch is whether this text really belongs in changes.rst, or whether it should be part of the doc-guide. jon