several textual improvements

Author: thomasWeise

text/main/basics/gettingStarted/firstProgram/firstProgram.tex

@@ -59,7 +59,7 @@
 \floatRowSep%
 %
 \subfloat[][%
-We enter a name for the new \python\ file (here:~\directory{very\_first\_program}) and hit \keys{\enter}.
+We enter a name for the new \python\ file (here:~\directory{very\_first\_program}) and hit \keys{\return}.
 \label{fig:firstProgram06createPythonFileNameEntered}%
 ]{\tightbox{\includegraphics[width=0.775\linewidth]{\currentDir/firstProgram06createPythonFileNameEntered}}}%
 %

text/main/basics/gettingStarted/installingPyCharm/installingPyCharmUbuntu/installingPyCharmUbuntu.tex

@@ -11,7 +11,7 @@
 \floatRowSep%
 %
 \subfloat[][%
-This command requires the super user password, which we type in and then press~\keys{\enter}.%
+This command requires the super user password, which we type in and then press~\keys{\return}.%
 \label{fig:installingPyCharmUbuntu02sudo}%
 ]{\includegraphics[width=0.7\linewidth]{\currentDir/installingPyCharmUbuntu02sudo}}%
 %
@@ -65,7 +65,7 @@
 \pycharm\ is available as Snap package under \ubuntu\ \linux~\cite{C2025SD,J2024PCPCE}.
 The installation process is very easy and follows the steps illustrated in \cref{fig:installingPyCharmUbuntu}.
 First, you open a \pgls{terminal} by pressing \ubuntuTerminal.
-Then, enter the command \bashil{sudo snap install pycharm-community --classic} and hit~\keys{\enter}~(\cref{fig:installingPyCharmUbuntu01snapInstall}).
+Then, enter the command \bashil{sudo snap install pycharm-community --classic} and hit~\keys{\return}~(\cref{fig:installingPyCharmUbuntu01snapInstall}).
 This installs the \pycharm\ software package and the necessary super user privileges are obtained via the pre-pended \pgls{sudo}, which will ask us to enter the root password, as sketched in \cref{fig:installingPyCharmUbuntu02sudo}.
 Then, the installation process basically runs automatically.
 Once it has completed (see \cref{fig:installingPyCharmUbuntu05snapInstallFinished}), you can press the \keys{\OSwin} key and type \bashil{pycharm} in the launcher window to find \pycharm~(\cref{fig:installingPyCharmUbuntu06launcher}).

text/main/basics/gettingStarted/installingPython/installingPythonWindows/installingPythonWindows.tex

@@ -53,8 +53,8 @@
 %
 Example installation steps for \python\ on \microsoftWindows\ (version~10) are sketched in \cref{fig:installPythonWindows}.
 First, you would open a \pgls{terminal} using and \windowsTerminal, as shown in \cref{fig:installingPythonWindows01openTerminal}.
-If \python\ is installed, then typing \bashil{python3 --version} in the terminal and hitting~\keys{\enter} would print the version of the \python\ installation.
-If it is not installed, however, then \microsoftWindows\ will print a message informing you that \python\ is not yet installed and that you can reach the web installer by just typing \bashil{python3} (and hitting~\keys{\enter}, of course).
+If \python\ is installed, then typing \bashil{python3 --version} in the terminal and hitting~\keys{\return} would print the version of the \python\ installation.
+If it is not installed, however, then \microsoftWindows\ will print a message informing you that \python\ is not yet installed and that you can reach the web installer by just typing \bashil{python3} (and hitting~\keys{\return}, of course).
 We do this in \cref{fig:installingPythonWindows03python}, which leads us to the installation screen (\cref{fig:installingPythonWindows04installGet}), where we need to press the \keys{Get} button.
 This will then download (\cref{fig:installingPythonWindows05downloading}) and install \python.
 When this process is completed, the screen just shows nothing (\cref{fig:installingPythonWindows06finished}).

text/main/basics/gettingStarted/installingPython/pythonUnderUbuntu/pythonUnderUbuntu.tex

