More details about solvers options

docs/src/manual-solve.md

@@ -146,16 +146,23 @@ For advanced usage, see:
 
 ## [NLP solvers specific options](@id manual-solve-solvers-specific-options)
 
-In addition to these options, all remaining keyword arguments passed to `solve` will be transmitted to the NLP solver used.
+In addition to these options, any remaining keyword arguments passed to `solve` are forwarded to the NLP solver.
+
+!!! warning
+
+    The option names and accepted values depend on the chosen solver. For example, in Ipopt, `print_level` expects an integer, whereas in MadNLP it must be a `MadNLP.LogLevels` value (valid options: `MadNLP.{TRACE, DEBUG, INFO, NOTICE, WARN, ERROR}`). Moreover, some options are solver-specific: for instance, `mu_strategy` exists in Ipopt but not in MadNLP.
+
+
+Please refer to the [Ipopt options list](https://coin-or.github.io/Ipopt/OPTIONS.html) and the [NLPModelsIpopt.jl documentation](https://jso.dev/NLPModelsIpopt.jl).  
 
-Please check the list of [Ipopt options](https://coin-or.github.io/Ipopt/OPTIONS.html) and the [NLPModelsIpopt.jl documentation](https://jso.dev/NLPModelsIpopt.jl).
 ```@example main
-sol = solve(ocp; max_iter=0, tol=1e-6, display=false)
+sol = solve(ocp; max_iter=0, tol=1e-6, print_level=0)
 iterations(sol)
 ```
 
-Similarly, please check the [MadNLP.jl documentation](https://madnlp.github.io/MadNLP.jl) and the list of [MadNLP.jl options](https://madnlp.github.io/MadNLP.jl/stable/options/).
+Likewise, see the [MadNLP.jl options](https://madnlp.github.io/MadNLP.jl/stable/options/) and the [MadNLP.jl documentation](https://madnlp.github.io/MadNLP.jl).  
+
 ```@example main
-sol = solve(ocp, :madnlp; max_iter=0, tol=1e-6, display=false)
+sol = solve(ocp, :madnlp; max_iter=0, tol=1e-6, print_level=MadNLP.ERROR)
 iterations(sol)
 ```