From 8cc7ebe927512403cc06067c88b789ceaeda2b25 Mon Sep 17 00:00:00 2001
From: cinerea0 <cinerea0@protonmail.com>
Date: Wed, 14 Apr 2021 17:24:22 -0400
Subject: [PATCH] steam: move documentation to README.voidlinux

---
 srcpkgs/steam/INSTALL.msg            | 25 ++------------
 srcpkgs/steam/files/README.voidlinux | 49 ++++++++++++++++++++++++++++
 srcpkgs/steam/template               |  5 ++-
 3 files changed, 55 insertions(+), 24 deletions(-)
 create mode 100644 srcpkgs/steam/files/README.voidlinux

diff --git a/srcpkgs/steam/INSTALL.msg b/srcpkgs/steam/INSTALL.msg
index 196c392f45be..3f33b10f959e 100644
--- a/srcpkgs/steam/INSTALL.msg
+++ b/srcpkgs/steam/INSTALL.msg
@@ -1,23 +1,2 @@
-Steam on x86_64 requires support for OpenGL/Vulkan in 32bits mode,
-the 32bit packages are available in the `multilib` repository.
-
-	# xbps-install -Syv void-repo-multilib{,-nonfree}
-	# xbps-install -S
-
-Generic (for all systems):
-
-	- libgcc-32bit libstdc++-32bit libdrm-32bit libglvnd-32bit
-
-For users of the open source drivers:
-
-	- mesa-dri-32bit
-
-For users of the proprietary NVIDIA driver:
-
-	- nvidia-libs-32bit (latest nvidia package)
-	- nvidia390-libs-32bit (latest previous package)
-	- nvidia340-libs-32bit (latest package for old GPUs)
-
-For mesa users this would result in:
-
-	# xbps-install -Syv libgcc-32bit libstdc++-32bit libdrm-32bit libglvnd-32bit mesa-dri-32bit
+Consult /usr/share/doc/steam/README.voidlinux for further installation
+instructions and troubleshooting information.
diff --git a/srcpkgs/steam/files/README.voidlinux b/srcpkgs/steam/files/README.voidlinux
new file mode 100644
index 000000000000..25f226d921fb
--- /dev/null
+++ b/srcpkgs/steam/files/README.voidlinux
@@ -0,0 +1,49 @@
+Steam on i686 should work without needing to install any extra packages.
+Steam on x86_64 requires support for OpenGL/Vulkan in 32bits mode,
+the 32bit packages are available in the multilib repository.
+
+	# xbps-install -S void-repo-multilib{,-nonfree}
+	# xbps-install -S
+
+Generic (for all systems):
+
+	- libgcc-32bit libstdc++-32bit libdrm-32bit libglvnd-32bit
+
+For users of the open source drivers:
+
+	- mesa-dri-32bit
+
+For users of the proprietary NVIDIA driver:
+
+	- nvidia-libs-32bit (latest nvidia package)
+	- nvidia390-libs-32bit (latest previous package)
+	- nvidia340-libs-32bit (latest package for old GPUs)
+
+For mesa users this would result in:
+
+	# xbps-install -S libgcc-32bit libstdc++-32bit libdrm-32bit libglvnd-32bit mesa-dri-32bit
+
+The dbus service must be enabled, and the mono package will need to be
+installed for some games to function.
+
+If games are running slowly or not at all, or there are issues with network
+streaming, verify that your user belongs to the video group.
+
+If your audio is not working, try installing pulseaudio and
+alsa-plugins-pulseaudio.
+
+If you are encountering runtime errors, the Steam Ubuntu bootstrap tarball might
+be using an incompatible libstdc++ library. You can verify this by running the
+following command:
+
+	$ LIBGL_DEBUG=verbose steam
+
+If that is the issue, removing the supplied libstdc++ from
+~/.local/share/steam will fix it. Note that this is a temporary solution, as
+this file will be restored every time the Steam client is updated. For a more
+reliable solution, you can try overriding problematic libraries with
+LD_PRELOAD:
+
+	$ LD_PRELOAD='/usr/$LIB/libstdc++.so.6 /usr/$LIB/libgcc_s.so.1 /usr/$LIB/libxcb.so.1' steam
+
+For convenience, you can put this in a script or an alias.
diff --git a/srcpkgs/steam/template b/srcpkgs/steam/template
index 972db525e1eb..1574edc98dd1 100644
--- a/srcpkgs/steam/template
+++ b/srcpkgs/steam/template
@@ -1,7 +1,7 @@
 # Template file for 'steam'
 pkgname=steam
 version=1.0.0.70
-revision=1
+revision=2
 archs="i686 x86_64"
 wrksrc=steam-launcher
 depends="zenity xz curl dbus freetype gdk-pixbuf hicolor-icon-theme desktop-file-utils
@@ -30,4 +30,7 @@ do_install() {
 	# Device support for Steam-related hardware (e.g. controllers over Steam Link)
 	vinstall ${FILESDIR}/60-steam-input.rules 644 usr/lib/udev/rules.d
 	vinstall ${FILESDIR}/60-steam-vr.rules 644 usr/lib/udev/rules.d
+
+	# Void-specific documentation.
+	vdoc "${FILESDIR}/README.voidlinux"
 }