Update doc

Signed-off-by: Nicolás Ojeda Bär <n.oje.bar@gmail.com>

CHANGES.md

@@ -17,9 +17,6 @@
 
 - Enable `(explicit_js_mode)` by default. (#1941, @nojb)
 
-- Add (add-to-path) field in (context) definitions.
-  (#2426, @nojb)
-
 1.11.0 (unreleased)
 -------------------
 
@@ -117,6 +114,9 @@
   targets, and a switch `(explicit_js_mode)` to require this mode in order to
   declare JS targets corresponding to executables. (#1941, @nojb)
 
+- Add (paths ...) field in (context) definitions.
+  (#2426, @nojb)
+
 1.10.0 (04/06/2019)
 -------------------
 

doc/usage.rst

@@ -500,9 +500,9 @@ context or can be the description of an opam switch, as follows:
 - ``(host <host_context>)`` choose a different context to build binaries that
   are meant to be executed on the host machine, such as preprocessors.
 
-- ``(add-to-path <string list>)`` allows to extend the value of PATH for the
-  context. The resulting value will be used for resolution of binaries
-  (including the compiler tools).
+- ``(paths (<var1> <val1>) .. (<varN> <valN>))`` allows to set the value of
+  PATH-like variables in this context. For each variable, the value is specified
+  using the :ref:`ordered-set-language`.
 
 Both ``(default ...)`` and ``(opam ...)`` accept a ``targets`` field in order to
 setup cross compilation. See :ref:`advanced-cross-compilation` for more