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.
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.
I certainly have longer argument lists with no problem. More likely the Rd file needs special consideration for %. Paul On 11/12/2014 02: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. > > 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
On Wed, 12 Nov 2014, "Therneau, Terry M., Ph.D." <therneau at mayo.edu> writes:> 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.Another guess: should you not escape the '%'? That is, write "\%Y-\%m-\%d"? [Untested.]> 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. >-- Enrico Schumann Lucerne, Switzerland http://enricoschumann.net
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> > 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
'Writing R Extensions', section 2.1 Rd format, says" Comments run from a percent symbol % to the end of the line in all types of text (as on the first line of the load example). Because backslashes, braces and percent symbols have special meaning, to enter them into text sometimes requires escapes using a backslash. In general balanced braces do not need to be escaped, but percent symbols always do. For the complete list of macros and rules for escapes, see ?Parsing Rd files? <http://developer.r-project.org/parseRd.pdf>. Bill Dunlap TIBCO Software wdunlap tibco.com On Wed, Nov 12, 2014 at 11:11 AM, Therneau, Terry M., Ph.D. < therneau at mayo.edu> 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. > > 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 >[[alternative HTML version deleted]]