tests: basesrc: unref gst_bus_timed_pop_filtered return
[platform/upstream/gstreamer.git] / gst / gsttocsetter.c
index 2721b51..c746f23 100644 (file)
  *
  * You should have received a copy of the GNU Library General Public
  * License along with this library; if not, write to the
- * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
- * Boston, MA 02111-1307, USA.
+ * Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
+ * Boston, MA 02110-1301, USA.
  */
 
 /**
  * SECTION:gsttocsetter
+ * @title: GstTocSetter
  * @short_description: Element interface that allows setting and retrieval
  *                     of the TOC
  *
  *
  * Elements that support some kind of chapters or editions (or tracks like in
  * the FLAC cue sheet) will implement this interface.
- * 
+ *
  * If you just want to retrieve the TOC in your application then all you
  * need to do is watch for TOC messages on your pipeline's bus (or you can
  * perform TOC query). This interface is only for setting TOC data, not for
  * extracting it. To set TOC from the application, find proper tocsetter element
  * and set TOC using gst_toc_setter_set_toc().
- * 
+ *
  * Elements implementing the #GstTocSetter interface can extend existing TOC
  * by getting extend UID for that (you can use gst_toc_find_entry() to retrieve it)
  * with any TOC entries received from downstream.
@@ -127,9 +128,8 @@ gst_toc_setter_reset (GstTocSetter * setter)
  * Return current TOC the setter uses. The TOC should not be
  * modified without making it writable first.
  *
- *
- * Returns: (transfer full): TOC set, or NULL. Unref with gst_toc_unref()
- *     when no longer needed
+ * Returns: (transfer full) (nullable): TOC set, or %NULL. Unref with
+ *     gst_toc_unref() when no longer needed
  */
 GstToc *
 gst_toc_setter_get_toc (GstTocSetter * setter)
@@ -155,8 +155,8 @@ gst_toc_setter_get_toc (GstTocSetter * setter)
  * @setter: a #GstTocSetter.
  * @toc: (allow-none): a #GstToc to set.
  *
- * Set the given TOC on the setter. Previously setted TOC will be
- * unrefed before setting a new one.
+ * Set the given TOC on the setter. Previously set TOC will be
+ * unreffed before setting a new one.
  */
 void
 gst_toc_setter_set_toc (GstTocSetter * setter, GstToc * toc)