FLAP Documentation

Appearance

Changelog ​

v1.2.13 (2026-02-18) ​

Full Changelog

Miscellaneous ​

  • Fix copyright years and update README with authors section (00b5590)

v1.2.12 (2026-02-18) ​

Full Changelog

Documentation ​

  • Overhaul README and restructure VitePress guide (de2da74)

v1.2.11 (2026-02-18) ​

Full Changelog

CI/CD ​

  • Use dynamic repo name in release tarball (5c80c7b)

v1.2.10 (2026-02-18) ​

Full Changelog

Miscellaneous ​

  • Bump FACE and PENF submodules to latest commits (6167ff2)

v1.2.9 (2026-02-18) ​

Full Changelog

Miscellaneous ​

  • Rename hero CTA button from "Get Started" to "Guide" (8be9078)

v1.2.8 (2026-02-18) ​

Full Changelog

Documentation ​

  • Add VitePress guide section and formal-generated API reference (95027e8)

v1.2.7 (2026-02-18) ​

Full Changelog

Documentation ​

  • Add CLAUDE.md with build commands and architecture guide (6edd0d1)
  • Migrate documentation pipeline from FORD to formal + VitePress (46e2542)

Miscellaneous ​

  • Update commit for FACE project (17b0d76)
  • Merge pull request #107 from jvdp1/update_fpm_toml

Update revision for FACE project (5a63132)

  • Improve Markdown output by adding some breaking lines (048d7a4)
  • Additional improvement for easier reading in Markdown files (07fd931)
  • Merge pull request #108 from jvdp1/improve_markdown

Improved Markdown output by adding some line breaks (60ca869)

  • Addition of the default flag --markdown (84e0100)
  • Merge branch 'markdown' into combi (ba2c727)
  • Merge branch 'improve_markdown' into combi (7f86bb4)
  • Merge branch 'improve_markdown' into combi (e64c5c4)
  • Merge pull request #109 from jvdp1/combi

Addition of a default flag --markdown (ead6384)

  • Add release bump and FORD-to-VitePress migration helpers (ce99144)

v1.2.6 (2023-03-30) ​

Full Changelog

Miscellaneous ​

  • Merge tag 'vv1.2.5' into develop

Minor updates after Jacob FPM integration (ca66972)

  • Firt GitHub Action test

Firt GitHub Action test

Why: replace Travis CI (d2185fd)

Fix issues #94 #95: switch from Travis CI to github actions for performing CI and revert back the creation of release tagged version with automatic assets upload.

Trim the verion number from the name of the tarball of the progect: the install script should be now working.

The release assets is uploaded always with the last tag and on the master branch. (76e9e00)

Fix issues #94 #95: switch from Travis CI to github actions for performing CI and revert back the creation of release tagged version with automatic assets upload.

Trim the verion number from the name of the tarball of the progect: the install script should be now working.

The release assets is uploaded always with the last tag and on the master branch. (b41fd60)

  • Add action for upload coverage reports to Codecov (87bba58)
  • Modify makecoverage rule for not deleting gcov files at the end (068239d)
  • Update readme badges (f97f549)
  • Update readme badges (0ea3f5b)
  • Update readme badges (279193e)
  • Update run tests script (84b4de9)
  • Add new tests (d0fcb63)
  • Add conditionals to CI GHA workflow

Add conditionals to CI GHA workflow

Why:

Skip some steps (e.g. deploy/upload) when running workflow locally by means of act. (6bc2072)

  • Add make/deploy doc to gh actions workflow (a4bd287)
  • Add make/deploy doc to gh actions workflow (f1db401)
  • Add GH action workflow for testing alternnative installers/builders (install.sh, make, cmake, FPM) (f881cb6)
  • Move coverage after deploy assets (6ea08a1)
  • Correct install script (b6bcf4a)
  • Update codecov config (6611e8a)
  • Merge branch 'master' into develop (6d9920b)
  • Add optional nature to CLA values

Try to implement enanchement of issue #100

Now beside 'required' attribute of CLA, there is also the attribute 'val_required': if set to .false. (it is .true. by default) the switch can be passed also without a value (even if it has action store) relying on the default value.

Why:

Obtain a more short/concise CLI expecially for output file names.

Side effects:

Expanded asction store CLAs, the optional nature of value can be associated with all type CLAs-storee

Added a (long) test to test all the new possibilities of the CLAs-store. (6d15d2e)

  • Merge branch 'release/v1.2.6' (65c0834)
  • Merge tag 'vv1.2.6' into develop

Add optional nature to CLA values

Try to implement enanchement of issue #100

Now beside 'required' attribute of CLA, there is also the attribute 'val_required': if set to .false. (it is .true. by default) the switch can be passed also without a value (even if it has action store) relying on the default value.

Why:

Obtain a more short/concise CLI expecially for output file names.

Side effects:

Expanded asction store CLAs, the optional nature of value can be associated with all type CLAs-storee

Added a (long) test to test all the new possibilities of the CLAs-store. (6cfd931)

  • Update licenses year (6b55bd8)
  • Merge branch 'master' into develop (495892e)
  • Update run tests scripts (272a5e5)
  • Merge branch 'master' into develop (be5accc)
  • Fix issue #98

Fix issue #98 exploiting -Mbackslah flag of NVFortran.

This change addresses the need by:

  • add a note into readme for pointing out the workaround based on the compiler switch (thanks to @cponder );
  • add an example of NVFortran compilation into the main fobos. (e8a5cbf)

vv1.2.5 (2022-06-28) ​

Full Changelog

Bug fixes ​

  • Fixed src directory so FPM doesn't get confused by the git submodules (67c0f9b)
  • Fix for FPM dependency

point PENF to latest https://github.com/szaghi/PENF.git (5597f53)

Miscellaneous ​

  • Merge tag 'v1.2.4' into develop

Fix issue#82 Help/Version message missing

Fix issue#82 Help/Version message missing: re-add check on negative error flags to catch help/version message invocation (a5cd8f0)

  • Re-add pre-processing flag for unsupported R16P (e92fc64)
  • Merge branch 'master' into develop (6a74267)
  • Fix "command --help" not printing message (738df2c)
  • Merge pull request #91 from ShatrovOA/master

