Discussion:
url.sty
(too old to reply)
Hoffmann, Jobst
2018-09-15 09:57:13 UTC
Permalink
Hi Karl,

whenever I want to have a look at the url package documentation by

texdoc url

the .sty file gets displayed. Entering

texdoc -s url

shows url.pdf as second entry in the list.

Is this behaviour intended?

Kind regards
Jobst
--
Prof. Dr. Jobst Hoffmann Tel: +49 (241) 6009-5 31 59
Fachhochschule Aachen Abt. Jülich Fax: +49 (241) 6009-5 31 89
Fachbereich 09 email: ***@fh-aachen.de
George N. White III
2018-09-15 13:38:20 UTC
Permalink
Post by Hoffmann, Jobst
Hi Karl,
whenever I want to have a look at the url package documentation by
texdoc url
the .sty file gets displayed. Entering
texdoc -s url
shows url.pdf as second entry in the list.
Is this behaviour intended?
It might help to mention the platform and TL version (e.g., year and
whether you installed the
CTAN version or used some linux distribution version).

Problems like this may be due to an old misplaced file or a
non-standard search path.
Please check the output of "texdoc -l url". On my x86_64-linux
system I see only the full path
"[...]/texmf-dist/doc/latex/url/url.pdf" for a couple TL versions.
--
George N. White III
Hoffmann, Jobst
2018-09-15 14:08:15 UTC
Permalink
Post by George N. White III
Post by Hoffmann, Jobst
Hi Karl,
whenever I want to have a look at the url package documentation by
texdoc url
the .sty file gets displayed. Entering
texdoc -s url
shows url.pdf as second entry in the list.
Is this behaviour intended?
It might help to mention the platform and TL version (e.g., year and
whether you installed the
CTAN version or used some linux distribution version).
Problems like this may be due to an old misplaced file or a
non-standard search path.
Please check the output of "texdoc -l url". On my x86_64-linux
system I see only the full path
"[...]/texmf-dist/doc/latex/url/url.pdf" for a couple TL versions.
The platform is Fedora 28, TL 2018 was installed from CTAN, the output
from

texdoc -s url

is

1 /usr/local/texlive/2018/texmf-dist/tex/latex/url/url.sty
2 /usr/local/texlive/2018/texmf-dist/doc/latex/url/url.pdf
= Package documentation
3 /usr/local/texlive/2018/texmf-dist/doc/latex/urcls/URletter-DEMO.pdf
= Example of usage (letter)
4 /usr/local/texlive/2018/texmf-dist/doc/latex/breakurl/breakurl.pdf
= Package documentation
5 /usr/local/texlive/2018/texmf-dist/doc/bibtex/urlbst/urlbst.pdf
= Package documentation (PDF format)
6 /usr/local/texlive/2018/texmf-dist/doc/latex/xurl/xurl.pdf
= Package documentation
7 /usr/local/texlive/2018/texmf-dist/doc/bibtex/urlbst/urlbst.html
= Package documentation (HTML format)
8 /usr/local/texlive/2018/texmf-dist/doc/latex/breakurl/README
= Package README
9 /usr/local/texlive/2018/texmf-dist/doc/bibtex/urlbst/README
= Package Readme
10 /usr/local/texlive/2018/texmf-dist/doc/latex/aurl/README.md
= Readme
11 /usr/local/texlive/2018/texmf-dist/doc/latex/xurl/README.md
= Readme
12 /usr/local/texlive/2018/texmf-dist/doc/man/man1/biburl2doi.man1.pdf
13 /usr/local/texlive/2018/texmf-dist/doc/latex/xurl/Changes
14 /usr/local/texlive/2018/texmf-dist/doc/bibtex/urlbst/VERSION
15 /usr/local/texlive/2018/texmf-dist/doc/latex/unamth-
template/Latex/Classes/urlbst
tex-live <tex-***@tug.org>
--
Prof. Dr. Jobst Hoffmann Tel: +49 (241) 6009-5 31 59
Fachhochschule Aachen Abt. Jülich Fax: +49 (241) 6009-5 31 89
Fachbereich 09 email: ***@fh-aachen.de
Takuto ASAKURA
2018-09-15 14:37:41 UTC
Permalink
Hi Jobst and All,

