X-Git-Url: https://git.creatis.insa-lyon.fr/pubgit/?a=blobdiff_plain;f=kernel%2Fsrc%2FbbtkFactory.cxx;h=d541db35b9203e89b984a63daa7c2dd1a7760eb5;hb=72e1281cc66954975acc2414264239dcf055c15f;hp=22c6ad362cf4556c3b0715a2c68041800d40dadc;hpb=5f49dad37400bf38b313463dd56455ea91086f5f;p=bbtk.git

diff --git a/kernel/src/bbtkFactory.cxx b/kernel/src/bbtkFactory.cxx
index 22c6ad3..d541db3 100644
--- a/kernel/src/bbtkFactory.cxx
+++ b/kernel/src/bbtkFactory.cxx
@@ -1,22 +1,40 @@
-/*=========================================================================
-                                                                                
-Program:   bbtk
-Module:    $RCSfile: bbtkFactory.cxx,v $
-Language:  C++
+/*
+ # ---------------------------------------------------------------------
+ #
+ # Copyright (c) CREATIS (Centre de Recherche en Acquisition et Traitement de l'Image
+ #                        pour la SantÈ)
+ # Authors : Eduardo Davila, Frederic Cervenansky, Claire Mouton
+ # Previous Authors : Laurent Guigues, Jean-Pierre Roux
+ # CreaTools website : www.creatis.insa-lyon.fr/site/fr/creatools_accueil
+ #
+ #  This software is governed by the CeCILL-B license under French law and
+ #  abiding by the rules of distribution of free software. You can  use,
+ #  modify and/ or redistribute the software under the terms of the CeCILL-B
+ #  license as circulated by CEA, CNRS and INRIA at the following URL
+ #  http://www.cecill.info/licences/Licence_CeCILL-B_V1-en.html
+ #  or in the file LICENSE.txt.
+ #
+ #  As a counterpart to the access to the source code and  rights to copy,
+ #  modify and redistribute granted by the license, users are provided only
+ #  with a limited warranty  and the software's author,  the holder of the
+ #  economic rights,  and the successive licensors  have only  limited
+ #  liability.
+ #
+ #  The fact that you are presently reading this means that you have had
+ #  knowledge of the CeCILL-B license and that you accept its terms.
+ # ------------------------------------------------------------------------ */
 
-Date:      $Date: 2008/04/21 11:38:19 $
-Version:   $Revision: 1.34 $
-                                                                                
 
