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