On Thu, May 11, 2017 at 2:51 PM, Michał Górny <mgo...@gentoo.org> wrote:
> Hi, > > Few janitorial notes for a start: > > 1. please fix your line wrapping since your messages are wrapped twice > now, and it's really hard to read with single words on every second > line; > sorry, I don't understand what are you talking about... probably some problem with your email client (or whatever you use). I'm using gmail's web UI and see no double wraps... > > 2. hardcore Python topics belong on gentoo-python@ but I guess we'll > continue here, > I don't see this ML here: https://gentoo.org/get-involved/mailing-lists/ so I decided to use `gentoo-dev` > > 3. please keep your messages brief. The first three paragraphs tell > a thing that could be told in one sentence. > I've got no idea what message format is "usual" in this ML... from my experience talking to various "tech support" and bug trackers ppl usually asking a lot of stupid questions if I wrote just "one sentence"... > > You can't use python_targets directly since it will break when the old > implementations are disabled (and also make it PITA for others to add > new impls). > Ok, what I can use instead? > > > Long story short, it's not worth the effort. > > Yes, most of the time people specify PYTHON_USEDEP on sphinx needlessly. > There are two other major cases when you need it though: > > 1. things like autointerface that interface with packages' code, > what are you talking about? ( https://pypi.python.org/pypi/repoze.sphinx.autointerface/ ??) > > 2. and packages calling sphinx via 'python /usr/bin/sphinx ...' (i.e. > requiring impl match between python in use and sphinx). > do you mean they are doing it from ebuild? > > In fact, I'm personally leaning towards not building docs at all > in ebuilds. It's practically a wasted effort since most of the time > users read docs online anyway. > unfortunately I'm travelling a lot and really often in places where Internet connection is far from good. it is why I like to have offline docs for some packages. moreover I really hate when some docs are not really offline and want to load google fonts or JS :( > > However, tracking the other uses down and figuring them is not worth > the effort. In the end, someone will probably add it back thinking > someone must've missed it. It's too hard to get it right. > I didn't get what are you talking about... > Building Sphinx with less implementations than its reverse dependencies > is a corner case. It's not really worth spending hours making sure > depends are 100% strictly correct. The more important goal is to have > things working reliably, and overspecified deps are reliable, i.e. > packages won't fail to build because of them. > > Ok, seems I've got your point of view, but can't agree w/ it... Well, I would fight alone w/ it > -- > Best regards, > Michał Górny >