[Xmlgraphics-fop Wiki] Update of "FOPIDESetupGuide" by JeremiasMaerki

[Apache Wiki <wi...@apache.org>]

Dear Wiki user,

You have subscribed to a wiki page or wiki category on "Xmlgraphics-fop Wiki" for change notification.

The following page has been changed by JeremiasMaerki:
http://wiki.apache.org/xmlgraphics-fop/FOPIDESetupGuide

The comment on the change is:
We've moved to SVN.

------------------------------------------------------------------------------
  This page tells you how to setup FOP for development in an IDE.
  ----
  == Eclipse ==
- === Initial project setup ===
-  *  Create a new java project, using File->New...->Project
-  *  Setup the project for CVS by using Team->Share Project... from the context menu (Eclipse 2.1)
+ == Importing an existing FOP checkout into Eclipse ==
+  * Simply import the root directory of the FOP checkout (Choose "Existing Project into Workspace")
+  * After that choose "Share Project..." from the "Team" menu item in the context menu of the project.
+  * Choose "SVN" as repository type.
+  * Eclipse will recognize that you've checked out FOP using SVN and will now simply let you verify the connection.
+  * That's it.
+ == Checking out inside Eclipse ==
- === Setup CVS Repositories ===
+ === Setup SVN Repository location ===
-  *  Open the "CVS Repository Exploring Perspective"
+  *  Open the "SVN Repository Exploring" Perspective
   *  Create a new "Repository Location" (via context menu)
  ==== Anonymous access ====
+  *  Url: http://svn.apache.org/repos/asf/xmlgraphics/fop
+  *  User: ''leavy empty''
-  *  Host: cvs.apache.org
-  *  Path: /home/cvspublic
-  *  User: anoncvs
-  *  Password: ''leave empty''</>
+  *  Password: ''leave empty''
-  *  Connection type: pserver
- http://cvs.apache.org/~jeremias/eclipse-setup/AddAnonCVSRepository.png
+ http://cvs.apache.org/~jeremias/eclipse-setup/new-svn-repo.png
  ==== Committer access ====
+  *  Url: http://svn.apache.org/repos/asf/xmlgraphics/fop
-  *  Host: cvs.apache.org
-  *  Path: /home/cvs
   *  User: <uid>
   *  Password: <pwd>