-Copyright (c) CREATIS (Centre de Recherche et d'Applications en Traitement de
-l'Image). All rights reserved. See doc/license.txt or
-http://www.creatis.insa-lyon.fr/Public/bbtk/License.html for details.
+/*=========================================================================
+  Program:   bbtk
+  Module:    $RCSfile: bbtkFactory.cxx,v $
+  Language:  C++
+  Date:      $Date: 2012/11/16 08:49:01 $
+  Version:   $Revision: 1.55 $
+=========================================================================*/
 
-This software is distributed WITHOUT ANY WARRANTY; without even
-the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
-PURPOSE.  See the above copyright notices for more information.
+                                                                       
 
-=========================================================================*/
 /**
  *\file
  *\brief  Class bbtk::Factory : can load and unload dynamic libraries containing 
@@ -28,6 +46,7 @@ PURPOSE.  See the above copyright notices for more information.
 #include "bbtkConnection.h"
 #include "bbtkConfigurationFile.h"
 #include "bbtkUtilities.h"
+#include "bbtkConfigurationFile.h"
 
 #include <sys/stat.h> // for struct stat stFileInfo
 
@@ -37,6 +56,7 @@ PURPOSE.  See the above copyright notices for more information.
 
 #include <cctype>    // std::toupper
 
+#include <time.h>
 
 namespace bbtk
 {
@@ -45,7 +65,7 @@ namespace bbtk
   /// Default ctor
   Factory::Pointer Factory::New()
   {
-    bbtkDebugMessage("Kernel",9,"Factory::New()"<<std::endl);
+    bbtkDebugMessage("kernel",9,"Factory::New()"<<std::endl);
     return MakePointer(new Factory());
   }
   //===================================================================
@@ -55,7 +75,7 @@ namespace bbtk
   Factory::Factory()
     : mExecuter()
   {
-    bbtkDebugMessage("Kernel",7,"Factory::Factory()"<<std::endl);
+    bbtkDebugMessage("kernel",7,"Factory()"<<std::endl);
   }
   //===================================================================
 
@@ -63,9 +83,9 @@ namespace bbtk
   /// Dtor
   Factory::~Factory()
   {
-    bbtkDebugMessageInc("Kernel",7,"Factory::~Factory()"<<std::endl);
+    bbtkDebugMessage("kernel",7,"==> ~Factory()"<<std::endl);
     CloseAllPackages();
-    bbtkDebugDecTab("Kernel",7);
+    bbtkDebugMessage("kernel",7,"<== ~Factory()"<<std::endl);
   }
   //===================================================================
 
@@ -74,9 +94,9 @@ namespace bbtk
   //===================================================================
   void Factory::Reset()
   {
-    bbtkDebugMessageInc("Kernel",7,"Factory::Reset()"<<std::endl);
+    bbtkDebugMessage("kernel",7,"==> Factory::Reset()"<<std::endl);
     CloseAllPackages();
-    bbtkDebugDecTab("Kernel",7);
+    bbtkDebugMessage("kernel",7,"<== Factory::Reset()"<<std::endl);
   }
   //===================================================================
 
@@ -93,13 +113,13 @@ namespace bbtk
     if (p!=0)
       {
 	//===================================================================
-	bbtkMessage("Output",2,p->GetName()<<" "
+	bbtkMessage("output",2,p->GetName()<<" "
 		    <<p->GetVersion()
 		    <<" "
 		    <<p->GetAuthor() << " Category(s) :"
 		    <<p->GetCategory()
 		    <<std::endl);
-	bbtkMessage("Output",2,p->GetDescription()<<std::endl);
+	bbtkMessage("output",2,p->GetDescription()<<std::endl);
 	//===================================================================
 	p->AddFactory(GetThisPointer<Factory>());
 	mPackageMap[pkgname] = p;
@@ -127,6 +147,8 @@ namespace bbtk
   
   void Factory::LoadPackage( const std::string& name )
   {
+	  
+	  
   // Note : in the following :
   // name : the user supplied name
   //      - abreviated name    e.g.       pkg   pkg.so   libbpkg   libbbpkg.so
@@ -135,151 +157,168 @@ namespace bbtk
   //          same for Windows, with      c:, d: ...
   //
   // lastname : string before the last / (if any), or user supplied name
+	  
+	 
+	  
+	if(name != ""){
+		bbtkDebugMessageInc("kernel",7,"Factory::LoadPackage(\""<<name<<"\")"<<std::endl);
+		bbtkMessage("debug",1,"Factory::LoadPackage(\""<<name<<"\")"<<std::endl);
+
+		std::vector<std::string> package_paths;
+		std::string libname;  // full path library name
+		std::string pkgname;  // e.g. libbb<pkgname>.so
+
+		std::string upath;
+
+		pkgname = Utilities::ExtractPackageName(name,upath);
+				
+		bbtkMessage("debug",1,"Package name ["<<pkgname<<"]"<<std::endl);
+		bbtkMessage("debug",1,"Package path ["<<upath<<"]"<<std::endl);
+
+		// no loading package if already loaded
+		PackageMapType::iterator iUnload;
+		iUnload = mPackageMap.find(pkgname);
+
+//EED Debuging message
+//     std::cout << "EED Factory::LoadPackage " <<  std::endl;
+//		PackageMapType::iterator it;
+//		for ( it=mPackageMap.begin() ; it != mPackageMap.end(); it++ )
+//			std::cout << (*it).first << " ";
+//		std::cout << std::endl;
+
+		
+		if (iUnload != mPackageMap.end())
+		{
+		  bbtkMessage("output",2,"["<< pkgname <<"] already loaded" << std::endl);
+		  return;
+		}
+
+	// =================================================
+	// The following structure was checked to work
+	// with any type of relative/absolute path.
+	// Please don't modify it without checking
+	// *all* the cases. JP
+	//==================================================
+
+		bool ok = false;
+		bool foundFile = false;
+
+		// If path provided by user will be the first scanned :
+		// push it into vector of paths
+		if (upath.length()>0)   // ------------------------------------- check user supplied location
+		{
+		   if (name[0] != '.' && name[0] != '/' && name[1]!= ':')
+		   {
+			  bbtkError("Use absolute or relative path name! ["<<name<<"] is an illegal name");
+			  return;
+		   }
+
+		  // std::string path = Utilities::ExpandLibName(upath, false);
+
+		   std::string path = Utilities::ExpandLibName(name,false); // keep last item, here.
+		   if (path != "")
+		   {
+			  std::string p2;
+			  Utilities::ExtractPackageName(path,p2);
+			  //libname = Utilities::MakeLibnameFromPath(path, pkgname);
+			  libname = Utilities::MakeLibnameFromPath(p2, pkgname); // remove last item
+			  // Check if library exists
+			  if ( !Utilities::FileExists(libname) )
+			  {
+			  // The following is *NOT* a debug time message :
+			  // It's a user intended message.
+			  // Please don't remove it.
+			bbtkMessage("output",3,"   [" <<libname 
+				<<"] : doesn't exist" <<std::endl);
+			  }
+			  else
+			  {
+				 ok = DoLoadPackage( libname, pkgname, path);         
+			  }
+		   }
+		   else
+		   {
+			  bbtkError("Path ["<<upath<<"] doesn't exist");
+			  return;
+		   }
+		}
+		else     // ----------------------------------------------------- iterate on the paths  
+		{
+
+		std::string path = ".";
+		package_paths = ConfigurationFile::GetInstance().Get_package_paths();
+		std::vector<std::string>::iterator i;
+		for (i=package_paths.begin();i!=package_paths.end();++i)
+		{
+			foundFile = false;
+			path = *i;
+//std::cout<<"JCP bbtkFactory.cxx void Factory::LoadPackage = path "<<path<<std::endl;
+			// we *really* want '.' to be the current working directory
+			if (path == ".")
+			{
+			  char buf[2048]; // for getcwd
+			  char * currentDir = getcwd(buf, 2048);
+			  std::string cwd(currentDir);
+//std::cout<<"JCP  bbtkFactory.cxx void Factory::LoadPackage = currentDir "<<currentDir<<std::endl;
+			  path = currentDir;
+			}
+//std::cout<<"JCP bbtkFactory.cxx void Factory::LoadPackage = path "<<path<<" pkgnam="<<pkgname<<std::endl;	         
+			libname = Utilities::MakeLibnameFromPath(path, pkgname);
+
+			bbtkMessage("debug",2,"-> Trying to load [" << libname << "]" <<std::endl);
+
+		  // Check if library exists           
+			if ( !Utilities::FileExists(libname) )
+			{
+			// The following is *NOT* a debug time message :
+			// It's a user intended message.
+			// Please don't remove it.
+			  bbtkMessage("output",3,
+				  "   [" <<libname <<"] : doesn't exist" <<std::endl);
+			   continue;  // try next path
+			}
+			foundFile = true; 
+
+		  // Try to Load the library
+
+			ok = DoLoadPackage( libname, pkgname, path);
+			if (ok)
+			{
+			   bbtkMessage("debug",2,"   OK"<<std::endl);
+			}
+		break; // we stop iterating even if error : have to signal it to user
+		} //------------------ // end for ( package_paths.begin();i!=package_paths.end() )
+
+	}
+
+		if( !ok )  // nothing was loaded
+		{
+		  if (!foundFile)
+		  {
+			bbtkError("Could not find package ["<<pkgname<< "]");
+		  }
+		  else
+		  {
+	#if defined(__GNUC__)
+			bbtkError("Could not load package ["<< pkgname
+					  <<"] :" << std::endl 
+			  << "  Opening "<<libname<<" failed"
+			  << "  Reason: "<< dlerror());
+	#elif defined(_WIN32)
+			bbtkError("Could not load package ["<<pkgname
+			  <<"] :"<< std::endl << "   Error loading " <<libname);
+
+		// look how to get the error message on win
+		//<<dlerror());
+		// it is the bordel !! (the bloody fucking bordel, you mean?)
+		// look : http://msdn2.microsoft.com/en-us/library/ms680582.aspx
+	#endif
+		  }
+		}	
+		bbtkMessage("output",2,"[" << libname << "] loaded" << std::endl);
+	}
 
-    bbtkDebugMessageInc("Kernel",7,"Factory::LoadPackage(\""<<name<<"\")"<<std::endl);
-    bbtkMessage("Debug",1,"Factory::LoadPackage(\""<<name<<"\")"<<std::endl);
-
-    std::vector<std::string> package_paths;
-    std::string libname;  // full path library name
-    std::string pkgname;  // e.g. libbb<pkgname>.so
-
-    std::string upath;
-    pkgname = Utilities::ExtractPackageName(name,upath);
-
-    bbtkMessage("Debug",1,"Package name ["<<pkgname<<"]"<<std::endl);
-    bbtkMessage("Debug",1,"Package path ["<<upath<<"]"<<std::endl);
-
-    // no loading package if already loaded
-    PackageMapType::iterator iUnload;
-    iUnload = mPackageMap.find(pkgname);
-    if (iUnload != mPackageMap.end())
-    {
-      bbtkMessage("Output",2,"["<< pkgname <<"] already loaded" << std::endl);
-      return;
-    }
-
-// =================================================
-// The following structure was checked to work
-// with any type of relative/absolute path.
-// Please don't modify it without checking
-// *all* the cases. JP
-//==================================================
-
-//std::cout << "upath [" << upath << "]" << std::endl;
-
-    bool ok = false;
-    bool foundFile = false;
-
-    // If path provided by user will be the first scanned :
-    // push it into vector of paths
-    if (upath.length()>0)   // ------------------------------------- check user supplied location
-    {
-       if (name[0] != '.' && name[0] != '/' && name[1]!= ':')
-       {
-          bbtkError("Use absolute or relative path name! ["<<name<<"] is an illegal name");
-          return;
-       }
-
-      // std::string path = Utilities::ExpandLibName(upath, false);
-       std::string path = Utilities::ExpandLibName(name,false); // keep last item, here.
-         
-       if (path != "")
-       {
-          std::string p2;
-          Utilities::ExtractPackageName(path,p2);
-          //libname = Utilities::MakeLibnameFromPath(path, pkgname);
-          libname = Utilities::MakeLibnameFromPath(p2, pkgname); // remove last item
-          // Check if library exists
-          if ( !Utilities::FileExists(libname) )
-          {
-          // The following is *NOT* a debug time message :
-          // It's a user intended message.
-          // Please don't remove it.
-	    bbtkMessage("Output",3,"   [" <<libname 
-			<<"] : doesn't exist" <<std::endl);
-          }
-          else
-          {
-             ok = DoLoadPackage( libname, pkgname, path);         
-          }
-       }
-       else
-       {
-          bbtkError("Path ["<<upath<<"] doesn't exist");
-          return;
-       }
-    }
-    else     // ----------------------------------------------------- iterate on the paths  
-    {
-
-    std::string path;
-    package_paths = ConfigurationFile::GetInstance().Get_package_paths();
-    std::vector<std::string>::iterator i;
-    for (i=package_paths.begin();i!=package_paths.end();++i)
-    {
-        foundFile = false;
-        path = *i;
-
-        // we *really* want '.' to be the current working directory
-        if (path == ".")
-        {
-          char buf[2048]; // for getcwd
-          char * currentDir = getcwd(buf, 2048);
-          std::string cwd(currentDir);
-          path = currentDir;
-        }
-
-        libname = Utilities::MakeLibnameFromPath(path, pkgname);
-
-        bbtkMessage("Debug",2,"-> Trying to load [" << libname << "]" <<std::endl);
-
-      // Check if library exists           
-        if ( !Utilities::FileExists(libname) )
-        {
-        // The following is *NOT* a debug time message :
-        // It's a user intended message.
-        // Please don't remove it.
-          bbtkMessage("Output",3,
-		      "   [" <<libname <<"] : doesn't exist" <<std::endl);
-           continue;  // try next path
-        }
-        foundFile = true; 
-
-      // Try to Load the library
-
-        ok = DoLoadPackage( libname, pkgname, path);
-        if (ok)
-        {
-           bbtkMessage("Debug",2,"   OK"<<std::endl);
-           break; // a package was found; we stop iterating
-        }
-    } //------------------ // end for ( package_paths.begin();i!=package_paths.end() )
-
-}
-
-    if( !ok )  // nothing was loaded
-    {
-      if (!foundFile)
-      {
-        bbtkError("Could not find package ["<<pkgname<< "]");
-      }
-      else
-      {
-#if defined(__GNUC__)
-        bbtkError("Could not load package ["<< pkgname
-                  <<"] :" << std::endl << "   " << dlerror());
-#elif defined(_WIN32)
-        bbtkError("Could not load package ["<<pkgname
-                 <<"] : " << std::endl << "   " <<libname<<" not found");
-
-    // look how to get the error message on win
-    //<<dlerror());
-    // it is the bordel !! (the bloody fucking bordel, you mean?)
-    // look : http://msdn2.microsoft.com/en-us/library/ms680582.aspx
-#endif
-      }
-    }
-    bbtkMessage("Output",2,"[" << libname << "] loaded" << std::endl);
+    
 
   }
 
@@ -290,7 +329,7 @@ namespace bbtk
   /// If the entry is found in the map, calls ClosePackage
  void Factory::UnLoadPackage( const std::string& name )
  {
-    bbtkDebugMessageInc("Kernel",7,"Factory::UnLoadPackage(\""
+    bbtkDebugMessageInc("kernel",7,"Factory::UnLoadPackage(\""
                        <<name<<"\")"<<std::endl);
   
     PackageMapType::iterator i;
@@ -301,7 +340,7 @@ namespace bbtk
                 <<"\" : package not loaded !");
     }
     ClosePackage(i);
-    bbtkDebugDecTab("Kernel",7);
+    bbtkDebugDecTab("kernel",7);
   }
   //===================================================================
 
@@ -309,13 +348,33 @@ namespace bbtk
   //===================================================================
   void Factory::CloseAllPackages()
   {
-    bbtkDebugMessageInc("Kernel",7,"Factory::CloseAllPackages()"<<std::endl);
-    while (mPackageMap.begin() != mPackageMap.end())
-      {
-        PackageMapType::iterator i = mPackageMap.begin();
-        ClosePackage(i);
-      }
-    bbtkDebugDecTab("Kernel",7);
+    bbtkDebugMessageInc("kernel",7,"Factory::CloseAllPackages()"<<std::endl);
+    
+    std::vector< Package::WeakPointer > mAlive;  
+    do {
+      mAlive.clear();  
+      while (mPackageMap.begin() != mPackageMap.end())
+	{
+	  PackageMapType::iterator i = mPackageMap.begin();
+	  Package::WeakPointer p = i->second;
+	  ClosePackage(i);
+	  if (p.lock()) mAlive.push_back(p);
+	}
+      std::vector< Package::WeakPointer >::iterator i;
+      for (i=mAlive.begin();i!=mAlive.end();++i)
+	{
+	  // If not dead : reinsert
+	  if (i->lock())
+	    {
+	      bbtkDebugMessage("kernel",7,"Package "<<i->lock()->GetName()
+			       <<" still alive"<<std::endl);
+	      // InsertPackage(i->lock());
+	    }
+	}      
+    }
+    while (mPackageMap.size()>0);
+
+    bbtkDebugDecTab("kernel",7);
   }
   //===================================================================
 
@@ -333,7 +392,7 @@ namespace bbtk
  /// Finally erases the package entry in the packages map
  void Factory::ClosePackage(PackageMapType::iterator& i) 
   {   
-     bbtkDebugMessageInc("Kernel",7,"Factory::ClosePackage(\""
+     bbtkDebugMessageInc("kernel",7,"Factory::ClosePackage(\""
                          <<i->second->GetName()
                         <<"\")"<<std::endl);
 
@@ -344,102 +403,104 @@ namespace bbtk
      // remove the entry in the map
      mPackageMap.erase(i);
      // Release the package if not already destroyed
-     if (p.lock()) Package::Release(p);
-
-
-     bbtkDebugDecTab("Kernel",7);
+     if (p.lock()) 
+       {
+	 Package::Release(p);
+       }
+     bbtkDebugDecTab("kernel",7);
   }
   //===================================================================
   
 
 
   //===================================================================  
-  /// Displays the list of packages loaded
-  void Factory::PrintPackages(bool details, bool adaptors) const
+  void Factory::PrintHelpListPackages(bool details, bool adaptors) const
   {
-    bbtkDebugMessageInc("Kernel",9,"Factory::PrintPackages"<<std::endl);
+    bbtkDebugMessageInc("kernel",9,"Factory::PrintPackages"<<std::endl);
 
     PackageMapType::const_iterator i;
     for (i = mPackageMap.begin(); i!=mPackageMap.end(); ++i )
     {
-      bbtkMessage("Help",1, i->first << std::endl);
+      bbtkMessage("help",1, i->first << std::endl);
       if (details) {
-         i->second->PrintBlackBoxes(false,adaptors);
+         i->second->PrintHelpListDescriptors(false,adaptors);
       }
     }
 
-    bbtkDebugDecTab("Kernel",9);
+    bbtkDebugDecTab("kernel",9);
   }
   //===================================================================
 
   //===================================================================  
   /// Displays help on a package
-  void Factory::HelpPackage(const std::string& name, bool adaptors) const
+  void Factory::PrintHelpPackage(const std::string& name, bool adaptors) const
   {
-    bbtkDebugMessageInc("Kernel",9,"Factory::HelpPackage(\""<<name<<"\")"
+    bbtkDebugMessageInc("kernel",9,"Factory::PrintHelpPackage(\""
+			<<name<<"\")"
                         <<std::endl);
 
     PackageMapType::const_iterator i = mPackageMap.find(name);
     if ( i != mPackageMap.end() ) 
       {
-      bbtkMessage("Help",1, "Package "<<i->first<<" ");
+      bbtkMessage("help",1, "Package "<<i->first<<" ");
       
       if (i->second->GetVersion().length()>0)
-        bbtkMessageCont("Help",1,"v" <<i->second->GetVersion());
+        bbtkMessageCont("help",1,"v" <<i->second->GetVersion());
         
       if (i->second->GetAuthor().length()>0)
-        bbtkMessageCont("Help",1,"- "<<i->second->GetAuthor());
+        bbtkMessageCont("help",1,"- "<<i->second->GetAuthor());
         
       if (i->second->GetCategory().length()>0)
-        bbtkMessageCont("Help",1,"- "<<i->second->GetCategory());        
+        bbtkMessageCont("help",1,"- "<<i->second->GetCategory());        
         
-      bbtkMessageCont("Help",1,std::endl);
-      bbtkIncTab("Help",1);
-      bbtkMessage("Help",1,i->second->GetDescription()<<std::endl);
-      if (i->second->GetNumberOfBlackBoxes()>0) 
+      bbtkMessageCont("help",1,std::endl);
+      bbtkIncTab("help",1);
+      bbtkMessage("help",1,i->second->GetDescription()<<std::endl);
+      if (i->second->GetNumberOfDescriptors()>0) 
         {
-          bbtkMessage("Help",1, "Black boxes : "<<std::endl);
-          i->second->PrintBlackBoxes(true,adaptors);
+          bbtkMessage("help",1, "Black boxes : "<<std::endl);
+          i->second->PrintHelpListDescriptors(true,adaptors);
         }
       else 
         {
-          bbtkMessage("Help",1, "No black boxes"<<std::endl);
+          bbtkMessage("help",1, "No black boxes"<<std::endl);
         }
-      bbtkDecTab("Help",1);
+      bbtkDecTab("help",1);
       }
     else 
       {
-      bbtkDebugDecTab("Kernel",9);
+      bbtkDebugDecTab("kernel",9);
       bbtkError("package \""<<name<<"\" unknown");
       }
     
-    bbtkDebugDecTab("Kernel",9);
+    bbtkDebugDecTab("kernel",9);
   }
   //===================================================================
 
   //===================================================================
   /// Prints help on the black box of type <name>
   /// Returns the package to which it belongs
-  void Factory::HelpBlackBox(const std::string& name, 
+  void Factory::PrintHelpDescriptor(const std::string& name, 
 			     std::string& package,
 			     bool full) const
   {
-    bbtkDebugMessageInc("Kernel",9,"Factory::HelpBlackBox(\""<<name<<"\")"
+    bbtkDebugMessageInc("kernel",9,"Factory::PrintHelpDescriptor(\""
+			<<name<<"\")"
                         <<std::endl);
 
     bool found = false;
     PackageMapType::const_iterator i;
     for (i = mPackageMap.begin(); i!=mPackageMap.end(); ++i )
       {
-      if (i->second->ContainsBlackBox(name)) 
+      if (i->second->ContainsDescriptor(name)) 
         {
-          i->second->HelpBlackBox(name,full);
+          i->second->PrintHelpDescriptor(name,full);
 	      package = i->second->GetName();
           found = true;
         }
       }
     
-    bbtkDebugDecTab("Kernel",9);
+    bbtkDebugDecTab("kernel",9);
     if (!found) 
       {
       bbtkError("No package of the factory contains any black box <"
@@ -453,13 +514,12 @@ namespace bbtk
   /// Inserts a package in the factory
   void Factory::InsertPackage( Package::Pointer p )
   {
-    bbtkDebugMessageInc("Kernel",9,"Factory::InsertPackage(\""<<
+    bbtkDebugMessageInc("kernel",9,"Factory::InsertPackage(\""<<
                         p->GetName()<<"\")"<<std::endl);
 
-    p->AddFactory(GetThisPointer<Factory>());
+    p->AddFactory(GetThisPointer<Factory>());	  
     mPackageMap[p->GetName()] = p;
-
-    bbtkDebugDecTab("Kernel",9);
+    bbtkDebugDecTab("kernel",9);
   }
   //===================================================================
   
@@ -467,7 +527,7 @@ namespace bbtk
   /// Removes a package from the factory (and deletes it)
   void Factory::RemovePackage( Package::Pointer p )
   {
-    bbtkDebugMessageInc("Kernel",9,"Factory::RemovePackage(\""<<
+    bbtkDebugMessageInc("kernel",9,"Factory::RemovePackage(\""<<
                         p->GetName()<<"\")"<<std::endl);
 
     PackageMapType::iterator i;
@@ -486,32 +546,104 @@ namespace bbtk
 		  p->GetName()<<"\") : package absent from factory");
       }
 
-    bbtkDebugDecTab("Kernel",9);
+    bbtkDebugDecTab("kernel",9);
   }
-  //===================================================================
   
 
+  //===================================================================
+	std::string Factory::GetPackageNameOfaBlackBox(std::string boxType)
+	{
+		std::string packageName="<void bbtk package name>";
+		PackageMapType::const_iterator i;
+
+ 		std::size_t found = boxType.find(":");
+ 		if (found!=std::string::npos)
+ 		{
+	 		packageName	= boxType.substr(0,found);
+ 		} else {
+			for (i = mPackageMap.begin(); i!=mPackageMap.end(); ++i )
+			{
+				if ( i->second->ifBoxExist( boxType ) == true)
+				{
+					packageName = i->first;
+				} // if ifBoxExist
+			} // for i
+
+		} // if found
+		return packageName;
+	}
+
+  //===================================================================
+	std::string Factory::GetTypeNameOfaBlackBox(std::string boxType)
+	{
+		std::string typeName="<void bbtk type name>";
+
+	 	std::size_t found = boxType.find(":");
+ 		if (found!=std::string::npos)
+ 		{
+	 		typeName		= boxType.substr(found+1);
+ 		} else {
+			typeName=boxType;
+		} // if found
+		return typeName;
+	}
+
+
+	
+	
   //===================================================================
   /// Creates an instance of a black box of type <type> with name <name>
   BlackBox::Pointer Factory::NewBlackBox(const std::string& type, 
                                  const std::string& name) const
   {
-    bbtkDebugMessageInc("Kernel",7,"Factory::NewBlackBox(\""
+	bbtkDebugMessageInc("kernel",7,"Factory::NewBlackBox(\""
                         <<type<<"\",\""<<name<<"\")"<<std::endl);
 
     BlackBox::Pointer b; 
     PackageMapType::const_iterator i;
-    for (i = mPackageMap.begin(); i!=mPackageMap.end(); ++i )
-      {
-      b = i->second->NewBlackBox(type,name);
-      if (b) break; 
-      }
+
+	std::string tmp = type;
+	std::string packageName = ((bbtk::Factory*)this)->GetPackageNameOfaBlackBox(tmp);
+	std::string type2 		= ((bbtk::Factory*)this)->GetTypeNameOfaBlackBox(tmp);
+  	i = mPackageMap.find(packageName);
+	if (i != mPackageMap.end())
+	{
+		b = i->second->NewBlackBox(type2,name);
+	} else {
+		b =BlackBox::Pointer();
+	}
+
+/*
+ 	std::size_t found = type.find(":");
+ 	if (found!=std::string::npos)
+ 	{
+	 	std::string packageName	= type.substr(0,found);
+	 	std::string type2		= type.substr(found+1);
+		i = mPackageMap.find(packageName);
+		if (i != mPackageMap.end())
+		{
+	      	b = i->second->NewBlackBox(type2,name);
+		} else {
+			b =BlackBox::Pointer();
+		}
+ 	} else {
+    	for (i = mPackageMap.begin(); i!=mPackageMap.end(); ++i )
+      	{
+      		b = i->second->NewBlackBox(type,name);
+      		if (b) break; 
+      	} // for i
+
+	} // if found :
+*/
+
+
     if (!b) 
-      {
-       bbtkError("black box type \""<<type<<"\" unknown");
-      } 
+    {
+      	bbtkError("black box type \""<<type<<"\" unknown");
+    }  // if !b
+
 
-    bbtkDebugDecTab("Kernel",7);
+    bbtkDebugDecTab("kernel",7);
     return b;
   }
   //===================================================================
