svn commit: r500026 - /incubator/uima/uimaj/trunk/uimaj-examples/src/main/java/org/apache/uima/examples/cpe/XCasWriterCasConsumer.java

[sc...@apache.org]

Author: schor
Date: Thu Jan 25 14:32:15 2007
New Revision: 500026

URL: http://svn.apache.org/viewvc?view=rev&rev=500026
Log:
No Jira - augmented the Note comment for the XCasWriterCasConsumer
example, still referencing the newer XmiWriterCasConsumer, but
saying that other tooling and services are still using the
XCas format - so this is not being deprecated yet, but new
code should consider using the new XmiWriterCasConsumer where
feasible.  

Modified:
    incubator/uima/uimaj/trunk/uimaj-examples/src/main/java/org/apache/uima/examples/cpe/XCasWriterCasConsumer.java

Modified: incubator/uima/uimaj/trunk/uimaj-examples/src/main/java/org/apache/uima/examples/cpe/XCasWriterCasConsumer.java
URL: http://svn.apache.org/viewvc/incubator/uima/uimaj/trunk/uimaj-examples/src/main/java/org/apache/uima/examples/cpe/XCasWriterCasConsumer.java?view=diff&rev=500026&r1=500025&r2=500026
==============================================================================
--- incubator/uima/uimaj/trunk/uimaj-examples/src/main/java/org/apache/uima/examples/cpe/XCasWriterCasConsumer.java (original)
+++ incubator/uima/uimaj/trunk/uimaj-examples/src/main/java/org/apache/uima/examples/cpe/XCasWriterCasConsumer.java Thu Jan 25 14:32:15 2007
@@ -20,10 +20,14 @@
 package org.apache.uima.examples.cpe;
 /* 
  *******************************************************************************************
- * N O T E :     The XML format (XCAS) that this Cas Consumer outputs, is
- *               is deprecated, but is being kept for compatibility with older versions
+ * N O T E :     The XML format (XCAS) that this Cas Consumer outputs, is eventually 
+ *               being superceeded by the more standardized and compact XMI format.  However
+ *               it is used currently as the expected form for remote services, and there is
+ *               existing tooling for doing stand-alone component development and debugging 
+ *               that uses this format to populate an initial CAS.  So it is not 
+ *               deprecated yet;  it is also being kept for compatibility with older versions.
  *               
- *               New code should use the XmiWriterCasConsumer
+ *               New code should consider using the XmiWriterCasConsumer where possible,
  *               which uses the current XMI format for XML externalizations of the CAS
  *******************************************************************************************               
  */