docs: add compiler for recursive Inline Methods (#15591)

Reference that the deep of recursion optimisation is bounded.

---------

Co-authored-by: Jędrzej Rochala <[email protected]>

Author: ouertani

docs/_docs/reference/metaprogramming/inline.md

@@ -105,7 +105,8 @@ would typecheck.
 
 Inline methods can be recursive. For instance, when called with a constant
 exponent `n`, the following method for `power` will be implemented by
-straight inline code without any loop or recursion.
+straight inline code without any loop or recursion. It is worth noting that the number of successive
+inlines is limited to 32 and can be modified by the compiler setting `-Xmax-inlines`.
 
 ```scala
 inline def power(x: Double, n: Int): Double =