put instructions in separate file

README.md

@@ -24,51 +24,7 @@ For the best performance, ensure you have the latest graphics drivers installed
 Breezy GNOME is in AUR (but not pacman, yet). To install: `yay -S breezy-desktop-gnome-git`
 
 #### Steam Deck Desktop Mode (writeable root filesystem)
-
+Fairly detailed instructions are [here](doc/steam-deck-desktop-mode.md)
-These instructions require making your filesystem read-write. Efforts have been made to use distrobox
-but so far have not succeeded. Please contribute if you have success with that!
-
-##### If your root is not already writeable, make it so
-```sh
-sudo steamos-readonly disable
-```
-##### If your pacman environment is not already initialized, make it so
-```sh
-sudo pacman-key --init
-sudo pacman-key --populate archlinux
-sudo pacman-key --populate holo
-```
-##### make sure /usr/share is in your XDG_DATA_DIRS variable
-##### if not, add :/usr/share to it
-##### load depends for breezy
-```sh
-sudo pacman -S --needed base-devel git
-# existing packages are reloaded here in order to install their header files
-sudo pacman -S glibc linux-api-headers holo-3.5/systemd-libs openssl libevdev libusb json-c curl hidapi python python-pydbus 'gnome-shell>=45.0' python-yaml
-```
-##### Install xr-driver-breezy-ghome-git
-```sh
-work=$(mktemp -d)
-cd $work
-mkdir xr-driver
-cd xr-driver
-curl 'https://aur.archlinux.org/cgit/aur.git/plain/PKGBUILD?h=xr-driver-breezy-gnome-git' > PKGBUILD
-curl 'https://aur.archlinux.org/cgit/aur.git/plain/hooks.install?h=xr-driver-breezy-gnome-git' > hooks.install
-mkpkg -si
-```
-##### Install breezy-desktop-gnome-git
-```sh
-cd $work
-mkdir breezy
-cd breezy
-curl 'https://aur.archlinux.org/cgit/aur.git/plain/PKGBUILD?h=breezy-desktop-gnome-git' > PKGBUILD
-```
-##### Make it read-only again (if desired)
-```sh
-sudo steamos-readonly enable
-```
-##### Thanks to TTachyon on Reddit for some very important info
-https://www.reddit.com/r/SteamDeck/comments/t92ozw/for_compiling_c_code
 
 #### All other distros
 

doc/steam-deck-desktop-mode.md

@@ -0,0 +1,61 @@
+# Installing Breezy Gnome desktop on Steam Deck (contributed by Bill Burdick)
+These instructions require making your filesystem read-write. Efforts have been made to use distrobox
+but so far have not succeeded. Please contribute if you have success with that!
+
+# Make sure you're running on at least 3.6, which might require switching to the beta or alpha channel
+## NOTE: gnome-shell --nested didn't work for me on 3.5 but it did when I updated to 3.6.
+I was getting errors:
+```
+Unrecognized option: -byteswappedclients
+```
+(with lots of other text).
+
+Seems related to this bug: https://bugs-devel.debian.org/cgi-bin/bugreport.cgi?bug=1050642 and SteamOS 3.5 has mutter 44.2
+# If your root is not already writeable, make it so
+```sh
+sudo steamos-readonly disable
+```
+# If your pacman environment is not already initialized, make it so
+```sh
+sudo pacman-key --init
+sudo pacman-key --populate archlinux
+sudo pacman-key --populate holo
+```
+# make sure /usr/share is in your XDG_DATA_DIRS variable
+# if not, add :/usr/share to it
+# load depends for breezy
+```sh
+sudo pacman -S --needed base-devel git
+# existing packages are reloaded here in order to install their header files
+sudo pacman -S glibc linux-api-headers systemd-libs openssl libevdev libusb json-c curl hidapi python python-pydbus 'gnome-shell>=45.0' python-yaml
+```
+# Install xr-driver-breezy-ghome-git
+```sh
+work=$(mktemp -d)
+cd $work
+mkdir xr-driver
+cd xr-driver
+curl 'https://aur.archlinux.org/cgit/aur.git/plain/PKGBUILD?h=xr-driver-breezy-gnome-git' > PKGBUILD
+curl 'https://aur.archlinux.org/cgit/aur.git/plain/hooks.install?h=xr-driver-breezy-gnome-git' > hooks.install
+makepkg -si
+```
+# Install breezy-desktop-gnome-git
+```sh
+cd $work
+mkdir breezy
+cd breezy
+curl 'https://aur.archlinux.org/cgit/aur.git/plain/PKGBUILD?h=breezy-desktop-gnome-git' > PKGBUILD
+makepkg -si
+```
+# Continue with wheaney's instructions
+[Instructions](../README.md#non-gnome-setup)
+# Thanks to TTachyon on Reddit for some very important info
+https://www.reddit.com/r/SteamDeck/comments/t92ozw/for_compiling_c_code
+# Docks
+My Steam Deck dock does not support displayport alt mode on any of its ports (except the one that goes into the deck of course). There are a few docks out there that do, but not many.
+If you need to use a third party dock with your glasses, make sure it has a port with the displayport alt mode symbol
+
+| like | ![image](small-usb-displayport-logo.png) | or | ![image](large-usb-displayport-logo.png) |
+|-|-|-|-|
+
+For reference, I'm using the Inateck 10-in-1 USB-C hub [(Amazon link)](https://www.amazon.com/dp/B0CCXZWS9C)