| 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/ | ||||