Merge branch 'master' into patch-1

Author: leviport

.github/workflows/deploy.yml

@@ -45,3 +45,4 @@ jobs:
           cname: support.system76.com
           github_token: ${{ secrets.RELEASE_TOKEN }}
           publish_dir: ./dist
+          force_orphan: true

content/bluetooth.md

@@ -106,51 +106,63 @@ Then, run <u>Bluetooth Manager</u>. Check for the device being trusted, and also
 
 ### Useful Commands
 
+To show if the Bluetooth module (driver) is loaded, and see what system messages have been logged:
+
 ```bash
 lsmod | grep bluetooth
 dmesg | grep Bluetooth
 ```
 
-These will show if the Bluetooth module (driver) is loaded, and what the system messages are.
+To check if the service that handles Bluetooth is running:
 
 ```bash
 sudo systemctl status bluetooth
 ```
 
-This will check to see if the service that handles Bluetooth is running.
+To check if Bluetooth or Wireless (Wi-Fi) are software-blocked:
 
 ```bash
 rfkill list
+```
+
+To unblock Bluetooth:
+
+```
 sudo rfkill unblock bluetooth
 ```
 
-If both Bluetooth and Wireless are soft blocked or if the Wireless is soft blocked run this command to unblock:
+To unblock all wireless types:
 
 ```bash
 sudo rfkill unblock all
 ```
 
-This will check to see Bluetooth is blocked, and if so, unblock it.
-
-*For Pop!\_OS 21.10 or 20.04:*
+To manually reload the Bluetooth USB kernel module:
 
 ```bash
-pactl load-module module-bluetooth-discover
+sudo rmmod btusb
+sudo modprobe btusb
 ```
 
-This will load the PulseAudio module responsible for Bluetooth Audio.  Typically, it's loaded by default, but sometimes a manual loading can get Bluetooth headsets working again. This module is no longer used on Pop!\_OS 22.04 or higher.
+To monitor Bluetooth-related messages (try leaving this command running while pairing or using a device to see any error messages or failures):
 
 ```bash
 sudo btmon
 ```
 