@@ -522,7 +654,7 @@ namespace bbtk
 				const DataInfo& typeout,
 				const std::string& name) const
   {
-    bbtkDebugMessageInc("Kernel",8,"Factory::NewAdaptor("
+    bbtkDebugMessageInc("kernel",8,"Factory::NewAdaptor("
                         <<typein<<","
                         <<typeout<<",\""
                         <<name<<"\")"<<bbtkendl);
@@ -541,7 +673,7 @@ namespace bbtk
 		  <<" adaptor available");
       } 
     
-    bbtkDebugDecTab("Kernel",7);
+    bbtkDebugDecTab("kernel",7);
     return b; 
   }
   //===================================================================
@@ -553,7 +685,7 @@ namespace bbtk
 				      const DataInfo& typeout,
 				      const std::string& name) const
   {
-    bbtkDebugMessageInc("Kernel",8,"Factory::NewWidgetAdaptor(<"
+    bbtkDebugMessageInc("kernel",8,"Factory::NewWidgetAdaptor(<"
                         <<typein<<">,<"
                         <<typeout<<">,\""
                         <<name<<"\")"<<bbtkendl);
@@ -574,7 +706,7 @@ namespace bbtk
 		  <<"> widget adaptor available");
       } 
     
-    bbtkDebugDecTab("Kernel",7);
+    bbtkDebugDecTab("kernel",7);
     return b; 
   }
   //===================================================================
