office-gobmx/rsc
Michael Stahl c923f7d2c2 gbuild: "use" vs. "add":
Naming convention for gbuild methods:
- "add" is used for stuff that is logically a part of the target
  (i.e. not registered at the Module, but defined in the target's makefile)
- "use" is used for stuff that is logically a different target
  (i.e. it is registered at the Module, has it's own makefile, may be
  in a different module than the target)
2012-04-08 01:05:52 +02:00
..
doku/feinkonz.43
inc
prj
source
Executable_rsc.mk
Makefile
Module_rsc.mk
Package_inc.mk
README

Resource Compiler.

This compiler converts .src files and .hrc equivalents into binary
.res files.  The basic idea is that this provides a map between
integer identifiers and the resources: string, pixmap (only the
file-name), and VCL control properties.

In more detail:

Typically we would have a .hrc file with entries like this:

#define SID_STR_FOO    1234

And then a .src file with some entries like this:

String SID_STR_FOO
{
    Text [ en-US ] = "Foo !" ;
};

This is compiled into a binary resource file, we have many of these
which live in program/resource/ and then tends to get used in the code
thus:

String aStr( ResId( SID_STR_FOO ) );

It is important to note that any appearance of hierarchical structure
in the .src files is in fact a mirage. The file is compiled at root
into a plain map<integer,resource>.

There is some German documentation about it in a subdirectory called
[git:rsc/doku].  Seems to be very old (January 1992).