Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 773271 - app-doc/eclass-manpages: Add direct links to eclass source
Summary: app-doc/eclass-manpages: Add direct links to eclass source
Status: CONFIRMED
Alias: None
Product: Documentation
Classification: Unclassified
Component: Devmanual (show other bugs)
Hardware: All Linux
: Normal normal
Assignee: Michał Górny
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2021-02-27 11:29 UTC by Sam James
Modified: 2022-05-19 21:56 UTC (History)
5 users (show)

See Also:
Package list:
Runtime testing required: ---


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Sam James archtester Gentoo Infrastructure gentoo-dev Security 2021-02-27 11:29:29 UTC
Is it possible to link directly to the eclass sources on the eclass reference pages?

For e.g. https://devmanual.gentoo.org/eclass-reference/distutils-r1.eclass/index.html, I envision the FILES section having a bunch of links.

Right now, I regularly click the git log -> tree -> eclass file, which is a bit of a pain. Please let me know if I'm missing a big red link!
Comment 1 Ulrich Müller gentoo-dev 2021-02-27 14:58:09 UTC
IMHO that would be best done when generating the eclass manpages.

The devmanual's gen-eclass-html.sh does too much postprocessing of the HTML already, so I'm reluctant to add even more.
Comment 2 Tim Harder gentoo-dev 2021-02-27 17:31:27 UTC
It should be trivial to inject whatever you want using pkgcore's eclass support and `pmaint eclass` if Gentoo ever wants to switch to using that.
Comment 3 Michał Górny archtester Gentoo Infrastructure gentoo-dev Security 2021-02-27 18:56:21 UTC
(In reply to Tim Harder from comment #2)
> It should be trivial to inject whatever you want using pkgcore's eclass
> support and `pmaint eclass` if Gentoo ever wants to switch to using that.

Yes, please do that in pmaint.  I don't think there's a point in doing any upgrades to the old script today.