Skip to content

[Bioc-devel] linking to suggested package in documentation

2 messages · Stephanie M. Gogarten, Martin Morgan

#
The package is installed on my system.  If it is listed in the 
"Suggests" field, I get the warning

* checking Rd cross-references ... WARNING
Missing link(s) in documentation object 
?/Volumes/geneva_sata/stephanie/Bioconductor/GWASTools/man/snpStats.Rd?:
   ?SnpMatrix-class?

If I move the "snpStats" package from "Suggests" to "Imports," that 
warning goes away.

I can see why R would warn about documentation links to packages in 
"Suggests", because if the package is not installed the link would be 
broken.  But I was wondering if there was a clever way to convince R CMD 
check that packages in "Suggests" should be considered valid for 
documentation links.

thanks,
Stephanie
On 5/17/12 3:00 AM, bioc-devel-request at r-project.org wrote:
#
On 05/17/2012 08:16 AM, Stephanie M. Gogarten wrote:
Hi Stephanie --

I think you're looking for sectin 2.5 of Writing R Extensions -- Cross 
references, along the lines of

   \link[pkg]{foo}

where 'foo' is the name of the _html_ file foo is documented in, or

   \link[pkg:bar]{foo}

to find documentation on foo in html page bar.html.

Martin