Re: w3m Info Node Tracing History

[Andreas Röhler <andreas.roehler@xxxxxxxxx>]

Am Dienstag, 19. Juni 2007 12:12 schrieb Katsumi Yamaoka:
> >>>>> In [emacs-w3m : No.09493] Andreas Röhler wrote:
> >
> > Some remarks concerning w3m Info:
> >
> > Node Tracing History says:
> > `s'
> >      "Display the list of visited URLs in this session."
> >
> > Whereas
> > "s runs the command w3m-search
> >   which is an interactive compiled Lisp function in `w3m-search.el'.
> > It is bound to s, <menu-bar> <w3m> <Search the Internet...>.
> > (w3m-search search-engine query)"
>
> We are sorry for inconvenience.  I noticed we had forgotten to
> mention `w3m-lynx-like-map' and `w3m-info-like-map' in the
> English version of the Info just now.  I will add that section
> later.  Though it will not necessarily help people who use the
> `Info-like' map.
>
> > That's probably the result from my emacs-style
> > customization.
>
> I don't know what `emacs-style' is, but it will probably do:
>
> (setq w3m-key-binding 'info)
>
> Also I wonder why `emacs-style', that will probably be used widely,
> alters the default value.
>
> > This occurs at other places too: Info mentions keys
> > whose meaning however depend from lynx-style or
> > emacs-style customization. So they probably are wrong in
> > this or the other case.
> >
> > Maybe some annotation could indicate "lynx-style" or so
> > from time to time.
> >
> > Too I suggest making emacs-style the default.
>
> I don't have an idea of how to mention both key maps in the Info
> in an easy-to-read style.  But typing `C-h m' in the emacs-w3m
> buffer will help for the time being.
>
> Volunteers are welcome.  Anyway.
>
> Regards,


Hi,

meanwhile I took a look into w3m.el...

Let me express my respect first for the prodigious work
you have done with your colleges.

In w3m.el I see the following:

(unless w3m-lynx-like-map...
(define-key map "s" 'w3m-history)

(unless w3m-info-like-map...
(define-key map "s" 'w3m-search)

;;;;;;;

line here was: 6894

AFAIS keys differ rather seldom. Probably the most easy
way would be simply to drop mentioning them in the info
in the cases they differ.

There is a didactic aspect too which I will stress in
this context:

If a novice learns a key, he or her got not so much,
because keys are freely to distribute. If he or her
learns the name of a function, this person got much
more.

So less might be more again.

Here is my diff -c

*** emacs-w3m.texi	2007-06-14 02:37:12.000000000 +0200
--- emacs-w3m.texi	2007-06-19 21:50:31.000000000 +0200
***************
*** 1238,1252 ****
  you can go to any of the pages you visited previously just like if you
  were visiting a regular page, by following the link.
  
! @table @kbd
! @item s
! @kindex s
! @item C-u s
! @kindex C-u s
  @findex w3m-history
! Display the list of URLs visited in this session.  If called with a
! prefix argument, show the list of arrived URLs instead
! (@code{w3m-history}).
  @end table
  
  Also see the @ref{Moving over pages} section, it explains how to move in
--- 1238,1249 ----
  you can go to any of the pages you visited previously just like if you
  were visiting a regular page, by following the link.
  
! @table 
! @item w3m-history
  @findex w3m-history
! 
! Display the list of URLs visited in this session.  
! 
  @end table
  
Also see the @ref{Moving over pages} section, it explains how to move in

;;;;;;;;;;;;;;

Have a nice day!

Andreas Roehler