[MERGE] (master|vendor_Seitosh): vendor import of 23.10.2015

Merge branch 'vendor_Seitosh'

Conflicts:
	contrib/aff/README.export
	contrib/fourier/README.export
	contrib/stfinv/README.export

Commands executed on branch master (as a guideline for future imports):

  git merge -X theirs vendor_Seitosh
  git rm contrib/*/README.export
  git commit

contrib/aff/COPYING

@@ -2,7 +2,7 @@ this is <COPYING>
 ============================================================================
 libaff
 ------
-$Id: COPYING 4964 2013-02-01 13:27:42Z lrehor $
+$Id$
 ============================================================================
 
 Copyright (C) 2002 by Thomas Forbriger and Wolfgang Friederich

contrib/aff/Carray.h

@@ -3,7 +3,7 @@
  * 
  * ----------------------------------------------------------------------------
  * 
- * $Id: Carray.h 3957 2011-05-16 14:46:43Z tforb $
+ * $Id$
  * \author Thomas Forbriger
  * \date 14/05/2011
  * 
@@ -40,7 +40,7 @@
 #define AFF_CARRAY_H_VERSION \
   "AFF_CARRAY_H   V1.0   "
 #define AFF_CARRAY_H_CVSID \
-  "$Id: Carray.h 3957 2011-05-16 14:46:43Z tforb $"
+  "$Id$"
 
 #include<aff/array.h>
 #include<aff/lib/checkedcast.h>

contrib/aff/Makefile

 # this is <Makefile>
 # ----------------------------------------------------------------------------
-# $Id: Makefile 4964 2013-02-01 13:27:42Z lrehor $
+# $Id$
 # 
 # Copyright (c) 2002 by Thomas Forbriger (IMG Frankfurt) 
 # 
@@ -24,19 +24,10 @@
 # Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
 # ----
 #     
-# A note on header files:
-# We extensively comment class declarations within the header files. The
-# reduce compilation time when using the library code, comments will be
-# stripped from the header files that are exportet. These stripped versions
-# are placed in the source code path with name *.h.strip and will be linked to
-# INCINSTALLPATH with name *.h.
+# Please have a look at the README file coming along with the source code in
+# this directory for further notes regarding provided functionality,
+# prerequisites and installation.
 #
-# Although comment stripping could be done by perl with an elaborate regular
-# expression, we prefer the remcmmnt command by Jari Laaksonen. You can find
-# the code at 
-#   http://www.eti.pg.gda.pl/KATEDRY/kecs/lab-cpp/snippets/
-# If it is not available to you, you should set TF_REMCMMNT=cat (see below)
-# 
 # REVISIONS and CHANGES 
 #    06/12/2002   V1.0   Thomas Forbriger
 #    27/12/2002   V1.1   doxygen reads Fortran code and files generated by f2c
@@ -52,24 +43,9 @@
 #    17/01/2011   V1.9   distinguish library creation and installation
 #    27/07/2011   V1.10  give precedence to $LOCINCLUDEDIR over 
 #                        $SERVERINCLUDEDIR 
+#    26/01/2014          eliminate comment stripping 
 # 
 # ============================================================================
-#
-# environment variables
-# ---------------------
-#
-# You will like to set the following environment variables:
-#
-# LOCINCLUDEDIR         Defines the path where header files will be copied for
-#                       usage in your own projects. You will pass this path to
-#                       the precompiler with the -I option.
-# LOCLIBDIR             Defines the path where the binary library will be
-#                       placed.
-# TF_WWWBASEDIR         Defines the path to your personal homepage. That's the
-#                       place where doxygen output will be written too (see
-#                       below).
-#
-# You will find the installed library header files in $(LOCINCLUDEDIR)/aff
 
 include ../Makefile_var
 
@@ -113,36 +89,19 @@ SRC=lib/error.cc dump.cc lib/strided.cc lib/stridedstepper.cc \
 # test programs are placed in a subdirectory
 TESTS=$(wildcard tests/*.cc)
 # whereever we find a README, we will use it
-README=$(shell find . -name README) README.changelog README.groups
+README=$(shell find . -name README) 
+# the frame of doxygen documentation is palced in text files
+DOXYTXT=$(shell find . -name doxygen\*.txt) 
 
 # place where we will copy header files
 INCINSTALLPATH=$(LOCINCLUDEDIR)/aff
 # place where we will copy the binary library
 LIBINSTALLPATH=$(LOCLIBDIR)
 
-# name of headers with comments stripped off (these are linked to your include
-# directory)
-STRIPHEADER=$(addsuffix .strip,$(notdir $(HEADERS)))
 # name of installed (exported) header files (these are the names in your
 # include directory)
 INSTHEADER=$(addprefix $(INCINSTALLPATH)/,$(filter-out ./tests/%,$(HEADERS)))
 
-#======================================================================
-# comments can be removed from headers
-# ------------------------------------
- 
-# if defined, empty lines are kept in comment-stripped headers
-# to synchronize line numbers (necessary during library debugging)
-EMPTYPRINT=1
-#EMPTYPRINT=0
-
-# define this to be cat in case you do not have remcmmnt available
-ifndef TF_REMCMMNT
-TF_REMCMMNT=cat
-endif
-#REMCMMNT=remcmmnt
-#REMCMMNT=cat
-
 #======================================================================
 # compiler and preprocessor flags
 # -------------------------------
@@ -159,8 +118,8 @@ CPPFLAGS=$(addprefix -I,$(LOCINCLUDEDIR) $(subst :, ,$(SERVERINCLUDEDIR))) \
 
 # files which are to be edited
 flist: Makefile tests/Makefile doxydoc.cfg $(README) COPYING \
-       $(HEADERS) $(SRC) $(TESTS) $(wildcard doxy*.cfg) \
-       tests/f77common.inc tests/f77procs.f
+       $(HEADERS) $(SRC) $(TESTS) $(wildcard doxy*.cfg) $(DOXYTXT) \
+       tests/f77common.inc tests/f77procs.f $(TF_EDIT)
 	echo $(filter-out lib/% tests/%,$^) | tr ' ' '\n' | sort > $@
 	echo $(filter lib/%,$^) | tr ' ' '\n' | sort >> $@
 	echo $(filter tests/%,$^) | tr ' ' '\n' | sort >> $@
@@ -177,8 +136,7 @@ clean: ;
 	-find . -name \*.bak | xargs --no-run-if-empty /bin/rm -v
 	-find . -name \*.o | xargs --no-run-if-empty /bin/rm -v
 	-find . -name \*.d | xargs --no-run-if-empty /bin/rm -v
-	-find . -name \*.h.strip | xargs --no-run-if-empty /bin/rm -v
-	-/bin/rm -vf flist *.o install-include libcontxx.a *.xxx junk* *.a *.so
+	-/bin/rm -vf flist *.o install-include *.xxx junk* *.a *.so
 	cd tests; $(MAKE) clean
 
 #======================================================================
@@ -218,35 +176,12 @@ include $(patsubst %.cc,%.d,$(SRC))
 #======================================================================
 # header files
 # ------------
-#
-# Since we extensively document the class structures within the header files,
-# these should be stripped for the production version (otherwise the compiler
-# has to scan all comments on each compile). Stripping is done by the rule
-# below and is controlled by the variables TF_REMCMMNT and EMPTYPRINT (see
-# above).
-
-# comment stripping
-# -----------------
-$(call CHECKVARS,TF_REMCMMNT EMPTYPRINT)
-
-# awk rule assumes that the first non-comment line starts with '#'
-# and that the first (copyright) comment end with pattern "^ */"
-%.h.strip: %.h
-	awk 'BEGIN {hot=1;} /^ \*\// { if (hot) { hot=2; print; next;} }\
-        /^#/ { hot=0; } \
-        { if (hot==2) { print ""; } else if (hot) { print; } }' $< > $@
-	$(TF_REMCMMNT) $< | awk 'BEGIN {hot=0;} \
-        /^ *$$/ { if ((hot) && ($(EMPTYPRINT))) { print ""; } next; } \
-        /^#/ { hot=1; } { if (hot) print; }' >> $@
-
-#----------------------------------------------------------------------
-.PRECIOUS: %.h.strip
       
 $(call CHECKVAR,INCINSTALLPATH)
