Make the documentation of Integration Methods consistent and up-to-date

[Francesco Casella]

The online documentation on solver methods available here

​https://openmodelica.org/doc/OpenModelicaUsersGuide/latest/simulationflags.html#simflag-s

is too concise and inhomogeneous. In particular, for many algorithms it is not clear whether they do have error control and step-size/order adaptation or not.

Some more information is provided in another section of that document

​https://openmodelica.org/doc/OpenModelicaUsersGuide/latest/simulationflags.html#integration-methods

but only for some of the algorithms, and I am not sure it is up-to-date even for those ones. Overall, this is sometimes frustrating, and gives a bad impression about the software quality

I would suggest the following actions

• make the information displayed under the -s=value section consistent w.r.t. the solver being fixed- or variable-step-size, i.e. either always mention this info, or never mention it
• add a link to the detailed description to the -s=value text, e.g. "Value specifies the integration method. See <Integration Methods> for additional details"
• update and complete the information shown in the Integration Methods section of the documentation, including a description of all the supported methods

[Willi Braun]

The section of integration methods has been updated in ​PR69.

[Francesco Casella]

I like the new section, which shows up ​here.

I would recommend to add a section on DAEmode, and also to put a cross reference to this section in the ​documentation of the -s flag.

[Willi Braun]

Added DAEmode section in ​PR90.

[Willi Braun]

Replying to casella:

I would recommend to add a section on DAEmode, and also to put a cross reference to this section in the ​documentation of the -s flag.

Done in ​PR2835.

[Francesco Casella]

Please merge it also to the maintenance/v1.13 branch