this seems to be an issue of Texdoc, so you can report it to ***@tug.org
or even better to open an issue on our GitHub repository:

https://github.com/TeX-Live/texdoc/

Talking about the issue, it didn't reproduce in my environment (macOS, TL 2018,
everything up-to-dated):

$ texdoc -s url
1 /usr/local/texlive/2018/texmf-dist/doc/latex/url/url.pdf
= Package documentation
2 /usr/local/texlive/2018/texmf-dist/doc/latex/urcls/URletter-DEMO.pdf
= Example of usage (letter)
3 /usr/local/texlive/2018/texmf-dist/doc/latex/breakurl/breakurl.pdf
= Package documentation
4 /usr/local/texlive/2018/texmf-dist/doc/bibtex/urlbst/urlbst.pdf
= Package documentation (PDF format)
5 /usr/local/texlive/2018/texmf-dist/doc/latex/xurl/xurl.pdf
= Package documentation
6 /usr/local/texlive/2018/texmf-dist/doc/bibtex/urlbst/urlbst.html
= Package documentation (HTML format)
7 /usr/local/texlive/2018/texmf-dist/doc/bibtex/urlbst/README
= Package Readme
8 /usr/local/texlive/2018/texmf-dist/doc/latex/breakurl/README
= Package README
9 /usr/local/texlive/2018/texmf-dist/doc/latex/aurl/README.md
= Readme
10 /usr/local/texlive/2018/texmf-dist/doc/latex/xurl/README.md
= Readme
11 /usr/local/texlive/2018/texmf-dist/doc/man/man1/biburl2doi.man1.pdf
12 /usr/local/texlive/2018/texmf-dist/doc/latex/xurl/Changes
13 /usr/local/texlive/2018/texmf-dist/doc/bibtex/urlbst/VERSION
14 /usr/local/texlive/2018/texmf-dist/doc/latex/unamth-template/Latex/Classes/urlbst
15 /usr/local/texlive/2018/texmf-dist/doc/generic/tex-virtual-academy-pl/latex2e/macro/url.html

To investigate more about your case, we need the output with --debug option:

$ texdoc --debug -s url

As a side note, if you give "*.sty" or "*.dtx" as a keyword, Texdoc will
search the source file instead of documentation. Thus,

$ texdoc -s url.sty
1 /usr/local/texlive/2018/texmf-dist/tex/latex/url/url.sty

is completely following our specification.

