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.

       --version
          Print program version 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 it 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.

          Also see --dependency-file.

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

       --external-data
          By  default,  code  generated  by --generate-source embeds the resource data as a string literal. When
          --external-data is given, the data is only declared in the generated C file, and the data  has  to  be
          linked externally.

       --dependency-file <FILE>
          Write  dependencies  in the same style as gcc -M -MF to the given file. If FILE is -, the dependencies
          are written to the standard output. Unlike --generate-dependencies, this option can be  combined  with
          other --generate options to generate dependencies as a side-effect of generating sources.

       --generate-phony-targets
          When  creating a dependency file with --dependency-file include phony targets in the same style as gcc
          -MP. This would typically be used with make.

       --compiler <NAME>
          Generate code that is going to target the given compiler NAME. The current two compiler modes are gcc,
          for all GCC-compatible toolchains; and msvc, for the Microsoft Visual C Compiler. If this option isn’t
          set, then the default will be taken from the CC environment variable.

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 for in the PATH.

       GDK_PIXBUF_PIXDATA
          Deprecated since gdk-pixbuf 2.32,  as  GResource  supports  embedding  modern  image  formats  without
          conversion.

          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 for in the PATH.

       JSON_GLIB_FORMAT
          The  full  path  to  the  json-glib-format  executable.  This is used to preprocess resources with the
          json-stripblanks preprocessing option. If this environment variable is not  set,  json-glib-format  is
          searched for in the PATH.

                                                                                        GLIB-COMPILE-RESOURCES()