@tomaszkacprzak , where do the `reconvolution_validation` and `test_convergence` programs fall into this pattern, and what do they do?  I think we need those to be documented too.

This doesn't need to be in a text file in the repository... This Pull Request is a permanent record of the contents of this branch and what they do, which is why a written description of code changes as provided in, e.g., #448 , is a perfectly acceptable record.  But there does need to be some record, and unfortunately I can't provide it as I am not sufficiently familiar with the code...