Add JavaDoc.

core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/ICodeReaderFactory.java

@@ -13,11 +13,34 @@ package org.eclipse.cdt.core.dom;
 import org.eclipse.cdt.core.parser.CodeReader;
 
 /**
+ * This is the interface that an AST Service uses to delegate the construction
+ * of a CodeReader. 
+ * 
  * @author jcamelon
  */
 public interface ICodeReaderFactory {
     
+
+    /**
+     * @return unique identifier as int
+     */
     public int getUniqueIdentifier();
+    
+    
+    /**
+     * Create CodeReader for translation unit
+     * 
+     * @param path Canonical Path representing path location for file to be opened
+     * @return CodeReader for contents at that path.
+     */
     public CodeReader createCodeReaderForTranslationUnit( String path );
+    
+    
+    /**
+     * Create CodeReader for inclusion.
+     * 
+     * @param path
+     * @return CodeReader for contents at that path.
+     */
     public CodeReader createCodeReaderForInclusion( String path );
 }

core/org.eclipse.cdt.core/parser/org/eclipse/cdt/core/dom/IParserConfiguration.java

@@ -13,11 +13,22 @@ package org.eclipse.cdt.core.dom;
 import org.eclipse.cdt.core.parser.IScannerInfo;
 
 /**
+ * This interface represents a parser configuration as specified by the 
+ * client to the parser service.  
+ * 
  * @author jcamelon
  */
 public interface IParserConfiguration {
 
+    /**
+     * @return IScannerInfo representing the build information required to parse.
+     */
     public IScannerInfo getScannerInfo();
+    
+    //TODO this may change
+    /**
+     * @return String representing dialect name for the language
+     */
     public String getParserDialect();
 
 }