2015.8.0 release notes and doc/conf.py updates

doc/conf.py

@@ -162,16 +162,16 @@ project = 'Salt'
 copyright = '2015 SaltStack, Inc.'
 
 version = salt.version.__version__
-latest_release = '2015.5.3' # latest release
+latest_release = '2015.8.0' # latest release
-previous_release = '2014.7.6'  # latest release from previous branch
+previous_release = '2015.5.5'  # latest release from previous branch
-previous_release_dir = '2014.7'  # path on web server for previous branch
+previous_release_dir = '2015.5'  # path on web server for previous branch
-build_type = 'develop'  # latest, previous, develop
+build_type = 'latest'  # latest, previous, develop
 
 # set release to 'version' for develop so sha is used
 # - otherwise -
 # set release to 'latest_release' or 'previous_release'
 
-release = version  # version, latest_release, previous_release
+release = latest_release  # version, latest_release, previous_release
 
 # Set google custom search engine
 
@@ -179,6 +179,8 @@ if release == latest_release:
     search_cx = '004624818632696854117:yfmprrbw3pk'
 elif release.startswith('2014.7'):
     search_cx = '004624818632696854117:thhslradbru'
+elif release.startswith('2015.5'):
+    search_cx = '004624818632696854117:ovogwef29do'
 else:
     search_cx = '004624818632696854117:haj7bjntf4s'  # develop
 
@@ -226,8 +228,8 @@ rst_prolog = """\
 .. _`salt-packagers`: https://groups.google.com/forum/#!forum/salt-packagers
 .. |windownload| raw:: html
 
-     <a href="https://repo.saltstack.com/windows/Salt-Minion-{release}-2-x86-Setup.exe"><strong>Salt-Minion-{release}-2-x86-Setup.exe</strong></a>
+     <a href="https://repo.saltstack.com/windows/Salt-Minion-{release}-2-x86-Setup.exe"><strong>Salt-Minion-{release}-x86-Setup.exe</strong></a>
-      | <a href="https://repo.saltstack.com/windows/Salt-Minion-{release}-2-x86-Setup.exe.md5"><strong>md5</strong></a>
+      | <a href="https://repo.saltstack.com/windows/Salt-Minion-{release}-x86-Setup.exe.md5"><strong>md5</strong></a>
 
 """.format(release=release)
 

doc/ref/cli/spm.rst

@@ -1,3 +1,5 @@
+.. _spm:
+
 =======
 ``spm``
 =======

doc/topics/releases/2015.5.3.rst

