]> https://gitweb.dealii.org/ - dealii-svn.git/commitdiff
Some more comments.
authorbangerth <bangerth@0785d39b-7218-0410-832d-ea1e28bc413d>
Fri, 2 Nov 2012 15:28:02 +0000 (15:28 +0000)
committerbangerth <bangerth@0785d39b-7218-0410-832d-ea1e28bc413d>
Fri, 2 Nov 2012 15:28:02 +0000 (15:28 +0000)
git-svn-id: https://svn.dealii.org/branches/branch_cmake@27314 0785d39b-7218-0410-832d-ea1e28bc413d

deal.II/doc/readme.html

index 31236a3bf9f4a25537d0597c27731ab656154b05..ff9a5dc18d1109cd7b633774537283b3580534ab 100644 (file)
          sources and recompile things, then you can remove
          the <code>build/</code> directory after the last step.
 
-       <li>The <acronym>deal.II</acronym> <code>cmake</code> system can accept a
+       <li> The <acronym>deal.II</acronym> <code>cmake</code> system can accept a
          significant number of configuration parameters. See the
          discussion <a href="#configuration-options">below</a>.
+
+       <li> If you are changing part of
+       the <acronym>deal.II</acronym> code itself, you can
+       re-compile the library using only the last two commands above
+       but in a previously created build directory. It is possible to
+       also change the configuration used in this directory by
+       calling <code>cmake</code> a second time, possibly with
+       different arguments. However, this sometimes leads to
+       surprising results and you may not get exactly what you were
+       hoping for. For more information, see <a href="cmake.html">here</a>.
+
       </ul>
     </p>
 
       other libraries. By default, <code>cmake</code> will enable interfaces
       to all external libraries it can find in default paths, but this
       behavior can all be selected using command line switches to the initial
-      call to <code>cmake</code>.
+      call to <code>cmake</code>. A detailed description of how this
+      all works can be found <a href="cmake.html">here</a>. In the
+      following, let us summarize the most common configuration options.
     </p>
 
     <a name="optional">
        </p>
     </ul>
 
-    <p>
-      <code>cmake</code> stores the paths to some
-      programs, such as the compilers or the Perl interpreter. The
-      compiler which will be used when compiling the library (or your
-      own application) is therefore selected at the time of
-      configuration and independent of the setting of your $PATH
-      environment value at the time when you run <code>make</code>. If
-      you want to change the compiler used, you will therefore have
-      to re-run ./configure.
-    </p>
-
-    <p>
-      It is in general a good idea to run <code>make clean</code>
-      before re-configuring.
-    </p>
-
 
 
 
       form <code>-DLIBX_DIR=/path/to/libx</code> then you can alternatively
       also set <code>LIBX_DIR</code> as an environment variable in
       your <code>.bashrc</code> or <code>.cshrc</code> file so that you do not
-      have to enter this argument everytime you call <code>cmake</code>.
+      have to enter this argument everytime you
+      call <code>cmake</code>. Any value passed on the command line
+      wins over a value that may be found in an environment variable.
     </p>
 
     <dl>
             target="_top">Threading Building Blocks (TBB)</a></dt>
       <dd>
        <p>
-         <a href="http://www.threadingbuildingblocks.org/"
+         The <a href="http://www.threadingbuildingblocks.org/"
             target="_top">Threading Building Blocks (TBB)</a>
          is a library that provides advanced services for using multiple
          processor cores on a single machine and is used

In the beginning the Universe was created. This has made a lot of people very angry and has been widely regarded as a bad move.

Douglas Adams


Typeset in Trocchi and Trocchi Bold Sans Serif.