diff mercurial/help/config.txt @ 38629:38dfd308fe9d

hook: add support for disabling the shell to native command translation

I think having it on by default is the right thing to do, but this is an escape
hatch if someone has a command that shouldn't be mangled.  The inspiration is
the priority prefix.  The translation does nothing on non Windows platforms, so
the default value is selected to avoid printing a useless note by default.

--- a/mercurial/help/config.txt	Sat Jul 07 23:47:49 2018 -0400
+++ b/mercurial/help/config.txt	Sat Jul 07 23:38:06 2018 -0400
@@ -893,7 +893,14 @@
 
   Some basic Unix syntax is supported for portability, including ``$VAR``
   and ``${VAR}`` style variables.  To use a literal ``$``, it must be
-  escaped with a back slash or inside of a strong quote.
+  escaped with a back slash or inside of a strong quote.  This can be
+  disabled by adding a prefix of ``tonative.`` to the hook name on a new
+  line, and setting it to ``False``.  For example::
+
+    [hooks]
+    incoming.autobuild = /my/build/hook
+    # disable translation to cmd.exe syntax for autobuild hook
+    tonative.incoming.autobuild = False
 
 ``changegroup``
   Run after a changegroup has been added via push, pull or unbundle.  The ID of