diff --git a/Source/GLControl/GLControl.cs b/Source/GLControl/GLControl.cs
index bafed945..a4efd029 100644
--- a/Source/GLControl/GLControl.cs
+++ b/Source/GLControl/GLControl.cs
@@ -287,6 +287,7 @@ namespace OpenTK
///
/// Swaps the front and back buffers, presenting the rendered scene to the screen.
+ /// This method will have no effect on a single-buffered GraphicsMode.
///
public void SwapBuffers()
{
@@ -299,8 +300,19 @@ namespace OpenTK
#region public void MakeCurrent()
///
- /// Makes the underlying this GLControl current in the calling thread.
- /// All OpenGL commands issued are hereafter interpreted by this GLControl.
+ ///
+ /// Makes current in the calling thread.
+ /// All OpenGL commands issued are hereafter interpreted by this context.
+ ///
+ ///
+ /// When using multiple GLControls, calling MakeCurrent on
+ /// one control will make all other controls non-current in the calling thread.
+ ///
+ ///
+ ///
+ /// A GLControl can only be current in one thread at a time.
+ /// To make a control non-current, call GLControl.Context.MakeCurrent(null).
+ ///
///
public void MakeCurrent()
{
@@ -330,7 +342,12 @@ namespace OpenTK
#region public IGraphicsContext Context
///
- /// Gets an interface to the underlying GraphicsContext used by this GLControl.
+ /// Gets the IGraphicsContext instance that is associated with the GLControl.
+ /// The associated IGraphicsContext is updated whenever the GLControl
+ /// handle is created or recreated.
+ /// When using multiple GLControls, ensure that Context
+ /// is current before performing any OpenGL operations.
+ ///
///
[Browsable(false)]
public IGraphicsContext Context
@@ -365,7 +382,11 @@ namespace OpenTK
#region public bool VSync
///
- /// Gets or sets a value indicating whether vsync is active for this GLControl.
+ /// Gets or sets a value indicating whether vsync is active for this GLControl.
+ /// When using multiple GLControls, ensure that
+ /// is current before accessing this property.
+ ///
+ ///
///
[Description("Indicates whether GLControl updates are synced to the monitor's refresh rate.")]
public bool VSync
@@ -400,11 +421,10 @@ namespace OpenTK
#region public GraphicsMode GraphicsMode
///
- /// Gets the GraphicsMode of the GraphicsContext attached to this GLControl.
+ /// Gets the GraphicsMode of the IGraphicsContext associated with
+ /// this GLControl. If you wish to change GraphicsMode, you must
+ /// destroy and recreate the GLControl.
///
- ///
- /// To change the GraphicsMode, you must destroy and recreate the GLControl.
- ///
public GraphicsMode GraphicsMode
{
get
@@ -430,7 +450,13 @@ namespace OpenTK
#region public Bitmap GrabScreenshot()
- /// Grabs a screenshot of the frontbuffer contents.
+ ///
+ /// Grabs a screenshot of the frontbuffer contents.
+ /// When using multiple GLControls, ensure that
+ /// is current before accessing this property.
+ ///
+ ///
+ ///
/// A System.Drawing.Bitmap, containing the contents of the frontbuffer.
///
/// Occurs when no OpenTK.Graphics.GraphicsContext is current in the calling thread.