Gentoo Archives: gentoo-dev

From: "Michał Górny" <mgorny@g.o>
To: gentoo-dev@l.g.o
Subject: Re: [gentoo-dev] Should Sphinx really depends on PYTHON_COMPAT/PYTHON_USEDEP for `dev-python/*` ebuilds?
Date: Sat, 13 May 2017 07:33:16
Message-Id: 1494660766.1789.3.camel@gentoo.org
In Reply to: Re: [gentoo-dev] Should Sphinx really depends on PYTHON_COMPAT/PYTHON_USEDEP for `dev-python/*` ebuilds? by Daniel Campbell
1 On pią, 2017-05-12 at 17:42 -0700, Daniel Campbell wrote:
2 > On 05/11/2017 12:51 AM, Michał Górny wrote:
3 > > In fact, I'm personally leaning towards not building docs at all
4 > > in ebuilds. It's practically a wasted effort since most of the time
5 > > users read docs online anyway.
6 >
7 > I believe that's a little myopic; a user (or even developer) may not
8 > have Internet access all the time, or may not have it in their primary
9 > development environment. Having a copy of the docs locally (the entire
10 > point of USE="doc") is super valuable to have when you're away from the
11 > network. I'm sure I'm not alone as one of the people who uses the flag
12 > and appreciates the work that goes into making sure said flag works.
13 >
14 > Sure, we could yank out every single USE="doc", but then we lose a nice
15 > feature of the tree and users are back to either (a) trawling the Web to
16 > find the project site, then hope they have docs in a separate download,
17 > or (b) we end up with foo+1 packages, one extra for any package that has
18 > documentation. Neither are particularly good solutions; Debian has done
19 > the latter and it results in a huge number of packages for little gain.
20
21 The Python team mostly focuses on providing packages for dependencies of
22 other Gentoo packages, not direct Python development. We do not have
23 the manpower to go above that.
24
25 --
26 Best regards,
27 Michał Górny

Attachments

File name MIME type
signature.asc application/pgp-signature

Replies