@@ -1,6 +1,6 @@
-
+===========================
-Changes for v2015.5.2..v2015.5.3
+Salt 2015.5.3 Release Notes
---------------------------------
+===========================
 
 Extended Changelog Courtesy of Todd Stansell (https://github.com/tjstansell/salt-changelogs):
 
@@ -621,7 +621,7 @@ Changes:
 
   - **ISSUE** `#24560`_: (*hydrosine*) Documentation missing on parameter
     | refs: `#24632`_
-  - **ISSUE** `#24547`_: (*dragonpaw*) Artifactory docs say module is 'jboss7'. 
+  - **ISSUE** `#24547`_: (*dragonpaw*) Artifactory docs say module is 'jboss7'.
     | refs: `#24632`_
   - **ISSUE** `#24375`_: (*companykitchen-dev*) Custom grain won't sync under any circumstances
     | refs: `#24632`_
@@ -634,7 +634,7 @@ Changes:
 
   * c7cdd41 Doc bug fixes Refs `#24547`_ Refs `#24275`_ Refs `#24375`_ Refs `#24560`_ Refs `#24163`_
 
-- **PR** `#24607`_: (*garethgreenaway*) fixes to minion.py 
+- **PR** `#24607`_: (*garethgreenaway*) fixes to minion.py
   @ *2015-06-17T18:16:42Z*
 
   - **ISSUE** `#24198`_: (*ahammond*) salt-call event.send doesn't send events from minion
@@ -852,7 +852,7 @@ Changes:
     | refs: `#24591`_
   - **ISSUE** `#21217`_: (*Colstuwjx*) Maybe a bug for jinja render?
     | refs: `#24591`_
-  - **PR** `#24591`_: (*tbaker57*) Add some documentation surrounding Jinja vs yaml comments - 
+  - **PR** `#24591`_: (*tbaker57*) Add some documentation surrounding Jinja vs yaml comments -
     | refs: `#24631`_
   - **PR** `#24492`_: (*DmitryKuzmenko*) Don't remove grains from opts
   * 5f491f9 Merge pull request `#24631`_ from rallytime/`bp-24591`_
@@ -1284,7 +1284,7 @@ Changes:
 - **PR** `#24426`_: (*basepi*) [2015.5] Merge forward from 2014.7 to 2015.5
   @ *2015-06-05T03:59:11Z*
 
-  - **ISSUE** `#24276`_: (*markuskramerIgitt*) Live salt-master Profiling with SIGUSR2 fails 
+  - **ISSUE** `#24276`_: (*markuskramerIgitt*) Live salt-master Profiling with SIGUSR2 fails
   - **PR** `#24405`_: (*jacksontj*) Fix for `#24276`_
   - **PR** `#24395`_: (*hvnsweeting*) handle exceptions when received data is not in good shape
   - **PR** `#24305`_: (*twangboy*) Added documentation, fixed formatting

doc/topics/releases/2015.5.5.rst

@@ -1,6 +1,6 @@
-
+===========================
-Changes for v2015.5.4..v2015.5.5
+Salt 2015.5.5 Release Notes
---------------------------------
+===========================
 
 Extended changelog courtesy of Todd Stansell (https://github.com/tjstansell/salt-changelogs):
 

doc/topics/releases/2015.8.0.rst

@@ -0,0 +1,277 @@
+================================================
+Salt 2015.8.0 Release Notes - Codename Beryllium
+================================================
+
+.. toctree::
+    includes/2015.8.0rc2
+    includes/2015.8.0rc3
+
+The 2015.8.0 feature release of Salt contains several major new features. As
+usual the release notes are not exhaustive and primarily include the most
+notable additions and improvements. Hundreds of bugs have been fixed and many
+modules have been substantially updated and added.
+
+Send Event on State Completion
+==============================
+
+A `fire_event` global state keyword argument was added that allows any state to
+send an event upon completion. Useful for custom progress bars and checking in
+on long state runs.
+
+ZeroMQ socket monitoring
+========================
+
+If :conf_master:`zmq_monitor` is enabled, log all ZMQ events for socket monitoring
+purposes. Verbose, but useful.
+
+SPM (Salt Package Manager)
+==========================
+
+Allows Salt formulas to be packaged for ease of deployment. See :ref:`spm <spm>`.
+
+Specify a Single Environment for Top Files
+==========================================
+
+A new :conf_master:`default_top` option was added to load the state top file
+from a single, specific environment, rather than merging top data across all
+environments. Additionally, new :conf_master:`top_file_merge_strategy` and
+:conf_master:`env_order` options were added for more control over top file
+merging.
+
+Tornado TCP Transport
+=====================
+
+Implemented a pure-TCP transport, in addition to ZeroMQ and RAET. The new
+transport uses Tornado, which allows Salt to use a standardized set of libraries
+for asynchronous behavior, which should greatly improve reliability and
+performance.
+
+.. note::
+
+   Tornado is considered early-access in this release. The following known
+   issues were being investigated at the time of release:
+     - TCP tests show
+       performance degredation over time (:issue:`26051`)
+     - TCP transport stacktrace on windows minion: Future exception was never
+       retrieved (:issue:`25718)
+     - [freebsd] TCP transport not working in 2015.8.0rc3 (:issue:`26364`)
+
+Core Changes
+============
+
+- Add system version info to ``versions_report``, which appears in both ``salt
+  --versions-report`` and ``salt '*' test.versions_report``. Also added is an
+  alias ``test.versions`` to ``test.versions_report``. (:issue:`21906`)
+
+- Add colorized console logging support.  This is activated by using
+  ``%(colorlevel)s``, ``%(colorname)s``, ``%(colorprocess)s``, ``%(colormsg)s``
+  in ``log_fmt_console`` in the config file for any of ``salt-master``,
+  ``salt-minion``, and ``salt-cloud``.
+
+Git Pillar
+==========
+
+The git external pillar has been rewritten to bring it up to feature parity
+with :mod:`gitfs <salt.fileserver.gitfs>`. Support for pygit2_ has been added,
+bring with it the ability to access authenticated repositories.
+
+Using the new features will require updates to the git ext_pillar
+configuration, further details can be found :ref:`here
+<git-pillar-2015-8-0-and-later>`.
+
+Salt Cloud Improvements
+=======================
+
+- Pricing data from several cloud providers (GCE, DigitalOcean, SoftLayer_HW, EC2)
+- All cloud providers now use standardized bootstrapping code
+- Modified the Linode Salt Cloud driver to use Linode's native API instead of
+  depending on apache-libcloud or linode-python.
+- When querying for VMs in ``digital_ocean.py``, the number of VMs to include in
+  a page was changed from 20 (default) to 200 to reduce the number of API calls
+  to Digital
+
+Salt Cloud Changes
+------------------
+
+- Changed the default behavior of ``rename_on_destroy`` to be set to ``True``
+  in the EC2 and AWS drivers.
+- Changed the default behavior of the EC2 and AWS drivers to always check for
+  duplicate names of VMs before trying to create a new VM. Will now throw an
+  error similarly to other salt-cloud drivers when trying to create a VM of the
+  same name, even if the VM is in the ``terminated`` state.
+- Modified the Linode Salt Cloud driver to use Linode's native API instead of
+  depending on apache-libcloud or linode-python.
+- When querying for VMs in ``ditigal_ocean.py``, the number of VMs to include in
+  a page was changed from 20 (default) to 200 to reduce the number of API calls
+  to Digital Ocean.Ocean.
+
+State and Execution Module Improvements
+=======================================
+
+- New and improved Docker state and execution modules (:mod:`state
+  <salt.states.dockerng>` and :mod:`execution module <salt.modules.dockerng>`).
+.. toctree::
+    includes/git-2015.8.0
+- OpenStack Glance API V2 execution module
+- Amazon VPC state module
+- RallyDev execution module
+- BambooHR execution module
+- Stormpath execution, state modules
+- Remove unused argument ``timeout`` in jboss7.status.
+- Deprecate ``enabled`` argument in ``pkgrepo.managed`` in favor of ``disabled``.
+- Archive module changes: In the ``archive.tar`` and ``archive.cmd_unzip``
+  module functions, remove the arbitrary prefixing of the options string with
+  ``-``.  An options string beginning with a ``--long-option``, would have
+  uncharacteristically needed its first ``-`` removed under the former scheme.
+  Also, tar will parse its options differently if short options are used with or
+  without a preceding ``-``, so it is better to not confuse the user into
+  thinking they're using the non- ``-`` format, when really they are using the
+  with- ``-`` format.
+
+Windows Improvements
+====================
+
+- Templatize Windows Software package definitions
+- Added additional capabilities to the user module for windows
+- Added new module for managing windows updates (win_wua)
+- Turned on multi-processing by default for windows in minion conf
+
+Windows Software Repo Changes
+-----------------------------
+
+Several config options have been renamed to make their naming more consistent.
+For a list of the winrepo config options, see :ref:`here
+<winrepo-master-config-opts>` for master config options, and :ref:`here
+<winrepo-minion-config-opts>` for configuration options for masterless Windows
+minions.
+
+On the master, the :mod:`winrepo.update_git_repos
+<salt.runners.winrepo.update_git_repos>` runner has been updated to use either
+pygit2_ or GitPython_ to checkout the git repositories containing repo data. If
+pygit2_ or GitPython_ is installed, existing winrepo git checkouts should be
+removed after upgrading to 2015.8.0, to allow them to be checked out again by
+running :py:func:`winrepo.update_git_repos
+<salt.runners.winrepo.update_git_repos>`.
+
+This enhancement also brings new functionality, see the :ref:`Windows Software
+Repository <2015-8-0-winrepo-changes>` documentation for more information.
+
+If neither GitPython_ nor pygit2_ are installed, then Salt will fall back to
+the pre-existing behavior for :mod:`winrepo.update_git_repos
+<salt.runners.winrepo.update_git_repos>`, and a warning will be logged in the
+master log.
+
+.. note::
+    Standalone Windows minions do not support the new GitPython_/pygit2_
+    functionality, and will instead use the :py:func:`git.latest
+    <salt.states.git.latest>` state to keep repositories up-to-date. More
+    information on how to use the Windows Software Repo on a standalone minion
+    can be found :ref:`here <standalone-winrepo>`.
+
+.. _pygit2: https://github.com/libgit2/pygit2
+.. _GitPython: https://github.com/gitpython-developers/GitPython
+
+Win System Module
+-----------------
+
+The unit of the ``timeout`` parameter in the ``system.halt``,
+``system.poweroff``, ``system.reboot``,  and ``system.shutdown`` functions has
+been changed from seconds to minutes in order to be consistent with the linux
+timeout setting. (:issue:`24411`)  Optionally, the unit can be reverted to
+seconds by specifying ``in_seconds=True``.
+
+Other Improvements
+==================
+
+- Python 3
+- Sanitize sensitive fields in http.query
+- Allow authorization to be read from Django and eauth
+- Add templating to SMTP returner
+- New REST module for SDB
+- Added rest_timeout config option and timeout argument to jobs api call
+- Provide config options for Raet lane and road buffer count. (Useful for BSD kernels)
+- Implemented ZeroMQ socket monitor for master and minion
+- Add end time to master job cache for jobs (optional, off by default)
+- Tornado is now the default backend for http.request
+- Support pillarenv selection as it's done for saltenv
+
+Deprecations
+============
+
+- The ``digital_ocean.py`` Salt Cloud driver was removed in favor of the
+  ``digital_ocean_v2.py`` driver as DigitalOcean has removed support for APIv1.
+  The ``digital_ocean_v2.py`` was renamed to ``digital_ocean.py`` and supports
+  DigitalOcean's APIv2.
+
+- The ``vsphere.py`` Salt Cloud driver has been deprecated in favor of the
+  ``vmware.py`` driver.
+
+- The ``openstack.py`` Salt Cloud driver has been deprecated in favor of the
+  ``nova.py`` driver.
+
+- The use of ``provider`` in Salt Cloud provider files to define cloud drivers
+  has been deprecated in favor of using ``driver``. Both terms will work until
+  the Nitrogen release of Salt. Example provider file:
+
+.. code-block:: yaml
+
+    my-ec2-cloud-config:
+      id: 'HJGRYCILJLKJYG'
+      key: 'kdjgfsgm;woormgl/aserigjksjdhasdfgn'
+      private_key: /etc/salt/my_test_key.pem
+      keyname: my_test_key
+      securitygroup: default
+      driver: ec2
+
+- The use of ``lock`` has been deprecated and from ``salt.utils.fopen``.
+  ``salt.utils.flopen`` should be used instead.
+
+- The following args have been deprecated from the ``rabbitmq_vhost.present``
+  state: ``user``, ``owner``, ``conf``, ``write``, ``read``, and ``runas``.
+
+- The use of ``runas`` has been deprecated from the ``rabbitmq_vhost.absent``
+  state.
+
+- Support for ``output`` in ``mine.get`` was removed. ``--out`` should be used
+  instead.
+
+- The use of ``delim`` was removed from the following functions in the ``match``
+  execution module: ``pillar_pcre``, ``pillar``, ``grain_pcre``,
+
+Major Bug Fixes
+===============
+
+- Fixed minion failover to next master on DNS errors (:issue:`21082`)
+- Fixed memory consuption in SaltEvents (:issue:`25557`)
+- Don't lookup outside system path in which() util (:issue:`24085`)
+- Fixed broken jobs rest api call (:issue:`23408`)
+- Fixed stale grains data using in modules (:issue:`24073`)
+- Added ssh_identities_only config flag for ssh-agent configured environments
+  (:issue:`24096`)
+- Fixed "object has no attribute" errors for Raet transport (:issue:`21640`)
+- Flush event returners before master exit (:issue:`22814`)
+- Fix CommandExecutionError in grains generation with lspci missing (:issue:`23342`)
+- Fix salt-ssh against CentOS 7 when python-zmq not installed (:issue:`23503`)
+- Fix salt-ssh issues related to out-of-date six module (:issue:`20949`)
+- Fix salt-ssh thin generation after previous run was interrupted (:issue:`24376`)
+- Use proper line endings on Windows with "file.managed" w/contents (:issue:`25675`)
+- Fixed broken comment/uncomment functions in file.py (:issue:`24620`)
+- Fixed problem with unicode when changing computer description (:issue:`12255`)
+- Fixed problem with chocolatey module not loading (:issue:`25717`)
+- Fixed problem adding users to groups with spaces in the name (:issue:`25144`)
+- Fixed problem adding full name to user account (:issue:`25206`)
+- Fixed gem module stack trace (:issue:`21041`)
+- Fixed problem with file.managed when test=True (:issue:`20441`)
+- Fixed problem with powershell hanging while waiting for user input (:issue:`13943`)
+- Fixed problem where the salt-minion service would not consistently start
+  (:issue:`25272`)
+- Fixed problem where pkg.refresh_db would return True even when winrepo.p was not
+  found (:issue:`18919`)
+- Could someone please provide end to end example for Proxy Minion with REST
+  (:issue:`25500`)
+- Proxy minions stopped working between 2014.7 and 2015.5 (:issue:`25053`)
+- Proxy minion documentation includes outdated code sample (:issue:`24018`)
+- Proxy Minion documentation missing grains example (:issue:`18273`)
+- Improve process management in proxy minion (:issue:`12024`)
+- Proxy minion never comes up with message ' I am XXX and I am not supposed to
+  start any proxies.' (:issue:`25908`)

doc/topics/releases/includes/2015.8.0rc2.rst

@@ -1,6 +1,6 @@
-
+==============================
-Changes for v2015.5.3..v2015.8.0rc2
+Salt 2015.8.0rc2 Release Notes
------------------------------------
+==============================
 
 Extended changelog courtesy of Todd Stansell (https://github.com/tjstansell/salt-changelogs):
 
@@ -1197,7 +1197,7 @@ Changes:
 - **PR** `#25257`_: (*notpeter*) Document SourceDestCheck added in `#25242`_.
   @ *2015-07-09T23:29:48Z*
 
-  - **ISSUE** `#25241`_: (*ruzarowski*) salt-cloud: SourceDestCheck flag not passed to AWS, provisioning NAT instances needs that 
+  - **ISSUE** `#25241`_: (*ruzarowski*) salt-cloud: SourceDestCheck flag not passed to AWS, provisioning NAT instances needs that
     | refs: `#25242`_
   - **PR** `#25242`_: (*ruzarowski*) Make SourceDestCheck flag available to network interface definition
   * cd405b4 Merge pull request `#25257`_ from notpeter/SourceDestCheck
@@ -1322,7 +1322,7 @@ Changes:
     | refs: `#25173`_
   - **PR** `#25001`_: (*jasonkeene*) Add docs for key arg in ssh_known_hosts.present
     | refs: `#25171`_
-  - **PR** `#24421`_: (*bechtoldt*) add missing module documentation 
+  - **PR** `#24421`_: (*bechtoldt*) add missing module documentation
     | refs: `#25019`_
   - **PR** `#21880`_: (*bechtoldt*) update references, fixes `#21879`_
     | refs: `#25019`_
@@ -1428,7 +1428,7 @@ Changes:
 - **PR** `#25242`_: (*ruzarowski*) Make SourceDestCheck flag available to network interface definition
   @ *2015-07-08T16:36:22Z*
 
-  - **ISSUE** `#25241`_: (*ruzarowski*) salt-cloud: SourceDestCheck flag not passed to AWS, provisioning NAT instances needs that 
+  - **ISSUE** `#25241`_: (*ruzarowski*) salt-cloud: SourceDestCheck flag not passed to AWS, provisioning NAT instances needs that
     | refs: `#25242`_
   * 810b109 Merge pull request `#25242`_ from ruzarowski/2015.8
   * 62b6d4f Make SourceDestCheck flag available to network interface definition
@@ -2036,7 +2036,7 @@ Changes:
     | refs: `#25019`_
   - **ISSUE** `#19262`_: (*bechtoldt*) salt.pillar.file_tree doesn't appear in the documentation
     | refs: `#25019`_
-  - **PR** `#24421`_: (*bechtoldt*) add missing module documentation 
+  - **PR** `#24421`_: (*bechtoldt*) add missing module documentation
     | refs: `#25019`_
   - **PR** `#21880`_: (*bechtoldt*) update references, fixes `#21879`_
     | refs: `#25019`_
@@ -2126,7 +2126,7 @@ Changes:
 - **PR** `#24976`_: (*cachedout*) Catch typeerror on msgpack failure
   @ *2015-06-25T22:02:04Z*
 
-  - **ISSUE** `#19130`_: (*Mrten*) grain typechecking 
+  - **ISSUE** `#19130`_: (*Mrten*) grain typechecking
     | refs: `#24976`_
   * 8e60cc2 Merge pull request `#24976`_ from cachedout/issue_19130
   * 9680996 Catch typeerror on msgpack failure
@@ -3260,14 +3260,14 @@ Changes:
 - **PR** `#24549`_: (*jfindlay*) Shutdown time
   @ *2015-06-11T16:20:55Z*
 
-  - **ISSUE** `#24411`_: (*vernondcole*) module system.shutdown timeout value not documented and inconsistant 
+  - **ISSUE** `#24411`_: (*vernondcole*) module system.shutdown timeout value not documented and inconsistant
     | refs: `#24549`_
   * 78a6814 Merge pull request `#24549`_ from jfindlay/shutdown_time
   * 79de6cd prefer shutdown timeout value in minutes on windows
 
   * b845775 document system.shutdown arg
 
-- **PR** `#24591`_: (*tbaker57*) Add some documentation surrounding Jinja vs yaml comments - 
+- **PR** `#24591`_: (*tbaker57*) Add some documentation surrounding Jinja vs yaml comments -
   @ *2015-06-11T15:54:17Z*
 
   - **ISSUE** `#24494`_: (*arnoutpierre*) Computed comments in jinja states
@@ -3790,7 +3790,7 @@ Changes:
 
   * ffb5018 Fixed a small pylint error
 
-- **PR** `#24421`_: (*bechtoldt*) add missing module documentation 
+- **PR** `#24421`_: (*bechtoldt*) add missing module documentation
   | refs: `#25019`_
   @ *2015-06-05T00:30:39Z*
 
@@ -4291,7 +4291,7 @@ Changes:
 
   * c4f5e23 Merge remote-tracking branch 'upstream/2015.5' into merge-forward-develop2
 
-- **PR** `#24248`_: (*msteed*) Reinit pycrypto RNG in Cloud multiprocess paths 
+- **PR** `#24248`_: (*msteed*) Reinit pycrypto RNG in Cloud multiprocess paths
   @ *2015-05-29T18:27:09Z*
 
   - **ISSUE** `#24176`_: (*nmadhok*) [salt-cloud] VM creation fails with NameError on develop branch
@@ -6360,7 +6360,7 @@ Changes:
 
   * 72ed91a Add 'upload_path' option
 
-- **PR** `#23282`_: (*lisa2lisa*) Iss23201-fix the revoke *.* bug for mysql module 
+- **PR** `#23282`_: (*lisa2lisa*) Iss23201-fix the revoke *.* bug for mysql module
   @ *2015-05-03T00:42:34Z*
 
   * bf867c6 Merge pull request `#23282`_ from lisa2lisa/iss23201
@@ -7410,7 +7410,7 @@ Changes:
 
   * 0e53fde fix authorityid bug
 
-- **PR** `#23003`_: (*notpeter*) Typo in ssh.check_key_file doc example 
+- **PR** `#23003`_: (*notpeter*) Typo in ssh.check_key_file doc example
   @ *2015-04-24T03:16:34Z*
 
   * 336373c Merge pull request `#23003`_ from notpeter/develop
@@ -9172,7 +9172,7 @@ Changes:
 - **PR** `#22414`_: (*syphernl*) Cloud: Do not look for disk underneath config in Proxmox driver
   @ *2015-04-07T19:13:54Z*
 
-  - **ISSUE** `#22382`_: (*ghost*) The 'proxmox' cloud provider alias, for the 'proxmox' driver, does not define the function 'disk'". 
+  - **ISSUE** `#22382`_: (*ghost*) The 'proxmox' cloud provider alias, for the 'proxmox' driver, does not define the function 'disk'".
     | refs: `#22414`_
   * ff04f10 Merge pull request `#22414`_ from syphernl/fix/proxmox_kvm
   * 6cfaeda Lint
@@ -10807,7 +10807,7 @@ Changes:
   * 40b99a2 Merge pull request `#21947`_ from dmyerscough/20625-Fixing-invalid-syntax
   * ac93e11 Ensure nginx config check passes by checking the exit status.... Nginx writes messages to stderr even when there are no errors
 
-- **PR** `#21930`_: (*ptonelli*) add hg_pillar similar to git_pillar 
+- **PR** `#21930`_: (*ptonelli*) add hg_pillar similar to git_pillar
   @ *2015-03-24T19:10:53Z*
 
   - **ISSUE** `#2`_: (*thatch45*) salt job queries
@@ -11914,7 +11914,7 @@ Changes:
 - **PR** `#21554`_: (*rallytime*) Add versionadded directive to docker.lastest_running function
   @ *2015-03-11T19:33:20Z*
 
-  - **ISSUE** `#21547`_: (*jasonm-makerbot*) docker.latest_running not in 2015.2 
+  - **ISSUE** `#21547`_: (*jasonm-makerbot*) docker.latest_running not in 2015.2
     | refs: `#21554`_
   * e3e455e Merge pull request `#21554`_ from rallytime/versionadded_docker_func
   * 1c3a764 Add versionadded directive to docker.lastest_running function
@@ -12274,7 +12274,7 @@ Changes:
     | refs: `#21421`_
   - **ISSUE** `#8754`_: (*techhat*) [salt.cloud] Need test cases for salt.cloud providers
     | refs: `#21421`_
-  - **PR** `#21421`_: (*junckritter*) Tests for cloud GCE provider 
+  - **PR** `#21421`_: (*junckritter*) Tests for cloud GCE provider
     | refs: `#21429`_
   * 0852db0 Merge pull request `#21429`_ from thatch45/junckritter-cloud-gce-tests
   * 0da8878 lint
@@ -12570,7 +12570,7 @@ Changes:
   * a52ebda Merge pull request `#21286`_ from ahus1/ahus1_releasedocs
   * 0887dfe make latest 2014.7.x releases visible in documentation
 
-- **PR** `#21285`_: (*pravka*) fix ca creation in tls module 
+- **PR** `#21285`_: (*pravka*) fix ca creation in tls module
   @ *2015-03-04T06:17:34Z*
 
   * b7d4232 Merge pull request `#21285`_ from atbell/fix_ca_creation
@@ -13151,7 +13151,7 @@ Changes:
   * 35f1266 Merge pull request `#20968`_ from jayeshka/win_firewall-unit-test
   * d5b70b5 adding win_firewall unit test case
 
-- **PR** `#20975`_: (*evilNullPointer*) Add Artifactory classifier support 
+- **PR** `#20975`_: (*evilNullPointer*) Add Artifactory classifier support
   @ *2015-02-24T21:38:29Z*
 
   * c61c3c1 Merge pull request `#20975`_ from FrimaStudio/add_artifactory_classifier
@@ -14044,7 +14044,7 @@ Changes:
     | refs: `#20658`_ `#20658`_
   - **PR** `#20618`_: (*cxfcxf*) add ranged interface support for bond interface
     | refs: `#20658`_ `#20649`_
-  - **PR** `#20602`_: (*cxfcxf*) adding range interface support and ability to turn arpcheck off to redhat related system, 
+  - **PR** `#20602`_: (*cxfcxf*) adding range interface support and ability to turn arpcheck off to redhat related system,
     | refs: `#20618`_ `#20658`_ `#20649`_
   * 84fc28b Merge pull request `#20658`_ from cxfcxf/develop
   * 4ddc1b1 range interface support for vlan
@@ -14099,7 +14099,7 @@ Changes:
   | refs: `#20658`_ `#20649`_
   @ *2015-02-12T17:39:33Z*
 
-  - **PR** `#20602`_: (*cxfcxf*) adding range interface support and ability to turn arpcheck off to redhat related system, 
+  - **PR** `#20602`_: (*cxfcxf*) adding range interface support and ability to turn arpcheck off to redhat related system,
     | refs: `#20618`_ `#20658`_ `#20649`_
   * 598f119 Merge pull request `#20618`_ from cxfcxf/develop
   * ef58955 add ranged interface support for bond and fix typo on rh6_eth.jinja
@@ -14427,7 +14427,7 @@ Changes:
 
   - **PR** `#20537`_: (*rallytime*) More python 3 compatibility changes
     | refs: `#20542`_
-  - **PR** `#20443`_: (*SmithSamuelM*) Fixed bug and reverted some unnecessary changes where .six.itervalues was applied 
+  - **PR** `#20443`_: (*SmithSamuelM*) Fixed bug and reverted some unnecessary changes where .six.itervalues was applied
     | refs: `#20542`_
   * f232f7f Merge pull request `#20542`_ from saltstack/revert-20537-py-3-compat
   * a0d5c3d Revert "More python 3 compatibility changes"
@@ -14649,7 +14649,7 @@ Changes:
   * 3b1ff44 Merge pull request `#20454`_ from scream3/develop
   * 3f7f50b Fix wrong check for rvm script existence
 
-- **PR** `#20443`_: (*SmithSamuelM*) Fixed bug and reverted some unnecessary changes where .six.itervalues was applied 
+- **PR** `#20443`_: (*SmithSamuelM*) Fixed bug and reverted some unnecessary changes where .six.itervalues was applied
   | refs: `#20542`_
   @ *2015-02-06T17:33:32Z*
 
@@ -18596,7 +18596,7 @@ Changes:
   * 3a1cffd Merge pull request `#19322`_ from garethgreenaway/19132_simple_state_notification
   * 6a3c15a Adding a simple notification function to the test module.
 
-- **PR** `#19307`_: (*blueicefield*) Feature : Adding functions to Mongodb module for the management of user roles 
+- **PR** `#19307`_: (*blueicefield*) Feature : Adding functions to Mongodb module for the management of user roles
   @ *2015-01-05T20:13:29Z*
 
   - **ISSUE** `#8933`_: (*thaddeusmt*) mongodb_user not creating users
@@ -18830,7 +18830,7 @@ Changes:
   * 846c78e Merge pull request `#19261`_ from manonthemat/develop
   * cd47b6d environ.set -> environ.setenv
 
-- **PR** `#19254`_: (*jacksontj*) Fix for:  TypeError: pub() got multiple values for keyword argument 'user' 
+- **PR** `#19254`_: (*jacksontj*) Fix for:  TypeError: pub() got multiple values for keyword argument 'user'
   @ *2014-12-28T20:42:16Z*
 
   * 7c85a70 Merge pull request `#19254`_ from jacksontj/multi_syndic

doc/topics/releases/includes/2015.8.0rc3.rst

@@ -1,6 +1,6 @@
-
+==============================
-Changes for v2015.8.0rc2..v2015.8.0rc3
+Salt 2015.8.0rc3 Release Notes
---------------------------------------
+==============================
 
 Extended changelog courtesy of Todd Stansell (https://github.com/tjstansell/salt-changelogs):
 
@@ -111,7 +111,7 @@ Changes:
   - **PR** `#25919`_: (*TheBigBear*) Minor update to msi un-installer info
   - **PR** `#25917`_: (*jmdcal*) adding missing format string
     | refs: `#25967`_
-  - **PR** `#25905`_: (*rallytime*) Back-port `#25982`_ to 2015.5 
+  - **PR** `#25905`_: (*rallytime*) Back-port `#25982`_ to 2015.5
   - **PR** `#25898`_: (*jfindlay*) clarify and expand syndic docs
   - **PR** `#25895`_: (*basepi*) [2015.5] Merge forward from 2014.7 to 2015.5
   - **PR** `#25894`_: (*jacobhammons*) Minor doc bug fixes
@@ -254,7 +254,7 @@ Changes:
     | refs: `#25642`_
   - **ISSUE** `#25478`_: (*zyio*) salt-ssh - Unable to locate current thin version
     | refs: `#25862`_
-  - **ISSUE** `#25447`_: (*spo0nman*) SaltMaster is crippled with Minion Re-Authentication 
+  - **ISSUE** `#25447`_: (*spo0nman*) SaltMaster is crippled with Minion Re-Authentication
     | refs: `#25856`_
   - **ISSUE** `#25437`_: (*lorengordon*) Stacktrace on Windows when running pkg.list_pkgs
     | refs: `#25763`_

doc/topics/releases/includes/git-2015.8.0.rst

@@ -1,42 +1,6 @@
-=======================================
+.. _2015.8.0-git-:
-Salt Release Notes - Codename Beryllium
-=======================================
-
-Core Changes
-============
-
-- Add system version info to ``versions_report``, which appears in both ``salt
-  --versions-report`` and ``salt '*' test.versions_report``. Also added is an
-  alias ``test.versions`` to ``test.versions_report``. (:issue:`21906`)
-
-- Add colorized console logging support.  This is activated by using
-  ``%(colorlevel)s``, ``%(colorname)s``, ``%(colorprocess)s``, ``%(colormsg)s``
-  in ``log_fmt_console`` in the config file for any of ``salt-master``,
-  ``salt-minion``, and ``salt-cloud``.
-
-Salt Cloud Changes
-==================
-
-- Changed the default behavior of ``rename_on_destroy`` to be set to ``True``
-  in the EC2 and AWS drivers.
-- Changed the default behavior of the EC2 and AWS drivers to always check for
-  duplicate names of VMs before trying to create a new VM. Will now throw an
-  error similarly to other salt-cloud drivers when trying to create a VM of the
-  same name, even if the VM is in the ``terminated`` state.
-- Modified the Linode Salt Cloud driver to use Linode's native API instead of
-  depending on apache-libcloud or linode-python.
-- When querying for VMs in ``ditigal_ocean.py``, the number of VMs to include in
-  a page was changed from 20 (default) to 200 to reduce the number of API calls
-  to Digital Ocean.
-
-New Docker State/Module
-=======================
-
-A new docker :mod:`state <salt.states.dockerng>` and :mod:`execution module
-<salt.modules.dockerng>` have been added. They will eventually take the place
-of the existing state and execution module, but for now will exist alongside
-them.
 
+=========================================
 Git State and Execution Modules Rewritten
 =========================================
 
@@ -214,135 +178,3 @@ Changes to Functions in Git Execution Module
 - Added the ``command`` argument to allow for operations other than ``update``
   to be run on submodules, and deprecated the ``init`` argument. To do a
   submodule update with ``init=True`` moving forward, use ``command=update
-  opts='--init'``
-
-
-Git Pillar Rewritten
-====================
-
-The git external pillar has been rewritten to bring it up to feature parity
-with :mod:`gitfs <salt.fileserver.gitfs>`. Support for pygit2_ has been added,
-bring with it the ability to access authenticated repositories.
-
-Using the new features will require updates to the git ext_pillar
-configuration, further details can be found :ref:`here
-<git-pillar-2015-8-0-and-later>`.
-
-.. note::
-    As with :mod:`gitfs <salt.fileserver.gitfs>`, pygit2_ 0.20.3 is required to
-    use pygit2_ with the git external pillar.
-
-Windows Software Repo Changes
-=============================
-
-Several config options have been renamed to make their naming more consistent.
-For a list of the winrepo config options, see :ref:`here
-<winrepo-master-config-opts>` for master config options, and :ref:`here
-<winrepo-minion-config-opts>` for configuration options for masterless Windows
-minions.
-
-On the master, the :mod:`winrepo.update_git_repos
-<salt.runners.winrepo.update_git_repos>` runner has been updated to use either
-pygit2_ or GitPython_ to checkout the git repositories containing repo data. If
-pygit2_ or GitPython_ is installed, existing winrepo git checkouts should be
-removed after upgrading to 2015.8.0, to allow them to be checked out again by
-running :py:func:`winrepo.update_git_repos
-<salt.runners.winrepo.update_git_repos>`.
-
-This enhancement also brings new functionality, see the :ref:`Windows Software
-Repository <2015-8-0-winrepo-changes>` documentation for more information.
-
-If neither GitPython_ nor pygit2_ are installed, then Salt will fall back to
-the pre-existing behavior for :mod:`winrepo.update_git_repos
-<salt.runners.winrepo.update_git_repos>`, and a warning will be logged in the
-master log.
-
-.. note::
-    Standalone Windows minions do not support the new GitPython_/pygit2_
-    functionality, and will instead use the :py:func:`git.latest
-    <salt.states.git.latest>` state to keep repositories up-to-date. More
-    information on how to use the Windows Software Repo on a standalone minion
-    can be found :ref:`here <standalone-winrepo>`.
-
-.. _pygit2: https://github.com/libgit2/pygit2
-.. _GitPython: https://github.com/gitpython-developers/GitPython
-
-JBoss 7 State
-=============
-
-Remove unused argument ``timeout`` in jboss7.status.
-
-Pkgrepo State
-=============
-
-Deprecate ``enabled`` argument in ``pkgrepo.managed`` in favor of ``disabled``.
-
-Archive Module
-==============
-
-In the ``archive.tar`` and ``archive.cmd_unzip`` module functions, remove the
-arbitrary prefixing of the options string with ``-``.  An options string
-beginning with a ``--long-option``, would have uncharacteristically needed its
-first ``-`` removed under the former scheme.
-
-Also, tar will parse its options differently if short options are used with or
-without a preceding ``-``, so it is better to not confuse the user into
-thinking they're using the non- ``-`` format, when really they are using the
-with- ``-`` format.
-
-Win System Module
-=================
-
-The unit of the ``timeout`` parameter in the ``system.halt``,
-``system.poweroff``, ``system.reboot``,  and ``system.shutdown`` functions has
-been changed from seconds to minutes in order to be consistent with the linux
-timeout setting. (:issue:`24411`)  Optionally, the unit can be reverted to
-seconds by specifying ``in_seconds=True``.
-
-Deprecations
-============
-
-- The ``digital_ocean.py`` Salt Cloud driver was removed in favor of the
-``digital_ocean_v2.py`` driver as DigitalOcean has removed support for APIv1.
-The ``digital_ocean_v2.py`` was renamed to ``digital_ocean.py`` and supports
-DigitalOcean's APIv2.
-
-- The ``vsphere.py`` Salt Cloud driver has been deprecated in favor of the
-``vmware.py`` driver.
-
-- The ``openstack.py`` Salt Cloud driver has been deprecated in favor of the
-``nova.py`` driver.
-
-- The use of ``provider`` in Salt Cloud provider files to define cloud drivers
-has been deprecated in favor of useing ``driver``. Both terms will work until
-the Nitrogen release of Salt. Example provider file:
-
-.. code-block:: yaml
-
-    my-ec2-cloud-config:
-      id: 'HJGRYCILJLKJYG'
-      key: 'kdjgfsgm;woormgl/aserigjksjdhasdfgn'
-      private_key: /etc/salt/my_test_key.pem
-      keyname: my_test_key
-      securitygroup: default
-      driver: ec2
-
-- The use of ``lock`` has been deprecated and from ``salt.utils.fopen``.
-``salt.utils.flopen`` should be used instead.
-
-- The following args have been deprecated from the ``rabbitmq_vhost.present``
-state: ``user``, ``owner``, ``conf``, ``write``, ``read``, and ``runas``.
-
-- The use of ``runas`` has been deprecated from the ``rabbitmq_vhost.absent``
-state.
-
-- Support for ``output`` in ``mine.get`` was removed. ``--out`` should be used
-instead.
-
-- The use of ``delim`` was removed from the following functions in the ``match``
-execution module: ``pillar_pcre``, ``pillar``, ``grain_pcre``,
-
-Known Issues
-============
-
-- The TCP transport does not function on FreeBSD.

doc/topics/releases/index.rst

@@ -17,6 +17,7 @@ Previous Releases
     :maxdepth: 1
     :glob:
 
+    2015.8.*
     2015.5.*
     2014.7.*
     2014.1.*