update LSES docstrings accounting for comments

python/src/LeastSquaresEquationsSolver_doc.i.in

@@ -1,6 +1,9 @@
 %feature("docstring") OT::LeastSquaresEquationsSolver
 "Solve systems of non-linear equations using a least squares method.
 
+.. warning::
+    This class is experimental and likely to be modified in future releases.
+    To use it, import the ``openturns.experimental`` submodule.
 
 Parameters
 ----------
@@ -31,7 +34,20 @@ openturns.Solver, openturns.OptimizationAlgorithm
 Notes
 -----
 LeastSquaresEquationsSolver might fail and not obtain a result lower than the
-specified threshold, in this case an error is thrown."
+specified threshold, in this case an error is thrown.
+
+Examples
+--------
+
+>>> import openturns as ot
+>>> from openturns.experimental import LeastSquaresEquationsSolver
+>>> # Analytical construction
+>>> inputs = ["x", "y"]
+>>> formulas = ["y*x-sin(2*x)", "1 + cos(y) + x"]
+>>> analytical = ot.SymbolicFunction(input, formulas)
+>>> algo = LeastSquaresEquationsSolver()
+>>> starting_point = [2.0, 1.0]
+>>> solution = algo.solve(analytical, starting_point)"
 
 // ---------------------------------------------------------------------