Add documentation of __OpenModelica vendor annotations for compilation and simulation flags

[Francesco Casella]

Following the discussion in #3488, vendor-specific annotations were added in OMC to set compilation and simulation flags.

Unfortunately, there is no mention of them in the user's guide, the only references are found in the ticket:

• ticket:3488#comment:9 for __OpenModelica_commandLineOptions
• ticket:3488#comment:17 for --ignoreCommandLineOptionsAnnotation
• ticket:3488#comment:27 for __OpenModelica_simulationFlags
• ticket:3488#comment:27 for --ignoreSimulationFlagsAnnotation

where they are mixed up with early proposals and various discussions, which makes the whole thing quite hard to interpret.

I would recommend to add a reference to the first two in the ​Compiler Flags page and a reference to the second two in the ​Simulation Flags page, explaining how to set the flags and with at least one example with multiple flags to make it clearer.

Also, it is not clear how (or actually if) it is possible to set value-less flags such as -daeMode or -noEquidistantTimeGrid, as it seems from the examples given in #3488 that is only possible to set simflags that have a value.

[Francesco Casella]

Maybe it would be betteer to add a section with all these annotations in the ​Documentation after Small Overview of Simulation Flags

[anonymous]

Please also add documentation of the followign flag:

annotation(__OpenModelica_IgnoreReplaceable)

https://trac.openmodelica.org/OpenModelica/ticket/4648

[Francesco Casella]

See #4812 and ​updated documentation