[monodis] Document --show-tokens

[mono.git] / mono / dis / monodis.1

diff --git a/mono/dis/monodis.1 b/mono/dis/monodis.1
index 9fdad5eea01e48e0314ac10f552f0a74fb2622d9..5783a12fd81f1ec8c241238750f680bc520dea3b 100644 (file)
--- a/mono/dis/monodis.1
+++ b/mono/dis/monodis.1
@@ -37,6 +37,7 @@ monodis \- CIL image content dumper and disassembler.
 [\-\-module]
 [\-\-moduleref]
 [\-\-mresources]
+[\-\-presources]
 [\-\-nested]
 [\-\-param]
 [\-\-parconst]
@@ -47,10 +48,20 @@ monodis \- CIL image content dumper and disassembler.
 [\-\-typeref]
 [\-\-typespec]
 [\-\-blob]
+[\-\-strings]
+[\-\-userstrings]
 [FILES...]
 .SH DESCRIPTION
-The \fImonodis\fP program is used to dump the contents a CIL image
-(contained in .EXE files that contain extended PE/COFF CIL code).  
+The \fImonodis\fP program is used to dump the contents an ECMA/ISO CIL
+image (contained in .EXE files that contain extended PE/COFF CIL
+code).
+.PP
+To roundtrip assemblies using ilasm, it is best to use the --output
+argument, as that will make monodis save the embedded resources in
+files that can later be properly embedded back by ilasm. 
+.PP
+Additionally, the tool can be used to dump the contents of the various
+ECMA CIL metadata tables.
 .SH OPTIONS
 The following Generic options are supported:
 .TP
@@ -65,7 +76,13 @@ For non-corlib assemblies, use "mscorlib" as the assembly name. This
 is useful for round-tripping the IL with ilasm.
 .TP
 .I "--show-method-tokens"
-Display tokens for dissasembled methods.
+Display tokens for disassembled methods.
+.TP
+.I "--show-tokens"
+Display tokens for strings, types, methods, fields, etc.
+.SH OPTIONS TO DISPLAY METADATA TABLES
+The following options are used to display metadata tables instead of
+disassembling the CIL image.
 .TP
 .I "--assembly"
 Dumps the contents of the Assembly table.
@@ -137,7 +154,12 @@ Dumps the contents of the Module table.
 Dumps the contents of the ModuleRef table.
 .TP
 .I "--mresources"
-Dumps the managed resources embedded in the assembly.
+Saves all the managed resources embedded in the assembly into the
+current directory.   To get a list of the embedded resources use the
+--manifest option.
+.TP
+.I "--presources"
+Prints offsets and names of manifest resources embedded in the assembly.
 .TP
 .I "--nested"
 Dumps the contents of the NestedClass table.
@@ -168,6 +190,12 @@ Dumps the contents of the TypeRef table.
 .TP
 .I "--blob"
 Dumps the entire contents of the blob stream as hex.
+.TP
+.I "--strings"
+Dumps the contents of the Strings heap.
+.TP
+.I "--userstrings"
+Dumps the contents of the User-Strings heap
 .PP
 If no flags are specified the program dumps the content of the image
 in a format that can be used to rountrip the code.