#+DATE: 2021

* Using R within emacs

** Open R manuals in Emacs-ess

The function ~?help.start()~ from ~utils~ package doesn't open the R manuals
in R vanilla

#+begin_src R
  ?help.start()
#+end_src

#+RESULTS:

To find the help files with rutils in Emacs-ess, use:

: M-x ess-rutils-html-docs

To open the help documents in browser, check the value of variable
and set the browser

#+begin_src R
  test <- options()
  head(test)
#+end_src

#+RESULTS:
| TRUE | cairo | iceweasel | FALSE | FALSE | FALSE |

#+begin_src R
  test <- options()
  names(test[1:10])
#+end_src

#+RESULTS:
| add.smooth          |
| bitmapType          |
| browser             |
| browserNLdisabled   |
| CBoundsCheck        |
| check.bounds        |
| citation.bibtex.max |
| continue            |
| contrasts           |
| defaultPackages     |

: > option(browser = "iceweasel") # setting a browser

The manuals can also be accessed using 'info' program in emacs, e.g.

: C-h i

Then use 'ALT' + 'm' and write the initial words of the manual you
are looking for:

: M m R

All the R manual can be accesed. From ~$ man R~. Typing in terminal 'info -f' followed
by the name of each section:

 * info -f R-intro
 * info -f R-data
 * info -f R-exts
 * info -f R-FAQ
 * info -f R-lang
 * info -f R-ints