Fix "command --help" not printing message (9205f6f)

  • Added support of group examples

This change will add a possbility to add examples of the correct usage of a group. If group has examples then they will be printed when user passes flag "-h". Otherwise common examples will be printed if they exist. (c741104)

  • Merge pull request #92 from ShatrovOA/master

Added support of group examples (11cb276)

  • Flap_object_t should have .F90 extension

since it has preprocessor directives (3d43349)

  • Added Fortran Package Manager support

updated .gitignore (87d98be)

  • Added FPM dependencies for submodules

(note will update PENF when it is merged to master) (83e2d26)

  • Specify latest version of FACE and fortran_tester (5e3d613)
  • Update README with FPM information (4332987)
  • Merge pull request #96 from jacobwilliams/fpm-support

WIP: FPM support (1957819)

  • Merge pull request #97 from jacobwilliams/fpm-cleanup

fix for FPM dependency (409a84c)

  • Merge branch 'master' into develop (7da98ec)
  • Minor changes in README (800d9be)
  • Update codecov YAML config (52f9ae1)
  • Merge branch 'release/v1.2.5' (1d67977)

v1.2.4 (2020-02-18) ​

Full Changelog

Miscellaneous ​

  • Merge tag 'v1.2.3' into develop

v1.2.3 Fix a new bug in issue#82

Fix a new bug in issue#82. Fully backward compatible. (b42f8b4)

  • Fix issue#82 Help/Version message missing

Fix issue#82 Help/Version message missing: re-add check on negative error flags to catch help/version message invocation (972f989)

  • Merge branch 'release/1.2.4' (e7b6475)

v1.2.3 (2020-02-17) ​

Full Changelog

Miscellaneous ​

  • Merge tag 'v1.2.2' into develop

Fix bug in ignoring unknown clas (a3a23c4)

  • Fix new bug raised in issue#82

The invocation of help usage message was done with a wront dimmy argument. (2f0e8bf)

  • Merge branch 'release/1.2.3' (94a327a)

v1.2.2 (2020-02-10) ​

Full Changelog

Miscellaneous ​

  • Merge tag 'v1.2.1' into develop

Add ignore passed unknown CLAs, fix issue#82

The CLI can now be initialized with a flag for ignoring the passed CLAs that are unknown. An error is still echoed, but the CLI parsing goes on until the end without exit the flow. By default a passed unknown CLA raises a blocking error as in the previous verions.

This change addresses the need by:

add a new option to init method of CLI object, e.g.

call cli%init(..., ignore_unknown_clas=.true.)

A dedicated test has been added, i.e. src/test/flap_test_ignore_unknown_clas.f90

Side effects:

Nothing.

Fully backward compatible. (c95df22)

  • Fix bug in ignoring unknown clas

Fix bug in ignoring unknown clas (37464da)

  • Merge branch 'release/1.2.2' (5a63d9c)

v1.2.1 (2020-02-05) ​

Full Changelog

Miscellaneous ​

  • Merge tag 'v1.2.0' into develop

Add bash completition script output issue#86

Add bash completition script output: given a CLI now it is possibile to save a bash auto completition script that once sourced in a bash shell provides the auto completition capabilities.

Note tha for CLI with multiple CLAs groups (like the git command) the generated script is smart enough to distinguish the CLAs of each group, e.g. the added test with 2 CLAs groups generates the following script:

bash
_completion()
{
  cur=${COMP_WORDS[COMP_CWORD]}
  prev=${COMP_WORDS[COMP_CWORD - 1]}
  if [ "$prev" == "compile" ] ; then
    COMPREPLY=( $( compgen -W "  --compiler -c --flags -f --help -h --version -v" -- $cur ) )
  elif [ "$prev" == "clean" ] ; then
    COMPREPLY=( $( compgen -W " --clean -c --clean-all -ca --help -h --version -v" -- $cur ) )
  else
    COMPREPLY=( $( compgen -W " --help -h --version -v compile clean" -- $cur ) )
  fi
  return 0
}
complete -F _completion flap_test_save_bash_completition
``` ([`0e0c19a`](https://github.com/szaghi/FLAP/commit/0e0c19a9897c3f064f8f2f80d95f0acd019e943e))
- Remove full path from progname in bash completion issue$86

Remove full path from progname in bash completion save and cleaned typos
like *completition* :-) ([`5732d1a`](https://github.com/szaghi/FLAP/commit/5732d1ac0cfaeabe9a80441b1d6bb1392fcb047b))
- Improve bash completion issue[#86](https://github.com/szaghi/FLAP/issues/86)

Improve bash completion: add completion for CLA with choices ([`2324054`](https://github.com/szaghi/FLAP/commit/23240547dcdeda84288e67467766acf496258033))
- Merge branch 'feature/improve-bash-completion' into develop ([`1c661b6`](https://github.com/szaghi/FLAP/commit/1c661b6f417d73241c11a7ee23bc9603873ad4fa))
- Update cmake config ([`0f3f205`](https://github.com/szaghi/FLAP/commit/0f3f20557674332a01aefb625b4bd6b212ac50aa))
- Bash completition non working, but clean ([`26aa4c3`](https://github.com/szaghi/FLAP/commit/26aa4c34abcfbf9048cf690bce7f9627b9a18ff5))
- Merge remote-tracking branch 'origin/master' into cmake ([`31f7aed`](https://github.com/szaghi/FLAP/commit/31f7aedbec3cc2ed75a58d72f85b49f36bfa6b23))
- Merge pull request [#88](https://github.com/szaghi/FLAP/issues/88) from kostyfisik/cmake

[WIP] update cmake config ([`de69af9`](https://github.com/szaghi/FLAP/commit/de69af90c738fd77f51bc62b6e0e9cc50bc1f1f1))
- Update submodules ([`88488c8`](https://github.com/szaghi/FLAP/commit/88488c8c902177a8ee01ac5c6af9b319c464fb60))
- Add ignore passed unknown CLAs, fix issue[#82](https://github.com/szaghi/FLAP/issues/82)

The CLI can now be initialized with a flag for ignoring the passed CLAs
that are unknown. An error is still echoed, but the CLI parsing goes on
until the end without exit the flow. By default a passed unknown CLA
raises a blocking error as in the previous verions.

This change addresses the need by:

add a new option to `init` method of CLI object, e.g.

call cli%init(..., ignore_unknown_clas=.true.)

A dedicated test has been added, i.e.
`src/test/flap_test_ignore_unknown_clas.f90`

Side effects:

Nothing. ([`4f806e5`](https://github.com/szaghi/FLAP/commit/4f806e5d0cf34b5d6dcca16cc1fa957700f6afaf))
- Update travis config ([`2ced75a`](https://github.com/szaghi/FLAP/commit/2ced75a5602c8f60333e4546c15518c1bb2c282c))
- Add ignore passed unknown CLAs, fix issue[#82](https://github.com/szaghi/FLAP/issues/82)

(Merge branch 'release/1.2.1')

The CLI can now be initialized with a flag for ignoring the passed CLAs
that are unknown. An error is still echoed, but the CLI parsing goes on
until the end without exit the flow. By default a passed unknown CLA
raises a blocking error as in the previous verions.

This change addresses the need by:

add a new option to `init` method of CLI object, e.g.

call cli%init(..., ignore_unknown_clas=.true.)

A dedicated test has been added, i.e.
`src/test/flap_test_ignore_unknown_clas.f90`

Side effects:

Nothing. ([`d2c3be9`](https://github.com/szaghi/FLAP/commit/d2c3be916a978b717048c1a77d486f8b6e0c0992))
- Merge branch 'release/1.2.1' ([`eec9467`](https://github.com/szaghi/FLAP/commit/eec946759d9e0a03c5e260825096a76c7b2cf1af))

## [v1.2.0](https://github.com/szaghi/FLAP/tree/v1.2.0) (2019-07-12)
[Full Changelog](https://github.com/szaghi/FLAP/compare/v1.1.9...v1.2.0)
### Miscellaneous
- Merge tag 'v1.1.9' into develop

Fix duplicated passed CLAs bug issue[#85](https://github.com/szaghi/FLAP/issues/85)

Fix the bug regarding duplicated passed CLAs: if the multiple instances
of the same non positional CLA is passed to the CLI an error is raised. ([`def9bbe`](https://github.com/szaghi/FLAP/commit/def9bbeff5126020b20b04ba588eb7ae5aad983c))
- Clean sources and add man/markdown tests

Clean sources and add two new tests for the `save_man_page` and
`save_usage_to_markdown` methods. ([`bd4b342`](https://github.com/szaghi/FLAP/commit/bd4b3427f4caddd52a593a874b29d6cc7d7ef527))
- Add bash completition script output issue[#86](https://github.com/szaghi/FLAP/issues/86)

Add bash completition script output: given a CLI now it is possibile to
save a *bash auto completition script* that once *sourced* in a bash
shell provides the auto completition capabilities.

Note tha for CLI with multiple CLAs groups (like the `git` command) the
generated script is smart enough to distinguish the CLAs of each group,
e.g. the added test with 2 CLAs groups generates the following script:

```bash
_completion()
{
  cur=${COMP_WORDS[COMP_CWORD]}
  prev=${COMP_WORDS[COMP_CWORD - 1]}
  if [ "$prev" == "compile" ] ; then
    COMPREPLY=( $( compgen -W "  --compiler -c --flags -f --help -h --version -v" -- $cur ) )
  elif [ "$prev" == "clean" ] ; then
    COMPREPLY=( $( compgen -W " --clean -c --clean-all -ca --help -h --version -v" -- $cur ) )
  else
    COMPREPLY=( $( compgen -W " --help -h --version -v compile clean" -- $cur ) )
  fi
  return 0
}
complete -F _completion flap_test_save_bash_completition
``` ([`e6f25ce`](https://github.com/szaghi/FLAP/commit/e6f25ce04474a1770d0c911f54fc9981fa85b9b2))
- Merge branch 'feature/add-save-bash-completition-issue[#86](https://github.com/szaghi/FLAP/issues/86)' into develop ([`40f12ab`](https://github.com/szaghi/FLAP/commit/40f12ab5d8de0490883c4aa7a72240a233fd2479))
- Merge branch 'release/1.2.0' ([`9784ea0`](https://github.com/szaghi/FLAP/commit/9784ea0b3a891fcb69bfa216b1b7a043930b24e7))

## [v1.1.9](https://github.com/szaghi/FLAP/tree/v1.1.9) (2019-07-08)
[Full Changelog](https://github.com/szaghi/FLAP/compare/v1.1.8...v1.1.9)
### Bug fixes
- Fix travis issue ([`0069a3b`](https://github.com/szaghi/FLAP/commit/0069a3b8026db5c1331e0b2adfce92250eb1846d))

### Miscellaneous
- Merge tag 'v1.1.8' into develop

Add first support for ANSI color/style

Stable release, fully backward compatible. ([`4d9d573`](https://github.com/szaghi/FLAP/commit/4d9d57301c83c7b69770ae0c18dd9dc6e3803e95))
- Merge branch 'master' into develop ([`6187151`](https://github.com/szaghi/FLAP/commit/618715142d12ef96cf9a552aef1b5f92d3863e3f))
- Trim out dangerous recursive git clone/update ([`86b24e5`](https://github.com/szaghi/FLAP/commit/86b24e5b7fc048f388aab11e217b047b4075dea1))
- Update submodule ([`3243f11`](https://github.com/szaghi/FLAP/commit/3243f11b9ca4cdb932a6d514eb42415e9aad5eaa))
- Merge branch 'master' into develop ([`f5448af`](https://github.com/szaghi/FLAP/commit/f5448af59ca877bb6dc856cdff71a2e7c240ac11))
- Update submodules ([`0563435`](https://github.com/szaghi/FLAP/commit/05634358b16927821874001214464f22684a8a5c))
- Merge branch 'master' into develop ([`b104123`](https://github.com/szaghi/FLAP/commit/b104123965ab230b331d8c099c0417295586a71c))
- Update submodules ([`578eab4`](https://github.com/szaghi/FLAP/commit/578eab4698339651e5a41c6eeb34be83987fa050))
- Sanitize preprocessing flags ([`1d19123`](https://github.com/szaghi/FLAP/commit/1d19123644563af876addb8d0f510fba1e8991ed))
- Added directives to build FACE ([`e9de614`](https://github.com/szaghi/FLAP/commit/e9de61459a533adaa04e9aef3c7a47414b81bd87))
- Fixed test executable names
Added FACE build directive
Added face.o as dependency for flap_command_line_argument_t.o target ([`2b8a940`](https://github.com/szaghi/FLAP/commit/2b8a94058ebdf2c1efaf6d4f56d16b12fe7410e3))
- Merge pull request [#81](https://github.com/szaghi/FLAP/issues/81) from apthorpe/master

Updates to CMake and makefile build process to support FACE & new test names ([`033549b`](https://github.com/szaghi/FLAP/commit/033549b1d2b05acc3a80b132daa41478dbea0f00))
- Update FACE for cmake support ([`a23c91f`](https://github.com/szaghi/FLAP/commit/a23c91fc94a7195c22c8ca71463a7311f4d2c7ef))
- Merge pull request [#83](https://github.com/szaghi/FLAP/issues/83) from pdebuyl/master

update FACE for cmake support ([`026a336`](https://github.com/szaghi/FLAP/commit/026a3367f85ed9f9afc94d210bd25e25dad27a9b))
- Add FACE libs to cmake file ([`c609ff0`](https://github.com/szaghi/FLAP/commit/c609ff0b7bb576f883db1095c101820ebaea9d4c))
- Merge pull request [#84](https://github.com/szaghi/FLAP/issues/84) from pdebuyl/master

add FACE libs to cmake file ([`9ef0bd8`](https://github.com/szaghi/FLAP/commit/9ef0bd82a1c9ff9563d5a7f7907dbd79186bcad4))
- Update submodules ([`7feb688`](https://github.com/szaghi/FLAP/commit/7feb688f94b16800e9b883bcdec9a0a3cc86c70a))
- Merge branch 'master' into develop ([`735f7b7`](https://github.com/szaghi/FLAP/commit/735f7b72560f3b795d3fe5505b1a412f7a19f981))
- Fix duplicated passed CLAs bug[#85](https://github.com/szaghi/FLAP/issues/85)

Fix the bug regarding duplicated passed CLAs: if the multiple instances
of the same non positional CLA is passed to the CLI an error is raised. ([`5ef92b6`](https://github.com/szaghi/FLAP/commit/5ef92b641882419cfca2a450d2fd557b53e8c47c))
- Merge branch 'release/1.1.9' ([`38908ab`](https://github.com/szaghi/FLAP/commit/38908ab1106adcb5301453f0185a410e88c96d98))

## [v1.1.8](https://github.com/szaghi/FLAP/tree/v1.1.8) (2017-03-07)
[Full Changelog](https://github.com/szaghi/FLAP/compare/v1.1.7...v1.1.8)
### Miscellaneous
- Remove -fdefault-real-8 option ([`819d5da`](https://github.com/szaghi/FLAP/commit/819d5dae014aeb98235d7bf9a1bb8ce2db86c453))
- Change MESSAGE to non-erroring mode ([`d78bda7`](https://github.com/szaghi/FLAP/commit/d78bda7131629c567482c87c188d144a694111bb))
- Update cmake and fortran_tester files for cmake build ([`99e7da9`](https://github.com/szaghi/FLAP/commit/99e7da93c6dee6d1e3d8d242646491818b30439a))
- Merge pull request [#72](https://github.com/szaghi/FLAP/issues/72) from pdebuyl/cmake_fortran_tester

Cmake changes to allow fortran tester ([`9e60188`](https://github.com/szaghi/FLAP/commit/9e6018852452fed4d1315fe83f21550d8fb4b0a9))
- Fix bug on R16P precision

Fix bug on R16P precision: CLA object missed a R16P TBP declaration. ([`9d42d40`](https://github.com/szaghi/FLAP/commit/9d42d406c55c32ae13f30a87ca556eec0c819fdd))
- Update third parties ([`91b186f`](https://github.com/szaghi/FLAP/commit/91b186f0b001eaf445a717b1a5252f61fc97506e))
- Add FACE third party ([`b40ce1b`](https://github.com/szaghi/FLAP/commit/b40ce1be3bd628ea744e67c67e86ea89ed12d765))
- Add first support for ANSI color-style

Add first support for ANSI color-style

This is an embryonic support: for now, only *some parts* of error and
help messages can be colorized/stylized.

Why:

Make better the library.

This change addresses the need by:

Add new dummies for error/help color/style into `cli%init` and `cli%add` methods.

Side effects:

+ add test for the new ansi color-style support;
+ rename tests program prefixing with `flap_` basename;
+ general *sanitize* of SLOCS touched. ([`ba911ec`](https://github.com/szaghi/FLAP/commit/ba911ec83e5c148fc1eb673f31cfd6306b705b66))
- Merge branch 'feature/add-ansi_color_style_support-[#75](https://github.com/szaghi/FLAP/issues/75)' into develop ([`699d0e8`](https://github.com/szaghi/FLAP/commit/699d0e86644cecefc7dde132fd833439daab0fa4))
- Merge branch 'release/1.1.8' ([`3cf3d9e`](https://github.com/szaghi/FLAP/commit/3cf3d9e3a1bf2dd840fbeba412f4085d940b006d))

## [v1.1.7](https://github.com/szaghi/FLAP/tree/v1.1.7) (2016-10-25)
[Full Changelog](https://github.com/szaghi/FLAP/compare/v1.1.6...v1.1.7)
### Miscellaneous
- Merge tag 'v1.1.6' into develop

Ship install script separately

Stable releaase, fully backward compatible. ([`a49f846`](https://github.com/szaghi/FLAP/commit/a49f846ed71cbfc30e61cbcf573e4022f89c05f0))
- Ammend README ([`6718807`](https://github.com/szaghi/FLAP/commit/6718807b5c9cdfc951432217fcb9aa4ea3210929))
- Merge branch 'master' into develop ([`e66d35a`](https://github.com/szaghi/FLAP/commit/e66d35a5d01974f0029a3b7a7cdbca997b68e104))
- Amend fobos ([`d532e2d`](https://github.com/szaghi/FLAP/commit/d532e2ddaa3b292d92c7c9f556ff93c12bad69f1))
- Update PENF ([`6ff1e3a`](https://github.com/szaghi/FLAP/commit/6ff1e3a1217f8322cc8f8d57c509bbddcf9101ef))
- Fix bug [#71](https://github.com/szaghi/FLAP/issues/71) group default value for not invoked group

Short description

Querying the default values of CLAs belonging to not invoked group
returns unpredictable results instead of the default value set
initializing the CLI.

Why:

Sane fallback.

This change addresses the need by:

Eliminating the check if the group has been invoked or not.

Side effects:

Nothing, but a warning could be like to be added in the case a not
invoked group is queried. ([`6c2cf0c`](https://github.com/szaghi/FLAP/commit/6c2cf0ccad14d097c70d99c0998d1ad4c66ba196))

## [v1.1.6](https://github.com/szaghi/FLAP/tree/v1.1.6) (2016-10-06)
[Full Changelog](https://github.com/szaghi/FLAP/compare/v1.1.5...v1.1.6)
### Miscellaneous
- Merge tag 'v1.1.5' into develop

Add tag version to release archive name

Stable release, fully backward compatible. ([`b842bd7`](https://github.com/szaghi/FLAP/commit/b842bd70dd65343e7758556bd29f4c73846076c2))
- Move scripts into their own new-home ([`753837a`](https://github.com/szaghi/FLAP/commit/753837ae2426521d6e7e3136fa3fdfca374b5049))
- Update doc ([`9a79004`](https://github.com/szaghi/FLAP/commit/9a790046a8165dd4fa0f5067648f26fb739e4ee3))
- Merge branch 'release/1.1.6' ([`1cacf46`](https://github.com/szaghi/FLAP/commit/1cacf46cd3f4ca31bc68c1c20dc6ac16e88186f0))

## [v1.1.5](https://github.com/szaghi/FLAP/tree/v1.1.5) (2016-10-05)
[Full Changelog](https://github.com/szaghi/FLAP/compare/v1.1.4...v1.1.5)
### Miscellaneous
- Merge tag 'v1.1.4' into develop

Add install.sh script

Stable release, fully backward compatible. ([`8932100`](https://github.com/szaghi/FLAP/commit/89321002028dd8e9c9d71c0b5732d69a459fe8e2))
- Add tag version to release archive deployed ([`74152c6`](https://github.com/szaghi/FLAP/commit/74152c6a217582c66bf8282a1566bb28b27c359d))
- Merge branch 'release/1.1.5' ([`86d9a42`](https://github.com/szaghi/FLAP/commit/86d9a42d83008809a52370babd2c2a1e0f2747ec))

## [v1.1.4](https://github.com/szaghi/FLAP/tree/v1.1.4) (2016-10-05)
[Full Changelog](https://github.com/szaghi/FLAP/compare/v1.1.3...v1.1.4)
### Miscellaneous
- Merge tag 'v1.1.3' into develop

Avoid tarbomb of release archive deflating

Stable release, fully backward compatible. ([`0f15376`](https://github.com/szaghi/FLAP/commit/0f153761fd2c12012f229541e2b8980c98bbb551))
- Add install script ([`7b96c06`](https://github.com/szaghi/FLAP/commit/7b96c0630492c8fe89ab304cccb9ee8bb6ce8a72))
- Update README with install script doc ([`e48da85`](https://github.com/szaghi/FLAP/commit/e48da854c9989f61c85744fdcf7cff2569e4cc61))
- Merge branch 'release/1.1.4' ([`4a01080`](https://github.com/szaghi/FLAP/commit/4a01080f19ee272ed7d6aa5b7fe81584ac48930a))

## [v1.1.3](https://github.com/szaghi/FLAP/tree/v1.1.3) (2016-10-05)
[Full Changelog](https://github.com/szaghi/FLAP/compare/v1.1.2...v1.1.3)
### Miscellaneous
- Merge tag 'v1.1.2' into develop

Test new Travis CI release deploy, stable release, fully backward
compatible. ([`6bcbc62`](https://github.com/szaghi/FLAP/commit/6bcbc62bc013c349759c01d43d11e91ddd777b20))
- Avoid tarbomb after deflating release archive ([`e02a4ea`](https://github.com/szaghi/FLAP/commit/e02a4eaa9e2c518e28eeab0e9fef994c7499a230))
- Merge branch 'release/1.1.3' ([`83e7127`](https://github.com/szaghi/FLAP/commit/83e712717397e7b054bfa2597680e5eb4a00f92b))

## [v1.1.2](https://github.com/szaghi/FLAP/tree/v1.1.2) (2016-10-05)
[Full Changelog](https://github.com/szaghi/FLAP/compare/v1.1.1...v1.1.2)
### Miscellaneous
- Merge tag 'v1.1.1' into develop

Fix bug of issue[#69](https://github.com/szaghi/FLAP/issues/69), stable release, fully backward compatible. ([`7105f43`](https://github.com/szaghi/FLAP/commit/7105f43e8b61959bad6c1d37af9e986f9fddcc8d))
- Add Travis CI support for a better release deploy ([`d78d1db`](https://github.com/szaghi/FLAP/commit/d78d1db935d553b6257eae04ac2bf695b3947c90))
- Merge branch 'release/1.1.2' ([`a4d6c3d`](https://github.com/szaghi/FLAP/commit/a4d6c3d97ebb037f3e651255cc1b96835a7900d8))

## [v1.1.1](https://github.com/szaghi/FLAP/tree/v1.1.1) (2016-10-03)
[Full Changelog](https://github.com/szaghi/FLAP/compare/v1.1.0...v1.1.1)
### Bug fixes
- Fix issue[#67](https://github.com/szaghi/FLAP/issues/67) ([`a302a6d`](https://github.com/szaghi/FLAP/commit/a302a6de7db19f84ab643446ffff085bb3bdf131))

### Miscellaneous
- Merge tag 'v1.1.0' into develop

Add Olle markdown manpage, stable release, fully backward compatible. ([`88b5967`](https://github.com/szaghi/FLAP/commit/88b59672c14c90eb5ed7b62cd2b22ee37c07a4e3))
- Update licenses ([`fd0db56`](https://github.com/szaghi/FLAP/commit/fd0db56cd93a09618a167ab28f5fa50298f93532))
- Merge branch 'master' into develop ([`1340d68`](https://github.com/szaghi/FLAP/commit/1340d682619382843451427244eb33857718387b))
- Update to last PENF ([`4366910`](https://github.com/szaghi/FLAP/commit/4366910d306853c5aede3d01bcd7cf7275c3a787))
- Rely on link instead of FoBiS recursion

Rely on link instead of FoBiS recursion ([`45a143e`](https://github.com/szaghi/FLAP/commit/45a143e4d2d971908111ac66ff97d8d0e195e1fc))
- Update travis config ([`689b750`](https://github.com/szaghi/FLAP/commit/689b750beb9710ee116fa24744e1d6bb816410b3))
- Point PENF submodule to master branch ([`2ca4a07`](https://github.com/szaghi/FLAP/commit/2ca4a071a531aa4f1225f5d2b3e819047c6bc57c))
- Update PENF submodule ([`a662930`](https://github.com/szaghi/FLAP/commit/a66293038d8f99500c9ab3f5f78a520ef34342c8))
- Merge branch 'master' into develop ([`c1124f3`](https://github.com/szaghi/FLAP/commit/c1124f3178e2b5f3af3ff686a8a7b4fa24b0b3d3))
- Change build to support new PENF ([`c285115`](https://github.com/szaghi/FLAP/commit/c285115d6431b4163cdbcfffbfe6821a9b026579))
- Update makedoc ([`c47d084`](https://github.com/szaghi/FLAP/commit/c47d0848477ce22d258719034e4564c97e87a582))
- Add (blindly) Victor's cmake setup... hope to work ([`a219aa2`](https://github.com/szaghi/FLAP/commit/a219aa2833ad5388fc0ed483318a9f21cf7d9b9c))
- Update makefile ([`6a62748`](https://github.com/szaghi/FLAP/commit/6a62748a7d4e133b60ae8f1468322a724ba8f0a7))
- Update doc ([`9a6737e`](https://github.com/szaghi/FLAP/commit/9a6737e4de34010fd5a0cf1b58556dfd1a0ac88c))
- Add victor's updates on CMake setup ([`1eadac5`](https://github.com/szaghi/FLAP/commit/1eadac5b525478fb188853e97d5d75b23c01b154))
- Fix bug of issue[#69](https://github.com/szaghi/FLAP/issues/69)

@victorsndvg discovered a subtle bug. From his report:

I think there is a bug (in release mode) using FLAP while parsing CLI multiple times.
If I run the code below, the second time that I call `parse(error)`, `error` value is not initialized from the `parse()` procedure.
```fortran
     type(Command_Line_Interface)  :: cli
     integer :: error
     cli%parse(error)
     ...
     cli%free()
     ...
     cli%parse(error)
     ...
     cli%free()

