From dd48d067a6489b26f2e18d0ed09039aa263d5d4c Mon Sep 17 00:00:00 2001 From: Tracey Date: Tue, 30 Apr 2024 20:10:59 -0500 Subject: [PATCH 1/2] Update broken package check Add -r to xargs so if the check for broken packages finds none there is no confusing output. Minor grammatical fixes. --- docs/user/troubleshooting/index.md | 13 +++++++++---- 1 file changed, 9 insertions(+), 4 deletions(-) diff --git a/docs/user/troubleshooting/index.md b/docs/user/troubleshooting/index.md index 758f8e83d..4a5988169 100644 --- a/docs/user/troubleshooting/index.md +++ b/docs/user/troubleshooting/index.md @@ -5,15 +5,20 @@ summary: Basic troubleshooting for some of the most common Solus problems. # Troubleshooting Common Issues -This guide provides some basic troubleshooting instructions for when you have an issue in Solus. Before reporting bugs, it is important to validate your Solus installation doesn't suffer from missing files or disk corruption. Also ensuring the system is fully up to date as the bug may have already been fixed. +This guide provides some basic troubleshooting instructions for when you have an issue in Solus. Before reporting bugs, it is important to validate your Solus installation doesn't suffer from missing files or disk corruption. Also ensure the system is fully up to date as the bug may have already been fixed. -First of all perform a full system update `sudo eopkg up` (or via the Software Center). Then validate that packages are installed correctly and aren't missing files: (run this once, it will take some time and may not show much output) +First, perform a full system update on command line with `sudo eopkg up` (or via the Software Center). + +Next, validate that packages are installed correctly and aren't missing files. Run this once, it will take some time. If there are no broken packages on your system, there will be no output. Otherwise, you will see packages be reinstalled. ```bash -sudo eopkg check | grep Broken | awk '{print $4}' | xargs sudo eopkg it --reinstall +sudo eopkg check | grep Broken | awk '{print $4}' | xargs -r sudo eopkg it --reinstall ``` -Then reboot the system to make sure the issue still persists on a clean system. +Reboot the system and see if the issue is resolved. + +``` +:: ## Issues with Software Center or eopkg From ad6912e260dac0fd21ca3895998f76ca458fca08 Mon Sep 17 00:00:00 2001 From: David Harder Date: Sat, 4 May 2024 20:52:06 -0500 Subject: [PATCH 2/2] david nits --- docs/user/troubleshooting/index.md | 7 ++----- 1 file changed, 2 insertions(+), 5 deletions(-) diff --git a/docs/user/troubleshooting/index.md b/docs/user/troubleshooting/index.md index 4a5988169..64aad1b67 100644 --- a/docs/user/troubleshooting/index.md +++ b/docs/user/troubleshooting/index.md @@ -5,9 +5,9 @@ summary: Basic troubleshooting for some of the most common Solus problems. # Troubleshooting Common Issues -This guide provides some basic troubleshooting instructions for when you have an issue in Solus. Before reporting bugs, it is important to validate your Solus installation doesn't suffer from missing files or disk corruption. Also ensure the system is fully up to date as the bug may have already been fixed. +This guide provides some basic troubleshooting instructions for when you have an issue in Solus. Before reporting bugs, it is important to check that your Solus installation is not missing files, or suffering from a corrupted disk. You should also ensure your system is fully up to date as the bug may have already been fixed. -First, perform a full system update on command line with `sudo eopkg up` (or via the Software Center). +First, perform a full system update on command line with `sudo eopkg up` (or using the Software Center). Next, validate that packages are installed correctly and aren't missing files. Run this once, it will take some time. If there are no broken packages on your system, there will be no output. Otherwise, you will see packages be reinstalled. @@ -17,9 +17,6 @@ sudo eopkg check | grep Broken | awk '{print $4}' | xargs -r sudo eopkg it --rei Reboot the system and see if the issue is resolved. -``` -:: - ## Issues with Software Center or eopkg ### Can't install updates