From 01e953bac9ac132fba90550492ee9f7eedfce7e0 Mon Sep 17 00:00:00 2001
From: "Jason R. Coombs" <jaraco@jaraco.com>
Date: Sat, 2 Apr 2016 22:23:15 -0400
Subject: [PATCH] Add support for linking to issues and adding datestamps to
 changelog entries.

---
 docs/conf.py     | 20 ++++++++++++++++++++
 docs/history.rst |  2 +-
 setup.py         |  2 +-
 3 files changed, 22 insertions(+), 2 deletions(-)

diff --git a/docs/conf.py b/docs/conf.py
index 1874074..9c7ad1b 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -5,6 +5,7 @@ import setuptools_scm
 
 extensions = [
     'sphinx.ext.autodoc',
+    'rst.linker',
 ]
 
 # General information about the project.
@@ -17,3 +18,22 @@ version = setuptools_scm.get_version(root='..', relative_to=__file__)
 release = version
 
 master_doc = 'index'
+
+link_files = {
+	'CHANGES.rst': dict(
+		using=dict(
+			GH='https://github.com',
+			project=project,
+		),
+		replace=[
+			dict(
+				pattern=r"(Issue )?#(?P<issue>\d+)",
+				url='{GH}/jaraco/{project}/issues/{issue}',
+			),
+			dict(
+				pattern=r"^(?m)((?P<scm_version>v?\d+(\.\d+){1,2}))\n[-=]+\n",
+				with_scm="{text}\n{rev[timestamp]:%d %b %Y}\n",
+			),
+		],
+	),
+}
diff --git a/docs/history.rst b/docs/history.rst
index 907000b..8e21750 100644
--- a/docs/history.rst
+++ b/docs/history.rst
@@ -5,4 +5,4 @@
 History
 *******
 
-.. include:: ../CHANGES.rst
+.. include:: ../CHANGES (links).rst
diff --git a/setup.py b/setup.py
index e825a5d..99d6c9c 100644
--- a/setup.py
+++ b/setup.py
@@ -13,7 +13,7 @@ with io.open('README.rst', encoding='utf-8') as readme:
 needs_pytest = {'pytest', 'test'}.intersection(sys.argv)
 pytest_runner = ['pytest_runner'] if needs_pytest else []
 needs_sphinx = {'release', 'build_sphinx', 'upload_docs'}.intersection(sys.argv)
-sphinx = ['sphinx'] if needs_sphinx else []
+sphinx = ['sphinx', 'rst.linker'] if needs_sphinx else []
 needs_wheel = {'release', 'bdist_wheel'}.intersection(sys.argv)
 wheel = ['wheel'] if needs_wheel else []