luc14n0/glib
1
0
Fork 0
mirror of https://gitlab.gnome.org/GNOME/glib.git synced 2024-11-09 02:46:16 +01:00
Code Issues Packages Projects Releases Wiki Activity

gfileutils: Fix transfer annotation and whitespace issues

Browse Source
This commit is contained in:
Phaedrus Leeds 2021-12-02 12:37:26 -08:00
parent 9538e05387
commit 93f5758cf4
1 changed files with 26 additions and 26 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

36
glib/gfileutils.c
View File

@ -1855,7 +1855,7 @@ g_file_open_tmp (const gchar *tmpl,
* Note that in contrast to g_mkdtemp() (and mkdtemp()) @tmpl is not * Note that in contrast to g_mkdtemp() (and mkdtemp()) @tmpl is not
* modified, and might thus be a read-only literal string. * modified, and might thus be a read-only literal string.
* *
* Returns: (type filename): The actual name used. This string * Returns: (type filename) (transfer full): The actual name used. This string
* should be freed with g_free() when not needed any longer and is * should be freed with g_free() when not needed any longer and is
* is in the GLib file name encoding. In case of errors, %NULL is * is in the GLib file name encoding. In case of errors, %NULL is
* returned and @error will be set. * returned and @error will be set.
@ -1989,8 +1989,8 @@ g_build_path_va (const gchar *separator,
* as a string array, instead of varargs. This function is mainly * as a string array, instead of varargs. This function is mainly
* meant for language bindings. * meant for language bindings.
* *
* Returns: (type filename): a newly-allocated string that must be freed * Returns: (type filename) (transfer full): a newly-allocated string that
* with g_free(). * must be freed with g_free().
* *
* Since: 2.8 * Since: 2.8
*/ */
@ -2038,8 +2038,8 @@ g_build_pathv (const gchar *separator,
* copies of the separator, elements consisting only of copies * copies of the separator, elements consisting only of copies
* of the separator are ignored. * of the separator are ignored.
* *
* Returns: (type filename): a newly-allocated string that must be freed with * Returns: (type filename) (transfer full): a newly-allocated string that
* g_free(). * must be freed with g_free().
**/ **/
gchar * gchar *
g_build_path (const gchar *separator, g_build_path (const gchar *separator,
@ -2198,8 +2198,8 @@ g_build_filename_va (const gchar *first_argument,
* Behaves exactly like g_build_filename(), but takes the path elements * Behaves exactly like g_build_filename(), but takes the path elements
* as a va_list. This function is mainly meant for language bindings. * as a va_list. This function is mainly meant for language bindings.
* *
* Returns: (type filename): a newly-allocated string that must be freed * Returns: (type filename) (transfer full): a newly-allocated string that
* with g_free(). * must be freed with g_free().
* *
* Since: 2.56 * Since: 2.56
*/ */
@ -2221,8 +2221,8 @@ g_build_filename_valist (const gchar *first_element,
* as a string array, instead of varargs. This function is mainly * as a string array, instead of varargs. This function is mainly
* meant for language bindings. * meant for language bindings.
* *
* Returns: (type filename): a newly-allocated string that must be freed * Returns: (type filename) (transfer full): a newly-allocated string that
* with g_free(). * must be freed with g_free().
* *
* Since: 2.8 * Since: 2.8
*/ */
@ -2253,8 +2253,8 @@ g_build_filenamev (gchar **args)
* path. If the first element is a relative path, the result will * path. If the first element is a relative path, the result will
* be a relative path. * be a relative path.
* *
* Returns: (type filename): a newly-allocated string that must be freed with * Returns: (type filename) (transfer full): a newly-allocated string that
* g_free(). * must be freed with g_free().
**/ **/
gchar * gchar *
g_build_filename (const gchar *first_element, g_build_filename (const gchar *first_element,
@ -2279,8 +2279,8 @@ g_build_filename (const gchar *first_element,
* readlink() function. The returned string is in the encoding used * readlink() function. The returned string is in the encoding used
* for filenames. Use g_filename_to_utf8() to convert it to UTF-8. * for filenames. Use g_filename_to_utf8() to convert it to UTF-8.
* *
* Returns: (type filename): A newly-allocated string with the contents of * Returns: (type filename) (transfer full): A newly-allocated string with
* the symbolic link, or %NULL if an error occurred. * the contents of the symbolic link, or %NULL if an error occurred.
* *
* Since: 2.4 * Since: 2.4
*/ */
@ -2534,8 +2534,8 @@ g_basename (const gchar *file_name)
* separators (and on Windows, possibly a drive letter), a single * separators (and on Windows, possibly a drive letter), a single
* separator is returned. If @file_name is empty, it gets ".". * separator is returned. If @file_name is empty, it gets ".".
* *
* Returns: (type filename): a newly allocated string containing the last * Returns: (type filename) (transfer full): a newly allocated string
* component of the filename * containing the last component of the filename
*/ */
gchar * gchar *
g_path_get_basename (const gchar *file_name) g_path_get_basename (const gchar *file_name)
@ -2595,7 +2595,7 @@ g_path_get_basename (const gchar *file_name)
* If the file name has no directory components "." is returned. * If the file name has no directory components "." is returned.
* The returned string should be freed when no longer needed. * The returned string should be freed when no longer needed.
* *
* Returns: (type filename): the directory components of the file * Returns: (type filename) (transfer full): the directory components of the file
* *
* Deprecated: use g_path_get_dirname() instead * Deprecated: use g_path_get_dirname() instead
*/ */
@ -2611,7 +2611,7 @@ g_path_get_basename (const gchar *file_name)
* If the file name has no directory components "." is returned. * If the file name has no directory components "." is returned.
* The returned string should be freed when no longer needed. * The returned string should be freed when no longer needed.
* *
* Returns: (type filename): the directory components of the file * Returns: (type filename) (transfer full): the directory components of the file
*/ */
gchar * gchar *
g_path_get_dirname (const gchar *file_name) g_path_get_dirname (const gchar *file_name)
@ -2870,7 +2870,7 @@ g_canonicalize_filename (const gchar *filename,
* the current directory. This can make a difference in the case that * the current directory. This can make a difference in the case that
* the current directory is the target of a symbolic link. * the current directory is the target of a symbolic link.
* *
* Returns: (type filename): the current directory * Returns: (type filename) (transfer full): the current directory
*/ */
gchar * gchar *
g_get_current_dir (void) g_get_current_dir (void)