Improve some documentation comments
This commit is contained in:
parent
e9f29a1002
commit
5e31f045a0
|
@ -73,7 +73,8 @@ static void die(const char * const error)
|
||||||
exit(EXIT_FAILURE);
|
exit(EXIT_FAILURE);
|
||||||
}
|
}
|
||||||
|
|
||||||
/** obtain language from environment
|
/**
|
||||||
|
* obtain language from environment
|
||||||
*
|
*
|
||||||
* start with GNU extension LANGUAGE environment variable and then try
|
* start with GNU extension LANGUAGE environment variable and then try
|
||||||
* POSIX variables LC_ALL, LC_MESSAGES and LANG
|
* POSIX variables LC_ALL, LC_MESSAGES and LANG
|
||||||
|
@ -107,7 +108,8 @@ static const char *get_language(void)
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
||||||
/** provide a string vector of languages in preference order
|
/**
|
||||||
|
* provide a string vector of languages in preference order
|
||||||
*
|
*
|
||||||
* environment variables are processed to aquire a colon separated
|
* environment variables are processed to aquire a colon separated
|
||||||
* list of languages which are converted into a string vector. The
|
* list of languages which are converted into a string vector. The
|
||||||
|
@ -174,7 +176,16 @@ static const char * const *get_languagev(void)
|
||||||
return &langv[0];
|
return &langv[0];
|
||||||
}
|
}
|
||||||
|
|
||||||
/* Stolen from gtk/gui.c */
|
/**
|
||||||
|
* Create an array of valid paths to search for resources.
|
||||||
|
*
|
||||||
|
* The idea is that all the complex path computation to find resources
|
||||||
|
* is performed here, once, rather than every time a resource is
|
||||||
|
* searched for.
|
||||||
|
*
|
||||||
|
* \param resource_path A shell style colon separated path list
|
||||||
|
* \return A string vector of valid paths where resources can be found
|
||||||
|
*/
|
||||||
static char **
|
static char **
|
||||||
nsmonkey_init_resource(const char *resource_path)
|
nsmonkey_init_resource(const char *resource_path)
|
||||||
{
|
{
|
||||||
|
|
|
@ -49,15 +49,15 @@ struct gui_fetch_table {
|
||||||
/**
|
/**
|
||||||
* Translate resource to full url.
|
* Translate resource to full url.
|
||||||
*
|
*
|
||||||
* @note Only used in resource fetcher
|
* @note Only used in resource protocol fetcher
|
||||||
*
|
*
|
||||||
* Transforms a resource: path into a full URL. The returned URL
|
* Transforms a resource protocol path into a full URL. The returned URL
|
||||||
* is used as the target for a redirect. The caller takes ownership of
|
* is used as the target for a redirect. The caller takes ownership of
|
||||||
* the returned nsurl including unrefing it when finished with it.
|
* the returned nsurl including unrefing it when finished with it.
|
||||||
*
|
*
|
||||||
* \param path The path of the resource to locate.
|
* \param path The path of the resource to locate.
|
||||||
* \return A string containing the full URL of the target object or
|
* \return A netsurf url object containing the full URL of the resource
|
||||||
* NULL if no suitable resource can be found.
|
* path or NULL if a suitable resource URL can not be generated.
|
||||||
*/
|
*/
|
||||||
struct nsurl* (*get_resource_url)(const char *path);
|
struct nsurl* (*get_resource_url)(const char *path);
|
||||||
|
|
||||||
|
|
Loading…
Reference in New Issue