mirror of
https://gitlab.gnome.org/GNOME/glib.git
synced 2025-04-26 17:16:53 +02:00
Partly revert "glib: Add filename type annotations"
Revert all annotation changes for environment variables and command line arguments. See commit 41013a01f44e9fc15ffef55eae78af2425bbd5a3.
This commit is contained in:
parent
9198f19d97
commit
c9dd204909
@ -67,15 +67,15 @@ g_environ_find (gchar **envp,
|
|||||||
|
|
||||||
/**
|
/**
|
||||||
* g_environ_getenv:
|
* g_environ_getenv:
|
||||||
* @envp: (allow-none) (array zero-terminated=1) (transfer none) (element-type filename):
|
* @envp: (allow-none) (array zero-terminated=1) (transfer none): an environment
|
||||||
* an environment list (eg, as returned from g_get_environ()), or %NULL
|
* list (eg, as returned from g_get_environ()), or %NULL
|
||||||
* for an empty environment list
|
* for an empty environment list
|
||||||
* @variable: (type filename): the environment variable to get
|
* @variable: the environment variable to get
|
||||||
*
|
*
|
||||||
* Returns the value of the environment variable @variable in the
|
* Returns the value of the environment variable @variable in the
|
||||||
* provided list @envp.
|
* provided list @envp.
|
||||||
*
|
*
|
||||||
* Returns: (type filename): the value of the environment variable, or %NULL if
|
* Returns: the value of the environment variable, or %NULL if
|
||||||
* the environment variable is not set in @envp. The returned
|
* the environment variable is not set in @envp. The returned
|
||||||
* string is owned by @envp, and will be freed if @variable is
|
* string is owned by @envp, and will be freed if @variable is
|
||||||
* set or unset again.
|
* set or unset again.
|
||||||
@ -99,20 +99,19 @@ g_environ_getenv (gchar **envp,
|
|||||||
|
|
||||||
/**
|
/**
|
||||||
* g_environ_setenv:
|
* g_environ_setenv:
|
||||||
* @envp: (allow-none) (array zero-terminated=1) (element-type filename) (transfer full):
|
* @envp: (allow-none) (array zero-terminated=1) (transfer full): an
|
||||||
* an environment list that can be freed using g_strfreev() (e.g., as
|
* environment list that can be freed using g_strfreev() (e.g., as
|
||||||
* returned from g_get_environ()), or %NULL for an empty
|
* returned from g_get_environ()), or %NULL for an empty
|
||||||
* environment list
|
* environment list
|
||||||
* @variable: (type filename): the environment variable to set, must not
|
* @variable: the environment variable to set, must not contain '='
|
||||||
* contain '='
|
* @value: the value for to set the variable to
|
||||||
* @value: (type filename): the value for to set the variable to
|
|
||||||
* @overwrite: whether to change the variable if it already exists
|
* @overwrite: whether to change the variable if it already exists
|
||||||
*
|
*
|
||||||
* Sets the environment variable @variable in the provided list
|
* Sets the environment variable @variable in the provided list
|
||||||
* @envp to @value.
|
* @envp to @value.
|
||||||
*
|
*
|
||||||
* Returns: (array zero-terminated=1) (element-type filename) (transfer full):
|
* Returns: (array zero-terminated=1) (transfer full): the
|
||||||
* the updated environment list. Free it using g_strfreev().
|
* updated environment list. Free it using g_strfreev().
|
||||||
*
|
*
|
||||||
* Since: 2.32
|
* Since: 2.32
|
||||||
*/
|
*/
|
||||||
@ -187,17 +186,16 @@ g_environ_unsetenv_internal (gchar **envp,
|
|||||||
|
|
||||||
/**
|
/**
|
||||||
* g_environ_unsetenv:
|
* g_environ_unsetenv:
|
||||||
* @envp: (allow-none) (array zero-terminated=1) (element-type filename) (transfer full):
|
* @envp: (allow-none) (array zero-terminated=1) (transfer full): an environment
|
||||||
* an environment list that can be freed using g_strfreev() (e.g., as
|
* list that can be freed using g_strfreev() (e.g., as returned from g_get_environ()),
|
||||||
* returned from g_get_environ()), or %NULL for an empty environment list
|
* or %NULL for an empty environment list
|
||||||
* @variable: (type filename): the environment variable to remove, must not
|
* @variable: the environment variable to remove, must not contain '='
|
||||||
* contain '='
|
|
||||||
*
|
*
|
||||||
* Removes the environment variable @variable from the provided
|
* Removes the environment variable @variable from the provided
|
||||||
* environment @envp.
|
* environment @envp.
|
||||||
*
|
*
|
||||||
* Returns: (array zero-terminated=1) (element-type filename) (transfer full):
|
* Returns: (array zero-terminated=1) (transfer full): the
|
||||||
* the updated environment list. Free it using g_strfreev().
|
* updated environment list. Free it using g_strfreev().
|
||||||
*
|
*
|
||||||
* Since: 2.32
|
* Since: 2.32
|
||||||
*/
|
*/
|
||||||
@ -219,7 +217,7 @@ g_environ_unsetenv (gchar **envp,
|
|||||||
|
|
||||||
/**
|
/**
|
||||||
* g_getenv:
|
* g_getenv:
|
||||||
* @variable: (type filename): the environment variable to get
|
* @variable: the environment variable to get
|
||||||
*
|
*
|
||||||
* Returns the value of an environment variable.
|
* Returns the value of an environment variable.
|
||||||
*
|
*
|
||||||
@ -229,7 +227,7 @@ g_environ_unsetenv (gchar **envp,
|
|||||||
* On Windows, in case the environment variable's value contains
|
* On Windows, in case the environment variable's value contains
|
||||||
* references to other environment variables, they are expanded.
|
* references to other environment variables, they are expanded.
|
||||||
*
|
*
|
||||||
* Returns: (type filename): the value of the environment variable, or %NULL if
|
* Returns: the value of the environment variable, or %NULL if
|
||||||
* the environment variable is not found. The returned string
|
* the environment variable is not found. The returned string
|
||||||
* may be overwritten by the next call to g_getenv(), g_setenv()
|
* may be overwritten by the next call to g_getenv(), g_setenv()
|
||||||
* or g_unsetenv().
|
* or g_unsetenv().
|
||||||
@ -244,9 +242,8 @@ g_getenv (const gchar *variable)
|
|||||||
|
|
||||||
/**
|
/**
|
||||||
* g_setenv:
|
* g_setenv:
|
||||||
* @variable: (type filename): the environment variable to set, must not
|
* @variable: the environment variable to set, must not contain '='.
|
||||||
* contain '='.
|
* @value: the value for to set the variable to.
|
||||||
* @value: (type filename): the value for to set the variable to.
|
|
||||||
* @overwrite: whether to change the variable if it already exists.
|
* @overwrite: whether to change the variable if it already exists.
|
||||||
*
|
*
|
||||||
* Sets an environment variable. On UNIX, both the variable's name and
|
* Sets an environment variable. On UNIX, both the variable's name and
|
||||||
@ -314,8 +311,7 @@ extern char **environ;
|
|||||||
|
|
||||||
/**
|
/**
|
||||||
* g_unsetenv:
|
* g_unsetenv:
|
||||||
* @variable: (type filename): the environment variable to remove, must
|
* @variable: the environment variable to remove, must not contain '='
|
||||||
* not contain '='
|
|
||||||
*
|
*
|
||||||
* Removes an environment variable from the environment.
|
* Removes an environment variable from the environment.
|
||||||
*
|
*
|
||||||
@ -365,9 +361,8 @@ g_unsetenv (const gchar *variable)
|
|||||||
* use cases for environment variables in GLib-using programs you want
|
* use cases for environment variables in GLib-using programs you want
|
||||||
* the UTF-8 encoding that this function and g_getenv() provide.
|
* the UTF-8 encoding that this function and g_getenv() provide.
|
||||||
*
|
*
|
||||||
* Returns: (array zero-terminated=1) (element-type filename) (transfer full):
|
* Returns: (array zero-terminated=1) (transfer full): a %NULL-terminated
|
||||||
* a %NULL-terminated list of strings which must be freed with
|
* list of strings which must be freed with g_strfreev().
|
||||||
* g_strfreev().
|
|
||||||
*
|
*
|
||||||
* Since: 2.8
|
* Since: 2.8
|
||||||
*/
|
*/
|
||||||
@ -407,8 +402,8 @@ g_listenv (void)
|
|||||||
* The return value is freshly allocated and it should be freed with
|
* The return value is freshly allocated and it should be freed with
|
||||||
* g_strfreev() when it is no longer needed.
|
* g_strfreev() when it is no longer needed.
|
||||||
*
|
*
|
||||||
* Returns: (array zero-terminated=1) (element-type filename) (transfer full):
|
* Returns: (array zero-terminated=1) (transfer full): the list of
|
||||||
* the list of environment variables
|
* environment variables
|
||||||
*
|
*
|
||||||
* Since: 2.28
|
* Since: 2.28
|
||||||
*/
|
*/
|
||||||
|
@ -190,7 +190,7 @@ unquote_string_inplace (gchar* str, gchar** end, GError** err)
|
|||||||
|
|
||||||
/**
|
/**
|
||||||
* g_shell_quote:
|
* g_shell_quote:
|
||||||
* @unquoted_string: (type filename): a literal string
|
* @unquoted_string: a literal string
|
||||||
*
|
*
|
||||||
* Quotes a string so that the shell (/bin/sh) will interpret the
|
* Quotes a string so that the shell (/bin/sh) will interpret the
|
||||||
* quoted string to mean @unquoted_string. If you pass a filename to
|
* quoted string to mean @unquoted_string. If you pass a filename to
|
||||||
@ -199,7 +199,7 @@ unquote_string_inplace (gchar* str, gchar** end, GError** err)
|
|||||||
* quoting style used is undefined (single or double quotes may be
|
* quoting style used is undefined (single or double quotes may be
|
||||||
* used).
|
* used).
|
||||||
*
|
*
|
||||||
* Returns: (type filename): quoted string
|
* Returns: quoted string
|
||||||
**/
|
**/
|
||||||
gchar*
|
gchar*
|
||||||
g_shell_quote (const gchar *unquoted_string)
|
g_shell_quote (const gchar *unquoted_string)
|
||||||
@ -240,7 +240,7 @@ g_shell_quote (const gchar *unquoted_string)
|
|||||||
|
|
||||||
/**
|
/**
|
||||||
* g_shell_unquote:
|
* g_shell_unquote:
|
||||||
* @quoted_string: (type filename): shell-quoted string
|
* @quoted_string: shell-quoted string
|
||||||
* @error: error return location or NULL
|
* @error: error return location or NULL
|
||||||
*
|
*
|
||||||
* Unquotes a string as the shell (/bin/sh) would. Only handles
|
* Unquotes a string as the shell (/bin/sh) would. Only handles
|
||||||
@ -265,7 +265,7 @@ g_shell_quote (const gchar *unquoted_string)
|
|||||||
* be escaped with backslash. Otherwise double quotes preserve things
|
* be escaped with backslash. Otherwise double quotes preserve things
|
||||||
* literally.
|
* literally.
|
||||||
*
|
*
|
||||||
* Returns: (type filename): an unquoted string
|
* Returns: an unquoted string
|
||||||
**/
|
**/
|
||||||
gchar*
|
gchar*
|
||||||
g_shell_unquote (const gchar *quoted_string,
|
g_shell_unquote (const gchar *quoted_string,
|
||||||
@ -618,10 +618,10 @@ tokenize_command_line (const gchar *command_line,
|
|||||||
|
|
||||||
/**
|
/**
|
||||||
* g_shell_parse_argv:
|
* g_shell_parse_argv:
|
||||||
* @command_line: (type filename): command line to parse
|
* @command_line: command line to parse
|
||||||
* @argcp: (out) (optional): return location for number of args
|
* @argcp: (out) (optional): return location for number of args
|
||||||
* @argvp: (out) (optional) (array length=argcp zero-terminated=1) (element-type filename):
|
* @argvp: (out) (optional) (array length=argcp zero-terminated=1): return
|
||||||
* return location for array of args
|
* location for array of args
|
||||||
* @error: (optional): return location for error
|
* @error: (optional): return location for error
|
||||||
*
|
*
|
||||||
* Parses a command line into an argument vector, in much the same way
|
* Parses a command line into an argument vector, in much the same way
|
||||||
|
@ -105,12 +105,9 @@ G_DEFINE_QUARK (g-spawn-exit-error-quark, g_spawn_exit_error)
|
|||||||
|
|
||||||
/**
|
/**
|
||||||
* g_spawn_async:
|
* g_spawn_async:
|
||||||
* @working_directory: (type filename) (allow-none): child's current working
|
* @working_directory: (type filename) (allow-none): child's current working directory, or %NULL to inherit parent's
|
||||||
* directory, or %NULL to inherit parent's
|
* @argv: (array zero-terminated=1): child's argument vector
|
||||||
* @argv: (array zero-terminated=1) (element-type filename):
|
* @envp: (array zero-terminated=1) (allow-none): child's environment, or %NULL to inherit parent's
|
||||||
* child's argument vector
|
|
||||||
* @envp: (array zero-terminated=1) (element-type filename) (allow-none):
|
|
||||||
* child's environment, or %NULL to inherit parent's
|
|
||||||
* @flags: flags from #GSpawnFlags
|
* @flags: flags from #GSpawnFlags
|
||||||
* @child_setup: (scope async) (allow-none): function to run in the child just before exec()
|
* @child_setup: (scope async) (allow-none): function to run in the child just before exec()
|
||||||
* @user_data: (closure): user data for @child_setup
|
* @user_data: (closure): user data for @child_setup
|
||||||
@ -218,12 +215,9 @@ read_data (GString *str,
|
|||||||
|
|
||||||
/**
|
/**
|
||||||
* g_spawn_sync:
|
* g_spawn_sync:
|
||||||
* @working_directory: (type filename) (allow-none): child's current working
|
* @working_directory: (type filename) (allow-none): child's current working directory, or %NULL to inherit parent's
|
||||||
* directory, or %NULL to inherit parent's
|
* @argv: (array zero-terminated=1): child's argument vector
|
||||||
* @argv: (array zero-terminated=1) (element-type filename):
|
* @envp: (array zero-terminated=1) (allow-none): child's environment, or %NULL to inherit parent's
|
||||||
* child's argument vector
|
|
||||||
* @envp: (array zero-terminated=1) (element-type filename) (allow-none):
|
|
||||||
* child's environment, or %NULL to inherit parent's
|
|
||||||
* @flags: flags from #GSpawnFlags
|
* @flags: flags from #GSpawnFlags
|
||||||
* @child_setup: (scope async) (allow-none): function to run in the child just before exec()
|
* @child_setup: (scope async) (allow-none): function to run in the child just before exec()
|
||||||
* @user_data: (closure): user data for @child_setup
|
* @user_data: (closure): user data for @child_setup
|
||||||
@ -473,13 +467,9 @@ g_spawn_sync (const gchar *working_directory,
|
|||||||
|
|
||||||
/**
|
/**
|
||||||
* g_spawn_async_with_pipes:
|
* g_spawn_async_with_pipes:
|
||||||
* @working_directory: (type filename) (allow-none): child's current working
|
* @working_directory: (type filename) (allow-none): child's current working directory, or %NULL to inherit parent's, in the GLib file name encoding
|
||||||
* directory, or %NULL to inherit parent's, in the GLib file name encoding
|
* @argv: (array zero-terminated=1): child's argument vector, in the GLib file name encoding
|
||||||
* @argv: (array zero-terminated=1) (element-type filename): child's argument
|
* @envp: (array zero-terminated=1) (allow-none): child's environment, or %NULL to inherit parent's, in the GLib file name encoding
|
||||||
* vector, in the GLib file name encoding
|
|
||||||
* @envp: (array zero-terminated=1) (element-type filename) (allow-none):
|
|
||||||
* child's environment, or %NULL to inherit parent's, in the GLib file
|
|
||||||
* name encoding
|
|
||||||
* @flags: flags from #GSpawnFlags
|
* @flags: flags from #GSpawnFlags
|
||||||
* @child_setup: (scope async) (allow-none): function to run in the child just before exec()
|
* @child_setup: (scope async) (allow-none): function to run in the child just before exec()
|
||||||
* @user_data: (closure): user data for @child_setup
|
* @user_data: (closure): user data for @child_setup
|
||||||
@ -686,7 +676,7 @@ g_spawn_async_with_pipes (const gchar *working_directory,
|
|||||||
|
|
||||||
/**
|
/**
|
||||||
* g_spawn_command_line_sync:
|
* g_spawn_command_line_sync:
|
||||||
* @command_line: (type filename): a command line
|
* @command_line: a command line
|
||||||
* @standard_output: (out) (array zero-terminated=1) (element-type guint8) (allow-none): return location for child output
|
* @standard_output: (out) (array zero-terminated=1) (element-type guint8) (allow-none): return location for child output
|
||||||
* @standard_error: (out) (array zero-terminated=1) (element-type guint8) (allow-none): return location for child errors
|
* @standard_error: (out) (array zero-terminated=1) (element-type guint8) (allow-none): return location for child errors
|
||||||
* @exit_status: (out) (allow-none): return location for child exit status, as returned by waitpid()
|
* @exit_status: (out) (allow-none): return location for child exit status, as returned by waitpid()
|
||||||
@ -751,7 +741,7 @@ g_spawn_command_line_sync (const gchar *command_line,
|
|||||||
|
|
||||||
/**
|
/**
|
||||||
* g_spawn_command_line_async:
|
* g_spawn_command_line_async:
|
||||||
* @command_line: (type filename): a command line
|
* @command_line: a command line
|
||||||
* @error: return location for errors
|
* @error: return location for errors
|
||||||
*
|
*
|
||||||
* A simple version of g_spawn_async() that parses a command line with
|
* A simple version of g_spawn_async() that parses a command line with
|
||||||
|
Loading…
x
Reference in New Issue
Block a user