Standard fenrir backgrounding and -d flags restored.

docs/fenrir.1

@@ -21,6 +21,9 @@ Run these commands from the checkout root after building
 \f[I]# Linux text console, with console and keyboard device access\f[R]
 sudo ./fenrir
 
+\f[I]# Linux console in the foreground (also use \-f with service managers)\f[R]
+sudo ./fenrir \-f
+
 \f[I]# X11 terminal, as your regular user\f[R]
 \&./fenrir \-x
 
@@ -28,8 +31,19 @@ sudo ./fenrir
 \&./fenrir \-x \-\-keyboard\-layout laptop
 .EE
 .PP
-Fenrir runs in the foreground.
-Press \f[B]Fenrir+Q\f[R] to quit.
+Console mode starts in the background by default.
+Add \f[CR]\-f\f[R] to keep it in the foreground, including under a
+service manager.
+The launcher returns after the reader initializes and reports startup
+failures in the launching terminal.
+Use \f[CR]\-\-debug\-file PATH\f[R] to retain diagnostics after
+detaching.
+Help, version, and configuration\-only commands always run in the
+foreground.
+.PP
+X11 mode (\f[CR]\-x\f[R]) always stays in the foreground because it owns
+the terminal and its child shell.
+Press \f[B]Fenrir+Q\f[R] to quit either mode.
 Run only one reader on a given Linux console.
 Separate X11 terminal instances can run at once.
 .PP
@@ -550,6 +564,13 @@ Purpose: Show usage and options
 Purpose: Print version and release channel
 .RE
 .IP \(bu 2
+\f[B]\-f\f[R]
+.RS 2
+.PP
+Purpose: Keep console mode in the foreground (always enabled with
+\f[CR]\-x\f[R])
+.RE
+.IP \(bu 2
 \f[B]\-x\f[R]
 .RS 2
 .PP

docs/fenrir.adoc

@@ -17,6 +17,9 @@ Run these commands from the checkout root after building `fenrir`:
 # Linux text console, with console and keyboard device access
 sudo ./fenrir
 
+# Linux console in the foreground (also use -f with service managers)
+sudo ./fenrir -f
+
 # X11 terminal, as your regular user
 ./fenrir -x
 
@@ -24,9 +27,17 @@ sudo ./fenrir
 ./fenrir -x --keyboard-layout laptop
 ----
 
-Fenrir runs in the foreground. Press *Fenrir{plus}Q* to quit. Run only
-one reader on a given Linux console. Separate X11 terminal instances can
-run at once.
+Console mode starts in the background by default. Add `-f` to keep it in
+the foreground, including under a service manager. The launcher returns
+after the reader initializes and reports startup failures in the
+launching terminal. Use `--debug-file PATH` to retain diagnostics after
+detaching. Help, version, and configuration-only commands always run in
+the foreground.
+
+X11 mode (`-x`) always stays in the foreground because it owns the
+terminal and its child shell. Press *Fenrir{plus}Q* to quit either mode.
+Run only one reader on a given Linux console. Separate X11 terminal
+instances can run at once.
 
 X11 mode starts a shell in a new PTY. The launching terminal must supply
 valid `DISPLAY` and `WINDOWID` environment variables. Keyboard
@@ -384,6 +395,8 @@ reference.
 
 |`--version` |Print version and release channel
 
+|`-f` |Keep console mode in the foreground (always enabled with `-x`)
+
 |`-x` |Start a shell inside this X11 terminal
 
 |`--config PATH` |Load a specific TOML settings file

docs/user.md

@@ -16,6 +16,9 @@ Run these commands from the checkout root after building `fenrir`:
 # Linux text console, with console and keyboard device access
 sudo ./fenrir
 
+# Linux console in the foreground (also use -f with service managers)
+sudo ./fenrir -f
+
 # X11 terminal, as your regular user
 ./fenrir -x
 
@@ -23,8 +26,16 @@ sudo ./fenrir
 ./fenrir -x --keyboard-layout laptop
 ```
 
-Fenrir runs in the foreground. Press **Fenrir+Q** to quit. Run only one reader
-on a given Linux console. Separate X11 terminal instances can run at once.
+Console mode starts in the background by default. Add `-f` to keep it in the
+foreground, including under a service manager. The launcher returns after the
+reader initializes and reports startup failures in the launching terminal.
+Use `--debug-file PATH` to retain diagnostics after detaching. Help, version,
+and configuration-only commands always run in the foreground.
+
+X11 mode (`-x`) always stays in the foreground because it owns the terminal
+and its child shell. Press **Fenrir+Q** to quit either mode. Run only one
+reader on a given Linux console. Separate X11 terminal instances can run at
+once.
 
 X11 mode starts a shell in a new PTY. The launching terminal must supply valid
 `DISPLAY` and `WINDOWID` environment variables. Keyboard interception is scoped
@@ -327,6 +338,7 @@ Fenrir runs as `fenrir [options]`. Use `--help` for the built-in reference.
 | --- | --- |
 | `--help` | Show usage and options |
 | `--version` | Print version and release channel |
+| `-f` | Keep console mode in the foreground (always enabled with `-x`) |
 | `-x` | Start a shell inside this X11 terminal |
 | `--config PATH` | Load a specific TOML settings file |
 | `--keyboard-layout NAME_OR_PATH` | Select a named layout or TOML file |

docs/user.txt

@@ -15,15 +15,26 @@ Run these commands from the checkout root after building fenrir:
     # Linux text console, with console and keyboard device access
     sudo ./fenrir
 
+    # Linux console in the foreground (also use -f with service managers)
+    sudo ./fenrir -f
+
     # X11 terminal, as your regular user
     ./fenrir -x
 
     # Either mode can select the laptop layout
     ./fenrir -x --keyboard-layout laptop
 
-Fenrir runs in the foreground. Press Fenrir+Q to quit. Run only one
-reader on a given Linux console. Separate X11 terminal instances can run
-at once.
+Console mode starts in the background by default. Add -f to keep it in
+the foreground, including under a service manager. The launcher returns
+after the reader initializes and reports startup failures in the
+launching terminal. Use --debug-file PATH to retain diagnostics after
+detaching. Help, version, and configuration-only commands always run in
+the foreground.
+
+X11 mode (-x) always stays in the foreground because it owns the
+terminal and its child shell. Press Fenrir+Q to quit either mode. Run
+only one reader on a given Linux console. Separate X11 terminal
+instances can run at once.
 
 X11 mode starts a shell in a new PTY. The launching terminal must supply
 valid DISPLAY and WINDOWID environment variables. Keyboard interception
@@ -357,6 +368,9 @@ Fenrir runs as fenrir [options]. Use --help for the built-in reference.
 
   --version                            Print version and release channel
 
+  -f                                   Keep console mode in the foreground
+                                       (always enabled with -x)
+
   -x                                   Start a shell inside this X11
                                        terminal