Bug 541131

Summary: tetex-elsevier documentation does not work with texdoc
Product: [Fedora] Fedora Reporter: Michal Jaegermann <michal>
Component: tetex-elsevierAssignee: Mary Ellen Foster <mefoster>
Status: CLOSED ERRATA QA Contact: Fedora Extras Quality Assurance <extras-qa>
Severity: medium Docs Contact:
Priority: low    
Version: rawhideCC: jonathan.underwood, mefoster, pertusus
Target Milestone: ---   
Target Release: ---   
Hardware: All   
OS: Linux   
Whiteboard:
Fixed In Version: 0.1.20090917-2.fc12 Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2010-01-07 00:54:20 UTC Type: ---
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:

Description Michal Jaegermann 2009-11-25 01:27:52 UTC
Description of problem:

'texdoc elsdoc' produces "Can't find documentation for `elsdoc'" instead of opening a corresponding pdf file.  For this to work /usr/share/doc/tetex-elsevier-0.1.20090917/elsdoc.pdf would need to be
linked with /usr/share/texmf/doc/latex/elsevier/elsdoc.pdf (or something similar).  The same for instructions-harv.pdf and instructions-num.pdf would
be possibly nice but secondary.

Version-Release number of selected component (if applicable):
tetex-elsevier-0.1.20090917-1.fc13 (and other similar)

Additional info:
The above means that adding 'elsdoc' to texdoctk data would not do much good and that is unfortunate.

Quite possibly other similar packages have analogous issue but I just bumped into that one. :-)

Comment 1 Mary Ellen Foster 2009-11-25 12:14:19 UTC
Hmm, interesting -- I don't know if there are guidelines for where to put TeX documentation. I guess the best is to put it both in the package %doc location and in /usr/share/texmf/doc as you suggest -- thanks for noticing this. Will update soon.

Comment 2 Michal Jaegermann 2009-11-25 18:38:15 UTC
> I don't know if there are guidelines for where to put TeX
> documentation.

I do not know if such explicit Fedora guidelines do exist either.  If not then maybe this is an oversight?  Only if you want documetation to be findable by 'texdoc', and 'texdoctk' too, then is should be somewhere where kpsewhich will list it.  Check /usr/bin/texdoc shell script for how this is done. In other words something located in subdirectories of /usr/local/share/texmf/doc/ will work too without any changes to /usr/share/texmf/web2c/texmf.cnf where TEXDOCS is set.  This is also where 'mktexlsr' will record documentation files.

Like I suggested symlinks in right places are entirely sufficient.

I also cannot tell if there are agreed upon procedures of maintaining /usr/share/texmf/texdoctk/texdoctk.dat.  Unfortunately that seems to be monolithic although I am not sure about that without diving into a texdoctk code.
Sure conditionally adding a non-existing yet line or two by a package script is not an issue but updates to texlive-texmf will clobber that.  Maybe some triggers could prevent this.  Possible modifications to texdoctk to do some "includes" would likely be a better way.  No idea who could/should coordinate that.

Comment 3 Fedora Update System 2009-11-27 10:35:49 UTC
tetex-elsevier-0.1.20090917-2.fc12 has been submitted as an update for Fedora 12.
http://admin.fedoraproject.org/updates/tetex-elsevier-0.1.20090917-2.fc12

Comment 4 Fedora Update System 2009-11-27 10:36:49 UTC
tetex-elsevier-0.1.20090917-2.fc11 has been submitted as an update for Fedora 11.
http://admin.fedoraproject.org/updates/tetex-elsevier-0.1.20090917-2.fc11

Comment 5 Fedora Update System 2009-11-27 21:52:11 UTC
tetex-elsevier-0.1.20090917-2.fc12 has been pushed to the Fedora 12 testing repository.  If problems still persist, please make note of it in this bug report.
 If you want to test the update, you can install it with 
 su -c 'yum --enablerepo=updates-testing update tetex-elsevier'.  You can provide feedback for this update here: http://admin.fedoraproject.org/updates/F12/FEDORA-2009-12258

Comment 6 Fedora Update System 2009-11-27 21:54:04 UTC
tetex-elsevier-0.1.20090917-2.fc11 has been pushed to the Fedora 11 testing repository.  If problems still persist, please make note of it in this bug report.
 If you want to test the update, you can install it with 
 su -c 'yum --enablerepo=updates-testing update tetex-elsevier'.  You can provide feedback for this update here: http://admin.fedoraproject.org/updates/F11/FEDORA-2009-12273

Comment 7 Fedora Update System 2010-01-07 00:54:15 UTC
tetex-elsevier-0.1.20090917-2.fc11 has been pushed to the Fedora 11 stable repository.  If problems still persist, please make note of it in this bug report.

Comment 8 Fedora Update System 2010-01-07 00:57:42 UTC
tetex-elsevier-0.1.20090917-2.fc12 has been pushed to the Fedora 12 stable repository.  If problems still persist, please make note of it in this bug report.