NAME

       glib-compile-resources - GLib resource compiler

SYNOPSIS

       glib-compile-resources [OPTION...] {FILE}

DESCRIPTION

       glib-compile-resources reads the resource description from FILE and the files that it
       references and creates a binary resource bundle that is suitable for use with the
       GResource API. The resulting bundle is then written out as-is, or as C source for linking
       into an application.

       The XML resource files normally have the filename extension .gresource.xml. For a detailed
       description of the XML file format, see the GResource documentation.

OPTIONS

       -h, --help
           Print help and exit

       --target=TARGET
           Store the compiled resources in the file TARGET. If not specified a filename based on
           the FILE basename is used.

       --sourcedir=DIRECTORY
           The files referenced in FILE are loaded from this directory. If not specified, the
           current directory is used.

       --generate
           Write the output file in the format selected for by its filename extension:

           .c
               C source

           .h
               C header

           .gresource
               resource bundle

       --generate-source
           Instead of a writing the resource bundle in binary form create a C source file that
           contains the resource bundle. This can then be compiled into an application for easy
           access.

       --generate-header
           Generate a header file for use with C code generated by --generate-source.

       --generate-dependencies
           Prints the list of files that the resource bundle references to standard output. This
           can be used to track dependencies in the build system. For example, the following make
           rule would mark test.gresource as depending on all the files that test.gresource.xml
           includes, so that is is automatically rebuilt if any of them change:

               test.gresource: test.gresource.xml $(shell $(GLIB_COMPILE_RESOURCES) --generate-dependencies test.gresource.xml)

           Note that this may or may not be portable to non-GNU make.

       --c-name
           Specify the prefix used for the C identifiers in the code generated by
           --generate-source and --generate-header.

       --manual-register
           By default code generated by --generate-source uses automatic initialization of the
           resource. This works on most systems by using the compiler support for constructors.
           However, some (uncommon) compilers may not support this, you can then specify
           --manual-register, which will generate custom register and unregister functions that
           your code can manually call at initialization and uninitialization time.

       --internal
           By default code generated by --generate-source declares all initialization functions
           as extern. So they are exported unless this is prevented by a link script or other
           means. Since libraries usually want to use the functions only internally it can be
           more useful to declare them as G_GNUC_INTERNAL which is what --internal does.

ENVIRONMENT

       XMLLINT
           The full path to the xmllint executable. This is used to preprocess resources with the
           xml-stripblanks preprocessing option. If this environment variable is not set, xmllint
           is searched in the PATH.

       GDK_PIXBUF_PIXDATA
           The full path to the gdk-pixbuf-pixdata executable. This is used to preprocess
           resources with the to-pixdata preprocessing option. If this environment variable is
           not set, gdk-pixbuf-pixdata is searched in the PATH.