[ESS] Hyperlinks in help pages

Frede Aakmann Tøgersen FredeA.Togersen at agrsci.dk
Mon Mar 20 10:58:52 CET 2006



In Emacs 21.3 (see below for version):

C-c C-v display 'Help on:' in the mini-buffer. Typing lm <Enter> opens another buffer in Emacs with the help page for lm. Switching to this buffer with C-x o the commands 'n' and 'p' works scrolling down and up sections.

However nothing (absolutely nothing) happens when typing s s. Going manually to the 'See also' section placing the cursor on 'summary.lm' and typing h only opens the minibuffer with a 'Help on:' and nothing more.

In Emacs 22.0:

Almost the same behaviour, the only difference being Emacs complaining about the keystroke s s not being defined. However, there seems to be more information in this Emacs' *ESS* buffer.

See below for the setups and debug buffers.


Best regards

Frede Aakmann Tøgersen
Scientist


Danish Institute of Agricultural Sciences
Research Centre Foulum
Dept. of Genetics and Biotechnology
Blichers Allé 20, P.O. BOX 50
DK-8830 Tjele

Phone:   +45 8999 1900
Direct:  +45 8999 1878

E-mail:  FredeA.Togersen at agrsci.dk
Web:	   http://www.agrsci.org				

This email may contain information that is confidential.
Any use or publication of this email without written permission from DIAS is not allowed.
If you are not the intended recipient, please notify DIAS immediately and delete this email.

 
The setup:

###########

The OS is Windows XP (Servicepack 2)

###########

For Emacs 21.3:

GNU Emacs 21.3.1 (i386-mingw-nt5.1.2600) of 2004-03-10 on NYAUMO

with *ESS' buffer:

[ess-site.el]: ess-customize-alist=nil 
[ess-site.el _2_]: ess-customize-alist=nil 
(R): ess-rterm-versions-create making M-x defuns for c:/progra~1/Rrw1091/bin/Rterm.exe c:/progra~1/Rrw2000/bin/Rterm.exe
(R): ess-dialect=nil, buf=*scratch*, start-arg=nil
 current-prefix-arg=nil
