Changes between Version 10 and Version 11 of Doc/SCDB/Eclipse


Ignore:
Timestamp:
Aug 8, 2007, 10:20:28 AM (18 years ago)
Author:
/O=GRID-FR/C=FR/O=CNRS/OU=LAL/CN=Charles Loomis
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • Doc/SCDB/Eclipse

    v10 v11  
    44[[TOC(inline)]]
    55
    6 Eclipse is an open source IDE (Integrated Development Environment), written in Java and thus available on all platforms, that provides a file browser, an editor, a SVN client, access to compilers and lot of other tools. It is neither part of SCDB, nor a requirement to use SCDB.
     6Eclipse is an open source, multi-platform IDE (Integrated Development Environment) written in Java that provides a file browser, an editor, a SVN client, access to compilers and lot of other tools. It is neither part of SCDB, nor a requirement to use SCDB.
    77
    8 With SCDB, it brings a graphical interface for administering SCDB and editing templates. With very few customization, Eclipse can be used both to edit templates, compile them and deploy them while taking advantage of all the advanced features you find in Eclipse like local history, file browsing and searching, ability to open a template directly at the line causing an error...
     8When used with SCDB, it brings a graphical interface for administering SCDB and editing templates.  With very few customizations, Eclipse can be used to edit templates, compile them, and deploy machine profiles while taking advantage of all the advanced features you find in Eclipse: local history, file browsing and searching, ability to open a template directly at the line causing an error, and others.
    99
    10 Instructions in this page explain how to customize Eclipse for SCDB. This is not an introduction to Eclipse usage itself. Refer to online documentation in Eclipse. Configuration described here has already been tested on Linux, MacOS and Windows but should work on any other platforms as all components used are pure Java.
     10Instructions in this page explain how to customize Eclipse for SCDB. This is not an introduction to Eclipse usage itself. Refer to online documentation in Eclipse. Configuration described here has already been tested on Linux, MacOS, and Windows but should work on any other platforms as all components used are pure Java.
    1111
    1212
    1313== Installation ==
    1414
    15 === Installating Eclipse ===
     15=== Installing Eclipse ===
    1616
    17 Eclipse can be downloaded from http://www.eclipse.org. Installing Eclipse mainly consists to unarchive the distribution. The archive format is dependant on the platform (zip, tar...).
     17Eclipse can be downloaded from http://www.eclipse.org. The site provides pre-built distributions for Windows, Linux, and MacOSX making installation trivial.  Recent versions of Eclipse offer several different pre-configured versions.  For SCDB, the "Eclipse Classic" is the most appropriate.   
    1818
    1919Before being able to run Eclipse, you need to install Java JRE or JDK on your machine. SCDB requires Java 1.5 or later. You need to check on Eclipse site minimum Java version required by Eclipse. As of Eclipse 3.2, it was lower than SCDB.
    2020
    21 If you have several Java JRE o JDK installed on your machine, run Eclipse, goto Preferences->Java (in  `Window` menu) and check the version used  by Eclipse matches both Eclipse and SCDB requirements.
     21If you have several Java JREs or JDKs installed on your machine, run Eclipse, goto Preferences->Java (in  `Window` menu) and check the version used  by Eclipse matches both Eclipse and SCDB requirements.
    2222
    23 ''Note : Java JDK is required only for some advanced operations like generating new OS templates. Java JRE is enougth for every day administration of SCDB.''
     23''Note : Java JDK is required only for some advanced operations like generating new OS templates. Java JRE is enough for daily administration of SCDB.''
    2424
    2525=== Installating Eclipse plugins ===
     
    2727For Eclipse to work with SCDB, some additional software, called plugins, needs to be installed. To do this, run Eclipse and use `Software Updates->Find and Install...->Search for New Features to Install -> Next`   in `Help` menu. Then add a `new remote site` for each of the following plugins :
    2828
    29  * Subclipse : used to interact with a SVN client. (Mylar integration is not required.)
     29 * Subclipse : used to interact with a SVN client. (To avoid dependency problems, deselect Mylar integration unless Mylar is installed in your version of Eclipse.)
    3030  * Download URL : http://subclipse.tigris.org/update_1.2.x.
    3131 * JavaSVN (SVNKit) : pure Java SVN client, providing both Java classes and a set of command line utilities compatible with SVN line mode client (command `jsvn`).
    3232  * Download URL : http://tmate.org/svn/.
    33  * Sunshade : used for parsing PAN compiler output.
     33 * Sunshade : used for error linking between console and editor (useful for opening templates where an error occurred)
    3434  * Download URL : http://sunshade.sourceforge.net/update.
    35  * Colorer : used for syntax colouring in templates.
     35 * Colorer (optional): used for syntax coloring in templates.
    3636  * Download URL : http://colorer.sf.net/eclipsecolorer/.
    3737
     
    5252=== Colorer ===
    5353
    54 Colorer is used to do syntax colouring when editing PAN templates.
     54Colorer is used to do syntax coloring when editing PAN templates.
    5555
    56 Syntax colouring rules are defined in a file `pan.hrc` that can be downloaded from Quattor CVS (in [http://isscvs.cern.ch:8180/cgi-bin/cvsweb.cgi/elfms/quattor/util/eclipse/pan.hrc?cvsroot=elfms elfms/Quattor/utils/eclipse]). This file must be placed in
     56Syntax coloring rules are defined in a file `pan.hrc` that can be downloaded from Quattor CVS (in [http://isscvs.cern.ch:8180/cgi-bin/cvsweb.cgi/elfms/quattor/util/eclipse/pan.hrc?cvsroot=elfms elfms/Quattor/utils/eclipse]). This file must be placed in
    5757`/path/to/eclipse/plugins/net.sf.colorer_VERSION/colorer/hrc/auto`.
    5858
     
    7474The links identified with these expressions will take you to the start of the expression causing the error.  Note that the error messages give you the full range of the expression in the format "beginLine.beginChar-endLine.endChar".
    7575 
    76 ''Note : The regexp above are intended for panc v7 and later. If you are still using panc v6 or before, you need to use a different set of regular expresssions. Both can coexist.''
     76''Note : The regexp above are intended for panc v7 and later. If you are still using panc v6 or before, you need to use a different set of regular expressions. Both can coexist.''
    7777{{{
    7878\[pan-syntax\]\s*(.*\.tpl):(\d+):