Why:

The bug do not free the CLI properly and do not return the correct (null) code the other times it is parsed.

This change addresses the need by:

@victorsndvg provided a perfect patch:

First, force a successful error code at the beginning of the parse() procedure in this line: https://github.com/szaghi/FLAP/blob/master/src/lib/flap_command_line_interface_t.F90#L519

fortran
    if(present(error)) error = 0  ! <- New line
    if (self%is_parsed_) return
    ...

And finally, set is_parsed_ variable to .false. in the free() procedure.

Side effects:

Nothing. (cee4711)

  • Merge branch 'hotfix/1.1.1' (e3999bd)

v1.1.0 (2016-05-09) ​

Full Changelog

Miscellaneous ​

  • Merge tag 'v1.0.6' into develop

Fix small bug into tokenize, stable release, fully backward compatible. (f37f89f)

  • Add Olle patches

Add Olle patches: add them manually due to some issues on line length (Olle allows to exceeed 132 characters). (6cf426c)

  • Merge branch 'release/1.1.0' (5d4dfa8)

v1.0.6 (2016-05-03) ​

Full Changelog

Miscellaneous ​

  • Merge tag 'v1.0.5' into develop

Fix PENF issue with ifort, stable release, fuly backward compatible. (994d4f2)

  • Add more control of default output units

  • Add optional arguments to init method

    • usage_lun specify optional alternate output unit other than stderr
    • version_lun specify optional alternate version/license output unit other than stdout
    • error_lun specify optional alternate error info/message output unit other than stderr

  • Fixes #61

  • Will allow users to use MPI without --help or --version exploding with output when running on many MPI ranks (06da04f)

  • Merge pull request #62 from zbeekman/error-help-unit-specify

