docs/: Small docs updates.

Original commit message from CVS:
* docs/design/part-events.txt:
* docs/design/part-gstpipeline.txt:
* docs/design/part-messages.txt:
* docs/design/part-overview.txt:
* docs/design/part-seeking.txt:
* docs/design/part-states.txt:
* docs/design/part-trickmodes.txt:
* docs/manual/advanced-position.xml:
Small docs updates.

* gst/gstobject.h:
People think !! is ugly, this looks better.

* gst/gstpad.c: (gst_pad_set_blocked_async):
Remove !! since it's fixed elsewhere now.

1 files changed, 5 insertions, 3 deletions

diff --git a/docs/design/part-overview.txt b/docs/design/part-overview.txt
index bf82dfd051..593ab5a14f 100644
--- a/docs/design/part-overview.txt
+++ b/docs/design/part-overview.txt
@@ -397,7 +397,8 @@ Pipeline EOS
  to the application. 
 
  When in EOS, the pipeline remains in the playing state, if is the application
- responsability to PAUSE or READY the pipeline. 
+ responsability to PAUSE or READY the pipeline. The application can also issue
+ a seek, for example.
 
 
 Pipeline READY
@@ -487,12 +488,13 @@ Pipeline seeking
  to produce new data.
 
  Since the pipeline is still PAUSED, this will preroll the next media sample in the
- sinks. 
+ sinks. The application can wait for this preroll to complete by performing a 
+ _get_state() on the pipeline.
 
  The last step in the seek operation is then to adjust the stream time of the pipeline
  to 0 and to set the pipeline back to PLAYING.
 
- The sequence of events in out mp3 playback example.
+ The sequence of events in our mp3 playback example.
 
                                       | a) seek on pipeline
                                       | b) PAUSE pipeline