Merge 8aed31f4e3 into 542643e786

plugins/modules/authorized_key.py

@@ -28,10 +28,9 @@ options:
     required: true
   path:
     description:
-      - Alternate path to the authorized_keys file.
+     - Alternative path to the authorized_keys file.
-      - When unset, this value defaults to I(~user/.ssh/authorized_keys).
+     - Most of the time, it's not necessary to set this key.
-      - To set this value please define "absolute path" 
+     - Use the path to your target authorized_keys if you need to explicitly point on it. 
-      or use I(~user/.ssh/authorized_keys)(where user is your target user_name).
     type: path
   manage_dir:
     description:
@@ -90,13 +89,6 @@ EXAMPLES = r'''
     state: present
     key: "{{ lookup('file', '/home/charlie/.ssh/id_rsa.pub') }}"
 
-- name: Set authorized key taken from file predefined target path
-  ansible.posix.authorized_key:
-    user: charlie
-    state: present
-    key: "{{ lookup('file', '/home/charlie/.ssh/id_rsa.pub') }}"
-    path: ~charlie/.ssh/authorized_keys
-
 - name: Set authorized keys taken from url
   ansible.posix.authorized_key:
     user: charlie
@@ -213,7 +205,7 @@ validate_certs:
 # =========
 #    user = username
 #    key = line to add to authorized_keys for user
-#    path = path to the user's authorized_keys file (default: ~user/.ssh/authorized_keys)
+#    path = path to the user's authorized_keys file (default: ~/.ssh/authorized_keys)
 #    manage_dir = whether to create, and control ownership of the directory (default: true)
 #    state = absent|present (default: present)
 #