From 292b226226a8ac9fe8ed528389994b63bec9407d Mon Sep 17 00:00:00 2001 From: wolf Date: Tue, 29 Feb 2000 08:54:20 +0000 Subject: [PATCH] Various updates. git-svn-id: https://svn.dealii.org/trunk@2504 0785d39b-7218-0410-832d-ea1e28bc413d --- deal.II/doc/download.html | 37 ++++++++++++ deal.II/doc/future.html | 4 +- deal.II/doc/navbar.html | 7 +++ deal.II/doc/readme.html | 115 ++++++++++++++++++++++---------------- deal.II/doc/toc.html | 4 +- 5 files changed, 115 insertions(+), 52 deletions(-) create mode 100644 deal.II/doc/download.html diff --git a/deal.II/doc/download.html b/deal.II/doc/download.html new file mode 100644 index 0000000000..ecf28fb132 --- /dev/null +++ b/deal.II/doc/download.html @@ -0,0 +1,37 @@ + + + + + + The deal.II Homepage + + + + + +

Downloading deal.II

+ +

+ deal.II will be Open Source and therefore + freely available. We will provide download facilities here + shortly. +

+ +

+ However, at present we are still in the latest testing stages and + do not presently put up snapshots for public download. If you want + to obtain a copy of the present state anyway, please feel free to + contact us through one of the mailing lists (see the + main page). +

+ + +
+ +
+ The deal.II group
+ + + + diff --git a/deal.II/doc/future.html b/deal.II/doc/future.html index 457faf343b..17dccd801c 100644 --- a/deal.II/doc/future.html +++ b/deal.II/doc/future.html @@ -115,8 +115,8 @@ Parallelization: We do not presently think about parallelizing the libraries on distributed memory machines, but the present - implementation of multithreading on shared memory machines is - quite promising. We will implement multithreading for several + implementation of multi-threading on shared memory machines is + quite promising. We will implement multi-threading for several other parts of the library of which we know they are taking significant amounts of time in common applications.

diff --git a/deal.II/doc/navbar.html b/deal.II/doc/navbar.html index 19b74e71cf..1d70cf4475 100644 --- a/deal.II/doc/navbar.html +++ b/deal.II/doc/navbar.html @@ -72,6 +72,13 @@

