rename 'image-*' & 'chapter-*' options to 'file-*' & 'child-*'

keep support for both names, e.g. file-filter & image-filter,
while prioritizing the new names

docs/configuration.rst

@@ -1515,6 +1515,8 @@ Description
     Use fallback download URLs when a download fails.
 
 
+extractor.*.file-range
+----------------------
 extractor.*.image-range
 -----------------------
 Type
@@ -1546,19 +1548,23 @@ extractor.*.post-range
 Type
     ``string``
 Description
-    Like `image-range <extractor.*.image-range_>`__,
+    Like `file-range <extractor.*.file-range_>`__,
     but for posts.
 
 
+extractor.*.child-range
+-----------------------
 extractor.*.chapter-range
 -------------------------
 Type
     ``string``
 Description
-    Like `image-range <extractor.*.image-range_>`__,
+    Like `file-range <extractor.*.file-range_>`__,
     but for child extractors handling manga chapters, external URLs, etc.
 
 
+extractor.*.file-filter
+-----------------------
 extractor.*.image-filter
 ------------------------
 Type
@@ -1584,10 +1590,14 @@ Example
     * ``"post['id'] > 12345"``
     * ``["date >= datetime(2025, 5, 1)", "print(post_id)"]``
 Description
-    Like `image-filter <extractor.*.image-filter_>`__,
+    Like `file-filter <extractor.*.file-filter_>`__,
     but for posts.
 
+    Available values are the directory-specific ones listed by ``-K`` or ``-j``.
 
+
+extractor.*.child-filter
+------------------------
 extractor.*.chapter-filter
 --------------------------
 Type
@@ -1597,10 +1607,12 @@ Example
     * ``"lang == 'en'"``
     * ``["language == 'French'", "10 <= chapter < 20"]``
 Description
-    Like `image-filter <extractor.*.image-filter_>`__,
+    Like `file-filter <extractor.*.file-filter_>`__,
     but for child extractors handling manga chapters, external URLs, etc.
 
 
+extractor.*.file-unique
+-----------------------
 extractor.*.image-unique
 ------------------------
 Type
@@ -1608,10 +1620,12 @@ Type
 Default
     ``false``
 Description
-    Ignore image URLs that have been encountered before during the
+    Ignore file URLs that have been encountered before during the
     current extractor run.
 
 
+extractor.*.child-unique
+------------------------
 extractor.*.chapter-unique
 --------------------------
 Type
@@ -1619,7 +1633,7 @@ Type
 Default
     ``false``
 Description
-    Like `image-unique <extractor.*.image-unique_>`__,
+    Like `file-unique <extractor.*.file-unique_>`__,
     but applies to delegated URLs like manga chapters, etc.
 
 
@@ -6003,7 +6017,7 @@ Note
     It is not possible to filter all subtitles of a specific source type,
     while also filtering for additional languages of another source type.
     (e.g. any ASR subtitle + fra-FR of any source type)
-    For this, refer to `extractor.*.image-filter`_.
+    For this, refer to `extractor.*.file-filter`_.
 
 
 extractor.tiktok.videos
@@ -6601,8 +6615,8 @@ Note
     use the ``/with_replies`` timeline while logged in. For example,
     media from Tweets which the user replied to will also be downloaded.
 
-    It is possible to exclude unwanted Tweets using `image-filter
-    <extractor.*.image-filter_>`__.
+    It is possible to exclude unwanted Tweets using `file-filter
+    <extractor.*.file-filter_>`__.
 
 
 extractor.twitter.retries-api
@@ -9976,7 +9990,7 @@ Description
     post-processor type, as well as any of its `options <Postprocessor Options_>`__.
 
     It is possible to set a ``"filter"`` Condition_ similar to
-    `image-filter <extractor.*.image-filter_>`_
+    `file-filter <extractor.*.file-filter_>`_
     to only run a post-processor conditionally.
 
     It is also possible set a ``"whitelist"`` or ``"blacklist"`` to

docs/gallery-dl.conf

@@ -44,14 +44,14 @@
         "cookies-select": null,
         "cookies-update": true,
 
-        "image-filter"  : null,
-        "image-range"   : null,
-        "image-unique"  : false,
-        "post-filter"   : null,
-        "post-range"    : null,
-        "chapter-filter": null,
-        "chapter-range" : null,
-        "chapter-unique": false,
+        "file-filter" : null,
+        "file-range"  : null,
+        "file-unique" : false,
+        "post-filter" : null,
+        "post-range"  : null,
+        "child-filter": null,
+        "child-range" : null,
+        "child-unique": false,
 
         "keywords"          : {},
         "keywords-default"  : null,

docs/options.md

@@ -162,7 +162,7 @@
                                 download. These can be either a constant value,
                                 range, or slice (e.g. '5', '8-20', or '1:24:3')
     --post-range RANGE          Like '--range', but for posts
-    --chapter-range RANGE       Like '--range', but for child extractors
+    --child-range RANGE         Like '--range', but for child extractors
                                 handling manga chapters, external URLs, etc.
     --filter EXPR               Python expression controlling which files to
                                 download. Files for which the expression
@@ -171,7 +171,7 @@
                                 Example: --filter "image_width >= 1000 and
                                 rating in ('s', 'q')"
     --post-filter EXPR          Like '--filter', but for posts
-    --chapter-filter EXPR       Like '--filter', but for child extractors
+    --child-filter EXPR         Like '--filter', but for child extractors
                                 handling manga chapters, external URLs, etc.
 
 ## Post-processing Options: