epocrc
combines the actions of passing a resource file
through the C++ preprocessor, and then compiling it with rcomp
.
epocrc [-Dargs] [-Iargs] [-u] [-ttmpdir] [-uid2 uid] [-uid3 uid] source-file [-ooutput-file] [-hheader-file]
|
|
Apart from the options listed above, you can use the
epocrc.config
file located at epoc32\tools\
to
configure the pre-processor and the rcomp
tool. The file is
supplied to each Symbian OS licensee as they need it, but it may not be present
on some platforms.
The epocrc.config
file contains the following options:
check_rls_items
: This option can either be set to 0
or 1. If you want to check for the presence of localisation comment tags before
each RLS item declaration, set it to 1, otherwise set it to 0. If there are no
localisation comment tags within the resource file, it is assumed that
localisation is not required for this file.
strict_checking
: This option can either be set to 0
or 1. If you set it to 1, the rcomp
tool warns you if the
rpp
file contains RLS item declarations without the localisation
comment tags. If you want to enable this functionality, you must set
check_rls_items
to 1.
include:
: This option is used to specify files and
directories, which need to be passed to the C++ pre-processor. File names and
directory names must be relative to EPOCROOT
.
Note: You can comment a line in the
epocrc.config
file by preceding it by '#'.
Here is an example of the epocrc.config
file, which
enables the strict_checking
and check_rls_items
options, and lists the resource headers to be included using the
include:
option:
# epocrc.config
#
# Copyright (c) 2005 Symbian Ltd. All rights reserved.
#
check_rls_items = 1;
strict_checking = 1;
include: epoc32\include\SymbianTags.rh
include: epoc32\include\SymbainContexts.rh
The following example compiles the source file ex.rss
into
the compiled resource file ex.rsc
and the header file
ex.rsg
.
> epocrc -I\symbian\epoc32\include\ -u ex.rss -oex.rsc
-hex.rsg