[Rd] Problem with build and check

[Joshua Ulrich]

On Wed, Nov 12, 2014 at 1:28 PM, Duncan Murdoch
<murdoch.duncan at gmail.com> wrote:
> On 12/11/2014 2:11 PM, Therneau, Terry M., Ph.D. wrote:
>>
>> I am getting failure of build and check, for an Rd file that has a long
>> argument list.
>> Guess diagnosis: a quoted string beyond a certain point in the argument
>> list is fatal.
>
>
> No, the problem is that % is a comment marker in .Rd.  You need to escape
> those in the dateformat default.  Apparently
> prompt() doesn't know this...
>
> Duncan Murdoch
>
prompt.default does add the escapes for the example section, but not
for the usage section.

>>
>> Example:  Use the function below, create an Rd file for it with prompt().
>> Move the .Rd
>> file to the man directory (no need to edit it) and try building
>>
>> dart.control <- function(server=c("production", "integration",
>> "development",
>>                                     "http"),
>>                            out.poll.duration = 5,
>>                            out.poll.increase = 1.1,
>>                            out.poll.max = 30,
>>                            out.poll.timeout = 3600,
>>                            netrc.path,
>>                            netrc.server = "ldap",
>>                            rtype = c("xml", "json"),
>>                            dateformat= "%Y-%m-%d") {
>>
>>       server <- match.arg(server)
>>       server
>> }
>>
>> I created a package "dummy" with only this function, and get the following
>> on my Linux box.
>>
>> tmt-local2021% R CMD build dummy
>> * checking for file ‘dummy/DESCRIPTION’ ... OK
>> * preparing ‘dummy’:
>> * checking DESCRIPTION meta-information ... OK
>> Warning: newline within quoted string at dart.control.Rd:11
>> Warning: /tmp/RtmpjPjz9V/Rbuild398d6e382572/dummy/man/dart.control.Rd:46:
>> unexpected
>> section header '\value'
>> Warning: newline within quoted string at dart.control.Rd:11
>> Error in
>> parse_Rd("/tmp/RtmpjPjz9V/Rbuild398d6e382572/dummy/man/dart.control.Rd", :
>>     Unexpected end of input (in " quoted string opened at
>> dart.control.Rd:88:16)
>> Execution halted
>>
>> Session info for my version
>>   > sessionInfo()
>> R Under development (unstable) (2014-10-30 r66907)
>> Platform: i686-pc-linux-gnu (32-bit)
>>
>> locale:
>>    [1] LC_CTYPE=en_US.UTF-8       LC_NUMERIC=C
>>    [3] LC_TIME=en_US.UTF-8        LC_COLLATE=C
>>    [5] LC_MONETARY=en_US.UTF-8    LC_MESSAGES=en_US.UTF-8
>>    [7] LC_PAPER=en_US.UTF-8       LC_NAME=C
>>    [9] LC_ADDRESS=C               LC_TELEPHONE=C
>> [11] LC_MEASUREMENT=en_US.UTF-8 LC_IDENTIFICATION=C
>>
>> attached base packages:
>> [1] stats     graphics  grDevices utils     datasets  methods base
>>
>>
>> Terry T.
>>
>> ______________________________________________
>> R-devel at r-project.org mailing list
>> https://stat.ethz.ch/mailman/listinfo/r-devel
>
>
> ______________________________________________
> R-devel at r-project.org mailing list
> https://stat.ethz.ch/mailman/listinfo/r-devel



-- 
Joshua Ulrich  |  about.me/joshuaulrich
FOSS Trading  |  www.fosstrading.com