From 87ddd0a14dc0464b7f51cede3af6a80f71338520 Mon Sep 17 00:00:00 2001
From: Pol Van Aubel <dev@polvanaubel.com>
Date: Wed, 14 Sep 2022 01:16:04 +0200
Subject: [PATCH] Suggest -o display_link_number=1

Apparently this w3m option is not very well known, to the point where
people are advised to switch to lynx.
---
 docs/source/faq.rst          | 4 ++++
 docs/source/installation.rst | 4 ++++
 2 files changed, 8 insertions(+)

diff --git a/docs/source/faq.rst b/docs/source/faq.rst
index df8fea817..96c0663fd 100644
--- a/docs/source/faq.rst
+++ b/docs/source/faq.rst
@@ -10,6 +10,10 @@ Try `w3m <http://w3m.sourceforge.net/>`_ and put the following into your
 
    text/html;  w3m -dump -o document_charset=%{charset} '%s'; nametemplate=%s.html; copiousoutput
 
+On more recent versions of w3m, links can be parsed and appended with reference numbers::
+
+   text/html;  w3m -dump -o document_charset=%{charset} -o display_link_number=1 '%s'; nametemplate=%s.html; copiousoutput
+
 Most `text based browsers <http://en.wikipedia.org/wiki/Text-based_web_browser>`_ have
 a dump mode that can be used here.
 
diff --git a/docs/source/installation.rst b/docs/source/installation.rst
index 85a4189ba..049aae8b5 100644
--- a/docs/source/installation.rst
+++ b/docs/source/installation.rst
@@ -11,6 +11,10 @@ On a recent Debian (-derived) systems for instance, just do `sudo apt install al
    (copiousoutput) set up for `text/html` in your :file:`~/.mailcap`::
 
      text/html;  w3m -dump -o document_charset=%{charset} '%s'; nametemplate=%s.html; copiousoutput
+
+   On more recent versions of w3m, links can be parsed and appended with reference numbers::
+
+     text/html;  w3m -dump -o document_charset=%{charset} -o display_link_number=1 '%s'; nametemplate=%s.html; copiousoutput
    
    See the manpage :manpage:`mailcap(5)` or :rfc:`1524` for more details on your mailcap setup.