From 17a39e88a5ca4e02992ed9ea9686ff43808e96bd Mon Sep 17 00:00:00 2001
From: Dag Wieers <dag@wieers.com>
Date: Thu, 2 Mar 2017 07:22:33 +0100
Subject: [PATCH] win_chocolatey: Add example to upgrade all installed software
 (#22167)

Add a missing example on how to upgrade all installed software using win_chocolatey.

This fixes #21559
---
 lib/ansible/modules/windows/win_chocolatey.py | 14 ++++++++++----
 1 file changed, 10 insertions(+), 4 deletions(-)

diff --git a/lib/ansible/modules/windows/win_chocolatey.py b/lib/ansible/modules/windows/win_chocolatey.py
index 5d4b01a9fae..e6479fe4595 100644
--- a/lib/ansible/modules/windows/win_chocolatey.py
+++ b/lib/ansible/modules/windows/win_chocolatey.py
@@ -106,19 +106,25 @@ EXAMPLES = r'''
   # Install git
   win_chocolatey:
     name: git
+    state: present
+
+  # Upgrade installed packages
+  win_chocolatey:
+    name: all
+    state: latest
 
   # Install notepadplusplus version 6.6
   win_chocolatey:
     name: notepadplusplus.install
     version: '6.6'
 
-  # Uninstall git
+  # Install git from specified repository
   win_chocolatey:
     name: git
-    state: absent
+    source: https://someserver/api/v2/
 
-  # Install git from specified repository
+  # Uninstall git
   win_chocolatey:
     name: git
-    source: https://someserver/api/v2/
+    state: absent
 '''