# HG changeset patch
# User Mike Ruprecht <maiku@soc.pidgin.im>
# Date 1237622002 0
# Node ID 4143990b5c0923d0d58cc198576fbe8e684da67d
# Parent  89002b47a0df0732d9fdb1bfa28d671f0d78d154
Add documentation for a few media functions.

diff -r 89002b47a0df -r 4143990b5c09 libpurple/media.h
--- a/libpurple/media.h	Sat Mar 21 07:34:13 2009 +0000
+++ b/libpurple/media.h	Sat Mar 21 07:53:22 2009 +0000
@@ -677,12 +677,36 @@
 void purple_media_set_output_volume(PurpleMedia *media, const gchar *session_id,
 		const gchar *participant, double level);
 
+/**
+ * Sets a video output window for the given session/stream.
+ *
+ * @param media The media instance to set the output window on.
+ * @param session_id The session to set the output window on.
+ * @param participant Optionally, the participant to set the output window on.
+ * @param window_id The window id use for embedding the video in.
+ *
+ * @return An id to reference the output window.
+ */
 gulong purple_media_set_output_window(PurpleMedia *media,
 		const gchar *session_id, const gchar *participant,
 		gulong window_id);
 
+/**
+ * Removes all output windows from a given media session.
+ *
+ * @param media The instance to remove all output windows from.
+ */
 void purple_media_remove_output_windows(PurpleMedia *media);
 
+/**
+ * Gets the tee from a given session/stream.
+ *
+ * @param media The instance to get the tee from.
+ * @param session_id The id of the session to get the tee from.
+ * @param participant Optionally, the participant of the stream to get the tee from.
+ *
+ * @return The GstTee element from the chosen session/stream.
+ */
 GstElement *purple_media_get_tee(PurpleMedia *media,
 		const gchar *session_id, const gchar *participant);