Fixes #61: More output control (414e265)

  • Merge branch 'master' into develop (14c72e1)
  • Change tokenize behaviour

Change tokenize behaviour: if the delimiter has higher number of chars than the input string, only 1 token is returned containing the input string instead of char(0) as previously.

Why:

More robust fail-safe when corner-cases happen, e.g. delimiter bigger than input string.

Side effects:

Unknowns. (dbfcc77)

  • Merge branch 'hotfix/1.0.6' (04c7d9a)

v1.0.5 (2016-04-05) ​

Full Changelog

Miscellaneous ​

  • Merge tag 'v1.0.4' into develop

Stable release, fully backward compatible.

Update to new PENF version.

Enabled for IBM XLF. (78e93d2)

  • Fix penf issue #60 with ifort (4bfea96)
  • Merge branch 'master' into develop (b39784a)
  • Merge branch 'release/1.0.5' (af963b9)

v1.0.4 (2016-03-25) ​

Full Changelog

Miscellaneous ​

  • Merge tag 'v1.0.3' into develop

Fix bug on CLA raise error switch unknown, stable release, fully backward compatible. (d23b835)

  • Modify makefile and sources for IBM XLF

Modify makefile and sources for IBM XLF (07ba726)

  • Update IR_Precision (c28d89f)
  • Update IR_Precision to the new PENF (779b002)
  • Update new PENF version (55e7096)
  • Merge branch 'feature/enable-ibm-xlf' into develop (91f5700)
  • Merge branch 'release/1.0.4' (d7c64fb)

