ctakes-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From tm...@apache.org
Subject svn commit: r1616516 - /ctakes/site/trunk/content/developer-faqs.mdtext
Date Thu, 07 Aug 2014 15:57:00 GMT
Author: tmill
Date: Thu Aug  7 15:57:00 2014
New Revision: 1616516

URL: http://svn.apache.org/r1616516
Added Q about managing resources in eclipse.


Modified: ctakes/site/trunk/content/developer-faqs.mdtext
URL: http://svn.apache.org/viewvc/ctakes/site/trunk/content/developer-faqs.mdtext?rev=1616516&r1=1616515&r2=1616516&view=diff
--- ctakes/site/trunk/content/developer-faqs.mdtext (original)
+++ ctakes/site/trunk/content/developer-faqs.mdtext Thu Aug  7 15:57:00 2014
@@ -34,6 +34,26 @@ Submit issues using [JIRA][4]. Anyone ma
   - Branches - cTAKES uses SVN branches for major releases and one-off attempts at major
functions. One-off attempts may or may not be merged back into the trunk in the future. Checkout
from a branch only if you know you are part of that feature. 
   - Tags - cTAKES uses SVN tags to delineate release candidates, betas, major releases and
any other stable points in time off of the trunk. You should only checkout from a tag as the
release manager or for bug fixes going into patch releases.
+### How do I work around issues with resource directories in Eclipse and m2e?
+There is [a known issue][19] with m2e blowing away unpacked resources directories during
the build process. 
+This can be very frustrating, as it will lead to Eclipse runtime using resources from 
+the jar files which will dramatically slow the dictionary lookup. 
+If you notice this slowness, check your 
+ctakes-dictionary-res/target/classes/ directory -- if you are missing the
+org/apache/ctakes/dictionary/lookup/umls2011ab/ path then you  are a victim of this issue.
+To workaround, we will run mvn clean compile on the cTAKES root project, then run mvn project
update on all cTAKES projects.
+Within eclipse do the following:
+ 1. Open the run configuration window (Run->Run configurations...)
+ 2. Select "Maven Build" in the left pane, then click the "New launch configuration" button
+ 3. For the "Base directory" text box use the "Browse Workspace" option to select the root
cTAKES project (just called "ctakes").
+ 4. In the "Goals" text box enter "clean compile" (without the quotes), save, and run. This
may take a while, because it will re-unpack the dictionary jars as well as re-compiling all
of the source.
+This will also clean the generated (type system) sources and not regenerate them, leaving
many compiler errors.
+ 5. To regenerate type system sources, select the cTAKES root project in the package explorer
window and select Maven->Update project in the context (right-click) window.
+This should bring up a window where all cTAKES modules are selected for updating. Press OK
and all source will be generated, and the compiler errors should disappear.
   [1]: http://ctakes.apache.org/mailing-lists.html#development-mailing-list
   [2]: http://ctakes.apache.org/mailing-lists.html
@@ -52,4 +72,5 @@ Submit issues using [JIRA][4]. Anyone ma
   [15]: mailto:private-subscribe@ctakes.apache.org
   [16]: http://www.apache.org/dev/new-committers-guide.html
   [17]: https://issues.apache.org/jira/browse/INFRA
-  [18]: http://www.apache.org/dev/infra-contact
\ No newline at end of file
+  [18]: http://www.apache.org/dev/infra-contact
+  [19]: https://issues.sonatype.org/browse/MNGECLIPSE-823
\ No newline at end of file

View raw message