m-chrzan.xyz
aboutsummaryrefslogtreecommitdiff
path: root/README
diff options
context:
space:
mode:
authorJason A. Donenfeld <Jason@zx2c4.com>2012-09-03 17:57:46 +0200
committerJason A. Donenfeld <Jason@zx2c4.com>2012-09-03 17:57:46 +0200
commitddb59757f5e4a6c30ede99a2d4f039e881132ab9 (patch)
tree2dbccf700970bdfaa13eaa260a08cb2b26696912 /README
parent8769aa6370cd6b4ebd7393c32519a04772f5bd29 (diff)
Move examples into manpage.
Diffstat (limited to 'README')
-rw-r--r--README99
1 files changed, 10 insertions, 89 deletions
diff --git a/README b/README
index 8fb5d91..e07720c 100644
--- a/README
+++ b/README
@@ -8,99 +8,20 @@ This is a very simple password store that encrypts passwords using gpg and
places the encrypted password in a directory. It can generate new passwords
and keep track of old ones.
-If the password storage directory ($HOME/.password-store) is also a git
-repository, add/remove/change operations will create a corresponding git
-commit.
+Please see the man page for considerable more documentation and examples.
-Usage:
- pass init gpg-id
- Initialize new password storage and use gpg-id for encryption.
- pass [ls] [subfolder]
- List passwords.
- pass [show] [--clip,-c] pass-name
- Show existing password and optionally put it on the clipboard.
- If put on the clipboard, it will be cleared in 45 seconds.
- pass insert [--multiline,-m] pass-name
- Insert new optionally multiline password.
- pass generate [--no-symbols,-n] [--clip,-c] pass-name pass-length
- Generate a new password of pass-length with optionally no symbols.
- Optionally put it on the clipboard and clear board after 45 seconds.
- pass rm pass-name
- Remove existing password.
- pass push
- If the password store is a git repository, push the latest changes.
- pass pull
- If the password store is a git repository, pull the latest changes.
- pass git git-command-args...
- If the password store is a git repository, execute a git command
- specified by git-command-args.
- pass help
- Show this text.
+You may read the man page without installing the package by one of these
+commands:
-See the man page for more options -- man 1 pass.
+- Show it in man:
+ $ man ./man/pass.1
-Examples:
+- Produce an HTML page:
- - Initialize password store:
-
- zx2c4@laptop ~ $ pass init Jason@zx2c4.com
- mkdir: created directory ‘/home/zx2c4/.password-store’
- Password store initialized for Jason@zx2c4.com.
-
- - List existing passwords in store:
+ $ groff -mandoc -T html ./man/pass.1 > pass-man-page.html
- zx2c4@laptop ~ $ pass
- ├── Business
- │ ├── some-silly-business-site.com
- │ └── another-business-site.net
- ├── Email
- │ ├── donenfeld.com
- │   └── zx2c4.com
- └── France
- ├── bank
- ├── freebox
- └── mobilephone
-
- Alternatively, "pass ls".
-
- - Show existing password:
-
- zx2c4@laptop ~ $ pass Email/zx2c4.com
- sup3rh4x3rizmynam3
-
- - Add password to store:
-
- zx2c4@laptop ~ $ pass insert Business/cheese-whiz-factory
- Enter password for Business/cheese-whiz-factory: omg so much cheese what am i gonna do
-
- Or, multiline passwords:
-
- zx2c4@laptop ~ $ pass insert --multiline Business/cheese-whiz-factory
- Enter contents of Business/cheese-whiz-factory and press Ctrl+D when finished:
-
- Hey this is my
- awesome
- multi
- line
- passworrrrrrrrd.
- ^D
-
- - Generate new password:
-
- zx2c4@laptop ~ $ pass generate Email/jasondonenfeld.com 15
- The generated password to Email/jasondonenfeld.com is:
- $(-QF&Q=IN2nFBx
-
- Or, with no symbols:
-
- zx2c4@laptop ~ $ pass generate --no-symbols Email/jasondonenfeld.com 12
- The generated password to Email/jasondonenfeld.com is:
- YqFsMkBeO6di
-
- - Remove password from store:
-
- zx2c4@laptop ~ $ pass remove Business/cheese-whiz-factory
- rm: remove regular file ‘/home/zx2c4/.password-store/Business/cheese-whiz-factory.gpg’? y
- removed ‘/home/zx2c4/.password-store/Business/cheese-whiz-factory.gpg’
+- Produce a PDF document:
+ $ groff -mandoc ./man/pass.1 pass-man-page.ps
+ $ ps2pdf pass-man-page.ps