@@ -585,7 +717,7 @@ namespace bbtk
 				  const DataInfo& typeout,
 				  std::string& adaptor) const
   {
-    bbtkDebugMessageInc("Kernel",8,"Factory::FindAdaptor(<"
+    bbtkDebugMessageInc("kernel",8,"Factory::FindAdaptor(<"
                         <<typein<<">,<"
                         <<typeout<<">)"<<bbtkendl);
     
@@ -606,7 +738,7 @@ namespace bbtk
       } 
     */
 
-    bbtkDebugDecTab("Kernel",7);
+    bbtkDebugDecTab("kernel",7);
     return b; 
   }
   //===================================================================
@@ -617,7 +749,7 @@ namespace bbtk
 				  const DataInfo& typeout,
 				  std::string& adaptor) const
   {
-    bbtkDebugMessageInc("Kernel",8,"Factory::FindWidgetAdaptor(<"
+    bbtkDebugMessageInc("kernel",8,"Factory::FindWidgetAdaptor(<"
                         <<typein<<">,<"
                         <<typeout<<">)"<<bbtkendl);
     
@@ -630,7 +762,7 @@ namespace bbtk
 						  adaptor);
 	if (b) break; 
       }
-    bbtkDebugDecTab("Kernel",7);
+    bbtkDebugDecTab("kernel",7);
     return b; 
   }
   //===================================================================
