Ответ 1
В конце концов, я сделал зависимость otherpkg
.
Мой пакет hyperSpec
предоставляет функции для работы со спектральными наборами данных. Я предоставляю hyperSpec-методы для целого ряда функций, поступающих из других пакетов. Однако некоторые из этих других пакетов я перечислял как Suggests:
, поскольку я не хочу заставлять пользователей устанавливать что-то вроде 20 других пакетов (подсчет зависимостей), если они никогда не смогут использовать определенную функциональность.
С точки зрения кодирования это работает хорошо. Однако я не понимаю, как это сделать в файле .Rd, но я уверен, что это довольно распространенная проблема.
Обычный \code{\link[otherpkg]{fun}}
не будет надежно работать, так как нет гарантии, что otherpkg доступен. Если otherpkg не установлен, ссылка не работает. Это будет обнаружено с помощью R CMD check
, например. на Winbuilder и r-forge. Это означает: пакет не будет проходить проверку CRAN.
Какие пакеты будут хорошим примером для просмотра?
Единственный намек (хотя нет решения), который я нашел до сих пор: https://stat.ethz.ch/pipermail/r-devel/2009-November/055425.html (но на этот адрес не было ответа).
В конце концов, я сделал зависимость otherpkg
.
В разделе Cross-References в разделе "Написание расширений R" говорится, что для связи с другими пакетами используйте
\link[otherpkg]{foo}
с хитрой/непостижимой вещью, заключающейся в том, что foo - это имя страницы справки html, на которую вы хотите установить ссылку (внутри пакета не требуется [mypkg]
и foo
будет \alias
на другой странице руководства). Имя справочной страницы определяется директивой \name
в файле Rd, определяющей помощь, которую вы хотите получить.