- /**
- * Choose a file for opening, starting in directory \param
- * path, with the file selection \param mask. The \param mask
- * string is of the form :
- *
- * <glob to match> | <description>
- *
- * for example, "*.ps | PostScript files (*.ps)".
- *
- * FIXME: should support multiple lines of these for different file types.
- */
- Result const open(string const & path = string(),
- string const & mask = string(),
- string const & suggested = string());
-
- /**
- * Choose a directory, starting in directory \param
- * path.
- */
- Result const opendir(string const & path = string(),
- string const & suggested = string());
+ /// Choose a file for opening, starting in directory \c path.
+ Result const open(docstring const & path,
+ support::FileFilterList const & filters,
+ docstring const & suggested);