Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 620674 - app-doc/devmanual: Eclass Reference Pages chapter is missing
Summary: app-doc/devmanual: Eclass Reference Pages chapter is missing
Status: RESOLVED FIXED
Alias: None
Product: Gentoo Linux
Classification: Unclassified
Component: Current packages (show other bugs)
Hardware: All Linux
: Normal minor (vote)
Assignee: Gentoo Devmanual Team
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2017-06-04 01:50 UTC by Andriy Utkin (RETIRED)
Modified: 2020-02-16 13:11 UTC (History)
1 user (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 Andriy Utkin (RETIRED) gentoo-dev 2017-06-04 01:50:27 UTC
Comparing "Contents" in index pages of online devmanual and one installed locally, you can see that "Eclass Reference Pages" is gone from local one.

As I understand the reason for this bug is that eclass ref pages are generated from some different source as a separate step.

But this isn't satisfactory as locally installed devmanual still should be complete devmanual. The fact that there is a section in online devmanual which is missing in my local installation surprised me a lot. Yes now I see there's app-portage/eclass-manpages package, but it's not obvious you need to install it to complement local devmanual to be on par with online version.
Comment 1 Ulrich Müller gentoo-dev 2020-02-16 13:11:54 UTC
devmanual-0_pre20200207 contains a placeholder for the eclass-reference chapter, with a note that eclass documentation can be found in app-doc/eclass-manpages. So at least the document structure is intact again.

If we were to provide eclass manpages as HTML, then IMHO it would make more sense to have app-doc/eclass-manpages install them under some USE conditional. 

Closing.