[R-pkg-devel] Literal LaTeX Text in Function Arguments

Georgi Boshnakov georg|@bo@hn@kov @end|ng |rom m@nche@ter@@c@uk
Fri Aug 23 15:51:39 CEST 2019

Rd is not LaTeX, although it resembles it.  You should use only markup described in WRE.
For example, \dots is for the use case you mention. 

Georgi Boshnakov

-----Original Message-----
From: R-package-devel [mailto:r-package-devel-bounces using r-project.org] On Behalf Of bill using denney.ws
Sent: 23 August 2019 04:15
To: r-package-devel using r-project.org
Subject: [R-pkg-devel] Literal LaTeX Text in Function Arguments



Does anyone know how to include verbatim \ldots (and maybe other LaTeX) in
an .Rd file correctly? 


When LaTeX is in the default arguments for a function, the code is
interpreted which makes the documentation not match the default formal


An example is:



Which yields:



Which gives the following warning with `devtools::check()`:


checking for code/documentation mismatches ... WARNING

Codoc mismatches from documentation object 'topic_long_table_header':


  Code: function(x, col_names = NULL, above_col_names = "\\hline
<file://hline> ",

                 below_col_names = "\\hline <file://hline> ",

                 subsequent_page_notification = "\\ldots continued
<file://ldots%20continued> ",

                 latex_header = NULL)

  Docs: function(x, col_names = NULL, above_col_names = "\\hline
<file://hline> ",

                 below_col_names = "\\hline <file://hline> ",

                 subsequent_page_notification = "\... continued",

                 latex_header = NULL)



I'm not sure, but I think that the solution is to add more protection to the
\s when generating the roxygen or perhaps wrapping the arguments in some
form of verbatim block (if it's available).






P.S. This is also discussed in https://github.com/r-lib/roxygen2/issues/837
where it appears to be related to the conversion of .Rd to help files not
the roxygen step.


	[[alternative HTML version deleted]]

R-package-devel using r-project.org mailing list

More information about the R-package-devel mailing list