Commit 879b5cad authored by Daniel Espinosa Ortiz's avatar Daniel Espinosa Ortiz

GI: replacing allow-none annotation with nullable

parent 5ce00a2f
......@@ -571,7 +571,7 @@ gdaui_dsn_editor_get_dsn (GdauiDsnEditor *config)
/**
* gdaui_dsn_editor_set_dsn
* @editor: a #GdauiDsnEditor widget
* @dsn_info: (allow-none): a #GdaDsnInfo pointer or %NULL
* @dsn_info: (nullable): a #GdaDsnInfo pointer or %NULL
*
*
* Requests that @editor update its contents with @dsn_info's contents
......
......@@ -233,8 +233,8 @@ gdaui_login_dialog_get_type (void)
/**
* gdaui_login_dialog_new
* @title: (allow-none): title of the dialog, or %NULL
* @parent: (allow-none): transient parent of the dialog, or %NULL
* @title: (nullable): title of the dialog, or %NULL
* @parent: (nullable): transient parent of the dialog, or %NULL
*
* Creates a new login dialog widget.
*
......
......@@ -21,7 +21,7 @@
/**
* support_create_pixbuf_for_provider:
* @pinfo: (allow-none): a #GdaProviderInfo, or %NULL
* @pinfo: (nullable): a #GdaProviderInfo, or %NULL
*
* Creates a new #GdkPixbuf using @pinfo's icon. The new pixbuf will at most be SUPPORT_ICON_SIZE pixels high.
*
......
......@@ -145,13 +145,20 @@ gdaui_data_cell_renderer_info_class_init (GdauiDataCellRendererInfoClass *class)
PROP_GROUP,
g_param_spec_pointer ("group", NULL, NULL,
G_PARAM_WRITABLE|G_PARAM_CONSTRUCT_ONLY));
/**
* GdauiDataCellRendererInfo::status-changed:
* @cell_renderer_info: Widget that receive the signal
* @path: a string with the path of the attribute
* @requested_action: (type Gda.ValueAttribute): action made
*/
info_cell_signals[STATUS_CHANGED] =
g_signal_new ("status-changed",
G_OBJECT_CLASS_TYPE (object_class),
G_SIGNAL_RUN_LAST,
G_STRUCT_OFFSET (GdauiDataCellRendererInfoClass, status_changed),
NULL, NULL,
_gdaui_marshal_VOID__STRING_ENUM,
_gdaui_marshal_VOID__STRING_FLAGS,
G_TYPE_NONE, 2,
G_TYPE_STRING,
GDA_TYPE_VALUE_ATTRIBUTE);
......
......@@ -33,7 +33,6 @@ G_DECLARE_DERIVABLE_TYPE (GdauiDataCellRendererInfo, gdaui_data_cell_renderer_in
struct _GdauiDataCellRendererInfoClass
{
GtkCellRendererClass parent_class;
void (* status_changed) (GdauiDataCellRendererInfo *cell_renderer_info,
const gchar *path,
GdaValueAttribute requested_action);
......
......@@ -540,7 +540,7 @@ gdaui_data_cell_renderer_textual_set_property (GObject *object,
/**
* gdaui_data_cell_renderer_textual_new:
* @dh: (allow-none): a #GdaDataHandler object, or %NULL
* @dh: (nullable): a #GdaDataHandler object, or %NULL
* @type: the #GType being edited
* @options: options as a string
*
......
......@@ -426,7 +426,7 @@ combo_contents_changed_cb (G_GNUC_UNUSED GdauiCombo *entry, GdauiEntryCombo *com
/**
* gdaui_entry_combo_set_values:
* @combo: a #GdauiEntryCombo widet
* @values: (element-type GValue) (allow-none): a list of #GValue values, or %NULL
* @values: (element-type GValue) (nullable): a list of #GValue values, or %NULL
*
* Sets the values of @combo to the specified ones. None of the
* values provided in the list is modified.
......
......@@ -149,7 +149,7 @@ gdaui_entry_number_is_type_numeric (GType type)
* gdaui_entry_number_new:
* @dh: the data handler to be used by the new widget
* @type: the requested data type (compatible with @dh)
* @options: (allow-none): some options formatting the new entry, or %NULL
* @options: (nullable): some options formatting the new entry, or %NULL
*
* Creates a new data entry widget. Known options are: THOUSAND_SEP, NB_DECIMALS and CURRENCY
*
......
......@@ -154,7 +154,7 @@ gdaui_entry_string_init (GdauiEntryString *mgstr)
* gdaui_entry_string_new:
* @dh: the data handler to be used by the new widget
* @type: the requested data type (compatible with @dh)
* @options: (allow-none): some options formatting the new entry, or %NULL
* @options: (nullable): some options formatting the new entry, or %NULL
*
* Creates a new data entry widget. Known options are: MAX_SIZE, MULTILINE, and HIDDEN
*
......
......@@ -304,8 +304,8 @@ adjust_display (GdauiEntry *entry, gchar *existing_text)
/**
* gdaui_entry_new:
* @prefix: (allow-none): a prefix (not modifiable) string, or %NULL
* @suffix: (allow-none): a suffix (not modifiable) string, or %NULL
* @prefix: (nullable): a prefix (not modifiable) string, or %NULL
* @suffix: (nullable): a suffix (not modifiable) string, or %NULL
*
* Creates a new #GdauiEntry widget.
*
......@@ -390,7 +390,7 @@ gdaui_entry_get_text (GdauiEntry *entry)
/**
* gdaui_entry_set_text:
* @entry: a #GdauiEntry widget
* @text: (allow-none): the text to set into @entry, or %NULL
* @text: (nullable): the text to set into @entry, or %NULL
*
* Sets @text into @entry.
*
......
......@@ -416,7 +416,7 @@ gdaui_formatted_entry_assume_delete (GdauiEntry *entry, gint virt_start_pos, gin
/**
* gdaui_formatted_entry_new:
* @format: a format string
* @mask: (allow-none): a mask string, or %NULL
* @mask: (nullable): a mask string, or %NULL
*
* Creates a new #GdauiFormattedEntry widget.
*
......@@ -499,8 +499,8 @@ gdaui_formatted_entry_get_text (GdauiFormattedEntry *entry)
/**
* gdaui_formatted_entry_set_insert_func:
* @entry: a #GdauiFormattedEntry widget
* @insert_func: (allow-none) (scope notified): a #GdauiFormattedEntryInsertFunc, or %NULL
* @data: (allow-none): a pointer which will be passed to @insert_func
* @insert_func: (nullable) (scope notified): a #GdauiFormattedEntryInsertFunc, or %NULL
* @data: (nullable): a pointer which will be passed to @insert_func
*
* Specifies that @entry should call @insert_func when the user wants to insert a char
* which is anot allowed, to perform other actions
......
......@@ -337,7 +337,7 @@ gdaui_data_cell_renderer_password_set_property (GObject *object,
/**
* gdaui_data_cell_renderer_password_new
* @dh: (allow-none): a #GdaDataHandler object, or %NULL
* @dh: (nullable): a #GdaDataHandler object, or %NULL
* @type: the #GType being edited
*
* Creates a new #GdauiDataCellRendererPassword.
......
......@@ -1868,7 +1868,7 @@ gdaui_basic_form_widget_grab_focus (GtkWidget *widget)
/**
* gdaui_basic_form_entry_grab_focus:
* @form: a #GdauiBasicForm widget
* @holder: (allow-none): a #GdaHolder object, or %NULL
* @holder: (nullable): a #GdaHolder object, or %NULL
*
* Makes the data entry corresponding to @holder grab the focus for the window it's in. If @holder is %NULL,
* then the focus is on the first entry which needs attention.
......@@ -1907,7 +1907,7 @@ gdaui_basic_form_entry_grab_focus (GdauiBasicForm *form, GdaHolder *holder)
/**
* gdaui_basic_form_entry_set_editable:
* @form: a #GdauiBasicForm widget
* @holder: (allow-none): a #GdaHolder object; or %NULL
* @holder: (nullable): a #GdaHolder object; or %NULL
* @editable: %TRUE if corresponding data entry must be editable
*
* Sets the #GdauiDataEntry in @form which corresponds to the
......@@ -2093,9 +2093,9 @@ gdaui_basic_form_get_label_widget (GdauiBasicForm *form, GdaHolder *holder)
/**
* gdaui_basic_form_new_in_dialog:
* @data_set: a #GdaSet object
* @parent: (allow-none): the parent window for the new dialog, or %NULL
* @title: (allow-none): the title of the dialog window, or %NULL
* @header: (allow-none): a helper text displayed at the top of the dialog, or %NULL
* @parent: (nullable): the parent window for the new dialog, or %NULL
* @title: (nullable): the title of the dialog window, or %NULL
* @header: (nullable): a helper text displayed at the top of the dialog, or %NULL
*
* Creates a new #GdauiBasicForm widget in the same way as gdaui_basic_form_new()
* and puts it into a #GtkDialog widget. The returned dialog has the "Ok" and "Cancel" buttons
......
......@@ -995,7 +995,7 @@ text_tag_table_foreach_cb (GtkTextTag *tag, FilterData *fdata)
/**
* gdaui_cloud_filter:
* @cloud: a #GdauiCloud widget
* @filter: (allow-none): the filter to use, or %NULL to remove any filter
* @filter: (nullable): the filter to use, or %NULL to remove any filter
*
* Filters the elements displayed in @cloud, by altering their color.
*
......@@ -1057,8 +1057,8 @@ gdaui_cloud_create_filter_widget (GdauiCloud *cloud)
/**
* gdaui_cloud_set_weight_func:
* @cloud: a #GdauiCloud widget
* @func: (allow-none) (scope notified): a #GdauiCloudWeightFunc function which computes weights, or %NULL to unset
* @data: (allow-none): a pointer to pass as last argument of @func each time it is called, or %NULL
* @func: (nullable) (scope notified): a #GdauiCloudWeightFunc function which computes weights, or %NULL to unset
* @data: (nullable): a pointer to pass as last argument of @func each time it is called, or %NULL
*
* Specifies a function called by @cloud to compute each row's respective weight.
*
......
......@@ -523,7 +523,7 @@ _gdaui_combo_get_selected (GdauiCombo *combo)
* _gdaui_combo_set_selected_ext
* @combo: a #GdauiCombo widget
* @values: (element-type GObject.Value): a list of #GValue objects
* @cols_index: (allow-none) (array): array of gint, index of column to which each value in @values corresponds, or %NULL
* @cols_index: (nullable) (array): array of gint, index of column to which each value in @values corresponds, or %NULL
*
* Sets the currently selected row of @combo from the values stored in @values, assuming that
* these values correspond to the columns listed in @cols_index. @cols_index must contain at least as
......@@ -558,7 +558,7 @@ _gdaui_combo_set_selected_ext (GdauiCombo *combo, const GSList *values, gint *co
* _gdaui_combo_get_selected_ext
* @combo: a #GdauiCombo widget
* @n_cols: the number of columns for which values are requested
* @cols_index: (array) (allow-none) (array length=n_cols): an array of @n_cols #gint indicating which column to get a value for, or %NULL
* @cols_index: (array) (nullable) (array length=n_cols): an array of @n_cols #gint indicating which column to get a value for, or %NULL
*
* Get a list of the currently selected values in @combo. The list itself must be free'd using g_slist_free(),
* but not the values it contains. If there is no selected value in @combo, then %NULL is returned.
......
......@@ -143,7 +143,7 @@ gdaui_data_entry_get_value_type (GdauiDataEntry *de)
/**
* gdaui_data_entry_set_value:
* @de: a #GtkWidget object which implements the #GdauiDataEntry interface
* @value: (allow-none): a #GValue, or %NULL
* @value: (nullable): a #GValue, or %NULL
*
* Push a value into the #GdauiDataEntry. The value parameter must either be:
* <itemizedlist>
......@@ -191,7 +191,7 @@ gdaui_data_entry_get_value (GdauiDataEntry *de)
/**
* gdaui_data_entry_validate:
* @de: a #GtkWidget object which implements the #GdauiDataEntry interface
* @error: (allow-none): a place to store an erro, or %NULL
* @error: (nullable): a place to store an erro, or %NULL
*
* Tests the validity of @de's contents. This function must be overrided by implementators.
*
......@@ -215,7 +215,7 @@ gdaui_data_entry_validate (GdauiDataEntry *de, GError **error)
/**
* gdaui_data_entry_set_reference_value:
* @de: a #GtkWidget object which implements the #GdauiDataEntry interface
* @value: (allow-none): a #GValue, or %NULL
* @value: (nullable): a #GValue, or %NULL
*
* Push a value into the GdauiDataEntry in the same way as gdaui_data_entry_set_value() but
* also sets this value as the reference value.
......@@ -277,7 +277,7 @@ gdaui_data_entry_get_reference_value (GdauiDataEntry *de)
/**
* gdaui_data_entry_set_default_value:
* @de: a #GtkWidget object which implements the #GdauiDataEntry interface
* @value: (allow-none): a #GValue, or %NULL
* @value: (nullable): a #GValue, or %NULL
*
* Sets the default value for the GdauiDataEntry which gets displayed when the
* user forces the default value. If it is not set then it is set to type GDA_TYPE_NULL.
......
......@@ -191,7 +191,7 @@ gdaui_grid_dispose (GObject *object)
/**
* gdaui_grid_new:
* @model: (allow-none): a #GdaDataModel, or %NULL
* @model: (nullable): a #GdaDataModel, or %NULL
*
* Creates a new #GdauiGrid widget suitable to display the data in @model
*
......
......@@ -104,7 +104,7 @@ gdaui_init (void)
/**
* gdaui_new_data_entry:
* @type: a #GType
* @plugin_name: (allow-none): the name of an entry plugin, or %NULL
* @plugin_name: (nullable): the name of an entry plugin, or %NULL
*
* Creates a new #GdauiDataEntry widget, taking into account the requested entry name
* if @plugin_name is not %NULL (if no entry of that name is found, then the default data
......@@ -203,7 +203,7 @@ gdaui_new_data_entry (GType type, const gchar *plugin_name)
/*
* _gdaui_new_cell_renderer
* @type: a #GType
* @plugin_name: (allow-none): the name of an entry plugin, or %NULL
* @plugin_name: (nullable): the name of an entry plugin, or %NULL
*
* Creates a new #GtkCellRenderer object which is suitable to use in
* a #GtkTreeView widget, taking into account the requested entry name
......@@ -795,7 +795,7 @@ gdaui_get_default_path (void)
/**
* gdaui_set_default_path:
* @path: (allow-none): a path, or %NULL to unset
* @path: (nullable): a path, or %NULL to unset
*
* Define the default path used when saving a file, or when showing a #GtkFileChooser file chooser.
*
......
......@@ -493,7 +493,7 @@ cnc_params_editor_changed_cb (G_GNUC_UNUSED GdauiProviderSpecEditor *editor, Gda
/**
* gdaui_login_new:
* @dsn: (allow-none): a data source name, or %NULL
* @dsn: (nullable): a data source name, or %NULL
*
* Creates a new login widget which enables the user to specify connection parameters.
*
......@@ -618,7 +618,7 @@ gdaui_login_get_connection_information (GdauiLogin *login)
/**
* gdaui_login_set_dsn:
* @login: a #GdauiLogin object
* @dsn: (allow-none): a data source name, or %NULL
* @dsn: (nullable): a data source name, or %NULL
*
* Changes the information displayed in @login, to represent @dsn.
* If @login's mode has %GDA_UI_LOGIN_HIDE_DSN_SELECTION_MODE, then
......
......@@ -30,7 +30,7 @@
* GdauiEntryCreateFunc:
* @handler: a #GdaDataHandler
* @type: a #GType
* @options: (allow-none): options, or %NULL
* @options: (nullable): options, or %NULL
* @Returns: a new #GdauiDataEntry
*
* Defines a function which creates a #GdauiDataEntry widget
......@@ -41,7 +41,7 @@ typedef GdauiDataEntry *(*GdauiEntryCreateFunc)(GdaDataHandler *handler, GType
* GdauiCellCreateFunc:
* @handler: a #GdaDataHandler
* @type: a #GType
* @options: (allow-none): options, or %NULL
* @options: (nullable): options, or %NULL
* @Returns:a new #GtkCellRenderer
*
* Defines a function which creates a #GtkCellRenderer object
......@@ -52,13 +52,13 @@ typedef GtkCellRenderer *(*GdauiCellCreateFunc) (GdaDataHandler *handler, GType
/**
* GdauiPlugin:
* @plugin_name: the name of the plugin
* @plugin_descr: (allow-none): a description for the plugin, or %NULL
* @plugin_file: (allow-none): the shared object implementing the plugin, can be %NULL for internal plugins
* @plugin_descr: (nullable): a description for the plugin, or %NULL
* @plugin_file: (nullable): the shared object implementing the plugin, can be %NULL for internal plugins
* @nb_g_types: number of types the plugin can handle, or %0 for any type
* @valid_g_types: (allow-none): an array of #GType, containing the accepted types, its size is @nb_g_types, or %NULL if @nb_g_types is %0
* @options_xml_spec: (allow-none): a string describing the plugin's options, or %NULL
* @entry_create_func: (allow-none): the function called to create a #GdauiDataEntry, or %NULL
* @cell_create_func: (allow-none): the function called to create a #GtkCellRenderer, or %NULL
* @valid_g_types: (nullable): an array of #GType, containing the accepted types, its size is @nb_g_types, or %NULL if @nb_g_types is %0
* @options_xml_spec: (nullable): a string describing the plugin's options, or %NULL
* @entry_create_func: (nullable): the function called to create a #GdauiDataEntry, or %NULL
* @cell_create_func: (nullable): the function called to create a #GtkCellRenderer, or %NULL
*
* Structure representing a plugin.
*
......
......@@ -129,7 +129,7 @@ gdaui_provider_selector_get_provider (GdauiProviderSelector *selector)
/**
* gdaui_provider_selector_set_provider:
* @selector: a #GdauiProviderSelector widget
* @provider: (allow-none): the provider to be selected, or %NULL for the default (SQLite)
* @provider: (nullable): the provider to be selected, or %NULL for the default (SQLite)
*
* Forces @selector to be set on @provider
*
......
......@@ -430,7 +430,7 @@ gdaui_raw_form_init (GdauiRawForm *wid)
/**
* gdaui_raw_form_new:
* @model: (allow-none): a #GdaDataModel, or %NULL
* @model: (nullable): a #GdaDataModel, or %NULL
*
* Creates a new #GdauiRawForm widget to display data in @model
*
......
......@@ -898,8 +898,8 @@ remove_formatting_function (GdauiRawGrid *grid, GdauiRawGridFormatFunc func)
* gdaui_raw_grid_add_formatting_function:
* @grid: a #GdauiRawGrid widget
* @func: a #GdauiRawGridFormatFunc function pointer
* @data: (allow-none): a pointer to pass to the @func function when called
* @dnotify: (allow-none): destroy notifier for @data
* @data: (nullable): a pointer to pass to the @func function when called
* @dnotify: (nullable): destroy notifier for @data
*
* This function allows you to specify that the @func function needs to be called
* whenever the rendering of a cell in @grid needs to be done. It is similar in purpose
......
......@@ -1257,7 +1257,7 @@ spaces_since_start_of_line (GtkTextIter *iter)
* get_markup_token:
* @iter: starting position
* @out_nb_spaces_before: a place to set the value returned by spaces_since_start_of_line() if called
* @out_end: (allow-none): place to put the last used position, or %NULL
* @out_end: (nullable): place to put the last used position, or %NULL
* @rte: the #GdauiRtEditor
*
* Parses marking tokens, nothing else
......
......@@ -1041,9 +1041,9 @@ sequence_item_remove_cb (GdaServerOperation *op, const gchar *seq_path, gint ite
/**
* gdaui_server_operation_new_in_dialog:
* @op: a #GdaServerOperation object
* @parent: (allow-none): the parent window for the new dialog, or %NULL
* @title: (allow-none): the title of the dialog window, or %NULL
* @header: (allow-none): a helper text displayed at the top of the dialog, or %NULL
* @parent: (nullable): the parent window for the new dialog, or %NULL
* @title: (nullable): the title of the dialog window, or %NULL
* @header: (nullable): a helper text displayed at the top of the dialog, or %NULL
*
* Creates a new #GdauiServerOperation widget in the same way as gdaui_server_operation_new()
* and puts it into a #GtkDialog widget. The returned dialog has the "Ok" and "Cancel" buttons
......
......@@ -110,7 +110,7 @@ gdaui_set_group_copy (GdauiSetGroup *sg)
/**
* gdaui_set_group_free:
* @sg: (allow-none): a #GdauiSetGroup struct to free
* @sg: (nullable): a #GdauiSetGroup struct to free
*
* Frees any resources taken by @sg struct. If @sg is %NULL, then nothing happens.
*
......@@ -126,7 +126,7 @@ gdaui_set_group_free (GdauiSetGroup *sg)
/**
* gdaui_set_group_set_source:
* @sg: a #GdauiSetGroup struct to free
* @source (allow-none): a #GdauiSetSource struct or NULL
* @source (nullable): a #GdauiSetSource struct or NULL
*
* Set source to @source. if @source is #NULL, then @group nodes contains exactly one entry.
*
......@@ -294,7 +294,7 @@ gdaui_set_source_copy (GdauiSetSource *s)
/**
* gdaui_set_source_free:
* @s: (allow-none): a #GdauiSetSource struct to free
* @s: (nullable): a #GdauiSetSource struct to free
*
* Frees any resources taken by @s struct. If @s is %NULL, then nothing happens.
*
......
......@@ -40,6 +40,7 @@ VOID:STRING,INT
POINTER:POINTER
BOOLEAN:POINTER
VOID:STRING,ENUM
VOID:STRING,FLAGS
VOID:BOOLEAN
VOID:INT
BOOLEAN:STRING
......
......@@ -91,7 +91,7 @@ objattrs_unref (ObjAttrs *attrs)
/**
* gda_attributes_manager_new:
* @for_objects: set to TRUE if attributes will be set on objects.
* @signal_func: (allow-none) (scope call): a function to be called whenever an attribute changes on an object (if @for_objects is TRUE), or %NULL
* @signal_func: (nullable) (scope call): a function to be called whenever an attribute changes on an object (if @for_objects is TRUE), or %NULL
* @signal_data: user data passed as last argument of @signal_func when it is called
*
* Creates a new #GdaAttributesManager, which can store (name, value) attributes for pointers or GObject objects
......@@ -249,7 +249,7 @@ manager_real_set (GdaAttributesManager *mgr, gpointer ptr,
* @mgr: a #GdaAttributesManager
* @ptr: a pointer to the resources to which the attribute will apply
* @att_name: an attribute's name
* @value: (transfer none) (allow-none): a #GValue, or %NULL
* @value: (transfer none) (nullable): a #GValue, or %NULL
*
* Associates an attribute named @att_name to @ptr, with the value @value. Any previous association is replaced by
* this one, and if @value is %NULL then the association is removed.
......@@ -271,7 +271,7 @@ gda_attributes_manager_set (GdaAttributesManager *mgr, gpointer ptr, const gchar
* @mgr: a #GdaAttributesManager
* @ptr: a pointer to the resources to which the attribute will apply
* @att_name: an attribute's name
* @value: (allow-none): a #GValue, or %NULL
* @value: (nullable): a #GValue, or %NULL
* @destroy: function called when @att_name has to be freed
*
* Does the same as gda_attributes_manager_set() except that @destroy is called when @att_name needs
......
......@@ -339,7 +339,7 @@ gda_batch_get_statements (GdaBatch *batch)
/**
* gda_batch_get_parameters:
* @batch: a #GdaBatch object
* @out_params: (out) (transfer full) (allow-none): a place to store a new #GdaSet object, or %NULL
* @out_params: (out) (transfer full) (nullable): a place to store a new #GdaSet object, or %NULL
* @error: a place to store errors, or %NULL
*
* Get a new #GdaSet object which groups all the execution parameters
......
......@@ -519,7 +519,7 @@ gda_column_set_position (GdaColumn *column, gint position)
* gda_column_get_default_value:
* @column: a #GdaColumn.
*
* Returns: (allow-none): @column's default value, as a #GValue object, or %NULL if column does not have a default value
* Returns: (nullable): @column's default value, as a #GValue object, or %NULL if column does not have a default value
*/
const GValue *
gda_column_get_default_value (GdaColumn *column)
......@@ -532,7 +532,7 @@ gda_column_get_default_value (GdaColumn *column)
/**
* gda_column_set_default_value:
* @column: a #GdaColumn.
* @default_value: (allow-none): default #GValue for the column
* @default_value: (nullable): default #GValue for the column
*
* Sets @column's default #GValue.
*/
......@@ -571,8 +571,8 @@ gda_column_get_attribute (GdaColumn *column, const gchar *attribute)
* gda_column_set_attribute:
* @column: a #GdaColumn
* @attribute: attribute name as a static string
* @value: (allow-none): a #GValue, or %NULL
* @destroy: (allow-none): a function to be called when @attribute is not needed anymore, or %NULL
* @value: (nullable): a #GValue, or %NULL
* @destroy: (nullable): a function to be called when @attribute is not needed anymore, or %NULL
*
* Set the value associated to a named attribute. The @attribute string is 'stolen' by this method, and
* the memory it uses will be freed using the @destroy function when no longer needed (if @destroy is %NULL,
......
......@@ -92,7 +92,7 @@ void gda_column_set_attribute (GdaColumn *column, const gchar *a
* gda_column_set_attribute_static:
* @holder: a #GdaHolder
* @attribute: attribute's name
* @value: (allow-none): the value to set the attribute to, or %NULL
* @value: (nullable): the value to set the attribute to, or %NULL
*
* This function is similar to gda_column_set_attribute() but for static strings
*/
......
......@@ -150,7 +150,7 @@ gda_dsn_info_copy (const GdaDsnInfo *source)
/**
* gda_dsn_info_free:
* @dsn: (allow-none): a #GdaDsnInfo struct to free
* @dsn: (nullable): a #GdaDsnInfo struct to free
*
* Frees any resources taken by @dsn struct. If @dsn is %NULL, then nothing happens.
*
......@@ -215,8 +215,8 @@ make_cmp_string (const gchar *key_values_string)
/**
* gda_dsn_info_equal:
* @dsn1: (allow-none): a #GdaDsnInfo
* @dsn2: (allow-none): a #GdaDsnInfo
* @dsn1: (nullable): a #GdaDsnInfo
* @dsn2: (nullable): a #GdaDsnInfo
*
* Compares @dsn1 and @dsn2.
*
......
......@@ -201,7 +201,7 @@ gda_connection_event_get_description (GdaConnectionEvent *event)
/**
* gda_connection_event_set_description:
* @event: a #GdaConnectionEvent.
* @description: (allow-none): a description, or %NULL (to unset current description if any)
* @description: (nullable): a description, or %NULL (to unset current description if any)
*
* Sets @event's @description. This function should not be called directly.
*/
......
......@@ -389,7 +389,7 @@ gda_data_access_wrapper_new (GdaDataModel *model)
/**
* gda_data_access_wrapper_set_mapping:
* @wrapper: a #GdaDataAccessWrapper object
* @mapping: (allow-none) (array length=mapping_size): an array of #gint which represents the mapping between @wrapper's columns
* @mapping: (nullable) (array length=mapping_size): an array of #gint which represents the mapping between @wrapper's columns
* and the columns of the wrapped data model
* @mapping_size: the size of @mapping.
*
......
......@@ -357,7 +357,7 @@ gda_data_model_array_new_with_g_types_v (gint cols, GType *types)
*
* Makes a copy of @src into a new #GdaDataModelArray object
*
* Returns: (transfer full) (allow-none): a new data model, or %NULL if an error occurred
* Returns: (transfer full) (nullable): a new data model, or %NULL if an error occurred
*/
GdaDataModelArray *
gda_data_model_array_copy_model (GdaDataModel *src, GError **error)
......@@ -412,7 +412,7 @@ gda_data_model_array_copy_model (GdaDataModel *src, GError **error)
* Like gda_data_model_array_copy_model(), makes a copy of @src, but copies only some
* columns.
*
* Returns: (transfer full) (allow-none): a new data model, or %NULL if an error occurred
* Returns: (transfer full) (nullable): a new data model, or %NULL if an error occurred
*
* Since: 5.2.0
*/
......
......@@ -463,7 +463,7 @@ gda_data_model_bdb_get_property (GObject *object,
/**
* gda_data_model_bdb_new:
* @filename: name of the file containing the database
* @db_name: (allow-none): the name of the database within @filename, or %NULL
* @db_name: (nullable): the name of the database within @filename, or %NULL
*
* Creates a new #GdaDataModel object to access the contents of the Berkeley DB file @file,
* for the database @db_name if not %NULL
......
......@@ -793,7 +793,7 @@ gda_data_model_import_get_property (GObject *object,
* gda_data_model_import_new_file:
* @filename: the file to import data from
* @random_access: TRUE if random access will be required
* @options: (transfer none) (allow-none): importing options
* @options: (transfer none) (nullable): importing options
*
* Creates a new #GdaDataModel object which contains the data stored within the @filename file.
*
......@@ -834,7 +834,7 @@ gda_data_model_import_new_file (const gchar *filename, gboolean random_access,
* gda_data_model_import_new_mem:
* @data: a string containing the data to import
* @random_access: TRUE if random access will be required
* @options: (transfer none) (allow-none): importing options, see gda_data_model_import_new_file() for more information
* @options: (transfer none) (nullable): importing options, see gda_data_model_import_new_file() for more information
*
* Creates a new #GdaDataModel object which contains the data stored in the @data string.
*
......
......@@ -1014,7 +1014,7 @@ gda_data_model_iter_get_holder_for_field (GdaDataModelIter *iter, gint col)
*
* Get the value stored at the column @col in @iter. The returned value must not be modified.
*
* Returns: (allow-none) (transfer none): the #GValue, or %NULL if the value could not be fetched
* Returns: (nullable) (transfer none): the #GValue, or %NULL if the value could not be fetched
*/
const GValue *
gda_data_model_iter_get_value_at (GdaDataModelIter *iter, gint col)
......@@ -1040,11 +1040,11 @@ gda_data_model_iter_get_value_at (GdaDataModelIter *iter, gint col)
* gda_data_model_iter_get_value_at_e:
* @iter: a #GdaDataModelIter object
* @col: the requested column
* @error: (allow-none): a place to store errors, or %NULL
* @error: (nullable): a place to store errors, or %NULL
*
* Get the value stored at the column @col in @iter. The returned value must not be modified.
*
* Returns: (allow-none) (transfer none): the #GValue, or %NULL if the value could not be fetched
* Returns: (nullable) (transfer none): the #GValue, or %NULL if the value could not be fetched
*
* Since: 4.2.10
*/
......@@ -1105,7 +1105,7 @@ gda_data_model_iter_set_value_at (GdaDataModelIter *iter, gint col, const GValue
*
* Get the value stored at the column @field_name in @iter
*
* Returns: (allow-none) (transfer none): the #GValue, or %NULL
* Returns: (nullable) (transfer none): the #GValue, or %NULL
*/
const GValue *
gda_data_model_iter_get_value_for_field (GdaDataModelIter *iter, const gchar *field_name)
......
......@@ -187,9 +187,9 @@ gda_data_model_ldap_get_type (void)
/**
* gda_data_model_ldap_new_with_config:
* @cnc: an LDAP opened connection (must be a balid #GdaLdapConnection)
* @base_dn: (allow-none): the base DN to search on, or %NULL
* @filter: (allow-none): an LDAP filter, for example "(objectClass=*)"
* @attributes: (allow-none): the list (CSV format) of attributes to fetch, each in the format &lt;attname&gt;[::&lt;GType&gt;]
* @base_dn: (nullable): the base DN to search on, or %NULL
* @filter: (nullable): an LDAP filter, for example "(objectClass=*)"
* @attributes: (nullable): the list (CSV format) of attributes to fetch, each in the format &lt;attname&gt;[::&lt;GType&gt;]
* @scope: the search scope
*
* Creates a new #GdaDataModel object to extract some LDAP contents. The returned data model will
......@@ -238,7 +238,7 @@ gda_data_model_ldap_new_with_config (GdaConnection *cnc,
/**
* gda_data_model_ldap_compute_columns:
* @cnc: a #GdaConnection
* @attributes: (allow-none): a string describing which LDAP attributes to retreive, or %NULL
* @attributes: (nullable): a string describing which LDAP attributes to retreive, or %NULL
*
* Computes the #GdaColumn of the data model which would be created using @attributes when calling
* gda_data_model_ldap_new_with_config().
......
......@@ -488,7 +488,7 @@ gda_data_model_get_n_columns (GdaDataModel *model)
* WARNING: the returned #GdaColumn object belongs to the @model model and
* and should not be destroyed; any modification will affect the whole data model.
*
* Returns: (transfer none) (allow-none): the description of the column.
* Returns: (transfer none) (nullable): the description of the column.
*/
GdaColumn *
gda_data_model_describe_column (GdaDataModel *model, gint col)
......@@ -659,7 +659,7 @@ gda_data_model_set_column_title (GdaDataModel *model, gint col, const gchar *tit
* Upon errors %NULL will be returned and @error will be assigned a
* #GError from the #GDA_DATA_MODEL_ERROR domain.
*
* Returns: (allow-none) (transfer none): a #GValue containing the value stored in the given
* Returns: (nullable) (transfer none): a #GValue containing the value stored in the given
* position, or %NULL on error (out-of-bound position, etc).
*/
const GValue *
......@@ -698,7 +698,7 @@ gda_data_model_get_value_at (GdaDataModel *model, gint col, gint row, GError **e
* Upon errors %NULL will be returned and @error will be assigned a
* #GError from the #GDA_DATA_MODEL_ERROR domain.
*
* Returns: (allow-none) (transfer none): a #GValue containing the value stored in the given
* Returns: (nullable) (transfer none): a #GValue containing the value stored in the given
* position, or %NULL on error (out-of-bound position, wrong data type, etc).
*/
const GValue *
......@@ -797,7 +797,7 @@ gda_data_model_set_value_at (GdaDataModel *model, gint col, gint row, const GVal
* gda_data_model_set_values:
* @model: a #GdaDataModel object.
* @row: row number.
* @values: (element-type GObject.Value) (transfer none) (allow-none): a list of #GValue (or %NULL), one for at most the number of columns of @model
* @values: (element-type GObject.Value) (transfer none) (nullable): a list of #GValue (or %NULL), one for at most the number of columns of @model
* @error: a place to store errors, or %NULL
*
* In a similar way to gda_data_model_set_value_at(), this method modifies a data model's contents
......@@ -898,7 +898,7 @@ gda_data_model_create_iter (GdaDataModel *model)
/**
* gda_data_model_append_values:
* @model: a #GdaDataModel object.
* @values: (element-type GObject.Value) (allow-none): #GList of #GValue* representing the row to add. The
* @values: (element-type GObject.Value) (nullable): #GList of #GValue* representing the row to add. The
* length must match model's column count. These #GValue
* are value-copied (the user is still responsible for freeing them).
* @error: a place to store errors, or %NULL
......@@ -1071,7 +1071,7 @@ gda_data_model_get_row_from_values (GdaDataModel *model, GSList *values, gint *c
* gda_data_model_send_hint:
* @model: a #GdaDataModel
* @hint: (transfer none): a hint to send to the model
* @hint_value: (allow-none): an optional value to specify the hint, or %NULL
* @hint_value: (nullable): an optional value to specify the hint, or %NULL
*
* Sends a hint to the data model. The hint may or may not be handled by the data
* model, depending on its implementation
......@@ -1119,9 +1119,9 @@ static gchar *export_to_text_separated (GdaDataModel *model, const gint *cols, g
* gda_data_model_export_to_string:
* @model: a #GdaDataModel
* @format: the format in which to export data
* @cols: (array length=nb_cols) (allow-none): an array containing which columns of @model will be exported, or %NULL for all columns
* @cols: (array length=nb_cols) (nullable): an array containing which columns of @model will be exported, or %NULL for all columns
* @nb_cols: the number of columns in @cols
* @rows: (array length=nb_rows) (allow-none): an array containing which rows of @model will be exported, or %NULL for all rows
* @rows: (array length=nb_rows) (nullable): an array containing which rows of @model will be exported, or %NULL for all rows