[gnumeric] Introspection: white space fixes for function arguments.
- From: Morten Welinder <mortenw src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [gnumeric] Introspection: white space fixes for function arguments.
- Date: Tue, 26 Mar 2013 15:48:42 +0000 (UTC)
commit a72086296234bf0f11cff1b00db0558eb5a30ea7
Author: Morten Welinder <terra gnome org>
Date: Tue Mar 26 11:48:12 2013 -0400
Introspection: white space fixes for function arguments.
Evidently introspection is picky.
plugins/applix/applix-read.c | 2 +-
plugins/excel/ms-biff.c | 10 ++--
plugins/excel/ms-chart.c | 6 +-
plugins/excel/ms-container.c | 12 +++---
plugins/excel/ms-excel-read.c | 20 +++++-----
plugins/excel/ms-excel-util.c | 4 +-
plugins/excel/ms-excel-write.c | 30 +++++++-------
plugins/excel/ms-formula-write.c | 4 +-
plugins/excel/ms-obj.c | 6 +-
plugins/html/latex.c | 72 +++++++++++++++++-----------------
src/cell-draw.c | 2 +-
src/clipboard.c | 10 ++--
src/cmd-edit.c | 2 +-
src/colrow.c | 26 ++++++------
src/commands.c | 36 ++++++++--------
src/dependent.c | 22 +++++-----
src/dialogs/dialog-doc-metadata.c | 56 +++++++++++++-------------
src/dialogs/dialog-formula-guru.c | 2 +-
src/dialogs/dialog-stf-csv-page.c | 12 +++---
src/dialogs/dialog-stf-export.c | 6 +-
src/dialogs/dialog-stf-fixed-page.c | 6 +-
src/dialogs/dialog-stf-format-page.c | 4 +-
src/dialogs/dialog-stf-main-page.c | 18 ++++----
src/dialogs/dialog-stf-preview.c | 8 ++--
src/expr-name.c | 24 ++++++------
src/expr.c | 34 ++++++++--------
src/format-template.c | 2 +-
src/func.c | 6 +-
src/gnm-data-cache-source.c | 6 +-
src/gnm-format.c | 18 ++++----
src/gnm-pane.c | 2 +-
src/gnm-sheet-slicer.c | 8 ++--
src/go-data-cache.c | 18 ++++----
src/go-data-slicer-field.c | 10 ++--
src/go-data-slicer.c | 6 +-
src/go-val.c | 4 +-
src/gui-util.c | 4 +-
src/input-msg.c | 4 +-
src/item-bar.c | 12 +++---
src/mstyle.c | 34 ++++++++--------
src/parse-util.c | 40 +++++++++---------
src/print-info.c | 12 +++---
src/print.c | 2 +-
src/ranges.c | 24 ++++++------
src/sheet-control-gui.c | 40 +++++++++---------
src/sheet-filter.c | 56 +++++++++++++-------------
src/sheet-object-image.c | 8 ++--
src/sheet-utils.c | 6 +-
src/sheet-view.c | 34 ++++++++--------
src/stf-parse.c | 2 +-
src/stf.c | 22 +++++-----
src/style-border.c | 8 ++--
src/style-conditions.c | 8 ++--
src/style.c | 4 +-
src/validation.c | 20 +++++-----
src/widgets/gnm-cell-combo-view.c | 10 ++--
src/widgets/gnumeric-expr-entry.c | 4 +-
src/widgets/widget-editable-label.c | 6 +-
src/workbook-view.c | 2 +-
src/xml-sax-read.c | 8 ++--
60 files changed, 442 insertions(+), 442 deletions(-)
---
diff --git a/plugins/applix/applix-read.c b/plugins/applix/applix-read.c
index 74fe330..354b9ff 100644
--- a/plugins/applix/applix-read.c
+++ b/plugins/applix/applix-read.c
@@ -136,7 +136,7 @@ applix_parse_error (ApplixReadState *state, char const *format, ...)
/**
* applix_parse_value : Parse applix's optionally quoted values.
*
- * @follow : A pointer to a char * that is adjusted to point 2 chars AFTER the
+ * @follow: A pointer to a char * that is adjusted to point 2 chars AFTER the
* end of the string.
*
* returns the strings and null terminates it.
diff --git a/plugins/excel/ms-biff.c b/plugins/excel/ms-biff.c
index 76e3b29..b64efa8 100644
--- a/plugins/excel/ms-biff.c
+++ b/plugins/excel/ms-biff.c
@@ -307,8 +307,8 @@ skip_bytes (BiffQuery *q, int start, int count)
/**
* ms_biff_query_set_decrypt :
- * @q :
- * @password : password in UTF-8 encoding.
+ * @q:
+ * @password: password in UTF-8 encoding.
**/
gboolean
ms_biff_query_set_decrypt (BiffQuery *q, MsBiffVersion version,
@@ -532,9 +532,9 @@ ms_biff_query_destroy (BiffQuery *q)
/**
* ms_biff_put_new :
- * @output : the output storage
- * @version :
- * @codepage : Ignored if negative
+ * @output: the output storage
+ * @version:
+ * @codepage: Ignored if negative
*
* Take responsibility for @output
* and prepare to generate biff records.
diff --git a/plugins/excel/ms-chart.c b/plugins/excel/ms-chart.c
index 10932bc..1030334 100644
--- a/plugins/excel/ms-chart.c
+++ b/plugins/excel/ms-chart.c
@@ -3839,9 +3839,9 @@ ms_excel_chart_read (BiffQuery *q, MSContainer *container,
/* A wrapper which reads and checks the BOF record then calls ms_excel_chart_read */
/**
* ms_excel_chart_read_BOF :
- * @q : #BiffQuery
- * @container : #MSContainer
- * @sog : #SheetObjectGraph
+ * @q: #BiffQuery
+ * @container: #MSContainer
+ * @sog: #SheetObjectGraph
**/
gboolean
ms_excel_chart_read_BOF (BiffQuery *q, MSContainer *container, SheetObject *sog)
diff --git a/plugins/excel/ms-container.c b/plugins/excel/ms-container.c
index 8406cfb..2a7dfda 100644
--- a/plugins/excel/ms-container.c
+++ b/plugins/excel/ms-container.c
@@ -171,9 +171,9 @@ ms_container_realize_objs (MSContainer *container)
/**
* ms_container_parse_expr:
*
- * @c : The container
- * @data : the encoded expression
- * @length : the size of the encoded expression
+ * @c: The container
+ * @data: the encoded expression
+ * @length: the size of the encoded expression
*
* Attempts to parse the encoded expression in the context of the container.
*/
@@ -191,7 +191,7 @@ ms_container_parse_expr (MSContainer *c, guint8 const *data, int length)
/**
* ms_container_sheet:
*
- * @c : The container
+ * @c: The container
*
* DEPRECATED !
* This will become dependent_container when that abstraction is added
@@ -222,8 +222,8 @@ ms_container_get_fmt (MSContainer const *c, unsigned indx)
/**
* ms_container_get_markup :
- * @c : #MSContainer
- * @indx :
+ * @c: #MSContainer
+ * @indx:
*
* Return a #PangoAttrList the caller should not modify or free the list.
**/
diff --git a/plugins/excel/ms-excel-read.c b/plugins/excel/ms-excel-read.c
index cef5b53..7f9cec4 100644
--- a/plugins/excel/ms-excel-read.c
+++ b/plugins/excel/ms-excel-read.c
@@ -951,12 +951,12 @@ excel_unexpected_biff (BiffQuery *q, char const *state,
/**
* excel_read_string_header :
- * @data : a pointer to the start of the string header
- * @maxlen : the length of the data area
- * @use_utf16 : Is the content in 8 or 16 bit chars
- * @n_markup : number of trailing markup records
- * @has_extended : Is there trailing extended string info (eg japanese PHONETIC)
- * @post_data_len :
+ * @data: a pointer to the start of the string header
+ * @maxlen: the length of the data area
+ * @use_utf16: Is the content in 8 or 16 bit chars
+ * @n_markup: number of trailing markup records
+ * @has_extended: Is there trailing extended string info (eg japanese PHONETIC)
+ * @post_data_len:
*
* returns the length of the header (in bytes)
**/
@@ -1106,10 +1106,10 @@ excel_get_text (GnmXLImporter const *importer,
/**
* excel_get_text_fixme :
- * @importer :
- * @pos : pointer to the start of string information
- * @length : in _characters_
- * @byte_len : The number of bytes between @pos and the end of string data
+ * @importer:
+ * @pos: pointer to the start of string information
+ * @length: in _characters_
+ * @byte_len: The number of bytes between @pos and the end of string data
*
* Returns a string which the caller is responsible for freeing
**/
diff --git a/plugins/excel/ms-excel-util.c b/plugins/excel/ms-excel-util.c
index e34f27a..ca91698 100644
--- a/plugins/excel/ms-excel-util.c
+++ b/plugins/excel/ms-excel-util.c
@@ -167,8 +167,8 @@ two_way_table_put (TwoWayTable const *table, gpointer key,
/**
* two_way_table_move
* @table Table
- * @dst_idx : The new idx for the value
- * @src_idx : stored here
+ * @dst_idx: The new idx for the value
+ * @src_idx: stored here
*
* Moves the key at index @src_idx into index @dst_idx, and drops the original
* content of @dst_idx
diff --git a/plugins/excel/ms-excel-write.c b/plugins/excel/ms-excel-write.c
index b290141..b59c96c 100644
--- a/plugins/excel/ms-excel-write.c
+++ b/plugins/excel/ms-excel-write.c
@@ -262,8 +262,8 @@ excel_sheet_extent (Sheet const *sheet, GnmRange *extent, GnmStyle **col_styles,
/**
* excel_strlen :
- * @str : The utf8 encoded string in question
- * @bytes :
+ * @str: The utf8 encoded string in question
+ * @bytes:
*
* Returns the size of the string in _characters_ and stores the number of
* bytes in @bytes.
@@ -286,9 +286,9 @@ excel_strlen (guint8 const *str, size_t *bytes)
/**
* excel_write_string :
- * @bp :
- * @flags :
- * @txt :
+ * @bp:
+ * @flags:
+ * @txt:
*
* NOTE : I considered putting markup here too to be strictly correct and
* export rich text directly. But it was easier to just use RSTRING.
@@ -1734,8 +1734,8 @@ palette_free (XLExportBase *ewb)
/**
* palette_get_index
- * @ewb : #XLExportBase
- * @c : color
+ * @ewb: #XLExportBase
+ * @c: color
*
* Get index of color
* The color index to use is *not* simply the index into the palette.
@@ -2117,8 +2117,8 @@ after_put_font (ExcelWriteFont *f, gboolean was_added, gint index, gconstpointer
/**
* put_efont :
- * @efont : #ExcelWriteFont
- * @xle : #XLExportBase
+ * @efont: #ExcelWriteFont
+ * @xle: #XLExportBase
*
* Absorbs ownership of @efont potentially freeing it.
*
@@ -3584,8 +3584,8 @@ write_mulblank (BiffPut *bp, ExcelWriteSheet *esheet, guint32 end_col, guint32 r
/**
* excel_write_GUTS
- * @bp : BIFF buffer
- * @esheet : sheet
+ * @bp: BIFF buffer
+ * @esheet: sheet
*
* Write information about outline mode gutters.
**/
@@ -3670,10 +3670,10 @@ excel_write_DEFCOLWIDTH (BiffPut *bp, ExcelWriteSheet *esheet)
* excel_write_COLINFO
* @bp: BIFF buffer
* @esheet:
- * @ci : the descriptor of the first col (possibly NULL)
- * @first_col : the index of the last contiguous identical col
- * @last_col : the index of the last contiguous identical col
- * @xf_index : the style index to the entire col (< 0 for none)
+ * @ci: the descriptor of the first col (possibly NULL)
+ * @first_col: the index of the last contiguous identical col
+ * @last_col: the index of the last contiguous identical col
+ * @xf_index: the style index to the entire col (< 0 for none)
*
* Write column info for a run of identical columns
**/
diff --git a/plugins/excel/ms-formula-write.c b/plugins/excel/ms-formula-write.c
index d7ebf3a..b21168c 100644
--- a/plugins/excel/ms-formula-write.c
+++ b/plugins/excel/ms-formula-write.c
@@ -74,8 +74,8 @@ excel_write_prep_sheet (ExcelWriteState *ewb, Sheet const *sheet)
/**
* excel_write_prep_expr :
- * @ewb :
- * @texpr :
+ * @ewb:
+ * @texpr:
*
* Searches for interesting functions, names, or sheets.
* and builds a database of things to write out later.
diff --git a/plugins/excel/ms-obj.c b/plugins/excel/ms-obj.c
index a19e0f8..f6afe43 100644
--- a/plugins/excel/ms-obj.c
+++ b/plugins/excel/ms-obj.c
@@ -1220,9 +1220,9 @@ ms_obj_read_biff8_obj (BiffQuery *q, MSContainer *c, MSObj *obj)
/**
* ms_read_OBJ :
- * @q : The biff record to start with.
- * @c : The object's container
- * @attrs : an optional hash of object attributes.
+ * @q: The biff record to start with.
+ * @c: The object's container
+ * @attrs: an optional hash of object attributes.
*
* This function takes ownership of attrs.
*
diff --git a/plugins/html/latex.c b/plugins/html/latex.c
index 85ec716..4e30cdf 100644
--- a/plugins/html/latex.c
+++ b/plugins/html/latex.c
@@ -133,8 +133,8 @@ static latex_border_connectors_t const conn_styles[LATEX_MAX_BORDER]
/**
* latex_raw_str :
- * @p : a pointer to a char, start of the string to be processed
- * @output : output stream where the processed characters are written.
+ * @p: a pointer to a char, start of the string to be processed
+ * @output: output stream where the processed characters are written.
* @utf8: is this a utf8 string?
*
* @return:
@@ -176,8 +176,8 @@ latex_raw_str(char const *p, GsfOutput *output, gboolean utf8)
/**
* latex_fputs_utf :
*
- * @p : a pointer to a char, start of the string to be processed.
- * @output : output stream where the processed characters are written.
+ * @p: a pointer to a char, start of the string to be processed.
+ * @output: output stream where the processed characters are written.
*
* This escapes any special LaTeX characters from the LaTeX engine,
* except the ones enclosed in "\L{" and "}".
@@ -222,7 +222,7 @@ latex_fputs_utf (char const *p, GsfOutput *output)
/**
* latex_math_fputs_utf :
*
- * @p : a pointer to a char, start of the string to be processed.
+ * @p: a pointer to a char, start of the string to be processed.
* @output: output stream where the processed characters are written.
*
* This escapes any special LaTeX characters from the LaTeX engine,
@@ -310,8 +310,8 @@ latex_convert_latin_to_utf (char const *text)
/**
* latex_fputs_latin :
*
- * @p : a pointer to a char, start of the string to be processed.
- * @output : output stream where the processed characters are written.
+ * @p: a pointer to a char, start of the string to be processed.
+ * @output: output stream where the processed characters are written.
*
* This escapes any special LaTeX characters from the LaTeX engine,
* except the ones enclosed in "\L{" and "}".
@@ -361,7 +361,7 @@ latex_fputs_latin (char const *text, GsfOutput *output)
/**
* latex_math_fputs_latin :
*
- * @p : a pointer to a char, start of the string to be processed.
+ * @p: a pointer to a char, start of the string to be processed.
* @output: output stream where the processed characters are written.
*
* This escapes any special LaTeX characters from the LaTeX engine,
@@ -737,7 +737,7 @@ latex2e_find_vline (int col, int row, Sheet *sheet, GnmStyleElement which_border
/**
* latex2e_print_vert_border:
*
- * @output : Output stream where the cell contents will be written.
+ * @output: Output stream where the cell contents will be written.
* @clines: GnmStyleBorderType indicating the type of border
*
*/
@@ -752,12 +752,12 @@ latex2e_print_vert_border (GsfOutput *output, GnmStyleBorderType style)
/**
* latex2e_write_blank_multicolumn_cell:
*
- * @output : output stream where the cell contents will be written.
- * @star_col :
- * @start_row :
- * @num_merged_cols : an integer value of the number of columns to merge.
- * @num_merged_rows : an integer value of the number of rows to merge.
- * @sheet : the current sheet.
+ * @output: output stream where the cell contents will be written.
+ * @star_col:
+ * @start_row:
+ * @num_merged_cols: an integer value of the number of columns to merge.
+ * @num_merged_rows: an integer value of the number of rows to merge.
+ * @sheet: the current sheet.
*
* This function creates all the LaTeX code for the cell of a table (i.e. all
* the code that might fall between two ampersands (&)), assuming that
@@ -865,12 +865,12 @@ latex2e_write_blank_multicolumn_cell (GsfOutput *output, int start_col,
/**
* latex2e_write_multicolumn_cell:
*
- * @output : output stream where the cell contents will be written.
- * @cell : the cell whose contents are to be written.
- * @star_col :
- * @num_merged_cols : an integer value of the number of columns to merge.
- * @num_merged_rows : an integer value of the number of rows to merge.
- * @sheet : the current sheet.
+ * @output: output stream where the cell contents will be written.
+ * @cell: the cell whose contents are to be written.
+ * @star_col:
+ * @num_merged_cols: an integer value of the number of columns to merge.
+ * @num_merged_rows: an integer value of the number of rows to merge.
+ * @sheet: the current sheet.
*
* This function creates all the LaTeX code for the cell of a table (i.e. all
* the code that might fall between two ampersands (&)).
@@ -1122,9 +1122,9 @@ latex2e_write_multicolumn_cell (GsfOutput *output, GnmCell *cell, int start_col,
*
* @clines: array of GnmStyleBorderType* indicating the type of border
* @length: (remaining) positions in clines
- * @col :
- * @row :
- * @sheet :
+ * @col:
+ * @row:
+ * @sheet:
*
* Determine the border style
*
@@ -1161,9 +1161,9 @@ latex2e_find_hhlines (GnmStyleBorderType *clines, int length, int col, int row,
/**
* latex2e_print_hhline :
*
- * @output : output stream where the cell contents will be written.
+ * @output: output stream where the cell contents will be written.
* @clines: an array of GnmStyleBorderType* indicating the type of border
- * @n : the number of elements in clines
+ * @n: the number of elements in clines
*
* This procedure prints an hhline command according to the content
* of clines.
@@ -1237,10 +1237,10 @@ file_saver_sheet_get_extent (Sheet *sheet)
/**
* latex_file_save : The LaTeX2e exporter plugin function.
*
- * @FileSaver : New structure for file plugins. I don't understand.
- * @IOcontext : currently not used but reserved for the future.
- * @WorkbookView : this provides the way to access the sheet being exported.
- * @filename : where we'll write.
+ * @FileSaver: New structure for file plugins. I don't understand.
+ * @IOcontext: currently not used but reserved for the future.
+ * @WorkbookView: this provides the way to access the sheet being exported.
+ * @filename: where we'll write.
*
* This writes the top sheet of a Gnumeric workbook to a LaTeX2e longtable. We
* check for merges here, then call the function latex2e_write_multicolum_cell()
@@ -1465,8 +1465,8 @@ latex_file_save (G_GNUC_UNUSED GOFileSaver const *fs, G_GNUC_UNUSED GOIOContext
/**
* latex2e_table_cell:
*
- * @output : output stream where the cell contents will be written.
- * @cell : the cell whose contents are to be written.
+ * @output: output stream where the cell contents will be written.
+ * @cell: the cell whose contents are to be written.
*
* This function creates all the LaTeX code for the cell of a table (i.e. all
* the code that might fall between two ampersands (&)).
@@ -1513,10 +1513,10 @@ latex2e_table_write_file_header(GsfOutput *output)
/**
* latex_table_file_save : The LaTeX2e exporter plugin function.
*
- * @FileSaver : New structure for file plugins. I don't understand.
- * @IOcontext : currently not used but reserved for the future.
- * @WorkbookView : this provides the way to access the sheet being exported.
- * @filename : where we'll write.
+ * @FileSaver: New structure for file plugins. I don't understand.
+ * @IOcontext: currently not used but reserved for the future.
+ * @WorkbookView: this provides the way to access the sheet being exported.
+ * @filename: where we'll write.
*
* This writes the top sheet of a Gnumeric workbook as the content of a latex table environment.
* We try to avoid all formatting.
diff --git a/src/cell-draw.c b/src/cell-draw.c
index b776be7..5f36eb0 100644
--- a/src/cell-draw.c
+++ b/src/cell-draw.c
@@ -68,7 +68,7 @@ cell_draw_simplify_attributes (GnmRenderedValue *rv)
* 'm' == margin
* ' ' == space for contents
*
- * @h_center : The number of pango units from x1 marking the logical center
+ * @h_center: The number of pango units from x1 marking the logical center
* of the cell. NOTE This can be asymetric. Passing
* <= 0 will use width / 2
*/
diff --git a/src/clipboard.c b/src/clipboard.c
index 45f6834..013e2bd 100644
--- a/src/clipboard.c
+++ b/src/clipboard.c
@@ -820,7 +820,7 @@ paste_target_init (GnmPasteTarget *pt, Sheet *sheet, GnmRange const *r, int flag
/**
* gnm_cell_region_new :
- * @origin_sheet : optionally NULL.
+ * @origin_sheet: optionally NULL.
*
* A convenience routine to create CellRegions and init the flags nicely.
*/
@@ -934,8 +934,8 @@ cb_invalidate_cellcopy (GnmCellCopy *cc, gconstpointer ignore,
/**
* cellregion_invalidate_sheet :
- * @cr : #GnmCellRegion
- * @sheet : #Sheet
+ * @cr: #GnmCellRegion
+ * @sheet: #Sheet
*
* Invalidate references from cell content, objects or style to @sheet.
**/
@@ -985,8 +985,8 @@ cb_cellregion_extent (GnmCellCopy *cc, gconstpointer ignore, GnmRange *extent)
/**
* cellregion_extent:
- * @cr : #GnmCellRegion
- * @extent : #GnmRange
+ * @cr: #GnmCellRegion
+ * @extent: #GnmRange
*
* Find the min and max col/row with cell content
**/
diff --git a/src/cmd-edit.c b/src/cmd-edit.c
index c9c188a..16a8491 100644
--- a/src/cmd-edit.c
+++ b/src/cmd-edit.c
@@ -376,7 +376,7 @@ cmd_paste_to_selection (WorkbookControl *wbc, SheetView *dest_sv, int paste_flag
/**
* cmd_shift_rows:
- * @wbc : The error context.
+ * @wbc: The error context.
* @sheet the sheet
* @col column marking the start of the shift
* @start_row first row
diff --git a/src/colrow.c b/src/colrow.c
index 10a8271..08f6c9d 100644
--- a/src/colrow.c
+++ b/src/colrow.c
@@ -109,7 +109,7 @@ colrow_is_default (ColRowInfo const *cri)
/**
* colrow_is_empty :
- * @cri : #ColRowInfo
+ * @cri: #ColRowInfo
*
* TRUE if there is no information in col/row @cri.
**/
@@ -126,8 +126,8 @@ colrow_is_empty (ColRowInfo const *cri)
/**
* colrow_equal :
- * @a : ColRowInfo #1
- * @b : ColRowInfo #2
+ * @a: ColRowInfo #1
+ * @b: ColRowInfo #2
*
* Returns true if the infos are equivalent.
**/
@@ -148,8 +148,8 @@ colrow_equal (ColRowInfo const *a, ColRowInfo const *b)
/**
* colrow_copy :
- * @dst :
- * @src :
+ * @dst:
+ * @src:
*
* Assign all content, except the position of @src to @dst
*/
@@ -1081,9 +1081,9 @@ colrow_set_visibility_list (Sheet *sheet, gboolean is_cols,
/**
* colrow_set_outline :
- * @cri : the col/row to tweak
- * @outline_level :
- * @is_collapsed :
+ * @cri: the col/row to tweak
+ * @outline_level:
+ * @is_collapsed:
*
* Adjust the outline state of a col/row
*/
@@ -1224,11 +1224,11 @@ colrow_set_visibility (Sheet *sheet, gboolean is_cols,
/**
* colrow_get_global_outline :
- * @sheet :
- * @is_cols :
- * @depth :
- * @show :
- * @hide :
+ * @sheet:
+ * @is_cols:
+ * @depth:
+ * @show:
+ * @hide:
*
* Collect the set of visiblity changes required to change the visiblity of
* all outlined columns such tach those > @depth are visible.
diff --git a/src/commands.c b/src/commands.c
index 9d3b3c9..ca8a08d 100644
--- a/src/commands.c
+++ b/src/commands.c
@@ -311,7 +311,7 @@ select_selection (Sheet *sheet, GSList *selection, WorkbookControl *wbc)
/**
* get_menu_label:
* with a list of commands.
- * @cmd_list : The command list to check.
+ * @cmd_list: The command list to check.
*
* Utility routine to get the descriptor associated
* Returns : A static reference to a descriptor. DO NOT free this.
@@ -510,7 +510,7 @@ command_repeat (WorkbookControl *wbc)
/**
* command_setup_combos :
- * @wbc :
+ * @wbc:
*
* Initialize the combos to correspond to the current undo/redo state.
*/
@@ -648,8 +648,8 @@ truncate_undo_info (Workbook *wb)
/**
* command_register_undo:
- * @wbc : The workbook control that issued the command.
- * @cmd : The new command to add.
+ * @wbc: The workbook control that issued the command.
+ * @cmd: The new command to add.
*
* An internal utility to tack a new command
* onto the undo list.
@@ -1827,7 +1827,7 @@ cmd_format_finalize (GObject *cmd)
* @sheet: the sheet
* @style: style to apply to the selection
* @borders: borders to apply to the selection
- * @opt_translated_name : An optional name to use in place of 'Format Cells'
+ * @opt_translated_name: An optional name to use in place of 'Format Cells'
*
* If borders is non NULL, then the GnmBorder references are passed,
* the GnmStyle reference is also passed.
@@ -6051,11 +6051,11 @@ cmd_define_name_finalize (GObject *cmd)
/**
* cmd_define_name :
- * @wbc :
- * @name :
- * @pp :
- * @texpr : absorbs a ref to the texpr.
- * @descriptor : optional descriptor.
+ * @wbc:
+ * @name:
+ * @pp:
+ * @texpr: absorbs a ref to the texpr.
+ * @descriptor: optional descriptor.
*
* If the @name has never been defined in context @pp create a new name
* If its a placeholder assign @texpr to it and make it real
@@ -6206,8 +6206,8 @@ cmd_remove_name_finalize (GObject *cmd)
/**
* cmd_remove_name :
- * @wbc :
- * @nexpr : name to remove.
+ * @wbc:
+ * @nexpr: name to remove.
*
* Returns TRUE on error
**/
@@ -6285,8 +6285,8 @@ cmd_rescope_name_finalize (GObject *cmd)
/**
* cmd_rescope_name :
- * @wbc :
- * @nexpr : name to rescope.
+ * @wbc:
+ * @nexpr: name to rescope.
*
* Returns TRUE on error
**/
@@ -6803,10 +6803,10 @@ cmd_freeze_panes_finalize (GObject *cmd)
/**
* cmd_freeze_panes :
- * @wbc : where to report errors
- * @sv : the view to freeze
- * @frozen :
- * @unfrozen :
+ * @wbc: where to report errors
+ * @sv: the view to freeze
+ * @frozen:
+ * @unfrozen:
*
* Returns TRUE on error
**/
diff --git a/src/dependent.c b/src/dependent.c
index 92edad4..5aa49ee 100644
--- a/src/dependent.c
+++ b/src/dependent.c
@@ -344,7 +344,7 @@ dependent_types_shutdown (void)
/**
* dependent_register_type :
- * @klass : A vtable
+ * @klass: A vtable
*
* Store the vtable and allocate an ID for a new class
* of dependents.
@@ -376,7 +376,7 @@ dependent_type_register (GnmDependentClass const *klass)
/**
* dependent_changed:
- * @cell : the dependent that changed
+ * @cell: the dependent that changed
*
* Queues a recalc.
*/
@@ -501,7 +501,7 @@ dependent_queue_recalc_main (GSList *work)
/**
* dependent_queue_recalc_list :
- * @list :
+ * @list:
*
* Queues any elements of @list for recalc that are not already queued,
* and marks all elements as needing a recalc.
@@ -1685,7 +1685,7 @@ iterate :
/**
* dependent_eval :
- * @dep :
+ * @dep:
*/
static void
dependent_eval (GnmDependent *dep)
@@ -1722,7 +1722,7 @@ gnm_cell_eval (GnmCell *cell)
/**
* cell_queue_recalc :
- * @cell :
+ * @cell:
*
* Queue the cell and everything that depends on it for recalculation.
* If a dependency is already queued ignore it.
@@ -1948,7 +1948,7 @@ typedef struct
/**
* dependents_unrelocate_free :
- * @info :
+ * @info:
*
* Free the undo info associated with a dependent relocation.
*/
@@ -1966,7 +1966,7 @@ dependents_unrelocate_free (GSList *info)
/**
* dependents_unrelocate :
- * @info :
+ * @info:
*
* Apply the undo info associated with a dependent relocation.
*/
@@ -2788,7 +2788,7 @@ workbook_queue_all_recalc (Workbook *wb)
/**
* workbook_recalc :
- * @wb :
+ * @wb:
*
* Computes all dependents in @wb that have been flaged as requiring
* recomputation.
@@ -2828,7 +2828,7 @@ workbook_recalc (Workbook *wb)
/**
* workbook_recalc_all :
- * @wb :
+ * @wb:
*
* Queues all dependents for recalc and recalculates.
*/
@@ -2966,7 +2966,7 @@ dependent_debug_name_for_sheet (GnmDependent const *dep, Sheet *sheet,
/**
* dependent_debug_name :
- * @dep : The dependent we are interested in.
+ * @dep: The dependent we are interested in.
*
* A useful little debugging utility.
*/
@@ -3073,7 +3073,7 @@ dump_dynamic_dep (gpointer key, G_GNUC_UNUSED gpointer value,
/**
* gnm_dep_container_dump :
- * @deps :
+ * @deps:
*
* A useful utility for checking the state of the dependency data structures.
*/
diff --git a/src/dialogs/dialog-doc-metadata.c b/src/dialogs/dialog-doc-metadata.c
index 352259d..8839a86 100644
--- a/src/dialogs/dialog-doc-metadata.c
+++ b/src/dialogs/dialog-doc-metadata.c
@@ -867,10 +867,10 @@ dialog_doc_metadata_set_gsf_prop_val (DialogDocMetaData *state,
/**
* dialog_doc_metadata_set_gsf_prop
*
- * @state : dialog main struct
- * @name : property name
- * @value : property value
- * @link : property linked to
+ * @state: dialog main struct
+ * @name: property name
+ * @value: property value
+ * @link: property linked to
*
* Sets a new value to the property in the GsfDocMetaData struct
*
@@ -971,9 +971,9 @@ dialog_doc_metadata_set_gsf_prop (DialogDocMetaData *state,
/**
* dialog_doc_metadata_set_prop
*
- * @state : dialog main struct
- * @prop_name : property name
- * @prop_value : property value
+ * @state: dialog main struct
+ * @prop_name: property name
+ * @prop_value: property value
*
* Tries to update the property value in all the dialog and in the GsfDocMetaData
* struct. If the property was not found, creates a new one.
@@ -1161,7 +1161,7 @@ cb_dialog_doc_metadata_comments_changed (GtkTextView *view,
/**
* dialog_doc_metadata_init_description_page
*
- * @state : dialog main struct
+ * @state: dialog main struct
*
* Initializes the widgets and signals for the 'Description' page.
*
@@ -1320,7 +1320,7 @@ cb_dialog_doc_metadata_keyword_edited (G_GNUC_UNUSED GtkCellRendererText *render
/**
* dialog_doc_metadata_init_keywords_page
*
- * @state : dialog main struct
+ * @state: dialog main struct
*
* Initializes the widgets and signals for the 'Description' page.
*
@@ -1399,8 +1399,8 @@ cb_dialog_doc_metadata_value_edited (G_GNUC_UNUSED GtkCellRendererText *renderer
/**
* cb_dialog_doc_metadata_add_clicked
*
- * @w : widget
- * @state : dialog main struct
+ * @w: widget
+ * @state: dialog main struct
*
* Adds a new "empty" property to the tree view.
*
@@ -1434,9 +1434,9 @@ cb_dialog_doc_metadata_add_clicked (G_GNUC_UNUSED GtkWidget *w,
/**
* dialog_doc_metadata_update_prop
*
- * @state : dialog main struct
- * @prop_name : property name
- * @prop_value : property value
+ * @state: dialog main struct
+ * @prop_name: property name
+ * @prop_value: property value
*
* Updates a label or a entry text with the new value.
*
@@ -1522,8 +1522,8 @@ dialog_doc_metadata_update_prop (DialogDocMetaData *state,
/**
* cb_dialog_doc_metadata_remove_clicked
*
- * @remove_bt : widget
- * @state : dialog main struct
+ * @remove_bt: widget
+ * @state: dialog main struct
*
* Removes a property from the tree view and updates all the dialog and
* the GsfDocMetaData struct.
@@ -1574,8 +1574,8 @@ cb_dialog_doc_metadata_remove_clicked (GtkWidget *remove_bt,
/**
* cb_dialog_doc_metadata_tree_prop_selected
*
- * @combo_box : widget
- * @state : dialog main struct
+ * @combo_box: widget
+ * @state: dialog main struct
*
* Update the highlited item in the 'Properties' page combo box.
*
@@ -1639,8 +1639,8 @@ cb_dialog_doc_metadata_tree_prop_selected (GtkTreeSelection *selection,
/**
* dialog_doc_metadata_get_prop_val
*
- * @prop_name : property name
- * @prop_value : property value
+ * @prop_name: property name
+ * @prop_value: property value
*
* Retrieves an arbitrary property value always as string.
*
@@ -1670,9 +1670,9 @@ dialog_doc_metadata_get_prop_val (G_GNUC_UNUSED DialogDocMetaData *state,
/**
* dialog_doc_metadata_populate_tree_view
*
- * @name : property name
- * @prop : property stored in GsfDocMetaData
- * @state : dialog main struct
+ * @name: property name
+ * @prop: property stored in GsfDocMetaData
+ * @state: dialog main struct
*
* Populates the tree view in 'Properties' page.
*
@@ -1844,7 +1844,7 @@ cb_dialog_doc_metadata_ppt_name_changed (G_GNUC_UNUSED GtkEntry *entry,
/**
* dialog_doc_metadata_init_properties_page
*
- * @state : dialog main struct
+ * @state: dialog main struct
*
* Initializes the widgets and signals for the 'Properties' page.
*
@@ -1982,7 +1982,7 @@ dialog_doc_metadata_init_properties_page (DialogDocMetaData *state)
/**
* dialog_doc_metadata_init_statistics_page
*
- * @state : dialog main struct
+ * @state: dialog main struct
*
* Initializes the widgets and signals for the 'Statistics' page.
*
@@ -2044,7 +2044,7 @@ cb_dialog_doc_metadata_recalc_iteration_changed (G_GNUC_UNUSED GtkWidget *widget
/**
* dialog_doc_metadata_init_calculations_page
*
- * @state : dialog main struct
+ * @state: dialog main struct
*
* Initializes the widgets and signals for the 'Calculations' page.
*
@@ -2092,7 +2092,7 @@ dialog_doc_metadata_init_calculations_page (DialogDocMetaData *state)
/**
* dialog_doc_metadata_set_file_permissions
*
- * @state : dialog main struct
+ * @state: dialog main struct
*
* Writes the new file permissions if there were any changes.
*
@@ -2428,7 +2428,7 @@ dialog_doc_metadata_init (DialogDocMetaData *state,
/**
* dialog_doc_metadata_new
*
- * @wbcg : WBCGtk
+ * @wbcg: WBCGtk
*
* Creates a new instance of the dialog.
*
diff --git a/src/dialogs/dialog-formula-guru.c b/src/dialogs/dialog-formula-guru.c
index 8fe1882..4d54f1c 100644
--- a/src/dialogs/dialog-formula-guru.c
+++ b/src/dialogs/dialog-formula-guru.c
@@ -992,7 +992,7 @@ dialog_formula_guru_show (FormulaGuruState *state)
/**
* dialog_formula_guru
- * @wbcg : The workbook to use as a parent window.
+ * @wbcg: The workbook to use as a parent window.
*
* Pop up a function selector then a formula guru.
*/
diff --git a/src/dialogs/dialog-stf-csv-page.c b/src/dialogs/dialog-stf-csv-page.c
index b48453b..6a7a773 100644
--- a/src/dialogs/dialog-stf-csv-page.c
+++ b/src/dialogs/dialog-stf-csv-page.c
@@ -32,8 +32,8 @@
/**
* csv_page_global_change
- * @widget : the widget which emitted the signal
- * @data : mother struct
+ * @widget: the widget which emitted the signal
+ * @data: mother struct
*
* This will update the preview based on the state of
* the widgets on the csv page
@@ -100,8 +100,8 @@ csv_page_global_change (G_GNUC_UNUSED GtkWidget *widget,
/**
* csv_page_custom_toggled
- * @button : the Checkbutton that emitted the signal
- * @data : a mother struct
+ * @button: the Checkbutton that emitted the signal
+ * @data: a mother struct
*
* This will nicely activate the @data->csv_info->csv_customseparator widget
* so the user can enter text into it.
@@ -196,7 +196,7 @@ csv_page_parseoptions_to_gui (StfDialogData *pagedata)
/**
* stf_dialog_csv_page_prepare
- * @data : mother struct
+ * @data: mother struct
*
* Will prepare the csv page
*
@@ -217,7 +217,7 @@ stf_dialog_csv_page_prepare (StfDialogData *pagedata)
/**
* stf_dialog_csv_page_cleanup
- * @pagedata : mother struct
+ * @pagedata: mother struct
*
* Will cleanup csv page run-time data
*
diff --git a/src/dialogs/dialog-stf-export.c b/src/dialogs/dialog-stf-export.c
index 4c7f0e2..171d17f 100644
--- a/src/dialogs/dialog-stf-export.c
+++ b/src/dialogs/dialog-stf-export.c
@@ -697,9 +697,9 @@ cb_next_page (TextExportState *state)
/**
* stf_dialog
- * @wbcg : #WBCGtk (can be NULL)
- * @stfe : An exporter to set up (and take defaults from)
- * @wb : The #Workbook to export
+ * @wbcg: #WBCGtk (can be NULL)
+ * @stfe: An exporter to set up (and take defaults from)
+ * @wb: The #Workbook to export
*
* This will start the export assistant.
* returns : TRUE if cancelled.
diff --git a/src/dialogs/dialog-stf-fixed-page.c b/src/dialogs/dialog-stf-fixed-page.c
index de014b3..8b2b9be 100644
--- a/src/dialogs/dialog-stf-fixed-page.c
+++ b/src/dialogs/dialog-stf-fixed-page.c
@@ -368,7 +368,7 @@ cb_col_key_press (GtkWidget *button,
/**
* fixed_page_update_preview
- * @pagedata : mother struct
+ * @pagedata: mother struct
*
* Will simply update the preview
*
@@ -458,7 +458,7 @@ fixed_page_auto_clicked (G_GNUC_UNUSED GtkButton *button,
/**
* stf_dialog_fixed_page_prepare
- * @data : mother struct
+ * @data: mother struct
*
* Will prepare the fixed page
*
@@ -591,7 +591,7 @@ cb_treeview_draw_2 (GtkWidget *widget,
/**
* stf_dialog_fixed_page_cleanup
- * @pagedata : mother struct
+ * @pagedata: mother struct
*
* Will cleanup fixed page run-time data
*
diff --git a/src/dialogs/dialog-stf-format-page.c b/src/dialogs/dialog-stf-format-page.c
index 7ea69da..cab05db 100644
--- a/src/dialogs/dialog-stf-format-page.c
+++ b/src/dialogs/dialog-stf-format-page.c
@@ -529,7 +529,7 @@ cb_treeview_key_press (GtkWidget *treeview,
/**
* format_page_update_preview
- * @pagedata : mother struct
+ * @pagedata: mother struct
*
* Will simply utilize the preview rendering functions to update
* the preview
@@ -693,7 +693,7 @@ locale_changed_cb (GOLocaleSel *ls, char const *new_locale,
/**
* stf_dialog_format_page_prepare
- * @data : mother struct
+ * @data: mother struct
*
* This will prepare the widgets on the format page before
* the page gets displayed
diff --git a/src/dialogs/dialog-stf-main-page.c b/src/dialogs/dialog-stf-main-page.c
index 974d92b..ea222a2 100644
--- a/src/dialogs/dialog-stf-main-page.c
+++ b/src/dialogs/dialog-stf-main-page.c
@@ -106,9 +106,9 @@ main_page_update_preview (StfDialogData *pagedata)
/**
* main_page_set_spin_button_adjustment
- * @spinbutton : the spinbutton to adjust
- * @min : the minimum number the user may enter into the spinbutton
- * @max : the maximum number the user may enter into the spinbutton
+ * @spinbutton: the spinbutton to adjust
+ * @min: the minimum number the user may enter into the spinbutton
+ * @max: the maximum number the user may enter into the spinbutton
*
* returns : nothing
**/
@@ -124,7 +124,7 @@ main_page_set_spin_button_adjustment (GtkSpinButton* spinbutton, int min, int ma
/**
* main_page_import_range_changed
- * @data : mother struct
+ * @data: mother struct
*
* Updates the "number of lines to import" label on the main page
*
@@ -196,8 +196,8 @@ encodings_changed_cb (GOCharmapSel *cs, char const *new_charmap,
/**
* main_page_startrow_changed
- * @button : the spinbutton the event handler is attached to
- * @data : mother struct
+ * @button: the spinbutton the event handler is attached to
+ * @data: mother struct
*
* This function will adjust the amount of displayed text to
* reflect the number of lines the user wants to import
@@ -212,8 +212,8 @@ main_page_startrow_changed (GtkSpinButton* button, StfDialogData *data)
/**
* main_page_stoprow_changed
- * @button : the spinbutton the event handler is attached to
- * @data : mother struct
+ * @button: the spinbutton the event handler is attached to
+ * @data: mother struct
*
* returns : nothing
**/
@@ -263,7 +263,7 @@ cb_line_breaks (G_GNUC_UNUSED GtkWidget *widget,
/**
* stf_dialog_main_page_prepare
- * @data : mother struct
+ * @data: mother struct
*
* This will prepare the widgets on the format page before
* the page gets displayed
diff --git a/src/dialogs/dialog-stf-preview.c b/src/dialogs/dialog-stf-preview.c
index 02d08de..284e8dc 100644
--- a/src/dialogs/dialog-stf-preview.c
+++ b/src/dialogs/dialog-stf-preview.c
@@ -141,7 +141,7 @@ stf_preview_new (GtkWidget *data_container,
/**
* stf_preview_free
- * @renderdata : a renderdata struct
+ * @renderdata: a renderdata struct
*
* This will free the @renderdata
*
@@ -243,7 +243,7 @@ stf_preview_set_lines (RenderData_t *renderdata,
/**
* stf_preview_colformats_clear
- * @renderdata : a struct containing rendering information
+ * @renderdata: a struct containing rendering information
*
* This will clear the @renderdata->colformats array which contains the format of
* each column.
@@ -264,8 +264,8 @@ stf_preview_colformats_clear (RenderData_t *renderdata)
/**
* stf_preview_colformats_add
- * @renderdata : a struct containing rendering information
- * @format : the format of the column
+ * @renderdata: a struct containing rendering information
+ * @format: the format of the column
*
* This will add an entry to the @renderdata->colformats array.
* The widths of the columns will be set to at least have the width of
diff --git a/src/expr-name.c b/src/expr-name.c
index 1ba3bf9..d8ebc83 100644
--- a/src/expr-name.c
+++ b/src/expr-name.c
@@ -456,8 +456,8 @@ expr_name_handle_references (GnmNamedExpr *nexpr, gboolean add)
/**
* expr_name_lookup:
- * @pos :
- * @name :
+ * @pos:
+ * @name:
*
* lookup but do not reference a named expression.
*/
@@ -747,7 +747,7 @@ gnm_named_expr_get_type (void)
/**
* expr_name_remove :
- * @nexpr :
+ * @nexpr:
*
* Remove a @nexpr from its container and deactivate it.
* NOTE : @nexpr may continue to exist if things still have references to it,
@@ -779,8 +779,8 @@ expr_name_name (GnmNamedExpr const *nexpr)
/**
* expr_name_set_name :
- * @nexpr : the named expression
- * @new_name : the new name of the expression
+ * @nexpr: the named expression
+ * @new_name: the new name of the expression
*
* returns: TRUE on error.
*/
@@ -830,8 +830,8 @@ expr_name_set_name (GnmNamedExpr *nexpr,
/**
* expr_name_as_string :
- * @nexpr :
- * @pp : optionally null.
+ * @nexpr:
+ * @pp: optionally null.
*
* returns a string that the caller needs to free.
*/
@@ -919,8 +919,8 @@ expr_name_set_pos (GnmNamedExpr *nexpr, GnmParsePos const *pp)
/**
* expr_name_set_expr :
- * @nexpr : the named expression
- * @texpr : the new content
+ * @nexpr: the named expression
+ * @texpr: the new content
*
* Unrefs the current content of @nexpr and absorbs a ref to @new_expr.
**/
@@ -989,7 +989,7 @@ expr_name_remove_dep (GnmNamedExpr *nexpr, GnmDependent *dep)
/**
* expr_name_is_placeholder :
- * @ne :
+ * @ne:
*
* Returns TRUE if @ne is a placeholder for an unknown name
**/
@@ -1106,8 +1106,8 @@ expr_name_cmp_by_name (GnmNamedExpr const *a, GnmNamedExpr const *b)
/**
* sheet_names_check :
- * @sheet :
- * @r :
+ * @sheet:
+ * @r:
*
* Returns a constant string if @sheet! r is the target of a named range.
* Preference is given to workbook scope over sheet.
diff --git a/src/expr.c b/src/expr.c
index d87bedc..7be26f8 100644
--- a/src/expr.c
+++ b/src/expr.c
@@ -69,7 +69,7 @@ static GOMemChunk *expression_pool_small, *expression_pool_big;
/**
* gnm_expr_new_constant :
- * @v :
+ * @v:
*
* Absorbs the value.
**/
@@ -274,9 +274,9 @@ gnm_expr_is_array (GnmExpr const *expr)
/**
* gnm_expr_new_array_corner :
- * @cols :
- * @rows :
- * @expr : optionally NULL.
+ * @cols:
+ * @rows:
+ * @expr: optionally NULL.
*
* Absorb a referernce to @expr if it is non NULL.
**/
@@ -724,8 +724,8 @@ handle_empty (GnmValue *res, GnmExprEvalFlags flags)
/**
* value_intersection :
- * @v : a VALUE_CELLRANGE or VALUE_ARRAY
- * @pos :
+ * @v: a VALUE_CELLRANGE or VALUE_ARRAY
+ * @pos:
*
* Handle the implicit union of a single row or column with the eval position.
*
@@ -1214,8 +1214,8 @@ gnm_expr_range_op (GnmExpr const *expr, GnmEvalPos const *ep,
/**
* gnm_expr_eval :
- * @expr :
- * @pos :
+ * @expr:
+ * @pos:
* @flags:
*
* if GNM_EXPR_EVAL_PERMIT_EMPTY is not set then return int(0) if the
@@ -2451,7 +2451,7 @@ do_referenced_sheets (GnmExpr const *expr, GSList *sheets)
/**
* gnm_expr_containts_subtotal :
- * @expr :
+ * @expr:
*
* return TRUE if the expression calls the SUBTOTAL function
**/
@@ -2561,7 +2561,7 @@ gnm_expr_get_boundingbox (GnmExpr const *expr, Sheet const *sheet,
/**
* gnm_expr_get_range:
- * @expr :
+ * @expr:
*
* If this expression contains a single range return it.
* Caller is responsible for value_releasing the result.
@@ -2657,7 +2657,7 @@ do_gnm_expr_get_ranges (GnmExpr const *expr, GSList *ranges)
/**
* gnm_expr_is_rangeref :
- * @expr :
+ * @expr:
*
* Returns TRUE if the expression can generate a reference.
* NOTE : in the future it would be nice to know if a function
@@ -2993,7 +2993,7 @@ gnm_expr_top_new_array_elem (int x, int y)
/**
* gnm_expr_top_get_ranges:
- * @texpr :
+ * @texpr:
*
* A collect the set of GnmRanges in @expr.
* Returns: (element-type GnmRange) (transfer full): a list of the unique
@@ -3068,9 +3068,9 @@ gnm_expr_top_equal (GnmExprTop const *te1, GnmExprTop const *te2)
/*
* gnm_expr_top_relocate :
- * @texpr : #GnmExprTop to fixup
- * @rinfo : #GnmExprRelocateInfo details of relocation
- * @ignore_rel : Do not adjust relative refs (for internal use when
+ * @texpr: #GnmExprTop to fixup
+ * @rinfo: #GnmExprRelocateInfo details of relocation
+ * @ignore_rel: Do not adjust relative refs (for internal use when
* relocating named expressions. Most callers will want FALSE.
*
* GNM_EXPR_RELOCATE_INVALIDATE_SHEET :
@@ -3200,7 +3200,7 @@ gnm_expr_top_is_err (GnmExprTop const *texpr, GnmStdError err)
/**
* gnm_expr_top_get_constant:
- * @texpr :
+ * @texpr:
*
* If this expression consists of just a constant, return it.
*/
@@ -3228,7 +3228,7 @@ gnm_expr_top_get_cellref (GnmExprTop const *texpr)
/**
* gnm_expr_top_first_funcall :
- * @texpr :
+ * @texpr:
*
*/
GnmExpr const *
diff --git a/src/format-template.c b/src/format-template.c
index 5d19c21..5eee565 100644
--- a/src/format-template.c
+++ b/src/format-template.c
@@ -694,7 +694,7 @@ typedef void (* PCalcCallback) (GnmFormatTemplate *ft, GnmRange *r, GnmStyle *ms
* format_template_range_check:
* @ft: Format template
* @r: Target range
- * @optional_cc : if non-NULL display an error message if @r is not
+ * @optional_cc: if non-NULL display an error message if @r is not
* appropriate for @ft.
*
* Check whether range @r is big enough to apply format template @ft to it.
diff --git a/src/func.c b/src/func.c
index e1c920f..61c16eb 100644
--- a/src/func.c
+++ b/src/func.c
@@ -213,8 +213,8 @@ dump_externals (GPtrArray *defs, FILE *out)
/**
* function_dump_defs :
- * @filename :
- * @dump_type :
+ * @filename:
+ * @dump_type:
*
* A generic utility routine to operate on all funtion defs
* in various ways. @dump_type will change/extend as needed
@@ -1718,7 +1718,7 @@ free_values (GnmValue **values, int top)
/**
* function_call_with_exprs:
* @ei: EvalInfo containing valid fn_def!
- * @flags :
+ * @flags:
*
* Do the guts of calling a function.
*
diff --git a/src/gnm-data-cache-source.c b/src/gnm-data-cache-source.c
index 34f2d81..dd9bcb7 100644
--- a/src/gnm-data-cache-source.c
+++ b/src/gnm-data-cache-source.c
@@ -187,9 +187,9 @@ GSF_CLASS_FULL (GnmDataCacheSource, gnm_data_cache_source, NULL, NULL,
/**
* gnm_data_cache_source_new:
- * @src_sheet : #Sheet
- * @src_range : #GnmRange
- * @src_name : char *, optionally %NULL
+ * @src_sheet: #Sheet
+ * @src_range: #GnmRange
+ * @src_name: char *, optionally %NULL
*
* Allocates a new Allocates a new #GnmDataCacheSource
*
diff --git a/src/gnm-format.c b/src/gnm-format.c
index 2366323..bf77536 100644
--- a/src/gnm-format.c
+++ b/src/gnm-format.c
@@ -198,11 +198,11 @@ gnm_format_layout (PangoLayout *layout,
/**
* format_value_gstring :
- * @str : append the result here.
- * @format : #GOFormat.
- * @value : #GnmValue to convert
- * @col_width : optional
- * @date_conv : #GODateConventions.
+ * @str: append the result here.
+ * @format: #GOFormat.
+ * @value: #GnmValue to convert
+ * @col_width: optional
+ * @date_conv: #GODateConventions.
*
**/
GOFormatNumberError
@@ -233,11 +233,11 @@ format_value_gstring (GString *str,
/**
* format_value_layout :
- * @layout :
- * @format : #GOFormat.
- * @value : #GnmValue to convert
+ * @layout:
+ * @format: #GOFormat.
+ * @value: #GnmValue to convert
* col_width : optional
- * @date_conv : #GODateConventions.
+ * @date_conv: #GODateConventions.
*
**/
GOFormatNumberError
diff --git a/src/gnm-pane.c b/src/gnm-pane.c
index a3aeb0a..84720c4 100644
--- a/src/gnm-pane.c
+++ b/src/gnm-pane.c
@@ -1318,7 +1318,7 @@ gnm_pane_find_row (GnmPane const *pane, gint64 y, gint64 *row_origin)
* gnm_pane_compute_visible_region : Keeps the top left col/row the same and
* recalculates the visible boundaries.
*
- * @full_recompute :
+ * @full_recompute:
* if TRUE recompute the pixel offsets of the top left row/col
* else assumes that the pixel offsets of the top left have not changed.
*/
diff --git a/src/gnm-sheet-slicer.c b/src/gnm-sheet-slicer.c
index 5fd9d22..3917e1f 100644
--- a/src/gnm-sheet-slicer.c
+++ b/src/gnm-sheet-slicer.c
@@ -238,8 +238,8 @@ gnm_sheet_slicer_set_range (GnmSheetSlicer *gss, GnmRange const *r)
/**
* gnm_sheet_slicer_overlaps_range :
- * @gss : #GnmSheetSlicer
- * @r : #GnmRange
+ * @gss: #GnmSheetSlicer
+ * @r: #GnmRange
*
* Returns: %TRUE if @gss overlaps @r.
**/
@@ -252,8 +252,8 @@ gnm_sheet_slicer_overlaps_range (GnmSheetSlicer const *gss, GnmRange const *r)
/**
* gnm_sheet_slicer_field_header_at_pos :
- * @gss : #GnmSheetSlicer const
- * @pos : #GnmCellPos const
+ * @gss: #GnmSheetSlicer const
+ * @pos: #GnmCellPos const
*
* Checks to see if @pos (in absolute position, not relative to @gss' corner)
* corresponds to a field header. [Does not add a reference]
diff --git a/src/go-data-cache.c b/src/go-data-cache.c
index 7af9d98..827b96a 100644
--- a/src/go-data-cache.c
+++ b/src/go-data-cache.c
@@ -216,8 +216,8 @@ go_data_cache_get_source (GODataCache const *cache)
/**
* go_data_cache_set_source :
- * @cache : #GODataCache
- * @src : #GODataCacheSource
+ * @cache: #GODataCache
+ * @src: #GODataCacheSource
*
* Absorbs the reference to @src.
**/
@@ -248,8 +248,8 @@ go_data_cache_add_field (GODataCache *cache, GODataCacheField *field)
/**
* go_data_cache_import_start :
- * @cache :#GODataCache
- * @n : num records
+ * @cache:#GODataCache
+ * @n: num records
*
* Validate the field setup and initialize the storage.
**/
@@ -390,8 +390,8 @@ go_data_cache_set_index (GODataCache *cache,
/**
* go_data_cache_import_done :
- * @cache : #GODataCache
- * @actual_records : count
+ * @cache: #GODataCache
+ * @actual_records: count
*
* Tidy up after an import, and tighten up the amount of memory used to store
* the records.
@@ -504,9 +504,9 @@ cb_go_data_cache_cmp (int const *a, int const * b,
/**
* go_data_cache_permute:
- * @cache : #GODataCache
- * @field_order : #GArray of unsigned int
- * @permutation : #GArray of unsigned int that will be re-ordered according to the fields.
+ * @cache: #GODataCache
+ * @field_order: #GArray of unsigned int
+ * @permutation: #GArray of unsigned int that will be re-ordered according to the fields.
*
**/
void
diff --git a/src/go-data-slicer-field.c b/src/go-data-slicer-field.c
index a635575..5e373e4 100644
--- a/src/go-data-slicer-field.c
+++ b/src/go-data-slicer-field.c
@@ -140,7 +140,7 @@ GSF_CLASS (GODataSlicerField, go_data_slicer_field,
/**
* go_data_slicer_field_get_cache_field :
- * @dsf : #GODataSlicerField const
+ * @dsf: #GODataSlicerField const
*
* Returns : the underlying cache field
**/
@@ -154,7 +154,7 @@ go_data_slicer_field_get_cache_field (GODataSlicerField const *dsf)
/**
* go_data_slicer_field_get_name :
- * @dsf : #GODataSlicerField const
+ * @dsf: #GODataSlicerField const
*
* If @dsf has a name return that, otherwise default to the name of the
* underlying cache field. If there is a need (e.g. for export) to get the
@@ -184,9 +184,9 @@ go_data_slicer_field_get_field_type_pos (GODataSlicerField const *dsf,
/**
* go_data_slicer_field_set_field_type_pos :
- * @dsf : #GODataSlicerField
- * @field_type : #GODataSlicerFieldType
- * @pos : >= len => append, else move ahead of @pos, -1 removes
+ * @dsf: #GODataSlicerField
+ * @field_type: #GODataSlicerFieldType
+ * @pos: >= len => append, else move ahead of @pos, -1 removes
*
* Make @dsf a @field_type, and move it to position @pos other @field_type's
* in the slicer.
diff --git a/src/go-data-slicer.c b/src/go-data-slicer.c
index 0549b76..f579672 100644
--- a/src/go-data-slicer.c
+++ b/src/go-data-slicer.c
@@ -124,7 +124,7 @@ GSF_CLASS (GODataSlicer, go_data_slicer,
/**
* go_data_slicer_get_cache :
- * @ds : #GODataSlicer
+ * @ds: #GODataSlicer
*
* Does not add a reference.
*
@@ -139,8 +139,8 @@ go_data_slicer_get_cache (GODataSlicer const *ds)
/**
* go_data_slicer_set_cache:
- * @ds : #GODataSlicer
- * @cache : #GODataCache
+ * @ds: #GODataSlicer
+ * @cache: #GODataCache
*
* Assign @cache to @ds, and adds a reference to @cache
**/
diff --git a/src/go-val.c b/src/go-val.c
index e1fa31e..d8f1a9d 100644
--- a/src/go-val.c
+++ b/src/go-val.c
@@ -77,8 +77,8 @@ go_val_bucketer_validate (GOValBucketer *bucketer)
/**
* go_val_bucketer_apply :
- * @bucketer : #GOValBucketer
- * @v : #GOVal
+ * @bucketer: #GOValBucketer
+ * @v: #GOVal
*
* Calculate which bucket @v falls into.
*
diff --git a/src/gui-util.c b/src/gui-util.c
index 1d3c93a..799e2b3 100644
--- a/src/gui-util.c
+++ b/src/gui-util.c
@@ -454,8 +454,8 @@ kill_popup_menu (G_GNUC_UNUSED GtkWidget *widget, GtkMenu *menu)
/**
* gnumeric_popup_menu :
- * @menu : #GtkMenu
- * @event : #GdkEventButton optionally NULL
+ * @menu: #GtkMenu
+ * @event: #GdkEventButton optionally NULL
*
* Bring up a popup and if @event is non-NULL ensure that the popup is on the
* right screen.
diff --git a/src/input-msg.c b/src/input-msg.c
index f04c14a..18d660b 100644
--- a/src/input-msg.c
+++ b/src/input-msg.c
@@ -74,8 +74,8 @@ GSF_CLASS (GnmInputMsg, gnm_input_msg,
/**
* gnm_input_msg_new :
- * @msg :
- * @title :
+ * @msg:
+ * @title:
*
* Returns: a ref to new #GnmInputMsg.
**/
diff --git a/src/item-bar.c b/src/item-bar.c
index df53ad0..b0871de 100644
--- a/src/item-bar.c
+++ b/src/item-bar.c
@@ -718,12 +718,12 @@ item_bar_distance (GocItem *item, double x, double y,
/**
* is_pointer_on_division :
- * @ib : #GnmItemBar
- * @x : in world coords
- * @y : in world coords
- * @the_total :
- * @the_element :
- * @minor_pos :
+ * @ib: #GnmItemBar
+ * @x: in world coords
+ * @y: in world coords
+ * @the_total:
+ * @the_element:
+ * @minor_pos:
*
* NOTE : this could easily be optimized. We need not start at 0 every time.
* We could potentially use the routines in gnm-pane.
diff --git a/src/mstyle.c b/src/mstyle.c
index 0ab8899..d975692 100644
--- a/src/mstyle.c
+++ b/src/mstyle.c
@@ -505,9 +505,9 @@ elem_clear_contents (GnmStyle *style, GnmStyleElement elem)
/**
* gnm_style_find_conflicts :
- * @accum : accumulator #GnmStyle
- * @overlay : #GnmStyle
- * @conflicts : flags
+ * @accum: accumulator #GnmStyle
+ * @overlay: #GnmStyle
+ * @conflicts: flags
*
* Copy any items from @overlay that do not conflict with the values in @accum.
* If an element had a previous conflict (flagged via @conflicts) it is ignored.
@@ -665,8 +665,8 @@ gnm_style_dup (GnmStyle const *src)
/**
* gnm_style_new_merged :
- * @base : #GnmStyle
- * @overlay : #GnmStyle
+ * @base: #GnmStyle
+ * @overlay: #GnmStyle
*
* A new GnmStyle that contains any elements of @overlay that are set, and uses
* @base for anything that is not set in @overlay.
@@ -706,7 +706,7 @@ gnm_style_ref (GnmStyle const *style)
/**
* gnm_style_unref :
- * @style : #GnmStyle const
+ * @style: #GnmStyle const
*
* Unrefs and _potentially frees_ @style.
* Takes a _const_ pointer to facilitate life cycles. The const indicates that
@@ -863,8 +863,8 @@ gnm_style_linked_sheet_changed (GnmStyle *style)
/**
* gnm_style_link_sheet :
- * @style :
- * @sheet :
+ * @style:
+ * @sheet:
*
* ABSORBS a reference to the style and sets the link count to 1.
*
@@ -1082,9 +1082,9 @@ gnm_style_cmp (GnmStyle const *a, GnmStyle const *b)
/**
* gnm_style_equal_header :
- * @a : #GnmStyle
- * @b : #GnmStyle
- * @top : is this a header vertically or horizontally
+ * @a: #GnmStyle
+ * @b: #GnmStyle
+ * @top: is this a header vertically or horizontally
*
* Check to see if @a is different enough from @b to make us think that @a is
* from a header.
@@ -1116,7 +1116,7 @@ gnm_style_is_element_set (GnmStyle const *style, GnmStyleElement elem)
/**
* gnm_style_is_complete :
- * @style : #GnmStyle
+ * @style: #GnmStyle
*
* Returns TRUE if all elements are set.
**/
@@ -1142,8 +1142,8 @@ gnm_style_unset_element (GnmStyle *style, GnmStyleElement elem)
/**
* gnm_style_merge :
- * @base : #GnmStyle
- * @overlay : #GnmStyle
+ * @base: #GnmStyle
+ * @overlay: #GnmStyle
*
* Applies all active elements of @overlay onto @base.
**/
@@ -1204,8 +1204,8 @@ gnm_style_set_font_color (GnmStyle *style, GnmColor *col)
/**
* gnm_style_set_back_color :
- * @style : #GnmStyle
- * @col : #GnmColor
+ * @style: #GnmStyle
+ * @col: #GnmColor
*
* Assigns @col as the background of @style.
*
@@ -1974,7 +1974,7 @@ add_attr (PangoAttrList *attrs, PangoAttribute *attr)
/**
* gnm_style_get_pango_attrs :
- * @style : #GnmStyle
+ * @style: #GnmStyle
**/
PangoAttrList *
gnm_style_get_pango_attrs (GnmStyle const *style,
diff --git a/src/parse-util.c b/src/parse-util.c
index 07b098a..188dc32 100644
--- a/src/parse-util.c
+++ b/src/parse-util.c
@@ -254,9 +254,9 @@ wb_rel_uri (Workbook *wb, Workbook *ref_wb)
/**
* cellref_as_string :
- * @out : #GnmConventionsOut
- * @cell_ref :
- * @no_sheetname :
+ * @out: #GnmConventionsOut
+ * @cell_ref:
+ * @no_sheetname:
*
* Returns a string that the caller needs to free containing the A1 format
* representation of @ref as evaluated at @pp. @no_sheetname can be used to
@@ -311,8 +311,8 @@ cellref_as_string (GnmConventionsOut *out,
/**
* rangeref_as_string :
- * @out : #GnmConventionsOut
- * @ref : #GnmRangeRef
+ * @out: #GnmConventionsOut
+ * @ref: #GnmRangeRef
*
**/
void
@@ -420,8 +420,8 @@ rangeref_as_string (GnmConventionsOut *out, GnmRangeRef const *ref)
/**
* gnm_1_0_rangeref_as_string :
- * @out : #GnmConventionsOut
- * @ref : #GnmRangeRef
+ * @out: #GnmConventionsOut
+ * @ref: #GnmRangeRef
*
* Simplified variant of rangeref_as_string that old versions of gnumeric can
* read. It drops support for full col/row references. We can remap them on
@@ -885,9 +885,9 @@ unquote (char *dst, char const *src, int n)
/**
* wbref_parse :
- * @convs : #GnmConventions const
- * @start :
- * @wb :
+ * @convs: #GnmConventions const
+ * @start:
+ * @wb:
*
* Returns : NULL if there is a valid workbook name but it is unknown.
* If the string is a valid workbook known name it returns a pointer
@@ -935,11 +935,11 @@ wbref_parse (GnmConventions const *convs,
/**
* sheetref_parse :
- * @convs :
- * @start :
- * @sheet :
- * @wb :
- * @allow_3d :
+ * @convs:
+ * @start:
+ * @sheet:
+ * @wb:
+ * @allow_3d:
*
* Returns : NULL if there is a valid sheet name but it is unknown.
* If the string is a valid sheet name it returns a pointer
@@ -1097,9 +1097,9 @@ r1c1_rangeref_parse (GnmRangeRef *res, char const *ptr, GnmParsePos const *pp)
/**
* rangeref_parse :
- * @res : where to store the result
- * @start : the start of the string to parse
- * @pp : the location to parse relative to
+ * @res: where to store the result
+ * @start: the start of the string to parse
+ * @pp: the location to parse relative to
* @convs: #GnmConventions
*
* Returns a pointer to the first invalid character.
@@ -1421,7 +1421,7 @@ std_string_parser (char const *in, GString *target,
/**
* gnm_conventions_new_full :
- * @size :
+ * @size:
*
* Construct a GnmConventions of @size.
*
@@ -1481,7 +1481,7 @@ gnm_conventions_new (void)
/**
* gnm_conventions_unref :
- * @c : #GnmConventions
+ * @c: #GnmConventions
*
* Release a convention
**/
diff --git a/src/print-info.c b/src/print-info.c
index 4842bb2..a03ee7f 100644
--- a/src/print-info.c
+++ b/src/print-info.c
@@ -1353,8 +1353,8 @@ print_info_get_page_setup (PrintInformation *pi)
/**
* print_info_set_page_setup :
- * @pi : #PrintInformation
- * @page_setup : #GtkPageSetup
+ * @pi: #PrintInformation
+ * @page_setup: #GtkPageSetup
*
* Absorb a ref to @page_setup.
*
@@ -1408,8 +1408,8 @@ print_info_set_paper_orientation (PrintInformation *pi,
/**
* print_info_set_breaks :
- * @pi : #PrintInformation
- * @breaks : #GnmPageBreaks
+ * @pi: #PrintInformation
+ * @breaks: #GnmPageBreaks
*
* NOTE : Takes ownership of @breaks. DO NOT FREE after calling.
**/
@@ -1444,7 +1444,7 @@ print_info_has_manual_breaks (PrintInformation *pi)
/**
* gnm_page_breaks_new :
- * @is_vert :
+ * @is_vert:
*
* Allocate a collection of page breaks.
**/
@@ -1655,7 +1655,7 @@ gnm_page_breaks_set_break (GnmPageBreaks *breaks,
/**
* gnm_page_break_type_from_str:
- * @str :
+ * @str:
*
**/
GnmPageBreakType
diff --git a/src/print.c b/src/print.c
index dd326f1..fc2d63c 100644
--- a/src/print.c
+++ b/src/print.c
@@ -469,7 +469,7 @@ print_hf_line (GtkPrintContext *context, cairo_t *cr, Sheet const *sheet,
/**
* print_page:
* @pj: printing context
- * @gsr : the page information
+ * @gsr: the page information
*
* Excel prints repeated rows like this: Pages up to and including the page
* where the first of the repeated rows "naturally" occurs are printed in
diff --git a/src/ranges.c b/src/ranges.c
index aa07e35..69a421e 100644
--- a/src/ranges.c
+++ b/src/ranges.c
@@ -131,8 +131,8 @@ range_init (GnmRange *r, int start_col, int start_row,
/**
* range_parse :
- * @r : #GnmRange
- * @text :
+ * @r: #GnmRange
+ * @text:
*
* Parse a simple range (no abs/rel refs, no sheet refs)
* Store the result in @res.
@@ -568,9 +568,9 @@ range_is_singleton (GnmRange const *r)
/**
* range_is_full :
- * @r : the range.
- * @sheet : the sheet in which @r lives
- * @horiz : TRUE to check for a horizontal full ref (_cols_ [0..MAX))
+ * @r: the range.
+ * @sheet: the sheet in which @r lives
+ * @horiz: TRUE to check for a horizontal full ref (_cols_ [0..MAX))
*
* This determines whether @r completely spans a sheet
* in the dimension specified by @horiz.
@@ -590,8 +590,8 @@ range_is_full (GnmRange const *r, Sheet const *sheet, gboolean horiz)
/**
* range_clip_to_finite :
- * @range :
- * @sheet : the sheet in which @range lives
+ * @range:
+ * @sheet: the sheet in which @range lives
*
* Clip the range to the area of the sheet with content.
* if the range reaches the edge
@@ -668,8 +668,8 @@ range_translate (GnmRange *range, Sheet const *sheet, int col_offset, int row_of
/**
* range_ensure_sanity :
- * @range : the range to check
- * @sheet : the sheet in which @range lives
+ * @range: the range to check
+ * @sheet: the sheet in which @range lives
*
* Silently clip a range to ensure that it does not contain areas
* outside the valid bounds. Does NOT fix inverted ranges.
@@ -686,7 +686,7 @@ range_ensure_sanity (GnmRange *range, Sheet const *sheet)
/**
* range_is_sane :
- * @range : the range to check
+ * @range: the range to check
*
* Generate warnings if the range is out of bounds or inverted.
**/
@@ -808,8 +808,8 @@ gnm_sheet_range_dup (GnmSheetRange const *sr)
/**
* gnm_sheet_range_from_value :
- * @r :
- * @v :
+ * @r:
+ * @v:
*
* Convert @v into a GnmSheetRange and return in @r
**/
diff --git a/src/sheet-control-gui.c b/src/sheet-control-gui.c
index 3ddff72..5880918 100644
--- a/src/sheet-control-gui.c
+++ b/src/sheet-control-gui.c
@@ -443,7 +443,7 @@ scg_resize_virt (SheetControl *sc, gboolean force_scroll)
/**
* scg_scrollbar_config :
- * @sc :
+ * @sc:
*
* Manages the scrollbar dimensions and paging parameters.
* Currently sizes things based on the cols/rows visible in pane-0. This has
@@ -2557,8 +2557,8 @@ cb_scg_object_unselect (SheetObject *so, double *coords, SheetControlGUI *scg)
/**
* scg_object_unselect :
- * @scg : #SheetControlGUI
- * @so : #SheetObject (optionally NULL)
+ * @scg: #SheetControlGUI
+ * @so: #SheetObject (optionally NULL)
*
* unselect the supplied object, and drop out of edit mode if this is the last
* one. If @so == NULL unselect _all_ objects.
@@ -2747,12 +2747,12 @@ cb_drag_selected_objects (SheetObject *so, double *coords, ObjDragInfo *info)
/**
* scg_objects_drag :
- * @scg : #SheetControlGUI
- * @primary : #SheetObject (optionally NULL)
- * @dx :
- * @dy :
- * @drag_type :
- * @symmetric :
+ * @scg: #SheetControlGUI
+ * @primary: #SheetObject (optionally NULL)
+ * @dx:
+ * @dy:
+ * @drag_type:
+ * @symmetric:
*
* Move the control points and drag views of the currently selected objects to
* a new position. This movement is only made in @scg not in the actual
@@ -2994,8 +2994,8 @@ scg_object_anchor_to_coords (SheetControlGUI const *scg,
/**
* scg_comment_display :
- * @scg : The SheetControl
- * @cc : A cell comment
+ * @scg: The SheetControl
+ * @cc: A cell comment
*
*/
void
@@ -3080,8 +3080,8 @@ cb_cell_comment_timer (SheetControlGUI *scg)
/**
* scg_comment_select :
- * @scg : The SheetControl
- * @cc : A cell comment
+ * @scg: The SheetControl
+ * @cc: A cell comment
*
* Prepare @cc for display.
*/
@@ -3104,8 +3104,8 @@ scg_comment_select (SheetControlGUI *scg, GnmComment *cc, int x, int y)
/**
* scg_comment_unselect :
- * @scg : The SheetControl
- * @cc : A cell comment
+ * @scg: The SheetControl
+ * @cc: A cell comment
*
* If @cc is the current cell comment being edited/displayed shutdown the
* display mechanism.
@@ -3330,7 +3330,7 @@ scg_rangesel_stop (SheetControlGUI *scg, gboolean clear_string)
/**
* scg_set_display_cursor :
- * @scg :
+ * @scg:
*
* Set the displayed cursor type.
*/
@@ -3489,11 +3489,11 @@ scg_cursor_move (SheetControlGUI *scg, int n,
/**
* scg_cursor_extend :
- * @scg : The scg
- * @n : Units to extend the selection
- * @jump_to_bound : Move to transitions between cells and blanks,
+ * @scg: The scg
+ * @n: Units to extend the selection
+ * @jump_to_bound: Move to transitions between cells and blanks,
* or move in single steps.
- * @horiz : extend vertically or horizontally.
+ * @horiz: extend vertically or horizontally.
*/
void
scg_cursor_extend (SheetControlGUI *scg, int n,
diff --git a/src/sheet-filter.c b/src/sheet-filter.c
index 7b9e5db..d3ad9cb 100644
--- a/src/sheet-filter.c
+++ b/src/sheet-filter.c
@@ -46,8 +46,8 @@
/**
* gnm_filter_condition_new_single :
- * @op : #GnmFilterOp
- * @v : #GnmValue
+ * @op: #GnmFilterOp
+ * @v: #GnmValue
*
* Create a new condition with 1 value.
* Absorbs the reference to @v.
@@ -63,11 +63,11 @@ gnm_filter_condition_new_single (GnmFilterOp op, GnmValue *v)
/**
* gnm_filter_condition_new_double :
- * @op0 : #GnmFilterOp
- * @v0 : #GnmValue
- * @join_with_and :
- * @op1 : #GnmFilterOp
- * @v1 : #GnmValue
+ * @op0: #GnmFilterOp
+ * @v0: #GnmValue
+ * @join_with_and:
+ * @op1: #GnmFilterOp
+ * @v1: #GnmValue
*
* Create a new condition with 2 value.
* Absorbs the reference to @v0 and @v1.
@@ -409,8 +409,8 @@ gnm_filter_combo_index (GnmFilterCombo *fcombo)
/**
* gnm_filter_combo_apply :
- * @fcombo : #GnmFilterCombo
- * @target_sheet : @Sheet
+ * @fcombo: #GnmFilterCombo
+ * @target_sheet: @Sheet
*
**/
void
@@ -641,8 +641,8 @@ gnm_filter_attach (GnmFilter *filter, Sheet *sheet)
/**
* gnm_filter_new :
- * @sheet :
- * @r :
+ * @sheet:
+ * @r:
*
* Init a filter and add it to @sheet
**/
@@ -668,8 +668,8 @@ gnm_filter_new (Sheet *sheet, GnmRange const *r)
/**
* gnm_filter_dup :
- * @src : #GnmFilter
- * @sheet : #Sheet
+ * @src: #GnmFilter
+ * @sheet: #Sheet
*
* Duplicate @src into @sheet
**/
@@ -767,8 +767,8 @@ gnm_filter_remove (GnmFilter *filter)
/**
* gnm_filter_get_condition :
- * @filter :
- * @i :
+ * @filter:
+ * @i:
*
**/
GnmFilterCondition const *
@@ -822,10 +822,10 @@ gnm_filter_update_active (GnmFilter *filter)
/**
* gnm_filter_set_condition :
- * @filter :
- * @i :
- * @cond : #GnmFilterCondition
- * @apply :
+ * @filter:
+ * @i:
+ * @cond: #GnmFilterCondition
+ * @apply:
*
* Change the @i-th condition of @filter to @cond. If @apply is
* TRUE @filter is used to set the visibility of the rows in @filter::sheet
@@ -871,8 +871,8 @@ gnm_filter_set_condition (GnmFilter *filter, unsigned i,
/**
* gnm_filter_overlaps_range :
- * @filter : #GnmFilter
- * @r : #GnmRange
+ * @filter: #GnmFilter
+ * @r: #GnmRange
*
* Returns: %TRUE if @filter overlaps @r.
**/
@@ -889,7 +889,7 @@ gnm_filter_overlaps_range (GnmFilter const *filter, GnmRange const *r)
/**
* gnm_sheet_filter_at_pos :
- * @sheet : #Sheet
+ * @sheet: #Sheet
*
* Returns : #GnmRange
**/
@@ -1009,12 +1009,12 @@ gnm_filter_set_range (GnmFilter *filter, GnmRange *r)
/**
* gnm_sheet_filter_insdel_colrow :
- * @sheet :
- * @is_cols :
- * @is_insert :
- * @start :
- * @count :
- * @pundo : location to store undo closures.
+ * @sheet:
+ * @is_cols:
+ * @is_insert:
+ * @start:
+ * @count:
+ * @pundo: location to store undo closures.
*
* Adjust filters as necessary to handle col/row insertions and deletions
**/
diff --git a/src/sheet-object-image.c b/src/sheet-object-image.c
index 1d6d68b..7002420 100644
--- a/src/sheet-object-image.c
+++ b/src/sheet-object-image.c
@@ -124,11 +124,11 @@ enum {
/**
* sheet_object_image_set_image :
- * @soi : #SheetObjectImage
- * @type :
- * @data :
+ * @soi: #SheetObjectImage
+ * @type:
+ * @data:
* @data_len
- * @copy_data :
+ * @copy_data:
*
* Assign raw data and type to @so assuming that it has not been initialized
* yet.
diff --git a/src/sheet-utils.c b/src/sheet-utils.c
index 000b1cd..f7f2e0c 100644
--- a/src/sheet-utils.c
+++ b/src/sheet-utils.c
@@ -35,7 +35,7 @@ sheet_cell_or_one_below_is_not_empty (Sheet *sheet, int col, int row)
/**
* gnm_sheet_guess_region :
- * @sheet : #Sheet
+ * @sheet: #Sheet
* @region: #GnmRange
*
* Makes a guess at the logical containing @region and returns the possibly
@@ -93,8 +93,8 @@ gnm_sheet_guess_region (Sheet *sheet, GnmRange *region)
/**
* gnm_sheet_guess_data_range :
- * @sheet : #Sheet
- * @region : #GnmRange
+ * @sheet: #Sheet
+ * @region: #GnmRange
*
* Makes a guess at the logical range containing @region and returns the possibly
* expanded result in @region. The range is also expanded upwards.
diff --git a/src/sheet-view.c b/src/sheet-view.c
index 6a48a98..58d43a5 100644
--- a/src/sheet-view.c
+++ b/src/sheet-view.c
@@ -435,13 +435,13 @@ sv_selection_cut (SheetView *sv, WorkbookControl *wbc)
/**
* sv_cursor_set :
- * @sv : The sheet
- * @edit :
- * @base_col :
- * @base_row :
- * @move_col :
- * @move_row :
- * @bound : An optionally NULL range that should contain all the supplied points
+ * @sv: The sheet
+ * @edit:
+ * @base_col:
+ * @base_row:
+ * @move_col:
+ * @move_row:
+ * @bound: An optionally NULL range that should contain all the supplied points
**/
void
sv_cursor_set (SheetView *sv,
@@ -607,8 +607,8 @@ sv_flag_status_update_range (SheetView *sv, GnmRange const *range)
/**
* sv_flag_style_update_range :
- * @sv : The sheet being changed
- * @range : the range that is changing.
+ * @sv: The sheet being changed
+ * @range: the range that is changing.
*
* Flag style changes that will require updating the style indicators.
*/
@@ -623,7 +623,7 @@ sv_flag_style_update_range (SheetView *sv, GnmRange const *range)
/**
* sv_flag_selection_change :
- * @sv :
+ * @sv:
*
* flag the sheet as requiring an update to the status display
*
@@ -685,7 +685,7 @@ sv_update (SheetView *sv)
/**
* sv_editpos_in_filter :
- * @sv : #SheetView
+ * @sv: #SheetView
*
* Returns: %NULL or GnmFilter that overlaps the sv::edit_pos
**/
@@ -698,7 +698,7 @@ sv_editpos_in_filter (SheetView const *sv)
/**
* sv_selection_intersects_filter_rows :
- * @sv : #SheetView
+ * @sv: #SheetView
*
* Returns: %NULL or GnmFilter whose rows intersect the rows
* of the current selection.
@@ -808,11 +808,11 @@ sv_freeze_panes (SheetView *sv,
/**
* sv_panes_insdel_colrow :
- * @sv :
- * @is_cols :
- * @is_insert :
- * @start :
- * @count :
+ * @sv:
+ * @is_cols:
+ * @is_insert:
+ * @start:
+ * @count:
*
* Adjust the positions of frozen panes as necessary to handle col/row
* insertions and deletions. note this assumes that the ins/del operations
diff --git a/src/stf-parse.c b/src/stf-parse.c
index 24cf371..8fb65ad 100644
--- a/src/stf-parse.c
+++ b/src/stf-parse.c
@@ -458,7 +458,7 @@ stf_parse_options_fixed_splitpositions_nth (StfParseOptions_t *parseoptions, int
/**
* stf_parse_options_valid:
- * @parseoptions : an import options struct
+ * @parseoptions: an import options struct
*
* Checks if @parseoptions is correctly filled
*
diff --git a/src/stf.c b/src/stf.c
index fbff3a8..6a5c1ff 100644
--- a/src/stf.c
+++ b/src/stf.c
@@ -84,7 +84,7 @@ stf_warning (GOIOContext *context, char const *msg)
/*
* stf_open_and_read:
- * @filename : name of the file to open&read
+ * @filename: name of the file to open&read
*
* Will open filename, read the file into a g_alloced memory buffer
*
@@ -211,11 +211,11 @@ resize_columns (Sheet *sheet)
/*
* stf_read_workbook:
- * @fo : file opener
- * @enc : encoding of file
- * @context : command context
- * @book : workbook
- * @input : file to read from+convert
+ * @fo: file opener
+ * @enc: encoding of file
+ * @context: command context
+ * @book: workbook
+ * @input: file to read from+convert
*
* Main routine, handles importing a file including all dialog mumbo-jumbo
*/
@@ -414,11 +414,11 @@ clear_stray_NULs (GOIOContext *context, GString *utf8data)
/*
* stf_read_workbook_auto_csvtab:
- * @fo : file opener
- * @enc : optional encoding
- * @context : command context
- * @book : workbook
- * @input : file to read from+convert
+ * @fo: file opener
+ * @enc: optional encoding
+ * @context: command context
+ * @book: workbook
+ * @input: file to read from+convert
*
* Attempt to auto-detect CSV or tab-delimited file
*/
diff --git a/src/style-border.c b/src/style-border.c
index eea2270..cc141b1 100644
--- a/src/style-border.c
+++ b/src/style-border.c
@@ -153,7 +153,7 @@ gnm_style_border_none (void)
/**
* gnm_style_border_none_set_color:
- * @color :
+ * @color:
*
* This function updates the color of gnm_style_border_none when the wanted grid
* color is known. gnm_style_border_none tells how to render the grid. Because
@@ -183,9 +183,9 @@ gnm_style_border_none_set_color (GnmColor *color)
/**
* gnm_style_border_fetch :
- * @line_type : dash style
- * @color : colour
- * @orientation : Not currently used.
+ * @line_type: dash style
+ * @color: colour
+ * @orientation: Not currently used.
*
* Fetches a GnmBorder from the cache, creating one if necessary. Absorbs
* the colour reference. In the future we may have different dash styles for
diff --git a/src/style-conditions.c b/src/style-conditions.c
index e6ee5f7..54d905e 100644
--- a/src/style-conditions.c
+++ b/src/style-conditions.c
@@ -80,7 +80,7 @@ gnm_style_cond_op_operands (GnmStyleCondOp op)
/**
* gnm_style_cond_is_valid :
- * @cond : #GnmStyleCond
+ * @cond: #GnmStyleCond
*
* Returns: TRUE if @cond is in a reasonable state
**/
@@ -382,9 +382,9 @@ gnm_style_conditions_details (GnmStyleConditions const *sc)
/**
* gnm_style_conditions_insert :
- * @sc : #GnmStyleConditions
- * @cond : #GnmStyleCond
- * @pos : position.
+ * @sc: #GnmStyleConditions
+ * @cond: #GnmStyleCond
+ * @pos: position.
*
* Insert @cond before @pos (append if @pos < 0).
**/
diff --git a/src/style.c b/src/style.c
index 13a94fc..15fdb0d 100644
--- a/src/style.c
+++ b/src/style.c
@@ -572,8 +572,8 @@ gnm_style_required_spanflags (GnmStyle const *style)
/**
* gnm_style_default_halign:
- * @style :
- * @c :
+ * @style:
+ * @c:
*
* Select the appropriate horizontal alignment depending on the style and cell
* value.
diff --git a/src/validation.c b/src/validation.c
index e1c957b..9909863 100644
--- a/src/validation.c
+++ b/src/validation.c
@@ -232,10 +232,10 @@ gnm_validation_op_get_type (void)
/**
* gnm_validation_new :
- * @title : will be copied.
- * @msg : will be copied.
- * @texpr0 : absorb the reference to the expression (optionally %NULL).
- * @texpr1 : absorb the reference to the expression (optionally %NULL).
+ * @title: will be copied.
+ * @msg: will be copied.
+ * @texpr0: absorb the reference to the expression (optionally %NULL).
+ * @texpr1: absorb the reference to the expression (optionally %NULL).
*
* Does _NOT_ require all necessary information to be set here.
* gnm_validation_set_expr can be used to change the expressions after creation,
@@ -401,9 +401,9 @@ gnm_validation_set_sheet (GnmValidation *v, Sheet *sheet)
/**
* gnm_validation_set_expr :
- * @v : #GnmValidation
- * @texpr : #GnmExprTop
- * @indx : 0 or 1
+ * @v: #GnmValidation
+ * @texpr: #GnmExprTop
+ * @indx: 0 or 1
*
* Assign an expression to a validation. gnm_validation_is_ok can be used to
* verify that @v has all of the required information.
@@ -480,9 +480,9 @@ cb_validate_custom (GnmValueIter const *v_iter, GnmValue const *target)
/**
* gnm_validation_eval:
- * @wbc :
- * @mstyle :
- * @sheet :
+ * @wbc:
+ * @mstyle:
+ * @sheet:
*
* validation set in the GnmStyle if applicable.
**/
diff --git a/src/widgets/gnm-cell-combo-view.c b/src/widgets/gnm-cell-combo-view.c
index e0f0d4d..1a862a3 100644
--- a/src/widgets/gnm-cell-combo-view.c
+++ b/src/widgets/gnm-cell-combo-view.c
@@ -261,8 +261,8 @@ static void cb_ccombo_cancel_button (GtkWidget *list) { ccombo_popup_destroy (li
/**
* gnm_cell_combo_view_popdown:
- * @sov : #SheetObjectView
- * @activate_time : event time
+ * @sov: #SheetObjectView
+ * @activate_time: event time
*
* Open the popup window associated with @sov
**/
@@ -418,9 +418,9 @@ gnm_cell_combo_view_popdown (SheetObjectView *sov, guint32 activate_time)
/**
* gnm_cell_combo_view_new:
- * @so : #SheetObject
- * @type : #GType
- * @container : SheetObjectViewContainer (a GnmPane)
+ * @so: #SheetObject
+ * @type: #GType
+ * @container: SheetObjectViewContainer (a GnmPane)
*
* Create and register an in cell combo to pick from an autofilter list.
**/
diff --git a/src/widgets/gnumeric-expr-entry.c b/src/widgets/gnumeric-expr-entry.c
index 322118d..0b1bc8e 100644
--- a/src/widgets/gnumeric-expr-entry.c
+++ b/src/widgets/gnumeric-expr-entry.c
@@ -1797,8 +1797,8 @@ GSF_CLASS_FULL (GnmExprEntry, gnm_expr_entry,
/**
* gee_prepare_range :
- * @gee :
- * @dst :
+ * @gee:
+ * @dst:
*
* Adjust @dst as necessary to conform to @gee's requirements
* Produces the _logical_ range, a merge is displayed as only the topleft.
diff --git a/src/widgets/widget-editable-label.c b/src/widgets/widget-editable-label.c
index ff2d220..0e0a123 100644
--- a/src/widgets/widget-editable-label.c
+++ b/src/widgets/widget-editable-label.c
@@ -346,9 +346,9 @@ editable_label_get_text (EditableLabel const *el)
/**
* editable_label_set_color :
- * @el :
- * @base_color : optionally NULL.
- * @text_color : optionally NULL.
+ * @el:
+ * @base_color: optionally NULL.
+ * @text_color: optionally NULL.
*
* assign the specified colours. If we are editing just store them for later use.
*/
diff --git a/src/workbook-view.c b/src/workbook-view.c
index fde9b6d..91d23ae 100644
--- a/src/workbook-view.c
+++ b/src/workbook-view.c
@@ -118,7 +118,7 @@ wb_view_get_doc (WorkbookView const *wbv)
/**
* wb_view_get_index_in_wb :
- * @wbv : #WorkbookView
+ * @wbv: #WorkbookView
*
* Returns 0 based index of wbv within workbook, or -1 if there is no workbook.
**/
diff --git a/src/xml-sax-read.c b/src/xml-sax-read.c
index c818b0d..cd49ad9 100644
--- a/src/xml-sax-read.c
+++ b/src/xml-sax-read.c
@@ -1900,10 +1900,10 @@ xml_sax_cell (GsfXMLIn *xin, xmlChar const **attrs)
* xml_cell_set_array_expr : Utility routine to parse an expression
* and store it as an array.
*
- * @cell : The upper left hand corner of the array.
- * @text : The text to parse.
- * @rows : The number of rows.
- * @cols : The number of columns.
+ * @cell: The upper left hand corner of the array.
+ * @text: The text to parse.
+ * @rows: The number of rows.
+ * @cols: The number of columns.
*/
static void
xml_cell_set_array_expr (XMLSaxParseState *state,
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]
