Merge branch 'master' into develop

.gitignore

@@ -1,4 +1,35 @@
-references/
-doc/html/
-tests/
+# compiled object files
+*.slo
+*.lo
+*.o
+*.obj
+
+# compiled dynamic libraries
+*.so
+
+# fortran module files
+*.mod
+
+# compiled static libraries
+*.la
+*.a
+*.lib
+
+# executables
+*.exe
+*.out
+*.a
+*.app
+
+# log files
 *.log
+
+# special directories
+doc/html/
+exe/
+forks/
+get_automatic_changelog.sh
+references/
+shared/
+static/
+wiki/

.gitmodules

@@ -1,6 +1,8 @@
 [submodule "external/pyplot-fortran"]
-	path = src/third_party/pyplot-fortran
-	url = https://github.com/jacobwilliams/pyplot-fortran
+  path = src/third_party/pyplot-fortran
+  url = https://github.com/jacobwilliams/pyplot-fortran
+  branch = master
 [submodule "src/third_party/PENF"]
-	path = src/third_party/PENF
-	url = https://github.com/szaghi/PENF
+  path = src/third_party/PENF
+  url = https://github.com/szaghi/PENF
+  branch = master

.travis.yml

@@ -1,7 +1,4 @@
-language: python
-
-python:
-  - 2.7
+language: generic
 
 sudo: false
 
@@ -17,14 +14,17 @@ addons:
     sources:
       - ubuntu-toolchain-r-test
     packages:
-      - gfortran-4.9
+      - gfortran-6
       - binutils
       - python-pip
-      - graphviz      
+      - graphviz
 
 env:
   global:
-    - SCRIPT="FoBiS.py rule -ex makecoverage"
+    - MAKECOVERAGE="FoBiS.py rule -ex makecoverage"
+    - MAKEDOC="./scripts/makedoc.sh Fortran-FOSS-Programmers/WenOOF"
+    - CLEAN="FoBiS.py rule -ex clean"
+    - MAKETAR="FoBiS.py rule -ex maketar"
 
 before_install:
   - git submodule update --init --recursive
@@ -35,20 +35,32 @@ install:
       mkdir "$HOME/.local/bin"
     fi
   - export PATH="$HOME/.local/bin:$PATH"
-  - export FC=/usr/bin/gfortran-4.9
-  - ln -fs /usr/bin/gfortran-4.9 "$HOME/.local/bin/gfortran" && gfortran --version
-  - ls -l /usr/bin/gfortran-4.9
-  - ln -fs /usr/bin/gcov-4.9 "$HOME/.local/bin/gcov" && gcov --version
-  - pip install --upgrade pygooglechart
-  - pip install --upgrade graphviz
-  - pip install --upgrade FoBiS.py
-  - pip install --upgrade markdown-checklist 
-  - pip install --upgrade ford
+  - export FC=/usr/bin/gfortran-6
+  - ln -fs /usr/bin/gfortran-6 "$HOME/.local/bin/gfortran" && gfortran --version
+  - ls -l /usr/bin/gfortran-6
+  - ln -fs /usr/bin/gcov-6 "$HOME/.local/bin/gcov" && gcov --version
+  - pip install --user --upgrade pygooglechart
+  - pip install --user --upgrade graphviz
+  - pip install --user --upgrade FoBiS.py
+  - pip install --user --upgrade markdown-checklist 
+  - pip install --user --upgrade ford
 
 script:
-  - $SCRIPT
+  - $MAKECOVERAGE
 
 after_success:
