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