[FIX] various broken JS docstrings

Resulting in sphinx warnings or ill-formatted doc all the way to the
doc not building at all.

1 files changed, 7 insertions, 5 deletions

diff --git a/addons/web/static/src/js/core/py_utils.js b/addons/web/static/src/js/core/py_utils.js
index 83e24b207c6..9bcd66864e5 100644
--- a/addons/web/static/src/js/core/py_utils.js
+++ b/addons/web/static/src/js/core/py_utils.js
@@ -335,11 +335,13 @@ function py_eval(expr, context) {
 /**
  * Assemble domains into a single domains using an 'OR' or an 'AND' operator.
  *
- * Note: - this function does not evaluate anything inside the domain.  This is
- * actually quite critical because this allows the manipulation of unevaluated
- * (dynamic) domains.
- *       - this function gives a normalized domain as result,
- *       - applied on a list of length 1, it returns the domain normalized.
+ * .. note:
+ *
+ *      - this function does not evaluate anything inside the domain.  This
+ *        is actually quite critical because this allows the manipulation of
+ *        unevaluated (dynamic) domains.
+ *      - this function gives a normalized domain as result,
+ *      - applied on a list of length 1, it returns the domain normalized.
  *
  * @param {string[]} domains list of string representing domains
  * @param {"AND" | "OR"} operator used to combine domains (default "AND")