cvs: php-gtk-doc /en preface.xml /en/reference/gdk gdkwindow.xml /en/reference/gtk gtkcombo.xml gtkctree.xml /en/tutorials hellow.xml
/en/userguide/chapters installunix.xml installusage.xml signals.xml

cweiske Mon Jul 19 10:45:14 2004 EDT Modified files: /php-gtk-doc/en preface.xml /php-gtk-doc/en/reference/gdk gdkwindow.xml /php-gtk-doc/en/userguide/chapters installunix.xml installusage.xml signals.xml /php-gtk-doc/en/tutorials hellow.xml /php-gtk-doc/en/reference/gtk gtkcombo.xml gtkctree.xml Log: Changed the loading of php-gtk extension to a more standard-conform way with "PHP_SHLIB_SUFFIX", added a unix installation hint and documented some gtkctree and gtkcombo functions

http://cvs.php.net/diff.php/php-gtk-doc/en/preface.xml?r1=1.7&r2=1.8&ty=u Index: php-gtk-doc/en/preface.xml diff -u php-gtk-doc/en/preface.xml:1.7 php-gtk-doc/en/preface.xml:1.8 --- php-gtk-doc/en/preface.xml:1.7 Tue Jun 17 17:27:57 2003 +++ php-gtk-doc/en/preface.xml Mon Jul 19 10:45:14 2004 @@ -20,7 +20,7 @@ The manual is produced using a modified version of the Docbook DTD. The modifications that have been made allow the documentation of the object system used by PHP-GTK. The XML basis for each of the classes and their - methods is generated automagically from the PHP-GTK source code. Note + methods is generated automatically from the PHP-GTK source code. Note that it is not possible to generate signal information in this way, i.e. if there is no accompanying textual description then signal information is ispo facto incomplete for that class. http://cvs.php.net/diff.php/php-gtk-doc/en/reference/gdk/gdkwindow.xml?r1=1.4&r2=1.5&ty=u Index: php-gtk-doc/en/reference/gdk/gdkwindow.xml diff -u php-gtk-doc/en/reference/gdk/gdkwindow.xml:1.4 php-gtk-doc/en/reference/gdk/gdkwindow.xml:1.5 --- php-gtk-doc/en/reference/gdk/gdkwindow.xml:1.4 Sun Jul 18 16:32:32 2004 +++ php-gtk-doc/en/reference/gdk/gdkwindow.xml Mon Jul 19 10:45:14 2004 @@ -64,7 +64,7 @@ <funcdef>void <function>set_cursor</function></funcdef> <paramdef> <classname>GdkCursor</classname> - <parameter>cursor</parameter> + <parameter><optional>cursor</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> http://cvs.php.net/diff.php/php-gtk-doc/en/userguide/chapters/installunix.xml?r1=1.2&r2=1.3&ty=u Index: php-gtk-doc/en/userguide/chapters/installunix.xml diff -u php-gtk-doc/en/userguide/chapters/installunix.xml:1.2 php-gtk-doc/en/userguide/chapters/installunix.xml:1.3 --- php-gtk-doc/en/userguide/chapters/installunix.xml:1.2 Sun Aug 3 13:29:46 2003 +++ php-gtk-doc/en/userguide/chapters/installunix.xml Mon Jul 19 10:45:14 2004 @@ -80,6 +80,19 @@ <itemizedlist> <listitem> <simpara> + If you get a <literal>./configure: line 3027: `PHP_GTK_ARG_ENABLE(debug, + whether to include debugging symbols,'</literal> after doing the + <command>./configure</command>, you just have to do the following: + </simpara> + <programlisting> +./buildconf +aclocal +./buildconf +./configure + </programlisting> + </listitem> + <listitem> + <simpara> <literal>./ltconfig: ltconfig : No such file or directory, configure: error: libtool configure failed</literal> is caused by not having one of libtool, automake or autoconf installed. http://cvs.php.net/diff.php/php-gtk-doc/en/userguide/chapters/installusage.xml?r1=1.1&r2=1.2&ty=u Index: php-gtk-doc/en/userguide/chapters/installusage.xml diff -u php-gtk-doc/en/userguide/chapters/installusage.xml:1.1 php-gtk-doc/en/userguide/chapters/installusage.xml:1.2 --- php-gtk-doc/en/userguide/chapters/installusage.xml:1.1 Thu May 1 13:45:33 2003 +++ php-gtk-doc/en/userguide/chapters/installusage.xml Mon Jul 19 10:45:14 2004 @@ -6,4 +6,9 @@ file) with this syntax: <command>C:\php4\php -q C:\path\to\php-gtk\script.php</command> </simpara> + <simpara> + Everytime you start a script with the command above, you will see the + DOS box coming up which can be annoying. To prevent this, call the + <filename>php_win.exe</filename> instead of <filename>php.exe</filename>. + </simpara> </chapter> http://cvs.php.net/diff.php/php-gtk-doc/en/userguide/chapters/signals.xml?r1=1.17&r2=1.18&ty=u Index: php-gtk-doc/en/userguide/chapters/signals.xml diff -u php-gtk-doc/en/userguide/chapters/signals.xml:1.17 php-gtk-doc/en/userguide/chapters/signals.xml:1.18 --- php-gtk-doc/en/userguide/chapters/signals.xml:1.17 Sun Aug 3 13:29:46 2003 +++ php-gtk-doc/en/userguide/chapters/signals.xml Mon Jul 19 10:45:14 2004 @@ -104,6 +104,9 @@ <programlisting role="php"> <![CDATA[ <?php +if( !extension_loaded('gtk')) { + dl( 'php_gtk.' . PHP_SHLIB_SUFFIX); +} function shutdown() { @@ -508,10 +511,9 @@ <programlisting role="php"> <![CDATA[ <?php - -dl("php_gtk." . (strstr(PHP_OS, "WIN") ? "dll" : -"so")) || -die("Can't load php_gtk module!\n"); +if( !extension_loaded('gtk')) { + dl( 'php_gtk.' . PHP_SHLIB_SUFFIX) || die("Can't load php_gtk module!\n"); +} function show_event_type($button, $event, $text) { http://cvs.php.net/diff.php/php-gtk-doc/en/tutorials/hellow.xml?r1=1.12&r2=1.13&ty=u Index: php-gtk-doc/en/tutorials/hellow.xml diff -u php-gtk-doc/en/tutorials/hellow.xml:1.12 php-gtk-doc/en/tutorials/hellow.xml:1.13 --- php-gtk-doc/en/tutorials/hellow.xml:1.12 Sun Aug 3 13:29:45 2003 +++ php-gtk-doc/en/tutorials/hellow.xml Mon Jul 19 10:45:14 2004 @@ -27,11 +27,8 @@ <![CDATA[ <?php -if (!class_exists('gtk')) { - if (strtoupper(substr(PHP_OS, 0,3) == 'WIN')) - dl('php_gtk.dll'); - else - dl('php_gtk.so'); +if( !extension_loaded('gtk')) { + dl( 'php_gtk.' . PHP_SHLIB_SUFFIX); } function delete_event() @@ -77,11 +74,8 @@ <![CDATA[ <?php -if (!class_exists('gtk')) { - if (strtoupper(substr(PHP_OS, 0,3) == 'WIN')) - dl('php_gtk.dll'); - else - dl('php_gtk.so'); +if( !extension_loaded('gtk')) { + dl( 'php_gtk.' . PHP_SHLIB_SUFFIX); } ?> @@ -92,7 +86,8 @@ already available, and loads it if it isn't. This is done by the <literal>dl('php_gtk.dll');</literal> or <literal>dl('php_gtk.so');</literal> statements on Windows and Linux - respectively. + respectively. The PHP_SHLIB_SUFFIX takes care of the specific extensions + used by Windows and Linux. </para> <para> <example> http://cvs.php.net/diff.php/php-gtk-doc/en/reference/gtk/gtkcombo.xml?r1=1.8&r2=1.9&ty=u Index: php-gtk-doc/en/reference/gtk/gtkcombo.xml diff -u php-gtk-doc/en/reference/gtk/gtkcombo.xml:1.8 php-gtk-doc/en/reference/gtk/gtkcombo.xml:1.9 --- php-gtk-doc/en/reference/gtk/gtkcombo.xml:1.8 Sun Aug 3 13:09:22 2003 +++ php-gtk-doc/en/reference/gtk/gtkcombo.xml Mon Jul 19 10:45:14 2004 @@ -101,6 +101,16 @@ </tgroup> </table> </para> + <para> + The normal but annoying behaviour is that the first entry is selected + when you open the dropdown. This can be stopped by doing the following: + <programlisting role="php"> +<![CDATA[ +$objList = $objCombobox->list; +$objList->set_selection_mode( GTK_SELECTION_SINGLE); +]]> + </programlisting> + </para> <simpara> See also: <classname>GtkEditable</classname>, <classname>GtkEntry</classname>, <classname>GtkItem</classname>, @@ -147,8 +157,9 @@ <![CDATA[ <?php -dl("php_gtk." . (strstr(PHP_OS, "WIN") ? "dll" : -"so")); +if( !extension_loaded('gtk')) { + dl( 'php_gtk.' . PHP_SHLIB_SUFFIX); +} function on_click($item, $event, $i) { echo $item->get_data($i)."\n"; http://cvs.php.net/diff.php/php-gtk-doc/en/reference/gtk/gtkctree.xml?r1=1.9&r2=1.10&ty=u Index: php-gtk-doc/en/reference/gtk/gtkctree.xml diff -u php-gtk-doc/en/reference/gtk/gtkctree.xml:1.9 php-gtk-doc/en/reference/gtk/gtkctree.xml:1.10 --- php-gtk-doc/en/reference/gtk/gtkctree.xml:1.9 Sun Aug 3 13:09:22 2003 +++ php-gtk-doc/en/reference/gtk/gtkctree.xml Mon Jul 19 10:45:14 2004 @@ -15,13 +15,21 @@ <funcsynopsis> <funcprototype> <funcdef> <function>GtkCTree</function></funcdef> - <paramdef>XXX</paramdef> + <paramdef>int <parameter>nColumns</parameter></paramdef> + <paramdef>int <parameter>nTreeGraphic</parameter></paramdef> + <paramdef><optional>Array <parameter>arColTitles</parameter></optional></paramdef> </funcprototype> </funcsynopsis> <shortdesc> - + Creates a new <classname>CtkCTree</classname> object. </shortdesc> <desc> + <simpara> + Create a new <classname>CtkCTree</classname> object with a number + of columns. The second parameter contains the index of the column + in which the tree lines shall be visible (indent and +/-) and the third + parameter can be an array with the column titles. + </simpara> <para> Notice how much of the code here is actually the arrays of data needed to populate the <classname>GtkCTree</classname>. It would probably be @@ -31,8 +39,9 @@ <programlisting role="php"> <![CDATA[ <?php - -dl('php_gtk.' . (strstr(PHP_OS, 'WIN') ? 'dll' : 'so')); +if( !extension_loaded('gtk')) { + dl( 'php_gtk.' . PHP_SHLIB_SUFFIX); +} /* start of data generation arrays */ $widgets_ = array( @@ -140,15 +149,33 @@ <method id="gtk.gtkctree.method.insert_node"> <funcsynopsis> <funcprototype> - <funcdef>XXX <function>insert_node</function></funcdef> - <paramdef>XXX</paramdef> + <funcdef><classname>GtkCTreeNode</classname> <function>insert_node</function></funcdef> + <paramdef><classname>GtkCTreeNode</classname> <parameter>sibling</parameter></paramdef> + <paramdef>Array <parameter>contents</parameter></paramdef> + <paramdef>int <parameter>pixmap_spacing</parameter></paramdef> + <paramdef><classname>GdkPixmap</classname> <parameter>pixmap_closed</parameter></paramdef> + <paramdef><classname>GdkBitmap</classname> <parameter>mask_closed</parameter></paramdef> + <paramdef><classname>GdkPixmap</classname> <parameter>pixmap_open</parameter></paramdef> + <paramdef><classname>GdkBitmap</classname> <parameter>mask_open</parameter></paramdef> + <paramdef>boolean <parameter>is_leaf</parameter></paramdef> + <paramdef>boolean <parameter>is_expanded</parameter></paramdef> </funcprototype> </funcsynopsis> <shortdesc> - + Inserts a new node in the tree. </shortdesc> <desc> - + <simpara> + This function creates a new node and inserts it into the tree. The first parameter + is the parent node; if it's NULL the node will be the root. The "contents" parameter + is an array of strings which are shown in the tree, for each column one. pixmap_spacing + is the spacing between the pixmap and the text. + </simpara> + <simpara> + The sibling parameter determines the position of the new node. If it is NULL, + it will be appended to the parents childen as the last element. If the sibling is + given, the new node will be inserted just before it. + </simpara> </desc> </method> @@ -163,10 +190,13 @@ </funcprototype> </funcsynopsis> <shortdesc> - + Removes the given node from the tree </shortdesc> <desc> - + <simpara> + Removes the given node from the tree. Children nodes are appended to the end of the + tree if they are not removed explicitly. + </simpara> </desc> </method>