From 2b4526916dd8092191baa5b9387e8198e5072b83 Mon Sep 17 00:00:00 2001
From: Markus Heiser <markus.heiser@darmarit.de>
Date: Wed, 18 Dec 2019 18:32:42 +0100
Subject: [PATCH] edoc: -- makefile.rst fix typo and add extlinks['man']

Signed-off-by: Markus Heiser <markus.heiser@darmarit.de>
---
 docs/conf.py          |  1 +
 docs/dev/makefile.rst | 12 ++++++++----
 2 files changed, 9 insertions(+), 4 deletions(-)

diff --git a/docs/conf.py b/docs/conf.py
index 64c7a715..9eba67cf 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -33,6 +33,7 @@ extlinks['patch'] = (GIT_URL + '/commit/%s', '#')
 extlinks['search'] = (SEARX_URL + '/%s', '#')
 extlinks['docs'] = (DOCS_URL + '/%s', 'docs: ')
 extlinks['pypi'] = ('https://pypi.org/project/%s', 'PyPi: ')
+extlinks['man'] = ('https://manpages.debian.org/jump?q=%s', '')
 
 extensions = [
     'sphinx.ext.extlinks',
diff --git a/docs/dev/makefile.rst b/docs/dev/makefile.rst
index 65cddd3e..00825623 100644
--- a/docs/dev/makefile.rst
+++ b/docs/dev/makefile.rst
@@ -4,13 +4,16 @@
 Makefile Targets
 ================
 
+.. _gnu-make: https://www.gnu.org/software/make/manual/make.html#Introduction
+
 .. sidebar:: build environment
 
    Before looking deeper at the targets, first read about :ref:`makefile setup`
    and :ref:`make pyenv`.
 
 With the aim to simplify development cycles, started with :pull:`1756` a
-``Makefile`` based boilerplate was added.
+``Makefile`` based boilerplate was added.  If you are not familiar with
+Makefiles, we recommend to read gnu-make_ introduction.
 
 The usage is simple, just type ``make {target-name}`` to *build* a target.
 Calling the ``help`` target gives a first overview::
@@ -77,7 +80,7 @@ and release a ``make pyenv``:
    ...
 
 With target ``pyenv`` a development environment (aka virtualenv) was build up in
-``./local/py3/``.  To make a *developer install** of searx (:origin:`setup.py`)
+``./local/py3/``.  To make a *developer install* of searx (:origin:`setup.py`)
 into this environment make target ``install``
 
 .. code:: sh
@@ -108,8 +111,9 @@ the :origin:`setup.py` file (or the requirements listed in
 ============
 
 To get up a running a developer instance simply call ``make run``.  This enables
-*debug* option in :origin:`searx/settings.yml`, starts ``./searx/webapp.py``
-instance, disables *debug* option and opens the site (xdg-open):
+*debug* option in :origin:`searx/settings.yml`, starts a ``./searx/webapp.py``
+instance, disables *debug* option again and opens the URL in your favorite WEB
+browser (:man:`xdg-open`):
 
 .. code:: sh