[ESS] How does the ess-function-outline-file work?

[Martin Maechler]

>>>>> "Henrik" == Henrik Andersson <h.andersson at nioo.knaw.nl>
>>>>>     on Fri, 08 Jul 2005 10:05:16 +0200 writes:

    Henrik> I updated to the latest ESS via svn five minutes ago
    Henrik> When I open an file in ESS[S] mode, and type "C-c f"
    Henrik> nothing happens...

    Henrik> C-h f ess-f TAB reveals:
	    ----
    Henrik> ess-find-dump-file-other-window ess-find-exec
    Henrik> ess-find-exec-completions ess-find-help-file
    Henrik> ess-find-rterm ess-fix-EQ-assign ess-fix-comments
    Henrik> ess-fix-dot ess-fix-dot-1 ess-fix-dot-more
    Henrik> ess-fix-miscellaneous ess-flatten-list
    Henrik> ess-flatten-list-1 ess-force-buffer-current

    Henrik> No ess-function-outline as far as I can see.


    Henrik> Strange...

No, not really strange.  

1) The function is called ess-insert-function-outline;
   [ Patrick had been asking about the corresponding *variable* 
     with name ess-function-outline ]

2) "C-c f" is not activated by default since a good Emacs
   package is not allowed to set any "C-c <character>" key
   settings  {they are reserved for user-private settings}.
   But I concluded from Patrick's e-mail that he had found the
   hacky function  (ess-add-MM-keys)   -- guess who MM is --
   and that he does {in his ~/.emacs equivalent}
   something similar to what we do here, namely
      (add-hook 'ess-mode-hook 'ess-add-MM-keys)

   For a while now, this is only equivalent to 
      (add-hook 'ess-mode-hook 
                '(lambda () 
	          (define-key ess-mode-map "\C-cf" 
		                           'ess-insert-function-outline)))

Alternatively (to "C-c f"), you bind  ess-insert-function-outline
to one of your favorite functions keys or so.

Martin Maechler <maechler at stat.math.ethz.ch>	http://stat.ethz.ch/~maechler/
Seminar fuer Statistik, ETH-Zentrum  LEO C16	Leonhardstr. 27
ETH (Federal Inst. Technology)	8092 Zurich	SWITZERLAND
phone: +41-44-632-3408		fax: ...-1228			<><