From 75de7f3c2e26bdd01fdc047e379efbfc0668ca9d Mon Sep 17 00:00:00 2001
From: James Moore <j.k.moore@sheffield.ac.uk>
Date: Thu, 26 May 2022 12:55:38 +0100
Subject: [PATCH] Clarification on shell behaviour with apptainer exec.

Signed-off-by: James Moore <j.k.moore@sheffield.ac.uk>
---
 quick_start.rst | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/quick_start.rst b/quick_start.rst
index bc628c35..390f3b91 100644
--- a/quick_start.rst
+++ b/quick_start.rst
@@ -430,6 +430,18 @@ command and disappears.
                    ||----w |
                    ||     ||
 
+.. warning:: 
+   Using shell operators such as ``&&`` in the command supplied to {command} exec 
+   will run subsequent commands in the current shell, not within the {command} container!
+
+   For example:
+   
+   .. code::
+
+      $ {command} exec docker://sylabsio/lolcow echo "Hello" && cowsay "Fresh from the internet!"
+      Hello
+      Command 'cowsay' not found.
+
 .. _runcontainer:
 
 Running a container