From 1adafdd3d0cb283166c47752d0068de69de1a528 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Mike=20F=C3=A4hrmann?= Date: Sun, 13 Oct 2019 23:01:57 +0200 Subject: [PATCH] document cache file requirement for DeviantArt refresh tokens --- docs/configuration.rst | 12 ++++++++---- 1 file changed, 8 insertions(+), 4 deletions(-) diff --git a/docs/configuration.rst b/docs/configuration.rst index 08243901..39a3b9e1 100644 --- a/docs/configuration.rst +++ b/docs/configuration.rst @@ -603,11 +603,15 @@ extractor.deviantart.refresh-token =========== ===== Type ``string`` Default ``null`` -Description The ``refresh_token`` value you get from +Description The ``refresh-token`` value you get from `linking your DeviantArt account to gallery-dl `__. - Using a ``refresh_token`` allows you to access private or otherwise + Using a ``refresh-token`` allows you to access private or otherwise not publicly available deviations. + + Note: Authenticating with a ``refresh-token`` requires persistent + storage in a `cache file `__. + Otherwise the token will become invalid after its first use. =========== ===== @@ -897,10 +901,10 @@ extractor.reddit.refresh-token =========== ===== Type ``string`` Default ``null`` -Description The ``refresh_token`` value you get from +Description The ``refresh-token`` value you get from `linking your Reddit account to gallery-dl `__. - Using a ``refresh_token`` allows you to access private or otherwise + Using a ``refresh-token`` allows you to access private or otherwise not publicly available subreddits, given that your account is authorized to do so, but requests to the reddit API are going to be rate limited