Author: mordante
Date: Wed Jun 18 19:49:06 2008
New Revision: 27287

URL: http://svn.gna.org/viewcvs/wesnoth?rev=27287&view=rev
Log:
Update doxygen comment style.

Modified:
    trunk/src/network_worker.cpp
    trunk/src/network_worker.hpp

Modified: trunk/src/network_worker.cpp
URL: 
http://svn.gna.org/viewcvs/wesnoth/trunk/src/network_worker.cpp?rev=27287&r1=27286&r2=27287&view=diff
==============================================================================
--- trunk/src/network_worker.cpp (original)
+++ trunk/src/network_worker.cpp Wed Jun 18 19:49:06 2008
@@ -12,12 +12,14 @@
    See the COPYING file for more details.
 */
 
-//! Network worker handles data transfers in threads
-//! Remember to use mutexs as little as possible
-//! All global vars should be used in mutex
-//! FIXME: @todo: All code which holds a mutex should run O(1) time
-//! for scalability. Implement read/write locks.
-//!  (postponed for 1.5)
+/**
+ * Network worker handles data transfers in threads
+ * Remember to use mutexs as little as possible
+ * All global vars should be used in mutex
+ * FIXME: @todo: All code which holds a mutex should run O(1) time
+ * for scalability. Implement read/write locks.
+ *  (postponed for 1.5)
+ */
 
 #include "global.hpp"
 
@@ -123,14 +125,18 @@
        mutable config config_buf;
        std::string config_error;
        std::ostringstream stream;
-       //! Do we wish to send the data gzipped, if not use binary wml.
-       //! This needs to stay until the last user of binary_wml has
-       //! been removed.
+
+       /**
+        * Do we wish to send the data gzipped, if not use binary wml. This 
needs
+        * to stay until the last user of binary_wml has been removed.
+        */
        bool gzipped;
 
-       //this field is used if we're sending a raw buffer instead of
-       //through a config object. It will contain the entire contents of
-       //the buffer being sent.
+       /**
+        * This field is used if we're sending a raw buffer instead of through a
+        * config object. It will contain the entire contents of the buffer 
being
+        * sent.
+        */
        std::vector<char> raw_buffer;
 };
 
@@ -148,7 +154,7 @@
 
 schema_map schemas; //schemas_mutex
 
-//a queue of sockets that we are waiting to receive on
+/** a queue of sockets that we are waiting to receive on */
 typedef std::vector<TCPsocket> receive_list;
 receive_list pending_receives[NUM_SHARDS];
 
@@ -939,7 +945,7 @@
 namespace
 {
 
-//! Caller has to make sure to own the mutex for this shard
+/** Caller has to make sure to own the mutex for this shard */
 void remove_buffers(TCPsocket sock)
 {
        {

Modified: trunk/src/network_worker.hpp
URL: 
http://svn.gna.org/viewcvs/wesnoth/trunk/src/network_worker.hpp?rev=27287&r1=27286&r2=27287&view=diff
==============================================================================
--- trunk/src/network_worker.hpp (original)
+++ trunk/src/network_worker.hpp Wed Jun 18 19:49:06 2008
@@ -50,7 +50,7 @@
 void set_raw_data_only();
 void set_use_system_sendfile(bool);
 
-//! Function to asynchronously received data to the given socket.
+/** Function to asynchronously received data to the given socket. */
 void receive_data(TCPsocket sock);
 
 TCPsocket get_received_data(TCPsocket sock, config& cfg, bool* gzipped= 0);


_______________________________________________
Wesnoth-commits mailing list
[email protected]
https://mail.gna.org/listinfo/wesnoth-commits

Reply via email to