v1.0.3 (2016-03-24) ​

Full Changelog

Miscellaneous ​

  • Merge tag 'v1.0.2' into develop

Fix issue#58, stable release, fully backward compatible. (b439c97)

  • Fix a minor bug on raise error unknown switch

Fix a minor bug on raise error unknown switch (b57b287)

v1.0.2 (2016-03-24) ​

Full Changelog

Miscellaneous ​

  • Merge tag 'v1.0.1' into develop

Fix minor bug on error messages truncation after 1.0.0 refactoring, stable release fully backward compatible with 1.0.0 master branch. (ac60c91)

  • Update fobos rule for coverage analysis (1c240f7)
  • Merge branch 'master' into develop (f989b75)
  • Issue with API doc... ask to Chris! (915e680)
  • Merge branch 'master' into develop (fc52021)
  • Fix issue#58 bug on parse defaults

Fix issue#52 bug on parse defaults: defaults list are wrongly parsed, add a sanitize before use defaults.

Concurrently add:

  • fix issue#57 on "cosmetic" help messages for hidden CLA;
  • make the call to cli%parse optional: when call cli%get for the first time the CLI parsed status is checked an, if necessary, cli%parse is automatically called;

Minor API changes: cli%get and cli%get_varying now accept also string args for passing arguments by string to cli%parse. (6756314)

  • Merge branch 'hotfix/1.0.2' (cc11876)