Best,
Takuto
Post by Hoffmann, Jobst
Post by George N. White III
Post by Hoffmann, Jobst
Hi Karl,
whenever I want to have a look at the url package documentation by
texdoc url
the .sty file gets displayed. Entering
texdoc -s url
shows url.pdf as second entry in the list.
Is this behaviour intended?
It might help to mention the platform and TL version (e.g., year and
whether you installed the
CTAN version or used some linux distribution version).
Problems like this may be due to an old misplaced file or a
non-standard search path.
Please check the output of "texdoc -l url". On my x86_64-linux
system I see only the full path
"[...]/texmf-dist/doc/latex/url/url.pdf" for a couple TL versions.
The platform is Fedora 28, TL 2018 was installed from CTAN, the output
from
texdoc -s url
is
1 /usr/local/texlive/2018/texmf-dist/tex/latex/url/url.sty
2 /usr/local/texlive/2018/texmf-dist/doc/latex/url/url.pdf
= Package documentation
3 /usr/local/texlive/2018/texmf-dist/doc/latex/urcls/URletter-DEMO.pdf
= Example of usage (letter)
4 /usr/local/texlive/2018/texmf-dist/doc/latex/breakurl/breakurl.pdf
= Package documentation
5 /usr/local/texlive/2018/texmf-dist/doc/bibtex/urlbst/urlbst.pdf
= Package documentation (PDF format)
6 /usr/local/texlive/2018/texmf-dist/doc/latex/xurl/xurl.pdf
= Package documentation
7 /usr/local/texlive/2018/texmf-dist/doc/bibtex/urlbst/urlbst.html
= Package documentation (HTML format)
8 /usr/local/texlive/2018/texmf-dist/doc/latex/breakurl/README
= Package README
9 /usr/local/texlive/2018/texmf-dist/doc/bibtex/urlbst/README
= Package Readme
10 /usr/local/texlive/2018/texmf-dist/doc/latex/aurl/README.md
= Readme
11 /usr/local/texlive/2018/texmf-dist/doc/latex/xurl/README.md
= Readme
12 /usr/local/texlive/2018/texmf-dist/doc/man/man1/biburl2doi.man1.pdf
13 /usr/local/texlive/2018/texmf-dist/doc/latex/xurl/Changes
14 /usr/local/texlive/2018/texmf-dist/doc/bibtex/urlbst/VERSION
15 /usr/local/texlive/2018/texmf-dist/doc/latex/unamth-
template/Latex/Classes/urlbst
--
Prof. Dr. Jobst Hoffmann Tel: +49 (241) 6009-5 31 59
Fachhochschule Aachen Abt. Jülich Fax: +49 (241) 6009-5 31 89
Peter Wilson
2018-09-15 17:27:27 UTC
Permalink
On my Ubuntu system and TL 2018
Post by Hoffmann, Jobst
texdoc url
presented the user manual but I could the package code by
Post by Hoffmann, Jobst
texdoc url.sty
Peter W.
Post by Hoffmann, Jobst
Hi Jobst and All,
https://github.com/TeX-Live/texdoc/
Talking about the issue, it didn't reproduce in my environment (macOS, TL 2018,
$ texdoc -s url
1 /usr/local/texlive/2018/texmf-dist/doc/latex/url/url.pdf
= Package documentation
2 /usr/local/texlive/2018/texmf-dist/doc/latex/urcls/URletter-DEMO.pdf
= Example of usage (letter)
3 /usr/local/texlive/2018/texmf-dist/doc/latex/breakurl/breakurl.pdf
= Package documentation
4 /usr/local/texlive/2018/texmf-dist/doc/bibtex/urlbst/urlbst.pdf
= Package documentation (PDF format)
5 /usr/local/texlive/2018/texmf-dist/doc/latex/xurl/xurl.pdf
= Package documentation
6 /usr/local/texlive/2018/texmf-dist/doc/bibtex/urlbst/urlbst.html
= Package documentation (HTML format)
7 /usr/local/texlive/2018/texmf-dist/doc/bibtex/urlbst/README
= Package Readme
8 /usr/local/texlive/2018/texmf-dist/doc/latex/breakurl/README
= Package README
9 /usr/local/texlive/2018/texmf-dist/doc/latex/aurl/README.md
= Readme
10 /usr/local/texlive/2018/texmf-dist/doc/latex/xurl/README.md
= Readme
11 /usr/local/texlive/2018/texmf-dist/doc/man/man1/biburl2doi.man1.pdf
12 /usr/local/texlive/2018/texmf-dist/doc/latex/xurl/Changes
13 /usr/local/texlive/2018/texmf-dist/doc/bibtex/urlbst/VERSION
14 /usr/local/texlive/2018/texmf-dist/doc/latex/unamth-template/Latex/Classes/urlbst
15 /usr/local/texlive/2018/texmf-dist/doc/generic/tex-virtual-academy-pl/latex2e/macro/url.html
$ texdoc --debug -s url
As a side note, if you give "*.sty" or "*.dtx" as a keyword, Texdoc will
search the source file instead of documentation. Thus,
$ texdoc -s url.sty
1 /usr/local/texlive/2018/texmf-dist/tex/latex/url/url.sty
is completely following our specification.
Best,
Takuto
Post by Hoffmann, Jobst
Post by George N. White III
Post by Hoffmann, Jobst
Hi Karl,
whenever I want to have a look at the url package documentation by
texdoc url
the .sty file gets displayed. Entering
texdoc -s url
shows url.pdf as second entry in the list.
Is this behaviour intended?
It might help to mention the platform and TL version (e.g., year and
whether you installed the
CTAN version or used some linux distribution version).
Problems like this may be due to an old misplaced file or a
non-standard search path.
Please check the output of "texdoc -l url". On my x86_64-linux
system I see only the full path
"[...]/texmf-dist/doc/latex/url/url.pdf" for a couple TL versions.
The platform is Fedora 28, TL 2018 was installed from CTAN, the output
from
texdoc -s url
is
1 /usr/local/texlive/2018/texmf-dist/tex/latex/url/url.sty
2 /usr/local/texlive/2018/texmf-dist/doc/latex/url/url.pdf
= Package documentation
3 /usr/local/texlive/2018/texmf-dist/doc/latex/urcls/URletter-DEMO.pdf
= Example of usage (letter)
4 /usr/local/texlive/2018/texmf-dist/doc/latex/breakurl/breakurl.pdf
= Package documentation
5 /usr/local/texlive/2018/texmf-dist/doc/bibtex/urlbst/urlbst.pdf
= Package documentation (PDF format)
6 /usr/local/texlive/2018/texmf-dist/doc/latex/xurl/xurl.pdf
= Package documentation
7 /usr/local/texlive/2018/texmf-dist/doc/bibtex/urlbst/urlbst.html
= Package documentation (HTML format)
8 /usr/local/texlive/2018/texmf-dist/doc/latex/breakurl/README
= Package README
9 /usr/local/texlive/2018/texmf-dist/doc/bibtex/urlbst/README
= Package Readme
10 /usr/local/texlive/2018/texmf-dist/doc/latex/aurl/README.md
= Readme
11 /usr/local/texlive/2018/texmf-dist/doc/latex/xurl/README.md
= Readme
12 /usr/local/texlive/2018/texmf-dist/doc/man/man1/biburl2doi.man1.pdf
13 /usr/local/texlive/2018/texmf-dist/doc/latex/xurl/Changes
14 /usr/local/texlive/2018/texmf-dist/doc/bibtex/urlbst/VERSION
15 /usr/local/texlive/2018/texmf-dist/doc/latex/unamth-
template/Latex/Classes/urlbst
--
Prof. Dr. Jobst Hoffmann Tel: +49 (241) 6009-5 31 59
Fachhochschule Aachen Abt. Jülich Fax: +49 (241) 6009-5 31 89
Reinhard Kotucha
2018-09-15 18:57:47 UTC
Permalink
Post by Peter Wilson
On my Ubuntu system and TL 2018
Post by Hoffmann, Jobst
texdoc url
presented the user manual but I could the package code by
Post by Hoffmann, Jobst
texdoc url.sty
Same here. I doubt that the platform matters. The program is written
in texlua with platform-independency in mind.

