Repository navigation
docs: add a full "Building on Linux" section - #1
Merged
Merged
Conversation
Replaces the two-line Linux build note with a step-by-step guide: - compiler and graphics header packages for Debian/Ubuntu (same as CI), Fedora and Arch - installing Go, including how Go 1.21+ fetches the go.mod version itself - building, version stamping, running, and where settings/downloads go - optional: CI checks, release-style packaging, a .desktop menu entry - a note on building inside WSL - a troubleshooting table for common cgo/header/OpenGL errors Also updates the package list in build.sh's header comment to include the Wayland headers GLFW 3.4 needs, matching the CI workflow. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01D2Ppju4rH8FQpuXyDyWfaa
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Replaces the two-line Linux build note under Building from source with a step-by-step Building on Linux section, and adds it to the table of contents.
What it covers
go.modversion by itself. Plus an exact-version install that reads the version fromgo.mod, so it won't go stale.VERSION=stamping, running, and where settings and received files end up.go vet/go testchecks as CI, release-style.tar.gz+.sha256packaging, and a.desktopapp-menu entry.Also updates the package list in
build.sh's header comment to includelibxkbcommon-dev libwayland-dev, to match the CI workflow.How it was checked
sh -n build.shpasses, theawkthat reads the Go version fromgo.modprints1.27.1, the.desktopsnippet was run in a throwaway home folder, and all the new anchor links resolve.