From 6ea4278a512bc9f1f816844222e65a4ea670db8e Mon Sep 17 00:00:00 2001
From: jvoisin
Date: Fri, 24 Oct 2025 23:50:18 +0200
Subject: feat(log): add the possibility to log to a file

---
 doc/source/config.rst | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

(limited to 'doc')

diff --git a/doc/source/config.rst b/doc/source/config.rst
index 64d3591..2053c2f 100644
--- a/doc/source/config.rst
+++ b/doc/source/config.rst
@@ -139,19 +139,21 @@ log_media
 ^^^^^^^^^
 
 This configuration variable allows to specify how logs should be written,
-either via ``php`` or ``syslog``.
+either via ``php``, ``syslog``, or `file:`.
 
 ::
 
   sp.log_media("php");
   sp.log_media("syslog");
+  sp.log_media("file:/var/log/snuffleupagus.log");
 
 The default value for ``sp.log_media`` is ``php``, to respect the `principle of
 least astonishment
 <https://en.wikipedia.org/wiki/Principle_of_least_astonishment>`__. But since
 it's `possible to modify php's logging system via php
 <https://www.php.net/manual/en/errorfunc.configuration.php>`__, it's
-heavily recommended to use the ``syslog`` option instead.
+heavily recommended to use the ``syslog`` option instead. The ``file:` option
+might be useful if you're using Snuffleupagus to fuzz or audit a codebase.
 
 log_max_len
 ^^^^^^^^^^^
-- 
cgit v1.3