@@ -9,7 +9,7 @@
 %
 \begin{sloppypar}%
 Under \ubuntu\ \linux, \python~\softwareStyle{3} is already pre-installed.
-You can open a \pgls{terminal}~\cite{B2022ELATCL} by pressing~\ubuntuTerminal, then type in \bashil{python3 --version}, hit \keys{\enter}, and get the result illustrated in \cref{fig:ubuntuTerminalPythonVersion}:
+You can open a \pgls{terminal}~\cite{B2022ELATCL} by pressing~\ubuntuTerminal, then type in \bashil{python3 --version}, hit \keys{\return}, and get the result illustrated in \cref{fig:ubuntuTerminalPythonVersion}:
 \end{sloppypar}%
 %
 \FloatBarrier%

text/main/basics/gettingStarted/pythonInTheTerminal/pythonInTheTerminal.tex

@@ -7,7 +7,7 @@
 %
 \subfloat[][%
 Open a \pgls{terminal} (by pressing \ubuntuTerminal\ under \ubuntu\ \linux; under \microsoftWindows\ \windowsTerminal). %
-Change into the directory \inQuotes{directory} where your \python\ file is located, by typing \bashil{cd directory} and hit \keys{\enter}. %
+Change into the directory \inQuotes{directory} where your \python\ file is located, by typing \bashil{cd directory} and hit \keys{\return}. %
 (I here had it in the temporary directory \bashil{/tmp}, you will have it elsewhere\dots)%
 \label{fig:terminalPython1cd}%
 ]{\includegraphics[width=0.9\linewidth]{\currentDir/terminalPython1cd}}%
@@ -22,7 +22,7 @@
 \floatRowSep%
 %
 \subfloat[][%
-Execute a \python\ program \inQuotes{program.py} by typing \bashil{python3 program.py} and hit \keys{\enter}. %
+Execute a \python\ program \inQuotes{program.py} by typing \bashil{python3 program.py} and hit \keys{\return}. %
 In our case, the program is \inQuotes{very\_first\_program.py}.%
 \label{fig:terminalPython3python}%
 ]{\includegraphics[width=0.9\linewidth]{\currentDir/terminalPython3python}}%
@@ -61,7 +61,7 @@
 \centering%
 %
 \subfloat[][%
-We enter the \inQuotes{Hello World!} program from \cref{lst:very_first_program} and press \keys{\enter}.%
+We enter the \inQuotes{Hello World!} program from \cref{lst:very_first_program} and press \keys{\return}.%
 \label{fig:pycharmConsole3writingCode}%
 ]{\tightbox{\includegraphics[width=0.76\linewidth]{\currentDir/pycharmConsole3writingCode}}}%
 %
@@ -80,7 +80,7 @@
 \centering%
 %
 \subfloat[][%
-Open a \pgls{terminal} (by pressing \ubuntuTerminal\ under \ubuntu\ \linux; under \microsoftWindows\ \windowsTerminal), enter \bashil{python3}, then hit \keys{\enter}.%
+Open a \pgls{terminal} (by pressing \ubuntuTerminal\ under \ubuntu\ \linux; under \microsoftWindows\ \windowsTerminal), enter \bashil{python3}, then hit \keys{\return}.%
 \label{fig:terminalConsole1python}%
 ]{\includegraphics[width=0.852\linewidth]{\currentDir/terminalConsole1python}}%
 %
@@ -94,7 +94,7 @@
 \floatRowSep%
 %
 \subfloat[][%
-We enter the \inQuotes{Hello World!} program from \cref{lst:very_first_program} and press \keys{\enter}.%
+We enter the \inQuotes{Hello World!} program from \cref{lst:very_first_program} and press \keys{\return}.%
 \label{fig:terminalConsole3writingCode}%
 ]{\includegraphics[width=0.852\linewidth]{\currentDir/terminalConsole3writingCode}}%
 %
