R(1)

๐Ÿ’… R(1) โ€” the manual page, bestie edition โœจ

okay so like โ€” this is the R(1) man page, the general manual for R on Unix-y systems, and I'm gonna walk you through every single bit of it. no skipping, no "you'll figure it out", we're doing the whole thing. grab a snack ๐Ÿ“


๐ŸŒธ NAME ๐ŸŒธ

R โ€” a language for data analysis and graphics. that's the whole vibe. it does stats, it does plots, it's a whole language. periodt.


๐Ÿฆ‹ SYNOPSIS ๐Ÿฆ‹

R [options] [< infile] [> outfile]
R CMD command [arguments]

two whole modes, bestie. either you're launching R straight up with options (and maybe piping in an infile / piping out to an outfile), or you're going through the R CMD interface to poke at one of the tools. pick your fighter ๐Ÿ’…


โœจ DESCRIPTION โœจ

so you start R โ€” a system for statistical computation and graphics โ€” with whatever options you specified. or you invoke an R tool through that 'R CMD' interface. both valid, both iconic.

R is a language that bears a passing resemblance to the S language developed at AT&T Bell Laboratories ๐Ÿ‘‘ (yes, that AT&T Bell Labs, iykyk). it's got support for a whole variety of statistical and graphical analyses. and ngl, R is a true computer language โ€” it's got a bunch of control-flow constructions for iteration and alternation, like, actual programming constructs, not just a calculator with delusions of grandeur. and you can add your own functionality by defining new functions, which is honestly the best part ๐Ÿซถ

on systems that have the GNU readline(3) library, R will maintain a command history โ€” so you can recall, edit, and re-execute your commands. no more retyping the whole thing because of one typo. a blessing. ๐Ÿ˜ญ


๐ŸŽ€ OPTIONS ๐ŸŽ€

most of these control what happens at the beginning and at the end of an R session โ€” in particular which files are being read and written, and how much memory gets reserved for the R process. so like, bookkeeping stuff, but important bookkeeping stuff.

  • -h, --help โ€” print a short help message and exit. bye ๐Ÿ‘‹
  • --version โ€” print version info and exit
  • --encoding=ENC โ€” specify the encoding to be used for stdin
  • --encoding ENC โ€” same thing, space-separated flavor โœจ
  • RHOME โ€” print the path to the R home directory and exit
  • --save โ€” do save the workspace at the end of the session
  • --no-save โ€” don't save it ๐Ÿ™ˆ
  • --no-environ โ€” don't read the site and user environment files
  • --no-site-file โ€” don't read the site-wide Rprofile
  • --no-init-file โ€” don't read the user R profile
  • --restore โ€” do restore previously saved objects at startup
  • --no-restore-data โ€” don't restore previously saved objects
  • --no-restore-history โ€” don't restore the R history file
  • --no-restore โ€” don't restore anything. scorched earth ๐Ÿ’€
  • --vanilla โ€” combine --no-save, --no-restore, --no-site-file, --no-init-file and --no-environ. it's the "just give me a clean slate" bundle ๐Ÿงš
  • --no-readline โ€” don't use readline for command-line editing
  • --max-connections=N โ€” set max number of connections to N
  • --max-ppsize=N โ€” set max size of the protect stack to N
  • --min-nsize=N โ€” set min number of fixed size obj's ("cons cells") to N
  • --min-vsize=N โ€” set the vector heap minimum to N bytes; '4M' = 4 MegaB
  • -q, --quiet โ€” don't print the startup message
  • --silent โ€” same as --quiet
  • -s, --no-echo โ€” make R run as quietly as possible
  • --interactive โ€” force an interactive session
  • --verbose โ€” print more information about progress ๐Ÿ‘€
  • -d, --debugger=NAME โ€” run R through debugger NAME
  • --debugger-args=ARGS โ€” pass ARGS as arguments to the debugger
  • -g TYPE, --gui=TYPE โ€” use TYPE as the GUI; possible values are 'X11' (default) and 'Tk'
  • --arch=NAME โ€” specify a sub-architecture
  • --args โ€” skip the rest of the command line
  • -f FILE, --file=FILE โ€” take input from 'FILE'
  • -e EXPR โ€” execute 'EXPR' and exit
heads up bestie: FILE may contain spaces but not shell metacharacters. so spaces = fine, shell weirdness = not fine ๐Ÿšซ

๐ŸŒˆ Commands: ๐ŸŒˆ

these are the R CMD tools, the little sidekicks:

  • BATCH โ€” run R in batch mode
  • COMPILE โ€” compile files for use with R
  • SHLIB โ€” build a shared library for dynamic loading
  • INSTALL โ€” install add-on packages
  • REMOVE โ€” remove add-on packages
  • build โ€” build add-on packages
  • check โ€” check add-on packages
  • LINK โ€” front-end for creating executable programs
  • Rprof โ€” post-process R profiling files
  • Rdconv โ€” convert Rd format to various other formats
  • Rd2pdf โ€” convert Rd format to PDF
  • Rd2txt โ€” convert Rd format to pretty text
  • Stangle โ€” extract S/R code from Sweave documentation
  • Sweave โ€” process Sweave documentation
  • Rdiff โ€” diff R output ignoring headers etc
  • config โ€” obtain configuration information about R
  • javareconf โ€” update the Java configuration variables
  • rtags โ€” create Emacs-style tag files from C, R, and Rd files

please use 'R CMD command --help' to get further information about how to use 'command', okay? it's right there, use it ๐Ÿ’–

also โ€” sneaky but useful โ€” the options --arch, --no-environ, --no-init-file, --no-site-file and --vanilla can be placed between R and CMD, so they apply to the R processes run by 'command'. flexibility, slay.


๐Ÿ› REPORTING BUGS ๐Ÿ›

found a bug? report it at <https://bugs.R-project.org>. be nice, be specific ๐Ÿซถ


Copyright ยฉ 2026 The R Foundation for Statistical Computing Platform: x86_64-redhat-linux-gnu

R is free software and comes with ABSOLUTELY NO WARRANTY. like, absolutely absolutely. you are welcome to redistribute it under the terms of the GNU General Public License versions 2 or 3. for more information about these matters see <https://www.gnu.org/licenses/>. ๐Ÿ“œ


๐Ÿ’œ SEE ALSO ๐Ÿ’œ

the full documentation for R is provided by a collection of Texinfo manuals plus individual help for R objects, which is also available online.

start R and type ?topic at the R prompt to get on-line information for topic.

if the processed manuals have been installed, they'll be available as DVI and/or PDF files in the doc/manual subdirectory of the documentation directory tree (default `R RHOME`).

and if the info program and the R manuals are installed on your system, typing these should give you access to the good stuff:

info -f R-intro, info -f R-data, info -f R-exts, info -f R-FAQ,
info -f R-lang and info -f R-ints

which gets you, respectively: An Introduction to R'' (the basic manual), the R Data Import/Export'' Guide, the R Extension Writer's Guide'', the R FAQ'', the The R Language Definition'', and the R Internals''. a whole library, no cap ๐Ÿ“šโœจ


okay that's literally the whole page!! this was R version 4.6.1, dated June 2026, and yes it's the R(1) page โ€” go forth and analyze your data, bestie ๐ŸŒธ๐Ÿฆ‹๐Ÿ’…

๐Ÿ“ฆ where this page comes from