Skip to content

[R-pkg-devel] Package manual built by CRAN (Xposted from R-help)

3 messages · Duncan Murdoch, Helmut Schütz

#
Dear all,

recently I noticed an unexpected effect. The PDF-manual built from the 
package?s .Rd-files looked different to what I was used to beforeand to 
the one rendered locally. Specifically: If the reference-section looks 
like this

\references{
 ? foo \href{bar}{baz}
 ? ...
}

previously "foo" was intended (like a normal paragraph), "bar" formatted 
in red and "baz" the URL.

Example of what I got instead: 
https://cran.r-project.org/web/packages/replicateBE/replicateBE.pdf 
(first occurrence at page 5).

In the references there are no direct links but a numbered footnotes in 
a mono-spaced font running beyond the right margin of the page. The two 
links of page 5:

In ABE.Rd
https://www.ema.europa.eu/en/documents/scientific-guideline/guideline-investigation-bioequivalence-rev1_en.pdf 

https://www.ema.europa.eu/en/documents/scientific-guideline/guideline-pharmacokinetic-clinical-evaluation-modified-release-dosage-forms_en.pdf 


ABE.Rd is correctly rendered into ABE.html

In the two footnotes of the PDF links are truncated
https://www.ema.europa.eu/en/documents/scientific-guideline/guideline-investigation-bioequivalence-rev1_ 

https://www.ema.europa.eu/en/documents/scientific-guideline/guideline-pharmacokinetic-clinical-evaluation-modified-release-dosage-forms_ 

Of course, both are punished with a HTTP 404.

Cheers,
Helmut

PS: I?m aware that
\references{
 ? \enumerate{
 ? ? \item foo \href{bar}{baz}
 ? }
}
produces *exactly* this effect. Didn't use it.
#
This sounds like a LaTeX bug in whatever system CRAN is using to produce 
the PDF.  Like you, I don't see footnotes, I see the link inline with a 
complete URL.  I think you'd get the footnotes if the LaTeX hyperref.sty 
file is not found, but there may be other ways to trigger that option.

Duncan Murdoch
On 25/07/2019 1:45 p.m., Helmut Sch?tz wrote:
#
Hi Duncan,

Duncan Murdoch wrote on 2019-07-25 21:33:
Perfect guess! When I removed hyperref.sty from my installation I got 
also the footnotes (without any errors or warnings).
So what is the best way to proceed? Ask Uwe Ligges?

Helmut