[prev in list] [next in list] [prev in thread] [next in thread]
List: gentoo-dev
Subject: Re: [gentoo-dev] Should Sphinx really depends on PYTHON_COMPAT/PYTHON_USEDEP for `dev-python/*` ebui
From: Alex Turbov <i.zaufi () gmail ! com>
Date: 2017-05-12 6:20:11
Message-ID: CANktQtvRwaN8YHn46z42K=y=2G3oV9mbjNs-fD4EtPGAq2xN3A () mail ! gmail ! com
[Download RAW message or body]
On Thu, May 11, 2017 at 2:51 PM, Micha=C5=82 G=C3=B3rny <mgorny@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=C5=82 G=C3=B3rny
>
[Attachment #3 (text/html)]
<div dir="ltr"><br><div class="gmail_extra"><br><div class="gmail_quote">On Thu, May \
11, 2017 at 2:51 PM, Michał Górny <span dir="ltr"><<a \
href="mailto:mgorny@gentoo.org" target="_blank">mgorny@gentoo.org</a>></span> \
wrote:<br><blockquote class="gmail_quote" style="margin:0px 0px 0px \
0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">Hi,<br> <br>
Few janitorial notes for a start:<br>
<br>
1. please fix your line wrapping since your messages are wrapped twice<br>
now, and it's really hard to read with single words on every second<br>
line;<br></blockquote><div><br></div><div>sorry, I don't understand what are you \
talking about... probably some problem with your email client (or whatever you \
use).<br></div><div>I'm using gmail's web UI and see no double \
wraps...<br></div><div> </div><blockquote class="gmail_quote" style="margin:0px 0px \
0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"> <br>
2. hardcore Python topics belong on gentoo-python@ but I guess we'll<br>
continue here,<br></blockquote><div><br></div><div>I don't see this ML here: <a \
href="https://gentoo.org/get-involved/mailing-lists/">https://gentoo.org/get-involved/mailing-lists/</a> \
so I decided to use `gentoo-dev`<br></div><div> </div><blockquote \
class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid \
rgb(204,204,204);padding-left:1ex"> <br>
3. please keep your messages brief. The first three paragraphs tell<br>
a thing that could be told in one \
sentence.<br></blockquote><div><br></div><div>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"...<br></div><div> \
</div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px \
solid rgb(204,204,204);padding-left:1ex"> <div><div class="gmail-h5"><br>
</div></div>You can't use python_targets directly since it will break when the \
old<br> implementations are disabled (and also make it PITA for others to add<br>
new impls).<br></blockquote><div><br></div><div>Ok, what I can use \
instead?<br></div><div> </div><blockquote class="gmail_quote" style="margin:0px 0px \
0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"> <span \
class="gmail-"><br><br> </span>Long story short, it's not worth the effort.<br>
<br>
Yes, most of the time people specify PYTHON_USEDEP on sphinx needlessly.<br>
There are two other major cases when you need it though:<br>
<br>
1. things like autointerface that interface with packages' \
code,<br></blockquote><div><br></div><div>what are you talking about? (<a \
href="https://pypi.python.org/pypi/repoze.sphinx.autointerface/">https://pypi.python.org/pypi/repoze.sphinx.autointerface/</a> \
??)<br></div><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px \
0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"> <br>
2. and packages calling sphinx via 'python /usr/bin/sphinx ...' (i.e.<br>
requiring impl match between python in use and \
sphinx).<br></blockquote><div><br></div><div>do you mean they are doing it from \
ebuild? <br> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px \
0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"> <br>
In fact, I'm personally leaning towards not building docs at all<br>
in ebuilds. It's practically a wasted effort since most of the time<br>
users read docs online anyway.<br></blockquote><div><br></div><div>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 \
:(<br></div><div> <br><blockquote class="gmail_quote" style="margin:0px 0px 0px \
0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"> <br>
However, tracking the other uses down and figuring them is not worth<br>
the effort. In the end, someone will probably add it back thinking<br>
someone must've missed it. It's too hard to get it \
right.<br></blockquote><div><br></div><div>I didn't get what are you talking \
about...<br></div></div><div> <br></div><blockquote class="gmail_quote" \
style="margin:0px 0px 0px 0.8ex;border-left:1px solid \
rgb(204,204,204);padding-left:1ex"> Building Sphinx with less implementations than \
its reverse dependencies<br> is a corner case. It's not really worth spending \
hours making sure<br> depends are 100% strictly correct. The more important goal is \
to have<br> things working reliably, and overspecified deps are reliable, i.e.<br>
packages won't fail to build because of them.<br>
<span class="gmail-HOEnZb"><font \
color="#888888"><br></font></span></blockquote><div><br></div><div>Ok, seems I've \
got your point of view, but can't agree w/ it... Well, I would fight alone w/ \
it<br></div><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px \
0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><span \
class="gmail-HOEnZb"><font color="#888888">
--<br>
Best regards,<br>
Michał Górny<br>
</font></span></blockquote></div><br></div></div>
[prev in list] [next in list] [prev in thread] [next in thread]
Configure |
About |
News |
Add a list |
Sponsored by KoreLogic