Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 710274 - eclass-reference: please add IDs to link to functions/variables
Summary: eclass-reference: please add IDs to link to functions/variables
Status: CONFIRMED
Alias: None
Product: Documentation
Classification: Unclassified
Component: Devmanual (show other bugs)
Hardware: All Linux
: Normal normal
Assignee: Gentoo Devmanual Team
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2020-02-20 06:56 UTC by Michał Górny
Modified: 2020-09-02 00:42 UTC (History)
2 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 Michał Górny archtester Gentoo Infrastructure gentoo-dev Security 2020-02-20 06:56:27 UTC
It would be really helpful if eclass references included stable identifiers permitting us to link to individual functions/variables defined in an eclass.

For example, I'd use something like:

https://devmanual.gentoo.org/eclass-reference/multibuild.eclass/#run_in_build_dir
Comment 1 Ulrich Müller gentoo-dev 2020-08-14 08:52:22 UTC
I don't think this can be done with our current tooling using eclass-to-manpage followed by man2html.

I think the way to go is to get rid of man2html and convert eclass documentation to DevBook XML directly.