(inferior-ess 0): ess-start-args=--ess   
ess-setq-vars-default 0: ess-language=Initial, -dialect=nil, buf=nil, comint..echoes=nil, comint..sender=comint-simple-send
ess-setq-vars-default 1: ess-language=S, -dialect=R, buf=nil, comint..echoes=nil, comint..sender=comint-simple-send
(inf-ess 1): lang=S, dialect=R, tmp-dialect=R, buf=*scratch*
(inf-ess 1.1): procname=R temp-dialect=R, buf-name=*R* 
(inferior-ess) Method #3 start=c:/Documents and Settings/FAT/My Documents/fat/MyRwork/ buf=*R*
(ess-setq-vars-LOCAL): language=S, dialect=R, buf=nil, comint..echoes=nil, comint..sender=comint-simple-send
(inf-ess 2.1): ess-language=S, ess-dialect=R buf=*R* 
(inf-ess 2.2): start args = --ess  , inf-ess-start-args=--ess   
(inf-ess finish [S(R), c:/Programmer/R/R-2.2.1/bin/Rterm.exe(nil,nil)]
(ess-multi 0):  inf-ess-start-args=--ess  , comint-..echoes=nil
(i-ess 1): buf=*R*, lang=S, comint..echo=nil, comint..sender=comint-simple-send,
(i-ess 2): buf=*R*, lang=S, comint..echo=t, comint..sender=inferior-R-input-sender,
(ess-setq-vars-LOCAL): language=S, dialect=R, buf=nil, comint..echoes=t, comint..sender=inferior-R-input-sender
(i-ess 3): curr-buf=*R*, comint..echo=t, comint..sender=inferior-R-input-sender,
(ess-multi post inf-ess: start-args=--ess  , comint-echoes=t
(ess-multi 1):  start-args=--ess   
Making Process...Buf *R*, Proc R, Prog c:/Programmer/R/R-2.2.1/bin/Rterm.exe
 Start File=nil, Args= --ess  .
(R): inferior-ess-language-start=options(STERM='iESS', editor='gnuclient.exe')
(ess-setq-vars-LOCAL): language=S, dialect=R, buf=nil, comint..echoes=nil, comint..sender=comint-simple-send


###########

For Emacs 22.0:

GNU Emacs 22.0.50.1 (i386-mingw-nt5.1.2600) of 2005-12-31 on W2ONE

with *ESS* buffer:


[ess-site.el]: ess-customize-alist=nil 
[ess-site.el _2_]: ess-customize-alist=nil 
(R): ess-rterm-versions-create making M-x defuns for c:/progra~1/Rrw1091/bin/Rterm.exe c:/progra~1/Rrw2000/bin/Rterm.exe(ess-setq-vars-LOCAL): language=S, dialect=R, buf=nil, comint..echoes=nil, comint..sender=comint-simple-send
(ess-mode-1): ess-language=S, ess-dialect=R buf=bagben.R 
(ess-mode-1.5): alist=((ess-local-customize-alist quote R-customize-alist) (ess-dialect . R) (ess-suffix . R) (ess-dump-filename-template ess-replace-regexp-in-string S$ ess-suffix ess-dump-filename-template-proto) (ess-mode-syntax-table . R-syntax-table) (ess-mode-editing-alist . R-editing-alist) (ess-change-sp-regexp . ess-R-change-sp-regexp) (ess-help-sec-regex . ess-help-R-sec-regex) (ess-help-sec-keys-alist . ess-help-R-sec-keys-alist) (ess-loop-timeout . ess-S-loop-timeout) (ess-cmd-delay . ess-R-cmd-delay) (ess-function-pattern . ess-R-function-pattern) (ess-object-name-db-file . ess-r-namedb.el) (ess-retr-lastvalue-command . assign(".Last.value", .ess.lvsave, envir=baseenv())
) (ess-save-lastvalue-command . assign(".ess.lvsave", get(".Last.value", envir=baseenv()))
) (ess-imenu-mode-function quote ess-imenu-R) (inferior-ess-program . inferior-R-program-name) (inferior-ess-objects-command . inferior-R-objects-command) (inferior-ess-font-lock-keywords . inferior-ess-R-font-lock-keywords) (inferior-ess-search-list-command . search()
) (inferior-ess-help-command . help("%s", htmlhelp=FALSE)
) (inferior-ess-exit-command . q()) (inferior-ess-exit-prompt . Save workspace image? [y/n/c]: ) (inferior-ess-primary-prompt . \([A-Z][][A-Za-z0-9.]*\)*> ) (inferior-ess-secondary-prompt . + ?) (inferior-ess-start-file) (inferior-ess-start-args . ) (ess-STERM . iESS) (ess-editor . R-editor) (ess-pager . R-pager) (ess-language . S) (inferior-ess-exit-command . q()
) (inferior-ess-language-start eval inferior-S-language-start) (comint-use-prompt-regexp-instead-of-fields . t)) 
(ess-mode-1.6): editing-alist=((paragraph-start concat \s-*$\| page-delimiter) (paragraph-separate concat \s-*$\| page-delimiter) (paragraph-ignore-fill-prefix . t) (require-final-newline . t) (comment-start . #) (comment-add . 1) (comment-start-skip . #+ *) (comment-column . 40) (indent-line-function quote S-indent-line) (parse-sexp-ignore-comments . t) (ess-set-style . ess-default-style) (ess-local-process-name) (ess-mode-syntax-table . S-syntax-table) (add-log-current-defun-header-regexp . ^\(.+\)\s-+<-[ 	
]*function) (font-lock-defaults quote (ess-R-mode-font-lock-keywords nil nil ((46 . w) (95 . w))))) 
(ess-setq-vars-LOCAL): language=S, dialect=R, buf=nil, comint..echoes=nil, comint..sender=comint-simple-send

Finished setting up ESS-mode.

(R): ess-dialect=R, buf=bagben.R, start-arg=nil
 current-prefix-arg=nil
(inferior-ess 0): ess-start-args=--ess   
ess-setq-vars-default 0: ess-language=Initial, -dialect=nil, buf=nil, comint..echoes=nil, comint..sender=comint-simple-send
ess-setq-vars-default 1: ess-language=S, -dialect=R, buf=nil, comint..echoes=nil, comint..sender=comint-simple-send
(inf-ess 1): lang=S, dialect=R, tmp-dialect=R, buf=bagben.R
(inf-ess 1.1): procname=R temp-dialect=R, buf-name=*R* 
(inferior-ess) Method #3 start=c:/Documents and Settings/FAT/My Documents/Projekter/Gulvprojekt/FDA/Bagben/ buf=*R*
(ess-setq-vars-LOCAL): language=S, dialect=R, buf=nil, comint..echoes=nil, comint..sender=comint-simple-send
(inf-ess 2.1): ess-language=S, ess-dialect=R buf=*R* 
(inf-ess 2.2): start args = --ess  , inf-ess-start-args=--ess   
(inf-ess finish [S(R), c:/Programmer/R/R-2.2.1/bin/Rterm.exe(nil,nil)]
(ess-multi 0):  inf-ess-start-args=--ess  , comint-..echoes=nil
(i-ess 1): buf=*R*, lang=S, comint..echo=nil, comint..sender=comint-simple-send,
(i-ess 2): buf=*R*, lang=S, comint..echo=t, comint..sender=inferior-R-input-sender,
(ess-setq-vars-LOCAL): language=S, dialect=R, buf=nil, comint..echoes=t, comint..sender=inferior-R-input-sender
(i-ess 3): curr-buf=*R*, comint..echo=t, comint..sender=inferior-R-input-sender,
(ess-multi post inf-ess: start-args=--ess  , comint-echoes=t
(ess-multi 1):  start-args=--ess   
Making Process...Buf *R*, Proc R, Prog c:/Programmer/R/R-2.2.1/bin/Rterm.exe
 Start File=nil, Args= --ess  .
(R): inferior-ess-language-start=options(STERM='iESS', editor='gnuclient.exe')
(ess-setq-vars-LOCAL): language=S, dialect=R, buf=nil, comint..echoes=nil, comint..sender=comint-simple-send
(ess-help: error-buffer '*help[R](lm')*' nodocs (1 17)
(ess-setq-vars-LOCAL): language=S, dialect=R, buf=nil, comint..echoes=nil, comint..sender=comint-simple-send
(ess-setq-vars-LOCAL): language=S, dialect=R, buf=nil, comint..echoes=nil, comint..sender=comint-simple-send
(ess-mode-1): ess-language=S, ess-dialect=R buf=functions.R 
(ess-mode-1.5): alist=((ess-local-customize-alist quote R-customize-alist) (ess-dialect . R) (ess-suffix . R) (ess-dump-filename-template ess-replace-regexp-in-string S$ ess-suffix ess-dump-filename-template-proto) (ess-mode-syntax-table . R-syntax-table) (ess-mode-editing-alist . R-editing-alist) (ess-change-sp-regexp . ess-R-change-sp-regexp) (ess-help-sec-regex . ess-help-R-sec-regex) (ess-help-sec-keys-alist . ess-help-R-sec-keys-alist) (ess-loop-timeout . ess-S-loop-timeout) (ess-cmd-delay . ess-R-cmd-delay) (ess-function-pattern . ess-R-function-pattern) (ess-object-name-db-file . ess-r-namedb.el) (ess-retr-lastvalue-command . assign(".Last.value", .ess.lvsave, envir=baseenv())
) (ess-save-lastvalue-command . assign(".ess.lvsave", get(".Last.value", envir=baseenv()))
) (ess-imenu-mode-function quote ess-imenu-R) (inferior-ess-program . inferior-R-program-name) (inferior-ess-objects-command . inferior-R-objects-command) (inferior-ess-font-lock-keywords . inferior-ess-R-font-lock-keywords) (inferior-ess-search-list-command . search()
) (inferior-ess-help-command . help("%s", htmlhelp=FALSE)
) (inferior-ess-exit-command . q()) (inferior-ess-exit-prompt . Save workspace image? [y/n/c]: ) (inferior-ess-primary-prompt . \([A-Z][][A-Za-z0-9.]*\)*> ) (inferior-ess-secondary-prompt . + ?) (inferior-ess-start-file) (inferior-ess-start-args . ) (ess-STERM . iESS) (ess-editor . R-editor) (ess-pager . R-pager) (ess-language . S) (inferior-ess-exit-command . q()
) (inferior-ess-language-start eval inferior-S-language-start) (comint-use-prompt-regexp-instead-of-fields . t)) 
(ess-mode-1.6): editing-alist=((paragraph-start concat \s-*$\| page-delimiter) (paragraph-separate concat \s-*$\| page-delimiter) (paragraph-ignore-fill-prefix . t) (require-final-newline . t) (comment-start . #) (comment-add . 1) (comment-start-skip . #+ *) (comment-column . 40) (indent-line-function quote S-indent-line) (parse-sexp-ignore-comments . t) (ess-set-style . ess-default-style) (ess-local-process-name) (ess-mode-syntax-table . S-syntax-table) (add-log-current-defun-header-regexp . ^\(.+\)\s-+<-[ 	
]*function) (font-lock-defaults quote (ess-R-mode-font-lock-keywords nil nil ((46 . w) (95 . w))))) 
(ess-setq-vars-LOCAL): language=S, dialect=R, buf=nil, comint..echoes=nil, comint..sender=comint-simple-send

Finished setting up ESS-mode.
(ess-setq-vars-LOCAL): language=S, dialect=R, buf=nil, comint..echoes=nil, comint..sender=comint-simple-send
ess-BEG-of-fun after 'search-FWD (': Ini-pt 14654, (p)-Ini-pt = 0
ELSE  not in setMethod() header ...
	Match,Pt:(14201,14225),14201
ess-END-of-fun: S4=nil, beginning = 14201
ess-BEG-of-fun after 'search-FWD (': Ini-pt 14511, (p)-Ini-pt = 22
ELSE  not in setMethod() header ...
	Match,Pt:(14201,14225),14201
ess-END-of-fun: S4=nil, beginning = 14201
ess-BEG-of-fun after 'search-FWD (': Ini-pt 14867, (p)-Ini-pt = 41
ELSE  not in setMethod() header ...
	Match,Pt:(14201,14225),14201
ess-END-of-fun: S4=nil, beginning = 14201
ess-BEG-of-fun after 'search-FWD (': Ini-pt 14905, (p)-Ini-pt = 18
ELSE  not in setMethod() header ...
	Match,Pt:(14201,14225),14201
ess-END-of-fun: S4=nil, beginning = 14201
ess-BEG-of-fun after 'search-FWD (': Ini-pt 14876, (p)-Ini-pt = 29
ELSE  not in setMethod() header ...
	Match,Pt:(14201,14225),14201
ess-END-of-fun: S4=nil, beginning = 14201
ess-BEG-of-fun after 'search-FWD (': Ini-pt 15003, (p)-Ini-pt = 31
ELSE  not in setMethod() header ...
	Match,Pt:(14201,14225),14201
ess-END-of-fun: S4=nil, beginning = 14201
ess-BEG-of-fun after 'search-FWD (': Ini-pt 15025, (p)-Ini-pt = 30
ELSE  not in setMethod() header ...
	Match,Pt:(14201,14225),14201
ess-END-of-fun: S4=nil, beginning = 14201
ess-BEG-of-fun after 'search-FWD (': Ini-pt 14883, (p)-Ini-pt = 0
ELSE  not in setMethod() header ...
	Match,Pt:(14201,14225),14201
ess-END-of-fun: S4=nil, beginning = 14201
ess-BEG-of-fun after 'search-FWD (': Ini-pt 14982, (p)-Ini-pt = 19
ELSE  not in setMethod() header ...
	Match,Pt:(14201,14225),14201
ess-END-of-fun: S4=nil, beginning = 14201
(ess-setq-vars-LOCAL): language=S, dialect=R, buf=nil, comint..echoes=nil, comint..sender=comint-simple-send
(ess-setq-vars-LOCAL): language=S, dialect=R, buf=nil, comint..echoes=nil, comint..sender=comint-simple-send
(ess-help-bogus-buffer-p *help[R](options)*) |--> nil [searching t]
ess-BEG-of-fun after 'search-FWD (': Ini-pt 15188, (p)-Ini-pt = 0
ELSE  not in setMethod() header ...
	Match,Pt:(14201,14225),14201
ess-END-of-fun: S4=nil, beginning = 14201
ess-BEG-of-fun after 'search-FWD (': Ini-pt 15217, (p)-Ini-pt = 0
ELSE  not in setMethod() header ...
	Match,Pt:(14201,14225),14201
ess-END-of-fun: S4=nil, beginning = 14201
ess-BEG-of-fun after 'search-FWD (': Ini-pt 14755, (p)-Ini-pt = 0
ELSE  not in setMethod() header ...
	Match,Pt:(14201,14225),14201
ess-END-of-fun: S4=nil, beginning = 14201
ess-BEG-of-fun after 'search-FWD (': Ini-pt 14756, (p)-Ini-pt = 0
ELSE  not in setMethod() header ...
	Match,Pt:(14201,14225),14201
ess-END-of-fun: S4=nil, beginning = 14201
ess-BEG-of-fun after 'search-FWD (': Ini-pt 14735, (p)-Ini-pt = 18
ELSE  not in setMethod() header ...
	Match,Pt:(14201,14225),14201
ess-END-of-fun: S4=nil, beginning = 14201
ess-BEG-of-fun after 'search-FWD (': Ini-pt 15067, (p)-Ini-pt = 12
ELSE  not in setMethod() header ...
	Match,Pt:(14201,14225),14201
ess-END-of-fun: S4=nil, beginning = 14201
(ess-setq-vars-LOCAL): language=S, dialect=R, buf=nil, comint..echoes=nil, comint..sender=comint-simple-send
(ess-help-bogus-buffer-p *help[R](lm)*) |--> nil [searching t]


 

> -----Oprindelig meddelelse-----
> Fra: ess-help-bounces at stat.math.ethz.ch 
> [mailto:ess-help-bounces at stat.math.ethz.ch] På vegne af 
> Martin Maechler
> Sendt: 20. marts 2006 10:24
> Til: Andreas Kiermeier
> Cc: ess-help at stat.math.ethz.ch
> Emne: Re: [ESS] Hyperlinks in help pages
> 
> >>>>> "Andreas" == Andreas Kiermeier 
> <Kiermeier.Andreas at saugov.sa.gov.au>
> >>>>>     on Mon, 20 Mar 2006 08:51:05 +1030 writes:
> 
>     Andreas> Martin, exactly the functionality I'm looking for,
>     Andreas> but it doesn't work for me.  Pressing 'h' in a help
>     Andreas> buffer does not load any default help topic,
>     Andreas> ie. the help topic is always blank.
> 
>     Andreas> I'm running:
> 
>     Andreas> GNU Emacs 22.0.50.1 (i386-mingw-nt5.1.2600) of
>     Andreas> 2005-06-27 on NONIQPC ESS: 5.2.10 O/S: Win XP
> 
>     Andreas> What can I do to help figure this out?
> 
> Can we first be sure about what happens when: 
> Here are detailed instructions (please, other "listeners" try 
> them too!):
> 
> 1) After starting R (M-x R),
> 2) inside *R* buffer type
>       C-c C-v lm <Enter>
> 		  you should now be inside a newly created buffer
> 		  "*help[R](lm)*
> 3) Type
> 	ss    
> 	        = [S]kip to the "[S]ee also" section in the help buffer
> 	C-n C-n      
> 		(advance two lines: "the cursor" (the "point" 
> in Emacs-lingo)
> 		 should now be somewhere on the word 'summary.lm')
> 4) Type
> 	h 
> 		(in the minibuffer, you should be prompted with
> 		"Help on: (default summary.lm) "
> 	<Enter>
> 		-> the help page for summary.lm opens in yet
> 		   another new buffer.
> 
> 
> - Can you tell exactly where the above differs for you?
> 
> - Could you also try with a non-alpha version of Emacs, i.e.  
>   Emacs 21.3 or 21.4 ?
> 
> 
> Regards,
> Martin
> 
> ______________________________________________
> ESS-help at stat.math.ethz.ch mailing list
> https://stat.ethz.ch/mailman/listinfo/ess-help
> 
>




More information about the ESS-help mailing list