mirrors
/
mc
mirror of https://github.com/MidnightCommander/mc
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Fix of DOXYGEN docs: @return instead of @returns 

...and other minor corrections.

Signed-off-by: Andrew Borodin <aborodin@vmail.ru>
This commit is contained in:
Andrew Borodin 2012-11-05 17:57:50 +04:00
parent ff22fa9ca0
commit 2940b7455d
21 changed files with 78 additions and 85 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
lib/charsets.c
View File

@ -260,7 +260,7 @@ get_codepage_index (const char *id)
/* --------------------------------------------------------------------------------------------- */ /* --------------------------------------------------------------------------------------------- */
/** Check if specified encoding can be used in mc. /** Check if specified encoding can be used in mc.
* @param encoding name of encoding * @param encoding name of encoding
* @returns TRUE if encoding has supported by mc, FALSE otherwise * @return TRUE if encoding is supported by mc, FALSE otherwise
*/ */
gboolean gboolean

2
lib/lock.c
View File

@ -266,7 +266,7 @@ lock_file (const vfs_path_t * fname_vpath)
/* --------------------------------------------------------------------------------------------- */ /* --------------------------------------------------------------------------------------------- */
/** /**
* Lowers file lock if possible * Lowers file lock if possible
* @returns Always 0 * @return Always 0
*/ */
int int

4
lib/strutil.h
View File

@ -533,7 +533,7 @@ void str_msg_term_size (const char *text, int *lines, int *columns);
* @param needle pointer to string * @param needle pointer to string
* @param skip_count skip first bytes * @param skip_count skip first bytes
* *
* @returns pointer to skip_count+1 needle (or NULL if not found). * @return pointer to skip_count+1 needle (or NULL if not found).
*/ */
char *strrstr_skip_count (const char *haystack, const char *needle, size_t skip_count); char *strrstr_skip_count (const char *haystack, const char *needle, size_t skip_count);
@ -564,7 +564,7 @@ str_replace (char *s, char from, char to)
* @param dest pointer to string * @param dest pointer to string
* @param src pointer to string * @param src pointer to string
* *
* @returns a newly allocated string * @return newly allocated string
* *
*/ */

6
lib/strutil/strescape.c
View File