-  - cd $TRAVIS_BUILD_DIR
+  - find . -name '*.gcno' -print
   - bash <(curl -s https://codecov.io/bash)
-  - ./makedoc.sh Fortran-FOSS-Programmers/WenOOF
+  - $MAKEDOC
+
+deploy:
+  provider: releases
+  api_key:
+    secure: gpkufaCbypzFjTtrnFZYz9OyBgViuAyLuPwLYs0awLKUiMhyD+ABsir9wbaOzZ9+Po10qJUcFBkIA8DQCP8va0CasOnOVS2t+vJSuTAHno53eJr93DHvNeS1mCifkuMlKbtefEb7bp7lzr2Yjx2MPkiQdXsLYfckR9MVR5AkFrBmAvGUI4eZdf1xj5OY795DE/zv7RZEDBqH2jCMkebxok77oAq0n5NUWoZaHdTE9TI+m9672zjzYASmnpulbZ19RKvgBiLMVr/W08fdswiJApF5AhkIjI0CkqZASqnfzypDjg8zGK/ZnYKDsKSD3fc9jcOA+eDPYrClql2PVIVqKa/cWTIa0U2Hr4CQoChQ4Y2YI/5mtenGLAuLSmAMkxljWROkx7UMTpSLpuHo/ij8MYdFGOK9EgZzcwcV6bllNztLXtBl0u0rLDwuvuofukQw5SWFkmSrmgVeE3Xob32oG4kxj3cxgE2Lb5B8Ns72KO6DfV9AvsitCjF98wZb88ZXVghS8THwAu9dMFqdUn1vL0pcSQPM8rhHteiieqR1wQG61FAzAUe2WmXT6r1IpWkBlLp5v5ITf+/BAoyLKDyDvCh+KScf6Yu/nBtE3GRR7RUMwENd34bEQXM8ZsWKgUdMeg/fhYED67Gw4N0ZedNFzJykR0jw4i/L9tzjMtGax1A=
+  file: 
+    - WenOOF-$TRAVIS_TAG.tar.gz
+    - ./scripts/install.sh
+  skip_cleanup: true
+  overwrite: true
+  on:
+    tags: true

CONTRIBUTING.md

@@ -0,0 +1,69 @@
+# How to contribute
+
+This project is FOSS (free and open source software), therefore, anyone is interest to use, to develop or to contribute to it is welcome.
+
+This project must remain KISS (Keep It Simple and Stupid), thus a few guidelines for contributing are provided.
+
+## Issues Handling
+
+If you find issues (bugs or new features requests) you are kindly requested to highlight them on the GitHub repository.
+
++ Make sure you have a [GitHub account](https://github.com/signup/free);
++ submit a ticket for your issue, assuming one does not already exist;
+  + clearly describe the issue including steps to reproduce when it is a bug;
+  + make sure you fill in the earliest version that you know has the issue.
+
+## Collaborative Development
+
+If you like to directly contribute to the project you are welcome. To improve the collaborative development of the project you are kindly requested to respect the following guidelines.
+
++ Fork the repository on GitHub;
++ make sure you have a modern Fortran compiler having extensive support for 2003+ standards for safely testing the project;
++ create a topic branch from where you want to base your work;
+  + this is usually the master branch:
+  + only target release branches if you are certain your fix must be on that branch;
+  + to quickly create a topic branch based on master; `git branch fix/master/my_contribution master` then checkout the new branch with `git checkout fix/master/my_contribution`; please avoid working directly on the `master` branch;
++ check for unnecessary whitespace with `git diff --check` [before committing](#gitws);
++ make sure your commit messages are clear;
++ make sure you have properly tested for your changes;
++ as long as possible, try to follow our [coding style](#fstyle);
+
+### <a name="gitws"></a> Make git to get the rid of unnecessary white-spaces
+
+It is suggested to allow git to get the rid of unnecessary white-spaces eventually introduced into the sources. To this aim check that your git configuration (global or repository-specific) contains the following settings:
+
+```dosini
+[color]
+  ui = true
+[color "diff"]
+  whitespace = red reverse
+[core]
+  whitespace=fix,-indent-with-non-tab,trailing-space,cr-at-eol
+```
+
+### <a name="fstyle"></a> Fortran Coding Style
+
+As long as possible, contributors are kindly requested to follow the current coding style:
+
++ write code that comments itself, e.g. clearness naming (even if lengthy) is better than conciseness one which often means obscure:
+  + human readable variables names are better than obscure acronyms, e.g. `real :: gas_ideal_air` is better than `real :: gia`;
+  + variables name of one character should be avoided; they should be used only for counters, e.g. `do i=1, Number_iterations ; ! loop statements ; enddo`
++ name all constants;
++ minimize global data:
+  + use global types parameters, i.e. kinds and precisions of numbers, especially;
++ use pervasive explicit typing, i.e. add `implicit none` to all modules and programs:
+  + declare intent for all procedures arguments;
+  + consistently place procedure arguments in the following order:
+    + the pass argument;
+    + intent(in out) arguments;
+    + intent(in) arguments;
+    + intent(out) arguments;
+    + optional arguments
++ avoid side effects, as much as possible;
++ indent blocks of statements being inside loops, select case, if, etc...:
+  + indent with two white spaces instead of tabs;
++ avoid trailing white spaces;
++ blank lines should not have any space;
++ prefer `>,<,==...` instead of `.gt.,.lt.,.eq....`;
+
+In general, it is strongly recommended to avoid Microsoft-Windows-like carriage-return symbols in order to not pollute the source files with unnecessary symbols.

doc/main_page.md

@@ -1,19 +1,22 @@
 project: WenOOF
-project_dir: ./src/
-output_dir: ./doc/html/publish/
+src_dir: ../src
+output_dir: html/publish/
 project_github: https://github.com/Fortran-FOSS-Programmers/WenOOF
 summary: WENO interpolation Object Oriented Fortran library
-author: Fortran-FOSS-Programmers Group
+author: Fortran-FOSS-Programmers
 github: http://fortran-foss-programmers.github.io/
 website: http://fortran-foss-programmers.github.io/
 md_extensions: markdown.extensions.toc(anchorlink=True)
                markdown.extensions.smarty(smart_quotes=False)
+               markdown.extensions.extra
                markdown_checklist.extension
 docmark: <
 display: public
          protected
          private
 source: true
 warn: true
+search: false
+graph: true
 
-{!README-WenOOF.md!}
+{!../README.md!}