Fix issues with Pentium machines and their escaping phantom keystrokes by dumbing down kbd interactions with kernel,R1 FirstStorm release just about ready

README.md

@@ -0,0 +1,90 @@
+# Mentalnet GNU/Linux
+
+A light, TTY-only GNU/Linux distribution for 90s Intel Pentium-class
+(i586) machines, built with [Buildroot](https://buildroot.org).
+
+<p align="center">
+  <img src="logos/mnlogo-text.png" alt="Mentalnet GNU/Linux — Modern GNU/Linux for Legacy i586 Pentiums" width="400">
+</p>
+
+The ISO is a live CD: the entire system runs from the CD with a
+read-only root filesystem, and the same CD carries a built-in hard
+disk installer (`mentalnet-install`).
+
+## Current release
+
+**R1 "FirstStorm"** — named after DECO*27's
+*Chūlán ~First Storm~* (初嵐～First Storm～).
+
+## Versioning
+
+- Major releases bump the `R<n>` number (`R1`, `R2`, ...).
+- Minor releases keep the `R<n>` base version and use the codename as
+  the minor version.
+- All codenames are taken from Vocaloid, Hatsune Miku or Kasane Teto
+  songs.
+
+| Release | Codename | Song | Notes |
+|---------|----------|------|-------|
+| R1 | Mesmerizer | *Mesmerizer* — 32ki (Hatsune Miku & Kasane Teto) | Initial release |
+| R1 | **FirstStorm** | *Chūlán ~First Storm~ (初嵐～First Storm～)* — DECO*27 | **Current** — swap-free installer, true i586 support, terminal/input hardening, interrupt-storm fixes |
+
+## Quick facts
+
+| | |
+|---|---|
+| Login | `root` / `mnlinux` |
+| Hostname | `mentalnet` |
+| Kernel | `6.12.104-mentalnet-intel32` |
+| Media | Live CD with built-in installer |
+| CPU | i586 (Pentium / Pentium MMX) or any newer x86 |
+| RAM | 128 MB minimum (64 MB usually works) |
+
+## Security after install
+
+The default root password is **`mnlinux`** — please change it after
+installing:
+
+```
+passwd
+```
+
+Then, for day-to-day use, create a regular user and give it sudo
+privileges (sudo is included in the build):
+
+```
+adduser myuser
+```
+
+You have two options to grant sudo:
+
+- Add the user to the `sudo` group, which the shipped sudoers file
+  already trusts:
+
+  ```
+  addgroup myuser sudo
+  ```
+
+- Or, if you prefer the classic `wheel` group, enable it with
+  `visudo` (uncomment the `%wheel` line) and add the user to it:
+
+  ```
+  visudo
+  addgroup myuser wheel
+  ```
+
+**Verify that sudo works for the new user before locking root** —
+log in as the user and run, for example, `sudo ls /`.
+
+Once sudo is confirmed working, lock the root account so it cannot
+be accessed (SSH included):
+
+```
+passwd -l root
+```
+
+## Documentation
+
+The full install and test guide — hardware requirements, QEMU
+testing, the install walkthrough and troubleshooting — lives in
+[`board/mentalnet/INSTALL-GUIDE.md`](board/mentalnet/INSTALL-GUIDE.md).