 --
 -- int xine_open (xine_stream_t *stream, const char *mrl)
 --
--- Returns 1 if OK, 0 on error.
+-- Returns 1 if OK, 0 on error (use 'xine_get_error' for details).
 {#fun unsafe xine_open
  {withStream* `Stream'
  ,withCAString* `MRL'} -> `Int' cint2int#}

-- xine_stream_t *xine_stream_new (xine_t *self,
--     xine_audio_port *ao, xine_video_port_t *vo)
--
-- Returns xine_stream_t* if OK, NULL on error.
{#fun unsafe xine_stream_new
 {withEngine* `Engine'
 ,withAudioPort* `AudioPort'

{#fun unsafe xine_stop {withStream* `Stream'} -> `()'#}

-- | Free all stream-related resources.
-- The stream stays valid for new 'xine_open'.
--
-- Header declaration:
--
