Index: /home/tverhagen/dev_ext/ivy/src/java/org/apache/ivy/core/module/descriptor/Artifact.java
===================================================================
--- /home/tverhagen/dev_ext/ivy/src/java/org/apache/ivy/core/module/descriptor/Artifact.java	(revision 551245)
+++ /home/tverhagen/dev_ext/ivy/src/java/org/apache/ivy/core/module/descriptor/Artifact.java	(working copy)
@@ -26,8 +26,8 @@
 
 /**
  * Representation of a published 'file' in the development environment. An artifact is generally a
- * file that is produced by a project build. This is typically a jar, a war, an ear, a zip, a deb,
- * ...
+ * file that is produced by a project build. This is typically a <code>jar</code>, a <code>war</code>,
+ * an <code>ear</code>, a <code>zip</code>, a <code>deb</code>, etc.
  */
 public interface Artifact extends ExtendableItem {
 
Index: /home/tverhagen/dev_ext/ivy/src/java/org/apache/ivy/core/module/descriptor/ModuleDescriptor.java
===================================================================
--- /home/tverhagen/dev_ext/ivy/src/java/org/apache/ivy/core/module/descriptor/ModuleDescriptor.java	(revision 551245)
+++ /home/tverhagen/dev_ext/ivy/src/java/org/apache/ivy/core/module/descriptor/ModuleDescriptor.java	(working copy)
@@ -76,9 +76,9 @@
     String getStatus();
 
     /**
-     * may be null if unknown in the descriptor itself
+     * May be <code>null</code> if unknown in the descriptor itself.
      * 
-     * @return
+     * @return  The publication date or <code>null</code> when not knwon.
      */
     Date getPublicationDate();
 
@@ -83,7 +83,7 @@
     Date getPublicationDate();
 
     /**
-     * the publication date of the module revision should be the date at which it has been
+     * The publication date of the module revision should be the date at which it has been
      * published, i.e. in general the date of any of its published artifacts, since all published
      * artifact of a module should follow the same publishing cycle.
      */