[docs/configuration] update 'Logging Configuration' defaults

This commit is contained in:
Mike Fährmann
2025-12-07 10:09:43 +01:00
parent da46d4fc87
commit b5712e7959

View File

@@ -7842,8 +7842,6 @@ Type
Description Description
File to write external URLs unsupported by *gallery-dl* to. File to write external URLs unsupported by *gallery-dl* to.
The default `Format String`_ here is ``"{message}"``.
output.errorfile output.errorfile
---------------- ----------------
@@ -7853,8 +7851,6 @@ Type
Description Description
File to write input URLs which returned an error to. File to write input URLs which returned an error to.
The default `Format String`_ here is also ``"{message}"``.
When combined with When combined with
``-I``/``--input-file-comment`` or ``-I``/``--input-file-comment`` or
``-x``/``--input-file-delete``, ``-x``/``--input-file-delete``,
@@ -9547,7 +9543,12 @@ Description
`path <https://github.com/mikf/gallery-dl/blob/v1.27.0/gallery_dl/path.py#L27>`__, `path <https://github.com/mikf/gallery-dl/blob/v1.27.0/gallery_dl/path.py#L27>`__,
and `keywords` objects and their attributes, for example and `keywords` objects and their attributes, for example
``"{extractor.url}"``, ``"{path.filename}"``, ``"{keywords.title}"`` ``"{extractor.url}"``, ``"{path.filename}"``, ``"{keywords.title}"``
* Default: ``"[{name}][{levelname}] {message}"`` * Default:
``"[{name}][{levelname}] {message}"`` for
`logfile <output.logfile_>`__,
``"{message}"`` for
`unsupportedfile <output.unsupportedfile_>`__ and
`errorfile <output.errorfile_>`__
* format-date * format-date
* Format string for ``{asctime}`` fields in logging messages * Format string for ``{asctime}`` fields in logging messages
(see `strftime() directives <https://docs.python.org/3/library/time.html#time.strftime>`__) (see `strftime() directives <https://docs.python.org/3/library/time.html#time.strftime>`__)
@@ -9562,15 +9563,24 @@ Description
* Mode in which the file is opened; * Mode in which the file is opened;
use ``"w"`` to truncate or ``"a"`` to append use ``"w"`` to truncate or ``"a"`` to append
(see |open()|_) (see |open()|_)
* Default: ``"w"`` * Default:
``"w"`` for
`logfile <output.logfile_>`__ and
`unsupportedfile <output.unsupportedfile_>`__,
``"a"`` for
`errorfile <output.errorfile_>`__
* encoding * encoding
* File encoding * File encoding
* Default: ``"utf-8"`` * Default: ``"utf-8"``
* defer * defer
* Defer file opening/creation until writing the first logging message * Defer file opening/creation until writing the first logging message
* Default: * Default:
``true`` for `errorfile <output.errorfile_>`__, ``false`` for
``false`` otherwise `logfile <output.logfile_>`__,
``true`` for
`unsupportedfile <output.unsupportedfile_>`__ and
`errorfile <output.errorfile_>`__
Note Note
path, mode, encoding, and defer path, mode, encoding, and defer
are only applied when configuring logging output to a file. are only applied when configuring logging output to a file.