-$(INCINSTALLPATH)/%.h: %.h.strip
-	mkdir -vp $(dir $@)
-	-rm -fv $@
-	/bin/cp -vpd $< $@
+$(INCINSTALLPATH)/%.h: %.h
+	@mkdir -vp $(dir $@)
+	-@rm -fv $@
+	@/bin/cp -vpd $< $@
 
 # install header files
 .PHONY: install-include
@@ -292,7 +227,7 @@ DOXYWWWPATH=$(TF_WWWBASEDIR)/libaff
 
 doxyclean: ;/bin/rm -rfv $(TF_WWWBASEDIR)/libaff doxydoc.xxx
 
-DOXYSRC=$(README) $(HEADERS) $(SRC) \
+DOXYSRC=$(DOXYTXT) $(HEADERS) $(SRC) \
   tests/f77procs.P tests/f77procs.f \
   tests/f77common.inc tests/f77common_com.P
 

contrib/aff/README.export

-this is <README>
-============================================================================
-aff
----
-$Id$
-============================================================================
-
-This directory contains source code for the library aff. It was exportet
-from TF_Software to DENISE. DENISE is hosted in the Trac-/svn-project
-FWI_elastic (http://gpitrsvn.gpi.uni-karlsruhe.de/repos/FWI_elastic/DENISE).
-
-
-See COPYING for copyright and license information.   
-
-
-
-Exports:
-   Each time this source code is exported to DENISE the current version is
-   tagged. The directory containing the tagged version is named by the day 
-   of the export (yyyymmdd) and can be found in 
-   http://gpitrsvn.gpi.uni-karlsruhe.de/repos/TFSoftware/export/aff.
-   
-   19/10/2011   First export of the version tagged in 20111019
-   01/02/2013   Export of version tagged in 20130201
-   
------ END OF README ----- 

contrib/aff/Wff.siklst

-#
-# SIK Auswahl fuer FF library
-#
-*.c *.h *.f ?akefile *.inc *.cc *.tcc
-#
-# when working with m4
-*.m4 *.fpp
-#
-README*
-#
-# there are CVS working directories
-CVS
-#
-# doxygen configuration
-*.cfg

contrib/aff/array.h

@@ -3,7 +3,7 @@
  * 
  * ----------------------------------------------------------------------------
  * 
- * $Id: array.h 4004 2011-06-21 19:28:23Z tforb $
+ * $Id$
  * \author Thomas Forbriger
  * \since 08/12/2002
  * 
@@ -136,7 +136,7 @@
 #define AFF_ARRAY_H_VERSION \
   "AFF_ARRAY_H   V1.2"
 #define AFF_ARRAY_H_CVSID \
-  "$Id: array.h 4004 2011-06-21 19:28:23Z tforb $"
+  "$Id$"
 
 #include <aff/lib/sharedheap.h>
 #include <aff/lib/strided.h>

contrib/aff/arrayoperators.h

@@ -3,7 +3,7 @@
  * 
  * ----------------------------------------------------------------------------
  * 
- * $Id: arrayoperators.h 3957 2011-05-16 14:46:43Z tforb $
+ * $Id$
  * \author Thomas Forbriger
  * \date 10/02/2004
  * 
@@ -39,7 +39,7 @@
 #define AFF_ARRAYOPERATORS_H_VERSION \
   "AFF_ARRAYOPERATORS_H   V1.0   "
 #define AFF_ARRAYOPERATORS_H_CVSID \
-  "$Id: arrayoperators.h 3957 2011-05-16 14:46:43Z tforb $"
+  "$Id$"
 
 #include<aff/array.h>
 

contrib/aff/converters.h

@@ -3,7 +3,7 @@
  * 
  * ----------------------------------------------------------------------------
  * 
- * $Id: converters.h 3957 2011-05-16 14:46:43Z tforb $
+ * $Id$
  * \author Thomas Forbriger
  * \date 15/05/2011
  * 
@@ -40,7 +40,7 @@
 #define AFF_CONVERTERS_H_VERSION \
   "AFF_CONVERTERS_H   V1.0   "
 #define AFF_CONVERTERS_H_CVSID \
-  "$Id: converters.h 3957 2011-05-16 14:46:43Z tforb $"
+  "$Id$"
 
 #include<aff/array.h>
 #include<aff/series.h>

contrib/aff/doxydoc.cfg

@@ -89,9 +89,7 @@ WARN_LOGFILE           =
 #---------------------------------------------------------------------------
 INPUT                  = ./
 INPUT_ENCODING         = UTF-8
-FILE_PATTERNS          = README \
-                         README.changelog \
-                         README.groups \
+FILE_PATTERNS          = doxygen*.txt \
                          *.h \
                          *.cc
 RECURSIVE              = YES

contrib/aff/README.changelog → contrib/aff/doxygen.changelog.txt

-/*! \file README.changelog
+/*! \file doxygen.changelog.txt
  * \brief ChangeLog for C++ containers for numbers (libaff)
  *
  * ----------------------------------------------------------------------------
  *
- * $Id: README.changelog 4964 2013-02-01 13:27:42Z lrehor $
+ * $Id$
  * 
  * Copyright (c) 2002 by Thomas Forbriger (IMG Frankfurt) 
  * 
@@ -31,13 +31,14 @@
  * 
  * REVISIONS and CHANGES 
  *  - 17/12/2002   V1.0   Thomas Forbriger 
+ *  - 12/06/2013   V1.1   renamed file
  * 
  * ============================================================================
  */
 
 /*! \page page_changelog ChangeLog (AFF)
 
-  $Id: README.changelog 4964 2013-02-01 13:27:42Z lrehor $
+  $Id$
 
   \sa \ref page_project_status
 
@@ -290,7 +291,7 @@
 
 /*! \page page_project_status Project status (AFF)
 
-  $Id: README.changelog 4964 2013-02-01 13:27:42Z lrehor $
+  $Id$
 
   \sa \ref page_changelog
 
@@ -521,4 +522,4 @@
   </TABLE>
 */
 
-// ----- END OF README.changelog ----- 
+// ----- END OF doxygen.changelog.txt ----- 

contrib/aff/README.groups → contrib/aff/doxygen.groups.txt

-/*! \file libaff/README.groups
+/*! \file libaff/doxygen.groups.txt
  * \brief groups in libaff
  *
  * ----------------------------------------------------------------------------
  *
- * $Id: README.groups 4964 2013-02-01 13:27:42Z lrehor $
+ * $Id$
  * 
  * Copyright (c) 2011 by Thomas Forbriger (BFO)
  *
@@ -27,6 +27,7 @@
  * 
  * REVISIONS and CHANGES 
  *  - 15/05/2011   V1.0   Thomas Forbriger
+ *  - 12/06/2013   V1.1   renamed file
  * 
 
   \todo
@@ -132,4 +133,4 @@
 
 /*======================================================================*/
 
-// ----- END OF README.groups ----- 
+// ----- END OF doxygen.groups.txt ----- 

contrib/aff/dump.cc

@@ -3,7 +3,7 @@
  * 
  * ----------------------------------------------------------------------------
  * 
- * $Id: dump.cc 3117 2010-08-12 12:07:25Z tforb $
+ * $Id$
  * \author Thomas Forbriger
  * \date 12/12/2002
  * 
@@ -41,7 +41,7 @@
 #define AFF_DUMP_CC_VERSION \
   "AFF_DUMP_CC   V1.1"
 #define AFF_DUMP_CC_CVSID \
-  "$Id: dump.cc 3117 2010-08-12 12:07:25Z tforb $"
+  "$Id$"
 
 #include <aff/lib/dump_strided.h>
 #include <aff/lib/error.h>

contrib/aff/dump.h

@@ -3,7 +3,7 @@
  * 
  * ----------------------------------------------------------------------------
  * 
- * $Id: dump.h 3084 2010-08-10 16:01:03Z tforb $
+ * $Id$
  * \author Thomas Forbriger
  * \date 12/12/2002
  * 
@@ -53,7 +53,7 @@
 #define AFF_DUMP_H_VERSION \
   "AFF_DUMP_H   V1.3"
 #define TF_DUMP_H_CVSID \
-  "$Id: dump.h 3084 2010-08-10 16:01:03Z tforb $"
+  "$Id$"
 
 /*! \defgroup group_helpers Debug functions
  */

contrib/aff/fortranshape.cc

@@ -3,7 +3,7 @@
  * 
  * ----------------------------------------------------------------------------
  * 
- * $Id: fortranshape.cc 3084 2010-08-10 16:01:03Z tforb $
+ * $Id$
  * \author Thomas Forbriger
  * \date 23/12/2002
  * 
@@ -35,7 +35,7 @@
 #define AFF_FORTRANSHAPE_CC_VERSION \
   "AFF_FORTRANSHAPE_CC   V1.0   "
 #define AFF_FORTRANSHAPE_CC_CVSID \
-  "$Id: fortranshape.cc 3084 2010-08-10 16:01:03Z tforb $"
+  "$Id$"
 
 #include <aff/fortranshape.h>
 #include <aff/lib/error.h>

contrib/aff/fortranshape.h

@@ -3,7 +3,7 @@
  * 
  * ----------------------------------------------------------------------------
  * 
- * $Id: fortranshape.h 3084 2010-08-10 16:01:03Z tforb $
+ * $Id$
  * \author Thomas Forbriger
  * \date 23/12/2002
  * 
@@ -47,7 +47,7 @@
 #define AFF_FORTRANSHAPE_H_VERSION \
   "AFF_FORTRANSHAPE_H   V1.2"
 #define AFF_FORTRANSHAPE_H_CVSID \
-  "$Id: fortranshape.h 3084 2010-08-10 16:01:03Z tforb $"
+  "$Id$"
 
 #include<aff/array.h>
 #include<aff/lib/checkedcast.h>

contrib/aff/functions/absmax.h

@@ -3,7 +3,7 @@
  * 
  * ----------------------------------------------------------------------------
  * 
- * $Id: absmax.h 3084 2010-08-10 16:01:03Z tforb $
+ * $Id$
  * \author Thomas Forbriger
  * \date 09/03/2010
  * 
@@ -40,7 +40,7 @@
 #define AFF_ABSMAX_H_VERSION \
   "AFF_ABSMAX_H   V1.0   "
 #define AFF_ABSMAX_H_CVSID \
-  "$Id: absmax.h 3084 2010-08-10 16:01:03Z tforb $"
+  "$Id$"
 
 #include<aff/lib/collector.h>
 

contrib/aff/functions/avg.h

@@ -3,7 +3,7 @@
  * 
  * ----------------------------------------------------------------------------
  * 
- * $Id: avg.h 3084 2010-08-10 16:01:03Z tforb $
+ * $Id$
  * \author Thomas Forbriger
  * \date 20/03/2005
  * 
@@ -40,7 +40,7 @@
 #define AFF_AVG_H_VERSION \
   "AFF_AVG_H   V1.1   "
 #define AFF_AVG_H_CVSID \
-  "$Id: avg.h 3084 2010-08-10 16:01:03Z tforb $"
+  "$Id$"
 
 
 #include<aff/lib/collector.h>

contrib/aff/functions/histo.h

@@ -3,7 +3,7 @@
  * 
  * ----------------------------------------------------------------------------
  * 
- * $Id: histo.h 3084 2010-08-10 16:01:03Z tforb $
+ * $Id$
  * \author Thomas Forbriger
  * \date 28/04/2005
  * 
@@ -39,7 +39,7 @@
 #define AFF_HISTO_H_VERSION \
   "AFF_HISTO_H   V1.0   "
 #define AFF_HISTO_H_CVSID \
-  "$Id: histo.h 3084 2010-08-10 16:01:03Z tforb $"
+  "$Id$"
 
 
 #include<aff/lib/collector.h>