v1.0.1 (2016-03-23) ​

Full Changelog

Miscellaneous ​

  • Merge conflicts before merge release 1.0.0 (9917a24)
  • Fix error messages trunction

Fix error messages trunction: after the 1.0.0 code refactorig the error messages were truncated... (15a3927)

  • Merge branch 'hotfix/1.0.1' (a4d0cec)

v1.0.0 (2016-03-23) ​

Full Changelog

Miscellaneous ​

  • Merge tag 'vcorrect-cli-free-method' into develop

Stable release, fully backward compatible. Fix bug on cli%free method. (8dcbbe8)

  • Minor changes (0638a68)
  • Merge pull request #53 from victorsndvg/makefile_fix

Minor changes (309c75b)

  • Increase args and examples static length when compiling with GNU compilers to allow the use of long paths (df906b4)
  • Merge pull request #54 from victorsndvg/master

Increase args and examples static length (6d04ae7)

  • Merge branch 'master' of github.com:szaghi/FLAP (a9e49c7)
  • Merge branch 'master' into develop (523162c)
  • Remove changelog from main module doc (643c5a5)
  • Sanitize docstrings (235cde3)
  • Trying google analytics (9a36d34)
  • Purge google analytics (dedeb06)
  • Improve makefile

Improve makefile:

  • create static library (libflap.a);
  • create tests;
  • untested support for IBM XL Fortran;

To create static library type

make STATIC=yes (3200ee6)

  • Merge conflicts before merge feature/refactor-library-names-and-makefile (6abb129)

Refactoring ​

  • Refactor library names

Refactor library names:

  • split library into multiple modules to adhere 1-class-1-module rule;
  • sanitize naming convention accordingly to my zen;
  • not backward compatible: API changed! (83ea5cb)

vcorrect-cli-free-method (2015-10-08) ​

Full Changelog

Miscellaneous ​

  • Merge tag 'v0.6.4' into develop

Add more clear error message for logical-choices abuse, stable release, fully backward compatible. (cce3916)

  • Update the name of tests programs (8d1f6a4)
  • Update .gitignore and .travis.yml (800fc6e)
  • Some minor changes related with the following issue:

https://github.com/szaghi/FLAP/issues/48 (6b4f1c7)

  • Some minor fixes after to compile with IBM XL Fortran for Linux, V14.1

    Deleted "elemental" in fuction Upper_Case due to the following XLF following compiler error:

    "1513-209 (S) The result of an elemental function must be a nonpointer, nonallocatable scalar, and its type parameters must be constant expressions."

This behaviour also occurs in Lib_VTK_IO:

https://github.com/victorsndvg/Lib_VTK_IO/commit/226c38e3e52051371e540b5fde66bcde16f5648f#diff-6952d71b75ad07086220a941f2a61ba7L538 (c9860e7)

  • Bug on Intel Fortran Compiler 15.0.2?

I get the following error:

forrtl: severe (194): Run-Time Check Failure. The variable 'var$11762' is being used in '/home/.../FLAP/src/Data_Type_Command_Line_Interface.F90(2229,5)' without being defined Image PC Routine Line Source Test_Driver_Neste 0000000000522EDA data_type_command 2229 Data_Type_Command_Line_Interface.F90 Test_Driver_Neste 0000000000404E00 MAIN__ 39 Test_Driver_Nested.f90 Test_Driver_Neste 000000000040378E Unknown Unknown Unknown libc.so.6 00007F620A933EC5 Unknown Unknown Unknown Test_Driver_Neste 0000000000403689 Unknown Unknown Unknown

Solution:

Change the line 2229: clasg_list_new(0:Ng-1) = cli%clasg(0:Ng-1)

With: do gi = 0, Ng-1 clasg_list_new(gi) = cli%clasg(gi) enddo

I cannot write a small piece of code to reproduce the problem. (a1b75df)

Fix bug on cli%free method.

Why:

Free method free all cli%clasg array elements that starts from 0 not 1.

This change addresses the need by:

Modify the loop of clasg%free starting from 0.

Side effects:

Nothing. (7049686)

  • Merge branch 'hotfix/correct-cli-free-method' (b8a5b4c)

v0.6.4 (2015-09-11) ​

Full Changelog

Miscellaneous ​

  • Merge branch 'hotfix/0.6.3' (ba327ba)
  • Merge tag 'v0.6.2' into develop

Submodularize IR_Precision, stable release, fully backward compatible. (80d47df)

  • Merge tag 'v0.6.3' into develop

