Commit Graph

4 Commits

Author SHA1 Message Date
bsncubed b533d35f95 docs: document the OpenGL requirement and the RDP workaround
haul compiles cleanly on Windows and then fails at startup inside an RDP
session, because Remote Desktop's display driver provides no usable OpenGL and
Fyne needs 2.1+. Same for Hyper-V, VMs without 3D, and Microsoft Basic Display
Adapter.

Documents deploying Mesa's llvmpipe renderer beside haul.exe, and two things
that are easy to get wrong: all ~19 DLLs from x64 are needed rather than just
opengl32.dll, since that file is now only a front-end for the others; and a
local opengl32.dll shadows the system one, so it forces software rendering even
on machines with a working GPU.

Also adds OpenGL to the runtime requirements table, which only mentioned
needing a display server.

Verified in an RDP session.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-07-30 21:58:02 +10:00
bsncubed 47ad62bb84 docs: add a proper Windows build section
Windows previously got one line pointing vaguely at MSYS2, while every other
platform got real commands — and the README's main instruction is `make build`,
which stock Windows cannot run at all.

Covers the three ways Windows actually differs: cgo needs a GCC-style compiler
(MSVC will not do), there is no make, and a GUI build needs -H=windowsgui or
Windows opens a console window behind the app on every launch. The Makefile
does not pass that flag since it targets Unix, so the section gives the direct
go build command and names the .exe output explicitly.

Also notes that Windows, unlike Linux, needs no graphics dev packages because
OpenGL ships with the OS.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-07-30 20:22:30 +10:00
bsncubed 54f8dbffe7 docs: make the Go toolchain an explicit prerequisite
Building needs both Go and a C toolchain, but only the C toolchain had install
commands — so the macOS path read as though `xcode-select --install` was the
whole job. Running it and being told the tools are already present looks like
success right up until `make build` fails with `go: command not found`.

Splits Prerequisites into two numbered steps with install commands for each,
`brew install go` on macOS, and says plainly that both are required.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-07-30 00:00:50 +10:00
bsncubed df42f240bf docs: add README
Covers what haul is, how to build it, and how to use it.

The build section is deliberately detailed about cgo: haul needs a C compiler
and the platform graphics headers, unlike dial, and cross-compiling needs a
per-target toolchain rather than just GOOS/GOARCH. Documents fyne-cross as the
practical route to Windows and macOS builds.

Claims are limited to what the code actually does — SFTP only, resume within a
session only, and ~/.ssh/config treated as read-only.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-07-29 23:25:58 +10:00