MF_BYCOMMAND is zero so don't try to test it

[wxWidgets.git] / docs / latex / wx / url.tex

diff --git a/docs/latex/wx/url.tex b/docs/latex/wx/url.tex
index 12385071e7cc0d7d59a526dbb152b8ee43a5dba6..7452671911f0abc5e3ff99f64fba986eddb0660a 100644 (file)
--- a/docs/latex/wx/url.tex
+++ b/docs/latex/wx/url.tex
@@ -1,8 +1,17 @@
 \section{\class{wxURL}}\label{wxurl}
 
 \section{\class{wxURL}}\label{wxurl}
 

+Parses URLs.
+
+Supports standard assignment operators, copy constructors,
+and comparison operators.
+

 \wxheading{Derived from}
 
 \wxheading{Derived from}
 

-\helpref{wxObject}{wxobject}
+\helpref{wxURI}{wxuri}
+
+\wxheading{Include files}
+
+<wx/url.h>

 
 \wxheading{See also}
 
 
 \wxheading{See also}
 


@@ -11,37 +20,33 @@
 % ----------------------------------------------------------------------------
 % Members
 % ----------------------------------------------------------------------------
 % ----------------------------------------------------------------------------
 % Members
 % ----------------------------------------------------------------------------

-\latexignore{\rtfignore{\membersection{Members}}}

 
 

-\membersection{wxURL::wxURL}\label{wxurlconstr}
+\latexignore{\rtfignore{\wxheading{Members}}}
+
+\membersection{wxURL::wxURL}\label{wxurlctor}

 
 \func{}{wxURL}{\param{const wxString\&}{ url}}
 
 
 \func{}{wxURL}{\param{const wxString\&}{ url}}
 

-Constructs an URL object from the string.
+Constructs a URL object from the string.  The URL must be valid according
+to RFC 1738.  In particular, file URLs must be of the format
+'file://hostname/path/to/file'.  It is valid to leave out the hostname
+but slashes must remain in place-- i.e. a file URL without a hostname must
+contain three consecutive slashes.

 
 \wxheading{Parameters}
 
 \docparam{url}{Url string to parse.}
 
 
 \wxheading{Parameters}
 
 \docparam{url}{Url string to parse.}
 

-\membersection{wxURL::\destruct{wxURL}}
+\membersection{wxURL::\destruct{wxURL}}\label{wxurldtor}

 
 \func{}{\destruct{wxURL}}{\void}
 
 Destroys the URL object.
 
 
 \func{}{\destruct{wxURL}}{\void}
 
 Destroys the URL object.
 

-%
-% GetProtocolName
-%
-\membersection{wxURL::GetProtocolName}
-
-\constfunc{wxString}{GetProtocolName}{\void}
-
-Returns the name of the protocol which will be used to get the URL.
-

 %
 % GetProtocol
 %
 %
 % GetProtocol
 %

-\membersection{wxURL::GetProtocol}
+\membersection{wxURL::GetProtocol}\label{wxurlgetprotocol}

 
 \func{wxProtocol\&}{GetProtocol}{\void}
 
 
 \func{wxProtocol\&}{GetProtocol}{\void}
 


@@ -50,7 +55,7 @@ Returns a reference to the protocol which will be used to get the URL.
 %
 % GetError
 %
 %
 % GetError
 %

-\membersection{wxURL::GetError}
+\membersection{wxURL::GetError}\label{wxurlgeterror}

 
 \constfunc{wxURLError}{GetError}{\void}
 
 
 \constfunc{wxURLError}{GetError}{\void}
 


@@ -65,28 +70,43 @@ It can be one of these errors:
 \twocolitem{{\bf wxURL\_NOHOST}}{An host name is required for this protocol.}
 \twocolitem{{\bf wxURL\_NOPATH}}{A path is required for this protocol.}
 \twocolitem{{\bf wxURL\_CONNERR}}{Connection error.}
 \twocolitem{{\bf wxURL\_NOHOST}}{An host name is required for this protocol.}
 \twocolitem{{\bf wxURL\_NOPATH}}{A path is required for this protocol.}
 \twocolitem{{\bf wxURL\_CONNERR}}{Connection error.}

-\twocolitem{{\bf wxURL\_PROTOERR}}{An error occured during negotiation.}
+\twocolitem{{\bf wxURL\_PROTOERR}}{An error occurred during negotiation.}

 \end{twocollist}%
 
 %
 % GetInputStream
 %
 \end{twocollist}%
 
 %
 % GetInputStream
 %

-\membersection{wxURL::GetInputStream}
+\membersection{wxURL::GetInputStream}\label{wxurlgetinputstream}

 
 \func{wxInputStream *}{GetInputStream}{\void}
 
 Creates a new input stream on the the specified URL. You can use all but seek
 
 \func{wxInputStream *}{GetInputStream}{\void}
 
 Creates a new input stream on the the specified URL. You can use all but seek

-functionnality of wxStream. Seek isn't available on all stream. For example,
+functionality of wxStream. Seek isn't available on all stream. For example,

 http or ftp streams doesn't deal with it.
 
 http or ftp streams doesn't deal with it.
 

+Note that this method is somewhat depreciated, all future wxWidgets applications
+should really use \helpref{wxFileSystem}{wxfilesystem} instead.
+
+Example:
+
+\begin{verbatim}
+  wxURL url("http://a.host/a.dir/a.file");
+  if (url.GetError() == wxURL_NOERR)
+  {
+      wxInputStream *in_stream;
+
+      in_stream = url.GetInputStream();
+      // Then, you can use all IO calls of in_stream (See wxStream)
+  }
+\end{verbatim}
+

 \wxheading{Return value}
 
 Returns the initialized stream. You will have to delete it yourself.
 
 \wxheading{See also}
 
 \wxheading{Return value}
 
 Returns the initialized stream. You will have to delete it yourself.
 
 \wxheading{See also}
 

-%\helpref{wxInputStream}{wxinputstream}
-wxInputStream
+\helpref{wxInputStream}{wxinputstream}

 
 %
 % SetDefaultProxy
 
 %
 % SetDefaultProxy