cvs: php-gtk /docs/en/chapters intro.xml widget.xml
| From: | James Moore | Date: | Mon, 12 Mar 2001 20:21:36 +0000 |
| Subject: | cvs: php-gtk /docs/en/chapters intro.xml widget.xml | ||
| Groups: | php.gtk | ||
| Request: | Send a blank email to php-gtk+get-723@lists.php.net to get a copy of this message | ||
jmoore Mon Mar 12 12:21:36 2001 EDT
Modified files:
/php-gtk/docs/en/chapters intro.xml widget.xml
Log:
php-gtk -> PHP-GTK, restoring some white space
# - sorry for mixing whitespace and changes
Index: php-gtk/docs/en/chapters/intro.xml diff -u php-gtk/docs/en/chapters/intro.xml:1.5 php-gtk/docs/en/chapters/intro.xml:1.6 --- php-gtk/docs/en/chapters/intro.xml:1.5 Mon Mar 12 10:56:38 2001 +++ php-gtk/docs/en/chapters/intro.xml Mon Mar 12 12:21:36 2001 @@ -5,7 +5,7 @@ <title>Introduction</title> <simpara> This section of the manual will introduce you to the ideas - and the technologies behind php-gtk as well as its uses. + and the technologies behind PHP-GTK as well as its uses. </simpara> </sect1> @@ -33,25 +33,24 @@ <sect2 id="intro.whatis.gtk.history"> <title>A History of GTK</title> <para> - GTK+ was originally developed for - <ulink url="&url.gimp;">GIMP</ulink>, the - <ulink url="&url.gnu">GNU</ulink> - Image Manipulation Program. GTK stands for - the GIMP Tool Kit. GTK+ has - grown from these beginnings and is now used - as a central part of - <ulink url="&url.gnome">Gnome</ulink>, the GNU - Projects desktop environment. GTK+ has also been - ported to BeOS and Win32, which makes it the perfect - choice to use as the basis for a PHP extension, keeping PHP as cross-platform as possible and allowing the creation of - Windowed applications in PHP for Linux, BeOS - and Windows. + GTK+ was originally developed for <ulink url="&url.gimp;"> + GIMP</ulink>, the <ulink url="&url.gnu">GNU</ulink> Image + Manipulation Program. GTK stands for the GIMP Tool Kit. + GTK+ has grown from these beginnings and is now used as a + central part of <ulink url="&url.gnome">Gnome</ulink>, the + GNU Projects desktop environment. GTK+ has also been ported + to BeOS and Win32, which makes it the perfect choice to use as + the basis for a PHP extension, keeping PHP as cross-platform + as possible and allowing the creation of Windowed applications + in PHP for Linux, BeOS and Windows. </para> </sect2> <sect2 id="intro.whatis.gtk.whatitdoes"> <title>What does GTK do?</title> <simpara> -GTK is a set of libraries written in C to create graphical user interfaces. It has an object oriented architecture developed in three libraries: + GTK is a set of libraries written in C to create graphical user + interfaces. It has an object oriented architecture developed in + three libraries: </simpara> <para> <itemizedlist> @@ -97,37 +96,60 @@ <simpara> PHP, known originally as Personal Home Pages, was first conceived in the autumn of 1994 by Rasmus Lerdorf. - He wrote it as a way to track visitors to his online CV. The first version was released in early 1995, by which time Rasmus had found that by making the project open-source, people would fix his bugs. The first version was very straightforward and had a simple parser which recognised a few special macros and provided some of the utilities which were in common usage on homepages back then. + He wrote it as a way to track visitors to his online CV. The first + version was released in early 1995, by which time Rasmus had found + that by making the project open-source, people would fix his bugs. + The first version was very straightforward and had a simple parser + which recognised a few special macros and provided some of the + utilities which were in common usage on homepages back then. </simpara> <simpara> The parser was rewritten in mid-1995 and renamed PHP/FI version 2. - The "FI" in this version stood for the Form Interpreter which Rasmus had added to PHP to cope with the growing needs of webpages. mSQL support was also added at this time. PHP/FI underwent massive growth and other people started to contribute code to it regularly. + The "FI" in this version stood for the Form Interpreter which Rasmus + had added to PHP to cope with the growing needs of webpages. mSQL + support was also added at this time. PHP/FI underwent massive growth + and other people started to contribute code to it regularly. </simpara> <simpara> In mid-1997 Zeev Suraski and Andi Gutmans rewrote the main parser and PHP shifted from being Rasmus' own to a more - group orientated project. This formed the basis for PHP3, now named PHP: Hypertext Preprocessor - a recursive acronym. + group orientated project. This formed the basis for PHP3, now + named PHP: Hypertext Preprocessor - a recursive acronym. </simpara> <simpara> The latest version, PHP4, is another rewrite by Suraski and Gutmans and is based around the <ulink url="&url.zend;">Zend</ulink> engine. - PHP now has over two hundred regular contributors working on various parts of the project. It has a massive amount of third party extension modules, supports all popular servers natively, and has inbuilt MySql and ODBC support. + PHP now has over two hundred regular contributors working on various + parts of the project. It has a massive amount of third party + extension modules, supports all popular servers natively, and has + inbuilt MySql and ODBC support. </simpara> <simpara> The latest statistics show that PHP is now in use on over 5.5 million - domains, and has had a steady usage growth rate over the past year. It is far and away the single most popular Apache module; to give this some perspective, Apache currently holds nearly 60% of the market share of Internet webservers, whereas IIS servers (natively supporting ASP) hold less than half that proportion of the market. - (Figures taken from <ulink url="&url.stats;">&url.stats;</ulink> March 2001.) + domains, and has had a steady usage growth rate over the past year. + It is far and away the single most popular Apache module; to give + this some perspective, Apache currently holds nearly 60% of the + market share of Internet webservers, whereas IIS servers (natively + supporting ASP) hold less than half that proportion of the market. + (Figures taken from <ulink url="&url.stats;">&url.stats;</ulink> + March 2001.) </simpara> </sect2> <sect2 id="intro.whatis.php.whatdoes"> <title>What does PHP do?</title> <simpara> - PHP is a general purpose language. It is normally put to use as an html-embedded scripting language for use on the web, but it can also be used as a shell scripting language or even as a language to write windowed applications, in the form of php-gtk. + PHP is a general purpose language. It is normally put to use as an + html-embedded scripting language for use on the web, but it can also + be used as a shell scripting language or even as a language to write + windowed applications, in the form of PHP-GTK. </simpara> <simpara> - Due to PHP's open-source nature, if there is something you can't - currently do in PHP itself there is nothing stopping you from - writing a PHP module or extension in C code to extend its functionality so that you can do what you want from within PHP itself. This is made possible through the well-documented API which is available to all. + Due to PHP's open-source nature, if there is something you can't + currently do in PHP itself there is nothing stopping you from + writing a PHP module or extension in C code to extend its + functionality so that you can do what you want from within PHP + itself. This is made possible through the well-documented API which + is available to all. </simpara> <para> PHP4 has two main parts to it: @@ -139,7 +161,7 @@ <simpara> is the part of the PHP package that keeps track of the requests, processes scripting files, and handles - variables and resources. Its homepage can be found at + variables and resources. Its homepage can be found at <ulink url="&url.zend;">&url.zend;</ulink>. </simpara> </listitem> @@ -148,7 +170,8 @@ <emphasis>PHP</emphasis> </simpara> <simpara> - implements 90% of the functionality seen by the end user. It provides a wide range of modules such as MySQL, ODBC and XML support. + implements 90% of the functionality seen by the end user. It + provides a wide range of modules such as MySQL, ODBC and XML support. </simpara> </listitem> </itemizedlist> @@ -157,7 +180,7 @@ </sect1> <sect1 id="intro.acknowledgements"> - <title>PHP GTK Acknowledgements</title> + <title>PHP-GTK Acknowledgements</title> <simpara> The person I would like to thank most is James Henstridge <ulink url="mailto:&email.james.henstridge;"> Index: php-gtk/docs/en/chapters/widget.xml diff -u php-gtk/docs/en/chapters/widget.xml:1.3 php-gtk/docs/en/chapters/widget.xml:1.4 --- php-gtk/docs/en/chapters/widget.xml:1.3 Mon Mar 12 10:56:54 2001 +++ php-gtk/docs/en/chapters/widget.xml Mon Mar 12 12:21:36 2001 @@ -25,7 +25,7 @@ <listitem> <simpara>Creation</simpara> <simpara> - In php-gtk this is done by creating an object, e.g. + In PHP-GTK this is done by creating an object, e.g. <literal>$window = &new GtkWindow;</literal> </simpara> </listitem> @@ -34,22 +34,25 @@ <simpara> This is the step of adding a widget to a <link linkend="gtk.containers.whatare">container</link>. - This is achived in php-gtk by using the syntax + This is achived in PHP-GTK by using the syntax <literal>$container->add($widget);</literal> </simpara> </listitem> <listitem> <simpara>Signal Connection</simpara> <simpara> - This is the step of setting up call back functions for use. An example of this - might be <literal> - $widget->connect("focus-in-event","my_focus_func");</literal> where 'focus-in-event' is a predefined state such as 'clicked' and 'my_focus_func' is the called subroutine. + This is the step of setting up call back functions for use. + An example of this might be <literal> + $widget->connect("event","my_focus_func");</literal> + where 'event' is a predefined state such as 'clicked' + and 'my_focus_func' is the called subroutine. </simpara> </listitem> <listitem> <simpara>Display</simpara> <simpara> - This describes whether the widget is on display to the user. It is started by calling + This describes whether the widget is on display to the user. + It is started by calling <literal>$widget->show();</literal> and finished by <literal>$widget->hide();</literal>. </simpara> @@ -57,7 +60,8 @@ <listitem> <simpara>Destruction</simpara> <simpara> - This occurs when the shutdown routine is called. All actions that are necessary here are handled by php-gtk itself. + This occurs when the shutdown routine is called. + All actions that are necessary here are handled by PHP-GTK itself. </simpara> </listitem> </orderedlist>
Index: php-gtk/docs/en/chapters/intro.xml diff -u php-gtk/docs/en/chapters/intro.xml:1.5 php-gtk/docs/en/chapters/intro.xml:1.6 --- php-gtk/docs/en/chapters/intro.xml:1.5 Mon Mar 12 10:56:38 2001 +++ php-gtk/docs/en/chapters/intro.xml Mon Mar 12 12:21:36 2001 @@ -5,7 +5,7 @@ <title>Introduction</title> <simpara> This section of the manual will introduce you to the ideas - and the technologies behind php-gtk as well as its uses. + and the technologies behind PHP-GTK as well as its uses. </simpara> </sect1> @@ -33,25 +33,24 @@ <sect2 id="intro.whatis.gtk.history"> <title>A History of GTK</title> <para> - GTK+ was originally developed for - <ulink url="&url.gimp;">GIMP</ulink>, the - <ulink url="&url.gnu">GNU</ulink> - Image Manipulation Program. GTK stands for - the GIMP Tool Kit. GTK+ has - grown from these beginnings and is now used - as a central part of - <ulink url="&url.gnome">Gnome</ulink>, the GNU - Projects desktop environment. GTK+ has also been - ported to BeOS and Win32, which makes it the perfect - choice to use as the basis for a PHP extension, keeping PHP as cross-platform as possible and allowing the creation of - Windowed applications in PHP for Linux, BeOS - and Windows. + GTK+ was originally developed for <ulink url="&url.gimp;"> + GIMP</ulink>, the <ulink url="&url.gnu">GNU</ulink> Image + Manipulation Program. GTK stands for the GIMP Tool Kit. + GTK+ has grown from these beginnings and is now used as a + central part of <ulink url="&url.gnome">Gnome</ulink>, the + GNU Projects desktop environment. GTK+ has also been ported + to BeOS and Win32, which makes it the perfect choice to use as + the basis for a PHP extension, keeping PHP as cross-platform + as possible and allowing the creation of Windowed applications + in PHP for Linux, BeOS and Windows. </para> </sect2> <sect2 id="intro.whatis.gtk.whatitdoes"> <title>What does GTK do?</title> <simpara> -GTK is a set of libraries written in C to create graphical user interfaces. It has an object oriented architecture developed in three libraries: + GTK is a set of libraries written in C to create graphical user + interfaces. It has an object oriented architecture developed in + three libraries: </simpara> <para> <itemizedlist> @@ -97,37 +96,60 @@ <simpara> PHP, known originally as Personal Home Pages, was first conceived in the autumn of 1994 by Rasmus Lerdorf. - He wrote it as a way to track visitors to his online CV. The first version was released in early 1995, by which time Rasmus had found that by making the project open-source, people would fix his bugs. The first version was very straightforward and had a simple parser which recognised a few special macros and provided some of the utilities which were in common usage on homepages back then. + He wrote it as a way to track visitors to his online CV. The first + version was released in early 1995, by which time Rasmus had found + that by making the project open-source, people would fix his bugs. + The first version was very straightforward and had a simple parser + which recognised a few special macros and provided some of the + utilities which were in common usage on homepages back then. </simpara> <simpara> The parser was rewritten in mid-1995 and renamed PHP/FI version 2. - The "FI" in this version stood for the Form Interpreter which Rasmus had added to PHP to cope with the growing needs of webpages. mSQL support was also added at this time. PHP/FI underwent massive growth and other people started to contribute code to it regularly. + The "FI" in this version stood for the Form Interpreter which Rasmus + had added to PHP to cope with the growing needs of webpages. mSQL + support was also added at this time. PHP/FI underwent massive growth + and other people started to contribute code to it regularly. </simpara> <simpara> In mid-1997 Zeev Suraski and Andi Gutmans rewrote the main parser and PHP shifted from being Rasmus' own to a more - group orientated project. This formed the basis for PHP3, now named PHP: Hypertext Preprocessor - a recursive acronym. + group orientated project. This formed the basis for PHP3, now + named PHP: Hypertext Preprocessor - a recursive acronym. </simpara> <simpara> The latest version, PHP4, is another rewrite by Suraski and Gutmans and is based around the <ulink url="&url.zend;">Zend</ulink> engine. - PHP now has over two hundred regular contributors working on various parts of the project. It has a massive amount of third party extension modules, supports all popular servers natively, and has inbuilt MySql and ODBC support. + PHP now has over two hundred regular contributors working on various + parts of the project. It has a massive amount of third party + extension modules, supports all popular servers natively, and has + inbuilt MySql and ODBC support. </simpara> <simpara> The latest statistics show that PHP is now in use on over 5.5 million - domains, and has had a steady usage growth rate over the past year. It is far and away the single most popular Apache module; to give this some perspective, Apache currently holds nearly 60% of the market share of Internet webservers, whereas IIS servers (natively supporting ASP) hold less than half that proportion of the market. - (Figures taken from <ulink url="&url.stats;">&url.stats;</ulink> March 2001.) + domains, and has had a steady usage growth rate over the past year. + It is far and away the single most popular Apache module; to give + this some perspective, Apache currently holds nearly 60% of the + market share of Internet webservers, whereas IIS servers (natively + supporting ASP) hold less than half that proportion of the market. + (Figures taken from <ulink url="&url.stats;">&url.stats;</ulink> + March 2001.) </simpara> </sect2> <sect2 id="intro.whatis.php.whatdoes"> <title>What does PHP do?</title> <simpara> - PHP is a general purpose language. It is normally put to use as an html-embedded scripting language for use on the web, but it can also be used as a shell scripting language or even as a language to write windowed applications, in the form of php-gtk. + PHP is a general purpose language. It is normally put to use as an + html-embedded scripting language for use on the web, but it can also + be used as a shell scripting language or even as a language to write + windowed applications, in the form of PHP-GTK. </simpara> <simpara> - Due to PHP's open-source nature, if there is something you can't - currently do in PHP itself there is nothing stopping you from - writing a PHP module or extension in C code to extend its functionality so that you can do what you want from within PHP itself. This is made possible through the well-documented API which is available to all. + Due to PHP's open-source nature, if there is something you can't + currently do in PHP itself there is nothing stopping you from + writing a PHP module or extension in C code to extend its + functionality so that you can do what you want from within PHP + itself. This is made possible through the well-documented API which + is available to all. </simpara> <para> PHP4 has two main parts to it: @@ -139,7 +161,7 @@ <simpara> is the part of the PHP package that keeps track of the requests, processes scripting files, and handles - variables and resources. Its homepage can be found at + variables and resources. Its homepage can be found at <ulink url="&url.zend;">&url.zend;</ulink>. </simpara> </listitem> @@ -148,7 +170,8 @@ <emphasis>PHP</emphasis> </simpara> <simpara> - implements 90% of the functionality seen by the end user. It provides a wide range of modules such as MySQL, ODBC and XML support. + implements 90% of the functionality seen by the end user. It + provides a wide range of modules such as MySQL, ODBC and XML support. </simpara> </listitem> </itemizedlist> @@ -157,7 +180,7 @@ </sect1> <sect1 id="intro.acknowledgements"> - <title>PHP GTK Acknowledgements</title> + <title>PHP-GTK Acknowledgements</title> <simpara> The person I would like to thank most is James Henstridge <ulink url="mailto:&email.james.henstridge;"> Index: php-gtk/docs/en/chapters/widget.xml diff -u php-gtk/docs/en/chapters/widget.xml:1.3 php-gtk/docs/en/chapters/widget.xml:1.4 --- php-gtk/docs/en/chapters/widget.xml:1.3 Mon Mar 12 10:56:54 2001 +++ php-gtk/docs/en/chapters/widget.xml Mon Mar 12 12:21:36 2001 @@ -25,7 +25,7 @@ <listitem> <simpara>Creation</simpara> <simpara> - In php-gtk this is done by creating an object, e.g. + In PHP-GTK this is done by creating an object, e.g. <literal>$window = &new GtkWindow;</literal> </simpara> </listitem> @@ -34,22 +34,25 @@ <simpara> This is the step of adding a widget to a <link linkend="gtk.containers.whatare">container</link>. - This is achived in php-gtk by using the syntax + This is achived in PHP-GTK by using the syntax <literal>$container->add($widget);</literal> </simpara> </listitem> <listitem> <simpara>Signal Connection</simpara> <simpara> - This is the step of setting up call back functions for use. An example of this - might be <literal> - $widget->connect("focus-in-event","my_focus_func");</literal> where 'focus-in-event' is a predefined state such as 'clicked' and 'my_focus_func' is the called subroutine. + This is the step of setting up call back functions for use. + An example of this might be <literal> + $widget->connect("event","my_focus_func");</literal> + where 'event' is a predefined state such as 'clicked' + and 'my_focus_func' is the called subroutine. </simpara> </listitem> <listitem> <simpara>Display</simpara> <simpara> - This describes whether the widget is on display to the user. It is started by calling + This describes whether the widget is on display to the user. + It is started by calling <literal>$widget->show();</literal> and finished by <literal>$widget->hide();</literal>. </simpara> @@ -57,7 +60,8 @@ <listitem> <simpara>Destruction</simpara> <simpara> - This occurs when the shutdown routine is called. All actions that are necessary here are handled by php-gtk itself. + This occurs when the shutdown routine is called. + All actions that are necessary here are handled by PHP-GTK itself. </simpara> </listitem> </orderedlist>