On 7/29/24 4:09 PM, Grant Edwards wrote:
> Right, but that's only useful after you track down the trigger for the
> new packages. What would be nice is avoiding that "tracking down"
> effort.  [I know, I should just relax, hit 'Y', and trust that emerge
> and the devs know what they're doing.]


That's basically just emerge -t though?


>> As for why it needs to format markdown -- build dependencies of
>> python software often do, since they want to render the darned stuff
>> into the https://pypi.org display page for that software
> 
> Oh. Is that display page (in html?) written into a log somewhere or
> shown during the build?


It's stored inside an installed file called

/usr/lib/python3.XX/site-packages/${PN}-${PV}.dist-info/METADATA

The file format is described at
https://packaging.python.org/en/latest/specifications/core-metadata/#description

Of course, the specific metadata field in question is not actually
useful for installed packages, only for web repository uploads, but
there you have it...

There is some useful metadata in that file, for example pip needs it to
be able to list which names and versions are installed, and also to
check whether each python module has its dependencies (or Extras
dependencies) installed. But the stuff that uses rst and markdown is
totally unnecessary for this, even though python build systems have to
add it.


>> aside: there are pip manpages, funny you should mention that.
> 
> When installed on Gentoo using dev-python/pip?
> 
>> I could totally add another bdepend on sphinx for this! But I would have
>> to package some things first. :(
> 
> No thanks, sphinx would pull in 10 more packages. :)
> 
> If I need pip documentation, I can google for it or look at the
> rst.bz2 files install in /usr/share/doc...
> 
> Thanks for tolerating my whinging.


Gentoo doesn't install the manpages, no.

We should. And per policy, manpages cannot be disabled by a USE flag:
https://projects.gentoo.org/qa/policy-guide/installed-files.html#pg0305

But what we can do is build the manpages ourselves and add an extra
SRC_URI to download that. And in this case it's a royal pain to package,
including the fact that it requires sphinxcontrib-towncrier which has
never released any version that isn't an alpha... amazing...


-- 
Eli Schwartz

Attachment: OpenPGP_signature.asc
Description: OpenPGP digital signature

Reply via email to