Revision: 18725
http://sourceforge.net/p/gate/code/18725
Author: ian_roberts
Date: 2015-05-28 13:42:41 +0000 (Thu, 28 May 2015)
Log Message:
-----------
A couple of my minor changes - @Sharable can go on fields as well as setters,
and JAPE phase and rule names can now contain hyphens as well as underscores.
Modified Paths:
--------------
userguide/trunk/api.tex
userguide/trunk/jape.tex
Modified: userguide/trunk/api.tex
===================================================================
--- userguide/trunk/api.tex 2015-05-28 13:31:19 UTC (rev 18724)
+++ userguide/trunk/api.tex 2015-05-28 13:42:41 UTC (rev 18725)
@@ -1129,8 +1129,11 @@
in a way that is thread-safe or appropriately synchronized.
The sharable property must have the standard public getter and setter methods,
-with the \verb|@Sharable| annotation applied to the setter. The same setter
-may be marked both as a sharable property and as a \verb|@CreoleParameter| but
+with the \verb|@Sharable| annotation applied to the setter\footnote{In the
+common case where the getter/setter pair are simple accessors for a private
+field whose name matches the Java Bean property name, the annotation may be
+applied to the field rather than to the setter.}. The same setter may be
+marked both as a sharable property and as a \verb|@CreoleParameter| but
the two are not related -- sharable properties that are not parameters and
parameters that are not sharable are both allowed and both have uses in
different circumstances. The use of sharable properties removes the need to
Modified: userguide/trunk/jape.tex
===================================================================
--- userguide/trunk/jape.tex 2015-05-28 13:31:19 UTC (rev 18724)
+++ userguide/trunk/jape.tex 2015-05-28 13:42:41 UTC (rev 18725)
@@ -114,7 +114,8 @@
We began the JAPE grammar by giving it a phase name, e.g. `Phase: Jobtitle'.
JAPE
grammars can be cascaded, and so each grammar is considered to be a `phase'
(see
Section~\ref{sec:jape:phasesequence}).
-The phase name makes up part of the Java class name for the compiled RHS
actions. Because of this, it must contain alphanumeric characters and
underscores only, and cannot start with a number.
+Phase names (and rule names) must contain only alphanumeric characters, hyphens
+and underscores, and cannot start with a number.
We also provide a list of the annotation
types we will use in the grammar. In this case, we say `Input: Lookup' because
This was sent by the SourceForge.net collaborative development platform, the
world's largest Open Source development site.
------------------------------------------------------------------------------
_______________________________________________
GATE-cvs mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/gate-cvs
