NAME

       resgen, resgen2 - Mono/CLI Resource Generator

SYNOPSIS

       resgen source.ext [dest.ext]

       resgen /compile source.ext[,dest.resources] [...]

       resgen2

DESCRIPTION

       Convert a resource file from one format to another.

       The currently supported formats are text, resources, resx and po.

       .txt, .text

              Used to process text files, the format of the text file is of the form:

                   key=value

              The  value  argument  can  contain  special  characters  as long as they are escaped.   The escape
              sequences currently supported are \n, \r, \t, \\ (to get the  escape  sequence  itself)  and  with
              resgen2  unicode  escape  sequences are supported with the \uXXXX escape sequence, where XXXX is a
              four digit number.

              Lines that start with the # or ; character are considered comments and ignored.

       '.resources'

              This is the binary file format implemented by the System.Resources.ResourceReader class,  part  of
              mscorlib.dll

       '.resx'

              This is the binary file format implemented by the System.Resources.ResXResourceReader class.  This
              class is not part of mscorlib.dll, this class is part of System.Windows.Forms.

       '.po'.

              PO files are the source files used by the Unix gettext infrastructure that is  typically  used  to
              internationalize applications.

              Lines starting with the '#' character are comment lines.

              The file contains many instance of strings like this:

                   msgid KEY
                   msgstr VALUE

              The  KEY  is  typically  the  string  to  translate and the VALUE is the translation.  On PO files
              instead of using codes as the KEY (as it is customary with resource files) the KEY is typically  a
              complete  english  message  that  applications  embed  in  their source code and will be used as a
              fallback if no translation resources are used.

              Since resources are key value pairs, the extended features in PO files are not supported  (plurals
              and support for N-cases).

              To  learn  more  about  the po file format, use your info browser and point it to the "(gettext)PO
              Files" node.

       If the destination file is not specified, source.resources will be used.

       The /compile option takes a list of .resX or .txt files to convert to the output file name.

OPTIONS

       -compile

              This switch instructs resgen to compile multiple files.  It must appear before any  resources  are
              specified on the command line.

       -usesourcepath

              This option is only available for resgen2, and it instructs resgen to resolve relative paths using
              the directory of the resx file as current directory.

FILES

       This program will load referenced assemblies from the Mono assembly cache.

MAILING LISTS

       Visit http://lists.ximian.com/mailman/listinfo/mono-devel-list for details.

WEB SITE

       Visit: http://www.mono-project.com for details

SEE ALSO

       mcs(1),mono(1),mono-config(5).

                                                                                                    Mono(resgen)