[prev in list] [next in list] [prev in thread] [next in thread] 

List:       php-gtk-doc
Subject:    [PHP-GTK-DOC] cvs: php-gtk-doc /manual global.ent  /manual/en preface.xml
From:       "Anant Narayanan" <anant () php ! net>
Date:       2006-03-28 22:53:09
Message-ID: cvsanant1143586389 () cvsserver
[Download RAW message or body]

anant		Tue Mar 28 22:53:09 2006 UTC

  Modified files:              
    /php-gtk-doc/manual	global.ent 
    /php-gtk-doc/manual/en	preface.xml 
  Log:
  Added the preface. Hope it's OK!
  
  
http://cvs.php.net/viewcvs.cgi/php-gtk-doc/manual/global.ent?r1=1.5&r2=1.6&diff_format=u
Index: php-gtk-doc/manual/global.ent
diff -u php-gtk-doc/manual/global.ent:1.5 php-gtk-doc/manual/global.ent:1.6
--- php-gtk-doc/manual/global.ent:1.5	Sun Mar 26 02:50:40 2006
+++ php-gtk-doc/manual/global.ent	Tue Mar 28 22:53:09 2006
@@ -1,5 +1,5 @@
 <!-- 
- $Id: global.ent,v 1.5 2006/03/26 02:50:40 sfox Exp $
+ $Id: global.ent,v 1.6 2006/03/28 22:53:09 anant Exp $
  Contains global "macros" for all the XML documents.
  All URLS and emails should be placed in here then
  referenced in the text as, for example &url.gtk -->
@@ -48,6 +48,7 @@
 <!ENTITY link.jmoore '<ulink url="mailto:&email.jmoore;"><en>James Moore</en></ulink>'>
 <!ENTITY link.steph '<ulink url="mailto:&email.steph;"><en>Steph Fox</en></ulink>'>
 <!ENTITY link.simon '<ulink url="mailto:&email.simon;"><en>Simon Wheeler</en></ulink>'>
+<!ENTITY link.cweiske '<ulink url="mailto:&email.cweiske;"><en>Christian Weiske</en></ulink>'>
 
 <!ENTITY link.phpgtkdoc '<ulink url="mailto:&email.phpgtkdoc;"><en>&email.phpgtkdoc;</en></ulink>'>
 
http://cvs.php.net/viewcvs.cgi/php-gtk-doc/manual/en/preface.xml?r1=1.2&r2=1.3&diff_format=u
Index: php-gtk-doc/manual/en/preface.xml
diff -u php-gtk-doc/manual/en/preface.xml:1.2 php-gtk-doc/manual/en/preface.xml:1.3
--- php-gtk-doc/manual/en/preface.xml:1.2	Sat Mar 25 16:31:21 2006
+++ php-gtk-doc/manual/en/preface.xml	Tue Mar 28 22:53:09 2006
@@ -1,7 +1,45 @@
 <?xml version="1.0" encoding="utf-8" ?>
 <book id="preface">
  <title>Preface</title>
- <!-- TODO -->
-  <para>
-  </para>
+  <simpara>
+   Welcome to the user manual of PHP-GTK 2! This manual should help you get
+   started with PHP-GTK 2 and also provide a comprehensive reference to most
+   aspects of the language.
+  </simpara>
+  <simpara>
+   This manual is split into two main parts. The first part is the 
+   <link linkend="tutorials">Tutorials</link> section. This part will help you
+   get started with PHP-GTK 2 programming and provide some insight into the
+   various aspects of designing applications with PHP-GTK 2. The other part is
+   the <link linkend="reference">Reference</link> section. This part of the
+   manual provides details on all GTK objects and their associated methods and
+   signals. This should be useful whenever you are in doubt of how a particular
+   method or object is used.
+  </simpara>
+  <simpara>
+   Although we have taken great care in ensuring that all of the information in
+   the manual is correct, it is possible that some errors crept in. Please do
+   inform the PHP-GTK documentation group: &email.phpgtkdoc; in case you
+   encounter such errors. If something you want is not present in the manual, 
+   do not hesitate to post your question to PHP-GTK-General mailing list: 
+   &email.phpgtk;.
+  </simpara>
+  <simpara>
+   This manual was produced using a modified version of the Docbook DTD. The
+   modifications were made to document the object system used by PHP-GTK 2 in an
+   easier manner. The XML basis for each class and their methods was initially
+   generated automatically from the PHP-GTK 2 source code, and is updated via
+   PHP5's Reflection to ensure that the documentation stays in-sync with the
+   source.
+  </simpara>
+  <simpara>
+   The XML generator was written by &link.andrei; (the original author of
+   PHP-GTK itself) and was modified by &link.cweiske;. The documentation is
+   transformed from its XML source into various other formats using
+   <acronym>XSL</acronym> stylesheets as well as a host of other tools. The
+   manual build system is maintained by &link.steph;.
+  </simpara>
+  <simpara>
+   We hope you enjoy reading the manual as much as we enjoyed making it!
+  </simpara>
 </book>

-- 
PHP-GTK Documentation Mailing List (http://gtk.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php

[prev in list] [next in list] [prev in thread] [next in thread]