[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Gnash-commit] gnash ChangeLog doc/C/gnash-man.xml doc/C/gnash...
From: |
Rob Savoye |
Subject: |
[Gnash-commit] gnash ChangeLog doc/C/gnash-man.xml doc/C/gnash... |
Date: |
Sat, 10 Feb 2007 04:30:52 +0000 |
CVSROOT: /sources/gnash
Module name: gnash
Changes by: Rob Savoye <rsavoye> 07/02/10 04:30:52
Modified files:
. : ChangeLog
doc/C : gnash-man.xml gnash.xml internals.xml
sources.xml
Added files:
doc/C : debugger.xml
Log message:
* doc/C/debugger.xml: New file about the Flash debugger.
* doc/C/sources.xml: Add --disable-debugger option.
* doc/C/gnash.xml: Add info about the -g option. Add an entity
for
the new debugger chapter.
* doc/C/gnash-man.xml: Add info about the -g option.
CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/gnash/ChangeLog?cvsroot=gnash&r1=1.2295&r2=1.2296
http://cvs.savannah.gnu.org/viewcvs/gnash/doc/C/gnash-man.xml?cvsroot=gnash&r1=1.7&r2=1.8
http://cvs.savannah.gnu.org/viewcvs/gnash/doc/C/gnash.xml?cvsroot=gnash&r1=1.39&r2=1.40
http://cvs.savannah.gnu.org/viewcvs/gnash/doc/C/internals.xml?cvsroot=gnash&r1=1.55&r2=1.56
http://cvs.savannah.gnu.org/viewcvs/gnash/doc/C/sources.xml?cvsroot=gnash&r1=1.28&r2=1.29
http://cvs.savannah.gnu.org/viewcvs/gnash/doc/C/debugger.xml?cvsroot=gnash&rev=1.1
Patches:
Index: ChangeLog
===================================================================
RCS file: /sources/gnash/gnash/ChangeLog,v
retrieving revision 1.2295
retrieving revision 1.2296
diff -u -b -r1.2295 -r1.2296
--- ChangeLog 10 Feb 2007 01:30:31 -0000 1.2295
+++ ChangeLog 10 Feb 2007 04:30:51 -0000 1.2296
@@ -1,5 +1,11 @@
2007-02-09 Rob Savoye <address@hidden>
+ * doc/C/debugger.xml: New file about the Flash debugger.
+ * doc/C/sources.xml: Add --disable-debugger option.
+ * doc/C/gnash.xml: Add info about the -g option. Add an entity for
+ the new debugger chapter.
+ * doc/C/gnash-man.xml: Add info about the -g option.
+
* server/debugger.{cpp, h}: Implement breakpoint functions. Add a
call stack.
* server/vm/ASHandlers.cpp: Break and watch point here.
Index: doc/C/gnash-man.xml
===================================================================
RCS file: /sources/gnash/gnash/doc/C/gnash-man.xml,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -b -r1.7 -r1.8
--- doc/C/gnash-man.xml 25 Jan 2007 01:00:37 -0000 1.7
+++ doc/C/gnash-man.xml 10 Feb 2007 04:30:51 -0000 1.8
@@ -157,6 +157,16 @@
</varlistentry>
<varlistentry>
+ <term>-g</term>
+ <listitem>
+ <para>
+ Start Gnash with a Flash debugger console so one can set
+ break points or watchpoints.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
<term>-w</term>
<listitem>
<para>
Index: doc/C/gnash.xml
===================================================================
RCS file: /sources/gnash/gnash/doc/C/gnash.xml,v
retrieving revision 1.39
retrieving revision 1.40
diff -u -b -r1.39 -r1.40
--- doc/C/gnash.xml 25 Jan 2007 01:00:37 -0000 1.39
+++ doc/C/gnash.xml 10 Feb 2007 04:30:51 -0000 1.40
@@ -54,6 +54,7 @@
<!ENTITY opcodes SYSTEM "opcodes.xml">
<!ENTITY rtmp SYSTEM "rtmp.xml">
<!ENTITY gnashrc SYSTEM "gnashrc.xml">
+ <!ENTITY debugger SYSTEM "debugger.xml">
]
>
@@ -505,6 +506,16 @@
</varlistentry>
<varlistentry>
+ <term>-g</term>
+ <listitem>
+ <para>
+ Start Gnash with a Flash debugger console so one can set
+ break points or watchpoints.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
<term>-x id</term>
<listitem>
<para>
@@ -688,6 +699,7 @@
</sect2>
&gnashrc;
+ &debugger;
</sect1>
@@ -720,7 +732,7 @@
The primary author of GameSWF (which provided the initial code for
Gnash) is Thatcher Ulrich <email>address@hidden</email>. Other
individuals who contributed code are: Mike Shaver, Thierry Berger-Perrin,
- Ignacio Castaño, Willem Kokke, Vitaly Alexeev,
+ Ignacio Castaño, Willem Kokke, Vitaly Alexeev,
Alexander Streit, and Rob Savoye.
</para>
Index: doc/C/internals.xml
===================================================================
RCS file: /sources/gnash/gnash/doc/C/internals.xml,v
retrieving revision 1.55
retrieving revision 1.56
diff -u -b -r1.55 -r1.56
--- doc/C/internals.xml 1 Feb 2007 14:52:13 -0000 1.55
+++ doc/C/internals.xml 10 Feb 2007 04:30:51 -0000 1.56
@@ -1799,11 +1799,8 @@
to implement a Movie tester for it. Some knowledge about the
expected behavior suffices.
</para>
-
</sect4>
-
</sect3>
-
</sect2>
</sect1>
Index: doc/C/sources.xml
===================================================================
RCS file: /sources/gnash/gnash/doc/C/sources.xml,v
retrieving revision 1.28
retrieving revision 1.29
diff -u -b -r1.28 -r1.29
--- doc/C/sources.xml 29 Jan 2007 18:24:42 -0000 1.28
+++ doc/C/sources.xml 10 Feb 2007 04:30:51 -0000 1.29
@@ -950,6 +950,7 @@
to limit what is required for a quite build of
<emphasis>Gnash</emphasis>.
</para>
+ <variablelist>
<varlistentry>
<term>--disable-fork</term>
<listitem>
@@ -999,6 +1000,16 @@
</varlistentry>
<varlistentry>
+ <term>--disable-debugger</term>
+ <listitem>
+ <para>
+ Disable support for the Flash debugger. The debugger is
+ mainly of interest to Flash developers.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
<term>--enable-libsuffix</term>
<listitem>
<para>
Index: doc/C/debugger.xml
===================================================================
RCS file: doc/C/debugger.xml
diff -N doc/C/debugger.xml
--- /dev/null 1 Jan 1970 00:00:00 -0000
+++ doc/C/debugger.xml 10 Feb 2007 04:30:51 -0000 1.1
@@ -0,0 +1,347 @@
+<?xml version="1.0" encoding="utf-8"?>
+<sect2 id="debugger">
+ <title>Flash Debugger</title>
+
+ <para>
+ Built into Gnash is a debugger for Flash movies. As there are no
+ line numbers nor real addresses in memory for symbols, it's
+ difficult to know now to set breakpoints. The existing debugger
+ implementation is limited to variables watch points and function
+ breakpoints.
+ </para>
+
+ <para>
+ Most of the debugger commands display information about variables,
+ the stack, registers, or ActionScript objects. It is also possible
+ to change these values in place when debugging to help change the
+ behaviour of a movie to determine the true problem.
+ </para>
+
+ <para>
+ Gnash developers can also insert a break where ever they want by
+ adding a few lines of code to the source file and recompiling. The
+ initial line gets a handle for the running debugger, and the
+ second, a call to <emphasis>Debugger::console()</emphasis> will
+ break at that point.
+ <programlisting>
+ static gnash::Debugger& debugger =
gnash::Debugger::getDefaultInstance();
+ debugger.console();
+ </programlisting>
+ </para>
+
+ <variablelist>
+ <varlistentry>
+ <term>?</term>
+ <listitem>
+ <para>
+ Display a help screen of commands.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>q</term>
+ <listitem>
+ <para>
+ Quit Gnash.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>t</term>
+ <listitem>
+ <para>
+ Toggle Trace Mode on or off. Trace mode prints a dissasemble
+ for each opcode as it executes in a similar fashion to the
+ <emphasis>-va</emphasis> option.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>c</term>
+ <listitem>
+ <para>
+ Continue executing the movie. It will continue until a break
+ or watch point is hit, or continue to the end of the movie
+ if not.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>d</term>
+ <listitem>
+ <para>
+ Dissasemble the current opcode.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ </variablelist>
+
+ <para>
+ Info commands are all started with the <emphasis>i</emphasis>
+ command, which is an abbreviation for
<emphasis>"info"</emphasis>.
+ The info commands dump out information on the state of the program.
+ </para>
+
+ <variablelist>
+ <varlistentry>
+ <term>i</term>
+ <listitem>
+ <para>
+ Dumps the movie infomation, version number, filename,
+ etc...
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>f</term>
+ <listitem>
+ <para>
+ Dumps the stack frame entries.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>s</term>
+ <listitem>
+ <para>
+ Dump the symbol tables. Everytime a function or method is
+ created it's stored in a symbol table along with it's
+ address. This function is probably only useful to Gnash
+ developers.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>g</term>
+ <listitem>
+ <para>
+ Display the values of the 4 global registers.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>r</term>
+ <listitem>
+ <para>
+ Display the values of the local registers, if any exist.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>l</term>
+ <listitem>
+ <para>
+ Display the values of all the local variables..
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>w</term>
+ <listitem>
+ <para>
+ List the watchpoints.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>b</term>
+ <listitem>
+ <para>
+ List all the breakpoints.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>c</term>
+ <listitem>
+ <para>
+ List the Call Stack.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ </variablelist>
+
+ <para>
+ Watch points are debugger commands that drop you into the
+ debugger console when the specified variable's value is either
+ read, or changed.
+ </para>
+
+ <variablelist>
+ <varlistentry>
+ <term>name r</term>
+ <listitem>
+ <para>
+ Set a watch point that triggers when the variable is read.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>name w</term>
+ <listitem>
+ <para>
+ Set a watch point that triggers when the variable is
+ written to.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>name b</term>
+ <listitem>
+ <para>
+ Set a watch point that triggers when the variable is read
+ or written to.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>d</term>
+ <listitem>
+ <para>
+ Delete a watchpoint by name.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+
+ <para>
+ Break points are debugger commands that drop you into the
+ debugger console when the specified function is about to be
+ executed by the Flash VM.
+ </para>
+
+ <variablelist>
+ <varlistentry>
+ <term>t</term>
+ <listitem>
+ <para>
+ Enable a breakpoint on a function.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>f</term>
+ <listitem>
+ <para>
+ Disable an existing breakpoint without deleting it.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>d</term>
+ <listitem>
+ <para>
+ Delete a breakpoint by name.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+
+
+ <para>
+ Watch points are debugger commands that drop you into the
+ debugger console when the specified variable's value is either
+ read, or changed.
+ </para>
+
+ <variablelist>
+ <varlistentry>
+ <term>name r</term>
+ <listitem>
+ <para>
+ Set a watch point that triggers when the variable is read.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>name w</term>
+ <listitem>
+ <para>
+ Set a watch point that triggers when the variable is
+ written to.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>name b</term>
+ <listitem>
+ <para>
+ Set a watch point that triggers when the variable is read
+ or written to.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>d</term>
+ <listitem>
+ <para>
+ Delete a watchpoint by name.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+
+ <para>
+ Break points are debugger commands that drop you into the
+ debugger console when the specified function is about to be
+ executed by the Flash VM.
+ </para>
+
+ <variablelist>
+ <varlistentry>
+ <term>set var [name] [value]</term>
+ <listitem>
+ <para>
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>set stack [index] [value]</term>
+ <listitem>
+ <para>
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>set reg [index] [value]</term>
+ <listitem>
+ <para>
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>set global [index] [value]</term>
+ <listitem>
+ <para>
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+
+</sect2>
+
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [Gnash-commit] gnash ChangeLog doc/C/gnash-man.xml doc/C/gnash...,
Rob Savoye <=