1.1 restoration

[mir.git] / source / mircoders / localizer / basic / MirBasicChildArticlePostingHandler.java

diff --git a/source/mircoders/localizer/basic/MirBasicChildArticlePostingHandler.java b/source/mircoders/localizer/basic/MirBasicChildArticlePostingHandler.java
index 8e4cdcb..f8c49fe 100755 (executable)
--- a/source/mircoders/localizer/basic/MirBasicChildArticlePostingHandler.java
+++ b/source/mircoders/localizer/basic/MirBasicChildArticlePostingHandler.java
@@ -36,7 +36,10 @@ import mir.session.SessionExc;
 import mir.session.SessionFailure;
 import mircoders.entity.EntityContent;
 
-
+/**
+ * Handler for open postings of "child articles", that is articles
+ * linked to other articles. Used frequently for translations.
+ */
 public class MirBasicChildArticlePostingHandler extends MirBasicArticlePostingHandler {
   public MirBasicChildArticlePostingHandler() {
     super();
@@ -44,12 +47,25 @@ public class MirBasicChildArticlePostingHandler extends MirBasicArticlePostingHa
     setNormalResponseGenerator(configuration.getString("Localizer.OpenSession.article.EditTemplate"));
   }
 
+  /**
+   * {@inheritDoc}
+   *
+   * <p>
+   * This class overrides this method to set the parent article.
+   */
   public void finalizeArticle(Request aRequest, Session aSession, EntityContent anArticle) throws SessionExc, SessionFailure {
     super.finalizeArticle(aRequest, aSession, anArticle);
 
     anArticle.setFieldValue("to_content", (String) aSession.getAttribute("to_content"));
   }
 
+  /**
+   * {@inheritDoc}
+   *
+   * <p>
+   * Overridden by this class to retrieve and store the to be associated
+   * parent article for subsequent usage.
+   */
   protected void initializeSession(Request aRequest, Session aSession) throws SessionExc, SessionFailure {
     super.initializeSession(aRequest, aSession);