annotate parser-mecmd.h @ 24086:f5b32d12b691

remove gconvert_uri_to_filename() and use url_unescape_string() instead. reasons: * gconvert strdup()s the original string, but it may exit without returning or freeing it. * gconvert returns the original pointer when no % escaping is done. It is then free()ed and used in that state. * gconvert doesn't consider that % may be at the end of the string and could continue parsing past the end. * gconvert would try to free() pointer that iconv() have modified. * gconvert would try to convert filenames from utf-8 to iso8859-1. Seems like no other DnD programs convert to utf-8 and/or honors CHARSET. Not converting seems to work best. Fix it if problem arises.

/// \file
/// \ingroup ConfigParsers MEntry
/// \brief A simple parser with per-entry settings.

/// \defgroup MEntry MEncoder's playlist
///@{

/// Playlist entry
typedef struct m_entry_st {
  /// Filename, url or whatever.
  char* name;
  /// NULL terminated list of name,val pairs.
  char** opts;
} m_entry_t;

/// Free a list returned by \ref m_config_parse_me_command_line.
void
m_entry_list_free(m_entry_t* lst);

/// Helper to set all config options from an entry.
int
m_entry_set_options(m_config_t *config, m_entry_t* entry);

/// Setup the \ref Config from command line arguments and build a playlist.
/** \ingroup ConfigParsers
 */
m_entry_t*
m_config_parse_me_command_line(m_config_t *config, int argc, char **argv);

///@}