Add more documentation.

[paraslash.git] / net.c

diff --git a/net.c b/net.c
index 0e41be1c3fa804c772f4547a16ac68ec8b42e262..9a93553985516b0db7150d20af99136b33165910 100644 (file)
--- a/net.c
+++ b/net.c
@@ -284,14 +284,16 @@ int get_host_info(char *host, struct hostent **ret)
 }
 
 /**
- * a wrapper around socket(2)
+ * A wrapper around socket(2).
  *
- * Create an IPv4 socket for sequenced, reliable, two-way, connection-based
- * byte streams.
+ * \param domain The communication domain that selects the protocol family.
  *
  * \return The socket fd on success, -E_SOCKET on errors.
  *
- * \sa socket(2)
+ * Create an IPv4 socket for sequenced, reliable, two-way, connection-based
+ * byte streams.
+ *
+ * \sa socket(2).
  */
 int get_stream_socket(int domain)
 {