added some comments, subminor tweaks

git-svn-id: http://svn.opengroupware.org/SOPE/trunk@817 e4a50df8-12e2-0310-a44c-efbce7f8a7e3

diff --git a/sope-gdl1/GDLAccess/EOExpressionArray.h b/sope-gdl1/GDLAccess/EOExpressionArray.h
index 4452d8663ba57657ba8bf1b9f9340da05610b9f9..24d586f8b3cf905ad882c9d3803fed656c42f814 100644 (file)
--- a/sope-gdl1/GDLAccess/EOExpressionArray.h
+++ b/sope-gdl1/GDLAccess/EOExpressionArray.h
@@ -38,6 +38,21 @@
 
 @end
 
+/*
+  Notes
+  
+  In LSExtendedSearchCommand this is bound to the 'content' of EOSQLQualifier
+  and contains an array like:
+
+    "(", "(", "(", LOWER, "(", { allowsNull=Y; columnName=name; width=50;...},
+    ...
+    " = ", 0, ")", ")"
+
+  so it seems to be a stream of tokens and an EOAttribute mixed in for column
+  keys.
+  
+  Apparently only EOSQLExpression supports the 'EOExpressionContext'?
+*/
 
 @interface EOExpressionArray : NSObject < NSMutableCopying >
 {
@@ -93,7 +108,7 @@
 
 
 @interface NSObject (EOExpression)
-- (NSString*)expressionValueForContext:(id<EOExpressionContext>)context;
+- (NSString *)expressionValueForContext:(id<EOExpressionContext>)context;
 @end
 
 #endif /* __EOExpressionArray_h__ */

diff --git a/sope-gdl1/GDLAccess/EOSQLExpression.h b/sope-gdl1/GDLAccess/EOSQLExpression.h
index 5c91e2de9e7e16c8b67d46dee8889ef6da3ca878..d4b51576211fcbc1861bb6534625d9ec2f4729b3 100644 (file)
--- a/sope-gdl1/GDLAccess/EOSQLExpression.h
+++ b/sope-gdl1/GDLAccess/EOSQLExpression.h
@@ -30,13 +30,18 @@
 #import <Foundation/NSDictionary.h>
 #import <Foundation/NSArray.h>
 
-#import <GDLAccess/EOExpressionArray.h>
-#import <GDLAccess/EOJoinTypes.h>
+#include <GDLAccess/EOExpressionArray.h>
+#include <GDLAccess/EOJoinTypes.h>
 
-@class EOAdaptor;
-@class EOAdaptorChannel;
-@class EOEntity;
-@class EOSQLQualifier;
+/*
+  EOSQLExpression
+
+  TODO: document
+  
+  Apparently the only object which implements EOExpressionContext?
+*/
+
+@class EOAdaptor, EOAdaptorChannel, EOEntity, EOSQLQualifier;
 
 extern NSString *EOBindVariableNameKey;
 extern NSString *EOBindVariablePlaceHolderKey;

diff --git a/sope-gdl1/GDLAccess/EOSQLQualifier.h b/sope-gdl1/GDLAccess/EOSQLQualifier.h
index 8528f650f8f20f96253e4de099866bf0aec05ff0..7a546df006fba7283d2e7de73ff2f32f89ae077f 100644 (file)
--- a/sope-gdl1/GDLAccess/EOSQLQualifier.h
+++ b/sope-gdl1/GDLAccess/EOSQLQualifier.h
@@ -33,6 +33,14 @@
 
 #import <GDLAccess/EOExpressionArray.h>
 
+/*
+  EOSQLQualifier
+  
+  TODO: document
+
+  Note: the expression context is the EOSQLExpression.
+*/
+
 @class NSDictionary, NSString, NSMutableSet;
 @class EOEntity, EORelationship, EOExpressionArray, EOSQLQualifier;
 @class EOSQLExpression;