]> https://gitweb.dealii.org/ - candi.git/commitdiff
Update README.md
authorUwe Köcher <koecher@hsu-hamburg.de>
Fri, 30 Oct 2015 20:11:41 +0000 (21:11 +0100)
committerUwe Köcher <koecher@hsu-hamburg.de>
Fri, 30 Oct 2015 20:11:41 +0000 (21:11 +0100)
README.md

index 8f6d0f74bfb6eb7e1fd0d6183b93f4e716662313..4bfe0477cdb8beff3e496c494100ca549c288ad9 100644 (file)
--- a/README.md
+++ b/README.md
@@ -1,14 +1,16 @@
-candi
+candi (Compile &amp; Install)
 =====
 
-candi - (Compile &amp; Install) - Downloads, configures, builds and install various FEM libraries, e.g. deal.II, FEniCS
+* Downloads, configures, builds and install various FEM libraries, e.g. deal.II, FEniCS
+* Set up your own projects to get tools or toolchains compiled easily
 
 General
 ----
 
 * candi is a bash script based installer tool.
+* candi is preconfigured to install a working deal.II toolchain on tested platforms
 * Open a Terminal.
-* Commands are further denoted with the prefix "$>"
+* Commands for your terminal are further denoted with the prefix "$>"
 * Do NOT copy the prefix "$>" into your terminal!
 
 Download
@@ -19,7 +21,7 @@ Download
 ```
 This downloads the current version of candi.
 
-Usage
+Usage (for installing deal.II)
 ----
 
 ### First Run
@@ -27,7 +29,7 @@ Make sure, that you are in the downloaded folder of candi; e.g. after the downlo
 ```bash
  $> cd candi
 ```
-Note: candi is initially configured to compile and install the current version of the deal.II library.
+Note: candi is preconfigured to compile and install the current version of the deal.II library.
 
 You run the installer by
 ```bash
@@ -42,7 +44,7 @@ You run the installer by
 * INSTALL the needed packages from your distribution. (You need super user rights for this step.)
 * SET UP the intended compilers; cf. the following instructions for this step.
 
-#### Install deal.II on RHEL 7, CentOS 7 or Fedora 20/21:
+#### Install deal.II on RHEL 7, CentOS 7 or Fedora 21/22:
 ```bash
   $> module load mpi/openmpi-`uname -i`
   $> export CC=mpicc; export CXX=mpicxx; export FC=mpif90; export FF=mpif77
@@ -62,20 +64,21 @@ Adapting candi to your needs
 
 ### Command line options (CLO) for `./candi.sh [CLO]`
 
-You can combine the command line options given below.
-Read carefully the output of `./candi.sh` before running!
+You can combine the command line options given below.
+Read carefully the output of `./candi.sh` before running!
 
-#### CLO: Prefix installation path: `[-p=<PATH>]`, `[--prefix=<PATH>]`
+#### CLO: Prefix path: `[-p=<PATH>]`, `[--prefix=<PATH>]`
 ```bash
   $> ./candi.sh --prefix=Your/Prefix/Path
 ```
 
-#### CLO: Using multiple build processes `[-j<N>]`, `[--PROCS=<N>]`
+#### CLO: Multiple build processes: `[-j<N>]`, `[--PROCS=<N>]`
 ```bash
   $> ./candi.sh -j<N>
 ```
+
 * Remark: there is no whitespace character allowed between `-j` and the number `<N>`.
-* Example: using 2 build processes `./candi.sh -j2` or `./candi.sh --PROCS=2`.
+* Example: using 2 build processes type `./candi.sh -j2` or `./candi.sh --PROCS=2`.
 * Be careful with that! You need to have enough system memory (e.g. at least 8GB for using 2 or more processes).
 
 ### Configuration file options (CFO)
@@ -84,6 +87,7 @@ Edit the configuration file behind the softlink "candi.cfg", e.g.
 ```bash
   $> gedit candi.cfg
 ```
+
 You can adapt several things to your personal needs here
 * the `DOWNLOAD_PATH` folder (can be safely removed after installation),
 * the `UNPACK_PATH` folder of the downloaded packages (can be safely removed after installation),
@@ -102,7 +106,7 @@ Note: setting the denoted variables in the configuration file will fix them,
 and they cannot be overwritten by command line options anymore.
 
 
-Switching candi to other Projects (e.g. FEniCS)
+Switching candi to other projects (e.g. FEniCS)
 ----
 
 You can switch the current project to handle to your needs.

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.