Merge pull request #751 from elliotfontaine/interactive-guard-clause

Add warning about interactive guard clause in some default .bashrc files

CONTRIBUTING.md

@@ -55,6 +55,7 @@ requests_).
  - David Sutherland
  - Thomas Coleman
  - Scott Wales
+ - Elliot Fontaine
 <!-- end-shortlog -->
 
 (All contributors are identifiable with email addresses in the git version

src/user-guide/troubleshooting.rst

@@ -95,6 +95,16 @@ run for interactive sessions like so:
    export PATH="$HOME/bin:$PATH"
    export MY_LIB_PATH="$HOME/my-lib/1.0/"
 
+Conversely, make sure to **remove** the interactive guard clause that is present in the default ``.bashrc`` of some Linux distributions (e.g. `Debian <https://sources.debian.org/src/bash/4.3-11/debian/skel.bashrc/>`_).
+
+.. code-block:: bash
+
+   # If not running interactively, don't do anything
+   case $- in
+       *i*) ;;
+         *) return;;
+   esac
+
 Some things to check your login files for:
 
 * Don't write to stdout (e.g. using ``echo`` or ``printf``), this can interfere