@@ -417,7 +417,16 @@ void symlink(
417417 defaultValue = "False" ,
418418 named = true ,
419419 positional = false ,
420- doc = "Whether the action should use the built in shell environment or not." ),
420+ doc =
421+ "Whether the action should use the default shell environment, which consists of a"
422+ + " few OS-dependent variables as well as variables set via <a"
423+ + " href=\" /reference/command-line-reference#flag--action_env\" ><code>"
424+ + "--action_env</code></a>.<p>If both <code>use_default_shell_env</code> and"
425+ + " <code>env</code> are set to <code>True</code>, values set in"
426+ + " <code>env</code> will overwrite the default shell environment if <a "
427+ + "href=\" /reference/command-line-reference#flag--incompatible_merge_fixed_and_default_shell_env\" ><code>--incompatible_merge_fixed_and_default_shell_env</code></a>"
428+ + " is enabled (default). If the flag is not enabled, <code>env</code> is"
429+ + " ignored." ),
421430 @ Param (
422431 name = "env" ,
423432 allowedTypes = {
@@ -427,7 +436,14 @@ void symlink(
427436 defaultValue = "None" ,
428437 named = true ,
429438 positional = false ,
430- doc = "Sets the dictionary of environment variables." ),
439+ doc =
440+ "Sets the dictionary of environment variables.<p>If both"
441+ + " <code>use_default_shell_env</code> and <code>env</code> are set to"
442+ + " <code>True</code>, values set in <code>env</code> will overwrite the"
443+ + " default shell environment if <a "
444+ + "href=\" /reference/command-line-reference#flag--incompatible_merge_fixed_and_default_shell_env\" ><code>--incompatible_merge_fixed_and_default_shell_env</code></a>"
445+ + " is enabled (default). If the flag is not enabled, <code>env</code> is"
446+ + " ignored." ),
431447 @ Param (
432448 name = "execution_requirements" ,
433449 allowedTypes = {
@@ -664,7 +680,16 @@ void run(
664680 defaultValue = "False" ,
665681 named = true ,
666682 positional = false ,
667- doc = "Whether the action should use the built in shell environment or not." ),
683+ doc =
684+ "Whether the action should use the default shell environment, which consists of a"
685+ + " few OS-dependent variables as well as variables set via <a"
686+ + " href=\" /reference/command-line-reference#flag--action_env\" ><code>"
687+ + "--action_env</code></a>.<p>If both <code>use_default_shell_env</code> and"
688+ + " <code>env</code> are set to <code>True</code>, values set in"
689+ + " <code>env</code> will overwrite the default shell environment if <a "
690+ + "href=\" /reference/command-line-reference#flag--incompatible_merge_fixed_and_default_shell_env\" ><code>--incompatible_merge_fixed_and_default_shell_env</code></a>"
691+ + " is enabled (default). If the flag is not enabled, <code>env</code> is"
692+ + " ignored." ),
668693 @ Param (
669694 name = "env" ,
670695 allowedTypes = {
@@ -674,7 +699,14 @@ void run(
674699 defaultValue = "None" ,
675700 named = true ,
676701 positional = false ,
677- doc = "Sets the dictionary of environment variables." ),
702+ doc =
703+ "Sets the dictionary of environment variables.<p>If both"
704+ + " <code>use_default_shell_env</code> and <code>env</code> are set to"
705+ + " <code>True</code>, values set in <code>env</code> will overwrite the"
706+ + " default shell environment if <a "
707+ + "href=\" /reference/command-line-reference#flag--incompatible_merge_fixed_and_default_shell_env\" ><code>--incompatible_merge_fixed_and_default_shell_env</code></a>"
708+ + " is enabled (default). If the flag is not enabled, <code>env</code> is"
709+ + " ignored." ),
678710 @ Param (
679711 name = "execution_requirements" ,
680712 allowedTypes = {
0 commit comments