glib-genmarshal.1.lzma | glib-genmarshal.1 | |||
---|---|---|---|---|
GLIB-GENMARSHAL(1) [FIXME: manual] GLIB-GENMARSH AL(1) | GLIB-GENMARSHAL(1) User Commands GLIB-GENMARSH AL(1) | |||
NAME | NAME | |||
glib-genmarshal - C code marshaller generation utility for GLib clos ures | glib-genmarshal - C code marshaller generation utility for GLib clos ures | |||
SYNOPSIS | SYNOPSIS | |||
glib-genmarshal [options...] [files...] | glib-genmarshal [options...] [files...] | |||
DESCRIPTION | DESCRIPTION | |||
glib-genmarshal is a small utility that generates C code marshallers for callback functions of the GClosure mechanism in the GObject sublibrary of GLib. The marshaller functions have a standard signature, they get pass ed in | glib-genmarshal is a small utility that generates C code marshallers for callback functions of the GClosure mechanism in the GObject sublibrary of GLib. The marshaller functions have a standard signature, they get pass ed in | |||
the invoking closure, an array of value structures holding the callb ack function parameters and a value structure for the return value of the c allback. The marshaller is then responsible to call the respective C code | the invoking closure, an array of value structures holding the callb ack function parameters and a value structure for the return value of the c allback. The marshaller is then responsible to call the respective C code | |||
skipping to change at line 25 | skipping to change at line 25 | |||
glib-genmarshal takes a list of marshallers to generate as input. Th e marshaller list is either read from standard input or from files passed a s additional arguments on the command line. | glib-genmarshal takes a list of marshallers to generate as input. Th e marshaller list is either read from standard input or from files passed a s additional arguments on the command line. | |||
Options | Options | |||
--header | --header | |||
Generate header file contents of the marshallers. | Generate header file contents of the marshallers. | |||
--body | --body | |||
Generate C code file contents of the marshallers. | Generate C code file contents of the marshallers. | |||
--prefix=string, --prefix string | --prefix=string, --prefix string | |||
Specify marshaller prefix. The default prefix is `g_cclosure_mar shal´. | Specify marshaller prefix. The default prefix is `g_cclosure_mar shal'. | |||
--skip-source | --skip-source | |||
Skip source location remarks in generated comments. | Skip source location remarks in generated comments. | |||
--nostdinc | --nostdinc | |||
Do not use the standard marshallers of the GObject library, and skip gmarshal.h include directive in generated header files. | Do not use the standard marshallers of the GObject library, and skip gmarshal.h include directive in generated header files. | |||
--g-fatal-warnings | --g-fatal-warnings | |||
Make warnings fatal, that is, exit immediately once a warning oc curs. | Make warnings fatal, that is, exit immediately once a warning oc curs. | |||
skipping to change at line 55 | skipping to change at line 55 | |||
# this is a comment | # this is a comment | |||
or a marshaller specification of the form | or a marshaller specification of the form | |||
RTYPE:PTYPE | RTYPE:PTYPE | |||
RTYPE:PTYPE,PTYPE | RTYPE:PTYPE,PTYPE | |||
RTYPE:PTYPE,PTYPE,PTYPE | RTYPE:PTYPE,PTYPE,PTYPE | |||
(up to 16 PTYPEs may be present). | (up to 16 PTYPEs may be present). | |||
The RTYPE part specifies the callback´s return type and the PTYPEs r ight to the colon specify the callback´s parameter list, except for the fir st and the last arguments which are always pointers. | The RTYPE part specifies the callback's return type and the PTYPEs r ight to the colon specify the callback's parameter list, except for the fir st and the last arguments which are always pointers. | |||
Parameter types | Parameter types | |||
Currently, the following types are supported: | Currently, the following types are supported: | |||
VOID | VOID | |||
indicates no return type, or no extra parameters. If VOID is use d as the parameter list, no additional parameters may be present. | indicates no return type, or no extra parameters. If VOID is use d as the parameter list, no additional parameters may be present. | |||
BOOLEAN | BOOLEAN | |||
for boolean types (gboolean) | for boolean types (gboolean) | |||
skipping to change at line 117 | skipping to change at line 117 | |||
PARAM | PARAM | |||
for GParamSpec or derived types (GParamSpec*) | for GParamSpec or derived types (GParamSpec*) | |||
POINTER | POINTER | |||
for anonymous pointer types (gpointer) | for anonymous pointer types (gpointer) | |||
OBJECT | OBJECT | |||
for GObject or derived types (GObject*) | for GObject or derived types (GObject*) | |||
VARIANT | ||||
for GVariant types (GVariant*) | ||||
NONE | NONE | |||
deprecated alias for VOID | deprecated alias for VOID | |||
BOOL | BOOL | |||
deprecated alias for BOOLEAN | deprecated alias for BOOLEAN | |||
EXAMPLE | EXAMPLE | |||
To generate marshallers for the following callback functions: | To generate marshallers for the following callback functions: | |||
void foo (gpointer data1, | void foo (gpointer data1, | |||
skipping to change at line 170 | skipping to change at line 173 | |||
glib-mkenums(1) | glib-mkenums(1) | |||
BUGS | BUGS | |||
None known yet. | None known yet. | |||
AUTHOR | AUTHOR | |||
glib-genmarshal has been written by Tim Janik timj@gtk.org. | glib-genmarshal has been written by Tim Janik timj@gtk.org. | |||
This manual page was provided by Tim Janik timj@gtk.org. | This manual page was provided by Tim Janik timj@gtk.org. | |||
[FIXME: source] 05/02/2010 GLIB-GENMARSH AL(1) | User Commands 06/05/2011 GLIB-GENMARSH AL(1) | |||
End of changes. 5 change blocks. | ||||
3 lines changed or deleted | 6 lines changed or added | |||
This html diff was produced by rfcdiff 1.41. The latest version is available from http://tools.ietf.org/tools/rfcdiff/ |