dnrops
/
gimp
mirror of https://github.com/GNOME/gimp.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

libgimpconfig: turn some comments into actual docs

This commit is contained in:
Michael Natterer 2019-09-16 20:24:06 +02:00
parent 8cdcaa4ef1
commit ccd6f6385b
2 changed files with 53 additions and 27 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

9
libgimpconfig/gimpconfig-params.c
View File

@ -34,6 +34,15 @@
#include "gimpconfig.h" #include "gimpconfig.h"
/**
* SECTION: gimpconfig-params
* @title: GimpConfig-params
* @short_description: Macros and defines to install config properties.
*
* Macros and defines to install config properties.
**/
static gboolean static gboolean
gimp_gegl_param_spec_has_key (GParamSpec *pspec, gimp_gegl_param_spec_has_key (GParamSpec *pspec,
const gchar *key, const gchar *key,

63
libgimpconfig/gimpconfig-params.h
View File

@ -33,44 +33,61 @@ G_BEGIN_DECLS
/** /**
* SECTION: gimpconfig-params * GIMP_CONFIG_PARAM_SERIALIZE:
* @title: GimpConfig-params
* @short_description: Macros and defines to install config properties.
* *
* Macros and defines to install config properties. * A property that can and should be serialized and deserialized.
**/ **/
/*
* GIMP_CONFIG_PARAM_SERIALIZE - A property that can and should be
* serialized and deserialized.
* GIMP_CONFIG_PARAM_AGGREGATE - The object property is to be treated as
* part of the parent object.
* GIMP_CONFIG_PARAM_RESTART - Changes to this property take effect only
* after a restart.
* GIMP_CONFIG_PARAM_CONFIRM - Changes to this property should be
* confirmed by the user before being applied.
* GIMP_CONFIG_PARAM_DEFAULTS - Don't serialize this property if it has the
* default value.
* GIMP_CONFIG_PARAM_IGNORE - This property exists for obscure reasons
* or is needed for backward compatibility.
* Ignore the value read and don't serialize it.
*/
#define GIMP_CONFIG_PARAM_SERIALIZE (1 << (0 + G_PARAM_USER_SHIFT)) #define GIMP_CONFIG_PARAM_SERIALIZE (1 << (0 + G_PARAM_USER_SHIFT))
/**
* GIMP_CONFIG_PARAM_AGGREGATE:
*
* The object property is to be treated as part of the parent object.
**/
#define GIMP_CONFIG_PARAM_AGGREGATE (1 << (1 + G_PARAM_USER_SHIFT)) #define GIMP_CONFIG_PARAM_AGGREGATE (1 << (1 + G_PARAM_USER_SHIFT))
/**
* GIMP_CONFIG_PARAM_RESTART:
*
* Changes to this property take effect only after a restart.
**/
#define GIMP_CONFIG_PARAM_RESTART (1 << (2 + G_PARAM_USER_SHIFT)) #define GIMP_CONFIG_PARAM_RESTART (1 << (2 + G_PARAM_USER_SHIFT))
/**
* GIMP_CONFIG_PARAM_CONFIRM:
*
* Changes to this property should be confirmed by the user before
* being applied.
**/
#define GIMP_CONFIG_PARAM_CONFIRM (1 << (3 + G_PARAM_USER_SHIFT)) #define GIMP_CONFIG_PARAM_CONFIRM (1 << (3 + G_PARAM_USER_SHIFT))
/**
* GIMP_CONFIG_PARAM_DEFAULTS:
*
* Don't serialize this property if it has the default value.
**/
#define GIMP_CONFIG_PARAM_DEFAULTS (1 << (4 + G_PARAM_USER_SHIFT)) #define GIMP_CONFIG_PARAM_DEFAULTS (1 << (4 + G_PARAM_USER_SHIFT))
/**
* GIMP_CONFIG_PARAM_IGNORE:
*
* This property exists for obscure reasons or is needed for backward
* compatibility. Ignore the value read and don't serialize it.
**/
#define GIMP_CONFIG_PARAM_IGNORE (1 << (5 + G_PARAM_USER_SHIFT)) #define GIMP_CONFIG_PARAM_IGNORE (1 << (5 + G_PARAM_USER_SHIFT))
/**
* GIMP_CONFIG_PARAM_FLAGS:
*
* The default flags that should be used for serializable #GimpConfig
* properties.
**/
#define GIMP_CONFIG_PARAM_FLAGS (G_PARAM_READWRITE | \ #define GIMP_CONFIG_PARAM_FLAGS (G_PARAM_READWRITE | \
G_PARAM_CONSTRUCT | \ G_PARAM_CONSTRUCT | \
G_PARAM_STATIC_STRINGS | \ G_PARAM_STATIC_STRINGS | \
GIMP_CONFIG_PARAM_SERIALIZE) GIMP_CONFIG_PARAM_SERIALIZE)
/* some convenience macros to install object properties */ /* some convenience macros to install object properties */
#define GIMP_CONFIG_PROP_BOOLEAN(class, id, name, nick, blurb, default, flags) \ #define GIMP_CONFIG_PROP_BOOLEAN(class, id, name, nick, blurb, default, flags) \