Documented new menu label functions

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

diff --git a/docs/latex/wx/protocol.tex b/docs/latex/wx/protocol.tex
index 7cf0aed0c142cea4cedb9ad06b913922bc6260cb..e1ba47af072f0abd79b4200369cbcda4f00c0cc0 100644 (file)
--- a/docs/latex/wx/protocol.tex
+++ b/docs/latex/wx/protocol.tex
@@ -3,6 +3,16 @@
 \wxheading{Derived from}
 
 \helpref{wxSocketClient}{wxsocketclient}
+\helpref{wxSocketBase}{wxsocketbase}
+\helpref{wxObject}{wxobject}
+
+\wxheading{Include files}
+
+<wx/protocol/protocol.h>
+
+\wxheading{Library}
+
+\helpref{wxNet}{librarieslist}
 
 \wxheading{See also}
 
@@ -12,9 +22,9 @@
 % Members
 % ----------------------------------------------------------------------------
 
-\latexignore{\rtfignore{\membersection{Members}}}
+\latexignore{\rtfignore{\wxheading{Members}}}
 
-\membersection{wxProtocol::Reconnect}\label{wxprotoreconnect}
+\membersection{wxProtocol::Reconnect}\label{wxprotocolreconnect}
 
 \func{bool}{Reconnect}{\void}
 
@@ -22,61 +32,81 @@ Tries to reestablish a previous opened connection (close and renegotiate connect
 
 \wxheading{Return value}
 
-TRUE, if the connection is established, else FALSE.
+true, if the connection is established, else false.
 
 % ----------------------------------------------------------------------------
-
-\membersection{wxProtocol::GetInputStream}\label{wxprotogetinput}
+\membersection{wxProtocol::GetInputStream}\label{wxprotocolgetinput}
 
 \func{wxInputStream *}{GetInputStream}{\param{const wxString\&}{ path}}
 
-Creates a new input stream on the the specified path. You can use all but seek
-functionnality of wxStream. Seek isn't available on all stream. For example,
-http or ftp streams doesn't deal with it.
+Creates a new input stream on the specified path. You can use all but seek
+functionality of wxStream. Seek isn't available on all streams. For example,
+HTTP or FTP streams don't deal with it. Other functions like StreamSize and
+Tell aren't available for the moment for this sort of stream.
+You will be notified when the EOF is reached by an error.
 
 \wxheading{Return value}
 
-Returns the initialized stream. You will have to delete it yourself.
+Returns the initialized stream. You will have to delete it yourself once you
+don't use it anymore. The destructor closes the network connection.
 
-% ----------------------------------------------------------------------------
-
-\membersection{wxProtocol::Abort}\label{wxprotoabort}
+\wxheading{See also}
 
-\func{bool }{Abort}{\void}
+\helpref{wxInputStream}{wxinputstream}
 
-Abort the current stream.
-\it{WARNING: It is advised to destroy the input stream instead of aborting the stream this way.}
+% ----------------------------------------------------------------------------
+\membersection{wxProtocol::Abort}\label{wxprotocolabort}
 
-\wxheading{Return value}
+\func{bool}{Abort}{\void}
 
-Returns TRUE, if successful, else FALSE.
+Abort the current stream.
 
-% ----------------------------------------------------------------------------
+\wxheading{Warning}
 
-\membersection{wxProtocol::GetError}
+It is advised to destroy the input stream instead of aborting the stream this way.
 
-\func{wxProtocolError }{GetError}{\void}
+\wxheading{Return value}
 
-Returns the last occured error.
+Returns true, if successful, else false.
 
 % ----------------------------------------------------------------------------
+\membersection{wxProtocol::GetError}\label{wxprotocolgeterror}
+
+\func{wxProtocolError}{GetError}{\void}
+
+Returns the last occurred error.
+
+\twocolwidtha{7cm}
+\begin{twocollist}\itemsep=0pt
+\twocolitem{{\bf wxPROTO\_NOERR}}{No error.}
+\twocolitem{{\bf wxPROTO\_NETERR}}{A generic network error occurred.}
+\twocolitem{{\bf wxPROTO\_PROTERR}}{An error occurred during negotiation.}
+\twocolitem{{\bf wxPROTO\_CONNERR}}{The client failed to connect the server.}
+\twocolitem{{\bf wxPROTO\_INVVAL}}{Invalid value.}
+\twocolitem{{\bf wxPROTO\_NOHNDLR}}{.}
+\twocolitem{{\bf wxPROTO\_NOFILE}}{The remote file doesn't exist.}
+\twocolitem{{\bf wxPROTO\_ABRT}}{Last action aborted.}
+\twocolitem{{\bf wxPROTO\_RCNCT}}{An error occurred during reconnection.}
+\twocolitem{{\bf wxPROTO\_STREAM}}{Someone tried to send a command during a transfer.}
+\end{twocollist}
 
-\membersection{wxProtocol::GetContentType}
+% ----------------------------------------------------------------------------
+\membersection{wxProtocol::GetContentType}\label{wxprotocolgetcontenttype}
 
-\func{wxString }{GetContentType}{\void}
+\func{wxString}{GetContentType}{\void}
 
 Returns the type of the content of the last opened stream. It is a mime-type.
 
 % ----------------------------------------------------------------------------
-
-\membersection{wxProtocol::SetUser}
+\membersection{wxProtocol::SetUser}\label{wxprotocolsetuser}
 
 \func{void }{SetUser}{\param{const wxString\&}{ user}}
 
 Sets the authentication user. It is mainly useful when FTP is used.
 
-\membersection{wxProtocol::SetPassword}
+\membersection{wxProtocol::SetPassword}\label{wxprotocolsetpassword}
 
-\func{void }{SetPassword}{\param{const wxString\&}{ user}}
+\func{void}{SetPassword}{\param{const wxString\&}{ user}}
 
 Sets the authentication password. It is mainly useful when FTP is used.
+