documentation bug (browse-url)

[Harry Putnam]

This bug report will be sent to the Free Software Foundation,
not to your local site managers!
Please write in English if possible, because the Emacs maintainers
usually do not have translators to read other languages for them.

Your bug report will be posted to the address@hidden mailing list.

Please describe exactly what actions triggered the bug
and the precise symptoms of the bug:

Attempting to learn how to adjust browse-url functions for my needs.
1) M-x customize-apropos <RET>
   browse-url <RET>
   
   Shows me one may use  specialized functions here
   (Choice `C' your own function)
>From here I decided to see if emacs online help had something to
offer.

Using the index search I entered string `browse', which lands me
directly at Node `Following URLS'.  The last section says:

     You can customize Browse-URL's behavior via various options in the
  `browse-url' Customize group, particularly
  `browse-url-browser-function'.  You can invoke actions dependent on the
  type of URL by defining `browse-url-browser-function' as an association
  list.  The package's commentary available via `C-h p' provides more
  information.  Packages with facilities for following URLs should always
  go through Browse-URL, so that the customization options for Browse-URL
  will affect all browsing in Emacs.

Notice the reference to using C-h p to find `the package'.  But no
where on the page is a package named.  Going to C-h p and searching
under `browse' fails to turn up any hits.

It turns out to be package `hypermedia'

Seems `the package' should be named in the refernce shown above.

In GNU Emacs 21.3.50.1 (i686-pc-linux-gnu, X toolkit, Xaw3d scroll bars)
 of 2003-07-29 on reader.local.net1
Important settings:
  value of $LC_ALL: nil
  value of $LC_COLLATE: C
  value of $LC_CTYPE: nil
  value of $LC_MESSAGES: nil
  value of $LC_MONETARY: nil
  value of $LC_NUMERIC: nil
  value of $LC_TIME: nil
  value of $LANG: en_US.UTF-8
  locale-coding-system: utf-8
  default-enable-multibyte-characters: t

Recent input:
<return> <down> <down> <down> <up> <up> <up> <return> 
<return> <return> <return> <return> <return> <return> 
<return> <return> <return> <return> <return> <return> 
<return> <return> <return> <return> <return> <return> 
<return> <return> <return> <return> <return> <return> 
<return> <return> <return> <down> <down> <down> <down> 
<down> <down> <down> <down> <down> <down> <down> <down> 
<down> <down> <up> <return> <return> <return> <return> 
<return> <return> <return> <return> <return> <return> 
<up> <up> <down> <return> <return> <return> <return> 
<return> <return> <return> <return> <return> <return> 
<return> <return> <return> <return> <return> <return> 
<return> <return> <return> <return> <return> <return> 
<return> <return> <return> <return> <return> <return> 
<return> <return> <return> <return> <return> M-x M-x 
<up> <return>

Recent messages:
Reading active file...done
Connecting to news.gmane.org...done
Mark saved where search started
Retrieving newsgroup: nntp+news.gmane.org:gmane.emacs.bugs...
Fetching headers for nntp+news.gmane.org:gmane.emacs.bugs...done
Generating summary...done
Mark set
Fetching articles for nntp+news.gmane.org:gmane.emacs.bugs... [4 times]
End of message [11 times]