cleaning docs and adding intial note

Author: alsacco38

docs/build/doctrees/01 - Installing OpenCV for Java.doctree

@@ -77,7 +77,7 @@ <h2>Install Open CV 2.4.6 under Linux or Mac.<a class="headerlink" href="#instal
 As first step, if you don&#8217;t have these already, download and install <a class="reference external" href="http://www.cmake.org/download/">CMake</a> and <a class="reference external" href="http://ant.apache.org/">Apache Ant</a>.
 Extract the downloaded OpenCV file in a location of your choice and open CMake ( cmake-gui ).
 Put the location of the extracted OpenCV library in the <code class="docutils literal"><span class="pre">Where</span> <span class="pre">is</span> <span class="pre">the</span> <span class="pre">source</span> <span class="pre">code</span> <span class="pre">field</span></code> (e.g., /opencv2.4.6.1/) and put the destination directory of your build in the <code class="docutils literal"><span class="pre">Where</span> <span class="pre">to</span> <span class="pre">build</span> <span class="pre">the</span> <span class="pre">binaries</span></code> field (e.g., /opencv2.4.6.1/build), at last, check the <code class="docutils literal"><span class="pre">Grouped</span></code> and <code class="docutils literal"><span class="pre">Advanced</span></code> checkboxes.</p>
-<a class="reference internal image-reference" href="./res/01-00.png"><img alt="./res/01-00.png" src="./res/01-00.png" style="height: 200pt;" /></a>
+<img alt="_images/01-00.png" src="_images/01-00.png" />
 <p>Now press <code class="docutils literal"><span class="pre">Configure</span></code> and use the default compilers for <code class="docutils literal"><span class="pre">Unix</span> <span class="pre">Makefiles</span></code>.
 In the <code class="docutils literal"><span class="pre">Ungrouped</span> <span class="pre">Entries</span></code> group, insert the path to the Apache Ant executable (e.g., <code class="docutils literal"><span class="pre">/apacheant1.9.2/bin/ant</span></code>).
 In the <code class="docutils literal"><span class="pre">BUILD</span></code> group, unselect:
@@ -91,19 +91,19 @@ <h2>Install Open CV 2.4.6 under Linux or Mac.<a class="headerlink" href="#instal
 insert the Java include path (e.g., <code class="docutils literal"><span class="pre">/usr/lib/jvm/java7oracle/include/</span></code>)
 insert the alternative Java include path (e.g., <code class="docutils literal"><span class="pre">/usr/lib/jvm/java7oracle/include/linux</span></code>)
 Once we have pressed <code class="docutils literal"><span class="pre">Generate</span></code> twice the CMake window should appear with a white background. Now close CMake.</p>
-<img alt="res/01-01.png" src="res/01-01.png" />
+<img alt="_images/01-01.png" src="_images/01-01.png" />
 <p>Now open the terminal , go to the <code class="docutils literal"><span class="pre">build</span></code> folder of OpenCV and build everything with the command: <code class="docutils literal"><span class="pre">make</span> <span class="pre">-j8</span></code> (wait for the process to be completed...).
 If everything went well you should have <code class="docutils literal"><span class="pre">opencv-246.jar</span></code> and <code class="docutils literal"><span class="pre">libopencv_java246.so</span></code> files in the <code class="docutils literal"><span class="pre">/opencv-2.4.6.1/build/bin</span></code> directory and the <code class="docutils literal"><span class="pre">data</span></code> folder in the <code class="docutils literal"><span class="pre">/opencv-2.4.6.1/</span></code> directory.</p>
 </div>
 <div class="section" id="set-up-opencv-for-java-in-eclipse">
 <h2>Set up OpenCV for Java in Eclipse<a class="headerlink" href="#set-up-opencv-for-java-in-eclipse" title="Permalink to this headline">¶</a></h2>
 <p>Open Eclipse and select a workspace of your choice. Create a User Library, ready to be used on all the next projects: go to  <code class="docutils literal"><span class="pre">Window</span> <span class="pre">&gt;</span> <span class="pre">Preferences...</span></code>.</p>
-<img alt="res/01-02.png" src="res/01-02.png" />
+<img alt="_images/01-02.png" src="_images/01-02.png" />
 <p>From the menu navigate under <code class="docutils literal"><span class="pre">Java</span> <span class="pre">&gt;</span> <span class="pre">Build</span> <span class="pre">Path</span> <span class="pre">&gt;</span> <span class="pre">User</span> <span class="pre">Libraries</span></code> and choose <code class="docutils literal"><span class="pre">New...</span></code>.
 Enter a name for the library (e.g., opencv246) and select the newly created user library.
 Choose <code class="docutils literal"><span class="pre">Add</span> <span class="pre">External</span> <span class="pre">JARs...</span></code>, browse to select <code class="docutils literal"><span class="pre">opencv246.jar</span></code>.
 After adding the jar, extend it and select <code class="docutils literal"><span class="pre">Native</span> <span class="pre">library</span> <span class="pre">location</span></code> and press <code class="docutils literal"><span class="pre">Edit...</span></code>.</p>
