From db077277b6d5560799ef15fb6b2a0b626a0e8dec Mon Sep 17 00:00:00 2001 From: kraushm Date: Thu, 17 Jul 2025 22:40:08 +0200 Subject: [PATCH 1/3] Rephrase shells --- docs/guides/terminal.md | 12 ++++-------- 1 file changed, 4 insertions(+), 8 deletions(-) diff --git a/docs/guides/terminal.md b/docs/guides/terminal.md index 92660933..3c798958 100644 --- a/docs/guides/terminal.md +++ b/docs/guides/terminal.md @@ -8,26 +8,22 @@ This documentation is a collection of guides, hints, and tips for setting up you Every user has a shell that will be used when they log in, with [bash](https://www.gnu.org/software/bash/) as the default shell for new users at CSCS. -At CSCS the vast majority of users stick with the default `bash`: at the time of writing, of over 1000 users on Daint, over 99% were using bash. - !!! example "Which shell am I using?" Run the following command after logging in: ```console - $ getent passwd | grep $USER - bcumming:*:22008:1000:Benjamin Cumming, CSCS:/users/bcumming:/usr/local/bin/bash + $ echo $SHELL + /usr/local/bin/bash ``` - The last entry in the output points to the shell of the user, in this case `/usr/local/bin/bash`. - !!! tip If you would like to change your shell, for example to [zsh](https://www.zsh.org), you have to open a [service desk](https://jira.cscs.ch/plugins/servlet/desk) ticket to request the change. You can't make the change yourself. !!! warning - Because `bash` is used by all CSCS staff and the overwhelming majority of users, it is the best tested, and safest default. - + If you are comfortable with another shell (like Zsh or Fish), you are welcome to switch. Just keep in mind that some tools and instructions might not work the same way outside of `bash`. Since our support and documentation are based on the default setup, using a different shell might make it harder to follow along or get help. + We strongly recommend against using cshell - tools like uenv are not tested against it. [](){#ref-guides-terminal-arch} From 2724534fbcdd596d2602ec956f01e02011298d0d Mon Sep 17 00:00:00 2001 From: Ben Cumming Date: Fri, 18 Jul 2025 13:13:36 +0200 Subject: [PATCH 2/3] Update docs/guides/terminal.md --- docs/guides/terminal.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/guides/terminal.md b/docs/guides/terminal.md index 3c798958..79906331 100644 --- a/docs/guides/terminal.md +++ b/docs/guides/terminal.md @@ -22,7 +22,8 @@ Every user has a shell that will be used when they log in, with [bash](https://w !!! warning - If you are comfortable with another shell (like Zsh or Fish), you are welcome to switch. Just keep in mind that some tools and instructions might not work the same way outside of `bash`. Since our support and documentation are based on the default setup, using a different shell might make it harder to follow along or get help. + If you are comfortable with another shell (like Zsh or Fish), you are welcome to switch. Just keep in mind that some tools and instructions might not work the same way outside of `bash`. + Since our support and documentation are based on the default setup, using a different shell might make it harder to follow along or get help. We strongly recommend against using cshell - tools like uenv are not tested against it. From 57d15987702e6c6dff727e5453db72958056e261 Mon Sep 17 00:00:00 2001 From: Mikael Simberg Date: Mon, 28 Jul 2025 15:43:21 +0200 Subject: [PATCH 3/3] Apply suggestion from @msimberg --- docs/guides/terminal.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/guides/terminal.md b/docs/guides/terminal.md index 79906331..decd6e6e 100644 --- a/docs/guides/terminal.md +++ b/docs/guides/terminal.md @@ -22,7 +22,8 @@ Every user has a shell that will be used when they log in, with [bash](https://w !!! warning - If you are comfortable with another shell (like Zsh or Fish), you are welcome to switch. Just keep in mind that some tools and instructions might not work the same way outside of `bash`. + If you are comfortable with another shell (like Zsh or Fish), you are welcome to switch. + Just keep in mind that some tools and instructions might not work the same way outside of `bash`. Since our support and documentation are based on the default setup, using a different shell might make it harder to follow along or get help. We strongly recommend against using cshell - tools like uenv are not tested against it.