[ESS] Hyperlinks in help pages

[Kiermeier, Andreas (PIRSA - SARDI)]

Martin,

I haven't gone to the length that Frede has, but I can confirm that I only have one version of ESS installed on the system - nothing came with Emacs & the version I got I've installed myself.

In general what I have done is:

1) Installed (unzipped) ess into my emacs/site-lisp folder.
2) renamed the folder "ess-5.2.10" to "ess" (which saves me having to change my init file for every new version of ess.
3) Byte complied all the .el files in the lisp subfolder.

4) The following is in my init file, most of these come either from the info file or through the list.  I have no further modifications through Emacs customization.

Cheers,

Andreas


(setq load-path (cons "d:/emacs/site-lisp/ess/lisp" load-path))
(require 'ess-site)

(setq comint-input-ring-size 200)
(setq ess-source-directory "C:/Temp")
(setq inferior-ess-same-window nil)

(add-hook 'ess-mode-hook
          (lambda ()
	    (setq comint-scroll-to-bottom-on-output t)
	    (ess-set-style 'DEFAULT)
            ))

(defun Rnw-mode()
  (require 'ess-noweb)
  (noweb-mode)
  (if (fboundp 'R-mode)
      (setq noweb-default-code-mode 'R-mode)))

(add-to-list 'auto-mode-alist '("\\.Rnw\\'" . Rnw-mode))
(add-to-list 'auto-mode-alist '("\\.Snw\\'" . Snw-mode))

(setq reftex-file-extensions
      '(("Snw" "Rnw" "nw" "tex" ".tex" ".ltx") ("bib" ".bib")))
(setq TeX-file-extensions
      '("Snw" "Rnw" "nw" "tex" "sty" "cls" "ltx" "texi" "texinfo"))

(setq ess-help-own-frame 'one)
(setq ess-help-frame-alist		; Modify the help frame appearance
      '((height . 45)
	(width . 80)
	(unsplittable . t)))

(autoload 'ess-rdired "ess-rdired"
  "View *R* objects in a dired-like buffer." t)

(defun ess-makeTexify ()
   "Run LaTeX on the product of Sweave()ing the current file."
   (interactive)
   (save-excursion
     (setq thisbuffer (buffer-name))
     (setq namestem (substring (buffer-name) 0 (search ".Rnw" (buffer-name))))
     (setq latex-filename (concat namestem ".tex"))
     (message "Running LaTeX ..." )
     (switch-to-buffer "*tex-output*")
     (kill-region (point-min) (point-max))
     (call-process "texify" nil "*tex-output*" 1 latex-filename)
     (goto-char (point-max))
     (sit-for 2)
     (switch-to-buffer thisbuffer)
     (message "Finished running LaTeX" )))

(eval-after-load "comint" '(progn
  (setq comint-scroll-to-bottom-on-output 'others)
  (setq comint-scroll-show-maximum-output t) ; I find jumpy
  (define-key comint-mode-map "\C-a"
    'comint-bol-or-process-mark) )
)


-----Original Message-----
From: Martin Maechler [mailto:maechler at stat.math.ethz.ch]
Sent: Tuesday, 21 March 2006 18:51
To: Kiermeier, Andreas (PIRSA - SARDI)
Cc: ess-help at stat.math.ethz.ch
Subject: Re: [ESS] Hyperlinks in help pages


>>>>> "AndrK" == Kiermeier, Andreas <Kiermeier.Andreas at saugov.sa.gov.au>
>>>>>     on Tue, 21 Mar 2006 09:24:09 +1030 writes:

    AndrK> Martin, two things for me (I guess they are the same
    AndrK> as for several others):

    AndrK> 1) ss does nothing, in fact, I get a message saying
    AndrK> that "s s is undefined".

    AndrK> 2) If I move down manually to summary.lm and press h
    AndrK> I get the message "Help on:"

Yes. I understood;  and the same applies to Frede.
But it means there's a considerable problem / bug in your
Emacs/ESS setup.

The help-mode section commands are governed by the variable
  ess-help-sec-keys-alist

This should be 'nil' after starting Emacs
and should become [C-h v ess-help-sec-keys-alist]

  >> ess-help-sec-keys-alist's value is shown below.
  >> 
  >> Documentation:
  >> Alist of (key . string) pairs for use in section searching.
  >> 
  >> Defined in `ess-cust'.
  >> 
  >> Value:
  >> ((97 . "\\s *Arguments:")
  >>  (100 . "\\s *Description:")
  >>  (68 . "\\s *Details:")
  >>  (101 . "\\s *Examples:")
  >>  (110 . "\\s *Note:")
  >>  (114 . "\\s *References:")
  >>  (115 . "\\s *See Also:")
  >>  (117 . "\\s *Usage:")
  >>  (118 . "\\s *Value[s]?"))

after M-x R
(M-x S or M-x S+ or ...
 will define a different list, since the S-plus help
 pages look a bit different).

---

I guess something is badly wrong in your emacs initialization if
you don't get the above; but I don't know.
Could it be that you are accidentally mixing two different
installations of ESS, e.g. one that ``comes with your system''
and one that you set up yourself?

    AndrK> Andreas