devonfw#715: Cygwin not supported warning. (devonfw#733)

Author: nmCapG

cli/src/main/package/bin/ide

@@ -18,6 +18,11 @@ if [ $? = 0 ]; then
     echo "IDE environment variables have been set for ${IDE_HOME} in workspace ${WORKSPACE}"
   fi
 fi
+
+if [ "${OSTYPE}" = "cygwin" ]; then
+    echo -e "\033[93m--- WARNING: CYGWIN IS NOT SUPPORTED ---\nCygwin console is not supported by IDEasy.\nConsider using the git terminal instead.\nIf you want to use Cygwin with IDEasy, you will have to configure it yourself.\nA few suggestions and caveats can be found here:\nhttps://github.com/devonfw/IDEasy/blob/main/documentation/cygwin.adoc\n\033[39m"
+fi
+
 unset _IDEASY
 unset ide_env
 unset return_code

documentation/cygwin.adoc

@@ -0,0 +1,21 @@
+:toc:
+toc::[]
+
+= Cygwin not supported
+
+Currently, the Cygwin terminal is not supported by IDEasy. The suggested way of using IDEasy is with the git-bash terminal.
+If you, for whatever reason, still intend to use IDEasy with Cygwin, you can find a few caveats and suggestions below.
+Be warned that setting Cygwin up for IDEasy could potentially be very time-consuming.
+
+== Caveats
+
+* Not working with Cygwin are the following (note: this list is non-exhaustive):
+** Some IDEs are not working as expected. Examples:
+*** `ide Intellij` does not open intellij
+
+== Suggestions
+
+* When you installed Cygwin, you might have set your home variable where IDEasy isn't expecting it.
+** Do `echo $HOME` to check that it points to path '/cygdrive/c/Users/<your-user-name>'
+** If not, change the home variable in your system settings accordingly or load the `.bashrc` file of IDEasy from within the `.bashrc` file of Cygwin: `source /cygdrive/c/Users/<your-user-name>/.bashrc && echo "IDEasy's bashrc loaded"`.
+