Compare commits

..
Author SHA1 Message Date
Ian Douglas Scott 1c873bfcf5 Add a DEBUGGING.md file with some information useful for debugging
I have included information about various things I've used for debugging
COSMIC. More could definitely be added.

It seems good to have some central resource for this. Though not
everything listed here is very straightforward to use.
2024-07-25 19:04:41 -07:00
23 changed files with 27 additions and 80 deletions
+6 -30
View File
@@ -1,6 +1,6 @@
# COSMIC Desktop
Currently an incomplete **alpha**. Testing instructions below for various distributions.
Currently an incomplete **pre-alpha**. Testing instructions below for various distributions.
## Components of COSMIC Desktop
@@ -124,15 +124,13 @@ We do our best to keep the referenced submodule commits in this repository build
Notes on versioning and packaging all these components together properly will be added at a later stage once COSMIC DE gets its first release.
## Installing on Pop!_OS
COSMIC DE is in its first alpha release. Using and testing the alpha is welcome. Bugs and breakage are expected.
COSMIC DE is near its first alpha release. Using and testing the pre-alpha is welcome. Bugs and breakage are expected.
#### Enable Wayland
`sudo nano /etc/gdm3/custom.conf`
Change `WaylandEnable` to `true`:
```
Change to true
WaylandEnable=true
```
Reboot for this change to take effect.
@@ -142,7 +140,7 @@ Reboot for this change to take effect.
sudo nano /usr/lib/udev/rules.d/61-gdm.rules
```
Look for `LABEL="gdm_prefer_xorg"` and `LABEL="gdm_disable_wayland"`. Add `#` to the `RUN` statements so they look like this:
Look for `LABEL="gdm_prefer_xorg"` and `LABEL="gdm_disable_wayland"`, add `#` to the `RUN` statement so it will look like this
```
LABEL="gdm_prefer_xorg"
@@ -166,8 +164,8 @@ sudo systemctl restart gdm
After logging out, click on your user and there will be a sprocket at the bottom right. Change the setting to COSMIC. Proceed to log in.
## Installing on Arch Linux
Install via [cosmic-session](https://archlinux.org/packages/extra/x86_64/cosmic-session/) or the [cosmic](https://archlinux.org/groups/x86_64/cosmic/) group, e.g.:
`pacman -S cosmic-session` or `pacman -S cosmic`
Installing via the preferred AUR helper is possible the usual way, e.g.:
`paru -S cosmic-session-git` or `yay -S cosmic-session-git`
Then log out, click on your user, and a sprocket at the bottom right shows an additional entry alongside your desktop environments. Change to COSMIC and proceed with log in.
For a more detailed discussion, consider the [relevant section in the Arch wiki](https://wiki.archlinux.org/title/COSMIC).
@@ -182,28 +180,6 @@ dnf install cosmic-desktop
Then log out, click on your user, and a sprocket at the bottom right shows an additional entry alongside your desktop environments. Change to COSMIC and proceed with log in.
For further information, you may check the [COPR page](https://copr.fedorainfracloud.org/coprs/ryanabx/cosmic-epoch/).
## Installing on openSUSE tumbleweed
Cosmic can be installed by adding X11:COSMIC:Factory repo with opi.
```
opi patterns-cosmic
```
Select X11:COSMIC:Factory, after installing keep the repo.
Then log out, click on your user, and a sprocket at the bottom right shows an additional entry alongside your desktop environments. Change to COSMIC and proceed with log in.
For further information, you may check the [OBS page](https://build.opensuse.org/project/show/X11:COSMIC:Factory).
## Installing on Gentoo Linux
COSMIC can be installed on Gentoo via a custom overlay. Add the overlay using your preferred overlay manager (such as eselect), and then install the desktop environment:
`eselect repository add cosmic-overlay git https://github.com/fsvm88/cosmic-overlay.git`
Next, install the COSMIC desktop environment and its associated themes:
`emerge -1 cosmic-meta pop-theme-meta -pv`
Then log out, click on your user, and a sprocket at the bottom right shows an additional entry alongside your desktop environments. Change to COSMIC and proceed with log in.
For further information, you may check the [Overlay Repository](https://github.com/fsvm88/cosmic-overlay).
## Contact
- [Mattermost](https://chat.pop-os.org/)
- [Twitter](https://twitter.com/pop_os_official)
-29
View File
@@ -1,29 +0,0 @@
#!/usr/bin/env bash
set -e
TAG="$1"
if [ -z "$TAG" ]
then
echo "$0 [tag]" >&2
exit 1
fi
echo "Do you want to tag the current state of cosmic-epoch with the tag $TAG? (y/N)"
read answer
if [ "$answer" != "y" ]
then
echo "Did not answer y, exiting" >&2
exit 1
fi
set -x
git fetch --recurse-submodules
git tag --force "$TAG"
git submodule foreach git tag --force "$TAG"
git push --force origin tag "$TAG"
git submodule foreach git push --force origin tag "$TAG"