doc/vim-password-store.txt

   1 *vim-password-store* Niceties for editing password-store files
   2
   3 ===============================================================================
   4 CONTENTS                                              *password-store-contents*
   5
   6     1. Intro ........................................... |password-store-intro|
   7     2. Requirements ............................. |password-store-requirements|
   8     3. Usage ........................................... |password-store-usage|
   9     4. Licence ....................................... |password-store-licence|
  10     5. Credits ....................................... |password-store-credits|
  11 ===============================================================================
  12 1. Intro                                                 *password-store-intro*
  13
  14 Password store is a nice command line password manager, well suited to
  15 vim's style. Tom Ryder has written a plugin to unset the standard
  16 password security leakages, backup files, info files etc. This works
  17 well, but doesn't provide hooks for extending. I wanted to add a few
  18 simple enhancements, including unsetting spelling (no password should be
  19 spell checked :-) and some simple syntax highlighting.
  20
  21 2. Requirements                                   *password-store-requirements*
  22
  23 A plugin manager (not required but the plugin is written to expect
  24 this) and password-store https://www.passwordstore.org/ .
  25
  26 3. Usage                                                 *password-store-usage*
  27
  28 The plugin automatically loads when it sees the appropriate file paths
  29 for password-store. This is Tom Ryders
  30
  31 There are two functions:
  32 >
  33   :Conceal
  34   :Reveal
  35 <
  36 That apply syntax highlighting to obscure and un-obscure the password.
  37 By default the pass file loads in obscured mode, however when the cursor is on
  38 the word it should readable and editable. This offers minor "shoulder surfing"
  39 protection, facilitating editing of metadata, such as adding URLs etc.
  40
  41 There's minor feedback for short passwords, with Error highlighting for
  42 passwords 6 or less characters long.
  43
  44 Password store also adds password generation support via pwgen. Since
  45 password-store already leverages pwgen, this is a fairly safe assumption.
  46 There is a Plug mapping *<Plug>rotate_password*
  47 by default this is mapped to <C-X> and <C-A> but can be overridden via setting
  48 an alternate plug mapping
  49 >
  50   nnoremap >M-a> <Plug>rotate_password
  51 <
  52 The mapped sequence will generate a random password. As neither decrement nor
  53 increment mean anything in this context, buth are mapped to the same plug.
  54 The default length of the password is 10 character, but
  55 modifiable by altering the global g:password_store_pwlength
  56 >
  57   let g:password_store_pwlength = 20
  58 <
  59 This is also available via the function call(s)
  60 >
  61    password_store#replace()
  62 <
  63 4. Licence                                            *password-store-licence*
  64
  65 This plugin is licensed under the same terms as vim itself (see
  66 |license| )
  67
  68 5. Credits                                            *password-store-credits*
  69
  70 Tom Ryder
  71 https://git.zx2c4.com/password-store/
  72
  73 vim:ft=help