--- a/dwt/ole/win32/OleControlSite.d	Tue Jul 01 08:58:50 2008 +0200
+++ b/dwt/ole/win32/OleControlSite.d	Tue Jul 01 10:15:59 2008 +0200
@@ -1,5 +1,5 @@
 /*******************************************************************************
- * Copyright (c) 2000, 2007 IBM Corporation and others.
+ * Copyright (c) 2000, 2008 IBM Corporation and others.
  * All rights reserved. This program and the accompanying materials
  * are made available under the terms of the Eclipse Public License v1.0
  * which accompanies this distribution, and is available at
@@ -61,6 +61,8 @@
  *  <dt><b>Events</b> <dd>Dispose, Move, Resize
  * </dl>
  *
+ * @see <a href="http://www.eclipse.org/swt/snippets/#ole">OLE and ActiveX snippets</a>
+ * @see <a href="http://www.eclipse.org/swt/examples.php">DWT Examples: OLEExample, OleWebBrowser</a>
  */
 public class OleControlSite : OleClientSite
 {
@@ -95,7 +97,7 @@
  *               in the registry for this Control (for example, the VersionIndependentProgID for
  *               Internet Explorer is Shell.Explorer)
  *
- *@exception IllegalArgumentException <ul>
+ * @exception IllegalArgumentException <ul>
  *     <li>ERROR_NULL_ARGUMENT when the parent is null
  *</ul>
  * @exception DWTException <ul>
@@ -468,10 +470,14 @@
 }
 /**
  *
- * Get the control site property specified by the dispIdMember.
+ * Get the control site property specified by the dispIdMember, or
+ * <code>null</code> if the dispId is not recognised.
  *
+ * @param dispId the dispId
+ *
+ * @return the property value or <code>null</code>
+ * 
  * @since 2.1
- *
  */
 public Variant getSiteProperty(int dispId){
     for (int i = 0; i < sitePropertyIds.length; i++) {
@@ -651,7 +657,7 @@
  *
  * @param eventID the event identifier
  *
- * @param listener the listener
+ * @param listener the listener which should no longer be notified
  *
  * @exception IllegalArgumentException <ul>
  *      <li>ERROR_NULL_ARGUMENT when listener is null</li>
@@ -692,17 +698,15 @@
 /**
  * Removes the listener.
  *
- * @since 2.0
- *
  * @param automation the automation object that provides the event notification
- *
  * @param eventID the event identifier
- *
- * @param listener the listener
+ * @param listener the listener which should no longer be notified
  *
  * @exception IllegalArgumentException <ul>
  *      <li>ERROR_NULL_ARGUMENT when listener is null</li>
  * </ul>
+ * 
+ * @since 2.0
  */
 public void removeEventListener(OleAutomation automation, int eventID, OleListener listener) {
     checkWidget();
@@ -753,7 +757,8 @@
 /**
  * Removes the listener.
  *
- * @param listener the listener
+ * @param propertyID the identifier of the property
+ * @param listener the listener which should no longer be notified
  *
  * @exception IllegalArgumentException <ul>
  *      <li>ERROR_NULL_ARGUMENT when listener is null</li>