But texdoc looks for local configuration files. An alias in such a
file could be the culprit.

Regards,
Reinhard
--
------------------------------------------------------------------
Reinhard Kotucha Phone: +49-511-3373112
Marschnerstr. 25
D-30167 Hannover mailto:***@web.de
------------------------------------------------------------------
Takuto ASAKURA
2018-09-16 04:55:42 UTC
Permalink
Hi All,
Post by Reinhard Kotucha
I doubt that the platform matters. The program is written
in texlua with platform-independency in mind.
But texdoc looks for local configuration files. An alias in such a
file could be the culprit.
indeed. So, I said we need the output of the --debug option.
Someone who get url.sty with "texdoc url" (not "texdoc url.sty"),
please kindly report the debug output.

Thanks,
Takuto
Post by Reinhard Kotucha
Post by Peter Wilson
On my Ubuntu system and TL 2018
Post by Hoffmann, Jobst
texdoc url
presented the user manual but I could the package code by
Post by Hoffmann, Jobst
texdoc url.sty
Same here. I doubt that the platform matters. The program is written
in texlua with platform-independency in mind.
But texdoc looks for local configuration files. An alias in such a
file could be the culprit.
Regards,
Reinhard
--
------------------------------------------------------------------
Reinhard Kotucha Phone: +49-511-3373112
Marschnerstr. 25
------------------------------------------------------------------
Hoffmann, Jobst
2018-09-16 07:44:21 UTC
Permalink
Post by Takuto ASAKURA
Hi All,
Post by Reinhard Kotucha
I doubt that the platform matters. The program is written
in texlua with platform-independency in mind.
But texdoc looks for local configuration files. An alias in such a
file could be the culprit.
indeed. So, I said we need the output of the --debug option.
Someone who get url.sty with "texdoc url" (not "texdoc url.sty"),
please kindly report the debug output.
Using the --debug option - I didn't know it - I found the culprit: an
old (obsolete) texdoc configuration file (dated from August 2009) on the
TEXMFLOCAL path. Removing that file solved the problem.

