doc: Fix some doctsing making GI happy
authorThibault Saunier <thibault.saunier@osg.samsung.com>
Fri, 21 Apr 2017 13:51:59 +0000 (10:51 -0300)
committerThibault Saunier <thibault.saunier@osg.samsung.com>
Fri, 21 Apr 2017 13:51:59 +0000 (10:51 -0300)
gst/gstelement.h

index fd6c293..a1c1ad5 100644 (file)
@@ -177,14 +177,11 @@ typedef enum {
 /**
  * GstStateChange:
  * @GST_STATE_CHANGE_NULL_TO_READY    : state change from NULL to READY.
- *
  *   * The element must check if the resources it needs are available. Device
  *     sinks and -sources typically try to probe the device to constrain their
  *     caps.
  *   * The element opens the device (in case feature need to be probed).
- *
  * @GST_STATE_CHANGE_READY_TO_PAUSED  : state change from READY to PAUSED.
- *
  *   * The element pads are activated in order to receive data in PAUSED.
  *     Streaming threads are started.
  *   * Some elements might need to return %GST_STATE_CHANGE_ASYNC and complete
@@ -193,11 +190,8 @@ typedef enum {
  *     when they receive the first buffer or %GST_EVENT_EOS (preroll).
  *     Sinks also block the dataflow when in PAUSED.
  *   * A pipeline resets the running_time to 0.
- *
  *   * Live sources return %GST_STATE_CHANGE_NO_PREROLL and don't generate data.
- *
  * @GST_STATE_CHANGE_PAUSED_TO_PLAYING: state change from PAUSED to PLAYING.
- *
  *   * Most elements ignore this state change.
  *   * The pipeline selects a #GstClock and distributes this to all the children
  *     before setting them to PLAYING. This means that it is only allowed to
@@ -212,14 +206,11 @@ typedef enum {
  *   * While streaming in PAUSED or PLAYING elements can create and remove
  *     sometimes pads.
  *   * Live sources start generating data and return %GST_STATE_CHANGE_SUCCESS.
- *
  * @GST_STATE_CHANGE_PLAYING_TO_PAUSED: state change from PLAYING to PAUSED.
- *
  *   * Most elements ignore this state change.
  *   * The pipeline calculates the running_time based on the last selected
  *     #GstClock and the base_time. It stores this information to continue
  *     playback when going back to the PLAYING state.
- *
  *   * Sinks unblock any #GstClock wait calls.
  *   * When a sink does not have a pending buffer to play, it returns
  *     #GST_STATE_CHANGE_ASYNC from this state change and completes the state
@@ -227,11 +218,8 @@ typedef enum {
  *   * Any queued %GST_MESSAGE_EOS items are removed since they will be reposted
  *     when going back to the PLAYING state. The EOS messages are queued in
  *     #GstBin containers.
- *
  *   * Live sources stop generating data and return %GST_STATE_CHANGE_NO_PREROLL.
- *
  * @GST_STATE_CHANGE_PAUSED_TO_READY  : state change from PAUSED to READY.
- *
  *   * Sinks unblock any waits in the preroll.
  *   * Elements unblock any waits on devices
  *   * Chain or get_range functions return %GST_FLOW_FLUSHING.
@@ -239,9 +227,7 @@ typedef enum {
  *     all streaming threads are stopped.
  *   * The sink forgets all negotiated formats
  *   * Elements remove all sometimes pads
- *
  * @GST_STATE_CHANGE_READY_TO_NULL    : state change from READY to NULL.
- *
  *   * Elements close devices
  *   * Elements reset any internal state.
  *