Relay-Version: version B 2.10 5/3/83; site utzoo.UUCP
Path: utzoo!mnetor!uunet!husc6!bloom-beacon!oberon!cit-vax!ucla-cs!zen!ucbcad!ames!aurora!labrea!rocky!lewis
From: lewis@rocky.STANFORD.EDU (Bil Lewis)
Newsgroups: comp.emacs
Subject: Re: GNU emacs on a 3B2
Message-ID: <677@rocky.STANFORD.EDU>
Date: Fri, 16-Oct-87 04:35:04 EDT
Article-I.D.: rocky.677
Posted: Fri Oct 16 04:35:04 1987
Date-Received: Sat, 17-Oct-87 19:05:43 EDT
References: <806@mrstve.UUCP>
Organization: Stanford University Computer Science Department
Lines: 84
In-reply-to: rjk@mrstve.UUCP's message of 15 Oct 87 01:22:18 GMT

Posting-Front-End: GNU Emacs 18.36.1 of Fri Feb  6 1987 on rocky (berkeley-unix)



As to your first problem, substitute-command-keys.  Are you quite sure?
It is not a normal thing for a user to call.  Check out the examples
below & be certain that they REALLY don't work.


@defun substitute-command-keys string 
  This function returns @var{string} with modifications made to allow
documentation messages to contain information about the current key
bindings.  (The key bindings may change between the time Emacs is
built and the time that the documentation is asked for.)

 Substrings of the form \[@var{COMMAND}] replaced by either:

@itemize

@item
a keystroke sequence that will invoke @var{COMMAND}

@item
@code{M-x @var{COMMAND}} if @var{COMMAND} is not bound to a key sequence.

@end itemize

  Substrings of the form \{@var{MAPVAR}} are replaced by summaries (made by
@code{describe-bindings}) of the value of @var{MAPVAR}, taken as a keymap.

  Substrings of the form \<@var{MAPVAR}> make
@code{substitute-command-keys} use the value of @var{MAPVAR} as the keymap
for future [@var{COMMAND}] substrings. @refill

@example
(substitute-command-keys "
To move forward one character type:
  \\[forward-char]")
=> "
To move forward one character type:
  C-f"

(substitute-command-keys "
To read news, type: \\[rnews]")
=> "
To read news, type: M-x rnews"

(substitute-command-keys "
The keys which are defined for the minibuffer here are:
  \\{minibuffer-local-must-match-map}")
=> "
The keys which are defined for the minibuffer here are:
  
?               minibuffer-completion-help
SPC             minibuffer-complete-word
TAB             minibuffer-complete
LFD             minibuffer-complete-and-exit
RET             minibuffer-complete-and-exit
C-g             abort-recursive-edit
"

"

(substitute-command-keys "
To abort a recursive edit, type:
\\[abort-recursive-edit]")
=> "
To abort a recursive edit, type:
C-]"

(substitute-command-keys "
To abort a recursive edit from the minibuffer, type
    \\<minibuffer-local-must-match-map>
    \\[abort-recursive-edit]")
=> "
To abort a recursive edit from the minibuffer, type
    
    C-g"


@end example
@end defun



-Bil
--