Merge 6a1ffb3dd1 into 6aa8192131

lib/ansible/modules/file.py

@@ -133,6 +133,11 @@ EXAMPLES = r'''
     group: foo
     mode: '0644'
 
+- name: Change file group using gid
+  ansible.builtin.file:
+    path: /etc/bar.conf
+    group: "1000"
+
 - name: Give insecure permissions to an existing file
   ansible.builtin.file:
     path: /work

lib/ansible/plugins/doc_fragments/files.py

@@ -41,7 +41,7 @@ options:
     type: str
   group:
     description:
-    - Name of the group that should own the filesystem object, as would be fed to I(chown).
+    - Name of the group or gid that should own the filesystem object, as would be fed to I(chown).
     - When left unspecified, it uses the current group of the current user unless you are root,
       in which case it can preserve the previous ownership.
     type: str