@@ -113,7 +113,7 @@
 \centering%
 %
 \subfloat[][%
-We exit the console by typing \pythonil{exit()}\pythonIdx{exit} and pressing \keys{\enter}.%
+We exit the console by typing \pythonil{exit()}\pythonIdx{exit} and pressing \keys{\return}.%
 \label{fig:terminalConsole5exit}%
 ]{\includegraphics[width=0.852\linewidth]{\currentDir/terminalConsole5exit}}%
 %
@@ -137,7 +137,7 @@
 %
 \item Actually, we can also write a \python\ program with a normal text editor. %
 A \python\ program is just a normal text file, after all. %
-We can execute such a text file by entering its directory and typing \bashil{python3 programName} (where \bashil{programName} is \bashil{very_first_program.py}, in our case) and hitting \keys{\enter}. %
+We can execute such a text file by entering its directory and typing \bashil{python3 programName} (where \bashil{programName} is \bashil{very_first_program.py}, in our case) and hitting \keys{\return}. %
 Then the program is executed directly in the \pgls{terminal}. %
 This process is shown in \cref{sec:terminalPython,fig:terminalPython}.%
 %
@@ -156,11 +156,11 @@
 Under \ubuntu\ \linux, we simply press \ubuntuTerminal.
 Under \microsoftWindows, we have to \windowsTerminal.
 Once the terminal is open, we need to change into the directory where the program is located.
