                                        (fromIntegral $ fromFlags seekFlags)
                                        (fromIntegral seekPos)
 
+-- | Send a seek event to an element. See
+--   'Media.Streaming.GStreamer.Core.Event.eventNewSeek' for the
+--   details of the parameters. The seek event is sent to the element
+--   using 'elementSendEvent'.
 elementSeek :: ElementClass element
-            => element
-            -> Double
-            -> Format
-            -> [SeekFlags]
-            -> SeekType
-            -> Int64
-            -> SeekType
-            -> Int64
-            -> IO Bool
+            => element     -- ^ @element@ - the element to seek on
+            -> Double      -- ^ @rate@ - the new playback rate
+            -> Format      -- ^ @format@ - the format of the seek values
+            -> [SeekFlags] -- ^ @seekFlags@ - the options to use
+            -> SeekType    -- ^ @curType@ - type and flags for the new current position
+            -> Int64       -- ^ @cur@ - the value of the new current position
+            -> SeekType    -- ^ @stopType@ - type and flags for the new stop position
+            -> Int64       -- ^ @stop@ - the value of the new stop position
+            -> IO Bool     -- ^ 'True' if the event was handled
 elementSeek element rate format flags curType cur stopType stop =
     liftM toBool $
         {# call element_seek #} (toElement element)

                                          fromIntegral cur)
                   else return Nothing

elementQueryDuration :: ElementClass element
                     => element
                     -> Format
                     -> IO (Maybe (Format, Word64))
elementQueryDuration element format =
    alloca $ \formatPtr ->
        alloca $ \durationPtr ->

                                          fromIntegral destVal)
                   else return Nothing

-- | Query an element for its stream position.
elementQueryPosition :: ElementClass element
                     => element -- ^ @element@ - the element to query
                     -> Format  -- ^ @format@ - the format requested
                     -> IO (Maybe (Format, Word64)) -- ^ the resulting format and value
elementQueryPosition element format =
    alloca $ \formatPtr ->
        alloca $ \curPtr ->
