Revision: 15100
http://gate.svn.sourceforge.net/gate/?rev=15100&view=rev
Author: valyt
Date: 2012-01-17 11:12:07 +0000 (Tue, 17 Jan 2012)
Log Message:
-----------
Updated the starting-up GATE section
Added recent-changes entries about the new launcher and the removal of GUK.
Modified Paths:
--------------
userguide/trunk/gettingstarted.tex
userguide/trunk/recent-changes.tex
Modified: userguide/trunk/gettingstarted.tex
===================================================================
--- userguide/trunk/gettingstarted.tex 2012-01-17 10:36:09 UTC (rev 15099)
+++ userguide/trunk/gettingstarted.tex 2012-01-17 11:12:07 UTC (rev 15100)
@@ -59,24 +59,18 @@
\item version 6.0 for GATE 6.1 or later.
\end{itemize}
available free from
-\htlink{http://java.sun.com/products/jdk/}{Sun Microsystems}
+\htlink{http://www.oracle.com/technetwork/java/javase/overview/index.html}{Oracle}
or from your UNIX supplier. (We test on various Sun
JDKs on Solaris, Linux and Windows XP.)
-\item
-Binaries from the GATE distribution you downloaded:
-{\tt gate.jar}, {\tt lib/ext/guk.jar} (Unicode editing support)
-and a suitable script to start Ant, e.g. {\tt ant.sh} or {\tt ant.bat}.
-These are held in a directory called {\tt bin} like this:
-\begin{verbatim}
- .../bin/
- gate.jar
- ant.sh
- ant.bat
-\end{verbatim}
-You will also need the {\tt lib} directory, containing various libraries that
-GATE depends on.
-\item
-An open mind and a sense of humour.
+\item Binaries from the GATE distribution you downloaded: {\tt gate.jar} (which
+can be found in the directory called {\tt bin}). You will also need the {\tt
+lib} directory, containing various libraries that GATE depends on.
+\item a suitable \htlink{http://ant.apache.org/}{Apache ANT} installation
+(version 1.8.1 or newer). You will need to add an environment variable named
+\verb!ANT_HOME! pointing to your ANT installation, and add \verb!ANT_HOME/bin!
+to your {\tt PATH}.
+
+\item An open mind and a sense of humour.
\end{itemize}
Using the binary distribution:
@@ -87,15 +81,13 @@
\item
To run GATE Developer:
on Windows, start a Command Prompt window, change to the directory where you
-unpacked the GATE distribution and run {\tt `bin/ant.bat run'}; on UNIX/Linux
-or Mac open a terminal window and run {\tt `bin/ant run'}. On UNIX/Linux
-system you can alternately also use the \verb|bin/gate.sh| script
-(see section~\ref{sec:gettingstarted:runonlinux}).
+unpacked the GATE distribution and run {\tt `ant.bat run'}; on UNIX/Linux
+or Mac open a terminal window and run {\tt `ant run'}. Alternatively, you can
+use the \verb|bin/gate.sh| script on UNIX/Linux systems (see
+section~\ref{sec:gettingstarted:runonlinux}), or \verb!bin/gate.bat! on
Windows.
\item
To embed GATE as a library (GATE Embedded), put {\tt gate.jar} and all
-the libraries in the lib directory in your {\tt CLASSPATH} and tell
-Java that guk.jar is an extension ({\tt
--Djava.ext.dirs=path-to-guk.jar}).
+the libraries in the lib directory in your {\tt CLASSPATH}.
\end{itemize}
The Ant scripts that start GATE Developer ({\tt ant.bat} or {\tt ant})
@@ -104,7 +96,7 @@
%
The value of {\tt GATE\_CONFIG} is passed to the system by the scripts using
either a {\tt -i} command-line option, or the Java property {\tt
-gate.config}.
+gate.site.config}.
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
@@ -154,10 +146,14 @@
(see section~\ref{sec:developer:savestate}).
This is equivalent to setting the property
\texttt{gate.user.resourceshome} to
this location.
- \item[\emph{all other parameters}] are passed on to the \texttt{ant}
command.
- This can be used to e.g. set properties using the \texttt{ant} option
\texttt{-D}. For
- example to set the maximum amount of heap memory to be used when running
GATE
- to 6000M, you can add \texttt{-Druntime.max.memory=6000m} as a parameter.
+ \item[-d \emph{URL}] loads the CREOLE plugin at the given URL during the
+ start-up process.
+ \item[-i \emph{file}] uses the specified file as the site configuration.
+ \item[\emph{all other parameters}] are passed on to the \texttt{java}
command.
+ This can be used to e.g. set properties using the \texttt{java} option
+ \texttt{-D}. For example to set the maximum amount of heap memory to be
+ used when running GATE to 6000M, you can add
+ \texttt{-DXmx6000m} as a parameter.
The name of any property that should get passed on to GATE should be
prepended
with \texttt{'run.'}.
In order to change the default encoding used by GATE to \texttt{UTF-8}
add
@@ -235,7 +231,7 @@
syntax, prepending `\texttt{run.}' to the property name,
for example to set \texttt{gate.user.config}:
-\texttt{./bin/ant run -Drun.gate.user.config=/my/path/to/user/config.file} \\
+\texttt{ant run -Drun.gate.user.config=/my/path/to/user/config.file} \\
or \\
\texttt{./bin/gate.sh -Drun.gate.user.config=/my/path/to/user/config.file}
Modified: userguide/trunk/recent-changes.tex
===================================================================
--- userguide/trunk/recent-changes.tex 2012-01-17 10:36:09 UTC (rev 15099)
+++ userguide/trunk/recent-changes.tex 2012-01-17 11:12:07 UTC (rev 15100)
@@ -35,6 +35,14 @@
applications with the old parameters should still work. Please see Section
\ref{sec:gazetteers:flexgazetteer}
for more details.
+A new Java-based launcher was implemented which now replaces the use of Apache
+ANT for starting-up GATE Developer.
+
+The GATE Unicode Kit (GUK) has been removed from the GATE distribution as it
has
+been superseded by localisation support in the various operating systems. If
you
+require GUK, you can still find it as a separate software project available at
+SourceForge (\url{http://gate.svn.sourceforge.net/viewvc/gate/guk/trunk/}).
+
\rcSubsect{December 2011}
Segment Processing PR has two additional run-time parameters called
This was sent by the SourceForge.net collaborative development platform, the
world's largest Open Source development site.
------------------------------------------------------------------------------
Keep Your Developer Skills Current with LearnDevNow!
The most comprehensive online learning library for Microsoft developers
is just $99.99! Visual Studio, SharePoint, SQL - plus HTML5, CSS3, MVC3,
Metro Style Apps, more. Free future releases when you subscribe now!
http://p.sf.net/sfu/learndevnow-d2d
_______________________________________________
GATE-cvs mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/gate-cvs
