-string const
-i18nLibFileSearch(string const & dir, string const & name,
- string const & ext = string());
-
-/** Takes a command such as "sh $$s/convertDefault.sh file.in file.out"
- * and replaces "$$s/" with the path to the "most important" of LyX's
- * script directories containing this script. If the script is not found,
- * "$$s/" is removed. Executing the command will still fail, but the
- * error message will make some sort of sense ;-)
+FileName const
+i18nLibFileSearch(std::string const & dir,
+ std::string const & name,
+ std::string const & ext = std::string());
+
+/** Same as libFileSearch(), but tries first to find a preferred
+ version of the file by appending the icon set name to the dir
+ */
+FileName const
+imageLibFileSearch(std::string & dir, std::string const & name,
+ std::string const & ext = std::string(),
+ search_mode mode = must_exist);
+
+/// How to quote a filename
+enum quote_style {
+ /** Quote for the (OS dependant) shell. This is needed for command
+ line arguments of subprocesses. */
+ quote_shell,
+ /** Quote a file name for the (OS dependant) shell. This is needed
+ for file names as command line arguments of subprocesses. */
+ quote_shell_filename,
+ /** Quote for python. Use this if you want to store a filename in a
+ python script. Example: \code
+ os << "infile = " << quoteName(filename) << '\\n';
+ \endcode This uses double quotes, so that you can also use this
+ to quote filenames as part of a string if the string is quoted
+ with single quotes. */
+ quote_python
+};
+
+/** Takes a command such as "python $$s/scripts/convertDefault.py file.in file.out"
+ * and replaces "$$s/" with the path to the LyX support directory containing
+ * this script. If the script is not found, "$$s/" is removed. Executing the
+ * command will still fail, but the error message will make some sort of
+ * sense ;-)