--- /dev/null
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
+ "http://www.w3.org/TR/html4/loose.dtd">
+
+<html>
+ <head>
+ <title>The deal.II Readme on interfacing to OpenCASCADE</title>
+ <link href="../screen.css" rel="StyleSheet">
+ <meta name="copyright" content="Copyright (C) 2010, 2013, 2014 by the deal.II authors">
+ <meta name="date" content="$Date$">
+ <meta name="keywords" content="deal.II">
+ </head>
+ <body>
+
+
+ <h2>Installation of <acronym>OpenCASCADE</acronym></h2>
+
+ <p> <a href="http://www.opencascade.org/">OpenCASCADE</a> is a
+ software development kit (SDK) intended for development of
+ applications dealing with 3D CAD data, freely available in open
+ source. It includes a set of C++ class libraries providing
+ services for 3D surface and solid modeling, visualization, data
+ exchange and rapid application development.</p>
+
+ <p> Below is a short summary of instructions on how to compile and
+ install <acronym>OpenCASCADE</acronym> community edition by hand
+ (for the case you wish to do so). </p>
+
+ <h3>How to compile and install <acronym>OpenCASCADE</acronym>
+ </h3>
+
+ <p>
+Get a clone of the OCE repository:
+<pre>
+git clone git://github.com/tpaviot/oce.git
+</pre>
+
+It is a good practice to build in a separate directory:
+<pre>
+mkdir build
+cd build
+cmake -DOCE_INSTALL_PREFIX=/path/to/where/you/want/oce ..
+make install
+</pre>
+
+The default options are good for the deal.II library.
+
+ <h2>Interfacing <acronym>deal.II</acronym>
+ to <acronym>OpenCASCADE</acronym></h2>
+
+ <p>
+ Support for <acronym>OpenCASCADE</acronym> will be
+ enabled automatically if a system wide installation of
+ <acronym>OpenCASCADE</acronym> can be found.
+ To use a self compiled version, specify
+ <pre>
+
+ -DOPENCASCADE_DIR=/path/to/opencascade/or/oce
+ </pre>
+ when invoking <code>cmake</code>.
+ </p>
+ <p>
+ You can override the autodetection by manually setting
+ <pre>
+
+ -DDEAL_II_WITH_OPENCASCADE=OFF|ON
+ </pre>.
+ </p>
+
+ <hr />
+ <address>
+ <a href="http://www.dealii.org/authors.html" target="_top">The deal.II Authors</a>
+ $Date$
+ </address>
+ <div class="right">
+ <a href="http://validator.w3.org/check?uri=referer" target="_top">
+ <img style="border:0" src="http://www.w3.org/Icons/valid-html401" alt="Valid HTML 4.01!"></a>
+ <a href="http://jigsaw.w3.org/css-validator/check/referer" target="_top">
+ <img style="border:0;width:88px;height:31px" src="http://jigsaw.w3.org/css-validator/images/vcss" alt="Valid CSS!"></a>
+ </div>
+
+ </body>
+</html>