<div dir="ltr">







<p class="">Here are some definitions as I understand them:</p><p class="">- password storage: Directory structure with encrypted files (and optional git files).</p><p class="">- password file: An gpg encrypted file with with password string on the first line.</p>

<p class="">- password: The actual password string. The only way to refer to a <br>                      password is to use its pass-name.</p><p class="">- pass-name: The name of the password file without .gpg extension</p>

<p class="">- path: Alias to pass-name with an emphasis on optional subdirectory <br>            structure embedded in the pass-name.</p><p class=""><br></p><p class="">Now, the 'pass help' command uses these terms quite loosely. I've tried to rewrite the text marking changed text with **. Feel free to compare the the current output.</p>

<p class="">The text below might be hard to read due to word wrapping. It is partly caused by lines longer than 78 characters. The line length should be fixed in the usage text, too.</p><p class=""><br></p><p class=""><br>

</p>Usage:<br><br>    pass init [--path=subfolder,-p subfolder] gpg-id...<br><br>        Initialize new password storage and use gpg-id for encryption.<br><br>        Selectively re-encrypt existing *password files* using new gpg-id.<br>

<br>    pass [ls] [subfolder]<br><br>        List *pass-names*.<br><br>    pass find *search-string [search-string]+*<br><br>    List *pass-names* that match *search-strings*.<br><br>    pass [show] [--clip,-c] pass-name<br>

<br>        Show existing password and optionally put *first line of* it on the clipboard.<br><br>        If put on the clipboard, it will be cleared in 45 seconds.<br><br>    pass grep search-string<br><br>        *List pass-names of files* containing search-string when decrypted.<br>

<br>    pass insert [--echo,-e | --multiline,-m] [--force,-f] pass-name<br><br>        Insert new password. Optionally, echo the password back to the console<br><br>        during entry. Or, optionally, the entry may be multiline. Prompt before<br>

<br>        overwriting existing password unless forced.<br><br>    pass edit pass-name<br><br>        Insert a new password or edit an existing password using vi.<br><br>    pass generate [--no-symbols,-n] [--clip,-c] [--in-place,-i | --force,-f] pass-name pass-length<br>

<br>        Generate a new password of pass-length with optionally no symbols.<br><br>        Optionally put it on the clipboard and clear board after 45 seconds.<br><br>        Prompt before overwriting existing password unless forced.<br>

<br>        Optionally replace only the first line of an existing file with a new password.<br><br>    pass rm [--recursive,-r] [--force,-f] pass-name<br><br>        Remove existing password *file* or directory, optionally forcefully.<br>

<br>    pass mv [--force,-f] old-path new-path<br><br>        Renames or moves old-path to new-path, optionally forcefully, selectively *re-encrypting*.<br><br>    pass cp [--force,-f] old-path new-path<br><br>        Copies old-path to new-path, optionally forcefully, selectively *re-encrypting*.<br>

<br>    pass git git-command-args...<br><br>        If the password store is a git repository, execute a git command<br><br>        specified by git-command-args.<br><br>    pass help<br><br>        Show this text.<br><br>

    pass version<br><br>        Show version information.<p class=""><br></p><p class="">I hope your find these changes helpful.</p><div><div dir="ltr">     -Heikki<br><br>Heikki Lehvaslaiho - skype:heikki_lehvaslaiho <a href="http://about.me/heikki" target="_blank">http://about.me/heikki</a><br>

cell: +966 545 595 849  office: +966 12 808 2429<br><br>Saudi Arabian weekend is now Friday and Saturday.<div><br>KAUST Supercomputing Center, Building #1, Level 0, 0203-WS23<br>4700 King Abdullah University of Science and Technology (KAUST)<br>

Thuwal 23955-6900, Kingdom of Saudi Arabia<br></div></div></div>
</div>