[ESS] help("foo") opens web browser but ?foo doesn't

Vitalie Spinu spinuvit at gmail.com
Wed Mar 13 17:35:23 CET 2013



Well. Jumping to "see also" or index is not a good reason. You can do
that in ess help with "h" and "i" respectively.

Opening in the same place is a good reason, though I was never bothered
by that. With ido, iflip and ibuffer switching back and forth is
instantious. And given that you forgo so many good things about ESS help
(section navigation, execution of code blocks, apropos, help on object,
index etc) html help doesn't remotely cut it IMO.

Some more cool features are on their way, of which I am silent for now
to keep the suspense ;)

    Vitalie

  >> Henrik Singmann <henrik.singmann at psychologie.uni-freiburg.de>
  >> on Wed, 13 Mar 2013 16:04:18 +0100 wrote:

  > Hi Vitalie,

  > The reason I prefer html help is mainly practically. When working with Emacs, I
  > usually have one Emacs frame open with two windows on my main screen, Source
  > plus R. Then, I would like to open all help pages in a separate window on a
  > different screen.
  > This is no problem when using html help, as they simply open in a new tab in the browser.
  > In contrast when using emacs help, even when setting up another frame with the
  > help file, the next help file will usually be opened in the frame that was the
  > last one active and not in the designated one on the extra screen. So either the
  > source or the R process is hidden and I need to reset the old behavior using
  > some C-x o C-x <left/right> combinations.
  > Additionally, I like to klick on the "See also" links.

  > But as I said in the discussion a little further done in this thread, I figured the issue is caused by the following line which is always called at the beginning of any R process, seemingly by ESS:
  > options(chmhelp=FALSE, help_type="text")
  > If you could tell me which variable I have to alter to change this to help_type = "html" that would solve my problem.

  > Thanks,
  > Henrik

  > Am 13.03.2013 15:42, schrieb Vitalie Spinu:
  >> Hi Henrik,
  >> 
  >> On ?ESS, just asks R for ?foo. On C-c C-v and help("foo") it uses
  >> inferior-ess-r-help-command instead. This inconsistency is for
  >> historical reasons mainly. Nowadays there is no need for .help.ESS and
  >> it is just a wrapper for R's help. And indeed in long run ESS should
  >> better respect R's options(...).
  >> 
  >> May I ask why do you prefer html help?  ESS help pages are superior in
  >> pretty much every respect I can think of.
  >> 
  >> Vitalie
  >> 
  >> >> Henrik Singmann <henrik.singmann at psychologie.uni-freiburg.de>
  >> >> on Wed, 13 Mar 2013 12:49:26 +0100 wrote:
  >> 
  >> > Hi all,
  >> 
  >> > I know that similar questions have come up from time to time, but the solutions didn't fit my problem.
  >> 
  >> > I want ESS to display help pages always in the web browser and
  >> > managed to do so partly thanks to SO
  >> > (http://stackoverflow.com/q/2413163/289572) via
  >> > '(inferior-ess-r-help-command ".help.ESS(\"%s\",
  >> > help_type=\"html\")") in my custom variables in my .emacs
  >> 
  >> > However, the browser only opens for help("foo") but not ?foo.
  >> 
  >> > Any thoughts on how to open help in browser also for ?foo (or better always)?
  >> 
  >> > Many thanks,
  >> > Henrik
  >>



More information about the ESS-help mailing list