From acbb0f5a572282fc780318de98e24570fd51065a Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Mike=20F=C3=A4hrmann?= Date: Tue, 8 Mar 2022 21:11:06 +0100 Subject: [PATCH] clarify 'metadata.mtime' usage and shortcomings (#2307) --- docs/configuration.rst | 12 +++++++++++- 1 file changed, 11 insertions(+), 1 deletion(-) diff --git a/docs/configuration.rst b/docs/configuration.rst index a61aec1f..234d1433 100644 --- a/docs/configuration.rst +++ b/docs/configuration.rst @@ -1980,7 +1980,7 @@ Description extractor.skeb.sent-requests -------------------------- +---------------------------- Type ``bool`` Default @@ -3128,6 +3128,16 @@ Description Set modification times for generated metadata files according to the accompanying downloaded file. + Enabling this option will only have an effect + *if* there is actual ``mtime`` metadata available, that is + + * after a file download (``"event": "file"`` (default), ``"event": "after"``) + * when running *after* an ``mtime`` post processes for the same `event `__ + + For example, a ``metadata`` post processor for ``"event": "post"`` will + *not* be able to set its file's modification time unless an ``mtime`` + post processor with ``"event": "post"`` runs *before* it. + mtime.event -----------