id	summary	reporter	owner	description	type	status	priority	milestone	component	version	resolution	keywords	cc
4642	Add documentation of __OpenModelica vendor annotations for compilation and simulation flags	Francesco Casella	Adeel Asghar	"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 [https://openmodelica.org/doc/OpenModelicaUsersGuide/latest/omchelptext.html Compiler Flags page] and a reference to the second two in the [https://openmodelica.org/doc/OpenModelicaUsersGuide/latest/simulationflags.html#simflag-newtonftol 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.

"	defect	closed	high	1.13.0	Documentation		fixed