summaryrefslogtreecommitdiff
path: root/agent/agent.h
diff options
context:
space:
mode:
authorPhilip Withnall <philip.withnall@collabora.co.uk>2014-09-26 16:11:59 +0100
committerPhilip Withnall <philip.withnall@collabora.co.uk>2014-09-26 16:11:59 +0100
commit7de8206de2b86d4e092f5e05405a907337fbec4d (patch)
treecdc9c5caaa51925ee58ec5d3f2e1ad45473dd25a /agent/agent.h
parent9a267fff39026e479d7075a36b28548a019c5fc0 (diff)
agent: Document interaction between closing and removing streams
GIOStream and nice_agent_remove_stream() interact slightly subtly when closing down the stream. See: https://bugzilla.gnome.org/show_bug.cgi?id=735754
Diffstat (limited to 'agent/agent.h')
-rw-r--r--agent/agent.h5
1 files changed, 4 insertions, 1 deletions
diff --git a/agent/agent.h b/agent/agent.h
index 60b8990..da59b45 100644
--- a/agent/agent.h
+++ b/agent/agent.h
@@ -442,7 +442,10 @@ nice_agent_add_stream (
* @agent: The #NiceAgent Object
* @stream_id: The ID of the stream to remove
*
- * Remove and free a previously created data stream from @agent
+ * Remove and free a previously created data stream from @agent. If any I/O
+ * streams have been created using nice_agent_get_io_stream(), they should be
+ * closed completely using g_io_stream_close() before this is called, or they
+ * will get broken pipe errors.
*
**/
void