[tor-commits] [manual/master] improve linux installation instructions and document .desktop file flags

[gus at torproject.org]

commit 6c5e0ff105c97339b270b00f7aba65fd0d9d210a
Author: championquizzer <championquizzer at gmail.com>
Date:   Fri Sep 3 19:38:30 2021 +0530

    improve linux installation instructions and document .desktop file flags
    
    fixes #88
    
    fixes #105
---
 .../linux-change-behavior-executable-files.png     | Bin 0 -> 82614 bytes
 .../images/linux-make-desktop-file-executable.png  | Bin 0 -> 58122 bytes
 content/installation/contents.lr                   |  43 +++++++++++++++++----
 3 files changed, 35 insertions(+), 8 deletions(-)

diff --git a/assets/static/images/linux-change-behavior-executable-files.png b/assets/static/images/linux-change-behavior-executable-files.png
new file mode 100644
index 0000000..a80e895
Binary files /dev/null and b/assets/static/images/linux-change-behavior-executable-files.png differ
diff --git a/assets/static/images/linux-make-desktop-file-executable.png b/assets/static/images/linux-make-desktop-file-executable.png
new file mode 100644
index 0000000..b0915ff
Binary files /dev/null and b/assets/static/images/linux-make-desktop-file-executable.png differ
diff --git a/content/installation/contents.lr b/content/installation/contents.lr
index d50bde9..c4fd7e9 100644
--- a/content/installation/contents.lr
+++ b/content/installation/contents.lr
@@ -40,19 +40,46 @@ For GNU/Linux:
 
 3. (Recommended) Verify the [file's signature](https://support.torproject.org/en/tbb/how-to-verify-signature/).
 
-4. When the download is complete, extract the archive with the command `tar -xf [TB archive]` or by using an archive manager.
+4. Now follow either the GUI method or the command-line method: 
 
-5. You'll need to tell your GNU/Linux that you want the ability to execute shell scripts from the graphical interface or the command line.
-   Navigate to the newly extracted Tor Browser directory.
-   Right click on `start-tor-browser.desktop`, open Properties or Preferences and change the permission to allow executing file as program.
+#### GUI method
+
+* When the download is complete, extract the archive using an archive manager.
+
+* You'll need to tell your GNU/Linux that you want the ability to execute shell scripts. Navigate to the newly extracted Tor Browser directory. Right click on `start-tor-browser.desktop`, open Properties or Preferences and change the permission to allow executing file as program.
    Double-click the icon to start up Tor Browser for the first time.
 
-   **Note:** On Ubuntu and some other distros if you try to launch the start-tor-browser.desktop file a text file might open up.
-To change this behavior and launch Tor Browser instead, follow this: Open "Files" (GNOME Files/Nautilus) → open Preferences → go to the 'Behavior' Tab → Select "Run them" or "Ask what to do" under "Executable Text Files".
-If you choose the latter click on "Run" after launching the start-tor-browser.desktop file.
+<img style="max-width:50%" class="col-md-6"  src="../../static/images/linux-make-desktop-file-executable.png" alt="Make the .desktop file executable in Linux">
+
+   **Note:** On Ubuntu and some other distros if you try to launch `start-tor-browser.desktop` a text file might open up.
+To change this behavior and launch Tor Browser instead, follow this:
+* Launch "Files" (GNOME Files/Nautilus)
+* Click on Preferences.
+* Navigate to the 'Behavior' Tab.
+* Select "Run them" or "Ask what to do" under "Executable Text Files".
+* If you choose the latter click on "Run" after launching the `start-tor-browser.desktop` file.
+
+<img style="max-width:50%" class="col-md-6"  src="../../static/images/linux-change-behavior-executable-files.png" alt="Change behavior of executable text file to always run in Linux">
+
+#### Command-line method
 
-6. Alternatively, from inside the Tor Browser directory, you can also start from the command line by running:
+* When the download is complete, extract the archive with the command `tar -xf [TB archive]`.
+
+* From inside the Tor Browser directory, you can launch Tor Browser by running:
 
    `./start-tor-browser.desktop`
 
+   **Note:** If this command fails to run, you probably need to make the file executable. From within this directory run: `chmod +x start-tor-browser.desktop`
+
+* Some additional flags that can be used with `start-tor-browser.desktop` from the command-line:
+
+| **Flag** | **Description** |
+|----------|-----------------|
+| `--register-app` | To register Tor Browser as a desktop application. |
+| `--verbose` | To display Tor and Firefox output in the terminal. |
+| `--log [file]` | To record Tor and Firefox output in file (default: tor-browser.log). |
+| `--detach` | To detach from terminal and run Tor Browser in the background. |
+| `--unregister-app` | To unregister Tor Browser as a desktop application. |
+
+
 See here on how to [update Tor Browser](https://tb-manual.torproject.org/updating/).