+
  • +

    + + Download +

    +
  • +
  • diff --git a/deal.II/doc/readme.html b/deal.II/doc/readme.html index f86410bf63..6810abc120 100644 --- a/deal.II/doc/readme.html +++ b/deal.II/doc/readme.html @@ -44,7 +44,8 @@ (and its sub-libraries /base and /lac) you need to have the following programs installed:

    @@ -137,75 +151,78 @@

    - After configuring, go to the /common subdirectory and type 'make', + After configuring, go to the /common subdirectory and type `make', to obtain the following help (this output may change slightly over time, just try it):

    
    -======================================================================
    -=Global Makefile for the deal.II libraries                           =
    -======================================================================
    -=Possible Targets                                                    =
    -=  baseg lacg: debug libraries base and lac                          =
    -=  base lac: debug and optimized libraries base and lac              =
    -=  1dg 2dg 3dg: (1) and deal.II debug version for specified dimension=
    -=  1d 2d 3d: (2) and deal.II for specified dimension                 =
    -=  all: base, lac 1d, 2d and 3d                                      =
    -=  online-doc: generate the documentation in HTML format             =
    -=  printable-doc: generate the documentation in Postscript format.   =
    -=      You need to have Doc++ and LaTeX installed for that.          =
    -=  tex-doc: same, but only generate the LaTeX file, don't compile it =
    -=  TODO: create a TODO file from TODO lines in the source files      =
    -=  TAGS: create a TAGS file from include and source files            =
    -=  clean: removes all object files, libraries, etc in all subdirs    =
    -=                                                                    =
    -=The following additional parameters may be specified to make:       =
    -=  PAR=-jn where n is the number of parallel processes for parallel  =
    -=          builds. If you use GNU make 3.78 or higher, you can       =
    -=          call 'make -jn' directly. This parameter is no more       =
    -=          necessary then.                                           =
    -======================================================================
    +    ======================================================================
    +    =Global Makefile for the deal.II libraries                           =
    +    ======================================================================
    +    =Possible Targets                                                    =
    +    =  baseg lacg: debug libraries base and lac                          =
    +    =  base lac: debug and optimized libraries base and lac              =
    +    =  1dg 2dg 3dg: (1) and deal.II debug version for specified dimension=
    +    =  1d 2d 3d: (2) and deal.II for specified dimension                 =
    +    =  all: base, lac 1d, 2d and 3d                                      =
    +    =  online-doc: generate the documentation in HTML format             =
    +    =  printable-doc: generate the documentation in Postscript format.   =
    +    =      You need to have Doc++ and LaTeX installed for that.          =
    +    =  tex-doc: same, but only generate the LaTeX file, don't compile it =
    +    =  TODO: create a TODO file from TODO lines in the source files      =
    +    =  TAGS: create a TAGS file from include and source files            =
    +    =  clean: removes all object files, libraries, etc in all subdirs    =
    +    =                                                                    =
    +    =The following additional parameters may be specified to make:       =
    +    =  PAR=-jn where n is the number of parallel processes for parallel  =
    +    =          builds. If you use GNU make 3.78 or higher, you can       =
    +    =          call 'make -jn' directly. This parameter is no more       =
    +    =          necessary then.                                           =
    +    ======================================================================
         
    - To execute one of the commands, type 'make target-name'. Please + To execute one of the commands, type `make target-name'. Please note that building all libraries in debug and optimized mode presently takes about an hour on a Sun Ultra 450, so you may want to do this during lunchtime.

    - In case you have a multi-processor machine, you can call 'make + In case you have a multi-processor machine, you can call `make PAR=-j4 target-name' to let make call multiple instances of the compiler (in this case four). Since the make files are written in a way to minimize cross-dependencies, this speeds up compilation - by about the factor given after '-j', at least if you have as many + by about the factor given after `-j', at least if you have as many processors. If you have GNU make 3.78 or higher, it is simpler to - directly call 'make -j4 target-name'. + directly call `make -j4 target-name'.

    - After 'make' has finished, you will have two sets of + After `make' has finished, you will have two sets of libraries. The first consists of the files

    For each library, there will also be another library with the @@ -229,8 +246,8 @@ almost always abort your program if something goes wrong. In our experience, more than ninety per cent of all errors are invalid parameters (such as vectors having the wrong size, etc) and they - are usually found almost instantaneously using the file name and - line number of where the problem occurred. + are usually found almost instantaneously displaying the file + name and line number of where the problem occurred.

    @@ -290,7 +307,7 @@

    --enable-multithreading: This sets compiler variables such that the resulting program supports - multithreading. Basically, for this different system include + multi-threading. Basically, for this different system include files have to be selected (gcc option -threads) and memory allocation has to be made thread-safe; the latter can be done for the C++ standard containers by defining @@ -304,16 +321,16 @@

  • --with-multithreading=ACE-path: enabling - multithreading as shown above does not enable multithreading + multi-threading as shown above does not enable multi-threading inside the library itself. However, there are several places - where multithreading can be used (in some parts of the graphical + where multi-threading can be used (in some parts of the graphical output routines, the KellyErrorEstimator class and some other - places), and you can switch to multithreading using this + places), and you can switch to multi-threading using this configure option.

    - To support multithreading in a cross-platform way, we use the + To support multi-threading in a cross-platform way, we use the ACE (Adaptive Communications Environment) library. This needs to be installed separately, and the path to its installation @@ -327,7 +344,9 @@

    Note that the multi-thread support in the library is still - experimental. + experimental. While deal.II runs on a variety + of Unix systems, we presently support detection of the number of + CPUs in your system only for Linux and Solaris.

    diff --git a/deal.II/doc/toc.html b/deal.II/doc/toc.html index 1227868433..baa44efb84 100644 --- a/deal.II/doc/toc.html +++ b/deal.II/doc/toc.html @@ -100,7 +100,7 @@
  • Support for several output formats, including some common - formats for visualisation of scientific data. + formats for visualization of scientific data.

  • @@ -220,7 +220,7 @@ postscript output.

  • Thomas Richter: Povray output; -   multithreading work. +   multi-threading work.
  • Jan Schrage: parts of the tutorial.
  • Franz-Theo Suttmeier: -- 2.39.5