SweaveListingUtils (version 0.7.7)

lstset: lstset and friends

Description

Functions for defining how listings prints R and Rd source code

Usage

lstset(taglist, LineLength = getOption("width"), startS = "\\lstset{")
lstsetR(Rset = NULL, LineLength = getOption("width"),
        add = getSweaveListingOption("addRset"),
        startS = "\\lstset{", append = TRUE, withRstyle = FALSE)
lstsetRd(Rdset = NULL, LineLength = getOption("width"),
         add = getSweaveListingOption("addRdset"),
         startS = "\\lstset{",
                    append = TRUE)
lstsetRin(Rinset = NULL, LineLength = getOption("width"),
          add = getSweaveListingOption("addRinset"),
          startS = "\\lstdefinestyle{Rinstyle}{",
                    append = TRUE)
lstsetRout(Routset = NULL, LineLength = getOption("width"),
           add = getSweaveListingOption("addRoutset"),
           startS = "\\lstdefinestyle{Routstyle}{",
                    append = TRUE)
lstsetRcode(Rcodeset = NULL, LineLength = getOption("width"),
            add = getSweaveListingOption("addRcodeset"),
            startS = "\\lstdefinestyle{Rcodestyle}{",
                    append = TRUE)
lstsetRall(Rallset = NULL, LineLength = getOption("width"),
           add = c("in" = getSweaveListingOption("addRinset"),
                   "out" = getSweaveListingOption("addRoutset"),
                   "code" = getSweaveListingOption("addRcodeset")),
           startS = c("in" = "\\lstdefinestyle{Rinstyle}{",
                      "out" = "\\lstdefinestyle{Routstyle}{",
                      "code" = "\\lstdefinestyle{Rcodestyle}{"),
           append = c("in" = TRUE, "out" = TRUE, "code" = TRUE),
           withOptionsDefAppend = TRUE)
lstdefRstyle(Rset = NULL, LineLength = getOption("width"),
             add = TRUE)

Arguments

LineLength

numeric number of characters per line for lstset and friends; defaults to getOption("width")

taglist

S3-object of class taglist; arguments for \lstset of TeX package listings.

Rset

object of S3-class taglist or named list of characters; the listings settings for R-code (for \lstset); defaults to NULL.

Rinset

object of S3-class taglist or named list of characters; the listings settings for R-code in environment Sinput; defaults to NULL.

Routset

object of S3-class taglist or named list of characters; the listings settings for R-code in environment Soutput; defaults to NULL.

Rcodeset

object of S3-class taglist or named list of characters; the listings settings for R-code in environment Scode; defaults to NULL.

Rallset

object of S3-class taglist or named list of characters; the listings settings for R-code in environments Sinput, Soutput, Scode, simultaneously; defaults to NULL.

Rdset

object of S3-class taglist or named list of characters; the listings settings for Rd-code (for \lstset); defaults to NULL.

add

boolean; defaults to TRUE; if TRUE, argument list Rset resp. Rdset will be appended to default value lists getSweaveListingOption("Rset") resp. getSweaveListingOption("Rdset") (see below), overwriting respective entries of the default value lists; in case of lstsetRall may be named vector of length 3 with names c("in","out","code").

startS

character; defaults to "\\lstset\{"; what to do by default we use \lstset; an alternative is to use \lstdefinestyle which amounts to "\\lstdefinestyle\{"; in case of lstsetRall may be named vector of length 3 with names c("in","out","code").

append

logical; if TRUE (default) the new settings are appended to the old ones; otherwise they are prepended; in case of lstsetRall may be named vector of length 3 with names c("in","out","code").

withRstyle

logical; if TRUE "style = Rstyle," is prepended.

withOptionsDefAppend

logical: shall definitions from global options (see SweaveListingoptions) be included?

Value

invisible()

Details

lstset writes out to stdout a call to TeX command \lstset{arg1 = val1, arg2 = val2, .....} and doing so respects a maximal number of characters per line and does not break arg=val tags. lstsetR and lstsetRd expect either objects of S3 class taglist, or lists of named characters as first arguments, which in the latter case are then converted to taglist; both lstsetR and lstsetRd use particular default values to define R resp. Rd output format. More specifically for R code, it uses getSweaveListingOption("Rset"), and for Rd code, it getSweaveListingOption("Rdset"); lstsetRin, lstsetRout, and lstsetRcode are corresponding specialized commands for 'listings' environments Sinput, Soutput, and Scode, respectively. lstsetRall simultaneously sets/modifies settings for 'listings' environments Sinput, Soutput, and Scode. lstsetdefRstyle redefines listings style definition for Rstyle. The output to stdout can be captured in an .Rnw file as

<< lstsetR, results=tex, echo=FALSE>>=
lstsetR()
@

to insert the corresponding \lstset command to the produced TeX file.

Examples

lstset(taglist(A="H", b=2, 3),30)
lstset(taglist(A="H", b=2, 3),30, startS = "\\lstdefinestyle{Rstyle}{")
lstsetR()
lstsetRd()