doc: Fix some doctsing making GI happy

This commit is contained in:
Thibault Saunier 2017-04-21 10:51:59 -03:00
parent e6db45a8af
commit b15d59b53c

View 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.
*