# derb

## NAME



           **derb** - disassemble a resource bundle
    


## SYNOPSIS



           **derb**[ **-h** , **-?** , **--help**] [ **-V** , **--version**] [ **-v** , **--verbose**] [ **-e** ,
           **--encoding** _encoding_ ] [ **--bom**] [ **-t** , **--truncate**[ _size_ ] ] [ **-s** ,
           **--sourcedir** _source_ ] [ **-d** , **--destdir** _destination_ ] [ **-i** ,
           **--icudatadir** _directory_ ] [ **-c** , **--to-stdout**] _bundle_ ...
    


## DESCRIPTION



           **derb** reads the compiled resource _bundle_ files passed on the
           command line and write them back in text form.  The resulting text
           files have a **.txt** extension while compiled resource bundle source
           files typically have a **.res** extension.
    
           It is customary to name the resource bundles by their locale name,
           i.e. to use a local identifier for the _bundle_ filename, e.g.
           **ja_JP.res** for Japanese (Japan) data, or **root.res** for the root
           bundle.  This is especially important for **derb** since the locale
           name is not accessible directly from the compiled resource bundle,
           and to know which locale to ask for when opening the bundle.  **derb**
           will produce a file whose base name is the base name of the
           compiled resource file itself.  If the **--to-stdout** , **-c** option is
           used, however, the text will be written on the standard output.
    


## OPTIONS



           **-h** , **-?** , **--help**
                  Print help about usage and exit.
    
           **-V** , **--version**
                  Print the version of **derb** and exit.
    
           **-v** , **--verbose**
                  Display extra informative messages during execution.
    
           **-A** , **--suppressAliases**
                  Don't follow aliases when producing output.
    
           **-e** , **--encoding** _encoding_
                  Set the encoding used to write output files to _encoding_.
                  The default encoding is the invariant (subset of ASCII or
                  EBCDIC) codepage for the system (see section **INVARIANT**
                  **CHARACTERS**).  The choice of the encoding does not affect
                  the data, just their representation. Characters that cannot
                  be represented in the _encoding_ will be represented using
                  **\u** _hhhh_ escape sequences.
    
           **--bom** Write a byte order mark (BOM) at the beginning of the file.
    
           **-l** , **--locale** _locale_
                  Set the _locale_ for the resource bundle, which is used both
                  in the generated text and as the base name of the output
                  file.
    
           **-t** , **--truncate**[ _size_ ]
                  Truncate individual resources (strings or binary data) to
                  _size_ bytes. The default if _size_ is not specified is **80**
                  bytes.
    
           **-s** , **--sourcedir** _source_
                  Set the source directory to _source_.  The default source
                  directory is the current directory.  If **-** is passed for
                  _source_ , then the _bundle_ will be looked for in its default
                  location, specified by the **ICU_DATA** environment variable
                  (or defaulting to the location set when ICU was built if
                  **ICU_DATA** is not set).
    
           **-d** , **--destdir** _destination_
                  Set the destination directory to _destination_.  The default
                  destination directory is specified by the environment
                  variable **ICU_DATA** or is the location set when ICU was built
                  if **ICU_DATA** is not set.
    
           **-i** , **--icudatadir** _directory_
                  Look for any necessary ICU data files in _directory_.  For
                  example, when processing collation overrides, the file
                  **ucadata.dat** must be located.  The default ICU data
                  directory is specified by the environment variable
                  **ICU_DATA**.
    
           **-c** , **--to-stdout**
                  Write the disassembled _bundle_ on standard output instead of
                  into a file.
    


## CAVEATS



           When the option **--bom** is used, the character **U+FEFF** is written in
           the destination _encoding_ regardless of whether it is a Unicode
           transformation format (UTF) or not.  This option should only be
           used with an UTF encoding, as byte order marks are not meaningful
           for other encodings.
    


## INVARIANT CHARACTERS



           The **invariant character set** consists of the following set of
           characters, expressed as a standard POSIX regular expression: **[a-**
           **z]|[A-Z]|[0-9]|_| |+|-|*|/**.  This is the set which is guaranteed
           to be available regardless of code page.
    


## ENVIRONMENT



           **ICU_DATA**
                  Specifies the directory containing ICU data. Defaults to
                  **${prefix}/share/icu/76.0.1/**.  Some tools in ICU depend on
                  the presence of the trailing slash. It is thus important to
                  make sure that it is present if **ICU_DATA** is set.
    


## VERSION



           1.0
    


* * *