Sorry for the noise, thank you for your help
Jobst
Post by Takuto ASAKURA
Thanks,
Takuto
Post by Reinhard Kotucha
Post by Peter Wilson
On my Ubuntu system and TL 2018
Post by Hoffmann, Jobst
texdoc url
presented the user manual but I could the package code by
Post by Hoffmann, Jobst
texdoc url.sty
Same here. I doubt that the platform matters. The program is written
in texlua with platform-independency in mind.
But texdoc looks for local configuration files. An alias in such a
file could be the culprit.
Regards,
Reinhard
--
------------------------------------------------------------------
Reinhard Kotucha Phone: +49-511-3373112
Marschnerstr. 25
------------------------------------------------------------------
--
Prof. Dr. Jobst Hoffmann Tel: +49 (241) 6009-5 31 59
Fachhochschule Aachen Abt. Jülich Fax: +49 (241) 6009-5 31 89
Fachbereich 09 email: ***@fh-aachen.de
Zdenek Wagner
2018-09-16 09:47:23 UTC
Permalink
ne 16. 9. 2018 v 9:45 odesílatel Hoffmann, Jobst
Post by Hoffmann, Jobst
Post by Takuto ASAKURA
Hi All,
Post by Reinhard Kotucha
I doubt that the platform matters. The program is written
in texlua with platform-independency in mind.
But texdoc looks for local configuration files. An alias in such a
file could be the culprit.
indeed. So, I said we need the output of the --debug option.
Someone who get url.sty with "texdoc url" (not "texdoc url.sty"),
please kindly report the debug output.
Using the --debug option - I didn't know it - I found the culprit: an
old (obsolete) texdoc configuration file (dated from August 2009) on the
TEXMFLOCAL path. Removing that file solved the problem.
Do you have a copy of the file and can you send it to me? It is always
interesting to see to sources of problems. At least it helps me to
give advices to others if something does not work on their computers.
Post by Hoffmann, Jobst
Sorry for the noise, thank you for your help
Jobst
Zdeněk Wagner
http://ttsm.icpf.cas.cz/team/wagner.shtml
http://icebearsoft.euweb.cz
Post by Hoffmann, Jobst
Post by Takuto ASAKURA
Thanks,
Takuto
Post by Reinhard Kotucha
Post by Peter Wilson
On my Ubuntu system and TL 2018
Post by Hoffmann, Jobst
texdoc url
presented the user manual but I could the package code by
Post by Hoffmann, Jobst
texdoc url.sty
Same here. I doubt that the platform matters. The program is written
in texlua with platform-independency in mind.
But texdoc looks for local configuration files. An alias in such a
file could be the culprit.
Regards,
Reinhard
--
------------------------------------------------------------------
Reinhard Kotucha Phone: +49-511-3373112
Marschnerstr. 25
------------------------------------------------------------------
--
Prof. Dr. Jobst Hoffmann Tel: +49 (241) 6009-5 31 59
Fachhochschule Aachen Abt. Jülich Fax: +49 (241) 6009-5 31 89
Loading...