xml doc improvements

Author: amaitland

CefSharp/IBrowser.cs

@@ -44,15 +44,15 @@ public interface IBrowser : IDisposable
         bool IsLoading { get; }
 
         /// <summary>
-        /// Request that the browser close. The JavaScript 'onbeforeunload' event will
-        /// be fired. If |forceClose| is false the event handler, if any, will be
-        /// allowed to prompt the user and the user can optionally cancel the close.
-        /// If |force_close| is true the prompt will not be displayed and the close
-        /// will proceed. Results in a call to CefLifeSpanHandler::DoClose() if the
-        /// event handler allows the close or if |force_close| is true. See
-        /// CefLifeSpanHandler::DoClose() documentation for additional usage
-        /// information.
-        /// </summary>
+        /// Request that the browser close. The JavaScript 'onbeforeunload' event will be fired.
+        /// </summary>
+        /// <param name="forceClose">
+        /// If forceClose is false the event handler, if any, will be allowed to prompt the user and the
+        /// user can optionally cancel the close. If forceClose is true the prompt will not be displayed
+        /// and the close will proceed. Results in a call to <see cref="ILifeSpanHandler.DoClose"/> if
+        /// the event handler allows the close or if forceClose is true
+        /// See <see cref="ILifeSpanHandler.DoClose"/> documentation for additional usage information.
+        /// </param>
         void CloseBrowser(bool forceClose);
 
         /// <summary>

CefSharp/IBrowserHost.cs

@@ -21,7 +21,7 @@ public interface IBrowserHost : IDisposable
         /// <summary>
         /// Add the specified word to the spelling dictionary.
         /// </summary>
-        /// <param name="word"></param>
+        /// <param name="word">custom word to be added to dictionary</param>
         void AddWordToDictionary(string word);
 
         /// <summary>
@@ -66,7 +66,7 @@ public interface IBrowserHost : IDisposable
         void DragTargetDragDrop(MouseEvent mouseEvent);
 
         /// <summary>
-        /// Call this method when the drag operation started by a <see cref="CefSharp.Internals.IRenderWebBrowser.StartDragging"/> call has ended either in a drop or by being cancelled.
+        /// Call this method when the drag operation started by a <see cref="CefSharp.Internals.IRenderWebBrowser.StartDragging(IDragData, DragOperationsMask, int, int)"/> call has ended either in a drop or by being cancelled.
         /// If the web view is both the drag source and the drag target then all DragTarget* methods should be called before DragSource* methods.
         /// This method is only used when window rendering is disabled. 
         /// </summary>
@@ -82,7 +82,7 @@ public interface IBrowserHost : IDisposable
         void DragTargetDragLeave();
 
         /// <summary>
-        /// Call this method when the drag operation started by a <see cref="CefSharp.Internals.IRenderWebBrowser.StartDragging"/> call has completed.
+        /// Call this method when the drag operation started by a <see cref="CefSharp.Internals.IRenderWebBrowser.StartDragging(IDragData, DragOperationsMask, int, int)"/> call has completed.
         /// This method may be called immediately without first calling DragSourceEndedAt to cancel a drag operation.
         /// If the web view is both the drag source and the drag target then all DragTarget* methods should be called before DragSource* mthods.
         /// This method is only used when window rendering is disabled. 

CefSharp/IDragData.cs

@@ -17,7 +17,7 @@ public interface IDragData : IDisposable
         /// <summary>
         /// Gets a copy of the current drag data
         /// </summary>
-        /// <returns></returns>
+        /// <returns>a clone of the current object</returns>
         IDragData Clone();
 
         /// <summary>
@@ -124,4 +124,4 @@ public interface IDragData : IDisposable
         /// </summary>
         bool IsDisposed { get; }
     }
-}
+}

CefSharp/IFrame.cs

@@ -195,6 +195,8 @@ public interface IFrame : IDisposable
         ///
         /// The request object will be marked as read-only after calling this method. 
         /// </summary>
+        /// <param name="request">the web request</param>
+        /// <param name="client">the client</param>
         IUrlRequest CreateUrlRequest(IRequest request, IUrlRequestClient client);
     }
 }