@ -166,7 +166,7 @@ strutils_unescape (const char *src, gsize src_len, const char *unescaped_chars,
* *
* @param src string for escaping * @param src string for escaping
* *
* @returns escaped string (which needs to be freed later) or NULL when NULL string is passed. * @return escaped string (which needs to be freed later) or NULL when NULL string is passed.
*/ */
char * char *
@ -199,7 +199,7 @@ strutils_regex_escape (const char *src)
* *
* @param text string for unescaping * @param text string for unescaping
* *
* @returns unescaped string (which needs to be freed) * @return unescaped string (which needs to be freed)
*/ */
char * char *
@ -231,7 +231,7 @@ strutils_regex_unescape (const char *text)
* @param start string for checking * @param start string for checking
* @param current pointer to checked character * @param current pointer to checked character
* *
* @returns TRUE if string contain escaped chars otherwise return FALSE * @return TRUE if string contain escaped chars otherwise return FALSE
*/ */
gboolean gboolean

2
lib/util.c
View File

@ -918,7 +918,7 @@ wipe_password (char *passwd)
* *
* @param p pointer to string * @param p pointer to string
* *
* @returns a newly allocated string * @return newly allocated string
*/ */
char * char *

4
lib/utilunix.c
View File

@ -286,7 +286,7 @@ my_system (int flags, const char *shell, const char *command)
* *
* @param directory pointer to the path * @param directory pointer to the path
* *
* @returns a newly allocated string, even if it's unchanged. * @return newly allocated string, even if it's unchanged.
*/ */
char * char *
@ -385,7 +385,7 @@ open_error_pipe (void)
* @param error '-1' - ignore errors, '0' - display warning, '1' - display error * @param error '-1' - ignore errors, '0' - display warning, '1' - display error
* @param text is prepended to the error message from the pipe * @param text is prepended to the error message from the pipe
* *
* @returns not 0 if an error was displayed * @return not 0 if an error was displayed
*/ */
int int

4
lib/vfs/path.c
View File

@ -1058,7 +1058,7 @@ vfs_path_element_need_cleanup_converter (const vfs_path_element_t * element)
* @param vpath data for serialization * @param vpath data for serialization
* @param error contain pointer to object for handle error code and message * @param error contain pointer to object for handle error code and message
* *
* @returns serialized vpath as newly allocated string * @return serialized vpath as newly allocated string
*/ */
char * char *
@ -1452,7 +1452,7 @@ vfs_path_vtokens_get (const vfs_path_t * vpath, ssize_t start_position, ssize_t
* @param element path element * @param element path element
* @param keep_password TRUE or FALSE * @param keep_password TRUE or FALSE
* *
* @returns newly allocated string * @return newly allocated string
*/ */
char * char *

2
lib/vfs/vfs.c
View File

@ -626,7 +626,7 @@ vfs_change_encoding (vfs_path_t * vpath, const char *encoding)
* @param src_fsize source file size * @param src_fsize source file size
* @param dest_fsize destination file size (if destination exists, otherwise should be 0) * @param dest_fsize destination file size (if destination exists, otherwise should be 0)
* *
* @returns 0 if success and non-zero otherwise. * @return 0 if success and non-zero otherwise.
* Note: function doesn't touch errno global variable. * Note: function doesn't touch errno global variable.
*/ */

4
lib/widget/input.c
View File

@ -984,7 +984,7 @@ input_event (Gpm_Event * event, void *data)
* @param def_text Default text filled in widget * @param def_text Default text filled in widget
* @param histname Name of history * @param histname Name of history
* @param completion_flags Flags for specify type of completions * @param completion_flags Flags for specify type of completions
* @returns WInput object * @return WInput object
*/ */
WInput * WInput *
input_new (int y, int x, const int *input_colors, int width, const char *def_text, input_new (int y, int x, const int *input_colors, int width, const char *def_text,
@ -1104,7 +1104,7 @@ input_callback (Widget * w, widget_msg_t msg, int parm)
/* --------------------------------------------------------------------------------------------- */ /* --------------------------------------------------------------------------------------------- */
/** Get default colors for WInput widget. /** Get default colors for WInput widget.
* @returns default colors * @return default colors
*/ */
const int * const int *
input_get_default_colors (void) input_get_default_colors (void)

67
src/diffviewer/ydiff.c
View File

@ -159,7 +159,7 @@ rewrite_backup_content (const vfs_path_t * from_file_name_vpath, const char *to_
* @note the name is not altered if this function fails * @note the name is not altered if this function fails
* *
* @param[out] name address of a pointer to store the temporary name * @param[out] name address of a pointer to store the temporary name
* @returns file descriptor on success, negative on error * @return file descriptor on success, negative on error
*/ */
static int static int
@ -186,7 +186,7 @@ open_temp (void **name)
* Alocate file structure and associate file descriptor to it. * Alocate file structure and associate file descriptor to it.
* *
* @param fd file descriptor * @param fd file descriptor
* @returns file structure * @return file structure
*/ */
static FBUF * static FBUF *
@ -222,7 +222,7 @@ f_dopen (int fd)
* Free file structure without closing the file. * Free file structure without closing the file.
* *
* @param fs file structure * @param fs file structure
* @returns 0 on success, non-zero on error * @return 0 on success, non-zero on error
*/ */
static int static int
@ -246,8 +246,7 @@ f_free (FBUF * fs)
* Open a binary temporary file in R/W mode. * Open a binary temporary file in R/W mode.
* @note the file will be deleted when closed * @note the file will be deleted when closed
* *
* @returns file structure * @return file structure
*
*/ */
static FBUF * static FBUF *
f_temp (void) f_temp (void)
@ -279,7 +278,7 @@ f_temp (void)
* @param filename file name * @param filename file name
* @param flags open mode, a combination of O_RDONLY, O_WRONLY, O_RDWR * @param flags open mode, a combination of O_RDONLY, O_WRONLY, O_RDWR
* *
* @returns file structure * @return file structure
*/ */
static FBUF * static FBUF *
@ -314,8 +313,7 @@ f_open (const char *filename, int flags)
* @param size size of buffer * @param size size of buffer
* @param fs file structure * @param fs file structure
* *
* @returns number of bytes read * @return number of bytes read
*
*/ */
static size_t static size_t
@ -357,8 +355,7 @@ f_gets (char *buf, size_t size, FBUF * fs)
* @param off offset * @param off offset
* @param whence seek directive: SEEK_SET, SEEK_CUR or SEEK_END * @param whence seek directive: SEEK_SET, SEEK_CUR or SEEK_END
* *
* @returns position in file, starting from begginning * @return position in file, starting from begginning
*
*/ */
static off_t static off_t
@ -397,7 +394,7 @@ f_seek (FBUF * fs, off_t off, int whence)
* *
* @param fs file structure * @param fs file structure
* *
* @returns 0 if success, non-zero on error * @return 0 if success, non-zero on error
*/ */
static off_t static off_t
@ -421,8 +418,7 @@ f_reset (FBUF * fs)
* @param buf source buffer * @param buf source buffer
* @param size size of buffer * @param size size of buffer
* *
* @returns number of written bytes, -1 on error * @return number of written bytes, -1 on error
*
*/ */
static ssize_t static ssize_t
@ -444,8 +440,7 @@ f_write (FBUF * fs, const char *buf, size_t size)
* *
* @param fs file structure * @param fs file structure
* *
* @returns current file size on success, negative on error * @return current file size on success, negative on error
*
*/ */
static off_t static off_t
@ -474,8 +469,7 @@ f_trunc (FBUF * fs)
* @note if this is temporary file, it is deleted * @note if this is temporary file, it is deleted
* *
* @param fs file structure * @param fs file structure
* @returns 0 on success, non-zero on error * @return 0 on success, non-zero on error
*
*/ */
static int static int
@ -500,7 +494,7 @@ f_close (FBUF * fs)
* @param cmd shell command line * @param cmd shell command line
* @param flags open mode, either O_RDONLY or O_WRONLY * @param flags open mode, either O_RDONLY or O_WRONLY
* *
* @returns file structure * @return file structure
*/ */
static FBUF * static FBUF *
@ -540,7 +534,7 @@ p_open (const char *cmd, int flags)
* Close pipe stream. * Close pipe stream.
* *
* @param fs structure * @param fs structure
* @returns 0 on success, non-zero on error * @return 0 on success, non-zero on error
*/ */
static int static int
@ -563,7 +557,7 @@ p_close (FBUF * fs)
* Get one char (byte) from string * Get one char (byte) from string
* *
* @param char * str, gboolean * result * @param char * str, gboolean * result
* @returns int as character or 0 and result == FALSE if fail * @return int as character or 0 and result == FALSE if fail
*/ */
static int static int
@ -584,8 +578,7 @@ dview_get_byte (char *str, gboolean * result)
* Get utf multibyte char from string * Get utf multibyte char from string
* *
* @param char * str, int * char_width, gboolean * result * @param char * str, int * char_width, gboolean * result
* @returns int as utf character or 0 and result == FALSE if fail * @return int as utf character or 0 and result == FALSE if fail
*
*/ */
static int static int
@ -666,7 +659,7 @@ dview_str_utf8_offset_to_pos (const char *text, size_t length)
* *
* @param[in,out] str string to parse * @param[in,out] str string to parse
* @param[out] n extracted number * @param[out] n extracted number
* @returns 0 if success, otherwise non-zero * @return 0 if success, otherwise non-zero
*/ */
static int static int
@ -690,7 +683,7 @@ scan_deci (const char **str, int *n)
* *
* @param p string to parse * @param p string to parse
* @param ops list of diff statements * @param ops list of diff statements
* @returns 0 if success, otherwise non-zero * @return 0 if success, otherwise non-zero
*/ */
static int static int
@ -766,7 +759,7 @@ scan_line (const char *p, GArray * ops)
* *
* @param f stream to read from * @param f stream to read from
* @param ops list of diff statements to fill * @param ops list of diff statements to fill
* @returns positive number indicating number of hunks, otherwise negative * @return positive number indicating number of hunks, otherwise negative
*/ */
static int static int
@ -807,7 +800,7 @@ scan_diff (FBUF * f, GArray * ops)
* @param file2 second file to compare * @param file2 second file to compare
* @param ops list of diff statements to fill * @param ops list of diff statements to fill
* *
* @returns positive number indicating number of hunks, otherwise negative * @return positive number indicating number of hunks, otherwise negative
*/ */
static int static int
@ -862,7 +855,7 @@ dff_execute (const char *args, const char *extra, const char *file1, const char
* @param printer printf-like function to be used for displaying * @param printer printf-like function to be used for displaying
* @param ctx printer context * @param ctx printer context
* *
* @returns 0 if success, otherwise non-zero * @return 0 if success, otherwise non-zero
*/ */
static int static int
@ -1039,7 +1032,7 @@ dff_reparse (diff_place_t ord, const char *filename, const GArray * ops, DFUNC p
* @param ret list of offsets for longest common substrings inside each string * @param ret list of offsets for longest common substrings inside each string
* @param min minimum length of common substrings * @param min minimum length of common substrings
* *
* @returns 0 if success, nonzero otherwise * @return 0 if success, nonzero otherwise
*/ */
static int static int
@ -1136,7 +1129,7 @@ lcsubstr (const char *s, int m, const char *t, int n, GArray * ret, int min)
* @param hdiff list of horizontal diff ranges to fill * @param hdiff list of horizontal diff ranges to fill
* @param depth recursion depth * @param depth recursion depth
* *
* @returns 0 if success, nonzero otherwise * @return 0 if success, nonzero otherwise
*/ */
static gboolean static gboolean
@ -1216,7 +1209,7 @@ hdiff_multi (const char *s, const char *t, const BRACKET bracket, int min, GArra
* @param hdiff list of horizontal diff ranges to fill * @param hdiff list of horizontal diff ranges to fill
* @param depth recursion depth * @param depth recursion depth
* *
* @returns 0 if success, nonzero otherwise * @return 0 if success, nonzero otherwise
*/ */
static gboolean static gboolean
@ -1251,7 +1244,7 @@ hdiff_scan (const char *s, int m, const char *t, int n, int min, GArray * hdiff,
* @param hdiff horizontal diff structure * @param hdiff horizontal diff structure
* @param ord DIFF_LEFT if reading from first file, DIFF_RIGHT if reading from 2nd file * @param ord DIFF_LEFT if reading from first file, DIFF_RIGHT if reading from 2nd file
* *
* @returns TRUE if inside hdiff limits, FALSE otherwise * @return TRUE if inside hdiff limits, FALSE otherwise
*/ */
static gboolean static gboolean
@ -1285,7 +1278,7 @@ is_inside (int k, GArray * hdiff, diff_place_t ord)
* @param base virtual base of this string, needed to calculate tabs * @param base virtual base of this string, needed to calculate tabs
* @param ts tab size * @param ts tab size
* *
* @returns new virtual base * @return new virtual base
*/ */
static int static int
@ -1322,7 +1315,7 @@ cvt_cpy (char *dst, const char *src, size_t srcsize, int base, int ts)
* @param base virtual base of this string, needed to calculate tabs * @param base virtual base of this string, needed to calculate tabs
* @param ts tab size * @param ts tab size
* *
* @returns new virtual base * @return new virtual base
* *
* @note The procedure returns when all bytes are consumed from 'src' * @note The procedure returns when all bytes are consumed from 'src'
* or 'dstsize' bytes are written to 'dst' * or 'dstsize' bytes are written to 'dst'
@ -1368,7 +1361,7 @@ cvt_ncpy (char *dst, int dstsize, const char **_src, size_t srcsize, int base, i
* @param ts tab size * @param ts tab size
* @param show_cr show trailing carriage return as ^M * @param show_cr show trailing carriage return as ^M
* *
* @returns negative on error, otherwise number of bytes except padding * @return negative on error, otherwise number of bytes except padding
*/ */
static int static int
@ -1465,7 +1458,7 @@ cvt_mget (const char *src, size_t srcsize, char *dst, int dstsize, int skip, int
* @param ord DIFF_LEFT if reading from first file, DIFF_RIGHT if reading from 2nd file * @param ord DIFF_LEFT if reading from first file, DIFF_RIGHT if reading from 2nd file
* @param att buffer of attributes * @param att buffer of attributes
* *
* @returns negative on error, otherwise number of bytes except padding * @return negative on error, otherwise number of bytes except padding
*/ */
static int static int
@ -1566,7 +1559,7 @@ cvt_mgeta (const char *src, size_t srcsize, char *dst, int dstsize, int skip, in
* @param ts tab size * @param ts tab size
* @param show_cr show trailing carriage return as ^M * @param show_cr show trailing carriage return as ^M
* *
* @returns negative on error, otherwise number of bytes except padding * @return negative on error, otherwise number of bytes except padding
*/ */
static int static int
@ -1976,7 +1969,7 @@ find_next_hunk (const GArray * a, size_t pos)
* Find start and end lines of the current hunk. * Find start and end lines of the current hunk.
* *
* @param dview WDiff widget * @param dview WDiff widget
* @returns boolean and * @return boolean and
* start_line1 first line of current hunk (file[0]) * start_line1 first line of current hunk (file[0])
* end_line1 last line of current hunk (file[0]) * end_line1 last line of current hunk (file[0])
* start_line1 first line of current hunk (file[0]) * start_line1 first line of current hunk (file[0])

4
src/editor/bookmark.c
View File

@ -145,7 +145,7 @@ book_mark_find (WEdit * edit, long line)
* @param edit editor object * @param edit editor object
* @param line line where book mark is * @param line line where book mark is
* @param c color of book mark * @param c color of book mark
* @returns TRUE if bookmark exists at this line of color c, FALSE otherwise * @return TRUE if bookmark exists at this line of color c, FALSE otherwise
*/ */
gboolean gboolean
@ -209,7 +209,7 @@ book_mark_insert (WEdit * edit, long line, int c)
* @param edit editor object * @param edit editor object
* @param line line where book mark is * @param line line where book mark is
* @param c color of book mark or -1 to clear all book marks on this line * @param c color of book mark or -1 to clear all book marks on this line
* @returns FALSE if not found, TRUE otherwise * @return FALSE if not found, TRUE otherwise
*/ */
gboolean gboolean

2
src/editor/edit-impl.h
View File

@ -336,7 +336,7 @@ void edit_execute_cmd (WEdit * edit, unsigned long command, int char_for_inserti
* To do it, allocate a new widget, initialize it and, if the new file * To do it, allocate a new widget, initialize it and, if the new file
* was loaded, copy the data to the old widget. * was loaded, copy the data to the old widget.
* *
* @returns TRUE on success, FALSE on failure. * @return TRUE on success, FALSE on failure.
*/ */
static inline gboolean static inline gboolean
edit_reload (WEdit * edit, const vfs_path_t * filename_vpath) edit_reload (WEdit * edit, const vfs_path_t * filename_vpath)

10
src/editor/edit.c
View File

@ -194,7 +194,7 @@ edit_init_buffers (WEdit * edit)
/** /**
* Load file OR text into buffers. Set cursor to the beginning of file. * Load file OR text into buffers. Set cursor to the beginning of file.
* *
* @returns FALSE on error. * @return FALSE on error.
*/ */
static gboolean static gboolean
@ -326,7 +326,7 @@ edit_insert_stream (WEdit * edit, FILE * f)
* @param edit editor object * @param edit editor object
* @param filename_vpath file name * @param filename_vpath file name
* @param st buffer for store stat info * @param st buffer for store stat info
* @returns TRUE for success, FALSE for error. * @return TRUE for success, FALSE for error.
*/ */
static gboolean static gboolean
@ -1740,7 +1740,7 @@ edit_move_block_to_left (WEdit * edit)
/* --------------------------------------------------------------------------------------------- */ /* --------------------------------------------------------------------------------------------- */
/** /**
* prints at the cursor * prints at the cursor
* @returns the number of chars printed * @return number of chars printed
*/ */
static size_t static size_t
@ -1918,7 +1918,7 @@ edit_get_write_filter (const vfs_path_t * write_name_vpath, const vfs_path_t * f
/** /**
* @param edit editor object * @param edit editor object
* @param f value of stream file * @param f value of stream file
* @returns the length of the file * @return the length of the file
*/ */
off_t off_t
@ -2347,7 +2347,7 @@ edit_clean (WEdit * edit)
* To do it, allocate a new widget, initialize it and, if the new file * To do it, allocate a new widget, initialize it and, if the new file
* was loaded, copy the data to the old widget. * was loaded, copy the data to the old widget.
* *
* @returns TRUE on success, FALSE on failure. * @return TRUE on success, FALSE on failure.
*/ */
gboolean gboolean
edit_reload_line (WEdit * edit, const vfs_path_t * filename_vpath, long line) edit_reload_line (WEdit * edit, const vfs_path_t * filename_vpath, long line)

10
src/editor/editcmd.c
View File

@ -2055,7 +2055,7 @@ edit_save_confirm_cmd (WEdit * edit)
/** /**
* Ask file to edit and load it. * Ask file to edit and load it.
* *
* @returns TRUE on success or cancel of ask. * @return TRUE on success or cancel of ask.
*/ */
gboolean gboolean
@ -2085,7 +2085,7 @@ edit_load_cmd (Dlg_head * h)
/** /**
* Load syntax file to edit. * Load syntax file to edit.
* *
* @returns TRUE on success * @return TRUE on success
*/ */
gboolean gboolean
@ -2130,7 +2130,7 @@ edit_load_syntax_file (Dlg_head * h)
/** /**
* Load menu file to edit. * Load menu file to edit.
* *
* @returns TRUE on success * @return TRUE on success
*/ */
gboolean gboolean
@ -2192,7 +2192,7 @@ edit_load_menu_file (Dlg_head * h)
/** /**
* Close window with opened file. * Close window with opened file.
* *
* @returns TRUE if file was closed. * @return TRUE if file was closed.
*/ */
gboolean gboolean
@ -2836,7 +2836,7 @@ edit_search_cmd (WEdit * edit, gboolean again)
/** /**
* Check if it's OK to close the file. If there are unsaved changes, ask user. * Check if it's OK to close the file. If there are unsaved changes, ask user.
* *
* @returns TRUE if it's OK to exit, FALSE to continue editing. * @return TRUE if it's OK to exit, FALSE to continue editing.
*/ */
gboolean gboolean

16
src/editor/spell.c
View File

@ -129,7 +129,7 @@ static struct
* Found the language name by language code. For example: en_US -> American English. * Found the language name by language code. For example: en_US -> American English.
* *
* @param code Short name of the language (ru, en, pl, uk, etc...) * @param code Short name of the language (ru, en, pl, uk, etc...)
* @returns the language name * @return language name
*/ */
static const char * static const char *
@ -150,7 +150,7 @@ spell_decode_lang (const char *code)
/** /**
* Checks if aspell library and symbols are available. * Checks if aspell library and symbols are available.
* *
* @returns FALSE or error * @return FALSE or error
*/ */
static gboolean static gboolean
@ -342,7 +342,7 @@ aspell_clean (void)
* Get array of available languages. * Get array of available languages.
* *
* @param lang_list Array of languages. Must be cleared before use * @param lang_list Array of languages. Must be cleared before use
* @returns language list length * @return language list length
*/ */
unsigned int unsigned int
@ -406,7 +406,7 @@ aspell_array_clean (GArray * array)
/** /**
* Get the current language name. * Get the current language name.
* *
* @returns Language name * @return language name
*/ */
const char * const char *
@ -423,7 +423,7 @@ aspell_get_lang (void)
* Set the language. * Set the language.
* *
* @param lang Language name * @param lang Language name
* @returns FALSE or error * @return FALSE or error
*/ */
gboolean gboolean
@ -469,7 +469,7 @@ aspell_set_lang (const char *lang)
* *
* @param word Word for spell check * @param word Word for spell check
* @param word_size Word size (in bytes) * @param word_size Word size (in bytes)
* @returns FALSE if word is not in the dictionary * @return FALSE if word is not in the dictionary
*/ */
gboolean gboolean
@ -490,7 +490,7 @@ aspell_check (const char *word, const int word_size)
* @param suggest array of words to iterate through * @param suggest array of words to iterate through
* @param word Word for spell check * @param word Word for spell check
* @param word_size Word size (in bytes) * @param word_size Word size (in bytes)
* @returns count of suggests for the word * @return count of suggests for the word
*/ */
unsigned int unsigned int
@ -533,7 +533,7 @@ aspell_suggest (GArray * suggest, const char *word, const int word_size)
* *
* @param word Word for spell check * @param word Word for spell check
* @param word_size Word size (in bytes) * @param word_size Word size (in bytes)
* @returns FALSE or error * @return FALSE or error
*/ */
gboolean gboolean
aspell_add_to_dict (const char *word, int word_size) aspell_add_to_dict (const char *word, int word_size)

4
src/editor/spell_dialogs.c
View File

@ -55,7 +55,7 @@
* @param word Word for spell check * @param word Word for spell check
* @param new_word Word to replace the incorrect word * @param new_word Word to replace the incorrect word
* @param suggest Array of suggests for current word * @param suggest Array of suggests for current word
* @returns code of pressed button * @return code of pressed button
*/ */
int int
@ -150,7 +150,7 @@ spell_dialog_spell_suggest_show (WEdit * edit, const char *word, char **new_word
* Show dialog to select language for spell check. * Show dialog to select language for spell check.
* *
* @param languages Array of available languages * @param languages Array of available languages
* @returns name of choosed language * @return name of choosed language
*/ */
char * char *

4
src/filemanager/dir.c
View File

@ -138,7 +138,7 @@ clean_sort_keys (dir_list * list, int start, int count)
* Increase directory list by RESIZE_STEPS * Increase directory list by RESIZE_STEPS
* *
* @param list directory list * @param list directory list
* @returns FALSE = failure, TRUE = success * @return FALSE on failure, TRUE on success
*/ */
static gboolean static gboolean
@ -160,7 +160,7 @@ grow_list (dir_list * list)
/* --------------------------------------------------------------------------------------------- */ /* --------------------------------------------------------------------------------------------- */
/** /**
* If you change handle_dirent then check also handle_path. * If you change handle_dirent then check also handle_path.
* @returns -1 = failure, 0 = don't add, 1 = add to the list * @return -1 = failure, 0 = don't add, 1 = add to the list
*/ */
static int static int

4
src/filemanager/panel.c
View File

@ -3998,7 +3998,7 @@ panel_set_lwd (WPanel * panel, const char *path_str)
/* --------------------------------------------------------------------------------------------- */ /* --------------------------------------------------------------------------------------------- */
/** Panel creation. /** Panel creation.
* @param panel_name the name of the panel for setup retieving * @param panel_name the name of the panel for setup retieving
* @returns new instance of WPanel * @return new instance of WPanel
*/ */
WPanel * WPanel *
@ -4015,7 +4015,7 @@ panel_new (const char *panel_name)
* @param wpath the path of working panel directory. If path is NULL then panel will be created * @param wpath the path of working panel directory. If path is NULL then panel will be created
* for current directory * for current directory
* *
* @returns new instance of WPanel * @return new instance of WPanel
*/ */
WPanel * WPanel *

2
src/help.c
View File

@ -161,7 +161,7 @@ search_string (const char *start, const char *text)
/* --------------------------------------------------------------------------------------------- */ /* --------------------------------------------------------------------------------------------- */
/** Searches text in the buffer pointed by start. Search ends /** Searches text in the buffer pointed by start. Search ends
* if the CHAR_NODE_END is found in the text. * if the CHAR_NODE_END is found in the text.
* @returns 0 on failure * @return NULL on failure
*/ */
static const char * static const char *

2
src/setup.c
View File

@ -409,7 +409,7 @@ static const struct
* @param subdir If not NULL, config is also searched in specified subdir. * @param subdir If not NULL, config is also searched in specified subdir.
* @param config_file_name If relative, file if searched in standard paths. * @param config_file_name If relative, file if searched in standard paths.
* *
* @returns Newly allocated string with config name or NULL if file is not found. * @return newly allocated string with config name or NULL if file is not found.
*/ */
static char * static char *

8
src/vfs/sftpfs/file.c
View File

@ -225,7 +225,7 @@ sftpfs_fstat (void *data, struct stat *buf, GError ** error)
* @param count data size * @param count data size
* @param error pointer to the error handler * @param error pointer to the error handler
* *
* @returns 0 on sucess, negative value otherwise * @return 0 on sucess, negative value otherwise
*/ */
ssize_t ssize_t
@ -277,7 +277,7 @@ sftpfs_read_file (vfs_file_handler_t * file_handler, char *buffer, size_t count,
* @param count data size * @param count data size
* @param error pointer to the error handler * @param error pointer to the error handler
* *
* @returns 0 on sucess, negative value otherwise * @return 0 on sucess, negative value otherwise
*/ */
ssize_t ssize_t
@ -322,7 +322,7 @@ sftpfs_write_file (vfs_file_handler_t * file_handler, const char *buffer, size_t
* @param file_handler file data handler * @param file_handler file data handler
* @param error pointer to the error handler * @param error pointer to the error handler
* *
* @returns 0 on sucess, negative value otherwise * @return 0 on sucess, negative value otherwise
*/ */
int int
@ -352,7 +352,7 @@ sftpfs_close_file (vfs_file_handler_t * file_handler, GError ** error)
* @param whence method of seek (at begin, at current, at end) * @param whence method of seek (at begin, at current, at end)
* @param error pointer to the error handler * @param error pointer to the error handler
* *
* @returns 0 on sucess, negative value otherwise * @return 0 on sucess, negative value otherwise
*/ */
off_t off_t