[Gnash-commit] gnash ./README ./ChangeLog doc/C/internals.xml ...

[Rob Savoye]

CVSROOT:        /sources/gnash
Module name:    gnash
Branch:         
Changes by:     Rob Savoye <address@hidden>     06/04/20 19:22:41

Modified files:
        .              : README ChangeLog 
        doc/C          : internals.xml plugin.xml 

Log message:
        * README: Clarify that no event handling means mouse clicks don't
        work with the SDL version of the plugin.
        * doc/C/internals.xml: Clarify that no event handling means mouse
        clicks don't work with the SDL version of the plugin.
        * doc/C/plugin.xml: Clarify that no event handling means mouse
        clicks don't work with the SDL version of the plugin.

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/gnash/gnash/README.diff?tr1=1.8&tr2=1.9&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/gnash/gnash/ChangeLog.diff?tr1=1.215&tr2=1.216&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/gnash/gnash/doc/C/internals.xml.diff?tr1=1.16&tr2=1.17&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/gnash/gnash/doc/C/plugin.xml.diff?tr1=1.4&tr2=1.5&r1=text&r2=text

Patches:
Index: gnash/ChangeLog
diff -u gnash/ChangeLog:1.215 gnash/ChangeLog:1.216
--- gnash/ChangeLog:1.215       Thu Apr 20 18:09:51 2006
+++ gnash/ChangeLog     Thu Apr 20 19:22:41 2006
@@ -1,5 +1,12 @@
 2006-04-20  Rob Savoye  <address@hidden>
 
+       * README: Clarify that no event handling means mouse clicks don't
+       work with the SDL version of the plugin.
+       * doc/C/internals.xml: Clarify that no event handling means mouse
+       clicks don't work with the SDL version of the plugin.
+       * doc/C/plugin.xml: Clarify that no event handling means mouse
+       clicks don't work with the SDL version of the plugin.
+       
        * libbase/triangulate_impl.h: Use the z modifier when printing a
        size_t.
        * plugin/plugin.cpp: Define start and end as a size_t, not an
Index: gnash/README
diff -u gnash/README:1.8 gnash/README:1.9
--- gnash/README:1.8    Fri Apr  7 17:11:00 2006
+++ gnash/README        Thu Apr 20 19:22:41 2006
@@ -70,10 +70,11 @@
 uses, it's the same as the standalone player.
 
 The GTK version has full event handling, and supports a right-click
-mouse menu to control the movie. The SDL version has no event handling
-or menu at all. The GTK version requires GtkGlExt, and defaults to SDL
-if GtkGlExt is not installed, or if --disable-glext is passed to
-configure.
+mouse menu to control the movie. The SDL version has no event
+handling, which means mouse clicks and keys pressed get ignored. Also
+the windows don't resize, and occasionally they overrun thweir
+biundaries. The GTK version requires GtkGlExt, and defaults to SDL if
+GtkGlExt is not installed, or if --disable-glext is passed to configure.
 
 All Flash movies are downloaded in full to /tmp, and then played from there.
 Gnash is not yet able to play a Flash file "as it arrives" over the
Index: gnash/doc/C/internals.xml
diff -u gnash/doc/C/internals.xml:1.16 gnash/doc/C/internals.xml:1.17
--- gnash/doc/C/internals.xml:1.16      Fri Apr  7 00:59:43 2006
+++ gnash/doc/C/internals.xml   Thu Apr 20 19:22:41 2006
@@ -204,12 +204,13 @@
        
        <para>
          The SDL version is more limited, but runs on all
-         platforms, including win32. It has no support for menus, and
-         I personally find the default event handler slow and
-         unresponsive. Gnash has support to use fast events,
-         (currently not enabled) which is an SDL hack using a
-         background thread to pump events into the SDL event queue at
-         a much higher rate.
+         platforms, including win32. It has no support for event
+         handling, which means mouse clicks, keyboard presses, and
+         window resizing doesn't work. I personally find the default
+         event handler slow and unresponsive. Gnash has support to
+         use fast events, (currently not enabled) which is an SDL
+         hack using a background thread to pump events into the SDL
+         event queue at a much higher rate.
        </para>
 
        <para>
@@ -223,7 +224,8 @@
          The GTK support is currently the most functional, and the
          best integrated into Firefox. The performance of this
          version is better than the SDL version because of the more
-         efficient event handling withing GTK. 
+         efficient event handling within GTK. For the best end user
+         experience, use the GTK enabled version.
        </para>
 
        <para>
Index: gnash/doc/C/plugin.xml
diff -u gnash/doc/C/plugin.xml:1.4 gnash/doc/C/plugin.xml:1.5
--- gnash/doc/C/plugin.xml:1.4  Fri Apr  7 00:59:43 2006
+++ gnash/doc/C/plugin.xml      Thu Apr 20 19:22:41 2006
@@ -330,14 +330,18 @@
       possible to have the plugin hook into the X11 event handling via
       GLX or GTK. Since Firefox uses GTK, so does Gnash. This also
       allows the addition of a right-click mouse menu for controlling
-      the player.
+      the player. The GTK build of Gnash offers the best browsing
+      experience as it's more functional than the SDL version.
     </para>
 
     <para>
       It is also possible to disable the <code>GTK</code> support so
       only the older <code>SDL</code> support is used. In this case 
-      Gnash can't support event handling within the browser. To
-      disable the GTK support and force SDL to be used, configure with
+      Gnash can't support event handling within the browser. This
+      means that when using the SDL of the plugin, mouse clicks and
+      keys pressed get ignored. Windows also can't be resized, and
+      sometimes they overrun their boundaries as well. To disable the
+      GTK support and force SDL to be used anyway, configure with
       <code>--disable-glext</code>
     </para>