Skip to content

docs: add Arch Linux appendix to installation guides - #12

Merged
sanohiro merged 1 commit into
sanohiro:mainfrom
kay-ws:docs/arch-linux-install
Apr 27, 2026
Merged

docs: add Arch Linux appendix to installation guides#12
sanohiro merged 1 commit into
sanohiro:mainfrom
kay-ws:docs/arch-linux-install

Conversation

@kay-ws

@kay-ws kay-ws commented Apr 26, 2026

Copy link
Copy Markdown
Contributor

Summary

Adds a "For Arch Linux Users" appendix to both docs/installation.md and docs/installation.ja.md, documenting the AUR install path as discussed in #11.

AUR package live since 2026-04-24: https://aur.archlinux.org/packages/bcon (community-maintained by @kay-ws).

Changes

The new section covers four subsections in parallel between the English and Japanese guides:

  1. Package managerpacmanapt mapping for the official-repo deps.
  2. AUR & AUR helpers — what AUR is, why an AUR helper is needed, and a yay bootstrap recipe (pacman -S --needed git base-develgit clone aur.archlinux.org/yay.gitmakepkg -si).
  3. Install bcon — the replacement for the existing Debian curl/apt flow: yay -S bcon.
  4. User Login Session — note that the AUR package places bcon-session and bcon.desktop in their final locations (/usr/bin/, /usr/share/xsessions/), so the manual cp step from the Debian section is unnecessary.

Notes

This PR matches the draft I posted in #11 with one minor cleanup — blank lines added after the four numbered-list titles (1. Package manager, 2. AUR ..., 3. Install bcon, 4. User Login Session) so CommonMark/GFM renders the title and body as separate paragraphs instead of running them together. Wording and structure are otherwise identical to the draft.

Validation

  • End-to-end install tested on a fresh Arch VM on 2026-04-24: yay -S bcon completed cleanly (~2m29s on 4 cores, 42 new packages, 946 MiB install size). Session files landed in the expected paths and the bcon xsession appeared in the DM picker.
  • GFM rendering verified locally — numbered list items now render with proper spacing both on GitHub and in offline GFM viewers.

Closes #11.

bcon is now available on the AUR (community-maintained by @kay-ws).
The appendix summarizes the Arch-specific deltas from the existing
Debian/Ubuntu flow: pacman vs apt, AUR helper bootstrap, yay -S bcon,
and the simplified login session (session files pre-installed by the
AUR package).
@sanohiro
sanohiro merged commit 92c025f into sanohiro:main Apr 27, 2026
1 check passed
@sanohiro

Copy link
Copy Markdown
Owner

Thanks for this and for maintaining the AUR package! Great to have Arch support officially documented.

sanohiro added a commit that referenced this pull request May 7, 2026
New features (contributed by @kay-ws):

Config discovery:
- Layered XDG-style merge: built-in defaults → /etc/bcon/config.toml
  (system) → ~/.config/bcon/config.toml (user override)
- Tables merge recursively; scalars and arrays replace wholesale
- BCON_CONFIG env var for single-file debug bypass
- Config::default_template() API for distributors

CLI:
- --init-config now accepts explicit target: system, user, or path
- sudo bcon --init-config=system deterministically writes to /etc/
- Legacy --init-config=vim,jp still writes to ~/.config/ (backward compat)

Also includes:
- Arch Linux installation docs (#12)
- libinput udev hotplug support (#10)
- Lenient Kitty graphics base64 decode (#7)

Contributors: @kay-ws

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Proposal: AUR packaging for Arch Linux users

2 participants