14 files changed, 60 insertions, 0 deletions
diff --git a/docs/changelog/.gitkeep b/docs/changelog/.gitkeep
new file mode 100644
index 0000000..e69de29
--- /dev/null
+++ b/docs/changelog/.gitkeep
diff --git a/docs/changelog/1057.doc.rst b/docs/changelog/1057.doc.rst
new file mode 100644
index 0000000..f8e740c
--- /dev/null
+++ b/docs/changelog/1057.doc.rst
@@ -0,0 +1 @@
+``activate_this.py`` recommend ``exec(open(this_file).read(), {'__file__': this_file})`` as it works both on Python 2 and 3.
diff --git a/docs/changelog/1057.feature.rst b/docs/changelog/1057.feature.rst
new file mode 100644
index 0000000..58c46c7
--- /dev/null
+++ b/docs/changelog/1057.feature.rst
@@ -0,0 +1 @@
+``activate_this.py`` improvements: set ``VIRTUAL_ENV`` environment variable; ``pypy``, ``pypy3`` and ``jython`` support.
diff --git a/docs/changelog/1206.feature.rst b/docs/changelog/1206.feature.rst
new file mode 100644
index 0000000..bdd1dad
--- /dev/null
+++ b/docs/changelog/1206.feature.rst
@@ -0,0 +1 @@
+The `xonsh <http://xon.sh/index.html>`_ shell is now supported by generating the ``xon.sh`` activation script.
diff --git a/docs/changelog/1234.doc.rst b/docs/changelog/1234.doc.rst
new file mode 100644
index 0000000..cd5bbbe
--- /dev/null
+++ b/docs/changelog/1234.doc.rst
@@ -0,0 +1 @@
+Move to a ``towncrier`` generated changelog to avoid merge conflicts, generate draft changelog documentation. Prefix version string in changelog with ``v`` to make the hyperlinks stable.
diff --git a/docs/changelog/1248.bugfix.rst b/docs/changelog/1248.bugfix.rst
new file mode 100644
index 0000000..ff1480d
--- /dev/null
+++ b/docs/changelog/1248.bugfix.rst
@@ -0,0 +1 @@
+``lib64`` symlink is again relative (as was with ``< 16.1.0``).
diff --git a/docs/changelog/1252.feature.rst b/docs/changelog/1252.feature.rst
new file mode 100644
index 0000000..ee6bae3
--- /dev/null
+++ b/docs/changelog/1252.feature.rst
@@ -0,0 +1 @@
+Support ``pip`` wheels with removed ``certifi's cacert.pem``.
diff --git a/docs/changelog/1257.feature.rst b/docs/changelog/1257.feature.rst
new file mode 100644
index 0000000..a654a18
--- /dev/null
+++ b/docs/changelog/1257.feature.rst
@@ -0,0 +1 @@
+Upgrade setuptools from ``40.5.0`` to ``40.6.3`` and wheel from ``0.32.2`` to ``0.32.3``.
diff --git a/docs/changelog/1258.feature.rst b/docs/changelog/1258.feature.rst
new file mode 100644
index 0000000..8e9e488
--- /dev/null
+++ b/docs/changelog/1258.feature.rst
@@ -0,0 +1 @@
+``powershell`` now also provides the ``pydoc`` function that uses the virtual environments ``pydoc``.
diff --git a/docs/changelog/268.bugfix.rst b/docs/changelog/268.bugfix.rst
new file mode 100644
index 0000000..c17ab24
--- /dev/null
+++ b/docs/changelog/268.bugfix.rst
@@ -0,0 +1 @@
+``copyfile`` handles relative symlinks and symlinks to symlinks, avoiding problems when Python was installed using ``stow`` or ``homebrew``.
diff --git a/docs/changelog/816.feature.rst b/docs/changelog/816.feature.rst
new file mode 100644
index 0000000..4a8d608
--- /dev/null
+++ b/docs/changelog/816.feature.rst
@@ -0,0 +1 @@
+``powershell`` activator is no longer signed.
diff --git a/docs/changelog/904.bugfix.rst b/docs/changelog/904.bugfix.rst
new file mode 100644
index 0000000..e2892b8
--- /dev/null
+++ b/docs/changelog/904.bugfix.rst
@@ -0,0 +1 @@
+Fix preserving of original path when using fish and a subshell.
diff --git a/docs/changelog/examples.rst b/docs/changelog/examples.rst
new file mode 100644
index 0000000..7c4b9ec
--- /dev/null
+++ b/docs/changelog/examples.rst
@@ -0,0 +1,18 @@
+.. examples for changelog entries adding to your Pull Requests
+
+file ``544.doc.rst``::
+
+    explain everything much better - by :user:`passionate_technicalwriter`
+
+file ``544.feature.rst``::
+
+    ``tox --version`` now shows information about all registered plugins - by :user:`obestwalter`
+
+
+file ``571.bugfix.rst``::
+
+    ``skip_install`` overrides ``usedevelop`` (``usedevelop`` is an option to choose the
+    installation type if the package is installed and ``skip_install`` determines if it should be
+    installed at all) - by :user:`ferdonline`
+
+.. see pyproject.toml for all available categories
diff --git a/docs/changelog/template.jinja2 b/docs/changelog/template.jinja2
new file mode 100644
index 0000000..cb98bf0
--- /dev/null
+++ b/docs/changelog/template.jinja2
@@ -0,0 +1,31 @@
+{% for section, _ in sections.items() %}
+{% set underline = underlines[0] %}
+{% if section %}
+{{section}}
+{{ underline * section|length }}
+{% set underline = underlines[1] %}
+{% endif %}
+
+{% if sections[section] %}
+{% for category, val in definitions.items() if category in sections[section] %}
+{{ definitions[category]['name'] }}
+{{ underline * definitions[category]['name']|length }}
+{% if definitions[category]['showcontent'] %}
+
+{% for text, values in sections[section][category].items() %}
+- {{ text }} ({{ values|join(', ') }})
+{% endfor %}
+
+{% else %}
+- {{ sections[section][category]['']|join(', ') }}
+{% endif %}
+
+{% if sections[section][category]|length == 0 %}
+No significant changes.
+{% endif %}
+{% endfor %}
+
+{% else %}
+No significant changes.
+{% endif %}
+{% endfor %}