lists.openwall.net | lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC | |
Open Source and information security mailing list archives
| ||
|
Date: Fri, 20 Jul 2018 18:28:09 +0200 From: Markus Heiser <markus.heiser@...marit.de> To: Christoph Hellwig <hch@...radead.org> Cc: "Darrick J. Wong" <darrick.wong@...cle.com>, "Theodore Y. Ts'o" <tytso@....edu>, Jonathan Corbet <corbet@....net>, linux-doc@...r.kernel.org, linux-ext4@...r.kernel.org, linux-kernel@...r.kernel.org Subject: Re: Sphinx version dependencies? Am Freitag, den 20.07.2018, 08:04 -0700 schrieb Christoph Hellwig: > On Fri, Jul 20, 2018 at 09:30:33AM +0200, Markus Heiser wrote: > > We have this discussion over and over again an I believe we will have it again > > and again, as long as we do not change our POV .. building viewing formats is > > an application not a part of the Kernel. > > Sorry, but this is complete and utter bullshit. Maybe .. I'am not a Kernel developer .. I only try to help with the doc tool- chain. But if I don't want to install anything from the web, the plain text is not as bad. > > If that was the case we could skip all that RST stuff and just stick > to text files. If we want fancy docs it better behave like the rest > of the kernel and just works. python virtual environments are just > not going to cut it as they lead to a long-term maintainance nightmare. Really a nightmare? This is what I do on my ubuntu/debian box ... I do prefer py3 so I installed *virtualenv-py3* once from distro's package manager: $ sudo apt install python3-virtualenv To setup up a environment for building htmldocs: $ python3 -m virtualenv py3env $ ./py3env/bin/pip install -r ./Documentation/sphinx/requirements.txt now I have all installed in the in the py3env folder. To build htmldocs with: $ SPHINXBUILD=./py3env/bin/sphinx-build make htmldocs If the env is no longer needed: $ rm -r py3env -- Markus -- > -- > To unsubscribe from this list: send the line "unsubscribe linux-doc" in > the body of a message to majordomo@...r.kernel.org > More majordomo info at http://vger.kernel.org/majordomo-info.html
Powered by blists - more mailing lists