[pclasses-cvs] pclasses2/include/pclasses Factory.h,1.8,1.9

[stephan b. <sg...@us...>]

Update of /cvsroot/pclasses/pclasses2/include/pclasses
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv13361/include/pclasses

Modified Files:
	Factory.h 
Log Message:
Doc additions and naming convention corrections.

Index: Factory.h
===================================================================
RCS file: /cvsroot/pclasses/pclasses2/include/pclasses/Factory.h,v
retrieving revision 1.8
retrieving revision 1.9
diff -u -d -r1.8 -r1.9
--- Factory.h	25 Dec 2004 01:45:14 -0000	1.8
+++ Factory.h	25 Dec 2004 02:45:48 -0000	1.9
@@ -170,15 +170,17 @@
 foo = fac.create( "my_key" ); // == a new MyClass object
 	   </pre>
 
-	   Note that all instantiators of the same type use the same
-	   object factories. The ContextType template parameter can be
-	   used to limit the scope of the object factory registrations
-	   to a specific context: Factories with different Contexts
-	   use different maps. ContextType is only used as a marker type,
-	   and is never instantiated by this class.
+	   Note that all instantiations of the same Factory type use
+	   the same object factories map. The ContextType template
+	   parameter can be used to limit the scope of a
+	   Factory<InterfaceT>, such that it it does not collide with
+	   other Factory<InterfaceT> instantiations. ContextType is
+	   only used as a marker type, and is never instantiated by
+	   this class. Used cleverly, it can allow you quite a bit
+	   of freedome in what code has access to which factories.
 	*/
 	template < class InterfaceT,
-		   class ContextType = Sharing::FactoryContext,
+		   class ContextT = Sharing::FactoryContext,
 		   class KeyType = std::string
 		   >
 	class Factory
@@ -202,7 +204,7 @@
 		typedef KeyType key_type;
 
 		/** Same as ContextType */
-		typedef ContextType context_type;
+		typedef ContextT ContextType;
 
 		/**
 		   Convenience typedef.
@@ -297,10 +299,14 @@
 
 		   It is safe to call this post-main(), but such calls
 		   may return an empty map!
+
+		   TODO: use a Hook or Traits type to allow the user
+		   to replace this object with his own, so that he can
+		   control the scope of the map more fully.
 		*/
 		static FactoryMap & factoryMap()
 		{
-			return Phoenix<FactoryMap,context_type>::instance();
+			return Phoenix<FactoryMap,ContextType>::instance();
 		}
 
 		/**