526186 – distutils-r1 / python-utils-r1: need better way of installing Sphinx docs

Bug 526186 - distutils-r1 / python-utils-r1: need better way of installing Sphinx docs

Summary: distutils-r1 / python-utils-r1: need better way of installing Sphinx docs

Status:	RESOLVED WORKSFORME

Alias:	None

Product:	Gentoo Linux
Classification:	Unclassified
Component:	Eclasses (show other bugs)
Hardware:	All Linux

Importance:	Normal normal (vote)
Assignee:	Python Gentoo Team

URL:
Whiteboard:
Keywords:

Depends on:
Blocks:

Reported:	2014-10-21 07:50 UTC by Michał Górny
Modified:	2018-02-27 10:24 UTC (History)
CC List:	3 users (show)

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

Attachments
Add an attachment (proposed patch, testcase, etc.)

Note You need to log in before you can comment on or make changes to this bug.

Description Michał Górny archtester

2014-10-21 07:50:35 UTC

Right now we're installing Sphinx docs through HTML_DOCS/dohtml. That includes implicit filtering that removes some of the Sphinx files. Since dohtml is being deprecated, HTML_DOCS are going to use dodoc, and we need some other filtering.

This brings the following questions:

1. which files do we want to install, and which ones we want to filter out?

2. do we want to install the docs somewhere more predictable (bug #522794)?

Comment 1 Ian Delaney (RETIRED) gentoo-dev

2014-10-22 03:03:35 UTC

While it's safe to install 'the lot', it also makes for 'cruft'.  The other bug has brought the binary objects.inv to my attention. Otherwise on my part I don't know what else would be wise to include.  Surely Arfrever has some opinion on this.

Comment 2 Michał Górny archtester

2018-02-27 10:24:53 UTC

I suppose HTML_DOCS works fine now and nobody has been complaining about extra files.