From ef350db58c3b2c73ae9cc4d07f3aeab6f314568f Mon Sep 17 00:00:00 2001
From: xndcn <xndchn@gmail.com>
Date: Thu, 24 Oct 2024 21:03:08 +0800
Subject: [PATCH] Add note about environment variable in parameter file.html

---
 war/src/main/webapp/help/parameter/file.html | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/war/src/main/webapp/help/parameter/file.html b/war/src/main/webapp/help/parameter/file.html
index ccf5b5ffab90..ef4f8d7f8e4a 100644
--- a/war/src/main/webapp/help/parameter/file.html
+++ b/war/src/main/webapp/help/parameter/file.html
@@ -22,6 +22,15 @@
     <code>my.zip</code>
     .) The name will not include the directory name portion.
   </p>
+  <p>
+    Please note that some shells, such as dash, or /bin/sh provided by dash,
+    do not make such environment variables with special characters available to
+    child processes. Try using shebang like
+    <code>#!/bin/bash</code>
+    in shell script and use
+    <code>$(printenv abc.zip)</code>
+    to get the original file name.
+  </p>
   <p>
     File upload is optional. If a user chooses not to upload anything, Jenkins
     will simply skips this parameter and will not place anything (but it also