char2Rdpiece | R Documentation |
Convert a character vector to Rd piece.
char2Rdpiece(content, name, force.sec = FALSE)
content |
a character vector. |
name |
name of an Rd macro, a string. |
force.sec |
TRUE or FALSE, see ‘Details’. |
Argument content
is converted to an Rd piece using
name
to determine the format of the result.
The Rd tag
of content
is set as appropriate for name
.
More specifically, if name
is the name of a macro (without the
leading '\
') whose content has a known "Rdtag", that tag is
used. Otherwise the tag is set to "TEXT".
If force.sec
is TRUE, name
is treated as the name of a
top level section of an Rd object. A top level section is exported as
one argument macro if it is a standard section (detected with
is_Rdsecname
) and as the two argument macro
"\section
" otherwise.
If force.sec
is FALSE, the content is exported as one argument
macro without further checks.
This function does not attempt to escape special symbols like ‘%’.
Georgi N. Boshnakov
## add a keyword section
a1 <- char2Rdpiece("graphics", "keyword")
a1
## "keyword" is a standard Rd top level section, so 'force.sec' is irrelevant
a2 <- char2Rdpiece("graphics", "keyword", force.sec = TRUE)
identical(a1, a2)
## an element suitable to be put in a "usage" section
char2Rdpiece("log(x, base = exp(1))", "usage")
## a user defined section "Todo"
char2Rdpiece("Give more examples for this function.", "Todo", force.sec = TRUE)
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.