-  *  Connection type: ext
- http://cvs.apache.org/~jeremias/eclipse-setup/AddCVSRepository.png
- You need a SSH executable for committer access. On Windows, there is Putty/plink ''(add link)'' and Cygwin SSH (get the setup.exe from http://www.cygwin.com).
- On Windows, you'll probably have to change the path to the SSH in the Preferences dialog under Team/CVS/Ext Connection Method:
-  *  CVS_RSH: C:\.....\putty\plink.exe (Tell Eclipse how to find plink.exe)
-  *  Parameters: {host} -l {user}
-  *  CVS_SERVER: cvs
- http://cvs.apache.org/~jeremias/eclipse-setup/PLinkSetup.png
- As an alternative you can set up your SSH client to provide a tunnel as described here: http://jakarta.apache.org/site/cvsonwin32.html. This is usually a bit faster because the connection doesn't have to be built up each time you access CVS. It's just a matter of opening another channel over an open connection. In this case use the following setup:
-  *  Host: localhost
-  *  Path: /home/cvs
-  *  User: <uid>
-  *  Password: <pwd>
-  *  Connection type: pserver
  
- === Work on HEAD ===
+ === Work on the Trunk ===
  ==== Download the project files ====
- Expand the newly created repository location, open "HEAD", right-click on "xml-fop" and select "Check Out As...". That's basically it.
+  * Expand the newly created repository location and right-click on "trunk" and select "Check Out As...".
  
- http://cvs.apache.org/~jeremias/eclipse-setup/CheckOutHEAD.png
+ http://cvs.apache.org/~jeremias/eclipse-setup/svn-checkout-as.png
+ 
+  * Make sure you DON'T choose "Check out as Project" or you'll not get the whole Java-related support!
+  * Choose "Java Project" on the next screen and run through the rest of the wizard.
+  * This will finally download the sources.
  
  ==== Setup source directories and libraries ====
  In order to enjoy the automatic compilation feature of Eclipse, you have to define source directories and add libraries in the project preferences ("source" and "libraries" tabs). Because FOP uses Java code generated from XML in the src/codegen directory, you'll still have to run the "codegen" target in the buildfile. The generated code is written to the '''build/gensrc''' directory.  ''See notes below on adding source directories before you do this. Her e is how you do it:''
@@ -70, +61 @@

   *  If you install JAI into a JRE, e.g. 1.4.1, and then set that JRE as the default for Eclipse, you don't have to add JAI as an external library.
   *  JCE and crypto service providers have to be installed in the JRE in order to work anyway, so you don't have to add them either.
  
- Note: it might happend that eclipe will '''not set the project as a Java Project'''. You might want to try this hack: 
+ Note: If you haven't followed the above instructions, it might happen that eclipe will '''not set the project as a Java Project'''. You might want to try this hack: 
   * Shut down eclipse, and open the ".properties" file of the project in an editor.
   * Update the followings tags. That's how eclipse understands that it is a java project.
  {{{     
@@ -89, +80 @@

  ----
  
  === Work on the Maintenance Branch ===
- Due to the current directory layout, setting FOP in Eclipse is a headache, you'll have to use exclude pathes because src/org and src/java-1.4/org overlap.
+ Due to the current directory layout, setting FOP in Eclipse is a headache, you'll have to use exclude paths because src/org and src/java-1.4/org overlap.
  
  ==== Download the project files ====
-  *  Open the CVS Repository Exploring Perspective
+  *  Open the "SVN Repository Exploring" Perspective
-  *  Create the repository location for "xml-fop" as shown above
+  *  Create the repository location for FOP as shown above
-  *  Expand the new repository location: You see HEAD, Branches, Versions
+  *  Expand the new repository location: You see trunk, branches and tags
+  *  Expand "branches" and select "fop-0_20_2-maintain" for the "Check out as..." context menu entry, similar to the instructions for trunk shown above.
+  *  The rest is the same as above.
- {{{    http://cvs.apache.org/~jeremias/eclipse-setup/CVSRepository.png }}}
-  *  Expand HEAD and select "xml-fop". Call the context menu and say "Configure Branches and Versions".
- {{{    http://cvs.apache.org/~jeremias/eclipse-setup/ConfigureBranches.png }}}
-  *  Dialog pops up: select "build.xml" and say "Add Selected Files"
-  *  Say "Deselect All" and select in the upper right box the tags you want to have remembered and say "Add Checked Tags".
- {{{    http://cvs.apache.org/~jeremias/eclipse-setup/ConfigureBranchesDialog.png }}}
-  *  Close the dialog.
-  *  Collapse the HEAD node again and expand the Branches node.
-  *  You'll now see the branches you made Eclipse remember.
-  *  You can expand one of them to call the context menu on the only child node: Say "Check Out As..." and setup your Eclipse project.
- {{{      http://cvs.apache.org/~jeremias/eclipse-setup/RememberedBranches.png }}}
  
  ==== Setup source directories and libraries ====
- See the setup in the "work on HEAD" section, however, you have carefully set exclusion masks for
+ See the setup in the "Work on the Trunk" section, however, you have carefully set exclusion masks for
   *  one of the src/java-1.3 or src/java-1.4 directory
   *  all the directories in build/gensrc which contain copy-filtered source files which are already in the main source tree
  You have to run an external Ant with both the targets of gensrc and prepare-compile, and clean out some of the superfluous generated files which Eclipse marks as conflicting.

---------------------------------------------------------------------
To unsubscribe, e-mail: fop-commits-unsubscribe@xmlgraphics.apache.org
For additional commands, e-mail: fop-commits-help@xmlgraphics.apache.org