From 14bd57d0a78dcd98449597fd3e19749799e36935 Mon Sep 17 00:00:00 2001
From: Konstantin Belousov <kib@FreeBSD.org>
Date: Sat, 27 Dec 2025 18:21:37 +0200
Subject: [PATCH] exterror.9: describe formatting of optional arguments

Reviewed by:	emaste, mckusick
Sponsored by:	The FreeBSD Foundation
MFC after:	1 week
Differential revision:	https://reviews.freebsd.org/D54380
---
 share/man/man9/exterror.9 | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/share/man/man9/exterror.9 b/share/man/man9/exterror.9
index fd4b732b821..a7c7a11d131 100644
--- a/share/man/man9/exterror.9
+++ b/share/man/man9/exterror.9
@@ -90,6 +90,16 @@ The
 .Fn EXTERROR
 macro can take two optional 64-bit integer arguments,
 whose meaning is specific to the subsystem.
+The format string may include up to two printf-like format
+specifiers to insert the optional argument values in the
+user output, which is done in userspace.
+.Pp
+The format specifier must be for an integer type, and include the
+.Dq j
+format modifier to accept only the types
+.Vt intmax_t
+or
+.Vt uintmax_t .
 .El
 .Pp
 The strings passed as the second argument are only retained