doc: warn about MSVC x86 toolchain cmd name conflict

Fixes #589

Signed-off-by: Xavier Delaruelle <[email protected]>

Author: xdelaruelle

INSTALL-win.rst

@@ -107,3 +107,9 @@ a modulepath and contains few modulefile examples::
 Documentation of the :ref:`module(1)`, :ref:`ml(1)` and :ref:`envml(1)`
 commands and :ref:`modulefile(5)` syntax can be found in the ``doc`` directory
 in installation directory.
+
+.. warning:: If both Modules and the *MSVC x86 toolchain* are installed and
+   Modules has been initialized in the current shell session, the command
+   ``ml`` will refer to the Modules version rather than the *MSVC assembler*.
+   To invoke the *MSVC assembler* while Modules is active, you must call it
+   explicitly as ``ml.exe``.

NEWS.rst

@@ -23,6 +23,8 @@ Modules 5.6.1 (not yet released)
   Docs.
 * Doc: describe how to call modulefile command from a hook procedure in
   :ref:`module(1)` man page. (fix issue #590)
+* Doc: add warning in :ref:`INSTALL-win` to mention :command:`ml` command name
+  conflict with *MSVC x86 toolchain* ``ml.exe``. (fix issue #589)
 
 .. _Furo: https://github.com/pradyunsg/furo