first veron of external tools
[phpeclipse.git] / net.sourceforge.phpeclipse / install.txt
index 5a4aa23..01cbc73 100644 (file)
-Installing the PHPEclipse plugin is quite straightforward :
+PHPEclipse  Version 1.0.6alpha
+Copyright 2003 net.sourceforge.phpeclipse
+http://www.phpeclipse.org
+Contributors:
+    Klaus Hartlage
+    Matthieu Casanova
+    Le Borgne Cédric
+    David Cummings
+    Thomas Geiger
+    Rusell Wilson
+    Philippe Lachaise
+    Stefan Langer
+    and others...
 
-- Make sure you have Eclipse 2.0 properly setup or download it from www.eclipse.org 
+This Plugin is released under the Common Public License v1.0 which is included
+in this distribution or can be viewed at http://www.eclipse.org/legal/cpl-v10.html.
 
-- Simply unzip the files in your eclipse plugins 
-  directory (<your path>\eclipse\plugins). 
+Look for updated versions of this plugin at http://www.phpeclipse.org -> Downloads
 
-- (re)Start Eclipse. 
+1. Requirements
+2. Recommended
+3. Installation
+4. Editing PHP
+5. Additional Help
+6. Additional Plugins
+7. Contributing
+    7.1 Reporting Bugs
 
-- Open the "Resource Perspective" in the Eclipse IDE and add a file with a 
-  *.php, *.php3 or *.php4 extension to your source tree. 
-  With a right mouse click on the PHP file you should see the new menu entry 
-  "Open With->PHP Editor". 
 
-- For more Information go to the menu "Help->Help Contents" and 
-  open the "PHPEclipse Help" 
\ No newline at end of file
+
+ 1. Requirements
+------------------------------------------
+Java Runtime 1.4.x or higher ( downloadable at http://java.sun.com )
+Eclipse 2.1 or higher ( downloadable at http://www.eclipse.org )
+
+
+
+ 2. Recommended
+------------------------------------------
+PHP Enviroment for running PHP code.
+PHP can be downloaded at http://www.php.net
+Server can be found at http://httpd.apache.org
+MySQL can be found at http://www.mysql.org
+
+
+
+ 3. Installation
+------------------------------------------
+Simply unzip the files to your eclipse plugins directory and (re)start eclipse.
+(<eclipse-install>/plugins/)
+
+If you copy the files manually make sure all files are located in the
+net.sourceforge.phpeclipse folder in the plugins directory in your eclipse installation.
+
+After installation the directorystructure should look as follows:
+
+|--<eclipse install>
+|     |
+.     plugins
+.           |
+.           |
+            |- net.sourceforge.phpeclipse_x.x.x     // plugin folder
+            |               |
+            .               |
+            .               |-- phpeclipse.jar      // the plugin jar file
+            .               |
+                            |-- plugin.xml          // plugin manifest
+                            |
+                            |-- plugin.properties   // manifest properties
+                            |
+                            |-- phpeclipsesrc.zip   // sources for phpeclipse (if you don't need the sources you can safly delete this file)
+                            |
+                            |-- install.txt         // this textfile
+                            |
+                            |-- cpl-v10.html        // common public licence
+                            |
+                            |-- TODO                // what's to do
+
+
+ 4. Editing PHP
+------------------------------------------
+To start coding your php code. Simply create a new project.
+(File -> New... -> Project) And choose PHP from the left list.
+Choose PHP Project from the right and press "Next >".
+Specify a name for your project and press "Finish".
+
+To open the PHP Perspective click Windows -> Open Perspective -> Other... and
+choose PHP from the list.
+
+- For more Information go to the menu "Help->Help Contents" and
+  open the "PHPEclipse Help"
+
+
+
+ 5. Additional Help
+------------------------------------------
+There is a help forum at http://sourceforge.net/projects/phpeclipse.
+Just follow the "Forums" link.
+
+
+
+ 6. Additional Plugins for PHPEclipse
+------------------------------------------
+
+- PHPEclipse SQL Plugin : Helps create SQL statements
+- PHPEclipse JTidy Plugin : Checks and cleans up HTML.
+
+Both can be found at: http://sourceforge.net/projects/phpeclipse/
+
+
+
+ 7. Contributing
+------------------------------------------
+To make PHPEclipse a usefull tool for developing PHP we need your help.
+No contribution is too small or too big!
+We need:
+    Developers
+    Documentation
+    Translation
+    Bundling
+    ...
+
+See http://phpeclipse.sourceforge.net/en/get_involved.php for more information
+on how to contribute.
+
+BUT MOST IMPORTANT we need your help to find and fix those little bugs that
+seem to creep into the code.
+
+
+ 7.1 Bug Reporting
+------------------------------------------
+Before reporting a bug make sure that you are using the latest release of
+PHPEclipse.
+
+If you find a bug see if it is allready listed in the bug database
+at http://sourceforge.net/projects/phpeclipse/ -> Bugs
+If it is not listed create a new bug report. Be sure to include your system
+information (e.g. W2K Pentium 4 512 MB RAM), your Eclipse version
+(e.g. Eclipse 2.1), the version of phpeclipse you are using and a detailed
+description of the bug and how it can be reproduced.