Merge pull request #22 from fvillalba/tagging-deprecated-classes-in-j…

…avadoc-and-installation-guide

Tagging deprecated classes in javadoc and installation guide

gsf-action-legacy/src/main/java/com/fatwire/gst/foundation/controller/action/AbstractActionController.java

@@ -32,6 +32,9 @@
  * 
  * @author Dolf Dijkstra
  * @since May 26, 2011
+ * 
+ * @deprecated as of release 12.x, replace GSF Actions with WCS 12c's native Controllers and/or wrappers
+ * 
  */
 public abstract class AbstractActionController extends AbstractController {
 

gsf-action-legacy/src/main/java/com/fatwire/gst/foundation/controller/action/Action.java

@@ -26,6 +26,9 @@
  * @author Tony Field
  * @author Dolf Dijkstra
  * @since 2011-03-15
+ * 
+ * @deprecated as of release 12.x, replace GSF Actions with WCS 12c's native Controllers and/or wrappers
+ *  
  */
 public interface Action {
     /**

gsf-action-legacy/src/main/java/com/fatwire/gst/foundation/controller/action/ActionController.java

@@ -19,6 +19,9 @@
  * Action controller adapter to provide backward-compatibility with GSF 11.6.1.
  * @author Tony Field
  * @since 15-07-30 4:33 PM
+ * 
+ * @deprecated as of release 12.x, replace GSF Actions with WCS 12c's native Controllers and/or wrappers
+ * 
  */
 public class ActionController extends com.fatwire.gst.foundation.controller.action.support.ActionController {
 }

gsf-action-legacy/src/main/java/com/fatwire/gst/foundation/controller/action/ActionFrameworkController.java

@@ -27,6 +27,10 @@
  * @author Tony Field
  * @author Dolf Dijkstra
  * @since Mar 15, 2011
+ * 
+ * 
+ * @deprecated as of release 12.x, replace GSF Actions with WCS 12c's native Controllers and/or wrappers
+ * 
  */
 public class ActionFrameworkController extends AbstractActionController {
     public ActionFrameworkController(ICS ics) {

gsf-action-legacy/src/main/java/com/fatwire/gst/foundation/controller/action/ActionLocator.java

@@ -25,6 +25,10 @@
  * @author Tony Field
  * @author Dolf Dijkstra
  * @since 2011-03-15
+ * 
+ * 
+ * @deprecated as of release 12.x, replace GSF Actions with WCS 12c's native Controllers and/or wrappers
+ * 
  */
 public interface ActionLocator {
 

gsf-action-legacy/src/main/java/com/fatwire/gst/foundation/controller/action/ActionLocatorUtils.java

@@ -23,6 +23,10 @@
 /**
  * @author Dolf Dijkstra
  * @since Apr 11, 2011
+ * 
+ * 
+ * @deprecated as of release 12.x, replace GSF Actions with WCS 12c's native Controllers and/or wrappers
+ * 
  */
 public final class ActionLocatorUtils {
     public static final String ACTION_LOCATOR_BEAN = "gsfActionLocator";

gsf-action-legacy/src/main/java/com/fatwire/gst/foundation/controller/action/ActionNameResolver.java

@@ -23,6 +23,10 @@
  * 
  * @author Dolf.Dijkstra
  * @since May 27, 2011
+ * 
+ * 
+ * @deprecated as of release 12.x, replace GSF Actions with WCS 12c's native Controllers and/or wrappers
+ * 
  */
 public interface ActionNameResolver {
 

gsf-action-legacy/src/main/java/com/fatwire/gst/foundation/controller/action/ActionNameResolverUtils.java

@@ -30,6 +30,9 @@
 /**
  * @author Dolf Dijkstra
  * @since May 27, 2011
+ * 
+ * @deprecated as of release 12.x, replace GSF Actions with WCS 12c's native Controllers and/or wrappers
+ * 
  */
 public final class ActionNameResolverUtils {
 	protected static final Logger LOG = LoggerFactory.getLogger("tools.gsf.controller.action.ActionNameResolverUtils");

gsf-action-legacy/src/main/java/com/fatwire/gst/foundation/controller/action/RenderPage.java

@@ -30,6 +30,9 @@
  * 
  * @author Dolf Dijkstra
  * @since 2011-03-15
+ * 
+ * @deprecated as of release 12.x, replace GSF Actions with WCS 12c's native Controllers and/or wrappers
+ * 
  */
 public class RenderPage extends WraRenderPage implements Action {
 

gsf-action-legacy/src/main/java/com/fatwire/gst/foundation/controller/action/support/AbstractActionLocator.java

@@ -40,6 +40,10 @@
  * 
  * @author Dolf Dijkstra
  * @since Apr 27, 2011
+ * 
+ * 
+ * @deprecated as of release 12.x, replace GSF Actions with WCS 12c's native Controllers and/or wrappers
+ * 
  */
 public abstract class AbstractActionLocator implements ActionLocator {
 

gsf-action-legacy/src/main/java/com/fatwire/gst/foundation/controller/action/support/ActionController.java

@@ -27,6 +27,9 @@
  * @author Dolf Dijkstra
  * @see ActionFrameworkController
  *
+ *
+ * @deprecated as of release 12.x, replace GSF Actions with WCS 12c's native Controllers and/or wrappers
+ *
  */
 public class ActionController implements Seed2 {
 

gsf-action-legacy/src/main/java/com/fatwire/gst/foundation/controller/action/support/BaseActionLocator.java

@@ -36,6 +36,10 @@
  * 
  * @author Dolf Dijkstra
  * @since Apr 27, 2011
+ * 
+ * 
+ * @deprecated as of release 12.x, replace GSF Actions with WCS 12c's native Controllers and/or wrappers
+ * 
  */
 public abstract class BaseActionLocator extends AbstractActionLocator {
 

gsf-action-legacy/src/main/java/com/fatwire/gst/foundation/controller/action/support/ClassActionLocator.java

@@ -33,6 +33,9 @@
  * 
  * @author Dolf Dijkstra
  *
+ *
+ * @deprecated as of release 12.x, replace GSF Actions with WCS 12c's native Controllers and/or wrappers
+ *
  */
 public class ClassActionLocator extends AbstractActionLocator {
     private static final Logger LOG = LoggerFactory.getLogger("tools.gsf.controller.action.support.ClassActionLocator");

gsf-action-legacy/src/main/java/com/fatwire/gst/foundation/controller/action/support/CommandActionNameResolver.java

@@ -27,6 +27,9 @@
  * 
  * @author Dolf.Dijkstra
  * @since May 26, 2011
+ * 
+ * @deprecated as of release 12.x, replace GSF Actions with WCS 12c's native Controllers and/or wrappers
+ * 
  */
 public class CommandActionNameResolver implements ActionNameResolver {
     private static final String CMD_VAR = "cmd";

gsf-action-legacy/src/main/java/com/fatwire/gst/foundation/controller/action/support/ElementNameActionNameResolver.java

@@ -24,6 +24,10 @@
  * 
  * @author Dolf.Dijkstra
  * @since May 26, 2011
+ * 
+ * 
+ * @deprecated as of release 12.x, replace GSF Actions with WCS 12c's native Controllers and/or wrappers
+ * 
  */
 public class ElementNameActionNameResolver implements ActionNameResolver {
 

gsf-action-legacy/src/main/java/com/fatwire/gst/foundation/controller/action/support/IcsBackedObjectFactoryTemplate.java

@@ -71,6 +71,8 @@
  * @author Dolf.Dijkstra
  * @since Apr 20, 2011
  * 
+ * @deprecated as of release 12.x, replace with SimpleIcsBackedObjectFactory or your own (WCS 12c-friendly) Factory implementation.
+ * 
  */
 public class IcsBackedObjectFactoryTemplate extends BaseFactory {
     /**

gsf-action-legacy/src/main/java/com/fatwire/gst/foundation/controller/action/support/IcsFactoryUtil.java

@@ -29,6 +29,9 @@
  * @since 28 August 2012 (for some history: <a
  *        href="http://en.wikipedia.org/wiki/Siege_of_Groningen">28 August</a>.)
  * 
+ * 
+ * @deprecated as of release 12.x
+ * 
  */
 public class IcsFactoryUtil {
 

gsf-action-legacy/src/main/java/com/fatwire/gst/foundation/controller/action/support/LegacyDefaultWebAppContext.java

@@ -37,6 +37,9 @@
  * 
  * @author Dolf Dijkstra
  * 
+ * 
+ * @deprecated as of release 12.x, replace with new DefaultWebAppContext or your own (WCS 12c-friendly) AppContext implementation.
+ * 
  */
 public class LegacyDefaultWebAppContext extends WebAppContext implements FactoryProducer {
 

gsf-action-legacy/src/main/java/com/fatwire/gst/foundation/controller/action/support/MapActionLocator.java

@@ -34,6 +34,9 @@
  * @author Tony Field
  * @author Dolf Dijkstra
  * @since 2011-03-15
+ * 
+ * @deprecated as of release 12.x, replace GSF Actions with WCS 12c's native Controllers and/or wrappers
+ * 
  */
 
 public class MapActionLocator extends BaseActionLocator {

gsf-action-legacy/src/main/java/com/fatwire/gst/foundation/controller/action/support/NullActionNameResolver.java

@@ -24,6 +24,9 @@
  * 
  * @author Dolf Dijkstra
  *
+ *
+ * @deprecated as of release 12.x, replace GSF Actions with WCS 12c's native Controllers and/or wrappers
+ *
  */
 public class NullActionNameResolver implements ActionNameResolver {
 

gsf-action-legacy/src/main/java/com/fatwire/gst/foundation/controller/action/support/ReflectionFactoryProducer.java

@@ -32,6 +32,8 @@
  * 
  * @author Dolf.Dijkstra
  * 
+ * @deprecated as of release 12.x
+ * 
  */
 public class ReflectionFactoryProducer implements FactoryProducer {
     protected static final Logger LOG = LoggerFactory.getLogger("tools.gsf.controller.action.support.ReflectionFactoryProducer");

gsf-action-legacy/src/main/java/com/fatwire/gst/foundation/controller/action/support/RenderPageActionLocator.java

@@ -28,6 +28,9 @@
  * 
  * @author Dolf Dijkstra
  * 
+ * 
+ * @deprecated as of release 12.x, replace GSF Actions with WCS 12c's native Controllers and/or wrappers
+ * 
  */
 public final class RenderPageActionLocator extends AbstractActionLocator {
     public RenderPageActionLocator(Injector injector) {

gsf-action-legacy/src/main/java/com/fatwire/gst/foundation/controller/action/support/SingleActionLocator.java

@@ -26,6 +26,9 @@
  * 
  * @author Dolf Dijkstra
  * 
+ * 
+ * @deprecated as of release 12.x, replace GSF Actions with WCS 12c's native Controllers and/or wrappers
+ * 
  */
 public class SingleActionLocator extends AbstractActionLocator {
 

gsf-action-legacy/src/main/java/com/fatwire/gst/foundation/controller/annotation/AnnotationController.java

@@ -40,6 +40,10 @@
  * @author Dolf Dijkstra
  * @since Apr 15, 2011
  * @see IcsVariable
+ * 
+ * 
+ * @deprecated as of release 12.x
+ * 
  */
 public abstract class AnnotationController extends AbstractController {
 

gsf-action-legacy/src/main/java/com/fatwire/gst/foundation/controller/support/SpringWebAppContext.java

@@ -28,6 +28,11 @@
 import com.fatwire.gst.foundation.controller.action.support.NullActionNameResolver;
 import com.fatwire.gst.foundation.controller.support.TemplateMethodFactory;
 
+/**
+ * 
+ * @deprecated as of release 12.x, replace with new DefaultWebAppContext or your own custom (WCS 12c-friendly) AppContext implementation.
+ *
+ */
 public class SpringWebAppContext implements AppContext {
 	protected static final Logger LOG = LoggerFactory.getLogger("tools.gsf.controller.support.SpringWebAppContext");
     private static final ActionNameResolver nullActionNameResolver = new NullActionNameResolver();

gsf-action-legacy/src/main/java/com/fatwire/gst/foundation/html/Anchor.java

@@ -18,6 +18,9 @@
 /**
  * @author Dolf Dijkstra
  * @since Apr 16, 2011
+ * 
+ * @deprecated as of release 12.x
+ * 
  */
 public final class Anchor extends BaseElement {
 

gsf-action-legacy/src/main/java/com/fatwire/gst/foundation/html/BaseElement.java

@@ -18,6 +18,9 @@
 /**
  * @author Dolf Dijkstra
  * @since Apr 16, 2011
+ * 
+ * @deprecated as of release 12.x
+ * 
  */
 abstract class BaseElement {
 

gsf-action-legacy/src/main/java/com/fatwire/gst/foundation/html/HtmlCoreAttr.java

@@ -15,6 +15,11 @@
  */
 package com.fatwire.gst.foundation.html;
 
+/**
+ * 
+ * @deprecated as of release 12.x
+ *
+ */
 final class HtmlCoreAttr {
     private String id;
     private String className;

gsf-action-legacy/src/main/java/com/fatwire/gst/foundation/html/HtmlEventsAttr.java

@@ -15,6 +15,11 @@
  */
 package com.fatwire.gst.foundation.html;
 
+/**
+ * 
+ * @deprecated as of release 12.x
+ *
+ */
 final class HtmlEventsAttr {
     private String onclick;
     private String ondblclick;

gsf-action-legacy/src/main/java/com/fatwire/gst/foundation/html/HtmlI18NAttr.java

@@ -15,6 +15,11 @@
  */
 package com.fatwire.gst.foundation.html;
 
+/**
+ * 
+ * @deprecated as of release 12.x
+ *
+ */
 final class HtmlI18NAttr {
 
     private String lang;

gsf-action-legacy/src/main/java/com/fatwire/gst/foundation/html/Img.java

@@ -15,6 +15,11 @@
  */
 package com.fatwire.gst.foundation.html;
 
+/**
+ * 
+ * @deprecated as of release 12.x
+ *
+ */
 public final class Img extends BaseElement {
     private String src;
     private String alt;

gsf-action-legacy/src/main/java/com/fatwire/gst/foundation/include/DefaultIncludeService.java

@@ -28,6 +28,9 @@
 /**
  * @author Dolf Dijkstra
  * @since Apr 13, 2011
+ * 
+ * @deprecated as of release 12.x, replace with OOTB features (e.g. callelement tag, calltemplate tag, ics.RunTag and the like) 
+ * 
  */
 public class DefaultIncludeService implements IncludeService {
 

gsf-action-legacy/src/main/java/com/fatwire/gst/foundation/include/GsfCallTemplate.java

@@ -28,6 +28,11 @@
 import com.fatwire.gst.foundation.facade.runtag.render.CallTemplate.Style;
 import com.fatwire.gst.foundation.facade.runtag.satellite.Page;
 
+/**
+ * 
+ * @deprecated as of release 12.x, replace with OOTB features (e.g. callelement tag, calltemplate tag, ics.RunTag and the like)
+ *
+ */
 public class GsfCallTemplate {
     private String site;
     private String tname;

gsf-action-legacy/src/main/java/com/fatwire/gst/foundation/include/Include.java

@@ -30,6 +30,9 @@
  * 
  * @author Dolf Dijkstra
  * @since Apr 13, 2011
+ * 
+ * @deprecated as of release 12.x, replace with OOTB features in WCS 12c (e.g. Controllers, callelement tag, calltemplate tag, ics.RunTag and the like).
+ * 
  */
 public interface Include {
 

gsf-action-legacy/src/main/java/com/fatwire/gst/foundation/include/IncludeElement.java

@@ -27,6 +27,9 @@
  * 
  * @author Dolf Dijkstra
  * @since Apr 11, 2011
+ * 
+ * @deprecated as of release 12.x, replace with OOTB features (e.g. callelement tag, calltemplate tag, ics.RunTag and the like)
+ * 
  */
 public class IncludeElement implements Include {
 

gsf-action-legacy/src/main/java/com/fatwire/gst/foundation/include/IncludePage.java

@@ -37,8 +37,10 @@
  * 
  * @author Dolf Dijkstra
  * @since Apr 13, 2011
+ * 
+ * @deprecated as of release 12.x, replace with OOTB features (e.g. callelement tag, calltemplate tag, ics.RunTag and the like)
+ * 
  */
-
 public class IncludePage implements Include {
     public static final List<String> FORBIDDEN_VARS = Collections.unmodifiableList(Arrays.asList("tid", "eid", "seid",
             "packedargs", "variant", "context", "pagename", "rendermode", "ft_ss"));

gsf-action-legacy/src/main/java/com/fatwire/gst/foundation/include/IncludeService.java

@@ -23,6 +23,10 @@
  * 
  * @author Dolf Dijkstra
  * @since Apr 13, 2011
+ * 
+ * 
+ * @deprecated as of release 12.x, replace with OOTB features (e.g. callelement tag, calltemplate tag, ics.RunTag and the like)
+ * 
  */
 public interface IncludeService {