-Under both \linux\ and \microsoftWindows, this can be done by typing the command \bashil{cd}, followed by the path to the directory, and hitting \keys{\enter}.\footnote{%
+Under both \linux\ and \microsoftWindows, this can be done by typing the command \bashil{cd}, followed by the path to the directory, and hitting \keys{\return}.\footnote{%
 Under \microsoftWindows, you may also need to change into the correct drive first.}
 We provide a screenshot for that, taken under \ubuntu\ \linux, in \cref{fig:terminalPython1cd}.
 Now we simply call the \python\ interpreter by writing \bashil{python3} followed by the file name of our program, which is \bashil{very_first_program.py} in our case.
-In \cref{fig:terminalPython3python} we do this and hit \keys{\enter}, which causes the \python\ interpreter to execute our program.
+In \cref{fig:terminalPython3python} we do this and hit \keys{\return}, which causes the \python\ interpreter to execute our program.
 The output \inQuotes{Hello World!} is then printed into the \pgls{terminal} in \cref{fig:terminalPython4result}.%
 \endhsection%
 %
@@ -176,7 +176,7 @@
 This directly brings us to the \python\ console~(\cref{fig:pycharmConsole2consoleOpen}).
 We can enter the one-line-program from \cref{lst:very_first_program}, as illustrated in \cref{fig:pycharmConsole3writingCode}.
 Notice that the input prompt of the console is marked by the three greater characters \bashil{>>>} after which we enter our text.
-Pressing \keys{\enter} after writing the code leads to the expected output shown in \cref{fig:pycharmConsole4codeOutput}.
+Pressing \keys{\return} after writing the code leads to the expected output shown in \cref{fig:pycharmConsole4codeOutput}.
 This output directly appears in the console and is not preceded by any other text, in particular not by \bashil{>>>}, which makes it easy to visually distinguish what the input and output in a \python\ console are.%
 \endhsection%
 %
@@ -186,14 +186,14 @@
 We therefore first need to open a normal terminal.
 Under \ubuntu\ \linux, we simply press \ubuntuTerminal.
 Under \microsoftWindows, we have to \windowsTerminal.
-Either way, the terminal opens and we can enter \bashil{python3} and press \keys{\enter}, as shown in \cref{fig:terminalConsole1python}.
+Either way, the terminal opens and we can enter \bashil{python3} and press \keys{\return}, as shown in \cref{fig:terminalConsole1python}.
 Now the \python\ interpreter starts right inside the \pgls{terminal}~(\cref{fig:terminalConsole2pythonRunning}).
 The prompt, i.e., the place where we can write our code, again is preceded by the \bashil{>>>} characters.
-As illustrated in \cref{fig:terminalConsole3writingCode}, we copy the single line of code, \pythonil{print("Hello World!")}\pythonIdx{print} from \cref{lst:very_first_program} and press \keys{\enter}.
+As illustrated in \cref{fig:terminalConsole3writingCode}, we copy the single line of code, \pythonil{print("Hello World!")}\pythonIdx{print} from \cref{lst:very_first_program} and press \keys{\return}.
 The output \inQuotes{Hello World!} is printed as expected in \cref{fig:terminalConsole4codeOutput}.
 However, we now are still in the \python\ interpreter.
 In order to leave it and to, maybe, enter other commands in the \pgls{terminal}, we have to use another new \python\ instruction:
-We type in \pythonil{exit()} and press \keys{\enter}, as shown in \cref{fig:terminalConsole5exit}, which causes the \python\ interpreter to exit.
+We type in \pythonil{exit()} and press \keys{\return}, as shown in \cref{fig:terminalConsole5exit}, which causes the \python\ interpreter to exit.
 We are now back in the basic terminal, as shown in \cref{fig:terminalConsole6left}.
 In these figures, I was using \ubuntu\ \linux.
 On \microsoftWindows\ or other \linux\ variants, the process would have looked quite similar.%

text/main/basics/simpleDataTypesAndOperations/documentation/documentation.tex

@@ -275,7 +275,7 @@
 \floatRowSep%
 %
 \subfloat[][%
-We enter our query \emph{\inQuotes{python rounding towards infinity}} and press~\keys{\enter}.%
+We enter our query \emph{\inQuotes{python rounding towards infinity}} and press~\keys{\return}.%
 \label{fig:stackOverflow03queryEntered}%
 ]{\tightbox{\includegraphics[width=0.47\linewidth]{\currentDir/stackOverflow01websiteLoading}}}%
 %

text/main/basics/simpleDataTypesAndOperations/int/int.tex

@@ -35,12 +35,12 @@
 (The same example is given in \cref{exec:int_arithmetics}, just as listing instead of screenshot.
 We will use such listings from now on, as they convey the exactly same information, but are easier to read and I can more conveniently include comments.)
 Like back in \cref{sec:terminalConsolem}, press \ubuntuTerminal\ under \ubuntu\ \linux\ or \windowsTerminal\ under \microsoftWindows\ to open a \pgls{terminal}.
-After entering \bashil{python3} and hitting \keys{\enter}, we can begin experimenting with integer maths.
+After entering \bashil{python3} and hitting \keys{\return}, we can begin experimenting with integer maths.
 The lines with \python\ commands in the console begin with \pythonil{>>>}, whereas the result is directly output below them without prefix string.
 
-In the very first line of \cref{fig:pythonIntMathInConsoleArith,exec:int_arithmetics}, we enter \pythonil{4 + 3}\pythonIdx{+} and hit \keys{\enter}.
+In the very first line of \cref{fig:pythonIntMathInConsoleArith,exec:int_arithmetics}, we enter \pythonil{4 + 3}\pythonIdx{+} and hit \keys{\return}.
 The result is displayed on the next line and, as expected, is \pythonil{7}.
-We then attempt to multiply the two integers \pythonil{7} and \pythonil{5} by typing \pythonil{7 * 5}\pythonIdx{*!multiplication} and hitting \keys{\enter}.
+We then attempt to multiply the two integers \pythonil{7} and \pythonil{5} by typing \pythonil{7 * 5}\pythonIdx{*!multiplication} and hitting \keys{\return}.
 The result is \pythonil{35}.
 
 \python\ does not just support normal arithmetics as you have learned it in school, it also follows the operator precedence rules.

text/main/basics/simpleDataTypesAndOperations/none/none.tex

@@ -16,7 +16,7 @@
 
 \Cref{exec:none} illustrates some of the things we can do with \pythonilIdx{None}.
 If we write \pythonilIdx{None} into the \python\ console, then nothing happens.
-In the past, we just wrote values, such as \pythonil{34} and, after we hit~\keys{\enter}, they would be printed again.
+In the past, we just wrote values, such as \pythonil{34} and, after we hit~\keys{\return}, they would be printed again.
 Not so~\pythonilIdx{None}.
 If we want to print~\pythonilIdx{None}, we have to force it by using the function~\pythonilIdx{print}.
 \pythonil{print(None)} then indeed prints~\pythonilIdx{None}.

text/main/basics/simpleDataTypesAndOperations/str/str.tex

@@ -383,9 +383,9 @@
 \pythonil{print("The horizontal tab is like a bigger space: '\\t'.")} yields \inlinelistingbox{\texttt{The~horizontal~tab~is~like~a~bigger~space:~'~~~~'.}}.
 
 Finally, a backslash can also escape an actual newline in your string\pythonIdx{str!escaping}\pythonIdx{escaping}.
-If you have a string that is too long to write on a single line but you do not want to have a linebreak inside the actual string, you can simply put a backslash, hit \keys{\enter}, and continue the typing the string.
+If you have a string that is too long to write on a single line but you do not want to have a linebreak inside the actual string, you can simply put a backslash, hit \keys{\return}, and continue the typing the string.
 The linebreak will then be ignored entirely.
-Therefore, if you print~\pythonil{print("Hello\\}, hit \keys{\enter}, and then continue to write \pythonil{World!")}, this produces the output~\textil{HelloWorld!}.
+Therefore, if you print~\pythonil{print("Hello\\}, hit \keys{\return}, and then continue to write \pythonil{World!")}, this produces the output~\textil{HelloWorld!}.
 
 \Pglspl{escapeSequence} allow us to write arbitrary text in strings.
 We already learned the sequences \inQuotes{\textbraceleft\textbraceleft}\pythonIdx{\textbraceleft\textbraceleft} and \inQuotes{\textbraceright\textbraceright}\pythonIdx{\textbraceright\textbraceright} that were designed for \pglspl{fstring} only.
@@ -403,7 +403,7 @@
 Before we discussed that strings in \python\ are delimited either by \pythonil{"}\pythonIdx{\textquotedbl\idxdots\textquotedbl} or \pythonil{'}\pythonIdx{\textquotesingle\idxdots\textquotesingle} on each side.
 However, we can actually delimit them also delimit them with \emph{three quotation marks} on each side, i.e., with either \pythonil{"""}\pythonIdx{\textquotedbl\textquotedbl\textquotedbl\idxdots\textquotedbl\textquotedbl\textquotedbl} or \pythonil{'''}\pythonIdx{\textquotesingle\textquotesingle\textquotesingle\idxdots\textquotesingle\textquotesingle\textquotesingle}.
 Such string delimiters are used for multi-line strings.
-In such strings, you can insert linebreaks by hitting \keys{\enter} completely normally.
+In such strings, you can insert linebreaks by hitting \keys{\return} completely normally.
 You can use the \pglspl{escapeSequence} from the previous section as well.
 The main use case are \pglspl{docstring}, which we will discuss later, see, e.g., \cref{bp:module:docstrings}.%
 %

text/main/basics/variables/assignment/assignment.tex

@@ -378,7 +378,7 @@
 For your convenience, we also showed the results when executing the program in \pycharm\ or the \ubuntu\ \pgls{terminal} in \cref{fig:variables:liuHuiPi}.
 To open a \pgls{terminal} under \ubuntu\ \linux, you would press~\ubuntuTerminal, whereas under \microsoftWindows, you~\windowsTerminal.
 With the command \bashil{cd}, you would enter the directory where our program \programUrl{variables:pi_liu_hui} is located.
-You would then type in \bashil{python3 pi_liu_hui.py} and hit~\keys{\enter}.
+You would then type in \bashil{python3 pi_liu_hui.py} and hit~\keys{\return}.
 As you can see in \cref{fig:liuHuiPiTerminal}, you will get the same output as given in \cref{exec:variables:pi_liu_hui}.
 
 Alternatively, if you are using \pycharm, you can open the program file \programUrl{variables:pi_liu_hui} as shown in \cref{fig:liuHuiPiPyCharm1}.