brewery
notashelf /
fe175a7c5133f0e3c865d83d033edb9c43113317

beer

public

A terminal worth pouring time into

Star0tarball
clone
ssh://git@git.notashelf.dev:33/notashelf/beer.git

Commit fe175a7c5133

tarball

NotAShelf <raf@notashelf.dev> · 2026-07-06 07:20 UTC

unverified2 files changed+13-3
docs: document `BEER_CONFIG` and repeatable `--config` in manpages

Signed-off-by: NotAShelf <raf@notashelf.dev>
Change-Id: I13e8c8170e645c508b0fc2a3e567add96a6a6964
diff --git a/doc/beer.1.scd b/doc/beer.1.scdindex ab8ad4d..ca74c49 100644--- a/doc/beer.1.scd+++ b/doc/beer.1.scd@@ -21,8 +21,11 @@ search, mouse selection, and clipboard integration. 	Run as a daemon hosting multiple windows. (Not yet implemented.)  *--config* _PATH_-	Load configuration from _PATH_ instead of the default location (see-	*FILES*).+	Load configuration from _PATH_ on top of the defaults. Repeatable; when+	given more than once, later files override keys from earlier ones and+	have higher priority than files listed in *BEER_CONFIG* (see+	*ENVIRONMENT*). Without any *--config* flags, the default location is+	used (see *FILES*).  *-h*, *--help* 	Print usage and exit.@@ -103,6 +106,11 @@ notifications via *OSC 9*, *OSC 777*, and *OSC 99*. *TERM* 	Set to the configured terminal name (default _beer_) for the child. +*BEER_CONFIG*+	A colon-separated list of config file paths, like *PATH*. These are+	lower priority than paths given via *--config* so explicit flags always+	win. Empty elements are ignored.+ *BEER_LOG* 	Log filter, in the _tracing_ env-filter syntax (e.g. _debug_). diff --git a/doc/beer.toml.5.scd b/doc/beer.toml.5.scdindex c00d237..ddd1c25 100644--- a/doc/beer.toml.5.scd+++ b/doc/beer.toml.5.scd@@ -8,7 +8,9 @@ beer.toml - configuration file for _beer_(1)  *beer* reads a TOML configuration file from _$XDG_CONFIG_HOME/beer/beer.toml_, falling back to-_~/.config/beer/beer.toml_, or from the path given to *--config*. A missing+_~/.config/beer/beer.toml_. The *--config* flag (repeatable, later files+override earlier ones) and the *BEER_CONFIG* environment variable (colon-+separated paths, lowest priority) can supply additional files. A missing file uses the built-in defaults; a malformed file is reported and the defaults are used. Unknown keys are ignored, so a file written for a newer *beer* still loads.