Some Javadoc for ICLanguageSettingEntry interfaces

core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/settings/model/ICIncludeFileEntry.java

@@ -10,6 +10,10 @@
  *******************************************************************************/
 package org.eclipse.cdt.core.settings.model;
 
+/**
+ * Representation in the project model of language settings entries
+ * such as include files ({@code -include file} gcc option). See {@link ICSettingEntry#INCLUDE_FILE}.
+ */
 public interface ICIncludeFileEntry extends ICLanguageSettingPathEntry {
 
 }

core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/settings/model/ICIncludePathEntry.java

@@ -10,6 +10,10 @@
  *******************************************************************************/
 package org.eclipse.cdt.core.settings.model;
 
+/**
+ * Representation in the project model of language settings entries
+ * include paths (-I). See {@link ICSettingEntry#INCLUDE_PATH}.
+ */
 public interface ICIncludePathEntry extends ICLanguageSettingPathEntry {
 	boolean isLocal();
 }

core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/settings/model/ICLanguageSettingEntry.java

@@ -10,5 +10,10 @@
  *******************************************************************************/
 package org.eclipse.cdt.core.settings.model;
 
-public interface ICLanguageSettingEntry extends ICSettingEntry{
+/**
+ * Representation in the project model of language settings entries
+ * such as include paths (-I) or preprocessor defines (-D) and others (see
+ * {@link ICSettingEntry#INCLUDE_PATH} and other kinds).
+ */
+public interface ICLanguageSettingEntry extends ICSettingEntry {
 }

core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/settings/model/ICLanguageSettingPathEntry.java

@@ -10,5 +10,10 @@
  *******************************************************************************/
 package org.eclipse.cdt.core.settings.model;
 
+/**
+ * Representation in the project model of language settings entries of
+ * path-kind such as include paths (-I) or include files and others.
+ * See interface hierarchy for more specifics.
+ */
 public interface ICLanguageSettingPathEntry extends ICLanguageSettingEntry, ICPathEntry {
 }

core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/settings/model/ICLibraryFileEntry.java

@@ -12,6 +12,10 @@ package org.eclipse.cdt.core.settings.model;
 
 import org.eclipse.core.runtime.IPath;
 
+/**
+ * Representation in the project model of language settings entries
+ * such as library file (-l gcc option). See {@link ICSettingEntry#LIBRARY_FILE}.
+ */
 public interface ICLibraryFileEntry extends ICLanguageSettingPathEntry {
 
 	/**

core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/settings/model/ICLibraryPathEntry.java

@@ -10,6 +10,10 @@
  *******************************************************************************/
 package org.eclipse.cdt.core.settings.model;
 
+/**
+ * Representation in the project model of language settings entries
+ * such as library path (-L gcc option). See {@link ICSettingEntry#LIBRARY_PATH}.
+ */
 public interface ICLibraryPathEntry extends ICLanguageSettingPathEntry {
 
 }

core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/settings/model/ICMacroEntry.java

@@ -10,6 +10,14 @@
  *******************************************************************************/
 package org.eclipse.cdt.core.settings.model;
 
+/**
+ * Representation in the project model of language settings entries having
+ * name-value attributes such as preprocessor defines (-D).
+ * See {@link ICSettingEntry#MACRO}.
+ */
 public interface ICMacroEntry extends ICLanguageSettingEntry {
+	/* (non-Javadoc)
+	 * @see org.eclipse.cdt.core.settings.model.ICSettingEntry#getValue()
+	 */
 	String getValue();
 }

core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/settings/model/ICMacroFileEntry.java

@@ -10,6 +10,11 @@
  *******************************************************************************/
 package org.eclipse.cdt.core.settings.model;
 
+/**
+ * Representation in the project model of language settings entries
+ * such as macro file ({@code -imacros file} gcc option).
+ * See {@link ICSettingEntry#MACRO_FILE}.
+ */
 public interface ICMacroFileEntry extends ICLanguageSettingPathEntry {
 
 }

core/org.eclipse.cdt.core/model/org/eclipse/cdt/core/settings/model/ICPathEntry.java

@@ -12,6 +12,11 @@ package org.eclipse.cdt.core.settings.model;
 
 import org.eclipse.core.runtime.IPath;
 
+/**
+ * Helper interface capturing 'path' characteristic for {@link ICSettingEntry}
+ * and {@link ICLanguageSettingEntry} interfaces.
+ *
+ */
 public interface ICPathEntry extends ICSettingEntry {
 	IPath getFullPath();