Add documentation on how to run wlmaker & improve build instructions

[phkaeser]

As raised by @tstraus13 in https://github.com/phkaeser/wlmaker/issues/26#issuecomment-2198430399

• Document how to run wlmaker in standalone mode, including recently-added args.
• Document how to run wlmaker from the console.
• Document how to run it from a session manager (lightdm, ...).
• Document the packages required to build (pointing to the github workflow is OK).

[tstraus13]

So following the instructions. I am able to build everything but when I go to run it I am getting two errors. (I will also attach a screenshot)

(ERROR) render/wlr_renderer.c:423 Could not initialize rednerer (ERROR) src/server.c:175 Failed wlr_renderer_autocreate()

I initially tried in a Debian 12 VM and thought that may cause issues but I could run KDE on Wayland without issue. Then I tried on an old Thinkpad T410 on XFCE in X11 and I get the same error. Any recommendations? Thanks.

[alexmyczko]

@tstraus13 I usually put exec wlmaker in ~/.xsession or ~/.xsessionrc and run startx on the console (chvt 2, ctrl-alt-f2)

[phkaeser]

With #76, I refined the documentation on running wlmaker in various options.

Technically, startx with .xsession works, but the purpose is actually to run on Wayland directly :smile:

@tstraus13 -- #76 also has some debugging options. Basically to recommendations: What you're seeing is from wlroots; so (1) verify if this also happens for other wlroots compositors (eg. swaywm), and (2) setting WLR_RENDERER=pixman to force software rendering.

If that doesn't help => please share a full dump of your configure & compile log (including dependencies) to see if or what is missing.

[phkaeser]

Given this issue was scoped to "Add documentation", which is done with #74 , #75 and #76 => closing the issue here.

@tstraus13 => following above suggestion: If it keeps not working, please create a new issue with title "Fails to start with 'Could not initialize renderer'" or similar. Thanks!