(Closes #522) Updated documentation.

[hiker]

Closes #522.

Note that in the html output the added lines in the grammar for the Intel compiler are not properly aligned, i.e. it looks like (with some non-code block between the two code blocks):

                 | UNFORMATTED = <scalar-default-char-variable>
                 | WRITE = <scalar-default-char-variable>

| DIRECTORY = <file-name-expr>
| DIRSPEC = <scalar-default-char-variable>

I could not figure out how to convince sphinx to keep the spaces that are in the .py file

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 92.25%. Comparing base (9441bde) to head (2f1c1a3).

Additional details and impacted files

@@           Coverage Diff           @@
##           master     #527   +/-   ##
=======================================
  Coverage   92.25%   92.25%           
=======================================
  Files          89       89           
  Lines       13891    13891           
=======================================
  Hits        12815    12815           
  Misses       1076     1076           

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[arporter]

Thanks Joerg. Surprisingly the html renders fine for me :-)
I'll proceed to merge.

[arporter]

I won't bother updating the changelog since this really should have been part of #523 (mea culpa).