@@ -642,7 +774,7 @@ namespace bbtk
 				  std::string& widget,
 				  std::string& adaptor) const
   {
-    bbtkDebugMessageInc("Kernel",8,"Factory::FindWidgetAdaptor(<"
+    bbtkDebugMessageInc("kernel",8,"Factory::FindWidgetAdaptor(<"
                         <<typein<<">,<"
                         <<typeout<<">)"<<bbtkendl);
     
@@ -659,7 +791,7 @@ namespace bbtk
     if (!b) 
       {
 	// Look for a widget adaptor with good nature out
-	bbtkMessage("Kernel",5,
+	bbtkMessage("kernel",5,
 		    "*** Looking for a two pieces widget adaptor for : "
 		    << typein << "->"<<typeout<<std::endl);
 	for (i = mPackageMap.begin(); i!=mPackageMap.end(); ++i )
@@ -670,13 +802,13 @@ namespace bbtk
 		 ++j)
 	      {
 		if ( ( j->first.mKind ==  
-		       BlackBoxDescriptor::DEFAULT_WIDGET_ADAPTOR) &&
+		       BlackBoxDescriptor::DEFAULT_GUI) &&
 		     //(j->first.mTypeIn == typein) &&
 		     (j->first.mTypeOut.GetNature() == typeout.GetNature() ) 
 		     )
 		  {
 		    widget = j->second.lock()->GetTypeName();
-		    bbtkMessage("Kernel",5,
+		    bbtkMessage("kernel",5,
 				"===> Found first part : "<<widget
 				<< " "<<j->first.mTypeIn<<"->"
 				<<j->first.mTypeOut<<std::endl);
@@ -685,14 +817,14 @@ namespace bbtk
 		    b = FindAdaptor( ti, to, adaptor );
 		    if (b) 
 		      {
-			bbtkMessage("Kernel",5,
+			bbtkMessage("kernel",5,
 				    "===> Found second part : "<<adaptor
 				    <<std::endl);
 			break;
 		      }
 		    else
 		      {
-			bbtkMessage("Kernel",5,
+			bbtkMessage("kernel",5,
 				    "===> No second part found"<<std::endl);
 		      }
 		  }
@@ -700,7 +832,7 @@ namespace bbtk
 	    if (b) break;
 	  }
       }
-    bbtkDebugDecTab("Kernel",7);
+    bbtkDebugDecTab("kernel",7);
     return b; 
   }
   //===================================================================
@@ -712,7 +844,7 @@ namespace bbtk
 					     BlackBox::Pointer to,
 					     const std::string& input) const
   {
-    bbtkDebugMessage("Kernel",7,"Factory::NewConnection(\""
+    bbtkDebugMessage("kernel",7,"Factory::NewConnection(\""
                       <<from->bbGetName()<<"\",\""<<output<<"\",\""
                       <<to->bbGetName()<<"\",\""<<input
                       <<"\")"<<std::endl);
@@ -727,37 +859,37 @@ namespace bbtk
   //===================================================================
   Package::Pointer Factory::GetPackage(const std::string& name) const
   {
-    bbtkDebugMessageInc("Kernel",9,"Factory::GetPackage(\""<<name<<"\")"
+    bbtkDebugMessageInc("kernel",9,"Factory::GetPackage(\""<<name<<"\")"
                          <<std::endl);
 
     PackageMapType::const_iterator i = mPackageMap.find(name);
     if ( i != mPackageMap.end() ) 
     {
-      bbtkDebugDecTab("Kernel",9); 
+      bbtkDebugDecTab("kernel",9); 
       return i->second;
     }
     else 
     {
-       bbtkDebugDecTab("Kernel",9);
+       bbtkDebugDecTab("kernel",9);
        bbtkError("package \""<<name<<"\" unknown");
     }
     
-    bbtkDebugDecTab("Kernel",9);  
+    bbtkDebugDecTab("kernel",9);  
   }
   //===================================================================
   
 
   //===================================================================
-  void Factory::CheckPackages() const
+  void Factory::Check() const
   {
-    bbtkMessage("Debug",1,"****** Checking Factory "<<(void*)this
+    bbtkMessage("debug",1,"****** Checking Factory "<<(void*)this
 		 <<std::endl);
     PackageMapType::const_iterator i;
     for (i = mPackageMap.begin(); i!=mPackageMap.end(); ++i )
       {
-	i->second->CheckBoxes();
+	i->second->Check();
       }
-    bbtkMessage("Debug",1,"****** Checking Factory "<<(void*)this
+    bbtkMessage("debug",1,"****** Checking Factory "<<(void*)this
 		<<" ... OK"<<std::endl);
   }
   //===================================================================
@@ -766,7 +898,7 @@ namespace bbtk
   void Factory::WriteDotFilePackagesList(FILE *ff)
   {
 
-    bbtkDebugMessageInc("Kernel",9,"Factory::WriteDotFilePackagesList()"
+    bbtkDebugMessageInc("kernel",9,"Factory::WriteDotFilePackagesList()"
                          <<std::endl);
 
     fprintf( ff , "\n");
@@ -784,53 +916,52 @@ namespace bbtk
        fprintf(ff,"  %s [shape=ellipse, URL=\"%s\"]%s\n",i->first.c_str(),url.c_str(),";" );
     }
     fprintf( ff , "}\n\n");
-    bbtkDebugDecTab("Kernel",9);
+    bbtkDebugDecTab("kernel",9);
   }
   //===================================================================
 
 
  void Factory::ShowGraphTypes(const std::string& name) const
  {
-
    bool found = false;
    PackageMapType::const_iterator i;
    for (i = mPackageMap.begin(); i!=mPackageMap.end(); ++i )
    {
-      if (i->second->ContainsBlackBox(name)) 
-      {
+     if (i->second->ContainsDescriptor(name)) 
+       {
          std::string separator = ConfigurationFile::GetInstance().Get_file_separator ();
-
-            // Don't pollute the file store with  "temp_dir" directories ...    
+	 
+	 // Don't pollute the file store with  "temp_dir" directories ...    
          std::string default_doc_dir = ConfigurationFile::GetInstance().Get_default_temp_dir();
          std::string directory = "\"" + default_doc_dir + separator + "temp_dir"  +separator + "\"";
          std::string filename2 =  default_doc_dir + separator + "temp_dir" + separator + "tmp.html"; 
-
+	 
 #if defined(_WIN32)  
-        std::string command("start \"Titre\" /D ");
+	 std::string command("start \"Titre\" /D ");
 #else 
-        std::string command("gnome-open ");
+	 std::string command("gnome-open ");
 #endif
-        command=command + directory +" tmp.html";
-        FILE *ff;
-        ff=fopen(filename2.c_str(),"w");
-
-        fprintf(ff,"<html><head><title>TMP</title> <script type=\"text/javascript\"> <!--\n");
-        fprintf(ff,"  window.location=\"%s#%s\";\n" , i->second->GetDocURL().c_str(),name.c_str() );
-        fprintf(ff,"//--></script></head><body></body></html>\n");
-
-
-        //fprintf(ff, "<a  href=\"%s#%s\">Link</a>\n", i->second->GetDocURL().c_str(),name.c_str() );
-        fclose(ff);
-        system( command.c_str() );      
-        found = true;
-     }
+	 command=command + directory +" tmp.html";
+	 FILE *ff;
+	 ff=fopen(filename2.c_str(),"w");
+	 
+	 fprintf(ff,"<html><head><title>TMP</title> <script type=\"text/javascript\"> <!--\n");
+	 fprintf(ff,"  window.location=\"%s#%s\";\n" , i->second->GetDocURL().c_str(),name.c_str() );
+	 fprintf(ff,"//--></script></head><body></body></html>\n");
+	 
+	 
+	 //fprintf(ff, "<a  href=\"%s#%s\">Link</a>\n", i->second->GetDocURL().c_str(),name.c_str() );
+	 fclose(ff);
+	 system( command.c_str() );      
+	 found = true;
+       }
    }
-    
-   bbtkDebugDecTab("Kernel",9);
+   
+   bbtkDebugDecTab("kernel",9);
    if (!found) 
    {
-      bbtkError("No package of the factory contains any black box <"
-                <<name<<">");
+     bbtkError("No package of the factory contains any black box <"
+	       <<name<<">");
    }
  }
     
@@ -840,82 +971,80 @@ namespace bbtk
   void Factory::CreateHtmlIndex(IndexEntryType type, 
 				const std::string& filename)
   {
-    bbtkDebugMessageInc("Kernel",9,"Factory::CreateHtmlIndex(\""
+    bbtkDebugMessageInc("kernel",9,"Factory::CreateHtmlIndex(\""
 			<<filename<<"\")"<<bbtkendl);
     
     std::string title;
 
     typedef std::map<std::string, 
-      std::vector<BlackBoxDescriptor::Pointer> > IndexType;
+                     std::vector<BlackBoxDescriptor::Pointer> > IndexType;
     IndexType index;
     // Builds the index map
     PackageMapType::const_iterator i;
     for (i = mPackageMap.begin(); i!=mPackageMap.end(); ++i )
-      {
-	Package::Pointer pack = i->second;
-	if (pack->GetName()=="user") continue;
-	Package::BlackBoxMapType::const_iterator j;
-	for (j = pack->GetBlackBoxMap().begin(); 
-	     j!= pack->GetBlackBoxMap().end(); 
-	     ++j)
-	  {
+	{
+		Package::Pointer pack = i->second;
+		if (pack->GetName()=="user") continue;
+		Package::DescriptorMapType::const_iterator j;
+		for (j = pack->GetDescriptorMap().begin(); 
+			j!= pack->GetDescriptorMap().end(); 
+			++j)
+		{
 	    
 	    // Skip adaptors 
-	    if ( type==Adaptors )
-	      {  
-		if (j->second->GetKind() == BlackBoxDescriptor::STANDARD )
-		  continue;
-	      }
-	    else 
-	      if (j->second->GetKind() != BlackBoxDescriptor::STANDARD )
-		continue;
-
-	    std::vector<std::string> keys;
-	    if (type==Packages)
-	      {
-		std::string k("");
-		k += pack->GetName();
-		keys.push_back(k);
-		title = "Boxes by package";
-	      }
-	    else if ((type==Initials) || (type==Adaptors))
-	      {
-		std::string init(" ");
-		init[0] =  std::toupper(j->second->GetTypeName()[0]);
-		keys.push_back(init);
-		title = "Alphabetical list";
-	      }
-	    else if (type==Categories)
-	      {
-		// Split the category string 
-		std::string delimiters = ";,";
-		Utilities::SplitString(j->second->GetCategory(),
-				       delimiters,keys);
-		if (keys.size()==0) 
-		  keys.push_back(" NONE");
-		title = "Boxes by category";
-	      }
-    
-	    
-	    std::vector<std::string>::const_iterator k;
-	    for (k=keys.begin(); k!=keys.end(); ++k )
-	      {
-		IndexType::iterator p;
-		p = index.find(*k);
-		if (p != index.end()) 
-		  {
-		    p->second.push_back(j->second);
-		  }
-		else 
-		  {
-		    std::vector<BlackBoxDescriptor::Pointer> v;
-		    v.push_back(j->second);
-		    index[*k] = v;
-		  }
-	      }
-	    
-	  }
-      }   
+			if ( type==Adaptors )
+			{  
+				if (j->second->GetKind() == BlackBoxDescriptor::STANDARD )
+				continue;
+			}
+			else 
+				if (j->second->GetKind() != BlackBoxDescriptor::STANDARD )
+				continue;
+
+			std::vector<std::string> keys;
+			if (type==Packages)
+			{
+				std::string k("");
+				k += pack->GetName();
+				keys.push_back(k);
+				title = "Boxes by package";
+			}
+			else if ((type==Initials) || (type==Adaptors))
+			{
+				std::string init(" ");
+				init[0] =  std::toupper(j->second->GetTypeName()[0]);
+				keys.push_back(init);
+				title = "Alphabetical list";
+			}
+			else if (type==Categories)
+			{
+			// Split the category string 
+			std::string delimiters = ";,";
+			Utilities::SplitString(j->second->GetCategory(),
+					   delimiters,keys);
+			if (keys.size()==0) 
+				keys.push_back(" NONE");
+				title = "Boxes by category";
+			}
+
+			std::vector<std::string>::const_iterator k;
+			for (k=keys.begin(); k!=keys.end(); ++k )
+			{
+				IndexType::iterator p;
+				p = index.find(*k);
+				if (p != index.end()) 
+				{
+					p->second.push_back(j->second);
+				}
+				else 
+				{
+					std::vector<BlackBoxDescriptor::Pointer> v;
+					v.push_back(j->second);
+					index[*k] = v;
+				}
+			}
+		}
+	}   
     // Creates the file 
     //---------------------
     // Open output file
@@ -960,7 +1089,7 @@ namespace bbtk
     IndexType::iterator ii;
     for (ii=index.begin();ii!=index.end();++ii)
       {
-	s << "<a href=\"#"<<ii->first<<"\">"<<ii->first<<"</a>&nbsp;&nbsp;";	
+		s << "<a href=\"#"<<ii->first<<"\">"<<ii->first<<"</a>&nbsp;&nbsp;";	
       }
 
     for (ii=index.begin();ii!=index.end();++ii)
@@ -976,7 +1105,14 @@ namespace bbtk
 	    s << "&nbsp;&nbsp;-&nbsp;&nbsp;\n"; 
 
 	    s << "<a name=\"doxygen\"></a>\n"; 
-	    s << "<a href=..\\doxygen\\" << ii->first << "/main.html>(Doxygen documentation of the source)</a>\n"; 
+
+//EED 26Mars2009
+	/*JCP 19 Nov 2009
+		std::string bin_path = bbtk::ConfigurationFile::GetInstance().Get_bin_path();
+	    s << "<a href=" << bin_path <<"/../share/bbtk/doc/doxygen/" << ii->first << "/main.html>(Doxygen documentation of the source)</a>\n"; 
+	JCP 19 Nov 2009*/
+		std::string bin_path = bbtk::ConfigurationFile::GetInstance().Get_bin_path();		
+	    s << "<a href=" << bin_path <<"/../share/bbtk/doc/doxygen/" << ii->first << "/main.html>(Doxygen documentation of the source)</a>\n"; 
 	  }
 	else 
 	  {
@@ -1016,7 +1152,7 @@ namespace bbtk
     ptm = gmtime ( &rawtime );
 
     s << "<p><hr>\n";
-    s << "Automatically generated by <b>bbi</b> on "
+    s << "Automatically generated by <b>bbtk</b> on "
       << ptm->tm_mday << "/" << ptm->tm_mon << "/" << ptm->tm_year+1900 
       << " - " << ptm->tm_hour << ":" << ptm->tm_min << " GMT\n";
     s << "</body></html>\n"; 
@@ -1024,7 +1160,7 @@ namespace bbtk
     //----------------------
 
     // End
-    bbtkDebugDecTab("Kernel",9);
+    bbtkDebugDecTab("kernel",9);
   }
 
  //==========================================================================