Trail API Version 1.0
=====================

Modules
-------
[copier] TODO
dnd: 2.
[fam]  TODO
format: 3.
gui: 4.
	icontheme: 4.1
path: 5.
spawner: 6.
preview: 7.
thumbnail: 8.


2. DND
-------
stringlist = trail_dnd_get_filename_list(context, dragdata)
trail_dnd_set_filename_list(context, dragdata, stringlist)
/* free stringlist with g_strfreev(stringlist) */

3. Format
----------
gchar *trail_format_prettysize(size_t value)
gchar *trail_format_prettydate(time_t time)
gchar *trail_format_dircaption(gchar const *path)
gchar *trail_format_get_file_names_summary_string_v(gchar **names)
gchar *trail_format_get_file_names_summary_string_list(GList *g)

4. GUI
------
4.1. Icontheme
---------------
GdkPixbuf *trail_gui_icontheme_get_themed_icon(gchar const *name, int width, int height)
GdkPixbuf *trail_gui_icontheme_get_custom_or_themed_icon(gchar const *name, int width, int height, gboolean use_fallback)
GdkPixbuf *trail_gui_icontheme_get_fallback_icon(gchar const *name, int width, int height, gboolean use_unknown)
GdkPixbuf *trail_gui_icontheme_get_themed_or_fallback_icon(gchar const *name, int width, int height, gboolean use_unknown)

5. Path
--------
gchar const *trail_path_get_app_short_name()
gchar const *trail_path_get_cache_dir()
gchar const *trail_path_get_glade_dir()

6. Spawner
-----------
trail_spawner_new(spawner_options_t opts)
typedef enum { SPAWNER_STDERR_JOIN_TO_STDOUT } spawner_options_t
pid_t trail_spawner_spawn(gchar const **args, gchar const *group) /* group: nullable */
int trail_spawner_count_running(gchar const *group)
int trail_spawner_wexitstatus(int code)
/*poll, unused*/
trail_spawner_kill(pid_t pid, signal_t signal /* SIGINT, usually */)

signals:
	child-spawned (pid_t, gchar const *group)
	child-stdout-received (pid_t, gchar const *group, gchar const *data)
	child-stderr-received (pid_t, gchar const *group, gchar const *data)
	child-terminated (pid_t, gchar const *group)

7. Preview
-----------
void trail_preview_minimum_aspect_correct_size(int source_width, int source_height, int max_width, int max_height, int *new_width, int *new_height)
GdkPixbuf *trail_preview_raw(GdkPixbuf *source_pixbuf, int intended_width, int intended_height)
GdkPixbuf *trail_preview_pad_icon_sized(GdkPixbuf *mini_pixbuf, int intended_width, int intended_height)
GdkPixbuf *trail_preview_get_icon_sized(GdkPixbuf *source_pixbuf, int intended_width, int intended_height)

8. Thumbnail
-------------
trail_thumbnails_new()
trail_thumbnails_raid()
trail_thumbnails_generate_thumbnail(gchar const *orig_path, int width, int height)
	/* width, height = MAX width, height */

trail_thumbnails_remove_thumbnails_for_dir(gchar const *dir)