Add password rotation

[etc/vim.git] / doc / vim-password-store.txt

diff --git a/doc/vim-password-store.txt b/doc/vim-password-store.txt
index 03a42c07f8fea159fadbc9f6298dcb1c76d6e16e..eca22ab8da7083513ad300494ed507ab1e777312 100644 (file)
--- a/doc/vim-password-store.txt
+++ b/doc/vim-password-store.txt
@@ -29,17 +29,37 @@ The plugin automatically loads when it sees the appropriate file paths
 for password-store. This is Tom Ryders 
 
 There are two functions:
-
+>
   :Conceal
   :Reveal
-
+<
 That apply syntax highlighting to obscure and un-obscure the password.
 By default the pass file loads in obscured mode, however when the cursor is on
-the file it's quite likely readable and editable.
-
-This offers minor "shoulder surfing" protection, facilitating editing of
-metadata, such as adding URLs etc.
-
+the word it should readable and editable. This offers minor "shoulder surfing"
+protection, facilitating editing of metadata, such as adding URLs etc.
+
+There's minor feedback for short passwords, with Error highlighting for
+passwords 6 or less characters long.
+
+Password store also adds password generation support via pwgen. Since
+password-store already leverages pwgen, this is a fairly safe assumption.
+There is a Plug mapping *<Plug>rotate_password*
+by default this is mapped to <C-X> and <C-A> but can be overridden via setting
+an alternate plug mapping
+>
+  nnoremap >M-a> <Plug>rotate_password
+<
+The mapped sequence will generate a random password. As neither decrement nor
+increment mean anything in this context, buth are mapped to the same plug.
+The default length of the password is 10 character, but
+modifiable by altering the global g:password_store_pwlength
+>
+  let g:password_store_pwlength = 20
+<
+This is also available via the function call(s)
+>
+   password_store#replace()
+<
 4. Licence                                            *password-store-licence*
 
 This plugin is licensed under the same terms as vim itself (see