Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 526128 - >=dev-libs/mathjax-2.1 USE=doc installs a single HTML file with a reference to online resources
Summary: >=dev-libs/mathjax-2.1 USE=doc installs a single HTML file with a reference t...
Status: RESOLVED FIXED
Alias: None
Product: Gentoo Linux
Classification: Unclassified
Component: Current packages (show other bugs)
Hardware: All All
: Normal trivial (vote)
Assignee: Mark Wright
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2014-10-20 17:30 UTC by Arfrever Frehtes Taifersar Arahesis
Modified: 2024-02-15 13:51 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 Arfrever Frehtes Taifersar Arahesis 2014-10-20 17:30:33 UTC
>=dev-libs/mathjax-2.1 with USE="doc" installs only index.html with this content:

"The source files for the documentation are now kept in a separate
GitHub repository at

       https://github.com/mathjax/mathjax-docs

The HTML versions are now available at

       http://docs.mathjax.org/

where it is possible for you to submit corrections and modifications
directly to the documentation on line."


I suggest one of these:
1. Delete "doc" USE flag in >=dev-libs/mathjax-2.1.
2. Delete "doc" USE flag in >=dev-libs/mathjax-2.1 and create dev-libs/mathjax-docs package.
3. Create dev-libs/mathjax-docs package and make >=dev-libs/mathjax-2.1[doc] depend on dev-libs/mathjax-docs.
Comment 1 Larry the Git Cow gentoo-dev 2020-01-10 08:45:27 UTC
The bug has been closed via the following commit(s):

https://gitweb.gentoo.org/repo/gentoo.git/commit/?id=c6e861e430f795dd862fe05fed3f93ef2ca298a9

commit c6e861e430f795dd862fe05fed3f93ef2ca298a9
Author:     Mark Wright <gienah@gentoo.org>
AuthorDate: 2020-01-10 03:12:28 +0000
Commit:     Mark Wright <gienah@gentoo.org>
CommitDate: 2020-01-10 08:43:16 +0000

    dev-libs/mathjax: Bump to 2.7.7, fix USE=doc
    
    Thanks to Arfrever Frehtes Taifersar Arahesis for reporting.
    
    Closes: https://bugs.gentoo.org/show_bug.cgi?id=526128
    Package-Manager: Portage-2.3.84, Repoman-2.3.20
    Signed-off-by: Mark Wright <gienah@gentoo.org>

 dev-libs/mathjax/Manifest             |  1 +
 dev-libs/mathjax/mathjax-2.7.7.ebuild | 64 +++++++++++++++++++++++++++++++++++
 2 files changed, 65 insertions(+)

Additionally, it has been referenced in the following commit(s):

https://gitweb.gentoo.org/repo/gentoo.git/commit/?id=d18700aaccc7a86f87163aeadedb74c60794803d

commit d18700aaccc7a86f87163aeadedb74c60794803d
Author:     Mark Wright <gienah@gentoo.org>
AuthorDate: 2020-01-10 02:58:33 +0000
Commit:     Mark Wright <gienah@gentoo.org>
CommitDate: 2020-01-10 08:43:14 +0000

    app-doc/mathjax-docs: Add for dev-libs/mathjax USE=doc
    
    Bug: https://bugs.gentoo.org/show_bug.cgi?id=526128
    Package-Manager: Portage-2.3.84, Repoman-2.3.20
    Signed-off-by: Mark Wright <gienah@gentoo.org>

 app-doc/mathjax-docs/Manifest                  |  1 +
 app-doc/mathjax-docs/mathjax-docs-2.7.7.ebuild | 33 ++++++++++++++++++++++++++
 app-doc/mathjax-docs/metadata.xml              | 23 ++++++++++++++++++
 3 files changed, 57 insertions(+)
Comment 2 Larry the Git Cow gentoo-dev 2024-02-15 13:50:53 UTC
The bug has been referenced in the following commit(s):

https://gitweb.gentoo.org/repo/gentoo.git/commit/?id=d8e93a9fe1a6a2c04b98590e3526df07018111e8

commit d8e93a9fe1a6a2c04b98590e3526df07018111e8
Author:     Eli Schwartz <eschwartz93@gmail.com>
AuthorDate: 2024-02-14 23:46:25 +0000
Commit:     Sam James <sam@gentoo.org>
CommitDate: 2024-02-15 13:50:25 +0000

    dev-libs/mathjax: include USE=docs as part of the package (2.x)
    
    Do not use a separated app-docs/mathjax-docs. It is impossible to get
    correct: the symlink is generated using ${SLOT}, which is totally bogus
    as the docs package uses ${PF} and is unknowable. The symlink was very
    broken.
    
    In bug 526128, it was stated that there are 2 options for handling docs
    as part of a separate tarball:
    
    - remove doc support (and optionally create a separate package)
    - make doc support depend on a separate package
    
    It's baffling that the final option of just... having two SRC_URI
    files and installing the docs... was totally overlooked.
    
    Fixes: c6e861e430f795dd862fe05fed3f93ef2ca298a9
    Bug: https://bugs.gentoo.org/526128
    Bug: https://bugs.gentoo.org/867370
    Signed-off-by: Eli Schwartz <eschwartz93@gmail.com>
    Signed-off-by: Sam James <sam@gentoo.org>

 dev-libs/mathjax/Manifest                |  1 +
 dev-libs/mathjax/mathjax-2.7.7-r1.ebuild | 92 ++++++++++++++++++++++++++++++++
 2 files changed, 93 insertions(+)