Commit 605f2e19 authored by Dafydd Harries's avatar Dafydd Harries

improve agent docstrings

darcs-hash:20070204190024-c9803-8a570bbe8c52516e779f3d0d9a232c39e2d6b09e.gz
parent a1dfecc8
...@@ -144,10 +144,11 @@ candidate_pair_priority ( ...@@ -144,10 +144,11 @@ candidate_pair_priority (
/** /**
* nice_agent_new: * nice_agent_new:
*
* @factory: a NiceUDPSocketFactory used for allocating sockets * @factory: a NiceUDPSocketFactory used for allocating sockets
* *
* Create a new NiceAgent. * Create a new NiceAgent.
*
* Returns: the new agent
**/ **/
NiceAgent * NiceAgent *
nice_agent_new (NiceUDPSocketFactory *factory) nice_agent_new (NiceUDPSocketFactory *factory)
...@@ -229,11 +230,13 @@ nice_agent_add_local_host_candidate ( ...@@ -229,11 +230,13 @@ nice_agent_add_local_host_candidate (
/** /**
* nice_agent_add_stream: * nice_agent_add_stream:
*
* @agent: a NiceAgent * @agent: a NiceAgent
* @handle_recv: A function called when the stream recieves data * @handle_recv: a function called when the stream recieves data
* @handle_recv_data: data passed as last parameter to @handle_recv
* *
* Add a data stream to @agent. * Add a data stream to @agent.
*
* Returns: the ID of the new stream
**/ **/
guint guint
nice_agent_add_stream ( nice_agent_add_stream (
...@@ -269,9 +272,8 @@ nice_agent_add_stream ( ...@@ -269,9 +272,8 @@ nice_agent_add_stream (
/** /**
* nice_agent_add_local_address: * nice_agent_add_local_address:
*
* @agent: A NiceAgent * @agent: A NiceAgent
* @addr: The address of a local IP interface * @addr: the address of a local IP interface
* *
* Inform the agent of the presence of an address that a local network * Inform the agent of the presence of an address that a local network
* interface is bound to. * interface is bound to.
...@@ -290,14 +292,14 @@ nice_agent_add_local_address (NiceAgent *agent, NiceAddress *addr) ...@@ -290,14 +292,14 @@ nice_agent_add_local_address (NiceAgent *agent, NiceAddress *addr)
/** /**
* nice_agent_add_remote_candidate * nice_agent_add_remote_candidate
* @agent: The agent * @agent: a NiceAgent
* @stream_id: The ID of the stream the candidate is for * @stream_id: the ID of the stream the candidate is for
* @candidate_id: The ID of the candidate the candidate is for * @component_id: the ID of the component the candidate is for
* @type: The type of the new candidate * @type: the type of the new candidate
* @addr: The new candidate's IP address * @addr: the new candidate's IP address
* @port: The new candidate's port * @port: the new candidate's port
* @username: The new candidate's username * @username: the new candidate's username
* @password: The new candidate's password * @password: the new candidate's password
* *
* Add a candidate our peer has informed us about to the agent's list. * Add a candidate our peer has informed us about to the agent's list.
**/ **/
...@@ -612,15 +614,15 @@ nice_agent_recv ( ...@@ -612,15 +614,15 @@ nice_agent_recv (
/** /**
* nice_agent_poll_read: * nice_agent_poll_read:
* @agent: A NiceAgent
* @other_fds: A GSList of other file descriptors to poll
* *
* Polls the agent's sockets until at least one of them is readable, and * Polls the agent's sockets until at least one of them is readable, and
* additionally if @other_fds is not NULL, polls those for readability too. * additionally if @other_fds is not NULL, polls those for readability too.
* @other_fds should contain the file descriptors directly, i.e. using * @other_fds should contain the file descriptors directly, i.e. using
* GUINT_TO_POINTER. * GUINT_TO_POINTER.
* *
* @agent: A NiceAgent * Returns: A list of file descriptors from @other_fds that are readable
* @other_fds: A GSList of other file descriptors to poll
* Return value: A list of file descriptors from @other_fds that are readable
**/ **/
GSList * GSList *
nice_agent_poll_read (NiceAgent *agent, GSList *other_fds) nice_agent_poll_read (NiceAgent *agent, GSList *other_fds)
...@@ -692,11 +694,12 @@ nice_agent_set_stun_server (NiceAddress *addr, guint16 port) ...@@ -692,11 +694,12 @@ nice_agent_set_stun_server (NiceAddress *addr, guint16 port)
/** /**
* nice_agent_get_local_candidates: * nice_agent_get_local_candidates:
*
* @agent: A NiceAgent * @agent: A NiceAgent
* Return value: a GSList of local candidates belonging to @agent
* *
* The caller does not own the GSList or the candidates contained within it. * The caller does not own the returned GSList or the candidates contained
* within it.
*
* Returns: a GSList of local candidates belonging to @agent
**/ **/
const GSList * const GSList *
nice_agent_get_local_candidates ( nice_agent_get_local_candidates (
...@@ -705,6 +708,12 @@ nice_agent_get_local_candidates ( ...@@ -705,6 +708,12 @@ nice_agent_get_local_candidates (
return agent->local_candidates; return agent->local_candidates;
} }
/**
* nice_agent_free:
* @agent: a NiceAgent
*
* Free the agent.
**/
void void
nice_agent_free (NiceAgent *agent) nice_agent_free (NiceAgent *agent)
{ {
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment