libtsioxx [DOC][ERR][!!!][WP]: give account of file contents
This is the first commit in a series of commits to fix a major bug: Currently the source code fails to compile with g++ 7.3.1, although no fatal errors were reported with previous compiler versions. Code analysis reveals: line 139 in sfftsfile.h calls the input operator datrw::idatstream& operator>>(datrw::idatstream& is, FileHeader& fh); which is not available there. It is embarrassing that this went unnoticed for such a long time. The input operator cannot be made available there because of inappropriate separation of class declaration and member function implementation. sfftsfile.h contains a declaration required by inputoperators.h Hence sfftsfile.h amy not load inputoperators.h Currently inputoperators.h appears like the main interface to libtsioxx, loading all other header files subsequently. This appears inapprorpiate as well. The code must be reorganized in different compilation units, probably introducing smaller granularity. This will change the API to the library in terms of header files.