summaryrefslogtreecommitdiff
path: root/man/mcpu-cpp.1
diff options
context:
space:
mode:
authorkx <kx@radix-linux.su>2026-10-02 08:45:51 +0300
committerkx <kx@radix-linux.su>2026-10-02 08:45:51 +0300
commit9d5894a43e3b4dcc4c3b2756b289aba51eef6c63 (patch)
tree5df3a0f2d7c387180da675aec606e276c0d76f11 /man/mcpu-cpp.1
parentba1b04d64bdfaf377915b22f77520216ebe47674 (diff)
downloadmcpu-cpp-9d5894a43e3b4dcc4c3b2756b289aba51eef6c63.tar.xz
Move per-user configuration to /home/kx/.mcpu/etc/mcpu-cpp.conf and add --sys-root=PATH
Diffstat (limited to 'man/mcpu-cpp.1')
-rw-r--r--man/mcpu-cpp.122
1 files changed, 19 insertions, 3 deletions
diff --git a/man/mcpu-cpp.1 b/man/mcpu-cpp.1
index 489de41..bed892d 100644
--- a/man/mcpu-cpp.1
+++ b/man/mcpu-cpp.1
@@ -1,4 +1,4 @@
-.TH MCPU-CPP 1 "October 2026" "MCPU-CPP 1.0.2" "User Commands"
+.TH MCPU-CPP 1 "October 2026" "MCPU-CPP 1.0.3" "User Commands"
.SH NAME
mcpu-cpp \- preprocessor for MCPU languages
.SH SYNOPSIS
@@ -299,6 +299,14 @@ as the explicit configuration layer on top of runtime-derived defaults.
.B --no-config
Do not read configuration files. Runtime-derived defaults remain active.
.TP
+.BI --sys-root= PATH
+Use
+.I PATH
+as the MCPU system root and do not read configuration files. The effective
+system include tree is
+.IR PATH/include .
+A relative path is resolved against the invocation working directory.
+.TP
.BR -v , " --verbose"
Print configuration and include activity.
.TP
@@ -351,9 +359,17 @@ Configuration layers are applied in increasing priority:
.nf
<runtime-root>/etc/mcpu-cpp.conf
/etc/mcpu/mcpu-cpp.conf
-$HOME/.mcpu/mcpu-cpp.conf
+$HOME/.mcpu/etc/mcpu-cpp.conf
.fi
.PP
+With
+.BI --sys-root= PATH
+these configuration files are not read and
+.I PATH/include
+becomes the effective system include root. This option therefore also
+suppresses an explicitly named
+.BR --config-file .
+.PP
The user configuration path variables are
.BR MCPU_CPP_INCLUDE_PATH ,
.BR MCPU_CPP_AFTER_INCLUDE_PATH ,
@@ -414,7 +430,7 @@ Configuration installed with the relocatable MCPU runtime tree.
.I /etc/mcpu/mcpu-cpp.conf
Optional machine-wide configuration override.
.TP
-.I $HOME/.mcpu/mcpu-cpp.conf
+.I $HOME/.mcpu/etc/mcpu-cpp.conf
Optional per-user configuration override with the highest normal configuration
priority.
.SH EXIT STATUS