Add comments.


git-svn-id: https://svn.apache.org/repos/asf/maven/sandbox/branches/doxia-ide-eclipse-with-tycho@1163055 13f79535-47bb-0310-9956-ffa450edef68
diff --git a/eclipse-plugins/plugins/org.apache.maven.doxia.ide.eclipse.common.ui/pom.xml b/eclipse-plugins/plugins/org.apache.maven.doxia.ide.eclipse.common.ui/pom.xml
index a762275..f67a5aa 100644
--- a/eclipse-plugins/plugins/org.apache.maven.doxia.ide.eclipse.common.ui/pom.xml
+++ b/eclipse-plugins/plugins/org.apache.maven.doxia.ide.eclipse.common.ui/pom.xml
@@ -31,6 +31,13 @@
     <name>Doxia Tools :: Eclipse IDE - Common UI Plugin</name>
     <description>Eclipse IDE - Common UI Plugin</description>
     <build>
+    <!--
+     Sadly, the PDE does not understand copying from someplace like
+     src/main/resources to the root of the output. So, for the icons
+     to work from PDE debugging, they have to really be at the top of the
+     project, and thus this exercise to get them into the output jar
+     with Maven. 
+     -->
         <resources>
             <resource>
                 <targetPath>/</targetPath>
diff --git a/eclipse-plugins/plugins/org.apache.maven.doxia.ide.eclipse.common.ui/src/main/java/org/apache/maven/doxia/ide/eclipse/common/ui/AbstractDoxiaPlugin.java b/eclipse-plugins/plugins/org.apache.maven.doxia.ide.eclipse.common.ui/src/main/java/org/apache/maven/doxia/ide/eclipse/common/ui/AbstractDoxiaPlugin.java
index de922c3..1359bf4 100644
--- a/eclipse-plugins/plugins/org.apache.maven.doxia.ide.eclipse.common.ui/src/main/java/org/apache/maven/doxia/ide/eclipse/common/ui/AbstractDoxiaPlugin.java
+++ b/eclipse-plugins/plugins/org.apache.maven.doxia.ide.eclipse.common.ui/src/main/java/org/apache/maven/doxia/ide/eclipse/common/ui/AbstractDoxiaPlugin.java
@@ -132,6 +132,15 @@
     // Private methods
     // ----------------------------------------------------------------------
 
+    /*
+     * TODO:
+     * This function gets the icons from a bundle path, not the classpath.
+     * This in turn requires them to be in the root of the source of the project
+     * to make the PDE work. It would be better, I think, to put them 
+     * on classpath if Eclipse will let us.
+     */
+    
+    
     private ImageDescriptor registerImage( String path )
     {
         Assert.isNotNull( path, "path is not initialized." );