summaryrefslogtreecommitdiffstats
path: root/Doc
diff options
context:
space:
mode:
Diffstat (limited to 'Doc')
-rw-r--r--Doc/lib/libwebbrowser.tex39
1 files changed, 22 insertions, 17 deletions
diff --git a/Doc/lib/libwebbrowser.tex b/Doc/lib/libwebbrowser.tex
index 25765e8..58dd604 100644
--- a/Doc/lib/libwebbrowser.tex
+++ b/Doc/lib/libwebbrowser.tex
@@ -8,7 +8,9 @@
The \module{webbrowser} module provides a very high-level interface to
allow displaying Web-based documents to users. The controller objects
-are easy to use and are platform independent.
+are easy to use and are platform-independent. 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
browsers will be used if graphical browsers are not available or an X11
@@ -16,11 +18,11 @@ display isn't available. If text-mode browsers are used, the calling
process will block until the user exits the browser.
Under \UNIX, if the environment variable \envvar{BROWSER} exists, it
-is interpreted to override the platform default browser, as a
+is interpreted to override the platform default list of browsers, as a
colon-separated list of browsers to try in order. When the value of
a list part contains the string \code{\%s}, then it is interpreted as
a literal browser command line to be used with the argument URL
-substituted for the \code{\%s}; if the part does not contain,
+substituted for the \code{\%s}; if the part does not contain
\code{\%s}, it is simply interpreted as the name of the browser to
launch.
@@ -37,9 +39,11 @@ The following exception is defined:
The following functions are defined:
-\begin{funcdesc}{open}{url\optional{, new}}
+\begin{funcdesc}{open}{url\optional{, new=0}\optional{, autoraise=1}}
Display \var{url} using the default browser. If \var{new} is true,
- a new browser window is opened if possible.
+ a new browser window is opened if possible. If \var{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).
\end{funcdesc}
\begin{funcdesc}{open_new}{url}
@@ -67,19 +71,20 @@ The following functions are defined:
argument matching the name of a handler you declare.
\end{funcdesc}
-Several browser types are defined. This table gives the type names
-that may be passed to the \function{get()} function and the names of
-the implementation classes, all defined in this module.
+A number of browser types are predefined. This table gives the type
+names that may be passed to the \function{get()} function and the
+corresponding instantiations for the controller classes, all defined
+in this module.
\begin{tableiii}{l|l|c}{code}{Type Name}{Class Name}{Notes}
- \lineiii{'mozilla'}{\class{Mozilla}}{}
- \lineiii{'netscape'}{\class{Netscape}}{}
- \lineiii{'mosaic'}{\class{Mosaic}}{}
- \lineiii{'kfm'}{\class{Konquerer}}{(1)}
- \lineiii{'grail'}{\class{Grail}}{}
- \lineiii{'links'}{\class{links}}{}
- \lineiii{'lynx'}{\class{Lynx}}{}
- \lineiii{'w3m'}{\class{w3m}}{}
+ \lineiii{'mozilla'}{\class{Netscape('mozilla')}}{}
+ \lineiii{'netscape'}{\class{Netscape('netscape')}}{}
+ \lineiii{'mosaic'}{\class{GenericBrowser('mosaic \%s &')}}{}
+ \lineiii{'kfm'}{\class{Konqueror()}}{(1)}
+ \lineiii{'grail'}{\class{Grail()}}{}
+ \lineiii{'links'}{\class{GenericBrowser('links \%s')}}{}
+ \lineiii{'lynx'}{\class{GenericBrowser('lynx \%s')}}{}
+ \lineiii{'w3m'}{\class{GenericBrowser('w3m \%s')}}{}
\lineiii{'windows-default'}{\class{WindowsDefault}}{(2)}
\lineiii{'internet-config'}{\class{InternetConfig}}{(3)}
\end{tableiii}
@@ -89,7 +94,7 @@ Notes:
\begin{description}
\item[(1)]
-``Konquerer'' is the file manager for the KDE desktop environment for
+``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.