From de819bb1f5be4e5f9e26d09ab40585684f284c4a Mon Sep 17 00:00:00 2001
From: Markus Heiser <markus.heiser@darmarit.de>
Date: Wed, 29 Dec 2021 17:38:13 +0100
Subject: [PATCH] [docs] move searxng_extra/ stuff to the developer section.

Stuff in folder searxng_extra/ is not suitable for normal users and should only
be used by developers.

The script searxng_extra/standalone_searx.py must not give the impression that
it improves privacy. [1]

[1] https://github.com/searxng/searxng/pull/651#issuecomment-1001389726

Signed-off-by: Markus Heiser <markus.heiser@darmarit.de>
---
 docs/dev/index.rst                                   | 1 +
 docs/{ => dev}/searxng_extra/index.rst               | 2 +-
 docs/{ => dev}/searxng_extra/standalone_searx.py.rst | 0
 docs/index.rst                                       | 1 -
 searxng_extra/standalone_searx.py                    | 9 +++++++++
 5 files changed, 11 insertions(+), 2 deletions(-)
 rename docs/{ => dev}/searxng_extra/index.rst (93%)
 rename docs/{ => dev}/searxng_extra/standalone_searx.py.rst (100%)

diff --git a/docs/dev/index.rst b/docs/dev/index.rst
index 93c914bbb..39be0885c 100644
--- a/docs/dev/index.rst
+++ b/docs/dev/index.rst
@@ -16,3 +16,4 @@ Developer documentation
    lxcdev
    makefile
    reST
+   searxng_extra/index
diff --git a/docs/searxng_extra/index.rst b/docs/dev/searxng_extra/index.rst
similarity index 93%
rename from docs/searxng_extra/index.rst
rename to docs/dev/searxng_extra/index.rst
index a98c358f2..f38bb3154 100644
--- a/docs/searxng_extra/index.rst
+++ b/docs/dev/searxng_extra/index.rst
@@ -5,7 +5,7 @@ Tooling box ``searxng_extra`` for developers and users
 ======================================================
 
 In the folder :origin:`searxng_extra/` we maintain some tools useful for
-developers and users.
+developers.
 
 .. toctree::
    :maxdepth: 2
diff --git a/docs/searxng_extra/standalone_searx.py.rst b/docs/dev/searxng_extra/standalone_searx.py.rst
similarity index 100%
rename from docs/searxng_extra/standalone_searx.py.rst
rename to docs/dev/searxng_extra/standalone_searx.py.rst
diff --git a/docs/index.rst b/docs/index.rst
index 7100d4ed1..f9800f95b 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -33,7 +33,6 @@ If you don't trust anyone, you can set up your own, see :ref:`installation`.
    user/index
    admin/index
    dev/index
-   searxng_extra/index
    utils/index
    src/index
 
diff --git a/searxng_extra/standalone_searx.py b/searxng_extra/standalone_searx.py
index 9ac8c8af2..baf8db0b4 100755
--- a/searxng_extra/standalone_searx.py
+++ b/searxng_extra/standalone_searx.py
@@ -23,6 +23,14 @@ Example to use this script:
 
     $ python3 searxng_extra/standalone_searx.py rain
 
+.. danger::
+
+   Be warned, using the ``standalone_searx.py`` won't give you privacy!
+
+   On the contrary, this script behaves like a SearXNG server: your IP is
+   exposed and tracked by all active engines (google, bing, qwant, ... ), with
+   every query!
+
 Example to run it from python:
 
 >>> import importlib
@@ -62,6 +70,7 @@ Example to run it from python:
     },
     "suggestions": [...]
 }
+
 """  # pylint: disable=line-too-long
 
 import argparse