class javadocs
diff --git a/jspwiki-main/src/main/java/org/apache/wiki/WikiEngine.java b/jspwiki-main/src/main/java/org/apache/wiki/WikiEngine.java
index 1afc4b1..8b4aca4 100644
--- a/jspwiki-main/src/main/java/org/apache/wiki/WikiEngine.java
+++ b/jspwiki-main/src/main/java/org/apache/wiki/WikiEngine.java
@@ -80,17 +80,14 @@
/**
- * Provides Wiki services to the JSP page.
+ * Main implementation for {@link Engine}.
*
* <P>
- * This is the main interface through which everything should go.
- *
- * <P>
- * Using this class: Always get yourself an instance from JSP page by using the WikiEngine.getInstance() method. Never create a new
- * WikiEngine() from scratch, unless you're writing tests.
+ * Using this class: Always get yourself an instance from JSP page by using the {@code WikiEngine.getInstance(..)} method. Never create
+ * a new WikiEngine() from scratch, unless you're writing tests.
*
* <p>
- * There's basically only a single WikiEngine for each web application, and you should always get it using the WikiEngine.getInstance() method.
+ * {@inheritDoc}
*/
public class WikiEngine implements Engine {
diff --git a/jspwiki-main/src/main/java/org/apache/wiki/api/core/Engine.java b/jspwiki-main/src/main/java/org/apache/wiki/api/core/Engine.java
index bab095c..d51cb0d 100644
--- a/jspwiki-main/src/main/java/org/apache/wiki/api/core/Engine.java
+++ b/jspwiki-main/src/main/java/org/apache/wiki/api/core/Engine.java
@@ -37,6 +37,16 @@
import java.util.Properties;
+/**
+ * Provides Wiki services to the JSP page.
+ *
+ * <P>
+ * This is the main interface through which everything should go.
+ *
+ * <p>
+ * There's basically only a single Engine for each web application, and you should always get it using the {@code WikiEngine.getInstance(..)}
+ * method.
+ */
public interface Engine {
/** The default inlining pattern. Currently "*.png" */