]> git.saurik.com Git - wxWidgets.git/blobdiff - interface/protocol/http.h
Added the function and macro group pages for Doxygen.
[wxWidgets.git] / interface / protocol / http.h
index 00617821115e2b8a99095ad06d436bc059978211..9ea510b233cb83ad0ab94de1f93e7401a00cbece 100644 (file)
@@ -1,6 +1,6 @@
 /////////////////////////////////////////////////////////////////////////////
 // Name:        protocol/http.h
-// Purpose:     documentation for wxHTTP class
+// Purpose:     interface of wxHTTP
 // Author:      wxWidgets team
 // RCS-ID:      $Id$
 // Licence:     wxWindows license
@@ -9,13 +9,12 @@
 /**
     @class wxHTTP
     @headerfile http.h wx/protocol/http.h
-    
-    
+
+
     @library{wxnet}
     @category{net}
-    
-    @seealso
-    wxSocketBase, wxURL
+
+    @see wxSocketBase, wxURL
 */
 class wxHTTP : public wxProtocol
 {
@@ -30,37 +29,37 @@ public:
     /**
         Creates a new input stream on the specified path. Notice that this stream is
         unseekable, i.e. SeekI() and TellI() methods shouldn't be used.
-        
-        Note that you can still know the size of the file you are getting using 
+        Note that you can still know the size of the file you are getting using
         wxStreamBase::GetSize. However there is a
         limitation: in HTTP protocol, the size is not always specified so sometimes
         @c (size_t)-1 can returned ot indicate that the size is unknown. In such
-        case, you may want to use wxInputStream::LastRead 
+        case, you may want to use wxInputStream::LastRead
         method in a loop to get the total size.
         
         @returns Returns the initialized stream. You must delete it yourself once
-                   you don't use it anymore and this must be done before
-                   the wxHTTP object itself is destroyed. The destructor
-                   closes the network connection. The next time you will
-                   try to get a file the network connection will have to
-                   be reestablished, but you don't have to take care of
-                   this since wxHTTP reestablishes it automatically.
+                 you don't use it anymore and this must be done before
+                 the wxHTTP object itself is destroyed. The destructor
+                 closes the network connection. The next time you will
+                 try to get a file the network connection will have to
+                 be reestablished, but you don't have to take care of
+                 this since wxHTTP reestablishes it automatically.
         
-        @sa wxInputStream
+        @see wxInputStream
     */
-    wxInputStream * GetInputStream(const wxString& path);
+    wxInputStream* GetInputStream(const wxString& path);
 
     /**
         Returns the HTTP response code returned by the server. Please refer to
         RFC 2616 for the list of responses.
     */
-    int GetResponse();
+    int GetResponse() const;
 
     /**
         It sets data of a field to be sent during the next request to the HTTP server.
         The field
-        name is specified by @e header and the content by @e h_data.
+        name is specified by @a header and the content by @e h_data.
         This is a low level function and it assumes that you know what you are doing.
     */
     void SetHeader(const wxString& header, const wxString& h_data);
 };
+