a bit more wiki (linux subsystem)
authorMatthias Maier <tamiko@43-1.org>
Thu, 17 May 2018 04:33:12 +0000 (23:33 -0500)
committerMatthias Maier <tamiko@43-1.org>
Thu, 17 May 2018 04:33:12 +0000 (23:33 -0500)
Windows.md

index 68c8bd8bbebda99b9b6c87443fa27b939776b780..72dfc658667850efe435d9ce42ad923d81888c4a 100644 (file)
@@ -10,7 +10,7 @@ GNU/Linux](https://www.microsoft.com/en-us/store/p/debian-gnu-linux/9msvkqc78pk6
 because it already contains the latest deal.II release in binary form.
 (<b>Note:</b> The same is true for the Ubuntu distribution.)
 
 because it already contains the latest deal.II release in binary form.
 (<b>Note:</b> The same is true for the Ubuntu distribution.)
 
-## Installing the subsystem and Debian GNU/Linux
+## (Required) Installing the subsystem and Debian GNU/Linux
 
 Have a look at the excellent documentation about the Linux subsystem on the
 [Windows help pages](https://docs.microsoft.com/en-us/windows/wsl/install-win10)
 
 Have a look at the excellent documentation about the Linux subsystem on the
 [Windows help pages](https://docs.microsoft.com/en-us/windows/wsl/install-win10)
@@ -46,7 +46,6 @@ Have a look at the excellent documentation about the Linux subsystem on the
    ```
    deb http://deb.debian.org/debian buster main contrib non-free
    ```
    ```
    deb http://deb.debian.org/debian buster main contrib non-free
    ```
-   (<i>TODO: replace with `testing`</i>)
 
 6. Now update/upgrade the system by running
    ```console
 
 6. Now update/upgrade the system by running
    ```console
@@ -64,7 +63,7 @@ Have a look at the excellent documentation about the Linux subsystem on the
    [...]
    ```
 
    [...]
    ```
 
-## Installing the deal.II library and tools
+## (Required) Installing the deal.II library and tools
 
 We continue the installation process by installing the deal.II library with
 development headers and documentation. The packages in Debian (or Ubuntu)
 
 We continue the installation process by installing the deal.II library with
 development headers and documentation. The packages in Debian (or Ubuntu)
@@ -87,6 +86,13 @@ are called `libdeal.ii-dev` and `libdeal.ii-doc`:
    Do you want to continue? [Y/n] <Enter>
    ```
 
    Do you want to continue? [Y/n] <Enter>
    ```
 
+   If you plan to use graphical tools, a number of useful programs are:
+   ```console
+   root@computer# apt install xterm gnuplot
+   [...]
+   Do you want to continue? [Y/n] <Enter>
+   ```
+
    If you plan to use MSVC, you will also need to install ssh, zip and
    unzip:
    ```console
    If you plan to use MSVC, you will also need to install ssh, zip and
    unzip:
    ```console
@@ -114,7 +120,45 @@ are called `libdeal.ii-dev` and `libdeal.ii-doc`:
    [100%] Built target run
    ```
 
    [100%] Built target run
    ```
 
-## Installing Microsoft Visual Studio Community Edition
+## (Recommended) Installing an X server
+
+In order to run graphical applications from within the Linux Subsystem a
+so-called X server has to be installed. This step is in particular
+necessary, if you plan to install
+[Eclipse](https://github.com/dealii/dealii/wiki/Eclipse), or
+[KDevelop](https://github.com/dealii/dealii/wiki/KDevelop) via the Linux
+subsystem.
+
+1. Download and install [xming](https://sourceforge.net/projects/xming/).
+
+2. Start xming. A styliced X should appear in the task bar.
+
+3. Open a Linux terminal and try to run xterm:
+   ```console
+   user@computer$ export DISPLAY=:0
+   user@computer$ xterm
+   ```
+   This should spawn a new window with a shell. Simply close the shell
+   again.
+
+4. In order to avoid to have to export `DISPLAY=:0` every single time, it
+   is convenient to append
+   ```
+   export DISPLAY=:0
+   ```
+   to the end of the `.bashrc` file.
+
+You should now be able to proceed and run all graphical and command lines
+tools that are mentioned in the documentation and video lectures about
+deal.II.
+
+
+## (Optional) Installing Microsoft Visual Studio Community Edition
+
+This step is optional and only needed if you intent to use MSVC for code
+development. (Great alternatives are
+[Eclipse](https://github.com/dealii/dealii/wiki/Eclipse), or
+[KDevelop](https://github.com/dealii/dealii/wiki/KDevelop).)
 
 1. Go to the [Microsoft website](https://www.visualstudio.com/downloads)
    and download Microsoft Visual Studio Community Edition
 
 1. Go to the [Microsoft website](https://www.visualstudio.com/downloads)
    and download Microsoft Visual Studio Community Edition
@@ -149,18 +193,7 @@ directory from Linux is `/mnt/c/Users/<user>/Documents/workspace`. (Substitute
    root@computer# exit
    ```
 
    root@computer# exit
    ```
 
-(<i>Warning: The rest of this section is work in progress.</i>)
-
-3. Now, open Microsoft Visual Studio and click on `File` -> `New` ->
-   `Create New Project from Existing Code Files`. Use
-   `C:\Users\<user>\Documents\workspace\step-6` as "Project file location"
-   and "step-6" as project name. Click next. Select "Use external build
-   system" and click next again.
-
-
-## Installing X server
-
-(<i>TODO: write section</i>)
+(<i>TODO: Write rest.</i>)
 
 
 
 
 
 

In the beginning the Universe was created. This has made a lot of people very angry and has been widely regarded as a bad move.

Douglas Adams


Typeset in Trocchi and Trocchi Bold Sans Serif.