Sanitize submodules, stable release, fully backward compatible. (62f53cc)

  • Use makedoc.sh template of all other fortran projects (68c65a5)
  • Update makedoc.sh (2a254f4)
  • Merge branch 'develop' (80d83d1)
  • Modify makedoc.sh script in order to make it more safe (d7e0592)
  • Add more clear error for logical-choices bad usage

Add a more clear error for bad usage choices option when coupled with logical options.

Why:

When adding a logical option to the CLI it is not possible to prevent the user to use the choices optional argument, that is intended to be used for limiting the range of admissible values of the passed option. However, logical type is be definition limited to only 2 values, namely .true. or .false., thus it is meaningless to use the choices optional argument with logical option.

This change addresses the need by:

Add a more clear error message when the user try to retry the value of a logical option for which a choices set has been defined.

Side effects:

Nothing.

Unrelated modifications:

Add the lib and tests directories inside src one for a better separation of the library sources and the tests suite ones. The fobos file has been modified accordingly. (b59fcd5)

  • Merge branch 'release/0.6.4' (9adeb7a)

v0.6.3 (2015-07-28) ​

Full Changelog

Miscellaneous ​

  • Sanitize submodules

Sanitize git submodules: put submodules into external directory outside src and symlink only the necessary sources. (0300767)

v0.6.2 (2015-07-27) ​

Full Changelog

Miscellaneous ​

  • Add more error checks (4f1dab5)
  • Commit before submodularize IR_Precision (0d95738)
  • Submodularize IR_Precision (ad0fd70)
  • Merge branch 'release/0.6.2' (2b3095e)

v0.6.1 (2015-07-02) ​

Full Changelog

Miscellaneous ​

  • Fix deploy.sh script

  • should work now

  • exposed token should be resolved

  • better informational printing and error notifications

  • .travis.yml updated under the assumption that @szaghi moved to web interface for encrypted variables

  • removed empty .gitignore added when demonstrating security breach (8829f2f)

  • Merge branch 'zbeekman-deployment-fix' (da82572)

  • Add gitter badge (de9b04a)

  • Fix issue#37

Fix issue#37 introducing new action store*. This allow to invoking a named option storing a valua without passing also the value. If no value is passed it is retrieved from the eventual default value. If no default value is set, the method get can fail. (2cf9c33)

v0.6.0 (2015-07-01) ​

Full Changelog

Miscellaneous ​

  • Try to fix my bad merging workflow... thank zaak! (66169f3)

Testing ​

  • Testing if @szaghi needs to revoke his GH token or if Travis-CI has a security hole... (c6d7f7e)

v0.5.3 (2015-07-01) ​

Full Changelog

Miscellaneous ​

v0.5.2 (2015-06-26) ​

Full Changelog

Miscellaneous ​

  • Commit before merge pull#35 (70769e9)
  • Use GFORTRAN rather than -DGNU (4c2f39b)
  • Merge pull request #35 from zbeekman/fix-GNU-define

use GFORTRAN rather than -DGNU (80061d4)

  • Merge remote-tracking branch 'origin/master' (5e41b40)
  • Fix issue#34

Fobos was not up-to-date, using .f90 instead of .F90 (1b4eaf6)

v0.5.1 (2015-06-10) ​

Full Changelog

Miscellaneous ​

  • Try to fix github pages deploying issue (c851adb)
  • Correct bug in parse_clasg procedure (ddcd2b4)

v0.5.0 (2015-06-05) ​

Full Changelog

Miscellaneous ​

  • Update Changelog (06a9d8a)
  • Try to fix TravisCI issue (f0472e5)
  • Correct grammar of some comments (49c7791)
  • Add automatic generation of MAN PAGE issue#22 (134242c)

v0.4.0 (2015-06-01) ​

Full Changelog

Miscellaneous ​

  • Update README (c5db7bf)
  • Implement support for environment variables (bd86a09)

v0.3.0 (2015-05-29) ​

Full Changelog

Miscellaneous ​

  • Backup before major modification of parse_clasg method (8fe348d)
  • Implement fake arguments from string, issue#28 (8c23e0f)

v0.2.0 (2015-05-26) ​

Full Changelog

Miscellaneous ​

  • Correct readme (85dd1df)
  • Correct readme (7e259df)
  • Implement mutually exclusive rules for CLA(s group) (64c1d11)

v0.1.0 (2015-05-22) ​

Full Changelog

Miscellaneous ​

  • Support nested subcommands by groups of CLAs (cf449d6)

v0.0.7 (2015-04-22) ​

Full Changelog

Miscellaneous ​

v0.0.6 (2015-04-17) ​

Full Changelog

Miscellaneous ​

v0.0.5 (2015-04-15) ​

Full Changelog

Miscellaneous ​

v0.0.4 (2015-04-15) ​

Full Changelog

Miscellaneous ​

v0.0.3 (2015-04-07) ​

Full Changelog

Miscellaneous ​

  • Correct README (bb65d18)
  • Eradicate Version history from readme (0798cf2)
  • Move status badge (acd1690)
  • Correct license badge for FORD (30e434a)
  • Add new IR_Precision readme (8e87946)
  • Improve error trapping of get method (ebb7878)

v0.0.2 (2015-02-17) ​

Full Changelog

Miscellaneous ​

v0.0.1 (2014-10-24) ​

Miscellaneous ​

  • Start to FLAP (d2651d3)
  • README improved (b0a7ee4)
  • README improved (df3a3a6)
  • README improved (4a0317a)
  • README improved (354f32b)
  • README improved (219303e)
  • README improved (c0c88bf)
  • README improved (af23a2f)
  • README improved (e6043fd)
  • README improved (d9698ae)
  • README improved (ce5cdf2)
  • Added support for choices: list of allowable values (e489e5f)
  • Added support for positional CLA (c9c72be)
  • Moved consistenc checks into add and parse methods (7caf5de)
  • Added link to POG example (c4d2921)
  • Added support for multiple valued (list) CLA (2cb64c9)
  • Make args_sep private: no user customization for args_sep (69ff44c)
  • Implement automatic help/version CLAs adding (a829847)

Refactoring ​

  • Refactored modules: move Type_Command_Line_Argument into Data_Type_Command_Line_Interface as private derived type (eac8caa)