From 178f9068c445aa4648c682658edb13b2bc48880d Mon Sep 17 00:00:00 2001
From: Neal Norwitz <nnorwitz@gmail.com>
Date: Tue, 4 Oct 2005 03:31:01 +0000
Subject: [PATCH] open_new_win does not exist.  use UNIX consistently, add
 autoraise parameter to open().  add versionadded tags to open_new_tab

---
 Doc/lib/libwebbrowser.tex | 25 +++++++++++++------------
 1 file changed, 13 insertions(+), 12 deletions(-)

diff --git a/Doc/lib/libwebbrowser.tex b/Doc/lib/libwebbrowser.tex
index 42c76912b03..06c0b8e85b4 100644
--- a/Doc/lib/libwebbrowser.tex
+++ b/Doc/lib/libwebbrowser.tex
@@ -11,7 +11,7 @@ allow displaying Web-based documents to users. Under most
 circumstances, simply calling the \function{open()} function from this
 module will do the right thing.
 
-Under \UNIX, graphical browsers are preferred under X11, but text-mode
+Under \UNIX{}, graphical browsers are preferred under X11, but text-mode
 browsers will be used if graphical browsers are not available or an X11
 display isn't available.  If text-mode browsers are used, the calling
 process will block until the user exits the browser.
@@ -26,9 +26,9 @@ substituted for the \code{\%s}; if the part does not contain
 launch.
 
 For non-\UNIX{} platforms, or when a remote browser is available on
-\UNIX, the controlling process will not wait for the user to finish
+\UNIX{}, the controlling process will not wait for the user to finish
 with the browser, but allow the remote browser to maintain its own
-windows on the display.  If remote browsers are not available on \UNIX,
+windows on the display.  If remote browsers are not available on \UNIX{},
 the controlling process will launch a new browser and wait.
 
 The script \program{webbrowser} can be used as a command-line interface
@@ -45,7 +45,7 @@ The following exception is defined:
 
 The following functions are defined:
 
-\begin{funcdesc}{open}{url\optional{, new=0}\optional{, autoraise=1}}
+\begin{funcdesc}{open}{url\optional{, new=0\optional{, autoraise=1}}}
   Display \var{url} using the default browser. If \var{new} is 0, the
   \var{url} is opened in the same browser window.  If \var{new} is 1,
   a new browser window is opened if possible.  If \var{new} is 2,
@@ -55,15 +55,15 @@ The following functions are defined:
 
 \end{funcdesc}
 
-\begin{funcdesc}{open_new_win}{url}
+\begin{funcdesc}{open_new}{url}
   Open \var{url} in a new window of the default browser, if possible,
-  otherwise, open \var{url} in the only browser window.  Alias
-  \function{open_new}.
+  otherwise, open \var{url} in the only browser window.
 \end{funcdesc}
 
 \begin{funcdesc}{open_new_tab}{url}
   Open \var{url} in a new page ("tab") of the default browser, if possible,
-  otherwise equivalent to \function{open_new_win}.
+  otherwise equivalent to \function{open_new}.
+\versionadded{2.5}
 \end{funcdesc}
 
 \begin{funcdesc}{get}{\optional{name}}
@@ -117,7 +117,7 @@ Notes:
 \begin{description}
 \item[(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
+\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
@@ -141,13 +141,13 @@ Only on MacOS X platform.
 Browser controllers provide two methods which parallel two of the
 module-level convenience functions:
 
-\begin{funcdesc}{open}{url\optional{, new}}
+\begin{funcdesc}{open}{url\optional{, new\optional{, autoraise=1}}}
   Display \var{url} using the browser handled by this controller.
   If \var{new} is 1, a new browser window is opened if possible.
   If \var{new} is 2, a new browser page ("tab") is opened if possible.
 \end{funcdesc}
 
-\begin{funcdesc}{open_new_win}{url}
+\begin{funcdesc}{open_new}{url}
   Open \var{url} in a new window of the browser handled by this
   controller, if possible, otherwise, open \var{url} in the only
   browser window.  Alias \function{open_new}.
@@ -155,5 +155,6 @@ module-level convenience functions:
 
 \begin{funcdesc}{open_new_tab}{url}
   Open \var{url} in a new page ("tab") of the browser handled by this
-  controller, if possible, otherwise equivalent to \function{open_new_win}.
+  controller, if possible, otherwise equivalent to \function{open_new}.
+\versionadded{2.5}
 \end{funcdesc}