From f60fca73f3f1593d9778b80f7f5d8214bfa9f0ed Mon Sep 17 00:00:00 2001
From: jensp <jensp@8810af33-2d31-482b-a856-94f89814c4df>
Date: Sun, 2 Oct 2011 11:51:17 +0000
Subject: [PATCH] =?UTF-8?q?Kommentare=20im=20Source-Code=20erg=C3=A4nzt?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

git-svn-id: https://svn.libreccm.org/ccm/trunk@1130 8810af33-2d31-482b-a856-94f89814c4df
---
 .../PersonalPublications.java                 |  6 +++-
 .../PersonalPublicationsConfig.java           | 30 +++++++++++++++++--
 2 files changed, 33 insertions(+), 3 deletions(-)

diff --git a/ccm-sci-personalpublications/src/com/arsdigita/cms/publicpersonalprofile/PersonalPublications.java b/ccm-sci-personalpublications/src/com/arsdigita/cms/publicpersonalprofile/PersonalPublications.java
index 89e94538a..7089a9f01 100644
--- a/ccm-sci-personalpublications/src/com/arsdigita/cms/publicpersonalprofile/PersonalPublications.java
+++ b/ccm-sci-personalpublications/src/com/arsdigita/cms/publicpersonalprofile/PersonalPublications.java
@@ -19,7 +19,11 @@ import javax.servlet.http.HttpServletRequest;
 import org.apache.log4j.Logger;
 
 /**
- *
+ * A {@link ContentGenerator} for personal profiles which displays all 
+ * publications of a person. The person and be organized in groups. The groups
+ * are configured via the configuration.
+ * 
+ * 
  * @author Jens Pelzetter
  * @version $Id$
  */
diff --git a/ccm-sci-personalpublications/src/com/arsdigita/cms/publicpersonalprofile/PersonalPublicationsConfig.java b/ccm-sci-personalpublications/src/com/arsdigita/cms/publicpersonalprofile/PersonalPublicationsConfig.java
index f7435b1ac..461b72c42 100644
--- a/ccm-sci-personalpublications/src/com/arsdigita/cms/publicpersonalprofile/PersonalPublicationsConfig.java
+++ b/ccm-sci-personalpublications/src/com/arsdigita/cms/publicpersonalprofile/PersonalPublicationsConfig.java
@@ -1,5 +1,6 @@
 package com.arsdigita.cms.publicpersonalprofile;
 
+import com.arsdigita.cms.contenttypes.Publication;
 import com.arsdigita.runtime.AbstractConfig;
 import com.arsdigita.util.parameter.IntegerParameter;
 import com.arsdigita.util.parameter.Parameter;
@@ -13,8 +14,33 @@ import com.arsdigita.util.parameter.StringParameter;
 public class PersonalPublicationsConfig extends AbstractConfig {
 
     /**
-     * Groups of publications. See {@link PersonalPublications} for a detailed 
-     * explanation.
+     * <p>
+     * Groups of publications. The syntax for this string is as follows 
+     * (as EBNF):
+     * </p>
+     * <pre>
+     * publicationGroupsConfig = groupDefinition {";"groupDefinition};
+     * groupDefinition = groupName":"typeDef{";"type};
+     * typeDef = typeName["_ref"];
+     * </pre>
+     * <p>
+     * The groups definition string consists of one or more group definitions. 
+     * Group definitions are separated by the semicolon {@code ;}.
+     * Each groups definition consists of a group name and a comma separated 
+     * lists of type names. Group name and types names are separated by a colon.
+     * </p>
+     * <p>
+     * {@code groupName} and {@code typeName} are not shown in the above 
+     * grammar. A group name may contain all letters (uppercase and 
+     * lowercase), all numbers and the underscore "{@code _}". A type name
+     * is the fully qualified name of content type derived from 
+     * {@link Publication}. A type name can be followed by the literals
+     * {@code _ref} and {@code _noref}. If a type name is not followed by
+     * one of this literals, all publications of the type will be put into the 
+     * group. If the type name is followed by one of this literals, the property
+     * {@code reviewed} is checked. If the type has this property, publications
+     * can be split into reviewed and not reviewed publications.
+     * </p>
      */
     private final Parameter publicationGroups;
     /**