0024816: Tool for upgrading OCCT and dependent code

A new script adm/upgrade.tcl defines a Tcl procedure occt_upgrade, to be used for upgrading code of OCCT and applications for changes introduced by OCCT 7.0.
Batch script upgrade.bat is provided for convenience.
File upgrade.dat contains data (lists of classes) required for some upgrade steps.
Details on upgrade procedure are put in dox/dev_guides/upgrade/upgrade.md.

OCCT code corrected to improve compatibility with code based on previous versions of OCCT:
- Added conversion operator of handle to bool, for use in conditional expressions.
- Forward declaration of argument class restored in macro DEFINE_STANDARD_HANDLE.
- Includes of used classes added in some headers to avoid problem of missing includes in dependent code
- Type cast operators to base curve and surface added in GC and GCE2d classes to reduce porting issues.

Added test for local reference to handle initialized by temporary handle to derived class.

WOK and CDL User Guides removed.

src/Geom2dHatch/Geom2dHatch_Hatcher.hxx

@@ -18,29 +18,23 @@
 #define _Geom2dHatch_Hatcher_HeaderFile
 
 #include <Standard.hxx>
-#include <Standard_DefineAlloc.hxx>
-#include <Standard_Handle.hxx>
 
+#include <Geom2dAdaptor_Curve.hxx>
 #include <Geom2dHatch_Intersector.hxx>
-#include <Standard_Real.hxx>
-#include <Standard_Boolean.hxx>
-#include <Standard_Integer.hxx>
 #include <Geom2dHatch_Elements.hxx>
 #include <Geom2dHatch_Hatchings.hxx>
 #include <TopAbs_Orientation.hxx>
 #include <HatchGen_ErrorStatus.hxx>
+
 class Standard_NoSuchObject;
 class Standard_OutOfRange;
 class StdFail_NotDone;
 class Geom2dHatch_Intersector;
 class Geom2dHatch_Element;
-class Geom2dAdaptor_Curve;
 class Geom2dHatch_Hatching;
 class HatchGen_PointOnHatching;
 class HatchGen_Domain;
 
-
-
 class Geom2dHatch_Hatcher 
 {
 public:
@@ -97,6 +91,13 @@ public:
   //! Adds an element to the hatcher and returns its index.
   Standard_EXPORT Standard_Integer AddElement (const Geom2dAdaptor_Curve& Curve, const TopAbs_Orientation Orientation = TopAbs_FORWARD);
   
+  //! Adds an element to the hatcher and returns its index.
+  Standard_Integer AddElement (const Handle(Geom2d_Curve)& Curve, const TopAbs_Orientation Orientation = TopAbs_FORWARD)
+  {
+    Geom2dAdaptor_Curve aGAC (Curve);
+    return AddElement (aGAC, Orientation);
+  }
+
   //! Removes the IndE-th element from the hatcher.
   Standard_EXPORT void RemElement (const Standard_Integer IndE);