From 4aa19db42abd25d3a7f0e31ffc2da37a9a1007bf Mon Sep 17 00:00:00 2001 From: Guido Kanschat Date: Wed, 12 Apr 2000 20:56:06 +0000 Subject: [PATCH] Info on porting git-svn-id: https://svn.dealii.org/trunk@2709 0785d39b-7218-0410-832d-ea1e28bc413d --- deal.II/doc/auto/kdoc/Makefile.in | 16 ++++--- deal.II/doc/development/toc.html | 9 ++++ deal.II/doc/porting.html | 77 +++++++++++++++++++++++++++++++ deal.II/doc/readme.html | 12 +++-- 4 files changed, 103 insertions(+), 11 deletions(-) create mode 100644 deal.II/doc/porting.html diff --git a/deal.II/doc/auto/kdoc/Makefile.in b/deal.II/doc/auto/kdoc/Makefile.in index 9796315cb2..ac0f260019 100644 --- a/deal.II/doc/auto/kdoc/Makefile.in +++ b/deal.II/doc/auto/kdoc/Makefile.in @@ -10,7 +10,11 @@ kdocversion = @kdocversion@ include $D/common/Make.global_options +ifeq ($kdocversion,1) KDOCFLAGS=-I$(kdocdir) $(kdocdir)/kdoc -a -p -L $D/doc/auto/kdoc +else +KDOCFLAGS=-I$(kdocdir) $(kdocdir)/kdoc -a -p -L $D/doc/auto/kdoc +endif kdoc.base = $(shell echo $D/base/include/base/*.h) kdoc.lac = $(shell echo $D/lac/include/lac/*.h) @@ -40,25 +44,25 @@ endif kdoc: $(kdoc.library-files) base.kdoc: $(kdoc.base) - @$(PERL) $(KDOCFLAGS) $(subst .kdoc,,$@) -d $(subst .kdoc,,$@) -L . \ + @$(PERL) $(KDOCFLAGS) $(subst .kdoc,,$@) -d $(subst .kdoc,,$@) \ $^ lac.kdoc: $(kdoc.lac) - @$(PERL) $(KDOCFLAGS) $(subst .kdoc,,$@) -d $(subst .kdoc,,$@) -L . \ + @$(PERL) $(KDOCFLAGS) $(subst .kdoc,,$@) -d $(subst .kdoc,,$@) \ -l base $^ grid.kdoc: $(kdoc.grid) - @$(PERL) $(KDOCFLAGS) $(subst .kdoc,,$@) -d $(subst .kdoc,,$@) -L . \ + @$(PERL) $(KDOCFLAGS) $(subst .kdoc,,$@) -d $(subst .kdoc,,$@) \ -l base $^ dof.kdoc: $(kdoc.dof) - $(PERL) $(KDOCFLAGS) $(subst .kdoc,,$@) -d $(subst .kdoc,,$@) -L . \ + $(PERL) $(KDOCFLAGS) $(subst .kdoc,,$@) -d $(subst .kdoc,,$@) \ -l base -llac -lgrid $^ numerics.kdoc: $(kdoc.numerics) - @$(PERL) $(KDOCFLAGS) $(subst .kdoc,,$@) -d $(subst .kdoc,,$@) -L . \ + @$(PERL) $(KDOCFLAGS) $(subst .kdoc,,$@) -d $(subst .kdoc,,$@) \ -l base -llac -lgrid -ldof $^ multigrid.kdoc: $(kdoc.multigrid) - @$(PERL) $(KDOCFLAGS) $(subst .kdoc,,$@) -d $(subst .kdoc,,$@) -L . \ + @$(PERL) $(KDOCFLAGS) $(subst .kdoc,,$@) -d $(subst .kdoc,,$@) \ -l base -llac -lgrid -ldof -lnumerics $^ diff --git a/deal.II/doc/development/toc.html b/deal.II/doc/development/toc.html index bbcc448ff2..6a0863b2d3 100644 --- a/deal.II/doc/development/toc.html +++ b/deal.II/doc/development/toc.html @@ -43,6 +43,15 @@ enable automatic documentation generation.

+

  • Porting + deal.II to a new system: + deal.II uses the mechanism provided by + GNU autoconf. Therefore, porting to a reasonably + standardized UNIX system should not be too difficult. Right + now, we have no experience with proprietory operating systems + like MSWindows or MacOS. +

    +

  • Recent changes to the library: If you want to stay informed about what is going on with the library itself, your may want to take a diff --git a/deal.II/doc/porting.html b/deal.II/doc/porting.html new file mode 100644 index 0000000000..d9952c52cd --- /dev/null +++ b/deal.II/doc/porting.html @@ -0,0 +1,77 @@ + + + + + + Porting deal.II + + + + + +

    Porting deal.II to new systems

    + +

    Attention: before starting a port to a new system, check +the readme file for your system.

    + +

    Compiler flags

    + +A configuration by setting the CXXFLAGS variable will soon be +supported. + +

    Configuration file

    + +

    Configurations must be done in the file configure.in of +the root directory of deal.II. At the end, look for +a section of the structure +

    +case "$target" in
+   *-linux*) ...;;
+   *-aix*) ...;;
+esac
+
+case "$target" in
+   alpha*-linux*) ...;;
+esac
+
    +The first case block allows you to adjust parameters for a certain +operating system, the second for an operating system/machine +configuration.

    + +

    Enable/disable configured options

    + +

    Some of the features of the library are turned on and of by +--enable-xxx and --with-xxx=yyy options to +configure. These user-supplied parameters can be changed by modifying +related variables: for example, to turn of shared libraries on aix, +enter the following in the operating system case-block +

    +   *-aix*) enableshared=no ;;
+
    + + +

    Preprocessor variables

    + +

    Some features of the library can be turned on or of by preprocessor +symbols. The following commands can be used: +

    + +
    throw_opt=-DNO_THROW
    +
    Turn of throwing exceptions in optimized mode.
    + +
    AC_DEFINE(QUIET_SUBSCRIPTOR)
    +
    Turn of type information in Subscriptor. +Helps to save memory (not much though) and is necessary if your +compiler does not implement RTTI. +
    + +
    + +
    +The deal.II +group $Date$ +
    + + + diff --git a/deal.II/doc/readme.html b/deal.II/doc/readme.html index 266aad19bd..f2917c4b7a 100644 --- a/deal.II/doc/readme.html +++ b/deal.II/doc/readme.html @@ -33,7 +33,7 @@ At present, deal.II has been developed and tested on Unix systems only. It can be used positively on
      -
    • Linux ELF with egcs 1.1.x and gcc 2.95.x; +
    • Linux ELF with gcc 2.95.x;
    • Sun Solaris 2.5, 2.6, and 7, with egcs 1.1.x and gcc 2.95.x;
    • SGI IRIX64 with gcc 2.95.x;
    • IBM AIX 4.2, with gcc 2.95.x (with some restrictions on @@ -41,7 +41,9 @@
    deal.II uses only very few features of an operating system. It should therefore be rather simple to port it - to other systems, at least with the compilers stated above. + to other systems, at least with the compilers stated above. See here, if your system is not on this + list.

    @@ -510,8 +512,8 @@

    - The deal.II group
    + The deal.II group + $Date$ + - - -- 2.39.5