2002-03-24 Martin Baulig <martin@gnome.org>

	* man/mcs.1: Documented the new --debug option and added a section
	about debugging support.

	* man/mono.1: Documented the new --dwarf and --dwarf-plus options.

svn path=/trunk/mono/; revision=3311

diff --git a/ChangeLog b/ChangeLog
index da424852c7afd538d28b8d932b9d45c4b4cfd40c..e886622023a4e13d51219ea25eb4a77e0b983440 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,10 @@
+2002-03-24  Martin Baulig  <martin@gnome.org>
+
+       * man/mcs.1: Documented the new --debug option and added a section
+       about debugging support.
+
+       * man/mono.1: Documented the new --dwarf and --dwarf-plus options.
+
 2002-03-21  Martin Baulig  <martin@gnome.org>
 
        * configure.in: Added check for <elf.h>.

diff --git a/man/mcs.1 b/man/mcs.1
index da4f9dcdd3c53ff41c79434d7eddf894108af104..8e487965268631fadc97a9ca321ab271063ccbbb 100755 (executable)
--- a/man/mcs.1
+++ b/man/mcs.1
@@ -36,8 +36,10 @@ the math operations checked (the default is unchecked).
 .I \-\-define SYMBOL
 Defines a symbol named SYMBOL.  This can be tested in the source code
 by the pre-processor.
-.TP \-\-debug or \-g
-Generate debugging information.
+.TP
+.I \-\-debug or \-g
+Generate debugging information.  The debugging information is written
+into an assembler file FILE-debug.s.
 .TP
 .I \-\-fatal 
 This is used for debugging the compiler.  This makes the error emission
@@ -117,6 +119,12 @@ Debugging. Turns on verbose yacc parsing.
 Use this to stop option parsing, and allow option-looking parameters
 to be passed on the command line.
 .PP
+.SH DEBUGGING SUPPORT
+When use the "--debug" or "-g" flag, MCS will create an assembler file
+FILE-debug.s containing debugging information where FILE is the name of
+the generated assembly. You need to run this file through the assembler
+to get a object file FILE-debug.o.  See mono's "--dwarf-plus" argument
+for details on how to use this file.
 .SH NOTES
 During compilation the MCS compiler defines the __MonoCS__ symbol,
 this can be used by pre-processor instructions to compile Mono C#

diff --git a/man/mono.1 b/man/mono.1
index d407ace685c3271b2adabbf749db3981a5a8c077..b64fea688f81d40296638818b3462314f712fc61 100644 (file)
--- a/man/mono.1
+++ b/man/mono.1
@@ -49,6 +49,16 @@ created from a stream of CIL opcodes.
 .I "--stabs"
 Writes out stabs debug information
 .TP
+.I "--dwarf"
+Writes out dwarf debug information
+.TP
+.I "--dwarf-plus"
+Uses an extended debugging information file which has been generated
+by MCS.  This extended debugging information will allow you to debug
+C# source code rather than IL code.  To use it, just run the JIT in
+your debugger and call "mono_debug_make_symbols" each time the program
+stops.
+.TP
 .I "--debug method"
 Debugs the method whose name is `method'
 .TP