Index: arch-core-palette.xml
===================================================================
RCS file: /cvs/core/arch/arch-core-palette.xml,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- arch-core-palette.xml	21 Jul 2005 09:41:28 -0000	1.3
+++ arch-core-palette.xml	10 Aug 2005 11:31:13 -0000	1.4
@@ -47,6 +47,12 @@
     The module will autoload.
 <api name="Palette" group="java" type="export" category="devel" url="http://www.netbeans.org/download/dev/javadoc/org-netbeans-spi-palette"/>   
   </p>
+  <p>
+      The API includes support for the clients writing palette content insertable into the text editor.<br/>
+      This support covers the DTD definition of the palette item definition file format and the content
+      of the Lookup holding object(s) representing the selected item.
+<api name="editor-palette-item-1_0.dtd" group="dtd" type="export" category="devel" url="http://www.netbeans.org/dtds/editor-palette-item-1_0.dtd" />
+  </p>
  </answer>
 
 
@@ -150,6 +156,24 @@
            FileObject.getAttribute().</p>
     </usecase>
   </p>
+  <p>
+    <usecase id="items" name="Writing Item" >
+        <p>The following steps must be taken when writing the item using the support provided by this module:</p>
+            <ol>
+                <li>
+                    Create XML file with item definition according to 
+                    the <a href="#dtd-editor-palette-item-1_0.dtd">editor-palette-item-1_0.dtd</a>.
+                </li>
+                <li>
+                    Register it in the editor's layer file (see Basic usage).
+                </li>
+                <li>
+                    Provide custom item implementation of the ActiveEditorDrop interface if needed. I must be
+                    referenced from the definition file.
+                </li>
+            </ol>
+    </usecase>
+  </p>
  </answer>
 
 
@@ -275,7 +299,7 @@
   <p>
     <api group="java" name="OpenAPIs" type="import" category="official">
      <p>
-      For acces to Nodes, winsys TopComponent, lookups, resource bundles etc.
+      For acces to Nodes, winsys TopComponent, ActiveEditorDrop, lookups, resource bundles etc.
      </p>
     </api>
   </p>
@@ -741,7 +765,19 @@
 -->
  <answer id="lookup-register">
   <p>
-   No
+    <api name="node_represention" group="lookup" type="export" category="devel">
+        The palette item implementor can either directly provide the item body 
+        or her own item class implementing <code>org.openide.text.ActiveEditorDrop</code> interface.
+        <br/>
+        Lookup that holds object(s) representing the selected item then associates 
+        custom item class instance with the <code>org.openide.text.ActiveEditorDrop.class</code> key and 
+        the body with <code>java.lang.String</code> key.
+        <br/>
+        Editor side implementor can use the Lookup content whenever the Lookup is given, 
+        namely in the editor-provided implementations of the <code>PaletteActions</code>,
+        <code>DragAndDropHandler</code> and <code>PropertyChangeListener</code> (registered 
+        on the <code>PaletteController</code>) interfaces.
+    </api>
   </p>
  </answer>