-<img alt="res/01-03.png" src="res/01-03.png" />
+<img alt="_images/01-03.png" src="_images/01-03.png" />
 <p>Select <code class="docutils literal"><span class="pre">External</span> <span class="pre">Folder...</span></code> and browse to select the folder containing the OpenCV libraries (e.g., <code class="docutils literal"><span class="pre">C:\opencv\build\java\x64</span></code> under Windows).</p>
 </div>
 </div>

docs/build/doctrees/02 - First Java Application with OpenCV.doctree

@@ -51,6 +51,10 @@ <h3>Navigation</h3>
 
   <div class="section" id="first-java-application-with-opencv">
 <h1>First Java Application with OpenCV<a class="headerlink" href="#first-java-application-with-opencv" title="Permalink to this headline">¶</a></h1>
+<div class="admonition note">
+<p class="first admonition-title">Note</p>
+<p class="last">We assume that by now you have already read the previous tutorials. If not, please check previous tutorials at <a class="reference external" href="http://polito-java-opencv-tutorials.readthedocs.org/en/latest/index.html">http://polito-java-opencv-tutorials.readthedocs.org/en/latest/index.html</a>. You can also find the source code and resources at <a class="reference external" href="https://github.com/java-opencv/Polito-Java-OpenCV-Tutorials-Source-Code">https://github.com/java-opencv/Polito-Java-OpenCV-Tutorials-Source-Code</a></p>
+</div>
 <div class="section" id="introduction-to-a-opencv-application-with-java">
 <h2>Introduction to a OpenCV application with Java<a class="headerlink" href="#introduction-to-a-opencv-application-with-java" title="Permalink to this headline">¶</a></h2>
 <p>This tutorial will guide you through the creation of a simple Java console application using the  OpenCV library by mean of Eclipse.</p>
@@ -70,17 +74,17 @@ <h2>What we will do in this tutorial<a class="headerlink" href="#what-we-will-do
 <div class="section" id="create-a-new-project">
 <h2>Create a New Project<a class="headerlink" href="#create-a-new-project" title="Permalink to this headline">¶</a></h2>
 <p>Open Eclipse and create a new Java project; open the <code class="docutils literal"><span class="pre">File</span></code> menu, go to <code class="docutils literal"><span class="pre">New</span></code> and click on <code class="docutils literal"><span class="pre">Java</span> <span class="pre">Project</span></code>.</p>
-<img alt="res/02-00.png" src="res/02-00.png" />
+<img alt="_images/02-00.png" src="_images/02-00.png" />
 <p>In the <code class="docutils literal"><span class="pre">New</span> <span class="pre">Java</span> <span class="pre">Project</span></code> dialog write the name of your project and click on <code class="docutils literal"><span class="pre">Finish</span></code>.</p>
 </div>
 <div class="section" id="add-a-user-library">
 <h2>Add a User Library<a class="headerlink" href="#add-a-user-library" title="Permalink to this headline">¶</a></h2>
 <p>If you followed the previous tutorial (<code class="docutils literal"><span class="pre">Installing</span> <span class="pre">OpenCV</span> <span class="pre">for</span> <span class="pre">Java</span></code>), you should already have the OpenCV library set in your workspace&#8217;s user libraries, if not please check out the previous tutorial.
 Now you should be ready to add the library to your project.
 Inside Eclipse&#8217;s <code class="docutils literal"><span class="pre">Package</span> <span class="pre">Explorer</span></code> just right-click on your project&#8217;s folder and go to <code class="docutils literal"><span class="pre">Build</span> <span class="pre">Path</span> <span class="pre">--&gt;</span> <span class="pre">Add</span> <span class="pre">Libraries...</span></code>.</p>
-<img alt="res/02-01.png" src="res/02-01.png" />
+<img alt="_images/02-01.png" src="_images/02-01.png" />
 <p>Select <code class="docutils literal"><span class="pre">User</span> <span class="pre">Libraries</span></code> and click on <code class="docutils literal"><span class="pre">Next</span></code>, check the checkbox of the OpenCV library and click <code class="docutils literal"><span class="pre">Finish</span></code>.</p>
-<img alt="res/02-02.png" src="res/02-02.png" />
+<img alt="_images/02-02.png" src="_images/02-02.png" />
 </div>
 <div class="section" id="create-a-simple-application">
 <h2>Create a simple application<a class="headerlink" href="#create-a-simple-application" title="Permalink to this headline">¶</a></h2>
@@ -119,7 +123,7 @@ <h2>Create a simple application<a class="headerlink" href="#create-a-simple-appl
 </div>
 <p>We can now try to build and run our application by clicking on the Run button.
 You should have the following output:</p>
-<img alt="res/02-03.png" src="res/02-03.png" />
+<img alt="_images/02-03.png" src="_images/02-03.png" />
 <p>Here I put the whole source code:</p>
 <div class="highlight-java"><div class="highlight"><pre><span class="kn">package</span> <span class="n">mypackage</span><span class="o">;</span>