From aa3c5a41273bc219ef33b2ca9a20c7a477ce3c0c Mon Sep 17 00:00:00 2001
From: Victor Zverovich <viz@meta.com>
Date: Sat, 16 Sep 2023 08:20:27 -0700
Subject: [PATCH] Clarify I/O error handling

---
 doc/api.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/doc/api.rst b/doc/api.rst
index 0b3d0231e157..eacf740ad3a9 100644
--- a/doc/api.rst
+++ b/doc/api.rst
@@ -49,6 +49,10 @@ checked at compile time in C++20. To pass a runtime format string wrap it in
 
 *args* is an argument list representing objects to be formatted.
 
+I/O errors are reported as `std::system_error
+<https://en.cppreference.com/w/cpp/error/system_error>`_ exceptions unless
+specified otherwise.
+
 .. _format:
 
 .. doxygenfunction:: format(format_string<T...> fmt, T&&... args) -> std::string