added API documentation.

2005-04-07  Sven Neumann  <sven@gimp.org>

	* libgimpconfig/gimpconfig-path.c: added API documentation.
This commit is contained in:
Sven Neumann 2005-04-07 17:19:47 +00:00 committed by Sven Neumann
parent 11fea041f6
commit 889caf60c0
2 changed files with 37 additions and 6 deletions

View File

@ -1,3 +1,7 @@
2005-04-07 Sven Neumann <sven@gimp.org>
* libgimpconfig/gimpconfig-path.c: added API documentation.
2005-04-07 Sven Neumann <sven@gimp.org>
* app/config/gimpcoreconfig.c

View File

@ -181,11 +181,21 @@ static gchar * gimp_config_path_expand_only (const gchar *path,
GError **error);
static inline gchar * gimp_config_path_extract_token (const gchar **str);
/**
* gimp_config_build_data_path:
* @name:
* @name: directory name (in UTF-8 encoding)
*
* Returns:
* Creates a search path as it is used in the gimprc file. The path
* returned by gimp_config_build_data_path() includes a directory
* below the user's gimp directory and one in the system-wide data
* directory.
*
* Note that you cannot use this path directly with gimp_path_parse().
* As it is in the gimprc notation, you first need to expand and
* recode it using gimp_config_path_expand().
*
* Returns: a newly allocated string
*
* Since: GIMP 2.4
**/
@ -200,9 +210,18 @@ gimp_config_build_data_path (const gchar *name)
/**
* gimp_config_build_plug_in_path:
* @name:
* @name: directory name (in UTF-8 encoding)
*
* Returns:
* Creates a search path as it is used in the gimprc file. The path
* returned by gimp_config_build_plug_in_path() includes a directory
* below the user's gimp directory and one in the system-wide plug-in
* directory.
*
* Note that you cannot use this path directly with gimp_path_parse().
* As it is in the gimprc notation, you first need to expand and
* recode it using gimp_config_path_expand().
*
* Returns: a newly allocated string
*
* Since: GIMP 2.4
**/
@ -217,9 +236,17 @@ gimp_config_build_plug_in_path (const gchar *name)
/**
* gimp_config_build_writable_path:
* @name:
* @name: directory name (in UTF-8 encoding)
*
* Returns:
* Creates a search path as it is used in the gimprc file. The path
* returned by gimp_config_build_writable_path() is just the writable
* parts of the search path constructed by gimp_config_build_data_path().
*
* Note that you cannot use this path directly with gimp_path_parse().
* As it is in the gimprc notation, you first need to expand and
* recode it using gimp_config_path_expand().
*
* Returns: a newly allocated string
*
* Since: GIMP 2.4
**/