--- rest25/library/webbrowser.rst	2008-12-19 16:58:08.000000000 +0900
+++ rest262/library/webbrowser.rst	2009-04-07 00:06:53.000000000 +0900
@@ -40,28 +40,33 @@
 
 
 .. exception:: Error
 
    Exception raised when a browser control error occurs.
 
 The following functions are defined:
 
 
 .. function:: open(url[, new=0[, autoraise=1]])
 
    Display *url* using the default browser. If *new* is 0, the *url* is opened in
-   the same browser window.  If *new* is 1, a new browser window is opened if
-   possible.  If *new* is 2, a new browser page ("tab") is opened if possible.  If
-   *autoraise* is true, the window is raised if possible (note that under many
-   window managers this will occur regardless of the setting of this variable).
+   the same browser window if possible.  If *new* is 1, a new browser window is
+   opened if possible.  If *new* is 2, a new browser page ("tab") is opened if
+   possible.  If *autoraise* is true, the window is raised if possible (note that
+   under many window managers this will occur regardless of the setting of this
+   variable).
+
+   Note that on some platforms, trying to open a filename using this function,
+   may work and start the operating system's associated program.  However, this
+   is neither supported nor portable.
 
    .. versionchanged:: 2.5
       *new* can now be 2.
 
 
 .. function:: open_new(url)
 
    Open *url* in a new window of the default browser, if possible, otherwise, open
    *url* in the only browser window.
 
 
 .. function:: open_new_tab(url)
@@ -141,60 +146,58 @@
 
 (1)
    "Konqueror" is the file manager for the KDE desktop environment for Unix, and
    only makes sense to use if KDE is running.  Some way of reliably detecting KDE
    would be nice; the :envvar:`KDEDIR` variable is not sufficient.  Note also that
    the name "kfm" is used even when using the :program:`konqueror` command with KDE
    2 --- the implementation selects the best strategy for running Konqueror.
 
 (2)
    Only on Windows platforms.
 
 (3)
-   Only on MacOS platforms; requires the standard MacPython :mod:`ic` module,
-   described in the Macintosh Library Modules (XXX reference: ../mac/module-
-   ic.html) manual.
+   Only on Mac OS platforms; requires the standard MacPython :mod:`ic` module.
 
 (4)
-   Only on MacOS X platform.
+   Only on Mac OS X platform.
 
 Here are some simple examples::
 
    url = 'http://www.python.org'
 
-   # Open URL in a new tab, if a browser window is already open. 
+   # Open URL in a new tab, if a browser window is already open.
    webbrowser.open_new_tab(url + '/doc')
 
    # Open URL in new window, raising the window if possible.
    webbrowser.open_new(url)
 
 
 .. _browser-controllers:
 
 Browser Controller Objects
 --------------------------
 
-Browser controllers provide two methods which parallel two of the module-level
+Browser controllers provide these methods which parallel two of the module-level
 convenience functions:
 
 
-.. function:: open(url[, new[, autoraise=1]])
+.. method:: controller.open(url[, new[, autoraise=1]])
 
    Display *url* using the browser handled by this controller. If *new* is 1, a new
    browser window is opened if possible. If *new* is 2, a new browser page ("tab")
    is opened if possible.
 
 
-.. function:: open_new(url)
+.. method:: controller.open_new(url)
 
    Open *url* in a new window of the browser handled by this controller, if
    possible, otherwise, open *url* in the only browser window.  Alias
    :func:`open_new`.
 
 
-.. function:: open_new_tab(url)
+.. method:: controller.open_new_tab(url)
 
    Open *url* in a new page ("tab") of the browser handled by this controller, if
    possible, otherwise equivalent to :func:`open_new`.
 
    .. versionadded:: 2.5
 