-This will show all Bluetooth related messages.  Try leaving this command running while pairing or using a device to see any error messages or failures.
+To reset the Bluetooth device profiles and require re-pairing all devices (this can help if your Bluetooth audio device is stuck in an HSP/HFP profile and will not switch to A2DP mode after updates <sup>[1](https://github.com/bluez/bluez/issues/157)</sup>):
 
 ```bash
 sudo rm -r /var/lib/bluetooth/
 ```
 
-This will reset the Bluetooth device profiles and require re-pairing all devices. This can help if your Bluetooth audio device is stuck in an HSP/HFP profile and will not switch to A2DP mode after updates <sup>[1](https://github.com/bluez/bluez/issues/157)</sup>.
+*For Pop!\_OS 21.10 or 20.04:*
+
+Older Pop!\_OS versions used a PulseAudio module for Bluetooth audio. It's typically loaded by default, but sometimes a manual load can get Bluetooth headsets working again:
+
+```bash
+pactl load-module module-bluetooth-discover
+```
 
 ## Additional Info
 

content/bootloader.md

@@ -28,50 +28,73 @@ Proprietary multimedia formats, such as MP3 files and DVD decoders, aren't inclu
 
 ## Open A Terminal
 
-Press the Super Key <kbd><font-awesome-icon :icon="['fab', 'ubuntu']"></font-awesome-icon></kbd>, and type the word *terminal*, then press <kbd>Enter</kbd>.  A <u>Terminal</u> window should open up.
+Press the Super key <kbd><font-awesome-icon :icon="['fab', 'ubuntu']"></font-awesome-icon></kbd> and type the word *terminal*, then press <kbd>Enter</kbd>. A <u>Terminal</u> window should open up.
 
 ## Install Packages
 
-Ubuntu and Pop!\_OS both have a package available which will install all available proprietary media codecs. Because of legal restrictions, this package cannot be installed automatically, but if you live in a territory where it is legal to do so, you can copy and paste the following line, followed by <kbd>Enter</kbd>:
+The commands below can be used to install various sets of packages. To paste into the terminal, use the "Edit" Menu, or press <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>V</kbd>.
+
+You may be prompted for your `[sudo] password`. If so, type in your regular login/user password, then press <kbd>Enter</kbd> again. You will not see characters appear while you're typing the password.
+
+Please note that packages listed with "bad" or "ugly" in the names below are not harmful to your system.
+
+- Plugins marked "ugly" may not be legal to install in all juristictions due to copyright and patent law.
+- Plugins marked "bad" do not receive as many development resources from the GStreamer project, but are still supported in Pop!\_OS and Ubuntu.
+
+### Install all available formats
+
+Ubuntu and Pop!\_OS both have a package available which will install most available proprietary media codecs. Because of legal restrictions, this package cannot be installed automatically, but if you live in a territory where it is legal to do so, you can copy and paste the following line, followed by <kbd>Enter</kbd>:
 
 ```
-sudo apt install -y ubuntu-restricted-extras
+sudo apt install -y ubuntu-restricted-extras gstreamer1.0-plugins-bad
 ```
 
-If it is not legal for you to do so, or if you only want the minimum required codecs, you may do so manually. Please note that packages listed with "bad" in the names below are not harmful to your system, they are listed as "bad" in the system software repositories due to the non-free (as in libre) nature of the code within the packages.
+If you receive a prompt titled `Configuring ttf-mscorefonts-installer`, press `Tab` to select the `<Ok>` item, then press `Enter`. Next, use `Tab` again to select the `<Yes>` option to agree to the EULA, then press `Enter` again.
+
+### Install only some formats
+
+If it is not legal for you to install all of the formats, or if you only want to install the formats you need, you can use the following manual commands. Remove any unwanted packages from the command before running it.
 
-Copy and paste the following line for Ubuntu/Pop!\_OS 18.04 and below, followed by <kbd>Enter</kbd>:
+For Ubuntu/Pop!\_OS **20.04 and above,** copy and paste the following line, followed by <kbd>Enter</kbd>:
 
 ```
-sudo apt install -y gstreamer1.0-plugins-bad gstreamer1.0-plugins-ugly libavcodec-extra gstreamer1.0-libav gstreamer1.0-fluendo-mp3 chromium-codecs-ffmpeg-extra libdvd-pkg
+sudo apt install -y gstreamer1.0-plugins-bad gstreamer1.0-plugins-ugly gstreamer1.0-plugins-good libavcodec-extra gstreamer1.0-libav chromium-codecs-ffmpeg-extra
 ```
 
-Copy and paste the following line for Ubuntu/Pop!\_OS 20.04 and above, followed by <kbd>Enter</kbd>:
+For Ubuntu/Pop!\_OS **18.04 and below,** copy and paste the following line, followed by <kbd>Enter</kbd>:
 
 ```
-sudo apt install -y gstreamer1.0-plugins-bad gstreamer1.0-plugins-ugly gstreamer1.0-plugins-good libavcodec-extra gstreamer1.0-libav chromium-codecs-ffmpeg-extra libdvd-pkg
+sudo apt install -y gstreamer1.0-plugins-bad gstreamer1.0-plugins-ugly libavcodec-extra gstreamer1.0-libav gstreamer1.0-fluendo-mp3 chromium-codecs-ffmpeg-extra
 ```
 
-To paste into the terminal, use the "Edit" Menu, or press <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>V</kbd>
+## Set up DVD Playback (optional)
 
-You may be prompted for your `[sudo] password`. If so, type in your regular login/user password, then press <kbd>Enter</kbd> again. You should see several lines of output in the terminal. The command may take a few minutes to complete.
+Once you see the command above has finished, enter the following command to additionally install and enable DVD playback:
 
-## Setup DVD Playback (optional)
+```
+sudo apt install -y libdvd-pkg
+```
 
-Once you see the command above has finished, enter in the following command to enable DVD playback:
+When you see the `Configuring libdvd-pkg` prompt, press `Enter` to select the `<Ok>` option, then press `Enter` again to select the `<Yes>` option. After the command has completed, you will also need to initialize the library with the following command:
 
 ```
 sudo dpkg-reconfigure libdvd-pkg
 ```
 
+At the prompt, press `Enter` to select `<Yes>`.
+
 ## Restart Your Computer
 
-After enabling codec support, it's recommended to restart your computer.
+After enabling codec support, it's recommended to restart your computer so any running software can load in the new codecs. You can do this with the top-right menu, or with the following command after saving and closing any other work:
+
+```
+sudo systemctl reboot
+```
 
 ## Useful Programs
 
-The program <u>VLC</u> is a excellent media player with support for DVDs, CDs, and most formats of media files.  It can be installed with the the <u>Pop!_Shop</u> in Pop!_OS, in the <u>Software Center</u> in Ubuntu, or with this command:
+The program <u>VLC</u> is an excellent media player with support for DVDs, CDs, and most formats of media files.  It can be installed with the the <u>Pop!\_Shop</u> in Pop!\_OS, with the <u>Software Center</u> in Ubuntu, or with this command:
 
 ```
-sudo apt install vlc
+sudo apt install -y vlc
 ```

content/codecs.md

@@ -30,7 +30,7 @@ The `nvidia-cuda-toolkit` package is [maintained by Ubuntu](https://packages.ubu
 
 The `nvidia-container-toolkit` package uses Docker containers to allow alternate versions of the CUDA libraries to be installed alongside the one included with the NVIDIA driver. You can see the different Docker images that are published by NVIDIA here: <https://hub.docker.com/r/nvidia/cuda/>
 
-This example installs a development enviroment with CUDA version 12.1.
+This example installs a development enviroment with CUDA version 12.4.
 
 #### Install Software
 
@@ -70,15 +70,15 @@ sudo systemctl restart docker
 Run this command to check the Docker configuration for CUDA:
 
 ```bash
-docker run --rm --runtime=nvidia --gpus all nvidia/cuda:12.1.0-devel-ubuntu22.04 nvidia-smi
+docker run --rm --runtime=nvidia --gpus all nvidia/cuda:12.4.0-devel-ubuntu22.04 nvidia-smi
 ```
 
 The output displays the CUDA version supported by the container:
 
 ```
-Thu Mar 23 14:43:51 2023       
+Thu Jun 13 14:43:51 2024       
 +-----------------------------------------------------------------------------+
-| NVIDIA-SMI 525.89.02    Driver Version: 525.89.02    CUDA Version: 12.1     |
+| NVIDIA-SMI 550.67.      Driver Version: 550.67       CUDA Version: 12.4     |
 |-------------------------------+----------------------+----------------------+
 | GPU  Name        Persistence-M| Bus-Id        Disp.A | Volatile Uncorr. ECC |
 | Fan  Temp  Perf  Pwr:Usage/Cap|         Memory-Usage | GPU-Util  Compute M. |
@@ -102,26 +102,26 @@ Thu Mar 23 14:43:51 2023
 Start a shell within the container:
 
 ```bash
-docker run -it --rm --runtime=nvidia --gpus all nvidia/cuda:12.1.0-devel-ubuntu22.04 bash
+docker run -it --rm --runtime=nvidia --gpus all nvidia/cuda:12.4.0-devel-ubuntu22.04 bash
 ```
 
 Commands can then be run with CUDA support:
 
 ```shell
 root@5397e7ea7f57:/# nvcc --version
 nvcc: NVIDIA (R) Cuda compiler driver
-Copyright (c) 2005-2023 NVIDIA Corporation
-Built on Tue_Feb__7_19:32:13_PST_2023
-Cuda compilation tools, release 12.1, V12.1.66
-Build cuda_12.1.r12.1/compiler.32415258_0
+Copyright (c) 2005-2024 NVIDIA Corporation
+Built on Thu_Mar_28_02:18:24_PDT_2024
+Cuda compilation tools, release 12.4, V12.4.131
+Build cuda_12.4.r12.4/compiler.34097967_0
 ```
 
 The container can be viewed and managed using `docker ps` in another terminal or tab:
 
 ```bash
 system76@pop-os:~$ docker ps
 CONTAINER ID   IMAGE                                 COMMAND   CREATED         STATUS         PORTS     NAMES
-5397e7ea7f57   nvidia/cuda:12.1.0-devel-ubuntu22.04   "/opt/nvidia/nvidia_…"   2 minutes ago   Up 2 minutes             boring_tesla
+5397e7ea7f57   nvidia/cuda:12.4.0-devel-ubuntu22.04   "/opt/nvidia/nvidia_…"   2 minutes ago   Up 2 minutes             boring_tesla
 ```
 
 The container ID can be referenced to copy files into and out of the container:
@@ -143,10 +143,10 @@ The binary (`c++11_cuda`) is built:
 ```
 root@5397e7ea7f57:~/cuda-samples/Samples/0_Introduction/c++11_cuda# ls -l
 total 6108
--rw-rw-r-- 1 1000 1000   13679 Mar 24 16:45 Makefile
+-rw-rw-r-- 1 1000 1000   13951 Mar 24 16:45 Makefile
 -rw-rw-r-- 1 1000 1000    2090 Mar 24 16:45 NsightEclipse.xml
 -rw-rw-r-- 1 1000 1000    3556 Mar 24 16:45 README.md
--rwxr-xr-x 1 root root 1881448 Mar 24 16:48 c++11_cuda
+-rwxr-xr-x 1 root root 2147784 Mar 24 16:48 c++11_cuda
 ...
 ```
 

content/cuda.md

@@ -91,4 +91,8 @@ sudo nvme smart-log /dev/nvme0n1
 
 ## Collect Logs
 
-The System76 Driver has the ability to generate a robust log file. To run the driver, access your Activities menu in the top left of your Desktop, type System76 and select the System76 driver. After opening the application, click the button in the bottom right to Create Log Files, then a log file will populate in your home folder. Please attach the log file in a reply to this ticket. If you are having any issues you can refer to this [article](/articles/log-files).
+If you are using Pop!\_OS, the Settings application has the ability to generate a robust log file. To generate a log file, open the Settings application, select the "Support" section, and click on the button named "Create Log Files". After you type your password into the prompt that appears, a log file will be generated in your home folder.
+
+If you are on a System76 computer _not_ running Pop!\_OS, use the System76 Driver to generate the log file. If the driver is not already installed, follow the steps in [this article to install it](https://support.system76.com/articles/system76-driver) before proceeding. To run the driver, access your Activities menu in the top left of your Desktop, type System76 and select the System76 driver. After opening the application, click the button in the bottom right to Create Log Files, then a log file will populate in your home folder.
+
+Please attach the log file in a reply to this ticket. If you are having any issues, you can refer to this [article](/articles/log-files).

content/freezing-behavior.md

@@ -5,13 +5,9 @@ description: >
 keywords:
   - System76
   - Pop
-  - 18.04
-  - 19.10
   - 20.04
-  - 20.10
-  - 21.04
-  - 21.10
   - 22.04
+  - 24.04
   - NVIDIA
   - Hybrid
   - Integrated
@@ -28,12 +24,12 @@ tableOfContents: true
 Many modern laptops with NVIDIA graphics cards have switchable graphics, which allows users to switch their primary GPU between the CPU's integrated graphics processor and the dedicated NVIDIA graphics card.
 The following System76 laptops have these switchable graphics capabilities:
 
-- Adder WS (addw1, addw2, addw3)
+- Adder WS (addw1 and newer)
 - Bonobo WS (bonw15)
 - Galago Pro (galp5 - NVIDIA models only)
-- Gazelle (gaze14, gaze15, gaze16, gaze17, gaze18)
+- Gazelle (gaze14 and newer)
 - Kudu (kudu6)
-- Oryx Pro (oryp4, oryp4-b, oryp5, oryp6, oryp7, oryp8, oryp9, oryp10, oryp11)
+- Oryx Pro (oryp4 and newer)
 - Serval WS (serw13)
 
 Pop!\_OS includes utilities for switching between these modes, which you can learn more about below.

content/graphics-switch-pop.md

@@ -5,13 +5,9 @@ description: >
 keywords:
   - System76
   - Ubuntu
-  - 18.04
-  - 19.10
   - 20.04
-  - 20.10
-  - 21.04
-  - 21.10
   - 22.04
+  - 24.04
   - NVIDIA
   - Hybrid
   - Integrated
@@ -27,12 +23,12 @@ tableOfContents: true
 
 Many modern laptops with NVIDIA graphics cards have switchable graphics, which allows users to switch their primary GPU between the CPU's integrated graphics processor and the dedicated NVIDIA graphics card. The following System76 laptops have these switchable graphics capabilities:
 
-- Adder WS (addw1, addw2, addw3)
+- Adder WS (addw1 and newer)
 - Bonobo WS (bonw15)
 - Galago Pro (galp5 - NVIDIA models only)
-- Gazelle (gaze14, gaze15, gaze16, gaze17, gaze18)
+- Gazelle (gaze14 and newer)
 - Kudu (kudu6)
-- Oryx Pro (oryp4, oryp4-b, oryp5, oryp6, oryp7, oryp8, oryp9, oryp10, oryp11)
+- Oryx Pro (oryp4 and newer)
 - Serval WS (serw13)
 
 ## Graphics modes