From 8d543b040dbe5e36231d91c398852f41b26836ca Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Mike=20F=C3=A4hrmann?= <mike_faehrmann@web.de>
Date: Wed, 9 Nov 2022 22:17:08 +0100
Subject: [PATCH] update docs

- document '"mode": "jsonl"' for metadata pp
- remove 'username' and 'password' from 'instagram'
- add 'ytdl' example (#3180)
---
 docs/configuration.rst       |  4 +++-
 docs/gallery-dl-example.conf | 13 +++++++++++++
 docs/gallery-dl.conf         |  3 +--
 3 files changed, 17 insertions(+), 3 deletions(-)

diff --git a/docs/configuration.rst b/docs/configuration.rst
index 2253ce32..473e69ea 100644
--- a/docs/configuration.rst
+++ b/docs/configuration.rst
@@ -3592,7 +3592,9 @@ Description
     Selects how to process metadata.
 
     * ``"json"``: write metadata using `json.dump()
-      <https://docs.python.org/3/library/json.html#json.dump>`_
+      <https://docs.python.org/3/library/json.html#json.dump>`__
+    * ``"jsonl"``: write metadata in `JSON Lines
+      <https://jsonlines.org/>`__ format
     * ``"tags"``: write ``tags`` separated by newlines
     * ``"custom"``: write the result of applying `metadata.content-format`_
       to a file's metadata dictionary
diff --git a/docs/gallery-dl-example.conf b/docs/gallery-dl-example.conf
index 279aeef2..92509b54 100644
--- a/docs/gallery-dl-example.conf
+++ b/docs/gallery-dl-example.conf
@@ -210,6 +210,19 @@
             "text-tweets": true
         },
 
+        "ytdl":
+        {
+            "#": "enable 'ytdl' extractor",
+            "#": "i.e. invoke ytdl on all otherwise unsupported input URLs",
+            "enabled": true,
+
+            "#": "use yt-dlp instead of youtube-dl",
+            "module": "yt_dlp",
+
+            "#": "load ytdl options from config file",
+            "config-file": "~/yt-dlp.conf"
+        },
+
         "mastodon":
         {
             "#": "add 'tabletop.social' as recognized mastodon instance",
diff --git a/docs/gallery-dl.conf b/docs/gallery-dl.conf
index 9349398e..351badbf 100644
--- a/docs/gallery-dl.conf
+++ b/docs/gallery-dl.conf
@@ -159,9 +159,8 @@
         },
         "instagram":
         {
-            "username": null,
-            "password": null,
             "api": "auto",
+            "cookies": null,
             "include": "posts",
             "sleep-request": [6.0, 12.0],
             "videos": true