From 61f17b5e7cef7d0e130d063a2beb7f5ac8fa1cc2 Mon Sep 17 00:00:00 2001
From: the_fiddler <the_fiddler@ebc5dd9b-fb1d-0410-b6f8-d24c324e9604>
Date: Sat, 10 Nov 2007 10:27:19 +0000
Subject: [PATCH] Added a new Settings.Legacy option: do not turn bools into
 ints. Changed the default Tao options to not turn bools into ints and use
 nested enums. Added documentation to these options.

---
 Source/Bind/Settings.cs | 48 ++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 47 insertions(+), 1 deletion(-)

diff --git a/Source/Bind/Settings.cs b/Source/Bind/Settings.cs
index a39c836c..2e3eb5cd 100644
--- a/Source/Bind/Settings.cs
+++ b/Source/Bind/Settings.cs
@@ -83,17 +83,63 @@ namespace Bind
         [Flags]
         public enum Legacy
         {
+            /// <summary>
+            /// Default value.
+            /// </summary>
             None = 0x00,
+            /// <summary>
+            /// Leave enums as plain const ints.
+            /// </summary>
             ConstIntEnums = 0x01,
+            /// <summary>
+            /// Leave enums in the default STRANGE_capitalization.ALL_CAPS form.
+            /// </summary>
             NoAdvancedEnumProcessing = 0x02,
+            /// <summary>
+            /// Don't allow unsafe wrappers in the interface.
+            /// </summary>
             NoPublicUnsafeFunctions = 0x04,
+            /// <summary>
+            /// Don't trim the [fdisub]v? endings from functions.
+            /// </summary>
             NoTrimFunctionEnding = NoPublicUnsafeFunctions,
+            /// <summary>
+            /// Don't trim the [gl|wgl|glx|glu] prefixes from functions.
+            /// </summary>
             NoTrimFunctionPrefix = 0x08,
+            /// <summary>
+            /// Don't spearate functions in different namespaces, according to their extension category
+            /// (e.g. GL.Arb, GL.Ext etc).
+            /// </summary>
             NoSeparateFunctionNamespaces = 0x10,
+            /// <summary>
+            /// No public void* parameters (should always be enabled. Disable at your own risk. Disabling
+            /// means that BitmapData.Scan0 and other .Net properties/functions must be cast to (void*)
+            /// explicitly, to avoid the 'object' overload from being called.)
+            /// </summary>
             TurnVoidPointersToIntPtr = 0x20,
+            /// <summary>
+            /// Generate all possible permutations for ref/array/pointer parameters.
+            /// </summary>
             GenerateAllPermutations = 0x40,
+            /// <summary>
+            /// Nest enums inside the GL class.
+            /// </summary>
             NestedEnums = 0x80,
-            Tao = ConstIntEnums | NoAdvancedEnumProcessing | NoPublicUnsafeFunctions | NoTrimFunctionEnding | NoTrimFunctionPrefix | NoSeparateFunctionNamespaces | TurnVoidPointersToIntPtr | GenerateAllPermutations,
+            /// <summary>
+            /// Turn GLboolean to int (Boolean enum), not bool.
+            /// </summary>
+            NoBoolParameters = 0100,
+            Tao = ConstIntEnums |
+                  NoAdvancedEnumProcessing |
+                  NoPublicUnsafeFunctions |
+                  NoTrimFunctionEnding |
+                  NoTrimFunctionPrefix |
+                  NoSeparateFunctionNamespaces |
+                  TurnVoidPointersToIntPtr |
+                  NestedEnums |
+                  NoBoolParameters,
+                  /*GenerateAllPermutations,*/
         }
         
         public static string WindowsGDI = "OpenTK.Platform.Windows.API";