mirror of
https://github.com/dcarrillo/prezto.git
synced 2025-07-01 19:49:25 +00:00
Compare commits
707 Commits
issue/276-
...
7e1c7e3c7a
Author | SHA1 | Date | |
---|---|---|---|
7e1c7e3c7a | |||
1431e4e8c2 | |||
dea85a0740 | |||
3dc3fa7f8c | |||
c857e809c3 | |||
ac1c39d2e1 | |||
2c66331316 | |||
fca913eded | |||
3da67271b9 | |||
1ff1099d05 | |||
98d69fc91f | |||
15150085e6 | |||
45adecd9c9 | |||
74d4100434 | |||
7ec1ecde3a | |||
20641f3447 | |||
bf3dfe8c02 | |||
d840f0fc7b | |||
d6e1ef5fcf | |||
7884fb2271 | |||
a96f1618b4 | |||
ecaed1cfa7 | |||
7f8b9b829a | |||
d828d06643 | |||
166cbe2fca | |||
48291f68e8 | |||
2451239713 | |||
98f6306d1e | |||
f3c92ffeb3 | |||
866d5dfccd | |||
dc66c17728 | |||
061a7b961c | |||
6833fcd2f2 | |||
f1e24d3fd8 | |||
37443368c1 | |||
afe59b293b | |||
f0942e6dda | |||
d686da3c03 | |||
9037fda36d | |||
53033bc5d9 | |||
7052e2a002 | |||
979144d0e4 | |||
c4a8f446c6 | |||
a3643f124e | |||
efebe3efec | |||
9459a716bf | |||
28ec39d9b2 | |||
9f37fc9841 | |||
f84075b8d4 | |||
af46875c5e | |||
c6b59f8bb1 | |||
515d70f639 | |||
7980dd91c9 | |||
e07fd052d7 | |||
d3d79bbe74 | |||
6eb4021556 | |||
d51e5ce40f | |||
6c5657be8e | |||
fae5e493ec | |||
2368c9142b | |||
1ff9421f7b | |||
424d4cb779 | |||
b14aca307d | |||
0628b91028 | |||
be61026920 | |||
95d223aa8a | |||
742c1ea26f | |||
d80e393f78 | |||
8edc5e9323 | |||
d04a6ef459 | |||
788aa3d158 | |||
261d3b8224 | |||
68300e6de4 | |||
e87a9b0a93 | |||
509c5ca80f | |||
1d1ae0a661 | |||
f830065347 | |||
3285b33f0c | |||
9d42feac16 | |||
93556a7d5f | |||
5a8bfd5bf5 | |||
8a967fc108 | |||
63bc5061a7 | |||
f651140f2c | |||
6a70bdfff2 | |||
c5175145d4 | |||
16ddedd1f3 | |||
db6cd0d668 | |||
40cc9f52f9 | |||
8003d0c6d8 | |||
7222fe5fd6 | |||
095f44796b | |||
4de0377106 | |||
a2f3f419f6 | |||
0a07ba27a2 | |||
ce937020ce | |||
428632ac07 | |||
76b8c810aa | |||
a7f223d959 | |||
d66041cdb7 | |||
b8a3d90a13 | |||
c005e87859 | |||
667fba697e | |||
704fc46c3f | |||
c43d483d47 | |||
f080e2075e | |||
b7a80d99a8 | |||
c7ef9c1f46 | |||
775f6123b2 | |||
e915c34507 | |||
39151645ac | |||
0a405494ca | |||
813bde4d44 | |||
38882275b8 | |||
e9197234cf | |||
685da200d7 | |||
cb8b9ca746 | |||
4e7ab4b8b7 | |||
677e301174 | |||
c21295b27f | |||
83f3dca4a3 | |||
a132c1007a | |||
2d3763380c | |||
20a78c04e5 | |||
ff91c8d410 | |||
b8f5b31573 | |||
cb69d2d3e4 | |||
793f239a5e | |||
649c0e4561 | |||
13c61bae30 | |||
6d546561c6 | |||
530ea10126 | |||
342385618c | |||
2da4774473 | |||
f427a567d7 | |||
de7b3b7fdc | |||
95ff0360ae | |||
5b03d7fa32 | |||
d5bef142d4 | |||
9b2744cfdf | |||
7fbedf4a3b | |||
f479f37ead | |||
f4ca9ebfc9 | |||
1b99be879c | |||
cfeb8cd6c9 | |||
0c22054a49 | |||
d955fbdeb7 | |||
94f9e44f3f | |||
92e6b37f73 | |||
d2832051f7 | |||
65e8ba0596 | |||
272528b439 | |||
a73bb314cc | |||
cb0099ec7a | |||
fc8f82329b | |||
3d827cdb88 | |||
47b37b22ea | |||
e9f281cd6f | |||
4b32ae96db | |||
bca85497f8 | |||
4bcbe2ee68 | |||
ac9843e2d4 | |||
66b9ea7d44 | |||
7cad349a5a | |||
4a32e9d68b | |||
7ec4aad48c | |||
1f52b03a45 | |||
9ae279e25a | |||
2acaec814f | |||
a3a51bdf6c | |||
c6efe80152 | |||
7c94154dda | |||
e86200e7aa | |||
721b1535ea | |||
a5ebde1b17 | |||
a251bd2fb9 | |||
ef3e9eda18 | |||
2d6205e714 | |||
b9c34d9445 | |||
0af28e758b | |||
048d5302d6 | |||
e9e8c31217 | |||
f549bd7a0b | |||
ed511e6747 | |||
13f3cabd81 | |||
b2aead431c | |||
21ce6a6f97 | |||
585b3646f9 | |||
aeb58b972d | |||
b44893d9eb | |||
ed6303c340 | |||
6d65cb4176 | |||
1bc0da5f48 | |||
55eb406515 | |||
2873885d37 | |||
91292526a0 | |||
a1df63bade | |||
9507a0e881 | |||
75b112bcd0 | |||
f596d5d1d6 | |||
61de4d199d | |||
6ae2f39cc1 | |||
75940e8ee9 | |||
43214f1aed | |||
8b1a7afd81 | |||
8914274ca9 | |||
34948690d5 | |||
a8087e01fb | |||
abb0c7ecb4 | |||
b01f02aa5c | |||
5566a9c792 | |||
3ae422a0da | |||
6dd97d15e0 | |||
21b83b65ef | |||
e94b6b2078 | |||
de23724dc3 | |||
e6e5e4d68f | |||
09e83ed282 | |||
9f86f48ae6 | |||
15bfe616bc | |||
1d58546406 | |||
ac65e8eb18 | |||
bb901dfb7e | |||
f235db7aaa | |||
82222831a7 | |||
1f4601e44c | |||
b8d7e2cad8 | |||
5d7c990eec | |||
d22effbf85 | |||
4ff726e600 | |||
c2c53592a1 | |||
4abbc55721 | |||
777674e07e | |||
ba4063f99e | |||
88456ec9b6 | |||
4a16d3fa50 | |||
a70d24ab10 | |||
a338cba805 | |||
0e6429da97 | |||
9d3e2f0204 | |||
dc8e168d5f | |||
3093f1b966 | |||
11184084bc | |||
54dff31b63 | |||
23c56a5640 | |||
1a48ae2e54 | |||
eee3c9c166 | |||
39e1a63349 | |||
d275f316ff | |||
6a2cc2e146 | |||
d45d87b08f | |||
a987c8bc8a | |||
f745645342 | |||
a2398fc045 | |||
e7fea3343f | |||
53286ebbdb | |||
2286662b80 | |||
3de1e24965 | |||
be68a38ff5 | |||
32084778d0 | |||
8bfed01773 | |||
b2a9152820 | |||
680fba3112 | |||
236907f8af | |||
108392b503 | |||
a09155f990 | |||
35a83744e7 | |||
b083b134e7 | |||
e6eea17b12 | |||
93313aac23 | |||
f37cf0ffc9 | |||
1ed5331e84 | |||
bfe1815cbf | |||
a43093119e | |||
a3753d8f3b | |||
58809b2d21 | |||
992b9de505 | |||
6f603df7a6 | |||
ff5bd9306e | |||
df4c61861d | |||
53facbe9de | |||
6c46804f41 | |||
e9387a177e | |||
ee885d42de | |||
fbcae356d3 | |||
f366e49c32 | |||
ad861d3b45 | |||
2bbf5d0687 | |||
dd7a26e219 | |||
7bb7a7cb6f | |||
66487c9532 | |||
f2042a29cc | |||
dacef14214 | |||
e064d5c65f | |||
152b4a1b5d | |||
e149367445 | |||
cd70822994 | |||
0d6e7de031 | |||
b11b9ce788 | |||
d4332e2faf | |||
92e668e1d9 | |||
3d911cd511 | |||
ae23bedd24 | |||
2995b7d0c8 | |||
6e179f24ab | |||
f8f93d4b91 | |||
b6b43eb331 | |||
300102897a | |||
054eb351f1 | |||
1b441e7654 | |||
443021237a | |||
a0977cb92e | |||
b3c27bb164 | |||
e00562e7cf | |||
742260b55f | |||
580ddc44f3 | |||
4325f74f9d | |||
6d00fdf8c8 | |||
e26387656d | |||
d7622624aa | |||
282b478fd2 | |||
904eef5fa5 | |||
906ac99e20 | |||
0b62639ad5 | |||
54d2a76731 | |||
e32a96be72 | |||
73e94b84bb | |||
82d3265ad5 | |||
66bfe9be27 | |||
83085e5231 | |||
4c31107e3b | |||
d8d6b4d70a | |||
e021adeb4a | |||
aa0395244d | |||
3ab569ff78 | |||
3a0bd28e0c | |||
64d57ec71f | |||
b407ba0c3a | |||
e2785cc246 | |||
029414581e | |||
7cdde9b631 | |||
8ed2c78de8 | |||
043d09bbfe | |||
df3468e957 | |||
65bcbae8bc | |||
64d6ae805c | |||
221c6cd128 | |||
cbe4815189 | |||
a3f40a7479 | |||
d725233bb1 | |||
2436806fce | |||
96bbb31cc8 | |||
ce349dff81 | |||
ad79f78fbe | |||
e159c1a439 | |||
f02dc1af57 | |||
105e9658bb | |||
948d9b3aa5 | |||
79927ac73a | |||
485ad9e704 | |||
c7dcd21c9e | |||
7ebb5e9dda | |||
ff9b901394 | |||
4b0ecffaca | |||
87d39f5dd2 | |||
cbcbedd694 | |||
109864429c | |||
b5d09e2da7 | |||
fb903cb067 | |||
6d5650eae7 | |||
25d8db301d | |||
63310f6403 | |||
1d0bee6098 | |||
9520f1be6f | |||
cd703d3c3c | |||
752f64f085 | |||
00f1d92ed8 | |||
34d4897d0e | |||
3faaffe7e9 | |||
34482cb325 | |||
2cfd366ba6 | |||
808d9d3579 | |||
76388a8cd1 | |||
6a8f1c6b16 | |||
ba0cb8afd8 | |||
46de6fef77 | |||
37c61a058c | |||
38fb41d66e | |||
727f094b0f | |||
8fa14ed72f | |||
58bcc43bf9 | |||
98f37b3c2f | |||
a7fb175b20 | |||
9c528efa60 | |||
83ab314b77 | |||
5ffc8a07f1 | |||
cab4ac54ec | |||
4c272a20f6 | |||
5b244eeadb | |||
3194442759 | |||
9dfa8a67f6 | |||
e6af5f2e91 | |||
dd1133d32e | |||
2f867d6f22 | |||
24e5e49ff2 | |||
730fc4690e | |||
5e295b0835 | |||
8d7e3e27c7 | |||
a60499f933 | |||
7b5196ca66 | |||
3f556400e7 | |||
b3c7d21d31 | |||
591d087ccc | |||
9b6bf4a7cd | |||
19435b16ea | |||
7e7124e84a | |||
09fe5191e7 | |||
0fc49ac4f0 | |||
e364eac8f5 | |||
9bdc1b35d5 | |||
9f1a41de90 | |||
d6276e8025 | |||
8846db9d4d | |||
eddbdd9416 | |||
24b710f545 | |||
a60fe47359 | |||
17a59bada7 | |||
ac628c9059 | |||
bcbaea27af | |||
608f291ad3 | |||
2db7f62c2b | |||
46e34d30b8 | |||
cb4be65d29 | |||
f236344fc8 | |||
90071d3ad0 | |||
c1a8fc0469 | |||
b0c85eddf6 | |||
04bfb5131b | |||
19990c8025 | |||
d25b251ef7 | |||
0f3a5f745e | |||
ebae698f70 | |||
d69070268a | |||
86de7a8d2e | |||
1221e4030d | |||
17bc7530ba | |||
aad91beb3c | |||
2a75fba6a8 | |||
6e1f4ddd19 | |||
7d109fb3fa | |||
899c176942 | |||
3f99519021 | |||
e3520b737f | |||
db48a22c74 | |||
e6136a517b | |||
7d5beeab51 | |||
a70bce3ea6 | |||
75a60bc7bf | |||
5cd3380d9d | |||
c6124d4d37 | |||
09b333eb41 | |||
a876890afd | |||
dbe9a5ea28 | |||
5ef10f7658 | |||
87868441eb | |||
eb47b45a0d | |||
a4ff6acd56 | |||
e52523204b | |||
961326f8e9 | |||
7fe28574a8 | |||
d101b0a319 | |||
f8f4953dce | |||
7c172fc9a7 | |||
ecc34e0051 | |||
1c041c0433 | |||
d9a1380263 | |||
a75c63768c | |||
a0541ce7a5 | |||
2f20a80f72 | |||
5bcc223e95 | |||
14670f40f0 | |||
7ae7a0266c | |||
08e39a587f | |||
658fffb3a6 | |||
6975b119b6 | |||
d02c2951b3 | |||
871b15663c | |||
42d9b78907 | |||
2794f95d3e | |||
46a1ffaf7e | |||
3d7a8c2870 | |||
1050a0a290 | |||
723b3812e1 | |||
7c509a264f | |||
850ad42c96 | |||
4f87376b50 | |||
876f426581 | |||
f15557159a | |||
81b41d2367 | |||
cf7d3cffbd | |||
fb37539f43 | |||
7242b4ed49 | |||
c38c2dd909 | |||
600b4cc9e6 | |||
38f0d2f34e | |||
40853f23c2 | |||
a622652f73 | |||
a8ce3da782 | |||
19d11ab1d0 | |||
e606b09c9e | |||
d035e4cf1e | |||
8a4333103d | |||
bb168c5881 | |||
7c64584629 | |||
7011031a87 | |||
2e20eb8571 | |||
5c0e68f75f | |||
1c0f95c08e | |||
fb6f3f7ee9 | |||
95036c908c | |||
9a70a1675c | |||
8655cd543b | |||
60c433d4ce | |||
b963484fe7 | |||
ee249e50ee | |||
412af29808 | |||
94708f6b50 | |||
8dafaae5a4 | |||
e413ef5a97 | |||
909006638d | |||
464a8d20a1 | |||
95d19b37c1 | |||
c0049855c5 | |||
27c2ccd8b9 | |||
fd0b627a8b | |||
076e29e97d | |||
013668f484 | |||
ddfc870f9a | |||
65b05c0220 | |||
12d48dfcf9 | |||
fb689449a7 | |||
483447082b | |||
2c1ad5bed1 | |||
4e35f701ca | |||
3a6ae0fc6c | |||
dcd8596192 | |||
a7729561e8 | |||
5271af8180 | |||
8913bcccd2 | |||
2ba060a426 | |||
8820b71f37 | |||
0be0ff565a | |||
7346efd206 | |||
b38ced856a | |||
4f19700919 | |||
c8b8397728 | |||
8bd720b0c7 | |||
38baf39513 | |||
e36eed9c8a | |||
64aa907087 | |||
7227c4f0be | |||
2ad1b2f5b1 | |||
a7e4b447b3 | |||
02b3d329ac | |||
e641c2111a | |||
165879d4b3 | |||
de9ed0610b | |||
c05fbedd8d | |||
e137068cac | |||
f2a826e963 | |||
bdec6c4e20 | |||
ef634f38a4 | |||
b761261b11 | |||
02c5f776fc | |||
a275db55d6 | |||
b6efdc1ea4 | |||
904c94469e | |||
159418835f | |||
f7ea78078f | |||
fe64f91f52 | |||
b46769149b | |||
999f0d1a74 | |||
f6a2c73423 | |||
a1dea6ae43 | |||
cd5067668c | |||
6a812ed36b | |||
ca03fd670a | |||
08676a273e | |||
20766138cb | |||
e9f86bf4db | |||
c98da90662 | |||
ac8bc74ef0 | |||
ccca57f2ac | |||
4016f0c7c1 | |||
c34098af20 | |||
ee0b02464c | |||
e144abb285 | |||
b41f485528 | |||
ab45ade380 | |||
1292587f95 | |||
933c61b8f1 | |||
88aee30ae8 | |||
4411c95a83 | |||
62d87cae32 | |||
d43bcb9720 | |||
ba351df9fb | |||
925b94b6e2 | |||
c171621747 | |||
0148ee6a4d | |||
fc3f8025ea | |||
9539341e1e | |||
13d1ed160e | |||
2a33581e80 | |||
3dd4cbc3c0 | |||
7a92046c86 | |||
3012c0984b | |||
00a5639e65 | |||
3cb1f7c4c9 | |||
90eae2b491 | |||
d349c1cec7 | |||
a7a4912940 | |||
82710c29fc | |||
9f82926f6e | |||
61e91b8fb0 | |||
967c91a351 | |||
087fce8548 | |||
2ae905a625 | |||
19fc31c342 | |||
e76df6022d | |||
c2d62c3b47 | |||
03336db523 | |||
1bc4235a5e | |||
c078c47c9d | |||
0bede677e6 | |||
ad09f29fd5 | |||
567506f7e7 | |||
13ed3a1bf7 | |||
6f9c1666e1 | |||
ab7f697734 | |||
d020d34e59 | |||
17a6124b43 | |||
3c47c57c87 | |||
ff0cdd3ed7 | |||
b948e3630b | |||
55e4db9429 | |||
53bd555c6d | |||
86ba5b69d3 | |||
5791c07d48 | |||
34a50c2550 | |||
417b9d429d | |||
fea08d4e50 | |||
d3f1441481 | |||
a84ac5b002 | |||
10c33ec9a4 | |||
9b1f39f267 | |||
36ade25eb6 | |||
8f711d64b5 | |||
c4b50ec1a0 | |||
62198b0326 | |||
b4884d4d45 | |||
abfc4ab6e5 | |||
657e8a16f4 | |||
ea25ccf62c | |||
3e88b8bcdc | |||
e892d7f3c7 | |||
4e4a6fcc63 | |||
3e8349ddde | |||
fdb406f917 | |||
493bf302f6 | |||
a217af99f3 | |||
06cc5088aa | |||
5088ca4839 | |||
0f696fc206 | |||
96bcf813b7 | |||
fe8f9a9b5b | |||
bf9dbfd5b9 | |||
ff0dfa424d | |||
fedad8e9cf | |||
478653fab2 | |||
10cf701864 | |||
7722dd4400 | |||
240eecaddf | |||
415e4bff3d | |||
e5a0e33f1c | |||
8189577772 | |||
c74cf4b5e0 | |||
72782528aa | |||
02717cb4c1 | |||
bccfca8c10 | |||
b8bb51d7b5 | |||
00e12b7a98 | |||
232313e2a0 | |||
e48dac79f3 | |||
dbeb6d4e1a | |||
af003d83c5 | |||
839f4a7b83 | |||
c091f71283 | |||
e1974ad58d | |||
391bc405d0 | |||
80ded5e33d | |||
fa6723a5ee | |||
57b283facd | |||
aefdce3fc3 | |||
e4e4f89c9f | |||
817dd3aa3a | |||
347928193f | |||
da1a837cd4 |
9
.editorconfig
Normal file
9
.editorconfig
Normal file
@ -0,0 +1,9 @@
|
|||||||
|
[*]
|
||||||
|
end_of_line = lf
|
||||||
|
insert_final_newline = true
|
||||||
|
indent_style = space
|
||||||
|
indent_size = 2
|
||||||
|
trim_trailing_whitespace = true
|
||||||
|
|
||||||
|
[{.gitattributes,.gitignore,.gitmodules}]
|
||||||
|
indent_style = tab
|
24
.github/ISSUE_TEMPLATE.md
vendored
Normal file
24
.github/ISSUE_TEMPLATE.md
vendored
Normal file
@ -0,0 +1,24 @@
|
|||||||
|
<!-- Please check if a similar issue already exists or has been closed before before opening your issue. -->
|
||||||
|
|
||||||
|
### Description
|
||||||
|
<!-- Provide a general description of the bug or feature -->
|
||||||
|
|
||||||
|
### Expected behavior
|
||||||
|
|
||||||
|
<!-- What you expected to happen -->
|
||||||
|
|
||||||
|
### Actual behavior
|
||||||
|
|
||||||
|
<!-- What actually happened -->
|
||||||
|
|
||||||
|
### Steps to Reproduce
|
||||||
|
|
||||||
|
1. [First Step]
|
||||||
|
2. [Second Step]
|
||||||
|
3. [and so on...]
|
||||||
|
|
||||||
|
### Versions
|
||||||
|
|
||||||
|
- Prezto commit:
|
||||||
|
- ZSH version:
|
||||||
|
- OS information:
|
10
.github/PULL_REQUEST_TEMPLATE.md
vendored
Normal file
10
.github/PULL_REQUEST_TEMPLATE.md
vendored
Normal file
@ -0,0 +1,10 @@
|
|||||||
|
Please be sure to check out our [contributing guidelines](https://github.com/sorin-ionescu/prezto/blob/master/CONTRIBUTING.md)
|
||||||
|
before submitting your pull request.
|
||||||
|
|
||||||
|
Fixes #
|
||||||
|
|
||||||
|
## Proposed Changes
|
||||||
|
|
||||||
|
-
|
||||||
|
-
|
||||||
|
-
|
1
.gitignore
vendored
1
.gitignore
vendored
@ -1,3 +1,4 @@
|
|||||||
*.zwc
|
*.zwc
|
||||||
*.zwc.old
|
*.zwc.old
|
||||||
modules/*/cache.zsh
|
modules/*/cache.zsh
|
||||||
|
contrib
|
||||||
|
22
.gitmodules
vendored
22
.gitmodules
vendored
@ -1,3 +1,6 @@
|
|||||||
|
[submodule "modules/autosuggestions/external"]
|
||||||
|
path = modules/autosuggestions/external
|
||||||
|
url = https://github.com/zsh-users/zsh-autosuggestions.git
|
||||||
[submodule "modules/history-substring-search/external"]
|
[submodule "modules/history-substring-search/external"]
|
||||||
path = modules/history-substring-search/external
|
path = modules/history-substring-search/external
|
||||||
url = https://github.com/zsh-users/zsh-history-substring-search.git
|
url = https://github.com/zsh-users/zsh-history-substring-search.git
|
||||||
@ -7,3 +10,22 @@
|
|||||||
[submodule "modules/completion/external"]
|
[submodule "modules/completion/external"]
|
||||||
path = modules/completion/external
|
path = modules/completion/external
|
||||||
url = https://github.com/zsh-users/zsh-completions.git
|
url = https://github.com/zsh-users/zsh-completions.git
|
||||||
|
[submodule "modules/prompt/external/powerline"]
|
||||||
|
path = modules/prompt/external/powerline
|
||||||
|
url = https://github.com/davidjrice/prezto_powerline.git
|
||||||
|
[submodule "modules/prompt/external/agnoster"]
|
||||||
|
path = modules/prompt/external/agnoster
|
||||||
|
url = https://github.com/agnoster/agnoster-zsh-theme.git
|
||||||
|
[submodule "modules/prompt/external/pure"]
|
||||||
|
path = modules/prompt/external/pure
|
||||||
|
url = https://github.com/sindresorhus/pure.git
|
||||||
|
[submodule "modules/fasd/external"]
|
||||||
|
path = modules/fasd/external
|
||||||
|
url = https://github.com/clvv/fasd.git
|
||||||
|
[submodule "modules/prompt/external/async"]
|
||||||
|
path = modules/prompt/external/async
|
||||||
|
url = https://github.com/mafredri/zsh-async.git
|
||||||
|
[submodule "modules/prompt/external/powerlevel10k"]
|
||||||
|
path = modules/prompt/external/powerlevel10k
|
||||||
|
url = https://github.com/romkatv/powerlevel10k.git
|
||||||
|
shallow = true
|
||||||
|
@ -1,42 +1,74 @@
|
|||||||
Contributing
|
# Contributing
|
||||||
------------
|
|
||||||
|
|
||||||
This project would not exist without all of its users and [contributors][1].
|
This project would not exist without all of its users and [contributors][1].
|
||||||
|
|
||||||
If you have ideas on how to make the configuration easier to maintain or
|
If you have ideas on how to make the configuration easier to maintain or
|
||||||
improve its performance, do not hesitate to fork and send pull requests.
|
improve its performance, do not hesitate to fork and send pull requests.
|
||||||
|
|
||||||
### Issue Reporting
|
## Issue Reporting
|
||||||
|
|
||||||
- Check that the issue has not already been reported.
|
- Check that the issue has not already been reported.
|
||||||
- Check that the issue has not already been fixed in the latest code.
|
- Check that the issue has not already been fixed in the latest code.
|
||||||
- Open an issue with a clear title and description in grammatically correct,
|
- Open an issue with a clear title and description in grammatically correct,
|
||||||
complete sentences.
|
complete sentences.
|
||||||
|
|
||||||
### Pull Request
|
## Pull Request
|
||||||
|
|
||||||
- Read [how to properly contribute to open source projects on GitHub][2].
|
- Read [how to properly contribute to open source projects on GitHub][2].
|
||||||
- Use a topic branch to easily amend a pull request later, if necessary.
|
- Use a topic branch to easily amend a pull request later, if necessary.
|
||||||
- Write [good commit messages][3].
|
- Write [good commit messages][3].
|
||||||
- Squash commits on the topic branch before opening a pull request.
|
- Squash commits on the topic branch before opening a pull request.
|
||||||
- Use the same coding style and spacing.
|
- Use the same coding style and spacing.
|
||||||
- Open a [pull request][4] that relates to but one subject with a clear
|
- Open a [pull request][4] that relates to but one subject with a clear title
|
||||||
title and description in grammatically correct, complete sentences.
|
and description in grammatically correct, complete sentences.
|
||||||
|
|
||||||
#### Modules
|
### Code Style
|
||||||
|
|
||||||
|
This project follows the [Google Shell Style Guide][5] when possible. However,
|
||||||
|
there are a number of additional things to keep in mind.
|
||||||
|
|
||||||
|
- Local variables should be used whenever possible.
|
||||||
|
- Prefer `zstyle` over environment variables for configuration.
|
||||||
|
- Prefer (( ... )) over [[ ... ]] for arithmetic expression.
|
||||||
|
- Use the function keyword to define functions.
|
||||||
|
- The 80 character hard limit can be waived for readability.
|
||||||
|
|
||||||
|
### Using an Alternative *zprezto* Directory
|
||||||
|
|
||||||
|
To work on Prezto without affecting your current configuration:
|
||||||
|
|
||||||
|
```sh
|
||||||
|
mkdir devel-zprezto
|
||||||
|
cd devel-zprezto
|
||||||
|
git clone --recursive https://github.com/sorin-ionescu/prezto.git .zprezto
|
||||||
|
ZDOTDIR=$(pwd)
|
||||||
|
echo "Your development ZDOTDIR is $ZDOTDIR"
|
||||||
|
setopt EXTENDED_GLOB
|
||||||
|
for rcfile in "${ZDOTDIR:-$HOME}"/.zprezto/runcoms/^README.md(.N); do
|
||||||
|
ln -s "$rcfile" "${ZDOTDIR:-$HOME}/.${rcfile:t}"
|
||||||
|
done
|
||||||
|
```
|
||||||
|
|
||||||
|
Then to start zsh in this development environment you will run:
|
||||||
|
|
||||||
|
```console
|
||||||
|
ZDOTDIR=/path/to/devel-zprezto zsh
|
||||||
|
```
|
||||||
|
|
||||||
|
### Modules
|
||||||
|
|
||||||
- A *README.md* must be present.
|
- A *README.md* must be present.
|
||||||
- Large functions must be placed in a *functions* directory.
|
- Large functions must be placed in a *functions* directory.
|
||||||
- Functions that take arguments must have completion.
|
- Functions that take arguments must have completion.
|
||||||
|
|
||||||
#### Themes
|
### Themes
|
||||||
|
|
||||||
- A screenshots section must be present in the file header.
|
- A screenshots section must be present in the file header.
|
||||||
- The pull request description must have [embedded screenshots][5].
|
- The pull request description must have [embedded screenshots][6].
|
||||||
|
|
||||||
[1]: https://github.com/sorin-ionescu/prezto/contributors
|
[1]: https://github.com/sorin-ionescu/prezto/contributors
|
||||||
[2]: http://gun.io/blog/how-to-github-fork-branch-and-pull-request
|
[2]: https://gun.io/blog/how-to-github-fork-branch-and-pull-request
|
||||||
[3]: http://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html
|
[3]: http://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html
|
||||||
[4]: https://help.github.com/articles/using-pull-requests
|
[4]: https://help.github.com/articles/using-pull-requests
|
||||||
[5]: http://daringfireball.net/projects/markdown/syntax#img
|
[5]: https://google.github.io/styleguide/shell.xml
|
||||||
|
[6]: https://github.github.com/gfm/#images
|
||||||
|
15
INSTALL.md
Normal file
15
INSTALL.md
Normal file
@ -0,0 +1,15 @@
|
|||||||
|
|
||||||
|
# Install and update
|
||||||
|
|
||||||
|
## Install
|
||||||
|
|
||||||
|
```bash
|
||||||
|
git clone https://github.com/dcarrillo/prezto.git ~/.zprezto
|
||||||
|
cd ~/.zprezto
|
||||||
|
git remote add upstream https://github.com/sorin-ionescu/prezto.git
|
||||||
|
git submodule update --init --recursive
|
||||||
|
```
|
||||||
|
|
||||||
|
## Keep updated
|
||||||
|
|
||||||
|
Run the [update](scripts/update_zprezto) script.
|
20
LICENSE
Normal file
20
LICENSE
Normal file
@ -0,0 +1,20 @@
|
|||||||
|
Copyright (c) 2009-2011 Robby Russell and contributors
|
||||||
|
Copyright (c) 2011-2017 Sorin Ionescu and contributors
|
||||||
|
|
||||||
|
Permission is hereby granted, free of charge, to any person obtaining a copy of
|
||||||
|
this software and associated documentation files (the "Software"), to deal in
|
||||||
|
the Software without restriction, including without limitation the rights to
|
||||||
|
use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
|
||||||
|
of the Software, and to permit persons to whom the Software is furnished to do
|
||||||
|
so, subject to the following conditions:
|
||||||
|
|
||||||
|
The above copyright notice and this permission notice shall be included in all
|
||||||
|
copies or substantial portions of the Software.
|
||||||
|
|
||||||
|
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||||||
|
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
||||||
|
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
||||||
|
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
||||||
|
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
||||||
|
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
||||||
|
SOFTWARE
|
180
README.md
180
README.md
@ -1,118 +1,158 @@
|
|||||||
Prezto — Instantly Awesome Zsh
|
# Prezto — Instantly Awesome Zsh
|
||||||
==============================
|
|
||||||
|
|
||||||
Prezto is the configuration framework for [Zsh][1]; it enriches the command line
|
Prezto is the configuration framework for [Zsh][1]; it enriches the command line
|
||||||
interface environment with sane defaults, aliases, functions, auto completion,
|
interface environment with sane defaults, aliases, functions, auto completion,
|
||||||
and prompt themes.
|
and prompt themes.
|
||||||
|
|
||||||
Installation
|
## Installation
|
||||||
------------
|
|
||||||
|
|
||||||
Prezto will work with any recent release of Zsh, but the minimum recommended
|
Prezto will work with any recent release of Zsh, but the minimum required
|
||||||
version is 4.3.11. Unfortunately, [Cygwin][9] is not supported due to
|
version is **4.3.11**.
|
||||||
non-standard core utilities.
|
|
||||||
|
|
||||||
1. Launch Zsh:
|
01. Launch Zsh:
|
||||||
|
|
||||||
|
```console
|
||||||
zsh
|
zsh
|
||||||
|
```
|
||||||
|
|
||||||
2. Clone the repository:
|
02. Clone the repository:
|
||||||
|
|
||||||
|
```console
|
||||||
git clone --recursive https://github.com/sorin-ionescu/prezto.git "${ZDOTDIR:-$HOME}/.zprezto"
|
git clone --recursive https://github.com/sorin-ionescu/prezto.git "${ZDOTDIR:-$HOME}/.zprezto"
|
||||||
|
```
|
||||||
|
|
||||||
3. Create a new Zsh configuration by copying the Zsh configuration files
|
<details>
|
||||||
provided:
|
<summary><em>Optional: Installing in <code>$XDG_CONFIG_HOME</code></em></summary>
|
||||||
|
|
||||||
|
Optionally, if you already have `$XDG_CONFIG_HOME` configured (usually as
|
||||||
|
_`$HOME/.config`_ by default) and intend to install Prezto under
|
||||||
|
_`$XDG_CONFIG_HOME/zsh`_ instead, you can clone the repository there and
|
||||||
|
configure `$ZDOTDIR` separately if not already configured.
|
||||||
|
|
||||||
|
- Clone the repository:
|
||||||
|
|
||||||
|
```console
|
||||||
|
git clone --recursive https://github.com/sorin-ionescu/prezto.git "${ZDOTDIR:-${XDG_CONFIG_HOME:-$HOME/.config}/zsh}/.zprezto"
|
||||||
|
```
|
||||||
|
|
||||||
|
- Configure `$XDG_CONFIG_HOME` and `$ZDOTDIR` in _`$HOME/.zshenv`_:
|
||||||
|
|
||||||
|
```sh
|
||||||
|
export XDG_CONFIG_HOME="${XDG_CONFIG_HOME:=$HOME/.config}"
|
||||||
|
export ZDOTDIR="${ZDOTDIR:=$XDG_CONFIG_HOME/zsh}"
|
||||||
|
source "$ZDOTDIR/.zshenv"
|
||||||
|
```
|
||||||
|
|
||||||
|
</details>
|
||||||
|
|
||||||
|
03. Create a new Zsh configuration by copying/linking the Zsh configuration
|
||||||
|
files provided:
|
||||||
|
|
||||||
|
```console
|
||||||
setopt EXTENDED_GLOB
|
setopt EXTENDED_GLOB
|
||||||
for rcfile in "${ZDOTDIR:-$HOME}"/.zprezto/runcoms/^README.md(.N); do
|
for rcfile in "${ZDOTDIR:-$HOME}"/.zprezto/runcoms/^README.md(.N); do
|
||||||
ln -s "$rcfile" "${ZDOTDIR:-$HOME}/.${rcfile:t}"
|
ln -s "$rcfile" "${ZDOTDIR:-$HOME}/.${rcfile:t}"
|
||||||
done
|
done
|
||||||
|
```
|
||||||
|
|
||||||
4. Set Zsh as your default shell:
|
**Note:** If you already have any of the given configuration files, `ln` in
|
||||||
|
the above operation will cause an error. In simple cases, you can load
|
||||||
|
Prezto by adding the line `source "${ZDOTDIR:-$HOME}/.zprezto/init.zsh"` to
|
||||||
|
the bottom of your _`${ZDOTDIR:-$HOME}/.zshrc`_ and keep the rest of your
|
||||||
|
Zsh configuration intact. For more complicated setups, we recommend that you
|
||||||
|
back up your original configs and replace them with the provided Prezto
|
||||||
|
[_`runcoms`_][10].
|
||||||
|
|
||||||
|
04. Set Zsh as your default shell:
|
||||||
|
|
||||||
|
```console
|
||||||
chsh -s /bin/zsh
|
chsh -s /bin/zsh
|
||||||
|
```
|
||||||
|
|
||||||
5. Open a new Zsh terminal window or tab.
|
05. Open a new Zsh terminal window or tab.
|
||||||
|
|
||||||
### Troubleshooting
|
### Troubleshooting
|
||||||
|
|
||||||
If you are not able to find certain commands after switching to *Prezto*,
|
If you are not able to find certain commands after switching to Prezto, modify
|
||||||
modify the `PATH` variable in *~/.zshenv* then open a new Zsh terminal
|
the `PATH` variable in _`${ZDOTDIR:-$HOME}/.zprofile`_ then open a new Zsh
|
||||||
window or tab.
|
terminal window or tab.
|
||||||
|
|
||||||
Updating
|
## Updating
|
||||||
--------
|
|
||||||
|
|
||||||
Pull the latest changes and update submodules.
|
Run `zprezto-update` to automatically check if there is an update to Prezto.
|
||||||
|
If there are no file conflicts, Prezto and its submodules will be automatically
|
||||||
|
updated. If there are conflicts you will be instructed to go into the
|
||||||
|
`$ZPREZTODIR` directory and resolve them yourself.
|
||||||
|
|
||||||
git pull && git submodule update --init --recursive
|
To pull the latest changes and update submodules manually:
|
||||||
|
|
||||||
Usage
|
```console
|
||||||
-----
|
cd $ZPREZTODIR
|
||||||
|
git pull
|
||||||
|
git submodule sync --recursive
|
||||||
|
git submodule update --init --recursive
|
||||||
|
```
|
||||||
|
|
||||||
Prezto has many features disabled by default. Read the source code and
|
## Usage
|
||||||
accompanying README files to learn of what is available.
|
|
||||||
|
Prezto has many features disabled by default. Read the source code and the
|
||||||
|
accompanying README files to learn about what is available.
|
||||||
|
|
||||||
### Modules
|
### Modules
|
||||||
|
|
||||||
1. Browse */modules* to see what is available.
|
01. Browse [_`modules`_][9] to see what is available.
|
||||||
2. Load the modules you need in *~/.zpreztorc* then open a new Zsh terminal
|
02. Load the modules you need in _`${ZDOTDIR:-$HOME}/.zpreztorc`_ and then open
|
||||||
window or tab.
|
a new Zsh terminal window or tab.
|
||||||
|
|
||||||
### Themes
|
### Themes
|
||||||
|
|
||||||
1. For a list of themes, type `prompt -l`.
|
01. For a list of themes, type `prompt -l`.
|
||||||
2. To preview a theme, type `prompt -p name`.
|
02. To preview a theme, type `prompt -p name`.
|
||||||
3. Load the theme you like in *~/.zpreztorc* then open a new Zsh terminal
|
03. Load the theme you like in _`${ZDOTDIR:-$HOME}/.zpreztorc`_ and then
|
||||||
window or tab.
|
open a new Zsh terminal window or tab.
|
||||||
|
|
||||||
![sorin theme][2]
|
![sorin theme][2]
|
||||||
|
Note that the [_`git`_][11] module may be required for special symbols to
|
||||||
|
appear, such as those on the right of the above image. Add `'git'` to the
|
||||||
|
`pmodule` list (under `zstyle ':prezto:load' pmodule \` in your
|
||||||
|
_`${ZDOTDIR:-$HOME}/.zpreztorc`_) to enable this module.
|
||||||
|
|
||||||
Customization
|
### External Modules
|
||||||
-------------
|
|
||||||
|
|
||||||
The project is managed via [Git][3]. It is highly recommended that you fork this
|
01. By default modules will be loaded from [_`/modules`_][9] and _`/contrib`_.
|
||||||
project; so, that you can commit your changes and push them to [GitHub][4] to
|
02. Additional module directories can be added to the
|
||||||
not lose them. If you do not know how to use Git, follow this [tutorial][5] and
|
`:prezto:load:pmodule-dirs` setting in _`${ZDOTDIR:-$HOME}/.zpreztorc`_.
|
||||||
bookmark this [reference][6].
|
|
||||||
|
|
||||||
Resources
|
Note that module names need to be unique or they will cause an error when
|
||||||
---------
|
loading.
|
||||||
|
|
||||||
|
```sh
|
||||||
|
zstyle ':prezto:load' pmodule-dirs $HOME/.zprezto-contrib
|
||||||
|
```
|
||||||
|
|
||||||
|
## Customization
|
||||||
|
|
||||||
|
The project is managed via [Git][3]. We highly recommend that you fork this
|
||||||
|
project so that you can commit your changes and push them to your fork on
|
||||||
|
[GitHub][4] to preserve them. If you do not know how to use Git, follow this
|
||||||
|
[tutorial][5] and bookmark this [reference][6].
|
||||||
|
|
||||||
|
## Resources
|
||||||
|
|
||||||
The [Zsh Reference Card][7] and the [zsh-lovers][8] man page are indispensable.
|
The [Zsh Reference Card][7] and the [zsh-lovers][8] man page are indispensable.
|
||||||
|
|
||||||
License
|
## License
|
||||||
-------
|
|
||||||
|
|
||||||
(The MIT License)
|
This project is licensed under the MIT License.
|
||||||
|
|
||||||
Copyright (c) 2009-2014 Sorin Ionescu and contributors.
|
[1]: https://www.zsh.org
|
||||||
|
[2]: https://i.imgur.com/nrGV6pg.png "sorin theme"
|
||||||
Permission is hereby granted, free of charge, to any person obtaining a copy of
|
[3]: https://git-scm.com
|
||||||
this software and associated documentation files (the "Software"), to deal in
|
|
||||||
the Software without restriction, including without limitation the rights to
|
|
||||||
use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
|
|
||||||
of the Software, and to permit persons to whom the Software is furnished to do
|
|
||||||
so, subject to the following conditions:
|
|
||||||
|
|
||||||
The above copyright notice and this permission notice shall be included in all
|
|
||||||
copies or substantial portions of the Software.
|
|
||||||
|
|
||||||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
||||||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
||||||
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
||||||
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
||||||
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
||||||
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
||||||
SOFTWARE.
|
|
||||||
|
|
||||||
[1]: http://www.zsh.org
|
|
||||||
[2]: http://i.imgur.com/nBEEZ.png "sorin theme"
|
|
||||||
[3]: http://git-scm.com
|
|
||||||
[4]: https://github.com
|
[4]: https://github.com
|
||||||
[5]: http://gitimmersion.com
|
[5]: https://gitimmersion.com
|
||||||
[6]: http://gitref.org
|
[6]: https://git.github.io/git-reference/
|
||||||
[7]: http://www.bash2zsh.com/zsh_refcard/refcard.pdf
|
[7]: http://www.bash2zsh.com/zsh_refcard/refcard.pdf
|
||||||
[8]: http://grml.org/zsh/zsh-lovers.html
|
[8]: https://grml.org/zsh/zsh-lovers.html
|
||||||
[9]: http://www.cygwin.com
|
[9]: modules#readme
|
||||||
|
[10]: runcoms#readme
|
||||||
|
[11]: modules/git#readme
|
||||||
|
@ -1,55 +0,0 @@
|
|||||||
.TH Archive
|
|
||||||
.PP
|
|
||||||
Provides functions to extract and list popular archive formats.
|
|
||||||
.SH Functions
|
|
||||||
.RS
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCextract\fR extracts the contents of one or more archives.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCls-archive\fR lists the contents of one or more archives.
|
|
||||||
.RE
|
|
||||||
.SH Supported Formats
|
|
||||||
.PP
|
|
||||||
The following archive formats are supported when the required utilities are
|
|
||||||
installed:
|
|
||||||
.RS
|
|
||||||
.IP \(bu 2
|
|
||||||
\fI.tar.gz\fP, \fI.tgz\fP require \fB\fCtar\fR.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fI.tar.bz2\fP, \fI.tbz\fP require \fB\fCtar\fR.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fI.tar.xz\fP, \fI.txz\fP require \fB\fCtar\fR with \fIxz\fP support.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fI.tar.zma\fP, \fI.tlz\fP require \fB\fCtar\fR with \fIlzma\fP support.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fI.tar\fP requires \fB\fCtar\fR.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fI.gz\fP requires \fB\fCgunzip\fR.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fI.bz2\fP requires \fB\fCbunzip2\fR.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fI.xz\fP requires \fB\fCunxz\fR.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fI.lzma\fP requires \fB\fCunlzma\fR.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fI.Z\fP requires \fB\fCuncompress\fR.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fI.zip\fP requires \fB\fCunzip\fR.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fI.rar\fP requires \fB\fCunrar\fR.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fI.7z\fP requires \fB\fC7za\fR.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fI.deb\fP requires \fB\fCar\fR, \fB\fCtar\fR.
|
|
||||||
.RE
|
|
||||||
.SH Authors
|
|
||||||
.PP
|
|
||||||
\fIThe authors of this module should be contacted via the issue tracker
|
|
||||||
.UR https://github.com/sorin-ionescu/prezto/issues
|
|
||||||
.UE .\fP
|
|
||||||
.RS
|
|
||||||
.IP \(bu 2
|
|
||||||
Sorin Ionescu
|
|
||||||
.UR https://github.com/sorin-ionescu
|
|
||||||
.UE
|
|
||||||
.RE
|
|
@ -1,17 +0,0 @@
|
|||||||
.TH Command\-Not\-Found
|
|
||||||
.PP
|
|
||||||
Loads the command\-not\-found
|
|
||||||
.UR https://code.launchpad.net/command-not-found
|
|
||||||
.UE
|
|
||||||
tool on Debian\-based distributions.
|
|
||||||
.SH Authors
|
|
||||||
.PP
|
|
||||||
\fIThe authors of this module should be contacted via the issue tracker
|
|
||||||
.UR https://github.com/sorin-ionescu/prezto/issues
|
|
||||||
.UE .\fP
|
|
||||||
.RS
|
|
||||||
.IP \(bu 2
|
|
||||||
Joseph Booker
|
|
||||||
.UR https://github.com/sargas
|
|
||||||
.UE
|
|
||||||
.RE
|
|
@ -1,27 +0,0 @@
|
|||||||
.TH Completion
|
|
||||||
.PP
|
|
||||||
Loads and configures tab completion and provides additional completions from
|
|
||||||
the zsh\-completions
|
|
||||||
.UR https://github.com/zsh-users/zsh-completions
|
|
||||||
.UE
|
|
||||||
project.
|
|
||||||
.PP
|
|
||||||
This module must be loaded \fBafter\fP the \fIutility\fP module.
|
|
||||||
.SH Contributors
|
|
||||||
.PP
|
|
||||||
Completions should be submitted to the zsh\-completions
|
|
||||||
.UR https://github.com/zsh-users/zsh-completions
|
|
||||||
.UE
|
|
||||||
project according
|
|
||||||
to its rules and regulations. This module will be synchronized against it.
|
|
||||||
.SH Authors
|
|
||||||
.PP
|
|
||||||
\fIThe authors of this module should be contacted via the issue tracker
|
|
||||||
.UR https://github.com/sorin-ionescu/prezto/issues
|
|
||||||
.UE .\fP
|
|
||||||
.RS
|
|
||||||
.IP \(bu 2
|
|
||||||
Sorin Ionescu
|
|
||||||
.UR https://github.com/sorin-ionescu
|
|
||||||
.UE
|
|
||||||
.RE
|
|
@ -1,49 +0,0 @@
|
|||||||
.TH Directory
|
|
||||||
.PP
|
|
||||||
Sets directory options and defines directory aliases.
|
|
||||||
.SH Options
|
|
||||||
.RS
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCAUTO_CD\fR auto changes to a directory without typing \fB\fCcd\fR.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCAUTO_PUSHD\fR pushes the old directory onto the stack on \fB\fCcd\fR.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCPUSHD_IGNORE_DUPS\fR does not store duplicates in the stack.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCPUSHD_SILENT\fR does not print the directory stack after \fB\fCpushd\fR or \fB\fCpopd\fR.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCPUSHD_TO_HOME\fR pushes to the home directory when no argument is given.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCCDABLE_VARS\fR changes directory to a path stored in a variable.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCAUTO_NAME_DIRS\fR auto adds variable\-stored paths to \fB\fC~\fR list.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCMULTIOS\fR writes to multiple descriptors.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCEXTENDED_GLOB\fR uses extended globbing syntax.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCCLOBBER\fR does not overwrite existing files with \fB\fC>\fR and \fB\fC>>\fR. Use \fB\fC>!\fR and
|
|
||||||
\fB\fC>>!\fR to bypass.
|
|
||||||
.RE
|
|
||||||
.SH Aliases
|
|
||||||
.RS
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCd\fR prints the contents of the directory stack.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fC1 ... 9\fR changes the directory to the \fBn\fP previous one.
|
|
||||||
.RE
|
|
||||||
.SH Authors
|
|
||||||
.PP
|
|
||||||
\fIThe authors of this module should be contacted via the issue tracker
|
|
||||||
.UR https://github.com/sorin-ionescu/prezto/issues
|
|
||||||
.UE .\fP
|
|
||||||
.RS
|
|
||||||
.IP \(bu 2
|
|
||||||
James Cox
|
|
||||||
.UR https://github.com/imajes
|
|
||||||
.UE
|
|
||||||
.IP \(bu 2
|
|
||||||
Sorin Ionescu
|
|
||||||
.UR https://github.com/sorin-ionescu
|
|
||||||
.UE
|
|
||||||
.RE
|
|
@ -1,63 +0,0 @@
|
|||||||
.TH Dpkg
|
|
||||||
.PP
|
|
||||||
Defines dpkg
|
|
||||||
.UR http://wiki.debian.org/Teams/Dpkg
|
|
||||||
.UE
|
|
||||||
aliases and functions.
|
|
||||||
.SH Aliases
|
|
||||||
.RS
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCdebc\fR cleans the cache.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCdebf\fR displays a file's packake.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCdebi\fR installs packages from repositories.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCdebI\fR installs packages from files.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCdebq\fR displays package information.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCdebu\fR updates the packages lists.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCdebU\fR upgrades outdated packages.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCdebx\fR removes packages.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCdebX\fR removes packages, their configuration, and unneeded dependencies.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCdebs\fR searches for packages.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCdeb-build\fR creates a basic .deb package.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCdeb-kclean\fR removes all kernel images and headers, except for the ones in
|
|
||||||
use.
|
|
||||||
.RE
|
|
||||||
.SH Functions
|
|
||||||
.RS
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCdeb-clone\fR generates a script that can be used to duplicate a dpkg\-based
|
|
||||||
system.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCdeb-history\fR displays dpkg history.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCdeb-kbuild\fR makes a dpkg Linux kernel package.
|
|
||||||
.RE
|
|
||||||
.SH Authors
|
|
||||||
.PP
|
|
||||||
\fIThe authors of this module should be contacted via the issue tracker
|
|
||||||
.UR https://github.com/sorin-ionescu/prezto/issues
|
|
||||||
.UE .\fP
|
|
||||||
.RS
|
|
||||||
.IP \(bu 2
|
|
||||||
Daniel Bolton
|
|
||||||
.UR https://github.com/dbb
|
|
||||||
.UE
|
|
||||||
.IP \(bu 2
|
|
||||||
Benjamin Boudreau
|
|
||||||
.UR https://github.com/dreur
|
|
||||||
.UE
|
|
||||||
.IP \(bu 2
|
|
||||||
Sorin Ionescu
|
|
||||||
.UR https://github.com/sorin-ionescu
|
|
||||||
.UE
|
|
||||||
.RE
|
|
@ -1,22 +0,0 @@
|
|||||||
.TH Environment
|
|
||||||
.PP
|
|
||||||
Sets general shell options and defines environment variables.
|
|
||||||
.PP
|
|
||||||
This module must be loaded first.
|
|
||||||
.SH Environment Variables
|
|
||||||
.SH Contributors
|
|
||||||
.PP
|
|
||||||
This module \fBMUST NOT\fP rely on any command not built in Zsh.
|
|
||||||
.PP
|
|
||||||
Non\-interactive environment variables should be defined in \fIzshenv\fP.
|
|
||||||
.SH Authors
|
|
||||||
.PP
|
|
||||||
\fIThe authors of this module should be contacted via the issue tracker
|
|
||||||
.UR https://github.com/sorin-ionescu/prezto/issues
|
|
||||||
.UE .\fP
|
|
||||||
.RS
|
|
||||||
.IP \(bu 2
|
|
||||||
Sorin Ionescu
|
|
||||||
.UR https://github.com/sorin-ionescu
|
|
||||||
.UE
|
|
||||||
.RE
|
|
@ -1,31 +0,0 @@
|
|||||||
.TH GNU Utility
|
|
||||||
.PP
|
|
||||||
Provides for the interactive use of GNU utilities on non\-GNU systems.
|
|
||||||
.PP
|
|
||||||
Installing GNU utilities on non\-GNU systems in \fB\fC$PATH\fR without a prefix, i.e.
|
|
||||||
\fB\fCls\fR instead of \fB\fCgls\fR, is not recommended since scripts that target other
|
|
||||||
utilities will be broken.
|
|
||||||
.PP
|
|
||||||
However, for interactive use, prefixed commands can be wrapped in their
|
|
||||||
non\-prefixed counterparts.
|
|
||||||
.PP
|
|
||||||
This module must be loaded \fBbefore\fP the \fIutility\fP module.
|
|
||||||
.SH Settings
|
|
||||||
.SS Prefix
|
|
||||||
.PP
|
|
||||||
To use a different prefix, add the following to \fIzpreztorc\fP, and replace 'g' with
|
|
||||||
the desired prefix:
|
|
||||||
.nf
|
|
||||||
zstyle ':prezto:module:gnu-utility' prefix 'g'
|
|
||||||
.fi
|
|
||||||
.SH Authors
|
|
||||||
.PP
|
|
||||||
\fIThe authors of this module should be contacted via the issue tracker
|
|
||||||
.UR https://github.com/sorin-ionescu/prezto/issues
|
|
||||||
.UE .\fP
|
|
||||||
.RS
|
|
||||||
.IP \(bu 2
|
|
||||||
Sorin Ionescu
|
|
||||||
.UR https://github.com/sorin-ionescu
|
|
||||||
.UE
|
|
||||||
.RE
|
|
@ -1,20 +0,0 @@
|
|||||||
.TH GPG\-Agent
|
|
||||||
.PP
|
|
||||||
Provides for an easier use of gpg\-agent
|
|
||||||
.UR http://linux.die.net/man/1/gpg-agent
|
|
||||||
.UE .
|
|
||||||
.SH Authors
|
|
||||||
.PP
|
|
||||||
\fIThe authors of this module should be contacted via the issue tracker
|
|
||||||
.UR https://github.com/sorin-ionescu/prezto/issues
|
|
||||||
.UE .\fP
|
|
||||||
.RS
|
|
||||||
.IP \(bu 2
|
|
||||||
Florian Walch
|
|
||||||
.UR https://github.com/fwalch
|
|
||||||
.UE
|
|
||||||
.IP \(bu 2
|
|
||||||
Sorin Ionescu
|
|
||||||
.UR https://github.com/sorin-ionescu
|
|
||||||
.UE
|
|
||||||
.RE
|
|
@ -1,27 +0,0 @@
|
|||||||
.TH Haskell
|
|
||||||
.PP
|
|
||||||
Enables local Haskell package installation.
|
|
||||||
.SH Per\-user Package Installation
|
|
||||||
.PP
|
|
||||||
Cabal
|
|
||||||
.UR http://www.haskell.org/cabal/
|
|
||||||
.UE , the Haskell package manager, can install packages into per user
|
|
||||||
directories.
|
|
||||||
.PP
|
|
||||||
This module prepends per user directories to the relevant path variables to
|
|
||||||
enable the execution of user installed executables and the reading of
|
|
||||||
documentation.
|
|
||||||
.SS Usage
|
|
||||||
.PP
|
|
||||||
Install packages into per user directories with \fB\fCcabal install --user\fR.
|
|
||||||
.SH Authors
|
|
||||||
.PP
|
|
||||||
\fIThe authors of this module should be contacted via the issue tracker
|
|
||||||
.UR https://github.com/sorin-ionescu/prezto/issues
|
|
||||||
.UE .\fP
|
|
||||||
.RS
|
|
||||||
.IP \(bu 2
|
|
||||||
Sebastian Wiesner
|
|
||||||
.UR https://github.com/lunaryorn
|
|
||||||
.UE
|
|
||||||
.RE
|
|
@ -1,29 +0,0 @@
|
|||||||
.TH Helper
|
|
||||||
.PP
|
|
||||||
Provides helper functions for developing modules.
|
|
||||||
.SH Functions
|
|
||||||
.RS
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCadd-zsh-trap\fR adds a function name to a list to be called when a trap is
|
|
||||||
triggered.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCis-autoloadable\fR checks if a file can be autoloaded by trying to load it
|
|
||||||
in a subshell.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCis-callable\fR checks if a name is a command, function, or alias.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCis-true\fR checks a boolean variable for "true".
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCcoalesce\fR prints the first non\-empty string in the arguments array.
|
|
||||||
.RE
|
|
||||||
.SH Authors
|
|
||||||
.PP
|
|
||||||
\fIThe authors of this module should be contacted via the issue tracker
|
|
||||||
.UR https://github.com/sorin-ionescu/prezto/issues
|
|
||||||
.UE .\fP
|
|
||||||
.RS
|
|
||||||
.IP \(bu 2
|
|
||||||
Sorin Ionescu
|
|
||||||
.UR https://github.com/sorin-ionescu
|
|
||||||
.UE
|
|
||||||
.RE
|
|
@ -1,55 +0,0 @@
|
|||||||
.TH History Substring Search
|
|
||||||
.PP
|
|
||||||
Integrates zsh\-history\-substring\-search
|
|
||||||
.UR https://github.com/zsh-users/zsh-history-substring-search
|
|
||||||
.UE
|
|
||||||
into Prezto, which implements
|
|
||||||
the Fish shell
|
|
||||||
.UR http://fishshell.com
|
|
||||||
.UE 's history search feature, where the user can type in any
|
|
||||||
part of a previously entered command and press up and down to cycle through
|
|
||||||
matching commands.
|
|
||||||
.PP
|
|
||||||
If this module is used in conjuncture with the \fIsyntax\-highlighting\fP module, it
|
|
||||||
must be loaded \fBafter\fP it.
|
|
||||||
.SH Contributors
|
|
||||||
.PP
|
|
||||||
New features and bug fixes should be submitted to the
|
|
||||||
zsh\-history\-substring\-search
|
|
||||||
.UR https://github.com/zsh-users/zsh-history-substring-search
|
|
||||||
.UE
|
|
||||||
project according to its rules and
|
|
||||||
regulations. This module will be synchronized against it.
|
|
||||||
.SH Settings
|
|
||||||
.SS Case Sensitivity
|
|
||||||
.PP
|
|
||||||
To enable case\-sensitivity for this module only, add the following line to
|
|
||||||
\fIzpreztorc\fP:
|
|
||||||
.nf
|
|
||||||
zstyle ':prezto:module:history-substring-search' case-sensitive 'yes'
|
|
||||||
.fi
|
|
||||||
.SS Highlighting
|
|
||||||
.PP
|
|
||||||
If colors are enabled, \fIhistory\-substring\-search\fP will automatically highlight
|
|
||||||
positive results.
|
|
||||||
.PP
|
|
||||||
To enable highlighting for this module only, add the following line to
|
|
||||||
\fIzpreztorc\fP:
|
|
||||||
.nf
|
|
||||||
zstyle ':prezto:module:history-substring-search' color 'yes'
|
|
||||||
.fi
|
|
||||||
.SH Authors
|
|
||||||
.PP
|
|
||||||
\fIThe authors of this module should be contacted via the issue tracker
|
|
||||||
.UR https://github.com/sorin-ionescu/prezto/issues
|
|
||||||
.UE .\fP
|
|
||||||
.RS
|
|
||||||
.IP \(bu 2
|
|
||||||
Suraj N. Kurapati
|
|
||||||
.UR https://github.com/sunaku
|
|
||||||
.UE
|
|
||||||
.IP \(bu 2
|
|
||||||
Sorin Ionescu
|
|
||||||
.UR https://github.com/sorin-ionescu
|
|
||||||
.UE
|
|
||||||
.RE
|
|
@ -1,62 +0,0 @@
|
|||||||
.TH History
|
|
||||||
.PP
|
|
||||||
Sets history
|
|
||||||
.UR http://zsh.sourceforge.net/Guide/zshguide02.html#l16
|
|
||||||
.UE
|
|
||||||
options and defines history aliases.
|
|
||||||
.SH Variables
|
|
||||||
.RS
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCHISTFILE\fR stores the path to the history file.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCHISTSIZE\fR stores the maximum number of events to save in the internal history.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCSAVEHIST\fR stores the maximum number of events to save in the history file.
|
|
||||||
.RE
|
|
||||||
.SH Options
|
|
||||||
.RS
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCBANG_HIST\fR treats the \fB!\fP character specially during expansion.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCEXTENDED_HISTORY\fR writes the history file in the \fI:start:elapsed;command\fP format.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCINC_APPEND_HISTORY\fR writes to the history file immediately, not when the shell exits.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCSHARE_HISTORY\fR shares history between all sessions.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCHIST_EXPIRE_DUPS_FIRST\fR expires a duplicate event first when trimming history.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCHIST_IGNORE_DUPS\fR does not record an event that was just recorded again.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCHIST_IGNORE_ALL_DUPS\fR deletes an old recorded event if a new event is a duplicate.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCHIST_FIND_NO_DUPS\fR does not display a previously found event.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCHIST_IGNORE_SPACE\fR does not record an event starting with a space.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCHIST_SAVE_NO_DUPS\fR does not write a duplicate event to the history file.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCHIST_VERIFY\fR does not execute immediately upon history expansion.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCHIST_BEEP\fR beeps when accessing non\-existent history.
|
|
||||||
.RE
|
|
||||||
.SH Aliases
|
|
||||||
.RS
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fChistory-stat\fR lists the ten most used commands
|
|
||||||
.RE
|
|
||||||
.SH Authors
|
|
||||||
.PP
|
|
||||||
\fIThe authors of this module should be contacted via the issue tracker
|
|
||||||
.UR https://github.com/sorin-ionescu/prezto/issues
|
|
||||||
.UE .\fP
|
|
||||||
.RS
|
|
||||||
.IP \(bu 2
|
|
||||||
Robby Russell
|
|
||||||
.UR https://github.com/robbyrussell
|
|
||||||
.UE
|
|
||||||
.IP \(bu 2
|
|
||||||
Sorin Ionescu
|
|
||||||
.UR https://github.com/sorin-ionescu
|
|
||||||
.UE
|
|
||||||
.RE
|
|
@ -1,35 +0,0 @@
|
|||||||
.TH Macports
|
|
||||||
.PP
|
|
||||||
Defines MacPorts aliases and adds MacPorts directories to path variables.
|
|
||||||
.SH Aliases
|
|
||||||
.RS
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCportc\fR cleans the files used to build ports.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCporti\fR installs a port.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCports\fR searches for a port.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCportu\fR upgrades a port.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCportU\fR upgrades MacPorts, the ports collection, and outdated ports.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCportx\fR uninstalls a port.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCportX\fR uninstalls inactive ports.
|
|
||||||
.RE
|
|
||||||
.SH Authors
|
|
||||||
.PP
|
|
||||||
\fIThe authors of this module should be contacted via the issue tracker
|
|
||||||
.UR https://github.com/sorin-ionescu/prezto/issues
|
|
||||||
.UE .\fP
|
|
||||||
.RS
|
|
||||||
.IP \(bu 2
|
|
||||||
Matt Cable
|
|
||||||
.UR https://github.com/curiousstranger
|
|
||||||
.UE
|
|
||||||
.IP \(bu 2
|
|
||||||
Sorin Ionescu
|
|
||||||
.UR https://github.com/sorin-ionescu
|
|
||||||
.UE
|
|
||||||
.RE
|
|
@ -1,29 +0,0 @@
|
|||||||
.TH Node.js
|
|
||||||
.PP
|
|
||||||
Provides utility functions for Node.js
|
|
||||||
.UR http://nodejs.org
|
|
||||||
.UE
|
|
||||||
and loads npm
|
|
||||||
.UR http://npmjs.org
|
|
||||||
.UE
|
|
||||||
completion.
|
|
||||||
.SH Functions
|
|
||||||
.RS
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCnode-doc\fR opens the Node.js online API documentation
|
|
||||||
.UR http://nodejs.org/api
|
|
||||||
.UE
|
|
||||||
in the default
|
|
||||||
browser.
|
|
||||||
.RE
|
|
||||||
.SH Authors
|
|
||||||
.PP
|
|
||||||
\fIThe authors of this module should be contacted via the issue tracker
|
|
||||||
.UR https://github.com/sorin-ionescu/prezto/issues
|
|
||||||
.UE .\fP
|
|
||||||
.RS
|
|
||||||
.IP \(bu 2
|
|
||||||
Sorin Ionescu
|
|
||||||
.UR https://github.com/sorin-ionescu
|
|
||||||
.UE
|
|
||||||
.RE
|
|
@ -1,48 +0,0 @@
|
|||||||
.TH OSX
|
|
||||||
.PP
|
|
||||||
Defines Mac OS X
|
|
||||||
.UR http://www.apple.com/macosx/
|
|
||||||
.UE
|
|
||||||
aliases and functions.
|
|
||||||
.SH Aliases
|
|
||||||
.RS
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCcdf\fR changes the current working director to the current \fIFinder\fP
|
|
||||||
directory.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCpushdf\fR pushes the current working directory onto the directory queue and
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCql\fR quick looks at files.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCrm-osx-cruft\fR deletes .DS_Store, __MACOSX cruft.
|
|
||||||
.RE
|
|
||||||
.SH Functions
|
|
||||||
.RS
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCmanb\fR opens \fIman\fP pages in \fIBwana.app\fP
|
|
||||||
.UR http://bruji.com/bwana/
|
|
||||||
.UE .
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCmanp\fR opens \fIman\fP pages in \fIPreview.app\fP.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCpfd\fR prints the current \fIFinder\fP directory.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCpfs\fR prints the current \fIFinder\fP selection.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCtab\fR creates a new tab (works in both \fITerminal\fP and \fIiTerm\fP
|
|
||||||
.UR http://www.iterm2.com/
|
|
||||||
.UE ).
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCtrash\fR moves files and folders to \fITrash\fP.
|
|
||||||
.RE
|
|
||||||
.SH Authors
|
|
||||||
.PP
|
|
||||||
\fIThe authors of this module should be contacted via the issue tracker
|
|
||||||
.UR https://github.com/sorin-ionescu/prezto/issues
|
|
||||||
.UE .\fP
|
|
||||||
.RS
|
|
||||||
.IP \(bu 2
|
|
||||||
Sorin Ionescu
|
|
||||||
.UR https://github.com/sorin-ionescu
|
|
||||||
.UE
|
|
||||||
.RE
|
|
@ -1,84 +0,0 @@
|
|||||||
.TH Pacman
|
|
||||||
.PP
|
|
||||||
Provides aliases and functions for the Pacman
|
|
||||||
.UR http://www.archlinux.org/pacman/
|
|
||||||
.UE
|
|
||||||
package manager and
|
|
||||||
frontends.
|
|
||||||
.SH Settings
|
|
||||||
.PP
|
|
||||||
To enable a Pacman frontend, for example, Yaourt
|
|
||||||
.UR http://archlinux.fr/yaourt-en
|
|
||||||
.UE , add the following line to
|
|
||||||
\fIzpreztorc\fP:
|
|
||||||
.nf
|
|
||||||
zstyle ':prezto:module:pacman' frontend 'yaourt'
|
|
||||||
.fi
|
|
||||||
.PP
|
|
||||||
If you have enabled color globally in \fIzpreztorc\fP, you may disable it for certain
|
|
||||||
commands.
|
|
||||||
.PP
|
|
||||||
To disable \fB\fCyaourt\fR highlighting, add the following line to \fIzpreztorc\fP:
|
|
||||||
.nf
|
|
||||||
zstyle ':prezto:module:pacman:yaourt' color 'no'
|
|
||||||
.fi
|
|
||||||
.SH Aliases
|
|
||||||
.SS Pacman
|
|
||||||
.RS
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCpac\fR is short for \fB\fCpacman\fR.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCpaci\fR installs packages from repositories.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCpacI\fR installs packages from files.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCpacx\fR removes packages and unneeded dependencies.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCpacX\fR removes packages, their configuration, and unneeded dependencies.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCpacq\fR displays information about a package from the repositories.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCpacQ\fR displays information about a package from the local database.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCpacs\fR searches for packages in the repositories.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCpacS\fR searches for packages in the local database.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCpacu\fR synchronizes the local package and Arch Build System (requires \fB\fCabs\fR)
|
|
||||||
databases against the repositories.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCpacU\fR synchronizes the local package database against the repositories then
|
|
||||||
upgrades outdated packages.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCpacman-list-orphans\fR lists orphan packages.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCpacman-remove-orphans\fR removes orphan packages.
|
|
||||||
.RE
|
|
||||||
.SS Frontends
|
|
||||||
.SS Yaourt
|
|
||||||
.RS
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCpacc\fR manages \fI.pac\\fP* files.
|
|
||||||
.RE
|
|
||||||
.SH Functions
|
|
||||||
.RS
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCpacman-list-explicit\fR lists explicitly installed pacman packages.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCpacman-list-disowned\fR lists pacman disowned files.
|
|
||||||
.RE
|
|
||||||
.SH Authors
|
|
||||||
.PP
|
|
||||||
\fIThe authors of this module should be contacted via the issue tracker
|
|
||||||
.UR https://github.com/sorin-ionescu/prezto/issues
|
|
||||||
.UE .\fP
|
|
||||||
.RS
|
|
||||||
.IP \(bu 2
|
|
||||||
Benjamin Boudreau
|
|
||||||
.UR https://github.com/dreur
|
|
||||||
.UE
|
|
||||||
.IP \(bu 2
|
|
||||||
Sorin Ionescu
|
|
||||||
.UR https://github.com/sorin-ionescu
|
|
||||||
.UE
|
|
||||||
.RE
|
|
@ -1,74 +0,0 @@
|
|||||||
.TH Perl
|
|
||||||
.PP
|
|
||||||
Enables local Perl
|
|
||||||
.UR http://www.perl.org
|
|
||||||
.UE
|
|
||||||
module installation on Mac OS X and defines alises.
|
|
||||||
.SH Local Module Installation
|
|
||||||
.PP
|
|
||||||
Perl versions older than 5.14 do not support the local installation of Perl
|
|
||||||
modules natively. This module allows for local installation of Perl modules on
|
|
||||||
Mac OS X in \fI~/Library/Perl/5.12\fP by altering the environment.
|
|
||||||
.SS Usage
|
|
||||||
.PP
|
|
||||||
For Perl versions older than 5.14, install \fIlocal::lib\fP.
|
|
||||||
.nf
|
|
||||||
curl -L -C - -O http://search.cpan.org/CPAN/authors/id/A/AP/APEIRON/local-lib-1.008004.tar.gz
|
|
||||||
tar xvf local-lib-1.008004.tar.gz
|
|
||||||
cd local-lib-1.008004
|
|
||||||
perl Makefile.PL --bootstrap=$HOME/Library/Perl/5.12
|
|
||||||
make && make test && make install
|
|
||||||
.fi
|
|
||||||
.PP
|
|
||||||
Install \fIcpanminus\fP:
|
|
||||||
.nf
|
|
||||||
curl -L http://cpanmin.us | perl - --self-upgrade
|
|
||||||
.fi
|
|
||||||
.SH Perlbrew
|
|
||||||
.PP
|
|
||||||
An alternative to the above is to use Perlbrew
|
|
||||||
.UR http://perlbrew.pl
|
|
||||||
.UE , which allows for the
|
|
||||||
management of multiple, isolated Perl installations in the home directory.
|
|
||||||
.SH Aliases
|
|
||||||
.SS General
|
|
||||||
.RS
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCpl\fR is short for \fB\fCperl\fR.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCpld\fR looks up Perl documentation (\fB\fCperldoc\fR).
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCple\fR executes a one line program in a loop (\fB\fCperl -wlne\fR).
|
|
||||||
.RE
|
|
||||||
.SS Perlbrew
|
|
||||||
.RS
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCplb\fR manages Perl environments.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCplba\fR lists available Perl versions.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCplbi\fR installs a Perl version.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCplbl\fR lists installed Perl versions.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCplbo\fR temporarily turns off Perlbrew.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCplbO\fR turns off Perlbrew.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCplbs\fR switches to a Perl version.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCplbu\fR uninstalls a Perl version.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCplbx\fR temporarily sets the Perl version to use.
|
|
||||||
.RE
|
|
||||||
.SH Authors
|
|
||||||
.PP
|
|
||||||
\fIThe authors of this module should be contacted via the issue tracker
|
|
||||||
.UR https://github.com/sorin-ionescu/prezto/issues
|
|
||||||
.UE .\fP
|
|
||||||
.RS
|
|
||||||
.IP \(bu 2
|
|
||||||
Sorin Ionescu
|
|
||||||
.UR https://github.com/sorin-ionescu
|
|
||||||
.UE
|
|
||||||
.RE
|
|
@ -1,108 +0,0 @@
|
|||||||
.TH Prompt
|
|
||||||
.PP
|
|
||||||
Loads prompt themes
|
|
||||||
.UR http://zsh.sourceforge.net/Doc/Release/User-Contributions.html#Prompt-Themes
|
|
||||||
.UE .
|
|
||||||
.SH Settings
|
|
||||||
.PP
|
|
||||||
To select a prompt theme, add the following to \fIzpreztorc\fP, and replace \fBname\fP
|
|
||||||
with the name of the theme you wish to load. Setting it to \fBrandom\fP will load
|
|
||||||
a random theme.
|
|
||||||
.nf
|
|
||||||
zstyle ':prezto:module:prompt' theme 'name'
|
|
||||||
.fi
|
|
||||||
.SH Theming
|
|
||||||
.PP
|
|
||||||
A prompt theme is an autoloadable function file with a special name,
|
|
||||||
\fB\fCprompt_name_setup\fR, placed anywhere in \fB\fC$fpath\fR, but for the purpose of this
|
|
||||||
project, themes \fBshould\fP be placed in the \fImodules/prompt/functions\fP
|
|
||||||
directory.
|
|
||||||
.SS Theme Functions
|
|
||||||
.PP
|
|
||||||
There are three theme functions, a setup function, a help function, and
|
|
||||||
a preview function. The setup function \fBmust\fP always be defined. The help
|
|
||||||
function and the preview functions are optional.
|
|
||||||
.SS prompt_name_setup
|
|
||||||
.PP
|
|
||||||
This function is called by the \fB\fCprompt\fR function to install the theme. This
|
|
||||||
function may define other functions as necessary to maintain the prompt,
|
|
||||||
including a function that displays help or a function used to preview it.
|
|
||||||
.PP
|
|
||||||
\fBDo not call this function directly.\fP
|
|
||||||
.PP
|
|
||||||
The most basic example of this function can be seen bellow.
|
|
||||||
.nf
|
|
||||||
function prompt_name_setup {
|
|
||||||
PROMPT='%m%# '
|
|
||||||
RPROMPT=''
|
|
||||||
}
|
|
||||||
.fi
|
|
||||||
.SS prompt_name_help
|
|
||||||
.PP
|
|
||||||
If the \fB\fCprompt_name_setup\fR function is customizable via parameters, a help
|
|
||||||
function \fBshould\fP be defined. The user will access it via \fB\fCprompt -h name\fR.
|
|
||||||
.PP
|
|
||||||
The most basic example of this function can be seen bellow.
|
|
||||||
.nf
|
|
||||||
function prompt_name_help {
|
|
||||||
cat <<EOH
|
|
||||||
This prompt is color-scheme-able. You can invoke it thus:
|
|
||||||
prompt theme [<color1>] [<color2>]
|
|
||||||
where the color is for the left-hand prompt.
|
|
||||||
EOH
|
|
||||||
}
|
|
||||||
.fi
|
|
||||||
.SS prompt_name_preview
|
|
||||||
.PP
|
|
||||||
If the \fB\fCprompt_name_setup\fR function is customizable via parameters, a preview
|
|
||||||
function \fBshould\fP be defined. The user will access it via \fB\fCprompt -p name\fR.
|
|
||||||
.PP
|
|
||||||
The most basic example of this function can be seen bellow.
|
|
||||||
.nf
|
|
||||||
function prompt_name_preview {
|
|
||||||
if (( $# > 0 )); then
|
|
||||||
prompt_preview_theme theme "$@"
|
|
||||||
else
|
|
||||||
prompt_preview_theme theme red green blue
|
|
||||||
print
|
|
||||||
prompt_preview_theme theme yellow magenta black
|
|
||||||
fi
|
|
||||||
}
|
|
||||||
.fi
|
|
||||||
.SS Hook Functions
|
|
||||||
.PP
|
|
||||||
There are many Zsh hook
|
|
||||||
.UR http://zsh.sourceforge.net/Doc/Release/Functions.html#Hook-Functions
|
|
||||||
.UE
|
|
||||||
functions, but mostly the \fIprecmd\fP hook will be
|
|
||||||
used.
|
|
||||||
.SS prompt_name_precmd
|
|
||||||
.PP
|
|
||||||
This hook is called before the prompt is displayed and is useful for getting
|
|
||||||
information to display in a prompt.
|
|
||||||
.PP
|
|
||||||
When calling functions to get information to display in a prompt, do not assume
|
|
||||||
that all the dependencies have been loaded. Always check for the availability of
|
|
||||||
a function before you calling it.
|
|
||||||
.PP
|
|
||||||
\fBDo not register hook functions. They will be registered by the \fB\fCprompt\fR function.\fP
|
|
||||||
.PP
|
|
||||||
The most basic example of this function can be seen bellow.
|
|
||||||
.nf
|
|
||||||
function prompt_name_precmd {
|
|
||||||
if (( $+functions[git-info] )); then
|
|
||||||
git-info
|
|
||||||
fi
|
|
||||||
}
|
|
||||||
.fi
|
|
||||||
.SH Authors
|
|
||||||
.PP
|
|
||||||
\fIThe authors of this module should be contacted via the issue tracker
|
|
||||||
.UR https://github.com/sorin-ionescu/prezto/issues
|
|
||||||
.UE .\fP
|
|
||||||
.RS
|
|
||||||
.IP \(bu 2
|
|
||||||
Sorin Ionescu
|
|
||||||
.UR https://github.com/sorin-ionescu
|
|
||||||
.UE
|
|
||||||
.RE
|
|
@ -1,119 +0,0 @@
|
|||||||
.TH Python
|
|
||||||
.PP
|
|
||||||
Enables local Python and local Python package installation.
|
|
||||||
.SH Local Python Installation
|
|
||||||
.PP
|
|
||||||
pythonz
|
|
||||||
.UR http://saghul.github.com/pythonz/
|
|
||||||
.UE
|
|
||||||
builds and installs multiple Python versions locally in the home
|
|
||||||
directory.
|
|
||||||
.PP
|
|
||||||
This module prepends the pythonz directory to the path variable to enable the
|
|
||||||
execution of \fB\fCpythonz\fR.
|
|
||||||
.SS Usage
|
|
||||||
.PP
|
|
||||||
Install Python versions with \fB\fCpythonz install\fR into \fI~/.pythonz/pythons\fP.
|
|
||||||
.SH Local Package Installation
|
|
||||||
.PP
|
|
||||||
Since version 2.6, Python supports per user package installation, as defined in
|
|
||||||
PEP 370
|
|
||||||
.UR http://www.python.org/dev/peps/pep-0370/
|
|
||||||
.UE .
|
|
||||||
.PP
|
|
||||||
This module prepends per user site directories to the relevant path variables
|
|
||||||
to enable the execution of user installed scripts and the reading of
|
|
||||||
documentation.
|
|
||||||
.SS Usage
|
|
||||||
.PP
|
|
||||||
Install packages into the per user site directory with \fB\fCeasy_install --user\fR or
|
|
||||||
\fB\fCpip install --user\fR.
|
|
||||||
.SH virtualenvwrapper
|
|
||||||
.PP
|
|
||||||
virtualenvwrapper
|
|
||||||
.UR http://www.doughellmann.com/projects/virtualenvwrapper/
|
|
||||||
.UE
|
|
||||||
is a frontend to the popular virtualenv
|
|
||||||
.UR http://pypi.python.org/pypi/virtualenv
|
|
||||||
.UE
|
|
||||||
utility.
|
|
||||||
.PP
|
|
||||||
virtualenv creates isolated Python environments and virtualenvwrapper provides
|
|
||||||
convenient shell functions to create, switch, and manage them.
|
|
||||||
.SS Usage
|
|
||||||
.PP
|
|
||||||
Install virtualenvwrapper.
|
|
||||||
.PP
|
|
||||||
Virtual environments are stored in \fI~/.virtualenvs\fP.
|
|
||||||
.PP
|
|
||||||
There are configuration variables that have to be set to enable certain features.
|
|
||||||
If you wish to use these features, export the variables in \fI~/.zshenv\fP
|
|
||||||
.PP
|
|
||||||
The variable \fB\fC$PROJECT_HOME\fR tells virtualenvwrapper where to place project
|
|
||||||
working directories. It must be set and the directory created before \fB\fCmkproject\fR
|
|
||||||
is used. Replace \fIDeveloper\fP with your projects directory.
|
|
||||||
.nf
|
|
||||||
export PROJECT_HOME="$HOME/Developer"
|
|
||||||
.fi
|
|
||||||
.PP
|
|
||||||
The variable \fB\fC$VIRTUALENVWRAPPER_VIRTUALENV_ARGS\fR tells virtualenvwrapper what
|
|
||||||
arguments to pass to \fB\fCvirtualenv\fR. For example, set the value to
|
|
||||||
\fI\-\-no\-site\-packages\fP to ensure that all new environments are isolated from the
|
|
||||||
system site\-packages directory.
|
|
||||||
.nf
|
|
||||||
export VIRTUALENVWRAPPER_VIRTUALENV_ARGS='--no-site-packages'
|
|
||||||
.fi
|
|
||||||
.SH Aliases
|
|
||||||
.RS
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCpy\fR is short for \fB\fCpython\fR.
|
|
||||||
.RE
|
|
||||||
.SS Pythonz
|
|
||||||
.RS
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCpyz\fR is short for \fB\fCpythonz\fR.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCpyzc\fR removes stale source folders and archives.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCpyzi\fR installs Python versions.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCpyzl\fR lists installed Python versions.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCpyzL\fR lists available Python versions.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCpyzu\fR updates itself to the latest version.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCpyzx\fR uninstalls Python versions.
|
|
||||||
.RE
|
|
||||||
.SH Functions
|
|
||||||
.RS
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCpython-info\fR exposes information about the Python environment via the
|
|
||||||
\fB\fC$python_info\fR associative array.
|
|
||||||
.RE
|
|
||||||
.SH Theming
|
|
||||||
.PP
|
|
||||||
To display the name of the current virtual enviroment in a prompt, define the
|
|
||||||
following style in the \fB\fCprompt_theme_setup\fR function.
|
|
||||||
.nf
|
|
||||||
# %v - virtualenv name.
|
|
||||||
zstyle ':prezto:module:python' virtualenv 'virtualenv:%v'
|
|
||||||
.fi
|
|
||||||
.PP
|
|
||||||
Then add \fB\fC$python_info[virtualenv]\fR to \fB\fC$PROMPT\fR or \fB\fC$RPROMPT\fR and call
|
|
||||||
\fB\fCpython-info\fR in the \fB\fCprompt_theme_preexec\fR hook function.
|
|
||||||
.SH Authors
|
|
||||||
.PP
|
|
||||||
\fIThe authors of this module should be contacted via the issue tracker
|
|
||||||
.UR https://github.com/sorin-ionescu/prezto/issues
|
|
||||||
.UE .\fP
|
|
||||||
.RS
|
|
||||||
.IP \(bu 2
|
|
||||||
Sorin Ionescu
|
|
||||||
.UR https://github.com/sorin-ionescu
|
|
||||||
.UE
|
|
||||||
.IP \(bu 2
|
|
||||||
Sebastian Wiesner
|
|
||||||
.UR https://github.com/lunaryorn
|
|
||||||
.UE
|
|
||||||
.RE
|
|
@ -1,56 +0,0 @@
|
|||||||
.TH Ruby on Rails
|
|
||||||
.PP
|
|
||||||
Defines Ruby on Rails
|
|
||||||
.UR http://rubyonrails.org
|
|
||||||
.UE
|
|
||||||
aliases.
|
|
||||||
.SH Aliases
|
|
||||||
.RS
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCror\fR is short for \fB\fCrails\fR.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCrorc\fR starts the Rails console.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCrordc\fR starts the Rails console connected to the database.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCrordm\fR migrates the database.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCrordM\fR migrates the database and recreates the test database.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCrordr\fR rolls the database schema back to the previous version.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCrorg\fR generates new code.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCrorl\fR displays the log.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCrorlc\fR truncates logs to zero bytes.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCrorp\fR installs a plugin.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCrorr\fR runs code in the application environment.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCrors\fR starts the Rails server.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCrorsd\fR starts the Rails server with the debugger.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCrorx\fR destroys newly generated code.
|
|
||||||
.RE
|
|
||||||
.SH Authors
|
|
||||||
.PP
|
|
||||||
\fIThe authors of this module should be contacted via the issue tracker
|
|
||||||
.UR https://github.com/sorin-ionescu/prezto/issues
|
|
||||||
.UE .\fP
|
|
||||||
.RS
|
|
||||||
.IP \(bu 2
|
|
||||||
Robby Russell
|
|
||||||
.UR https://github.com/robbyrussell
|
|
||||||
.UE
|
|
||||||
.IP \(bu 2
|
|
||||||
Jake Bell
|
|
||||||
.UR https://github.com/theunraveler
|
|
||||||
.UE
|
|
||||||
.IP \(bu 2
|
|
||||||
Sorin Ionescu
|
|
||||||
.UR https://github.com/sorin-ionescu
|
|
||||||
.UE
|
|
||||||
.RE
|
|
@ -1,34 +0,0 @@
|
|||||||
.TH Rsync
|
|
||||||
.PP
|
|
||||||
Defines rsync
|
|
||||||
.UR http://rsync.samba.org
|
|
||||||
.UE
|
|
||||||
aliases.
|
|
||||||
.PP
|
|
||||||
Mac OS X users are encouraged to use Bombich's rsync
|
|
||||||
.UR http://www.bombich.com/rsync.html
|
|
||||||
.UE , which has HFS+
|
|
||||||
enhancements.
|
|
||||||
.SH Aliases
|
|
||||||
.RS
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCrsync-copy\fR copies files and directories from \fIsource\fP to \fIdestination\fP.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCrsync-move\fR moves files and directories from \fIsource\fP to \fIdestination\fP.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCrsync-update\fR updates files and directories on \fIdestination\fP.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCrsync-synchronize\fR synchronizes files and directories between \fIsource\fP and
|
|
||||||
\fIdestination\fP.
|
|
||||||
.RE
|
|
||||||
.SH Authors
|
|
||||||
.PP
|
|
||||||
\fIThe authors of this module should be contacted via the issue tracker
|
|
||||||
.UR https://github.com/sorin-ionescu/prezto/issues
|
|
||||||
.UE .\fP
|
|
||||||
.RS
|
|
||||||
.IP \(bu 2
|
|
||||||
Sorin Ionescu
|
|
||||||
.UR https://github.com/sorin-ionescu
|
|
||||||
.UE
|
|
||||||
.RE
|
|
@ -1,97 +0,0 @@
|
|||||||
.TH Ruby
|
|
||||||
.PP
|
|
||||||
Configures Ruby
|
|
||||||
.UR http://www.ruby-lang.org
|
|
||||||
.UE
|
|
||||||
local gem installation, loads version managers, and defines
|
|
||||||
aliases.
|
|
||||||
.SH Local Gem Installation
|
|
||||||
.PP
|
|
||||||
When a Ruby version manager is not detected, local gems are installed in
|
|
||||||
\fI~/Library/Ruby/Gems/1.8\fP on Mac OS X.
|
|
||||||
.SH RVM
|
|
||||||
.PP
|
|
||||||
An alternative to the above is to use The Ruby Version Manager (RVM)
|
|
||||||
.UR https://rvm.io
|
|
||||||
.UE , which
|
|
||||||
allows for managing multiple, isolated Ruby installations and gem sets in the
|
|
||||||
home directory.
|
|
||||||
.PP
|
|
||||||
Since RVM is loaded into the shell and is known to override shell commands, it
|
|
||||||
may conflict with shell scripts.
|
|
||||||
.SH rbenv
|
|
||||||
.PP
|
|
||||||
An alternative RVM is to use rbenv
|
|
||||||
.UR https://github.com/sstephenson/rbenv
|
|
||||||
.UE , which allows for switching between multiple,
|
|
||||||
isolated Ruby installations in the home directory.
|
|
||||||
.PP
|
|
||||||
While it is not as feature rich as RVM, it is not loaded into the shell and is
|
|
||||||
not known to cause conflicts with shell scripts.
|
|
||||||
.SH Bundler
|
|
||||||
.PP
|
|
||||||
Manage gems that are not meant to be used as commands, such as application
|
|
||||||
dependencies, with Bundler
|
|
||||||
.UR http://gembundler.com
|
|
||||||
.UE .
|
|
||||||
.SH Aliases
|
|
||||||
.SS General
|
|
||||||
.RS
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCrb\fR is short for \fB\fCruby\fR.
|
|
||||||
.RE
|
|
||||||
.SS Bundler
|
|
||||||
.RS
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCrbb\fR manages ruby dependencies (\fB\fCbundle\fR).
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCrbbe\fR executes a script in the context of the current bundle.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCrbbi\fR installs the gems specified in the \fIGemfile\fP in \fIvendor/bundle\fP.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCrbbI\fR installs the following:
|
|
||||||
.RS
|
|
||||||
.IP \(bu 2
|
|
||||||
gems specified in the \fIGemfile\fP in \fIvendor/bundle\fP.
|
|
||||||
.IP \(bu 2
|
|
||||||
packages the gems into \fIvendor/cache\fP.
|
|
||||||
.IP \(bu 2
|
|
||||||
appends bundler directories to \fI.gitignore\fP.
|
|
||||||
.RE
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCrbbl\fR lists all gems in the current bundle.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCrbbo\fR opens an installed gem in the editor.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCrbbp\fR packages gem files into \fIvendor/cache\fP.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCrbbu\fR updates gems to their latest version.
|
|
||||||
.RE
|
|
||||||
.SH Functions
|
|
||||||
.RS
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCruby-info\fR exposes information about the Ruby environment via the
|
|
||||||
\fB\fC$ruby_info\fR associative array.
|
|
||||||
.RE
|
|
||||||
.SH Theming
|
|
||||||
.PP
|
|
||||||
To display the name of the current Ruby version in a prompt, define the
|
|
||||||
following style in the \fB\fCprompt_theme_setup\fR function.
|
|
||||||
.nf
|
|
||||||
# %v - ruby version.
|
|
||||||
zstyle ':prezto:module:ruby' version 'version:%v'
|
|
||||||
.fi
|
|
||||||
.PP
|
|
||||||
Then add \fB\fC$ruby_info[version]\fR to \fB\fC$PROMPT\fR or \fB\fC$RPROMPT\fR and call
|
|
||||||
\fB\fCruby-info\fR in the \fB\fCprompt_theme_preexec\fR hook function.
|
|
||||||
.SH Authors
|
|
||||||
.PP
|
|
||||||
\fIThe authors of this module should be contacted via the issue tracker
|
|
||||||
.UR https://github.com/sorin-ionescu/prezto/issues
|
|
||||||
.UE .\fP
|
|
||||||
.RS
|
|
||||||
.IP \(bu 2
|
|
||||||
Sorin Ionescu
|
|
||||||
.UR https://github.com/sorin-ionescu
|
|
||||||
.UE
|
|
||||||
.RE
|
|
@ -1,37 +0,0 @@
|
|||||||
.TH GNU Screen
|
|
||||||
.PP
|
|
||||||
Defines GNU Screen
|
|
||||||
.UR http://www.gnu.org/software/screen/
|
|
||||||
.UE
|
|
||||||
aliases and provides for auto launching it at start\-up.
|
|
||||||
.SH Settings
|
|
||||||
.SS Auto\-Start
|
|
||||||
.PP
|
|
||||||
Starts a GNU Screen session automatically when Zsh is launched.
|
|
||||||
.PP
|
|
||||||
To enable this feature, add the following line to \fIzpreztorc\fP:
|
|
||||||
.nf
|
|
||||||
zstyle ':prezto:module:screen' auto-start 'yes'
|
|
||||||
.fi
|
|
||||||
.SH Aliases
|
|
||||||
.RS
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCscr\fR is short for \fB\fCscreen\fR.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCscrl\fR lists sessions/socket directory.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCscrn\fR starts a new session.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCscrr\fR attaches to a session if one exists or start a new one.
|
|
||||||
.RE
|
|
||||||
.SH Authors
|
|
||||||
.PP
|
|
||||||
\fIThe authors of this module should be contacted via the issue tracker
|
|
||||||
.UR https://github.com/sorin-ionescu/prezto/issues
|
|
||||||
.UE .\fP
|
|
||||||
.RS
|
|
||||||
.IP \(bu 2
|
|
||||||
Sorin Ionescu
|
|
||||||
.UR https://github.com/sorin-ionescu
|
|
||||||
.UE
|
|
||||||
.RE
|
|
@ -1,145 +0,0 @@
|
|||||||
.TH Spectrum
|
|
||||||
.PP
|
|
||||||
Provides for easier use of 256 colors and effects.
|
|
||||||
.PP
|
|
||||||
To learn more about text formatting, read That 256 Color Thing
|
|
||||||
.UR http://lucentbeing.com/blog/that-256-color-thing/
|
|
||||||
.UE .
|
|
||||||
.SH Variables
|
|
||||||
.RS
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCBG\fR provides background colors.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCFG\fR provides foreground colors.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCFX\fR provides effects.
|
|
||||||
.RE
|
|
||||||
.SS Background and Foreground
|
|
||||||
.PP
|
|
||||||
Terminals support 8, 16, 88, and 256 colors. Check if a terminal supports 256
|
|
||||||
colors with \fB\fCtput colors\fR before use.
|
|
||||||
.PP
|
|
||||||
The following colors are supported.
|
|
||||||
.RS
|
|
||||||
.IP \(bu 2
|
|
||||||
0 to 255
|
|
||||||
.IP \(bu 2
|
|
||||||
black
|
|
||||||
.IP \(bu 2
|
|
||||||
red
|
|
||||||
.IP \(bu 2
|
|
||||||
green
|
|
||||||
.IP \(bu 2
|
|
||||||
yellow
|
|
||||||
.IP \(bu 2
|
|
||||||
blue
|
|
||||||
.IP \(bu 2
|
|
||||||
magenta
|
|
||||||
.IP \(bu 2
|
|
||||||
cyan
|
|
||||||
.IP \(bu 2
|
|
||||||
white
|
|
||||||
.RE
|
|
||||||
.SS Effects
|
|
||||||
.PP
|
|
||||||
Though there are many effects, most terminals support at least bold formatting.
|
|
||||||
.PP
|
|
||||||
\fBNot all effects work on all terminals; use them sparingly.\fP
|
|
||||||
.TS
|
|
||||||
allbox;
|
|
||||||
cb cb
|
|
||||||
l l
|
|
||||||
l l
|
|
||||||
l l
|
|
||||||
l l
|
|
||||||
l l
|
|
||||||
l l
|
|
||||||
l l
|
|
||||||
l l
|
|
||||||
l l
|
|
||||||
l l
|
|
||||||
l l
|
|
||||||
l l
|
|
||||||
l l
|
|
||||||
l l
|
|
||||||
l l
|
|
||||||
l l
|
|
||||||
l l
|
|
||||||
l l
|
|
||||||
l l
|
|
||||||
l l
|
|
||||||
l l
|
|
||||||
l l
|
|
||||||
l l
|
|
||||||
l l
|
|
||||||
l l
|
|
||||||
l l
|
|
||||||
l l
|
|
||||||
l l
|
|
||||||
l l
|
|
||||||
l l
|
|
||||||
l l
|
|
||||||
l l
|
|
||||||
l l
|
|
||||||
l l
|
|
||||||
l l
|
|
||||||
l l
|
|
||||||
l l
|
|
||||||
.
|
|
||||||
Enable Disable
|
|
||||||
none
|
|
||||||
normal
|
|
||||||
bold no\-bold
|
|
||||||
faint no\-faint
|
|
||||||
standout no\-standout
|
|
||||||
underline no\-underline
|
|
||||||
blink no\-blink
|
|
||||||
fast\-blink no\-fast\-blink
|
|
||||||
reverse no\-reverse
|
|
||||||
conceal no\-conceal
|
|
||||||
strikethrough no\-strikethrough
|
|
||||||
gothic no\-gothic
|
|
||||||
double\-underline no\-double\-underline
|
|
||||||
proportional no\-proportional
|
|
||||||
overline no\-overline
|
|
||||||
|
|
||||||
no\-border
|
|
||||||
border\-rectangle no\-border\-rectangle
|
|
||||||
border\-circle no\-border\-circle
|
|
||||||
|
|
||||||
no\-ideogram\-marking
|
|
||||||
underline\-or\-right no\-underline\-or\-right
|
|
||||||
double\-underline\-or\-right no\-double\-underline\-or\-right
|
|
||||||
overline\-or\-left no\-overline\-or\-left
|
|
||||||
double\-overline\-or\-left no\-double\-overline\-or\-left
|
|
||||||
stress no\-stress
|
|
||||||
|
|
||||||
font\-default
|
|
||||||
font\-first no\-font\-first
|
|
||||||
font\-second no\-font\-second
|
|
||||||
font\-third no\-font\-third
|
|
||||||
font\-fourth no\-font\-fourth
|
|
||||||
font\-fifth no\-font\-fifth
|
|
||||||
font\-sixth no\-font\-sixth
|
|
||||||
font\-seventh no\-font\-seventh
|
|
||||||
font\-eigth no\-font\-eigth
|
|
||||||
font\-ninth no\-font\-ninth
|
|
||||||
.TE
|
|
||||||
.SS Plain Text
|
|
||||||
.PP
|
|
||||||
Use \fB\fC$BG[none]\fR, \fB\fC$FG[none]\fR, or \fB\fC$FX[none]\fR to turn off formatting.
|
|
||||||
.SH Authors
|
|
||||||
.PP
|
|
||||||
\fIThe authors of this module should be contacted via the issue tracker
|
|
||||||
.UR https://github.com/sorin-ionescu/prezto/issues
|
|
||||||
.UE .\fP
|
|
||||||
.RS
|
|
||||||
.IP \(bu 2
|
|
||||||
P.C. Shyamshankar
|
|
||||||
.UR https://github.com/sykora
|
|
||||||
.UE
|
|
||||||
.IP \(bu 2
|
|
||||||
Sorin Ionescu
|
|
||||||
.UR https://github.com/sorin-ionescu
|
|
||||||
.UE
|
|
||||||
.RE
|
|
@ -1,53 +0,0 @@
|
|||||||
.TH SSH\-Agent
|
|
||||||
.PP
|
|
||||||
Provides for an easier use of ssh\-agent
|
|
||||||
.UR http://www.openbsd.org/cgi-bin/man.cgi?query=ssh-agent&sektion=1
|
|
||||||
.UE .
|
|
||||||
.SH Settings
|
|
||||||
.SS Agent Forwarding
|
|
||||||
.PP
|
|
||||||
To enable ssh\-agent forwarding, add the following line to \fIzpreztorc\fP:
|
|
||||||
.nf
|
|
||||||
zstyle ':prezto:module:ssh-agent' forwarding 'yes'
|
|
||||||
.fi
|
|
||||||
.SS Identities
|
|
||||||
.PP
|
|
||||||
To load multiple identities, add the following line to \fIzpreztorc\fP:
|
|
||||||
.nf
|
|
||||||
zstyle ':prezto:module:ssh-agent' identities 'id_rsa' 'id_rsa2' 'id_github'
|
|
||||||
.fi
|
|
||||||
.SH Authors
|
|
||||||
.PP
|
|
||||||
\fIThe authors of this module should be contacted via the issue tracker
|
|
||||||
.UR https://github.com/sorin-ionescu/prezto/issues
|
|
||||||
.UE .\fP
|
|
||||||
.RS
|
|
||||||
.IP \(bu 2
|
|
||||||
Robby Russell
|
|
||||||
.UR https://github.com/robbyrussell
|
|
||||||
.UE
|
|
||||||
.IP \(bu 2
|
|
||||||
Theodore Robert Campbell Jr
|
|
||||||
.UR https://github.com/trcjr
|
|
||||||
.UE
|
|
||||||
.IP \(bu 2
|
|
||||||
Joseph M. Reagle Jr.
|
|
||||||
.UR https://github.com/reagle
|
|
||||||
.UE
|
|
||||||
.IP \(bu 2
|
|
||||||
Florent Thoumie
|
|
||||||
.UR https://github.com/flz
|
|
||||||
.UE
|
|
||||||
.IP \(bu 2
|
|
||||||
Jonas Pfenniger
|
|
||||||
.UR https://github.com/zimbatm
|
|
||||||
.UE
|
|
||||||
.IP \(bu 2
|
|
||||||
Gareth Owen
|
|
||||||
.UR https://github.com/gwjo
|
|
||||||
.UE
|
|
||||||
.IP \(bu 2
|
|
||||||
Sorin Ionescu
|
|
||||||
.UR https://github.com/sorin-ionescu
|
|
||||||
.UE
|
|
||||||
.RE
|
|
@ -1,53 +0,0 @@
|
|||||||
.TH Syntax Highlighting
|
|
||||||
.PP
|
|
||||||
Integrates zsh\-syntax\-highlighting
|
|
||||||
.UR https://github.com/zsh-users/zsh-syntax-highlighting
|
|
||||||
.UE
|
|
||||||
into Prezto.
|
|
||||||
.PP
|
|
||||||
This module should be loaded \fIsecond to last\fP, where last is the \fIprompt\fP
|
|
||||||
module, unless used in conjuncture with the \fIhistory\-substring\-search\fP module
|
|
||||||
where it must be loaded \fBbefore\fP it.
|
|
||||||
.SH Contributors
|
|
||||||
.PP
|
|
||||||
New features and bug fixes should be submitted to the
|
|
||||||
zsh\-syntax\-highlighting
|
|
||||||
.UR https://github.com/zsh-users/zsh-syntax-highlighting
|
|
||||||
.UE
|
|
||||||
project according to its rules and regulations.
|
|
||||||
This module will be synchronized against it.
|
|
||||||
.SH Settings
|
|
||||||
.SS Highlighting
|
|
||||||
.PP
|
|
||||||
To enable highlighting for this module only, add the following line to
|
|
||||||
\fIzpreztorc\fP:
|
|
||||||
.nf
|
|
||||||
zstyle ':prezto:module:syntax-highlighting' color 'yes'
|
|
||||||
.fi
|
|
||||||
.SS Highlighters
|
|
||||||
.PP
|
|
||||||
Syntax highlighting is accomplished by pluggable highlighters
|
|
||||||
.UR https://github.com/zsh-users/zsh-syntax-highlighting/tree/master/highlighters
|
|
||||||
.UE . This module
|
|
||||||
enables the \fImain\fP, \fIbrackets\fP, and \fIcursor\fP highlighters by default.
|
|
||||||
.PP
|
|
||||||
To enable all highlighters, add the following to \fIzpreztorc\fP:
|
|
||||||
.nf
|
|
||||||
zstyle ':prezto:module:syntax-highlighting' highlighters \
|
|
||||||
'main' \
|
|
||||||
'brackets' \
|
|
||||||
'pattern' \
|
|
||||||
'cursor' \
|
|
||||||
'root'
|
|
||||||
.fi
|
|
||||||
.SH Authors
|
|
||||||
.PP
|
|
||||||
\fIThe authors of this module should be contacted via the issue tracker
|
|
||||||
.UR https://github.com/sorin-ionescu/prezto/issues
|
|
||||||
.UE .\fP
|
|
||||||
.RS
|
|
||||||
.IP \(bu 2
|
|
||||||
Sorin Ionescu
|
|
||||||
.UR https://github.com/sorin-ionescu
|
|
||||||
.UE
|
|
||||||
.RE
|
|
@ -1,26 +0,0 @@
|
|||||||
.TH Terminal
|
|
||||||
.PP
|
|
||||||
Sets terminal window and tab titles.
|
|
||||||
.SH Settings
|
|
||||||
.SS Auto\-Title
|
|
||||||
.PP
|
|
||||||
To auto set the terminal window and tab titles with the current command or
|
|
||||||
directory, add the following to \fIzpreztorc\fP:
|
|
||||||
.nf
|
|
||||||
zstyle ':prezto:module:terminal' auto-title 'yes'
|
|
||||||
.fi
|
|
||||||
.SH Authors
|
|
||||||
.PP
|
|
||||||
\fIThe authors of this module should be contacted via the issue tracker
|
|
||||||
.UR https://github.com/sorin-ionescu/prezto/issues
|
|
||||||
.UE .\fP
|
|
||||||
.RS
|
|
||||||
.IP \(bu 2
|
|
||||||
James Cox
|
|
||||||
.UR https://github.com/imajes
|
|
||||||
.UE
|
|
||||||
.IP \(bu 2
|
|
||||||
Sorin Ionescu
|
|
||||||
.UR https://github.com/sorin-ionescu
|
|
||||||
.UE
|
|
||||||
.RE
|
|
@ -1,61 +0,0 @@
|
|||||||
.TH Tmux
|
|
||||||
.PP
|
|
||||||
Defines tmux
|
|
||||||
.UR http://tmux.sourceforge.net
|
|
||||||
.UE
|
|
||||||
aliases and provides for auto launching it at start\-up.
|
|
||||||
.SH Settings
|
|
||||||
.SS Auto\-Start
|
|
||||||
.PP
|
|
||||||
Starts a tmux session automatically when Zsh is launched.
|
|
||||||
.PP
|
|
||||||
To enable this feature, add the following line to \fIzpreztorc\fP:
|
|
||||||
.nf
|
|
||||||
zstyle ':prezto:module:tmux' auto-start 'yes'
|
|
||||||
.fi
|
|
||||||
.PP
|
|
||||||
It will create a background session named \fI#Prezto\fP and attach every new shell
|
|
||||||
to it.
|
|
||||||
.PP
|
|
||||||
To avoid keeping open sessions, this module sets \fB\fCdestroy-unattached off\fR on
|
|
||||||
the background session and \fB\fCdestroy-unattached on\fR on every other session
|
|
||||||
(global setting).
|
|
||||||
.SH Aliases
|
|
||||||
.RS
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCtmuxa\fR attaches or switches to a tmux session.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCtmuxl\fR lists sessions managed by the tmux server.
|
|
||||||
.RE
|
|
||||||
.SH Caveats
|
|
||||||
.PP
|
|
||||||
On Mac OS X, launching tmux can cause the error \fBlaunch_msg(...): Socket is not
|
|
||||||
connected\fP to be displayed, which can be fixed by installing
|
|
||||||
reattach\-to\-user\-namespace
|
|
||||||
.UR ChrisJohnsen/tmux-MacOSX-pasteboard
|
|
||||||
.UE , available in Homebrew
|
|
||||||
.UR mxcl/homebrew
|
|
||||||
.UE , and adding the
|
|
||||||
following to \fItmux.conf\fP:
|
|
||||||
.PP
|
|
||||||
set\-option \-g default\-command "reattach\-to\-user\-namespace \-l $SHELL \-l"
|
|
||||||
.PP
|
|
||||||
Furthermore, tmux is known to cause \fBkernel panics\fP on Mac OS X. A discussion
|
|
||||||
about this and Prezto has already been opened
|
|
||||||
.UR http://git.io/jkPqHg
|
|
||||||
.UE .
|
|
||||||
.SH Authors
|
|
||||||
.PP
|
|
||||||
\fIThe authors of this module should be contacted via the issue tracker
|
|
||||||
.UR https://github.com/sorin-ionescu/prezto/issues
|
|
||||||
.UE .\fP
|
|
||||||
.RS
|
|
||||||
.IP \(bu 2
|
|
||||||
Sorin Ionescu
|
|
||||||
.UR https://github.com/sorin-ionescu
|
|
||||||
.UE
|
|
||||||
.IP \(bu 2
|
|
||||||
Colin Hebert
|
|
||||||
.UR https://github.com/ColinHebert
|
|
||||||
.UE
|
|
||||||
.RE
|
|
@ -1,233 +0,0 @@
|
|||||||
.TH Utility
|
|
||||||
.PP
|
|
||||||
Defines general aliases and functions.
|
|
||||||
.SH Settings
|
|
||||||
.SS Highlighting
|
|
||||||
.PP
|
|
||||||
If you have enabled color globally in \fIzpreztorc\fP, you may disable it for certain
|
|
||||||
commands.
|
|
||||||
.PP
|
|
||||||
To disable \fB\fCls\fR color, add the following line to \fIzpreztorc\fP; when coloring is
|
|
||||||
disabled, type indicators (*, /, =>, @, =, |, %) will be appended to entries.
|
|
||||||
.nf
|
|
||||||
zstyle ':prezto:module:utility:ls' color 'no'
|
|
||||||
.fi
|
|
||||||
.PP
|
|
||||||
To disable \fB\fCdiff\fR highlighting, add the following line to \fIzpreztorc\fP:
|
|
||||||
.nf
|
|
||||||
zstyle ':prezto:module:utility:diff' color 'no'
|
|
||||||
.fi
|
|
||||||
.PP
|
|
||||||
To disable \fB\fCwdiff\fR highlighting, add the following line to \fIzpreztorc\fP:
|
|
||||||
.nf
|
|
||||||
zstyle ':prezto:module:utility:wdiff' color 'no'
|
|
||||||
.fi
|
|
||||||
.PP
|
|
||||||
To disable \fB\fCmake\fR highlighting, add the following line to \fIzpreztorc\fP:
|
|
||||||
.nf
|
|
||||||
zstyle ':prezto:module:utility:make' color 'no'
|
|
||||||
.fi
|
|
||||||
.SH Aliases
|
|
||||||
.SS Disabled Spelling Correction
|
|
||||||
.RS
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCack\fR
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCcd\fR
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCcp\fR
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCebuild\fR
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCgcc\fR
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCgist\fR
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCgrep\fR
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCheroku\fR
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCln\fR
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCman\fR
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCmkdir\fR
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCmv\fR
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCmysql\fR
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCrm\fR
|
|
||||||
.RE
|
|
||||||
.SS Disabled File Globbing
|
|
||||||
.RS
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCfc\fR
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCfind\fR
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCftp\fR
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fChistory\fR
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fClocate\fR
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCrake\fR
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCrsync\fR
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCscp\fR
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCsftp\fR
|
|
||||||
.RE
|
|
||||||
.SS General
|
|
||||||
.RS
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fC_\fR executes a command as another user (\fB\fCsudo\fR).
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCb\fR opens the default web browser.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCcp\fR copies files and directories interactively.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCe\fR opens the default editor.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCln\fR links files and directories interactively.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCmkdir\fR creates directories, including intermediary directories.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCmv\fR moves files and directories interactively.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCp\fR opens the default pager.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCpo\fR removes a directory from the stack and changes to it (\fB\fCpopd\fR).
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCpu\fR changes the directory and pushes the old directory onto the stack
|
|
||||||
(\fB\fCpushd\fR).
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCrm\fR removes files and directories interactively.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCtype\fR displays all the attribute values of a shell parameter.
|
|
||||||
.RE
|
|
||||||
.SS Files and Directories
|
|
||||||
.RS
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCls\fR lists with directories grouped first (GNU only).
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCl\fR lists in one column, hidden files.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCll\fR lists human readable sizes.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fClr\fR lists human readable sizes, recursively.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCla\fR lists human readable sizes, hidden files.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fClm\fR lists human readable sizes, hidden files through pager.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fClx\fR lists sorted by extension (GNU only).
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fClk\fR lists sorted by size, largest last.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fClt\fR lists sorted by date, most recent last.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fClc\fR lists sorted by date, most recent last, shows change time.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fClu\fR lists sorted by date, most recent last, shows access time.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCsl\fR lists directory contents (\fB\fCls\fR).
|
|
||||||
.RE
|
|
||||||
.SS Mac OS X Everywhere
|
|
||||||
.RS
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCo\fR opens files and directories (\fB\fCopen\fR or \fB\fCxdg-open\fR).
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCget\fR downloads files (\fB\fCcurl\fR or \fB\fCwget\fR).
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCpbcopy\fR copies to the pasteboard (\fB\fCpbcopy\fR, \fB\fCxclip\fR or \fB\fCxsel\fR).
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCpbpaste\fR pastes from the pasteboard (\fB\fCpbcopy\fR, \fB\fCxclip\fR or \fB\fCxsel\fR).
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCpbc\fR copies to the pasteboard (\fB\fCpbcopy\fR).
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCpbp\fR pastes from the pasteboard (\fB\fCpbpaste\fR).
|
|
||||||
.RE
|
|
||||||
.SS Resource Usage
|
|
||||||
.RS
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCdf\fR displays free disk space using human readable units.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCdu\fR displays disk usage using human readable units.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCtop\fR displays information about processes (aliased to \fB\fChtop\fR, if installed).
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCtopc\fR displays information about processes sorted by CPU usage (\fB\fChtop\fR not
|
|
||||||
installed).
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCtopm\fR displays information about processes sorted by RAM usage (\fB\fChtop\fR not
|
|
||||||
installed).
|
|
||||||
.RE
|
|
||||||
.SS Miscellaneous
|
|
||||||
.RS
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fChttp-serve\fR serves a directory via HTTP.
|
|
||||||
.RE
|
|
||||||
.SH Functions
|
|
||||||
.SS General
|
|
||||||
.RS
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCslit\fR prints columns \fI1, 2, 3 ... n\fP.
|
|
||||||
.RE
|
|
||||||
.SS Files and Directories
|
|
||||||
.RS
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCcdls\fR changes to a directory and lists its contents.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCdut\fR displays the grand total disk usage using human readable units.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCfind-exec\fR finds files and executes a command on them.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCmkdcd\fR makes a directory and changes to it.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCpopdls\fR pops an entry off the directory stack and lists its contents.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCpushdls\fR pushes an entry onto the directory stack and lists its contents.
|
|
||||||
.RE
|
|
||||||
.SS Developer
|
|
||||||
.RS
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCdiff\fR highlights diff output (requires \fB\fCcolordiff\fR or \fB\fCGit\fR).
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCmake\fR highlights make output (requires \fB\fCcolormake\fR).
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCwdiff\fR highlights wdiff output (requires \fB\fCwdiff\fRor \fB\fCGit\fR).
|
|
||||||
.RE
|
|
||||||
.SS Resource usage
|
|
||||||
.RS
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCpsu\fR displays user owned processes status.
|
|
||||||
.RE
|
|
||||||
.SS Search and Replace
|
|
||||||
.RS
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCprep\fR provides a grep\-like pattern search.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCpsub\fR provides a sed\-like pattern substitution.
|
|
||||||
.RE
|
|
||||||
.SH Authors
|
|
||||||
.PP
|
|
||||||
\fIThe authors of this module should be contacted via the issue tracker
|
|
||||||
.UR https://github.com/sorin-ionescu/prezto/issues
|
|
||||||
.UE .\fP
|
|
||||||
.RS
|
|
||||||
.IP \(bu 2
|
|
||||||
Robby Russell
|
|
||||||
.UR https://github.com/robbyrussell
|
|
||||||
.UE
|
|
||||||
.IP \(bu 2
|
|
||||||
Suraj N. Kurapati
|
|
||||||
.UR https://github.com/sunaku
|
|
||||||
.UE
|
|
||||||
.IP \(bu 2
|
|
||||||
Sorin Ionescu
|
|
||||||
.UR https://github.com/sorin-ionescu
|
|
||||||
.UE
|
|
||||||
.RE
|
|
@ -1,43 +0,0 @@
|
|||||||
.TH Wake\-on\-LAN
|
|
||||||
.PP
|
|
||||||
This module provides a wrapper around the wakeonlan
|
|
||||||
.UR http://gsd.di.uminho.pt/jpo/software/wakeonlan/
|
|
||||||
.UE
|
|
||||||
tool.
|
|
||||||
.SH Usage
|
|
||||||
.PP
|
|
||||||
To use this wrapper, create the \fI~/.wakeonlan\fP directory, and place in it one
|
|
||||||
file for each device you would like to be able to wake. Give the file a name
|
|
||||||
that describes the device, such as its hostname.
|
|
||||||
.PP
|
|
||||||
Each file should contain a line with the MAC address of the target device and
|
|
||||||
the network broadcast address. For instance, there might be a file
|
|
||||||
\fI~/.wakeonlan/leto\fP with the following contents:
|
|
||||||
.nf
|
|
||||||
00:11:22:33:44:55:66 192.168.0.255
|
|
||||||
.fi
|
|
||||||
.PP
|
|
||||||
To wake that device, use the following command:
|
|
||||||
.nf
|
|
||||||
wake leto
|
|
||||||
.fi
|
|
||||||
.PP
|
|
||||||
For more information on the configuration file format, read the
|
|
||||||
wakeonlan man page
|
|
||||||
.UR http://man.cx/wakeonlan
|
|
||||||
.UE .
|
|
||||||
.SH Authors
|
|
||||||
.PP
|
|
||||||
\fIThe authors of this module should be contacted via issue tracker
|
|
||||||
.UR https://github.com/sorin-ionescu/prezto/issues
|
|
||||||
.UE .\fP
|
|
||||||
.RS
|
|
||||||
.IP \(bu 2
|
|
||||||
Paul Dann
|
|
||||||
.UR https://github.com/giddie
|
|
||||||
.UE
|
|
||||||
.IP \(bu 2
|
|
||||||
Sorin Ionescu
|
|
||||||
.UR https://github.com/sorin-ionescu
|
|
||||||
.UE
|
|
||||||
.RE
|
|
@ -1,40 +0,0 @@
|
|||||||
.TH Yum
|
|
||||||
.PP
|
|
||||||
Defines yum
|
|
||||||
.UR http://yum.baseurl.org
|
|
||||||
.UE
|
|
||||||
aliases.
|
|
||||||
.SH Aliases
|
|
||||||
.RS
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCyumc\fR removes package(s) and leaves.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCyumi\fR installs package(s).
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCyumh\fR displays history.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCyuml\fR lists packages.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCyumL\fR lists installed packages.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCyumq\fR displays package information.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCyumr\fR removes package(s).
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCyums\fR searches for a package.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCyumu\fR updates packages.
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCyumU\fR upgrates packages.
|
|
||||||
.RE
|
|
||||||
.SH Authors
|
|
||||||
.PP
|
|
||||||
\fIThe authors of this module should be contacted via the issue tracker
|
|
||||||
.UR https://github.com/sorin-ionescu/prezto/issues
|
|
||||||
.UE .\fP
|
|
||||||
.RS
|
|
||||||
.IP \(bu 2
|
|
||||||
Sorin Ionescu
|
|
||||||
.UR https://github.com/sorin-ionescu
|
|
||||||
.UE
|
|
||||||
.RE
|
|
@ -1,23 +0,0 @@
|
|||||||
.TH Z
|
|
||||||
.PP
|
|
||||||
Integrates z
|
|
||||||
.UR https://github.com/rupa/z
|
|
||||||
.UE
|
|
||||||
into Prezto, which maintains a frequently used directory
|
|
||||||
list for fast directory changes.
|
|
||||||
.SH Aliases
|
|
||||||
.RS
|
|
||||||
.IP \(bu 2
|
|
||||||
\fB\fCj\fR changes the current working directory to the most \fIfrecent\fP match.
|
|
||||||
.RE
|
|
||||||
.SH Authors
|
|
||||||
.PP
|
|
||||||
\fIThe authors of this module should be contacted via the issue tracker
|
|
||||||
.UR https://github.com/sorin-ionescu/prezto/issues
|
|
||||||
.UE .\fP
|
|
||||||
.RS
|
|
||||||
.IP \(bu 2
|
|
||||||
Sorin Ionescu
|
|
||||||
.UR https://github.com/sorin-ionescu
|
|
||||||
.UE
|
|
||||||
.RE
|
|
@ -1,199 +0,0 @@
|
|||||||
.TH Prezto — Instantly Awesome Zsh
|
|
||||||
.PP
|
|
||||||
Prezto is the configuration framework for Zsh
|
|
||||||
.UR http://www.zsh.org
|
|
||||||
.UE ; it enriches the command line
|
|
||||||
interface environment with sane defaults, aliases, functions, auto completion,
|
|
||||||
and prompt themes.
|
|
||||||
.SH Installation
|
|
||||||
.PP
|
|
||||||
Prezto will work with any recent release of Zsh, but the minimum recommended
|
|
||||||
version is 4.3.10.
|
|
||||||
.nr step0 0 1
|
|
||||||
.RS
|
|
||||||
.IP \n+[step0]
|
|
||||||
Launch Zsh:
|
|
||||||
.nf
|
|
||||||
zsh
|
|
||||||
.fi
|
|
||||||
.IP \n+[step0]
|
|
||||||
Clone the repository:
|
|
||||||
.nf
|
|
||||||
git clone --recursive https://github.com/sorin-ionescu/prezto.git "${ZDOTDIR:-$HOME}/.zprezto"
|
|
||||||
.fi
|
|
||||||
.IP \n+[step0]
|
|
||||||
Create a new Zsh configuration by copying the Zsh configuration files
|
|
||||||
provided:
|
|
||||||
.nf
|
|
||||||
setopt EXTENDED_GLOB
|
|
||||||
for rcfile in "${ZDOTDIR:-$HOME}"/.zprezto/runcoms/^README.md(.N); do
|
|
||||||
ln -s "$rcfile" "${ZDOTDIR:-$HOME}/.${rcfile:t}"
|
|
||||||
done
|
|
||||||
.fi
|
|
||||||
.IP \n+[step0]
|
|
||||||
Set Zsh as your default shell:
|
|
||||||
.nf
|
|
||||||
chsh -s /bin/zsh
|
|
||||||
.fi
|
|
||||||
.IP \n+[step0]
|
|
||||||
Open a new Zsh terminal window or tab.
|
|
||||||
.RE
|
|
||||||
.SS Mac OS X
|
|
||||||
.PP
|
|
||||||
If you have administrator privileges, you must fix an Apple\-introduced problem
|
|
||||||
in Mac OS X 10.5 Leopard by executing the following command, or BASH and Zsh
|
|
||||||
will have the wrong \fB\fCPATH\fR when executed non\-interactively.
|
|
||||||
.nf
|
|
||||||
sudo chmod ugo-x /usr/libexec/path_helper
|
|
||||||
.fi
|
|
||||||
.PP
|
|
||||||
\fB\fCpath_helper\fR is intended to make it easier for installers to add new paths to
|
|
||||||
the environment without having to edit shell configuration files by adding
|
|
||||||
a file with a path to the \fI/etc/paths.d\fP directory.
|
|
||||||
.PP
|
|
||||||
Unfortunately, \fB\fCpath_helper\fR always reads paths from \fI/etc/paths\fP set by Apple
|
|
||||||
then paths from \fI/etc/paths.d\fP set by third party installers, and lastly paths
|
|
||||||
from the \fB\fCPATH\fR environment variable set by the parent process, which
|
|
||||||
ultimately is set by the user with \fB\fCexport PATH=...\fR Thus, it reorders path
|
|
||||||
priorities, and user \fI/bin\fP directories meant to override system \fI/bin\fP
|
|
||||||
directories end up at the tail of the array.
|
|
||||||
.SS Troubleshooting
|
|
||||||
.PP
|
|
||||||
If you are not able to find certain commands after switching to \fIPrezto\fP,
|
|
||||||
modify the \fB\fCPATH\fR variable in \fI~/.zshenv\fP then open a new Zsh terminal
|
|
||||||
window or tab.
|
|
||||||
.SH Usage
|
|
||||||
.PP
|
|
||||||
Prezto has many features disabled by default. Read the source code and
|
|
||||||
accompanying README files to learn of what is available.
|
|
||||||
.SS Modules
|
|
||||||
.nr step1 0 1
|
|
||||||
.RS
|
|
||||||
.IP \n+[step1]
|
|
||||||
Browse \fI/modules\fP to see what is available.
|
|
||||||
.IP \n+[step1]
|
|
||||||
Load the modules you need in \fI~/.zpreztorc\fP then open a new Zsh terminal
|
|
||||||
window or tab.
|
|
||||||
.RE
|
|
||||||
.SS Themes
|
|
||||||
.nr step2 0 1
|
|
||||||
.RS
|
|
||||||
.IP \n+[step2]
|
|
||||||
For a list of themes, type \fB\fCprompt -l\fR.
|
|
||||||
.IP \n+[step2]
|
|
||||||
To preview a theme, type \fB\fCprompt -p name\fR.
|
|
||||||
.IP \n+[step2]
|
|
||||||
Load the theme you like in \fI~/.zpreztorc\fP then open a new Zsh terminal
|
|
||||||
window or tab.
|
|
||||||
.PP
|
|
||||||
[sorin theme]2
|
|
||||||
.UR http://i.imgur.com/ij8Lv.png
|
|
||||||
.UE
|
|
||||||
.RE
|
|
||||||
.SH Customization
|
|
||||||
.PP
|
|
||||||
The project is managed via Git
|
|
||||||
.UR http://git-scm.com
|
|
||||||
.UE . It is highly recommend that you commit
|
|
||||||
your changes and push them to GitHub
|
|
||||||
.UR https://github.com
|
|
||||||
.UE
|
|
||||||
to not lose them. If you do not know
|
|
||||||
how to use Git, follow this tutorial
|
|
||||||
.UR http://gitimmersion.com
|
|
||||||
.UE
|
|
||||||
and bookmark this reference
|
|
||||||
.UR http://gitref.org
|
|
||||||
.UE .
|
|
||||||
.SH Resources
|
|
||||||
.PP
|
|
||||||
The Zsh Reference Card
|
|
||||||
.UR http://www.bash2zsh.com/zsh_refcard/refcard.pdf
|
|
||||||
.UE
|
|
||||||
and the zsh\-lovers
|
|
||||||
.UR http://grml.org/zsh/zsh-lovers.html
|
|
||||||
.UE
|
|
||||||
man page are indispensable.
|
|
||||||
.SH Contribute
|
|
||||||
.PP
|
|
||||||
This project would not exist without all of its users and contributors
|
|
||||||
.UR https://github.com/sorin-ionescu/prezto/contributors
|
|
||||||
.UE .
|
|
||||||
.PP
|
|
||||||
If you have ideas on how to make the configuration easier to maintain or
|
|
||||||
improve its performance, do not hesitate to fork and send pull requests.
|
|
||||||
.SS Issue Reporting
|
|
||||||
.RS
|
|
||||||
.IP \(bu 2
|
|
||||||
Check that the issue has not already been reported.
|
|
||||||
.IP \(bu 2
|
|
||||||
Check that the issue has not already been fixed in the latest code.
|
|
||||||
.IP \(bu 2
|
|
||||||
Open an issue with a clear title and description in grammatically correct,
|
|
||||||
complete sentences.
|
|
||||||
.RE
|
|
||||||
.SS Pull Request
|
|
||||||
.RS
|
|
||||||
.IP \(bu 2
|
|
||||||
Read how to properly contribute to open source projects on GitHub
|
|
||||||
.UR http://gun.io/blog/how-to-github-fork-branch-and-pull-request
|
|
||||||
.UE .
|
|
||||||
.IP \(bu 2
|
|
||||||
Use a topic branch to easily amend a pull request later, if necessary.
|
|
||||||
.IP \(bu 2
|
|
||||||
Write good commit messages
|
|
||||||
.UR http://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html
|
|
||||||
.UE .
|
|
||||||
.IP \(bu 2
|
|
||||||
Squash commits on the topic branch before opening a pull request.
|
|
||||||
.IP \(bu 2
|
|
||||||
Use the same coding style and spacing.
|
|
||||||
.IP \(bu 2
|
|
||||||
Open a pull request
|
|
||||||
.UR https://help.github.com/articles/using-pull-requests
|
|
||||||
.UE
|
|
||||||
that relates to but one subject with a clear
|
|
||||||
title and description in grammatically correct, complete sentences.
|
|
||||||
.RE
|
|
||||||
.SS Modules
|
|
||||||
.RS
|
|
||||||
.IP \(bu 2
|
|
||||||
A \fIREADME.md\fP must be present.
|
|
||||||
.IP \(bu 2
|
|
||||||
Large functions must be placed in a \fIfunctions\fP directory.
|
|
||||||
.IP \(bu 2
|
|
||||||
Functions that take arguments must have completion.
|
|
||||||
.RE
|
|
||||||
.SS Themes
|
|
||||||
.RS
|
|
||||||
.IP \(bu 2
|
|
||||||
A screenshots section must be present in the file header.
|
|
||||||
.IP \(bu 2
|
|
||||||
The pull request description must have embedded
|
|
||||||
screenshots
|
|
||||||
.UR http://daringfireball.net/projects/markdown/syntax#img
|
|
||||||
.UE .
|
|
||||||
.RE
|
|
||||||
.SH License
|
|
||||||
.PP
|
|
||||||
(The MIT License)
|
|
||||||
.PP
|
|
||||||
Copyright (c) 2009\-2012 Robby Russell, Sorin Ionescu, and contributors.
|
|
||||||
.PP
|
|
||||||
Permission is hereby granted, free of charge, to any person obtaining a copy of
|
|
||||||
this software and associated documentation files (the "Software"), to deal in
|
|
||||||
the Software without restriction, including without limitation the rights to
|
|
||||||
use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
|
|
||||||
of the Software, and to permit persons to whom the Software is furnished to do
|
|
||||||
so, subject to the following conditions:
|
|
||||||
.PP
|
|
||||||
The above copyright notice and this permission notice shall be included in all
|
|
||||||
copies or substantial portions of the Software.
|
|
||||||
.PP
|
|
||||||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
||||||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
||||||
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
||||||
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
||||||
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
||||||
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
||||||
SOFTWARE.
|
|
@ -1,41 +0,0 @@
|
|||||||
Archive
|
|
||||||
=======
|
|
||||||
|
|
||||||
Provides functions to list and extract archives.
|
|
||||||
|
|
||||||
Functions
|
|
||||||
---------
|
|
||||||
|
|
||||||
- `lsarchive` lists the contents of one or more archives.
|
|
||||||
- `unarchive` extracts the contents of one or more archives.
|
|
||||||
|
|
||||||
Supported Formats
|
|
||||||
-----------------
|
|
||||||
|
|
||||||
The following archive formats are supported when the required utilities are
|
|
||||||
installed:
|
|
||||||
|
|
||||||
- *.tar.gz*, *.tgz* require `tar`.
|
|
||||||
- *.tar.bz2*, *.tbz* require `tar`.
|
|
||||||
- *.tar.xz*, *.txz* require `tar` with *xz* support.
|
|
||||||
- *.tar.zma*, *.tlz* require `tar` with *lzma* support.
|
|
||||||
- *.tar* requires `tar`.
|
|
||||||
- *.gz* requires `gunzip`.
|
|
||||||
- *.bz2* requires `bunzip2`.
|
|
||||||
- *.xz* requires `unxz`.
|
|
||||||
- *.lzma* requires `unlzma`.
|
|
||||||
- *.Z* requires `uncompress`.
|
|
||||||
- *.zip* requires `unzip`.
|
|
||||||
- *.rar* requires `unrar` or `rar`.
|
|
||||||
- *.7z* requires `7za`.
|
|
||||||
- *.deb* requires `ar`, `tar`.
|
|
||||||
|
|
||||||
Authors
|
|
||||||
-------
|
|
||||||
|
|
||||||
*The authors of this module should be contacted via the [issue tracker][1].*
|
|
||||||
|
|
||||||
- [Sorin Ionescu](https://github.com/sorin-ionescu)
|
|
||||||
|
|
||||||
[1]: https://github.com/sorin-ionescu/prezto/issues
|
|
||||||
|
|
@ -1,16 +0,0 @@
|
|||||||
Command-Not-Found
|
|
||||||
=================
|
|
||||||
|
|
||||||
Displays installation information for not found commands by loading the
|
|
||||||
[command-not-found][1] tool on Debian-based and Arch Linux-based distributions.
|
|
||||||
|
|
||||||
Authors
|
|
||||||
-------
|
|
||||||
|
|
||||||
*The authors of this module should be contacted via the [issue tracker][2].*
|
|
||||||
|
|
||||||
- [Joseph Booker](https://github.com/sargas)
|
|
||||||
|
|
||||||
[1]: https://code.launchpad.net/command-not-found
|
|
||||||
[2]: https://github.com/sorin-ionescu/prezto/issues
|
|
||||||
|
|
@ -1,24 +0,0 @@
|
|||||||
Completion
|
|
||||||
==========
|
|
||||||
|
|
||||||
Loads and configures tab completion and provides additional completions from
|
|
||||||
the [zsh-completions][1] project.
|
|
||||||
|
|
||||||
This module must be loaded **after** the *utility* module.
|
|
||||||
|
|
||||||
Contributors
|
|
||||||
------------
|
|
||||||
|
|
||||||
Completions should be submitted to the [zsh-completions][1] project according
|
|
||||||
to its rules and regulations. This module will be synchronized against it.
|
|
||||||
|
|
||||||
Authors
|
|
||||||
-------
|
|
||||||
|
|
||||||
*The authors of this module should be contacted via the [issue tracker][2].*
|
|
||||||
|
|
||||||
- [Sorin Ionescu](https://github.com/sorin-ionescu)
|
|
||||||
|
|
||||||
[1]: https://github.com/zsh-users/zsh-completions
|
|
||||||
[2]: https://github.com/sorin-ionescu/prezto/issues
|
|
||||||
|
|
@ -1,36 +0,0 @@
|
|||||||
Directory
|
|
||||||
=========
|
|
||||||
|
|
||||||
Sets directory options and defines directory aliases.
|
|
||||||
|
|
||||||
Options
|
|
||||||
-------
|
|
||||||
|
|
||||||
- `AUTO_CD` auto changes to a directory without typing `cd`.
|
|
||||||
- `AUTO_PUSHD` pushes the old directory onto the stack on `cd`.
|
|
||||||
- `PUSHD_IGNORE_DUPS` does not store duplicates in the stack.
|
|
||||||
- `PUSHD_SILENT` does not print the directory stack after `pushd` or `popd`.
|
|
||||||
- `PUSHD_TO_HOME` pushes to the home directory when no argument is given.
|
|
||||||
- `CDABLE_VARS` changes directory to a path stored in a variable.
|
|
||||||
- `AUTO_NAME_DIRS` auto adds variable-stored paths to `~` list.
|
|
||||||
- `MULTIOS` writes to multiple descriptors.
|
|
||||||
- `EXTENDED_GLOB` uses extended globbing syntax.
|
|
||||||
- `CLOBBER` does not overwrite existing files with `>` and `>>`. Use `>!` and
|
|
||||||
`>>!` to bypass.
|
|
||||||
|
|
||||||
Aliases
|
|
||||||
-------
|
|
||||||
|
|
||||||
- `d` prints the contents of the directory stack.
|
|
||||||
- `1 ... 9` changes the directory to the **n** previous one.
|
|
||||||
|
|
||||||
Authors
|
|
||||||
-------
|
|
||||||
|
|
||||||
*The authors of this module should be contacted via the [issue tracker][1].*
|
|
||||||
|
|
||||||
- [James Cox](https://github.com/imajes)
|
|
||||||
- [Sorin Ionescu](https://github.com/sorin-ionescu)
|
|
||||||
|
|
||||||
[1]: https://github.com/sorin-ionescu/prezto/issues
|
|
||||||
|
|
@ -1,63 +0,0 @@
|
|||||||
Editor
|
|
||||||
======
|
|
||||||
|
|
||||||
Sets key bindings.
|
|
||||||
|
|
||||||
Settings
|
|
||||||
--------
|
|
||||||
|
|
||||||
### Key bindings
|
|
||||||
|
|
||||||
To enable key bindings, add the following to *zpreztorc*, and replace 'bindings'
|
|
||||||
with 'emacs' or 'vi'.
|
|
||||||
|
|
||||||
zstyle ':prezto:module:editor' key-bindings 'bindings'
|
|
||||||
|
|
||||||
### Dot Expansion
|
|
||||||
|
|
||||||
To enable the auto conversion of .... to ../.., add the following to
|
|
||||||
*zpreztorc*.
|
|
||||||
|
|
||||||
zstyle ':prezto:module:editor' dot-expansion 'yes'
|
|
||||||
|
|
||||||
Theming
|
|
||||||
-------
|
|
||||||
|
|
||||||
To indicate when the editor is in the primary keymap (emacs or viins), add
|
|
||||||
the following to your `theme_prompt_setup` function.
|
|
||||||
|
|
||||||
zstyle ':prezto:module:editor:info:keymap:primary' format '>>>'
|
|
||||||
|
|
||||||
To indicate when the editor is in the primary keymap (emacs or viins) insert
|
|
||||||
mode, add the following to your `theme_prompt_setup` function.
|
|
||||||
|
|
||||||
zstyle ':prezto:module:editor:info:keymap:primary:insert' format 'I'
|
|
||||||
|
|
||||||
To indicate when the editor is in the primary keymap (emacs or viins) overwrite
|
|
||||||
mode, add the following to your `theme_prompt_setup` function.
|
|
||||||
|
|
||||||
zstyle ':prezto:module:editor:info:keymap:primary:overwrite' format 'O'
|
|
||||||
|
|
||||||
To indicate when the editor is in the alternate keymap (vicmd), add the
|
|
||||||
following to your `theme_prompt_setup` function.
|
|
||||||
|
|
||||||
zstyle ':prezto:module:editor:info:keymap:alternate' format '<<<'
|
|
||||||
|
|
||||||
To indicate when the editor is completing, add the following to your
|
|
||||||
`theme_prompt_setup` function.
|
|
||||||
|
|
||||||
zstyle ':prezto:module:editor:info:completing' format '...'
|
|
||||||
|
|
||||||
Then add `$editor_info[context]`, where context is *keymap*, *insert*, or
|
|
||||||
*overwrite*, to `$PROMPT` or `$RPROMPT` and call `editor-info` in the
|
|
||||||
`prompt_name_preexec` hook function.
|
|
||||||
|
|
||||||
Authors
|
|
||||||
-------
|
|
||||||
|
|
||||||
*The authors of this module should be contacted via the [issue tracker][1].*
|
|
||||||
|
|
||||||
- [Sorin Ionescu](https://github.com/sorin-ionescu)
|
|
||||||
|
|
||||||
[1]: https://github.com/sorin-ionescu/oh-my-zsh/issues
|
|
||||||
|
|
@ -1,33 +0,0 @@
|
|||||||
Emacs
|
|
||||||
=====
|
|
||||||
|
|
||||||
Enables Emacs dependency management.
|
|
||||||
|
|
||||||
Dependency management
|
|
||||||
---------------------
|
|
||||||
|
|
||||||
[Carton][1] installs and manages Emacs packages for Emacs package development
|
|
||||||
and Emacs configuration.
|
|
||||||
|
|
||||||
This module prepends the Carton directory to the path variable to enable the
|
|
||||||
execution of `carton`.
|
|
||||||
|
|
||||||
Aliases
|
|
||||||
-------
|
|
||||||
|
|
||||||
### Carton
|
|
||||||
|
|
||||||
- `cai` installs dependencies.
|
|
||||||
- `cau` updates dependencies.
|
|
||||||
- `caI` initializes the current directory for dependency management.
|
|
||||||
- `cae` executes a command which correct dependencies.
|
|
||||||
|
|
||||||
Authors
|
|
||||||
-------
|
|
||||||
|
|
||||||
*The authors of this module should be contacted via the [issue tracker][2].*
|
|
||||||
|
|
||||||
- [Sebastian Wiesner](https://github.com/lunaryorn)
|
|
||||||
|
|
||||||
[1]: https://github.com/rejeep/carton
|
|
||||||
[2]: https://github.com/sorin-ionescu/prezto/issues
|
|
@ -1,26 +0,0 @@
|
|||||||
Environment
|
|
||||||
===========
|
|
||||||
|
|
||||||
Sets general shell options and defines environment variables.
|
|
||||||
|
|
||||||
This module must be loaded first.
|
|
||||||
|
|
||||||
Environment Variables
|
|
||||||
---------------------
|
|
||||||
|
|
||||||
Contributors
|
|
||||||
------------
|
|
||||||
|
|
||||||
This module **MUST NOT** rely on any command not built in Zsh.
|
|
||||||
|
|
||||||
Non-interactive environment variables should be defined in *zshenv*.
|
|
||||||
|
|
||||||
Authors
|
|
||||||
-------
|
|
||||||
|
|
||||||
*The authors of this module should be contacted via the [issue tracker][1].*
|
|
||||||
|
|
||||||
- [Sorin Ionescu](https://github.com/sorin-ionescu)
|
|
||||||
|
|
||||||
[1]: https://github.com/sorin-ionescu/prezto/issues
|
|
||||||
|
|
@ -1,39 +0,0 @@
|
|||||||
Fasd
|
|
||||||
====
|
|
||||||
|
|
||||||
[Fasd][1] is a command-line productivity booster, inspired by tools like
|
|
||||||
[autojump][2], [z][3] and [v][4], it offers quick access to files and
|
|
||||||
directories by keeping track of files and directories that were previously
|
|
||||||
accessed.
|
|
||||||
|
|
||||||
For completion to work, this module must be loaded **after** the *completion*
|
|
||||||
module.
|
|
||||||
|
|
||||||
The Prezto Fasd configuration differs from the default. The default aliases have
|
|
||||||
been disabled.
|
|
||||||
|
|
||||||
Aliases
|
|
||||||
-------
|
|
||||||
|
|
||||||
- `j` changes the current working directory interactively.
|
|
||||||
|
|
||||||
Completion
|
|
||||||
----------
|
|
||||||
|
|
||||||
Type `,`, `f,`, `d,` in front of a comma-separated query or type `,,`, `,,f`,
|
|
||||||
`,,d` at the end of a comma-separated query then hit <kbd>tab</kbd>.
|
|
||||||
|
|
||||||
Authors
|
|
||||||
-------
|
|
||||||
|
|
||||||
*The authors of this module should be contacted via the [issue tracker][5].*
|
|
||||||
|
|
||||||
- [Wei Dai](https://github.com/clvv)
|
|
||||||
- [Sorin Ionescu](https://github.com/sorin-ionescu)
|
|
||||||
|
|
||||||
[1]: https://github.com/clvv/fasd
|
|
||||||
[2]: https://github.com/joelthelion/autojump
|
|
||||||
[3]: https://github.com/rupa/z
|
|
||||||
[4]: https://github.com/rupa/v
|
|
||||||
[5]: https://github.com/sorin-ionescu/prezto/issues
|
|
||||||
|
|
@ -1,335 +0,0 @@
|
|||||||
Git
|
|
||||||
===
|
|
||||||
|
|
||||||
Enhances the [Git][1] distributed version control system by providing aliases,
|
|
||||||
functions and by exposing repository status information to prompts.
|
|
||||||
|
|
||||||
Git **1.7.2** is the [minimum required version][7].
|
|
||||||
|
|
||||||
Settings
|
|
||||||
--------
|
|
||||||
|
|
||||||
### Log
|
|
||||||
|
|
||||||
The format of the [git-log][8] output is configurable via the following style,
|
|
||||||
where context is *brief*, *oneline*, and *medium*, which will be passed to the
|
|
||||||
`--pretty=format:` switch.
|
|
||||||
|
|
||||||
zstyle ':prezto:module:git:log:context' format ''
|
|
||||||
|
|
||||||
### Status
|
|
||||||
|
|
||||||
Retrieving the status of a repository with submodules can take a long time.
|
|
||||||
Submodules may be ignored when they are *dirty*, *untracked*, *all*, or *none*.
|
|
||||||
|
|
||||||
zstyle ':prezto:module:git:status:ignore' submodules 'all'
|
|
||||||
|
|
||||||
This setting affects all aliases and functions that call `git-status`.
|
|
||||||
|
|
||||||
Aliases
|
|
||||||
-------
|
|
||||||
|
|
||||||
### Git
|
|
||||||
|
|
||||||
- `g` is short for `git`.
|
|
||||||
|
|
||||||
### Branch
|
|
||||||
|
|
||||||
- `gb` lists, creates, renames, and deletes branches.
|
|
||||||
- `gbc` creates a new branch.
|
|
||||||
- `gbl` lists branches and their commits.
|
|
||||||
- `gbL` lists local and remote branches and their commits.
|
|
||||||
- `gbs` lists branches and their commits with ancestry graphs.
|
|
||||||
- `gbS` lists local and remote branches and their commits with ancestry
|
|
||||||
graphs.
|
|
||||||
- `gbx` deletes a branch.
|
|
||||||
- `gbX` deletes a branch irrespective of its merged status.
|
|
||||||
- `gbm` renames a branch.
|
|
||||||
- `gbM` renames a branch even if the new branch name already exists.
|
|
||||||
|
|
||||||
|
|
||||||
### Commit
|
|
||||||
|
|
||||||
- `gc` records changes to the repository.
|
|
||||||
- `gca` stages all modified and deleted files.
|
|
||||||
- `gcm` records changes to the repository with the given message.
|
|
||||||
- `gco` checks out a branch or paths to work tree.
|
|
||||||
- `gcO` checks out hunks from the index or the tree interactively.
|
|
||||||
- `gcf` amends the tip of the current branch using the same log message as
|
|
||||||
*HEAD*.
|
|
||||||
- `gcF` amends the tip of the current branch.
|
|
||||||
- `gcp` applies changes introduced by existing commits.
|
|
||||||
- `gcP` applies changes introduced by existing commits without committing.
|
|
||||||
- `gcr` reverts existing commits by reverting patches and recording new
|
|
||||||
commits.
|
|
||||||
- `gcR` removes the *HEAD* commit.
|
|
||||||
- `gcs` displays various types of objects.
|
|
||||||
- `gcl` lists lost commits.
|
|
||||||
|
|
||||||
### Conflict
|
|
||||||
|
|
||||||
- `gCl` lists unmerged files.
|
|
||||||
- `gCa` adds unmerged file contents to the index.
|
|
||||||
- `gCe` executes merge-tool on all unmerged file.
|
|
||||||
- `gCo` checks out our changes for unmerged paths.
|
|
||||||
- `gCO` checks out our changes for all unmerged paths.
|
|
||||||
- `gCt` checks out their changes for unmerged paths.
|
|
||||||
- `gCT` checks out their changes for all unmerged paths.
|
|
||||||
|
|
||||||
### Data
|
|
||||||
|
|
||||||
- `gd` displays information about files in the index and the work tree.
|
|
||||||
- `gdc` lists cached files.
|
|
||||||
- `gdx` lists deleted files.
|
|
||||||
- `gdm` lists modified files.
|
|
||||||
- `gdu` lists untracked files.
|
|
||||||
- `gdk` lists killed files.
|
|
||||||
- `gdi` lists ignored files.
|
|
||||||
|
|
||||||
### Fetch
|
|
||||||
|
|
||||||
- `gf` downloads objects and references from another repository.
|
|
||||||
- `gfc` clones a repository into a new directory.
|
|
||||||
- `gfm` fetches from and merges with another repository or local branch.
|
|
||||||
- `gfr` fetches from and rebases on another repository or local branch.
|
|
||||||
|
|
||||||
### Grep
|
|
||||||
|
|
||||||
- `gg` displays lines matching a pattern.
|
|
||||||
- `ggi` displays lines matching a pattern ignoring case.
|
|
||||||
- `ggl` lists files matching a pattern.
|
|
||||||
- `ggL` lists files that are not matching a pattern.
|
|
||||||
- `ggv` displays lines not matching a pattern.
|
|
||||||
- `ggw` displays lines matching a pattern at word boundary.
|
|
||||||
|
|
||||||
### Index
|
|
||||||
|
|
||||||
- `gia` adds file contents to the index.
|
|
||||||
- `giA` adds file contents to the index interactively.
|
|
||||||
- `giu` adds file contents to the index (updates only known files).
|
|
||||||
- `gid` displays changes between the index and a named commit (diff).
|
|
||||||
- `giD` displays changes between the index and a named commit (word diff).
|
|
||||||
- `gir` resets the current HEAD to the specified state.
|
|
||||||
- `giR` resets the current index interactively.
|
|
||||||
- `gix` removes files/directories from the index (recursively).
|
|
||||||
- `giX` removes files/directories from the index (recursively and forced).
|
|
||||||
|
|
||||||
### Log
|
|
||||||
|
|
||||||
- `gl` displays the log.
|
|
||||||
- `gls` displays the stats log.
|
|
||||||
- `gld` displays the diff log.
|
|
||||||
- `glo` displays the one line log.
|
|
||||||
- `glg` displays the graph log.
|
|
||||||
- `glb` displays the brief commit log.
|
|
||||||
- `glc` displays the commit count for each contributor in descending order.
|
|
||||||
|
|
||||||
### Merge
|
|
||||||
|
|
||||||
- `gm` joins two or more development histories together.
|
|
||||||
- `gmC` joins two or more development histories together but does not commit.
|
|
||||||
- `gmF` joins two or more development histories together but does not commit
|
|
||||||
generating a merge commit even if the merge resolved as a fast-forward.
|
|
||||||
- `gma` aborts the conflict resolution, and reconstructs the pre-merge state.
|
|
||||||
- `gmt` runs the merge conflict resolution tools to resolve conflicts.
|
|
||||||
|
|
||||||
### Push
|
|
||||||
|
|
||||||
- `gp` updates remote refs along with associated objects.
|
|
||||||
- `gpf` forcefully updates remote refs along with associated objects.
|
|
||||||
- `gpa` updates remote branches along with associated objects.
|
|
||||||
- `gpA` updates remote branches and tags along with associated objects.
|
|
||||||
- `gpt` updates remote tags along with associated objects.
|
|
||||||
- `gpc` updates remote refs along with associated objects and adds *origin*
|
|
||||||
as an upstream reference for the current branch.
|
|
||||||
- `gpp` pulls and pushes from origin to origin.
|
|
||||||
|
|
||||||
### Rebase
|
|
||||||
|
|
||||||
- `gr` forward-ports local commits to the updated upstream head.
|
|
||||||
- `gra` aborts the rebase.
|
|
||||||
- `grc` continues the rebase after merge conflicts are resolved.
|
|
||||||
- `gri` makes a list of commits to be rebased and opens the editor.
|
|
||||||
- `grs` skips the current patch.
|
|
||||||
|
|
||||||
### Remote
|
|
||||||
|
|
||||||
- `gR` manages tracked repositories.
|
|
||||||
- `gRl` lists remote names and their URLs.
|
|
||||||
- `gRa` adds a new remote.
|
|
||||||
- `gRx` removes a remote.
|
|
||||||
- `gRm` renames a remote.
|
|
||||||
- `gRu` fetches remotes updates.
|
|
||||||
- `gRp` prunes all stale remote tracking branches.
|
|
||||||
- `gRs` displays information about a given remote.
|
|
||||||
- `gRb` opens a remote on [GitHub][3] in the default browser.
|
|
||||||
|
|
||||||
### Stash
|
|
||||||
|
|
||||||
- `gs` stashes the changes of the dirty working directory.
|
|
||||||
- `gsa` applies the changes recorded in a stash to the working directory.
|
|
||||||
- `gsx` drops a stashed state.
|
|
||||||
- `gsX` drops all the stashed states.
|
|
||||||
- `gsl` lists stashed states.
|
|
||||||
- `gsL` lists dropped stashed states.
|
|
||||||
- `gsd` displays changes between the stash and its original parent.
|
|
||||||
- `gsp` removes and applies a single stashed state from the stash list.
|
|
||||||
- `gsr` recovers a given stashed state.
|
|
||||||
- `gss` stashes the changes of the dirty working directory, including untracked.
|
|
||||||
- `gsS` stashes the changes of the dirty working directory interactively.
|
|
||||||
- `gsw` stashes the changes of the dirty working directory retaining the index.
|
|
||||||
|
|
||||||
### Submodule
|
|
||||||
|
|
||||||
- `gS` initializes, updates, or inspects submodules.
|
|
||||||
- `gSa` adds given a repository as a submodule.
|
|
||||||
- `gSf` evaluates a shell command in each of checked out submodules.
|
|
||||||
- `gSi` initializes submodules.
|
|
||||||
- `gSI` initializes and clones submodules recursively.
|
|
||||||
- `gSl` lists the commits of all submodules.
|
|
||||||
- `gSm` moves a submodule.
|
|
||||||
- `gSs` synchronizes submodules' remote URL to the value specified in
|
|
||||||
.gitmodules.
|
|
||||||
- `gSu` fetches and merges the latest changes for all submodule.
|
|
||||||
- `gSx` removes a submodule.
|
|
||||||
|
|
||||||
### Working directory
|
|
||||||
|
|
||||||
- `gws` displays working-tree status in the short format.
|
|
||||||
- `gwS` displays working-tree status.
|
|
||||||
- `gwd` displays changes between the working tree and the index (diff).
|
|
||||||
- `gwD` displays changes between the working tree and the index (word diff).
|
|
||||||
- `gwr` resets the current HEAD to the specified state, does not touch the
|
|
||||||
index nor the working tree.
|
|
||||||
- `gwR` resets the current HEAD, index and working tree to the specified state.
|
|
||||||
- `gwc` removes untracked files from the working tree (dry-run).
|
|
||||||
- `gwC` removes untracked files from the working tree.
|
|
||||||
- `gwx` removes files from the working tree and from the index recursively.
|
|
||||||
- `gwX` removes files from the working tree and from the index recursively and
|
|
||||||
forcefully.
|
|
||||||
|
|
||||||
### Shadows
|
|
||||||
|
|
||||||
The following aliases may shadow system commands:
|
|
||||||
|
|
||||||
- `gpt` shadows the [GUID partition table maintenance utility][4].
|
|
||||||
- `gs` shadows the [Ghostscript][5].
|
|
||||||
|
|
||||||
If you frequently use the above commands, you may wish to remove said aliases
|
|
||||||
from this module or to disable them at the bottom of the zshrc with `unalias`.
|
|
||||||
|
|
||||||
You can temporarily bypass an alias by prefixing it with a backward slash:
|
|
||||||
`\gpt`.
|
|
||||||
|
|
||||||
Functions
|
|
||||||
---------
|
|
||||||
|
|
||||||
- `git-branch-current` displays the current branch.
|
|
||||||
- `git-commit-lost` lists lost commits.
|
|
||||||
- `git-dir` displays the path to the Git directory.
|
|
||||||
- `git-hub-browse` opens the [GitHub][3] repository in the default browser.
|
|
||||||
- `git-hub-shorten-url` shortens GitHub URLs.
|
|
||||||
- `git-info` exposes repository information via the `$git_info` associative
|
|
||||||
array.
|
|
||||||
- `git-root` displays the path to the working tree root.
|
|
||||||
- `git-stash-clear-interactive` asks for confirmation before clearing the stash.
|
|
||||||
- `git-stash-dropped` lists dropped stashed states.
|
|
||||||
- `git-stash-recover` recovers given dropped stashed states.
|
|
||||||
- `git-submodule-move` moves a submodule.
|
|
||||||
- `git-submodule-remove` removes a submodule.
|
|
||||||
|
|
||||||
Theming
|
|
||||||
-------
|
|
||||||
|
|
||||||
To display information about the current repository in a prompt, define the
|
|
||||||
following styles in the `prompt_name_setup` function, where the syntax for
|
|
||||||
setting a style is as follows.
|
|
||||||
|
|
||||||
zstyle ':prezto:module:git:info:context:subcontext' format 'string'
|
|
||||||
|
|
||||||
### Main Contexts
|
|
||||||
|
|
||||||
| Name | Format Code | Description
|
|
||||||
| --------- | :---------: | ---------------------------------------------------
|
|
||||||
| action | %s | Special action name
|
|
||||||
| ahead | %A | Commits ahead of remote count
|
|
||||||
| behind | %B | Commits behind of remote count
|
|
||||||
| branch | %b | Branch name
|
|
||||||
| commit | %c | Commit hash
|
|
||||||
| position | %p | Commits from the nearest tag count
|
|
||||||
| remote | %R | Remote name
|
|
||||||
| stashed | %S | Stashed states count
|
|
||||||
|
|
||||||
### Concise Contexts
|
|
||||||
|
|
||||||
| Name | Format Code | Description
|
|
||||||
| --------- | :---------: | ---------------------------------------------------
|
|
||||||
| clean | %C | Clean state
|
|
||||||
| dirty | %D | Dirty files count
|
|
||||||
| indexed | %i | Indexed files count
|
|
||||||
| unindexed | %I | Unindexed files count
|
|
||||||
| untracked | %u | Untracked files count
|
|
||||||
|
|
||||||
The following contexts must be enabled with the following zstyle:
|
|
||||||
|
|
||||||
zstyle ':prezto:module:git:info' verbose 'yes'
|
|
||||||
|
|
||||||
### Verbose Contexts
|
|
||||||
|
|
||||||
| Name | Format Code | Description
|
|
||||||
| --------- | :---------: | ---------------------------------------------------
|
|
||||||
| added | %a | Added files count
|
|
||||||
| clean | %C | Clean state
|
|
||||||
| deleted | %d | Deleted files count
|
|
||||||
| dirty | %D | Dirty files count
|
|
||||||
| modified | %m | Modified files count
|
|
||||||
| renamed | %r | Renamed files count
|
|
||||||
| unmerged | %U | Unmerged files count
|
|
||||||
| untracked | %u | Untracked files count
|
|
||||||
|
|
||||||
### Special Action Contexts
|
|
||||||
|
|
||||||
| Name | Format | Description
|
|
||||||
| -------------------- | :---------: | -----------------------------------------
|
|
||||||
| apply | value | Applying patches
|
|
||||||
| bisect | value | Binary searching for changes
|
|
||||||
| cherry-pick | value | Cherry picking
|
|
||||||
| cherry-pick-sequence | value | Cherry picking sequence
|
|
||||||
| merge | value | Merging
|
|
||||||
| rebase | value | Rebasing
|
|
||||||
| rebase-interactive | value | Rebasing interactively
|
|
||||||
| rebase-merge | value | Rebasing merge
|
|
||||||
|
|
||||||
First, format the repository state attributes. For example, to format the branch
|
|
||||||
and remote names, define the following styles.
|
|
||||||
|
|
||||||
zstyle ':prezto:module:git:info:branch' format 'branch:%b'
|
|
||||||
zstyle ':prezto:module:git:info:remote' format 'remote:%R'
|
|
||||||
|
|
||||||
Second, format how the above attributes are displayed in prompts.
|
|
||||||
|
|
||||||
zstyle ':prezto:module:git:info:keys' format \
|
|
||||||
'prompt' ' git(%b)' \
|
|
||||||
'rprompt' '[%R]'
|
|
||||||
|
|
||||||
Last, add `$git_info[prompt]` to `$PROMPT` and `$git_info[rprompt]` to
|
|
||||||
`$RPROMPT` respectively and call `git-info` in the `prompt_name_preexec` hook
|
|
||||||
function.
|
|
||||||
|
|
||||||
Authors
|
|
||||||
-------
|
|
||||||
|
|
||||||
*The authors of this module should be contacted via the [issue tracker][6].*
|
|
||||||
|
|
||||||
- [Sorin Ionescu](https://github.com/sorin-ionescu)
|
|
||||||
- [Colin Hebert](https://github.com/ColinHebert)
|
|
||||||
|
|
||||||
[1]: http://www.git-scm.com
|
|
||||||
[2]: https://github.com/defunkt/hub
|
|
||||||
[3]: https://www.github.com
|
|
||||||
[4]: http://www.manpagez.com/man/8/gpt/
|
|
||||||
[5]: http://linux.die.net/man/1/gs
|
|
||||||
[6]: https://github.com/sorin-ionescu/prezto/issues
|
|
||||||
[7]: https://github.com/sorin-ionescu/prezto/issues/219
|
|
||||||
[8]: http://www.kernel.org/pub/software/scm/git/docs/git-log.html
|
|
||||||
|
|
@ -1,33 +0,0 @@
|
|||||||
GNU Utility
|
|
||||||
===========
|
|
||||||
|
|
||||||
Provides for the interactive use of GNU utilities on non-GNU systems.
|
|
||||||
|
|
||||||
Installing GNU utilities on non-GNU systems in `$PATH` without a prefix, i.e.
|
|
||||||
`ls` instead of `gls`, is not recommended since scripts that target other
|
|
||||||
utilities will be broken.
|
|
||||||
|
|
||||||
This module wraps GNU utilities in functions without a prefix for interactive
|
|
||||||
use.
|
|
||||||
|
|
||||||
This module must be loaded **before** the *utility* module.
|
|
||||||
|
|
||||||
Settings
|
|
||||||
--------
|
|
||||||
|
|
||||||
### Prefix
|
|
||||||
|
|
||||||
To use a different prefix, add the following to *zpreztorc*, and replace 'g' with
|
|
||||||
the desired prefix:
|
|
||||||
|
|
||||||
zstyle ':prezto:module:gnu-utility' prefix 'g'
|
|
||||||
|
|
||||||
Authors
|
|
||||||
-------
|
|
||||||
|
|
||||||
*The authors of this module should be contacted via the [issue tracker][1].*
|
|
||||||
|
|
||||||
- [Sorin Ionescu](https://github.com/sorin-ionescu)
|
|
||||||
|
|
||||||
[1]: https://github.com/sorin-ionescu/prezto/issues
|
|
||||||
|
|
@ -1,25 +0,0 @@
|
|||||||
Helper
|
|
||||||
======
|
|
||||||
|
|
||||||
Provides helper functions for developing modules.
|
|
||||||
|
|
||||||
Functions
|
|
||||||
---------
|
|
||||||
|
|
||||||
- `add-zsh-trap` adds a function name to a list to be called when a trap is
|
|
||||||
triggered.
|
|
||||||
- `is-autoloadable` checks if a file can be autoloaded by trying to load it
|
|
||||||
in a subshell.
|
|
||||||
- `is-callable` checks if a name is a command, function, or alias.
|
|
||||||
- `is-true` checks a boolean variable for "true".
|
|
||||||
- `coalesce` prints the first non-empty string in the arguments array.
|
|
||||||
|
|
||||||
Authors
|
|
||||||
-------
|
|
||||||
|
|
||||||
*The authors of this module should be contacted via the [issue tracker][1].*
|
|
||||||
|
|
||||||
- [Sorin Ionescu](https://github.com/sorin-ionescu)
|
|
||||||
|
|
||||||
[1]: https://github.com/sorin-ionescu/prezto/issues
|
|
||||||
|
|
@ -1,62 +0,0 @@
|
|||||||
History Substring Search
|
|
||||||
========================
|
|
||||||
|
|
||||||
Integrates [zsh-history-substring-search][1] into Prezto, which implements
|
|
||||||
the [Fish shell][2]'s history search feature, where the user can type in any
|
|
||||||
part of a previously entered command and press up and down to cycle through
|
|
||||||
matching commands.
|
|
||||||
|
|
||||||
If this module is used in conjuncture with the *syntax-highlighting* module, it
|
|
||||||
must be loaded **after** it.
|
|
||||||
|
|
||||||
Contributors
|
|
||||||
------------
|
|
||||||
|
|
||||||
New features and bug fixes should be submitted to the
|
|
||||||
[zsh-history-substring-search][1] project according to its rules and
|
|
||||||
regulations. This module will be synchronized against it.
|
|
||||||
|
|
||||||
Settings
|
|
||||||
--------
|
|
||||||
|
|
||||||
### Case Sensitivity
|
|
||||||
|
|
||||||
To enable case-sensitivity for this module only, add the following line to
|
|
||||||
*zpreztorc*:
|
|
||||||
|
|
||||||
zstyle ':prezto:module:history-substring-search' case-sensitive 'yes'
|
|
||||||
|
|
||||||
### Highlighting
|
|
||||||
|
|
||||||
If colors are enabled, *history-substring-search* will automatically highlight
|
|
||||||
positive results.
|
|
||||||
|
|
||||||
To enable highlighting for this module only, add the following line to
|
|
||||||
*zpreztorc*:
|
|
||||||
|
|
||||||
zstyle ':prezto:module:history-substring-search' color 'yes'
|
|
||||||
|
|
||||||
To set the query found color, add the following line to *zpreztorc*:
|
|
||||||
|
|
||||||
zstyle ':prezto:module:history-substring-search:color' found ''
|
|
||||||
|
|
||||||
To set the query not found color, add the following line to *zpreztorc*:
|
|
||||||
|
|
||||||
zstyle ':prezto:module:history-substring-search:color' not-found ''
|
|
||||||
|
|
||||||
To set the search globbing flags, add the following line to *zpreztorc*:
|
|
||||||
|
|
||||||
zstyle ':prezto:module:history-substring-search' globbing-flags ''
|
|
||||||
|
|
||||||
Authors
|
|
||||||
-------
|
|
||||||
|
|
||||||
*The authors of this module should be contacted via the [issue tracker][3].*
|
|
||||||
|
|
||||||
- [Suraj N. Kurapati](https://github.com/sunaku)
|
|
||||||
- [Sorin Ionescu](https://github.com/sorin-ionescu)
|
|
||||||
|
|
||||||
[1]: https://github.com/zsh-users/zsh-history-substring-search
|
|
||||||
[2]: http://fishshell.com
|
|
||||||
[3]: https://github.com/sorin-ionescu/prezto/issues
|
|
||||||
|
|
@ -1,44 +0,0 @@
|
|||||||
History
|
|
||||||
=======
|
|
||||||
|
|
||||||
Sets [history][1] options and defines history aliases.
|
|
||||||
|
|
||||||
Variables
|
|
||||||
---------
|
|
||||||
|
|
||||||
- `HISTFILE` stores the path to the history file.
|
|
||||||
- `HISTSIZE` stores the maximum number of events to save in the internal history.
|
|
||||||
- `SAVEHIST` stores the maximum number of events to save in the history file.
|
|
||||||
|
|
||||||
Options
|
|
||||||
-------
|
|
||||||
|
|
||||||
- `BANG_HIST` treats the **!** character specially during expansion.
|
|
||||||
- `EXTENDED_HISTORY` writes the history file in the *:start:elapsed;command* format.
|
|
||||||
- `INC_APPEND_HISTORY` writes to the history file immediately, not when the shell exits.
|
|
||||||
- `SHARE_HISTORY` shares history between all sessions.
|
|
||||||
- `HIST_EXPIRE_DUPS_FIRST` expires a duplicate event first when trimming history.
|
|
||||||
- `HIST_IGNORE_DUPS` does not record an event that was just recorded again.
|
|
||||||
- `HIST_IGNORE_ALL_DUPS` deletes an old recorded event if a new event is a duplicate.
|
|
||||||
- `HIST_FIND_NO_DUPS` does not display a previously found event.
|
|
||||||
- `HIST_IGNORE_SPACE` does not record an event starting with a space.
|
|
||||||
- `HIST_SAVE_NO_DUPS` does not write a duplicate event to the history file.
|
|
||||||
- `HIST_VERIFY` does not execute immediately upon history expansion.
|
|
||||||
- `HIST_BEEP` beeps when accessing non-existent history.
|
|
||||||
|
|
||||||
Aliases
|
|
||||||
-------
|
|
||||||
|
|
||||||
- `history-stat` lists the ten most used commands
|
|
||||||
|
|
||||||
Authors
|
|
||||||
-------
|
|
||||||
|
|
||||||
*The authors of this module should be contacted via the [issue tracker][2].*
|
|
||||||
|
|
||||||
- [Robby Russell](https://github.com/robbyrussell)
|
|
||||||
- [Sorin Ionescu](https://github.com/sorin-ionescu)
|
|
||||||
|
|
||||||
[1]: http://zsh.sourceforge.net/Guide/zshguide02.html#l16
|
|
||||||
[2]: https://github.com/sorin-ionescu/prezto/issues
|
|
||||||
|
|
@ -1,26 +0,0 @@
|
|||||||
Homebrew
|
|
||||||
========
|
|
||||||
|
|
||||||
Defines Homebrew aliases.
|
|
||||||
|
|
||||||
Aliases
|
|
||||||
-------
|
|
||||||
|
|
||||||
- `brewc` cleans outdated brews and their cached archives.
|
|
||||||
- `brewC` cleans outdated brews, including keg-only, and their cached archives.
|
|
||||||
- `brewi` installs a formula.
|
|
||||||
- `brewl` lists installed formulae.
|
|
||||||
- `brews` searches for a formula.
|
|
||||||
- `brewU` upgrades Homebrew and outdated brews.
|
|
||||||
- `brewu` upgrades Homebrew.
|
|
||||||
- `brewx` uninstalls a formula.
|
|
||||||
|
|
||||||
Authors
|
|
||||||
-------
|
|
||||||
|
|
||||||
*The authors of this module should be contacted via the [issue tracker][1].*
|
|
||||||
|
|
||||||
- [Sorin Ionescu](https://github.com/sorin-ionescu)
|
|
||||||
|
|
||||||
[1]: https://github.com/sorin-ionescu/prezto/issues
|
|
||||||
|
|
@ -1,26 +0,0 @@
|
|||||||
Macports
|
|
||||||
========
|
|
||||||
|
|
||||||
Defines MacPorts aliases and adds MacPorts directories to path variables.
|
|
||||||
|
|
||||||
Aliases
|
|
||||||
-------
|
|
||||||
|
|
||||||
- `portc` cleans the files used to build ports.
|
|
||||||
- `porti` installs a port.
|
|
||||||
- `ports` searches for a port.
|
|
||||||
- `portu` upgrades a port.
|
|
||||||
- `portU` upgrades MacPorts, the ports collection, and outdated ports.
|
|
||||||
- `portx` uninstalls a port.
|
|
||||||
- `portX` uninstalls inactive ports.
|
|
||||||
|
|
||||||
Authors
|
|
||||||
-------
|
|
||||||
|
|
||||||
*The authors of this module should be contacted via the [issue tracker][1].*
|
|
||||||
|
|
||||||
- [Matt Cable](https://github.com/curiousstranger)
|
|
||||||
- [Sorin Ionescu](https://github.com/sorin-ionescu)
|
|
||||||
|
|
||||||
[1]: https://github.com/sorin-ionescu/prezto/issues
|
|
||||||
|
|
@ -1,46 +0,0 @@
|
|||||||
Node.js
|
|
||||||
=======
|
|
||||||
|
|
||||||
Provides utility functions for [Node.js][1], loads the Node Version Manager, and
|
|
||||||
enables [npm][2] completion.
|
|
||||||
|
|
||||||
nvm
|
|
||||||
---
|
|
||||||
|
|
||||||
[nvm][5] allows for managing multiple, isolated Node.js installations in the
|
|
||||||
home directory.
|
|
||||||
|
|
||||||
Functions
|
|
||||||
---------
|
|
||||||
|
|
||||||
- `node-doc` opens the Node.js online [API documentation][3] in the default
|
|
||||||
browser.
|
|
||||||
- `node-info` exposes information about the Node.js environment via the
|
|
||||||
`$node_info` associative array.
|
|
||||||
|
|
||||||
Theming
|
|
||||||
-------
|
|
||||||
|
|
||||||
To display the version number of the current Node.js version, define the
|
|
||||||
following style inside the `prompt_name_setup` function.
|
|
||||||
|
|
||||||
# %v - Node.js version.
|
|
||||||
zstyle ':prezto:module:node:info:version' format 'version:%v'
|
|
||||||
|
|
||||||
Then add `$node_info[version]` to either `$PROMPT` or `$RPROMPT` and call
|
|
||||||
`node-info` in `prompt_name_preexec` hook function.
|
|
||||||
|
|
||||||
Authors
|
|
||||||
-------
|
|
||||||
|
|
||||||
*The authors of this module should be contacted via the [issue tracker][4].*
|
|
||||||
|
|
||||||
- [Sorin Ionescu](https://github.com/sorin-ionescu)
|
|
||||||
- [Zeh Rizzatti](https://github.com/zehrizzatti)
|
|
||||||
|
|
||||||
[1]: http://nodejs.org
|
|
||||||
[2]: http://npmjs.org
|
|
||||||
[3]: http://nodejs.org/api
|
|
||||||
[4]: https://github.com/sorin-ionescu/prezto/issues
|
|
||||||
[5]: https://github.com/creationix/nvm
|
|
||||||
|
|
@ -1,35 +0,0 @@
|
|||||||
OSX
|
|
||||||
===
|
|
||||||
|
|
||||||
Defines [Mac OS X][1] aliases and functions.
|
|
||||||
|
|
||||||
Aliases
|
|
||||||
-------
|
|
||||||
|
|
||||||
- `cdf` changes the current working director to the current _Finder_
|
|
||||||
directory.
|
|
||||||
- `pushdf` pushes the current working directory onto the directory queue and
|
|
||||||
- `ql` quick looks at files.
|
|
||||||
- `rm-osx-cruft` deletes .DS\_Store, \_\_MACOSX cruft.
|
|
||||||
|
|
||||||
Functions
|
|
||||||
---------
|
|
||||||
|
|
||||||
- `manb` opens _man_ pages in [_Bwana.app_][2].
|
|
||||||
- `manp` opens _man_ pages in _Preview.app_.
|
|
||||||
- `pfd` prints the current _Finder_ directory.
|
|
||||||
- `pfs` prints the current _Finder_ selection.
|
|
||||||
- `tab` creates a new tab (works in both _Terminal_ and [_iTerm_][3]).
|
|
||||||
|
|
||||||
Authors
|
|
||||||
-------
|
|
||||||
|
|
||||||
*The authors of this module should be contacted via the [issue tracker][4].*
|
|
||||||
|
|
||||||
- [Sorin Ionescu](https://github.com/sorin-ionescu)
|
|
||||||
|
|
||||||
[1]: http://www.apple.com/macosx/
|
|
||||||
[2]: http://bruji.com/bwana/
|
|
||||||
[3]: http://www.iterm2.com/
|
|
||||||
[4]: https://github.com/sorin-ionescu/prezto/issues
|
|
||||||
|
|
@ -1,66 +0,0 @@
|
|||||||
Pacman
|
|
||||||
======
|
|
||||||
|
|
||||||
Provides aliases and functions for the [Pacman][1] package manager and
|
|
||||||
frontends.
|
|
||||||
|
|
||||||
Settings
|
|
||||||
--------
|
|
||||||
|
|
||||||
To enable a Pacman frontend, for example, [Yaourt][2], add the following line to
|
|
||||||
*zpreztorc*:
|
|
||||||
|
|
||||||
zstyle ':prezto:module:pacman' frontend 'yaourt'
|
|
||||||
|
|
||||||
If you have enabled color globally in *zpreztorc*, you may disable it for certain
|
|
||||||
commands.
|
|
||||||
|
|
||||||
To disable `yaourt` highlighting, add the following line to *zpreztorc*:
|
|
||||||
|
|
||||||
zstyle ':prezto:module:pacman:yaourt' color 'no'
|
|
||||||
|
|
||||||
Aliases
|
|
||||||
-------
|
|
||||||
|
|
||||||
### Pacman
|
|
||||||
|
|
||||||
- `pac` is short for `pacman`.
|
|
||||||
- `paci` installs packages from repositories.
|
|
||||||
- `pacI` installs packages from files.
|
|
||||||
- `pacx` removes packages and unneeded dependencies.
|
|
||||||
- `pacX` removes packages, their configuration, and unneeded dependencies.
|
|
||||||
- `pacq` displays information about a package from the repositories.
|
|
||||||
- `pacQ` displays information about a package from the local database.
|
|
||||||
- `pacs` searches for packages in the repositories.
|
|
||||||
- `pacS` searches for packages in the local database.
|
|
||||||
- `pacu` synchronizes the local package and Arch Build System (requires `abs`)
|
|
||||||
databases against the repositories.
|
|
||||||
- `pacU` synchronizes the local package database against the repositories then
|
|
||||||
upgrades outdated packages.
|
|
||||||
- `pacman-list-orphans` lists orphan packages.
|
|
||||||
- `pacman-remove-orphans` removes orphan packages.
|
|
||||||
|
|
||||||
### Frontends
|
|
||||||
|
|
||||||
#### Yaourt
|
|
||||||
|
|
||||||
- `pacc` manages *.pac\** files.
|
|
||||||
|
|
||||||
Functions
|
|
||||||
---------
|
|
||||||
|
|
||||||
- `pacman-list-explicit` lists explicitly installed pacman packages.
|
|
||||||
- `pacman-list-disowned` lists pacman disowned files.
|
|
||||||
|
|
||||||
Authors
|
|
||||||
-------
|
|
||||||
|
|
||||||
*The authors of this module should be contacted via the [issue tracker][3].*
|
|
||||||
|
|
||||||
- [Benjamin Boudreau](https://github.com/dreur)
|
|
||||||
- [Sorin Ionescu](https://github.com/sorin-ionescu)
|
|
||||||
|
|
||||||
[1]: http://www.archlinux.org/pacman/
|
|
||||||
[2]: http://archlinux.fr/yaourt-en
|
|
||||||
[3]: https://github.com/sorin-ionescu/prezto/issues
|
|
||||||
|
|
@ -1,64 +0,0 @@
|
|||||||
Perl
|
|
||||||
====
|
|
||||||
|
|
||||||
Enables local [Perl][1] module installation on Mac OS X and defines alises.
|
|
||||||
|
|
||||||
Local Module Installation
|
|
||||||
-------------------------
|
|
||||||
|
|
||||||
Perl versions older than 5.14 do not support the local installation of Perl
|
|
||||||
modules natively. This module allows for local installation of Perl modules on
|
|
||||||
Mac OS X in *~/Library/Perl/5.12* by altering the environment.
|
|
||||||
|
|
||||||
### Usage
|
|
||||||
|
|
||||||
For Perl versions older than 5.14, install *local::lib*.
|
|
||||||
|
|
||||||
curl -L -C - -O http://search.cpan.org/CPAN/authors/id/A/AP/APEIRON/local-lib-1.008004.tar.gz
|
|
||||||
tar xvf local-lib-1.008004.tar.gz
|
|
||||||
cd local-lib-1.008004
|
|
||||||
perl Makefile.PL --bootstrap=$HOME/Library/Perl/5.12
|
|
||||||
make && make test && make install
|
|
||||||
|
|
||||||
Install *cpanminus*:
|
|
||||||
|
|
||||||
curl -L http://cpanmin.us | perl - --self-upgrade
|
|
||||||
|
|
||||||
Perlbrew
|
|
||||||
--------
|
|
||||||
|
|
||||||
An alternative to the above is to use [Perlbrew][2], which allows for the
|
|
||||||
management of multiple, isolated Perl installations in the home directory.
|
|
||||||
|
|
||||||
Aliases
|
|
||||||
-------
|
|
||||||
|
|
||||||
### General
|
|
||||||
|
|
||||||
- `pl` is short for `perl`.
|
|
||||||
- `pld` looks up Perl documentation (`perldoc`).
|
|
||||||
- `ple` executes a one line program in a loop (`perl -wlne`).
|
|
||||||
|
|
||||||
### Perlbrew
|
|
||||||
|
|
||||||
- `plb` manages Perl environments.
|
|
||||||
- `plba` lists available Perl versions.
|
|
||||||
- `plbi` installs a Perl version.
|
|
||||||
- `plbl` lists installed Perl versions.
|
|
||||||
- `plbo` temporarily turns off Perlbrew.
|
|
||||||
- `plbO` turns off Perlbrew.
|
|
||||||
- `plbs` switches to a Perl version.
|
|
||||||
- `plbu` uninstalls a Perl version.
|
|
||||||
- `plbx` temporarily sets the Perl version to use.
|
|
||||||
|
|
||||||
Authors
|
|
||||||
-------
|
|
||||||
|
|
||||||
*The authors of this module should be contacted via the [issue tracker][3].*
|
|
||||||
|
|
||||||
- [Sorin Ionescu](https://github.com/sorin-ionescu)
|
|
||||||
|
|
||||||
[1]: http://www.perl.org
|
|
||||||
[2]: http://perlbrew.pl
|
|
||||||
[3]: https://github.com/sorin-ionescu/prezto/issues
|
|
||||||
|
|
@ -1,112 +0,0 @@
|
|||||||
Prompt
|
|
||||||
======
|
|
||||||
|
|
||||||
Loads prompt [themes][1].
|
|
||||||
|
|
||||||
Settings
|
|
||||||
--------
|
|
||||||
|
|
||||||
To select a prompt theme, add the following to *zpreztorc*, and replace **name**
|
|
||||||
with the name of the theme you wish to load. Setting it to **random** will load
|
|
||||||
a random theme.
|
|
||||||
|
|
||||||
zstyle ':prezto:module:prompt' theme 'name'
|
|
||||||
|
|
||||||
Theming
|
|
||||||
-------
|
|
||||||
|
|
||||||
A prompt theme is an autoloadable function file with a special name,
|
|
||||||
`prompt_name_setup`, placed anywhere in `$fpath`, but for the purpose of this
|
|
||||||
project, themes **should** be placed in the *modules/prompt/functions*
|
|
||||||
directory.
|
|
||||||
|
|
||||||
### Theme Functions
|
|
||||||
|
|
||||||
There are three theme functions, a setup function, a help function, and
|
|
||||||
a preview function. The setup function **must** always be defined. The help
|
|
||||||
function and the preview functions are optional.
|
|
||||||
|
|
||||||
#### prompt_name_setup
|
|
||||||
|
|
||||||
This function is called by the `prompt` function to install the theme. This
|
|
||||||
function may define other functions as necessary to maintain the prompt,
|
|
||||||
including a function that displays help or a function used to preview it.
|
|
||||||
|
|
||||||
**Do not call this function directly.**
|
|
||||||
|
|
||||||
The most basic example of this function can be seen below.
|
|
||||||
|
|
||||||
function prompt_name_setup {
|
|
||||||
PROMPT='%m%# '
|
|
||||||
RPROMPT=''
|
|
||||||
}
|
|
||||||
|
|
||||||
#### prompt_name_help
|
|
||||||
|
|
||||||
If the `prompt_name_setup` function is customizable via parameters, a help
|
|
||||||
function **should** be defined. The user will access it via `prompt -h name`.
|
|
||||||
|
|
||||||
The most basic example of this function can be seen bellow.
|
|
||||||
|
|
||||||
function prompt_name_help {
|
|
||||||
cat <<EOH
|
|
||||||
This prompt is color-scheme-able. You can invoke it thus:
|
|
||||||
|
|
||||||
prompt theme [<color1>] [<color2>]
|
|
||||||
|
|
||||||
where the color is for the left-hand prompt.
|
|
||||||
EOH
|
|
||||||
}
|
|
||||||
|
|
||||||
#### prompt_name_preview
|
|
||||||
|
|
||||||
If the `prompt_name_setup` function is customizable via parameters, a preview
|
|
||||||
function **should** be defined. The user will access it via `prompt -p name`.
|
|
||||||
|
|
||||||
The most basic example of this function can be seen bellow.
|
|
||||||
|
|
||||||
function prompt_name_preview {
|
|
||||||
if (( $# > 0 )); then
|
|
||||||
prompt_preview_theme theme "$@"
|
|
||||||
else
|
|
||||||
prompt_preview_theme theme red green blue
|
|
||||||
print
|
|
||||||
prompt_preview_theme theme yellow magenta black
|
|
||||||
fi
|
|
||||||
}
|
|
||||||
|
|
||||||
### Hook Functions
|
|
||||||
|
|
||||||
There are many Zsh [hook][2] functions, but mostly the *precmd* hook will be
|
|
||||||
used.
|
|
||||||
|
|
||||||
#### prompt_name_precmd
|
|
||||||
|
|
||||||
This hook is called before the prompt is displayed and is useful for getting
|
|
||||||
information to display in a prompt.
|
|
||||||
|
|
||||||
When calling functions to get information to display in a prompt, do not assume
|
|
||||||
that all the dependencies have been loaded. Always check for the availability of
|
|
||||||
a function before you calling it.
|
|
||||||
|
|
||||||
**Do not register hook functions. They will be registered by the `prompt` function.**
|
|
||||||
|
|
||||||
The most basic example of this function can be seen bellow.
|
|
||||||
|
|
||||||
function prompt_name_precmd {
|
|
||||||
if (( $+functions[git-info] )); then
|
|
||||||
git-info
|
|
||||||
fi
|
|
||||||
}
|
|
||||||
|
|
||||||
Authors
|
|
||||||
-------
|
|
||||||
|
|
||||||
*The authors of this module should be contacted via the [issue tracker][3].*
|
|
||||||
|
|
||||||
- [Sorin Ionescu](https://github.com/sorin-ionescu)
|
|
||||||
|
|
||||||
[1]: http://zsh.sourceforge.net/Doc/Release/User-Contributions.html#Prompt-Themes
|
|
||||||
[2]: http://zsh.sourceforge.net/Doc/Release/Functions.html#Hook-Functions
|
|
||||||
[3]: https://github.com/sorin-ionescu/prezto/issues
|
|
||||||
|
|
@ -1,100 +0,0 @@
|
|||||||
Python
|
|
||||||
======
|
|
||||||
|
|
||||||
Enables local Python and local Python package installation.
|
|
||||||
|
|
||||||
Local Python Installation
|
|
||||||
-------------------------
|
|
||||||
|
|
||||||
[pyenv][4] builds and installs multiple Python versions locally in the home
|
|
||||||
directory.
|
|
||||||
|
|
||||||
This module prepends the pyenv directory to the path variable to enable the
|
|
||||||
execution of `pyenv`.
|
|
||||||
|
|
||||||
### Usage
|
|
||||||
|
|
||||||
Install Python versions with `pyenv install` into *~/.pyenv/versions*.
|
|
||||||
|
|
||||||
Local Package Installation
|
|
||||||
--------------------------
|
|
||||||
|
|
||||||
Since version 2.6, Python supports per user package installation, as defined in
|
|
||||||
[PEP 370][1].
|
|
||||||
|
|
||||||
This module prepends per user site directories to the relevant path variables
|
|
||||||
to enable the execution of user installed scripts and the reading of
|
|
||||||
documentation.
|
|
||||||
|
|
||||||
### Usage
|
|
||||||
|
|
||||||
Install packages into the per user site directory with `easy_install --user` or
|
|
||||||
`pip install --user`.
|
|
||||||
|
|
||||||
virtualenvwrapper
|
|
||||||
-----------------
|
|
||||||
|
|
||||||
[virtualenvwrapper][2] is a frontend to the popular [virtualenv][3] utility.
|
|
||||||
|
|
||||||
virtualenv creates isolated Python environments and virtualenvwrapper provides
|
|
||||||
convenient shell functions to create, switch, and manage them.
|
|
||||||
|
|
||||||
### Usage
|
|
||||||
|
|
||||||
Install virtualenvwrapper.
|
|
||||||
|
|
||||||
Virtual environments are stored in *~/.virtualenvs*.
|
|
||||||
|
|
||||||
There are configuration variables that have to be set to enable certain features.
|
|
||||||
If you wish to use these features, export the variables in *~/.zshenv*
|
|
||||||
|
|
||||||
The variable `$PROJECT_HOME` tells virtualenvwrapper where to place project
|
|
||||||
working directories. It must be set and the directory created before `mkproject`
|
|
||||||
is used. Replace *Developer* with your projects directory.
|
|
||||||
|
|
||||||
export PROJECT_HOME="$HOME/Developer"
|
|
||||||
|
|
||||||
The variable `$VIRTUALENVWRAPPER_VIRTUALENV_ARGS` tells virtualenvwrapper what
|
|
||||||
arguments to pass to `virtualenv`. For example, set the value to
|
|
||||||
*--no-site-packages* to ensure that all new environments are isolated from the
|
|
||||||
system site-packages directory.
|
|
||||||
|
|
||||||
export VIRTUALENVWRAPPER_VIRTUALENV_ARGS='--no-site-packages'
|
|
||||||
|
|
||||||
Aliases
|
|
||||||
-------
|
|
||||||
|
|
||||||
- `py` is short for `python`.
|
|
||||||
|
|
||||||
Functions
|
|
||||||
---------
|
|
||||||
|
|
||||||
- `python-info` exposes information about the Python environment via the
|
|
||||||
`$python_info` associative array.
|
|
||||||
|
|
||||||
Theming
|
|
||||||
-------
|
|
||||||
|
|
||||||
To display the name of the current virtual enviroment in a prompt, define the
|
|
||||||
following style in the `prompt_name_setup` function.
|
|
||||||
|
|
||||||
# %v - virtualenv name.
|
|
||||||
zstyle ':prezto:module:python:info:virtualenv' format 'virtualenv:%v'
|
|
||||||
|
|
||||||
Then add `$python_info[virtualenv]` to `$PROMPT` or `$RPROMPT` and call
|
|
||||||
`python-info` in the `prompt_name_preexec` hook function.
|
|
||||||
|
|
||||||
Authors
|
|
||||||
-------
|
|
||||||
|
|
||||||
*The authors of this module should be contacted via the [issue tracker][5].*
|
|
||||||
|
|
||||||
- [Sorin Ionescu](https://github.com/sorin-ionescu)
|
|
||||||
- [Sebastian Wiesner](https://github.com/lunaryorn)
|
|
||||||
|
|
||||||
[1]: http://www.python.org/dev/peps/pep-0370/
|
|
||||||
[2]: http://www.doughellmann.com/projects/virtualenvwrapper/
|
|
||||||
[3]: http://pypi.python.org/pypi/virtualenv
|
|
||||||
[4]: https://github.com/yyuu/pyenv
|
|
||||||
[5]: https://github.com/sorin-ionescu/prezto/issues
|
|
||||||
|
|
@ -1,35 +0,0 @@
|
|||||||
Ruby on Rails
|
|
||||||
=============
|
|
||||||
|
|
||||||
Defines [Ruby on Rails][1] aliases.
|
|
||||||
|
|
||||||
Aliases
|
|
||||||
-------
|
|
||||||
|
|
||||||
- `ror` is short for `rails`.
|
|
||||||
- `rorc` starts the Rails console.
|
|
||||||
- `rordc` starts the Rails console connected to the database.
|
|
||||||
- `rordm` migrates the database.
|
|
||||||
- `rordM` migrates the database and recreates the test database.
|
|
||||||
- `rordr` rolls the database schema back to the previous version.
|
|
||||||
- `rorg` generates new code.
|
|
||||||
- `rorl` displays the log.
|
|
||||||
- `rorlc` truncates logs to zero bytes.
|
|
||||||
- `rorp` installs a plugin.
|
|
||||||
- `rorr` runs code in the application environment.
|
|
||||||
- `rors` starts the Rails server.
|
|
||||||
- `rorsd` starts the Rails server with the debugger.
|
|
||||||
- `rorx` destroys newly generated code.
|
|
||||||
|
|
||||||
Authors
|
|
||||||
-------
|
|
||||||
|
|
||||||
*The authors of this module should be contacted via the [issue tracker][2].*
|
|
||||||
|
|
||||||
- [Robby Russell](https://github.com/robbyrussell)
|
|
||||||
- [Jake Bell](https://github.com/theunraveler)
|
|
||||||
- [Sorin Ionescu](https://github.com/sorin-ionescu)
|
|
||||||
|
|
||||||
[1]: http://rubyonrails.org
|
|
||||||
[2]: https://github.com/sorin-ionescu/prezto/issues
|
|
||||||
|
|
@ -1,28 +0,0 @@
|
|||||||
Rsync
|
|
||||||
=====
|
|
||||||
|
|
||||||
Defines [rsync][1] aliases.
|
|
||||||
|
|
||||||
Mac OS X users are encouraged to use [Bombich's rsync][2], which has HFS+
|
|
||||||
enhancements.
|
|
||||||
|
|
||||||
Aliases
|
|
||||||
-------
|
|
||||||
|
|
||||||
- `rsync-copy` copies files and directories from *source* to *destination*.
|
|
||||||
- `rsync-move` moves files and directories from *source* to *destination*.
|
|
||||||
- `rsync-update` updates files and directories on *destination*.
|
|
||||||
- `rsync-synchronize` synchronizes files and directories between *source* and
|
|
||||||
*destination*.
|
|
||||||
|
|
||||||
Authors
|
|
||||||
-------
|
|
||||||
|
|
||||||
*The authors of this module should be contacted via the [issue tracker][3].*
|
|
||||||
|
|
||||||
- [Sorin Ionescu](https://github.com/sorin-ionescu)
|
|
||||||
|
|
||||||
[1]: http://rsync.samba.org
|
|
||||||
[2]: http://help.bombich.com/kb/overview/credits#opensource
|
|
||||||
[3]: https://github.com/sorin-ionescu/prezto/issues
|
|
||||||
|
|
@ -1,90 +0,0 @@
|
|||||||
Ruby
|
|
||||||
====
|
|
||||||
|
|
||||||
Configures [Ruby][1] local gem installation, loads version managers, and defines
|
|
||||||
aliases.
|
|
||||||
|
|
||||||
Local Gem Installation
|
|
||||||
----------------------
|
|
||||||
|
|
||||||
When a Ruby version manager is not detected, local gems are installed in
|
|
||||||
*~/Library/Ruby/Gems/1.8* on Mac OS X.
|
|
||||||
|
|
||||||
RVM
|
|
||||||
---
|
|
||||||
|
|
||||||
An alternative to the above is to use [The Ruby Version Manager (RVM)][2], which
|
|
||||||
allows for managing multiple, isolated Ruby installations and gem sets in the
|
|
||||||
home directory.
|
|
||||||
|
|
||||||
Since RVM is loaded into the shell and is known to override shell commands, it
|
|
||||||
may conflict with shell scripts.
|
|
||||||
|
|
||||||
rbenv
|
|
||||||
-----
|
|
||||||
|
|
||||||
An alternative RVM is to use [rbenv][3], which allows for switching between multiple,
|
|
||||||
isolated Ruby installations in the home directory.
|
|
||||||
|
|
||||||
While it is not as feature rich as RVM, it is not loaded into the shell and is
|
|
||||||
not known to cause conflicts with shell scripts.
|
|
||||||
|
|
||||||
Bundler
|
|
||||||
-------
|
|
||||||
|
|
||||||
Manage gems that are not meant to be used as commands, such as application
|
|
||||||
dependencies, with [Bundler][4].
|
|
||||||
|
|
||||||
Aliases
|
|
||||||
-------
|
|
||||||
|
|
||||||
### General
|
|
||||||
|
|
||||||
- `rb` is short for `ruby`.
|
|
||||||
|
|
||||||
### Bundler
|
|
||||||
|
|
||||||
- `rbb` manages ruby dependencies (`bundle`).
|
|
||||||
- `rbbe` executes a script in the context of the current bundle.
|
|
||||||
- `rbbi` installs the gems specified in the *Gemfile* in *vendor/bundle*.
|
|
||||||
- `rbbI` installs the following:
|
|
||||||
- gems specified in the *Gemfile* in *vendor/bundle*.
|
|
||||||
- packages the gems into *vendor/cache*.
|
|
||||||
- appends bundler directories to *.gitignore*.
|
|
||||||
- `rbbl` lists all gems in the current bundle.
|
|
||||||
- `rbbo` opens an installed gem in the editor.
|
|
||||||
- `rbbp` packages gem files into *vendor/cache*.
|
|
||||||
- `rbbu` updates gems to their latest version.
|
|
||||||
|
|
||||||
Functions
|
|
||||||
---------
|
|
||||||
|
|
||||||
- `ruby-app-root` displays the path to the Ruby application root directory.
|
|
||||||
- `ruby-info` exposes information about the Ruby environment via the
|
|
||||||
`$ruby_info` associative array.
|
|
||||||
|
|
||||||
Theming
|
|
||||||
-------
|
|
||||||
|
|
||||||
To display the name of the current Ruby version in a prompt, define the
|
|
||||||
following style in the `prompt_name_setup` function.
|
|
||||||
|
|
||||||
# %v - ruby version.
|
|
||||||
zstyle ':prezto:module:ruby:info:version' format 'version:%v'
|
|
||||||
|
|
||||||
Then add `$ruby_info[version]` to `$PROMPT` or `$RPROMPT` and call
|
|
||||||
`ruby-info` in the `prompt_name_preexec` hook function.
|
|
||||||
|
|
||||||
Authors
|
|
||||||
-------
|
|
||||||
|
|
||||||
*The authors of this module should be contacted via the [issue tracker][5].*
|
|
||||||
|
|
||||||
- [Sorin Ionescu](https://github.com/sorin-ionescu)
|
|
||||||
|
|
||||||
[1]: http://www.ruby-lang.org
|
|
||||||
[2]: https://rvm.io
|
|
||||||
[3]: https://github.com/sstephenson/rbenv
|
|
||||||
[4]: http://gembundler.com
|
|
||||||
[5]: https://github.com/sorin-ionescu/prezto/issues
|
|
||||||
|
|
@ -1,80 +0,0 @@
|
|||||||
Configuration Files
|
|
||||||
===================
|
|
||||||
|
|
||||||
Zsh has several system-wide and user-local configuration files.
|
|
||||||
|
|
||||||
Prezto has one user-local configuration file.
|
|
||||||
|
|
||||||
System-wide configuration files are installation-dependent but are installed
|
|
||||||
in */etc* by default.
|
|
||||||
|
|
||||||
User-local configuration files have the same name as their global counterparts
|
|
||||||
but are prefixed with a dot (hidden). Zsh looks for these files in the path
|
|
||||||
stored in the `$ZDOTDIR` environmental variable. However, if said variable is
|
|
||||||
not defined, Zsh will use the user's home directory.
|
|
||||||
|
|
||||||
File Descriptions
|
|
||||||
-----------------
|
|
||||||
|
|
||||||
The configuration files are read in the following order:
|
|
||||||
|
|
||||||
01. /etc/zshenv
|
|
||||||
02. ~/.zshenv
|
|
||||||
03. /etc/zprofile
|
|
||||||
04. ~/.zprofile
|
|
||||||
05. /etc/zshrc
|
|
||||||
06. ~/.zshrc
|
|
||||||
07. ~/.zpreztorc
|
|
||||||
08. /etc/zlogin
|
|
||||||
09. ~/.zlogin
|
|
||||||
10. ~/.zlogout
|
|
||||||
11. /etc/zlogout
|
|
||||||
|
|
||||||
### zshenv
|
|
||||||
|
|
||||||
This file is sourced by all instances of Zsh, and thus, it should be kept as
|
|
||||||
small as possible and should only define environment variables.
|
|
||||||
|
|
||||||
### zprofile
|
|
||||||
|
|
||||||
This file is similar to zlogin, but it is sourced before zshrc. It was added
|
|
||||||
for [KornShell][1] fans. See the description of zlogin below for what it may
|
|
||||||
contain.
|
|
||||||
|
|
||||||
zprofile and zlogin are not meant to be used concurrently but can be done so.
|
|
||||||
|
|
||||||
### zshrc
|
|
||||||
|
|
||||||
This file is sourced by interactive shells. It should define aliases,
|
|
||||||
functions, shell options, and key bindings.
|
|
||||||
|
|
||||||
### zpreztorc
|
|
||||||
|
|
||||||
This file configures Prezto.
|
|
||||||
|
|
||||||
### zlogin
|
|
||||||
|
|
||||||
This file is sourced by login shells after zshrc, and thus, it should contain
|
|
||||||
commands that need to execute at login. It is usually used for messages such as
|
|
||||||
[fortune][2], [msgs][3], or for the creation of files.
|
|
||||||
|
|
||||||
This is not the file to define aliases, functions, shell options, and key
|
|
||||||
bindings. It should not change the shell environment.
|
|
||||||
|
|
||||||
### zlogout
|
|
||||||
|
|
||||||
This file is sourced by login shells during logout. It should be used for
|
|
||||||
displaying messages and the deletion of files.
|
|
||||||
|
|
||||||
Authors
|
|
||||||
-------
|
|
||||||
|
|
||||||
*The authors of these files should be contacted via the [issue tracker][4].*
|
|
||||||
|
|
||||||
- [Sorin Ionescu](https://github.com/sorin-ionescu)
|
|
||||||
|
|
||||||
[1]: http://www.kornshell.com
|
|
||||||
[2]: http://en.wikipedia.org/wiki/Fortune_(Unix)
|
|
||||||
[3]: http://www.manpagez.com/man/1/msgs
|
|
||||||
[4]: https://github.com/sorin-ionescu/prezto/issues
|
|
||||||
|
|
@ -1,41 +0,0 @@
|
|||||||
GNU Screen
|
|
||||||
==========
|
|
||||||
|
|
||||||
Defines [GNU Screen][1] aliases and provides for auto launching it at start-up.
|
|
||||||
|
|
||||||
Settings
|
|
||||||
--------
|
|
||||||
|
|
||||||
### Auto-Start
|
|
||||||
|
|
||||||
Starts a GNU Screen session automatically when Zsh is launched.
|
|
||||||
|
|
||||||
To enable this feature when launching Zsh in a local terminal, add the
|
|
||||||
following line to *zpreztorc*:
|
|
||||||
|
|
||||||
zstyle ':prezto:module:screen:auto-start' local 'yes'
|
|
||||||
|
|
||||||
To enable this feature when launching Zsh in a SSH connection, add the
|
|
||||||
following line to *zpreztorc*:
|
|
||||||
|
|
||||||
zstyle ':prezto:module:screen:auto-start' remote 'yes'
|
|
||||||
|
|
||||||
Aliases
|
|
||||||
-------
|
|
||||||
|
|
||||||
- `scr` is short for `screen`.
|
|
||||||
- `scrl` lists sessions/socket directory.
|
|
||||||
- `scrn` starts a new session.
|
|
||||||
- `scrr` attaches to a session if one exists or start a new one.
|
|
||||||
|
|
||||||
Authors
|
|
||||||
-------
|
|
||||||
|
|
||||||
*The authors of this module should be contacted via the [issue tracker][2].*
|
|
||||||
|
|
||||||
- [Sorin Ionescu](https://github.com/sorin-ionescu)
|
|
||||||
- [Georges Discry](https://github.com/gdiscry)
|
|
||||||
|
|
||||||
[1]: http://www.gnu.org/software/screen/
|
|
||||||
[2]: https://github.com/sorin-ionescu/prezto/issues
|
|
||||||
|
|
@ -1,28 +0,0 @@
|
|||||||
SSH
|
|
||||||
===
|
|
||||||
|
|
||||||
Provides for an easier use of [SSH][1] by setting up [ssh-agent][2].
|
|
||||||
|
|
||||||
This module is disabled on Mac OS X due to custom Apple SSH support rendering it
|
|
||||||
unnecessary.
|
|
||||||
|
|
||||||
Settings
|
|
||||||
--------
|
|
||||||
|
|
||||||
### Identities
|
|
||||||
|
|
||||||
To load multiple identities, add the following line to *zpreztorc*:
|
|
||||||
|
|
||||||
zstyle ':prezto:module:ssh:load' identities 'id_rsa' 'id_dsa' 'id_github'
|
|
||||||
|
|
||||||
Authors
|
|
||||||
-------
|
|
||||||
|
|
||||||
*The authors of this module should be contacted via the [issue tracker][3].*
|
|
||||||
|
|
||||||
- [Sorin Ionescu](https://github.com/sorin-ionescu)
|
|
||||||
|
|
||||||
[1]: http://www.openssh.com
|
|
||||||
[2]: http://www.openbsd.org/cgi-bin/man.cgi?query=ssh-agent&sektion=1
|
|
||||||
[3]: https://github.com/sorin-ionescu/prezto/issues
|
|
||||||
|
|
@ -1,63 +0,0 @@
|
|||||||
Syntax Highlighting
|
|
||||||
===================
|
|
||||||
|
|
||||||
Integrates [zsh-syntax-highlighting][1] into Prezto.
|
|
||||||
|
|
||||||
This module should be loaded *second to last*, where last is the *prompt*
|
|
||||||
module, unless used in conjuncture with the *history-substring-search* module
|
|
||||||
where it must be loaded **before** it.
|
|
||||||
|
|
||||||
Contributors
|
|
||||||
------------
|
|
||||||
|
|
||||||
New features and bug fixes should be submitted to the
|
|
||||||
[zsh-syntax-highlighting][1] project according to its rules and regulations.
|
|
||||||
This module will be synchronized against it.
|
|
||||||
|
|
||||||
Settings
|
|
||||||
--------
|
|
||||||
|
|
||||||
### Highlighting
|
|
||||||
|
|
||||||
To enable highlighting for this module only, add the following line to
|
|
||||||
*zpreztorc*:
|
|
||||||
|
|
||||||
zstyle ':prezto:module:syntax-highlighting' color 'yes'
|
|
||||||
|
|
||||||
### Highlighters
|
|
||||||
|
|
||||||
Syntax highlighting is accomplished by pluggable [highlighters][2]. This module
|
|
||||||
enables the *main*, *brackets*, and *cursor* highlighters by default.
|
|
||||||
|
|
||||||
To enable all highlighters, add the following to *zpreztorc*:
|
|
||||||
|
|
||||||
zstyle ':prezto:module:syntax-highlighting' highlighters \
|
|
||||||
'main' \
|
|
||||||
'brackets' \
|
|
||||||
'pattern' \
|
|
||||||
'cursor' \
|
|
||||||
'root'
|
|
||||||
|
|
||||||
### Highlighting Styles
|
|
||||||
|
|
||||||
Each syntax highlighter defines styles used to highlight tokens.
|
|
||||||
|
|
||||||
To highlight, for example, builtins, commands, and functions in blue instead of
|
|
||||||
green, add the following to *zpreztorc*:
|
|
||||||
|
|
||||||
zstyle ':prezto:module:syntax-highlighting' styles \
|
|
||||||
'builtin' 'bg=blue' \
|
|
||||||
'command' 'bg=blue' \
|
|
||||||
'function' 'bg=blue'
|
|
||||||
|
|
||||||
Authors
|
|
||||||
-------
|
|
||||||
|
|
||||||
*The authors of this module should be contacted via the [issue tracker][3].*
|
|
||||||
|
|
||||||
- [Sorin Ionescu](https://github.com/sorin-ionescu)
|
|
||||||
|
|
||||||
[1]: https://github.com/zsh-users/zsh-syntax-highlighting
|
|
||||||
[2]: https://github.com/zsh-users/zsh-syntax-highlighting/tree/master/highlighters
|
|
||||||
[3]: https://github.com/sorin-ionescu/prezto/issues
|
|
||||||
|
|
@ -1,45 +0,0 @@
|
|||||||
Terminal
|
|
||||||
========
|
|
||||||
|
|
||||||
Sets terminal window and tab titles.
|
|
||||||
|
|
||||||
Settings
|
|
||||||
--------
|
|
||||||
|
|
||||||
### Auto-Title
|
|
||||||
|
|
||||||
To auto set the terminal window and tab titles with the current command or
|
|
||||||
directory, add the following to *zpreztorc*:
|
|
||||||
|
|
||||||
zstyle ':prezto:module:terminal' auto-title 'yes'
|
|
||||||
|
|
||||||
Auto titling is disabled inside terminal multiplexers, except inside dvtm, since
|
|
||||||
it interferes with window names defined in configuration files and profile
|
|
||||||
managers.
|
|
||||||
|
|
||||||
To format terminal window and tab titles, add the following to *zpreztorc*:
|
|
||||||
|
|
||||||
zstyle ':prezto:module:terminal:window-title' format '%n@%m: %s'
|
|
||||||
zstyle ':prezto:module:terminal:tab-title' format '%m: %s'
|
|
||||||
|
|
||||||
`%s` will be replaced with the current working directory path or the currently
|
|
||||||
executing program name.
|
|
||||||
|
|
||||||
For a list of sequences, see [Expansion of Prompt Sequences][1].
|
|
||||||
|
|
||||||
Functions
|
|
||||||
---------
|
|
||||||
|
|
||||||
- `set-tab-title` sets the terminal tab title.
|
|
||||||
- `set-window-title` sets the terminal or terminal multiplexer window title.
|
|
||||||
|
|
||||||
Authors
|
|
||||||
-------
|
|
||||||
|
|
||||||
*The authors of this module should be contacted via the [issue tracker][2].*
|
|
||||||
|
|
||||||
- [Sorin Ionescu](https://github.com/sorin-ionescu)
|
|
||||||
|
|
||||||
[1]: http://zsh.sourceforge.net/Doc/Release/Prompt-Expansion.html#Expansion-of-Prompt-Sequences
|
|
||||||
[2]: https://github.com/sorin-ionescu/prezto/issues
|
|
||||||
|
|
@ -1,63 +0,0 @@
|
|||||||
Tmux
|
|
||||||
====
|
|
||||||
|
|
||||||
Defines [tmux][1] aliases and provides for auto launching it at start-up.
|
|
||||||
|
|
||||||
Settings
|
|
||||||
--------
|
|
||||||
|
|
||||||
### Auto-Start
|
|
||||||
|
|
||||||
Starts a tmux session automatically when Zsh is launched.
|
|
||||||
|
|
||||||
To enable this feature when launching Zsh in a local terminal, add the
|
|
||||||
following line to *zpreztorc*:
|
|
||||||
|
|
||||||
zstyle ':prezto:module:tmux:auto-start' local 'yes'
|
|
||||||
|
|
||||||
To enable this feature when launching Zsh in a SSH connection, add the
|
|
||||||
following line to *zpreztorc*:
|
|
||||||
|
|
||||||
zstyle ':prezto:module:tmux:auto-start' remote 'yes'
|
|
||||||
|
|
||||||
In both cases, it will create a background session named _#Prezto_ and attach
|
|
||||||
every new shell to it.
|
|
||||||
|
|
||||||
To avoid keeping open sessions, this module sets `destroy-unattached off` on
|
|
||||||
the background session and `destroy-unattached on` on every other session
|
|
||||||
(global setting).
|
|
||||||
|
|
||||||
Aliases
|
|
||||||
-------
|
|
||||||
|
|
||||||
- `tmuxa` attaches or switches to a tmux session.
|
|
||||||
- `tmuxl` lists sessions managed by the tmux server.
|
|
||||||
|
|
||||||
Caveats
|
|
||||||
-------
|
|
||||||
|
|
||||||
On Mac OS X, launching tmux can cause the error **launch_msg(...): Socket is not
|
|
||||||
connected** to be displayed, which can be fixed by installing
|
|
||||||
[reattach-to-user-namespace][3], available in [Homebrew][4], and adding the
|
|
||||||
following to *tmux.conf*:
|
|
||||||
|
|
||||||
set-option -g default-command "reattach-to-user-namespace -l $SHELL -l"
|
|
||||||
|
|
||||||
Furthermore, tmux is known to cause **kernel panics** on Mac OS X. A discussion
|
|
||||||
about this and Prezto has already been [opened][2].
|
|
||||||
|
|
||||||
Authors
|
|
||||||
-------
|
|
||||||
|
|
||||||
*The authors of this module should be contacted via the [issue tracker][5].*
|
|
||||||
|
|
||||||
- [Sorin Ionescu](https://github.com/sorin-ionescu)
|
|
||||||
- [Colin Hebert](https://github.com/ColinHebert)
|
|
||||||
- [Georges Discry](https://github.com/gdiscry)
|
|
||||||
|
|
||||||
[1]: http://tmux.sourceforge.net
|
|
||||||
[2]: https://github.com/sorin-ionescu/prezto/issues/62
|
|
||||||
[3]: https://github.com/ChrisJohnsen/tmux-MacOSX-pasteboard
|
|
||||||
[4]: https://github.com/mxcl/homebrew
|
|
||||||
[5]: https://github.com/sorin-ionescu/prezto/issues
|
|
||||||
|
|
@ -1,158 +0,0 @@
|
|||||||
Utility
|
|
||||||
=======
|
|
||||||
|
|
||||||
Defines general aliases and functions.
|
|
||||||
|
|
||||||
Settings
|
|
||||||
--------
|
|
||||||
|
|
||||||
### Highlighting
|
|
||||||
|
|
||||||
If you have enabled color globally in *zpreztorc*, you may disable it for certain
|
|
||||||
commands.
|
|
||||||
|
|
||||||
To disable `ls` color, add the following line to *zpreztorc*; when coloring is
|
|
||||||
disabled, type indicators (\*, /, =>, @, =, |, %) will be appended to entries.
|
|
||||||
|
|
||||||
zstyle ':prezto:module:utility:ls' color 'no'
|
|
||||||
|
|
||||||
To disable `diff` highlighting, add the following line to *zpreztorc*:
|
|
||||||
|
|
||||||
zstyle ':prezto:module:utility:diff' color 'no'
|
|
||||||
|
|
||||||
To disable `wdiff` highlighting, add the following line to *zpreztorc*:
|
|
||||||
|
|
||||||
zstyle ':prezto:module:utility:wdiff' color 'no'
|
|
||||||
|
|
||||||
To disable `make` highlighting, add the following line to *zpreztorc*:
|
|
||||||
|
|
||||||
zstyle ':prezto:module:utility:make' color 'no'
|
|
||||||
|
|
||||||
Aliases
|
|
||||||
-------
|
|
||||||
|
|
||||||
### Disabled Spelling Correction
|
|
||||||
|
|
||||||
- `ack`
|
|
||||||
- `cd`
|
|
||||||
- `cp`
|
|
||||||
- `ebuild`
|
|
||||||
- `gcc`
|
|
||||||
- `gist`
|
|
||||||
- `grep`
|
|
||||||
- `heroku`
|
|
||||||
- `ln`
|
|
||||||
- `man`
|
|
||||||
- `mkdir`
|
|
||||||
- `mv`
|
|
||||||
- `mysql`
|
|
||||||
- `rm`
|
|
||||||
|
|
||||||
### Disabled File Globbing
|
|
||||||
|
|
||||||
- `fc`
|
|
||||||
- `find`
|
|
||||||
- `ftp`
|
|
||||||
- `history`
|
|
||||||
- `locate`
|
|
||||||
- `rake`
|
|
||||||
- `rsync`
|
|
||||||
- `scp`
|
|
||||||
- `sftp`
|
|
||||||
|
|
||||||
### General
|
|
||||||
|
|
||||||
- `_` executes a command as another user (`sudo`).
|
|
||||||
- `b` opens the default web browser.
|
|
||||||
- `cp` copies files and directories interactively.
|
|
||||||
- `e` opens the default editor.
|
|
||||||
- `ln` links files and directories interactively.
|
|
||||||
- `mkdir` creates directories, including intermediary directories.
|
|
||||||
- `mv` moves files and directories interactively.
|
|
||||||
- `p` opens the default pager.
|
|
||||||
- `po` removes a directory from the stack and changes to it (`popd`).
|
|
||||||
- `pu` changes the directory and pushes the old directory onto the stack
|
|
||||||
(`pushd`).
|
|
||||||
- `rm` removes files and directories interactively.
|
|
||||||
- `type` displays all the attribute values of a shell parameter.
|
|
||||||
|
|
||||||
### Files and Directories
|
|
||||||
|
|
||||||
- `ls` lists with directories grouped first (GNU only).
|
|
||||||
- `l` lists in one column, hidden files.
|
|
||||||
- `ll` lists human readable sizes.
|
|
||||||
- `lr` lists human readable sizes, recursively.
|
|
||||||
- `la` lists human readable sizes, hidden files.
|
|
||||||
- `lm` lists human readable sizes, hidden files through pager.
|
|
||||||
- `lx` lists sorted by extension (GNU only).
|
|
||||||
- `lk` lists sorted by size, largest last.
|
|
||||||
- `lt` lists sorted by date, most recent last.
|
|
||||||
- `lc` lists sorted by date, most recent last, shows change time.
|
|
||||||
- `lu` lists sorted by date, most recent last, shows access time.
|
|
||||||
- `sl` lists directory contents (`ls`).
|
|
||||||
|
|
||||||
### Mac OS X Everywhere
|
|
||||||
|
|
||||||
- `o` opens files and directories (`open` or `xdg-open`).
|
|
||||||
- `get` downloads files (`curl` or `wget`).
|
|
||||||
- `pbcopy` copies to the pasteboard (`pbcopy`, `xclip` or `xsel`).
|
|
||||||
- `pbpaste` pastes from the pasteboard (`pbcopy`, `xclip` or `xsel`).
|
|
||||||
- `pbc` copies to the pasteboard (`pbcopy`).
|
|
||||||
- `pbp` pastes from the pasteboard (`pbpaste`).
|
|
||||||
|
|
||||||
### Resource Usage
|
|
||||||
|
|
||||||
- `df` displays free disk space using human readable units.
|
|
||||||
- `du` displays disk usage using human readable units.
|
|
||||||
- `top` displays information about processes (aliased to `htop`, if installed).
|
|
||||||
- `topc` displays information about processes sorted by CPU usage (`htop` not
|
|
||||||
installed).
|
|
||||||
- `topm` displays information about processes sorted by RAM usage (`htop` not
|
|
||||||
installed).
|
|
||||||
|
|
||||||
### Miscellaneous
|
|
||||||
|
|
||||||
- `http-serve` serves a directory via HTTP.
|
|
||||||
|
|
||||||
Functions
|
|
||||||
---------
|
|
||||||
|
|
||||||
### General
|
|
||||||
|
|
||||||
- `slit` prints columns *1, 2, 3 ... n*.
|
|
||||||
|
|
||||||
### Files and Directories
|
|
||||||
|
|
||||||
- `cdls` changes to a directory and lists its contents.
|
|
||||||
- `dut` displays the grand total disk usage using human readable units.
|
|
||||||
- `find-exec` finds files and executes a command on them.
|
|
||||||
- `mkdcd` makes a directory and changes to it.
|
|
||||||
- `popdls` pops an entry off the directory stack and lists its contents.
|
|
||||||
- `pushdls` pushes an entry onto the directory stack and lists its contents.
|
|
||||||
|
|
||||||
### Developer
|
|
||||||
|
|
||||||
- `diff` highlights diff output (requires `colordiff` or `Git`).
|
|
||||||
- `make` highlights make output (requires `colormake`).
|
|
||||||
- `wdiff` highlights wdiff output (requires `wdiff `or `Git`).
|
|
||||||
|
|
||||||
### Resource usage
|
|
||||||
|
|
||||||
- `psu` displays user owned processes status.
|
|
||||||
|
|
||||||
### Search and Replace
|
|
||||||
|
|
||||||
- `prep` provides a grep-like pattern search.
|
|
||||||
- `psub` provides a sed-like pattern substitution.
|
|
||||||
|
|
||||||
Authors
|
|
||||||
-------
|
|
||||||
|
|
||||||
*The authors of this module should be contacted via the [issue tracker][1].*
|
|
||||||
|
|
||||||
- [Robby Russell](https://github.com/robbyrussell)
|
|
||||||
- [Suraj N. Kurapati](https://github.com/sunaku)
|
|
||||||
- [Sorin Ionescu](https://github.com/sorin-ionescu)
|
|
||||||
|
|
||||||
[1]: https://github.com/sorin-ionescu/prezto/issues
|
|
||||||
|
|
@ -1,29 +0,0 @@
|
|||||||
Yum
|
|
||||||
===
|
|
||||||
|
|
||||||
Defines [yum][1] aliases.
|
|
||||||
|
|
||||||
Aliases
|
|
||||||
-------
|
|
||||||
|
|
||||||
- `yumc` removes package(s) and leaves.
|
|
||||||
- `yumi` installs package(s).
|
|
||||||
- `yumh` displays history.
|
|
||||||
- `yuml` lists packages.
|
|
||||||
- `yumL` lists installed packages.
|
|
||||||
- `yumq` displays package information.
|
|
||||||
- `yumr` removes package(s).
|
|
||||||
- `yums` searches for a package.
|
|
||||||
- `yumu` updates packages.
|
|
||||||
- `yumU` upgrates packages.
|
|
||||||
|
|
||||||
Authors
|
|
||||||
-------
|
|
||||||
|
|
||||||
*The authors of this module should be contacted via the [issue tracker][2].*
|
|
||||||
|
|
||||||
- [Sorin Ionescu](https://github.com/sorin-ionescu)
|
|
||||||
|
|
||||||
[1]: http://yum.baseurl.org
|
|
||||||
[2]: https://github.com/sorin-ionescu/prezto/issues
|
|
||||||
|
|
@ -1,151 +0,0 @@
|
|||||||
Prezto — Instantly Awesome Zsh
|
|
||||||
==============================
|
|
||||||
|
|
||||||
Prezto is the configuration framework for [Zsh][1]; it enriches the command line
|
|
||||||
interface environment with sane defaults, aliases, functions, auto completion,
|
|
||||||
and prompt themes.
|
|
||||||
|
|
||||||
Installation
|
|
||||||
------------
|
|
||||||
|
|
||||||
Prezto will work with any recent release of Zsh, but the minimum recommended
|
|
||||||
version is 4.3.10.
|
|
||||||
|
|
||||||
1. Launch Zsh:
|
|
||||||
|
|
||||||
zsh
|
|
||||||
|
|
||||||
2. Clone the repository:
|
|
||||||
|
|
||||||
git clone --recursive https://github.com/sorin-ionescu/prezto.git "${ZDOTDIR:-$HOME}/.zprezto"
|
|
||||||
|
|
||||||
3. Create a new Zsh configuration by copying the Zsh configuration files
|
|
||||||
provided:
|
|
||||||
|
|
||||||
setopt EXTENDED_GLOB
|
|
||||||
for rcfile in "${ZDOTDIR:-$HOME}"/.zprezto/runcoms/^README.md(.N); do
|
|
||||||
ln -s "$rcfile" "${ZDOTDIR:-$HOME}/.${rcfile:t}"
|
|
||||||
done
|
|
||||||
|
|
||||||
4. Set Zsh as your default shell:
|
|
||||||
|
|
||||||
chsh -s /bin/zsh
|
|
||||||
|
|
||||||
5. Open a new Zsh terminal window or tab.
|
|
||||||
|
|
||||||
### Troubleshooting
|
|
||||||
|
|
||||||
If you are not able to find certain commands after switching to *Prezto*,
|
|
||||||
modify the `PATH` variable in *~/.zshenv* then open a new Zsh terminal
|
|
||||||
window or tab.
|
|
||||||
|
|
||||||
Usage
|
|
||||||
-----
|
|
||||||
|
|
||||||
Prezto has many features disabled by default. Read the source code and
|
|
||||||
accompanying README files to learn of what is available.
|
|
||||||
|
|
||||||
### Modules
|
|
||||||
|
|
||||||
1. Browse */modules* to see what is available.
|
|
||||||
2. Load the modules you need in *~/.zpreztorc* then open a new Zsh terminal
|
|
||||||
window or tab.
|
|
||||||
|
|
||||||
### Themes
|
|
||||||
|
|
||||||
1. For a list of themes, type `prompt -l`.
|
|
||||||
2. To preview a theme, type `prompt -p name`.
|
|
||||||
3. Load the theme you like in *~/.zpreztorc* then open a new Zsh terminal
|
|
||||||
window or tab.
|
|
||||||
|
|
||||||
![sorin theme][2]
|
|
||||||
|
|
||||||
Customization
|
|
||||||
-------------
|
|
||||||
|
|
||||||
The project is managed via [Git][3]. It is highly recommended that you fork this
|
|
||||||
project; so, that you can commit your changes and push them to [GitHub][4] to
|
|
||||||
not lose them. If you do not know how to use Git, follow this [tutorial][5] and
|
|
||||||
bookmark this [reference][6].
|
|
||||||
|
|
||||||
Resources
|
|
||||||
---------
|
|
||||||
|
|
||||||
The [Zsh Reference Card][7] and the [zsh-lovers][8] man page are indispensable.
|
|
||||||
|
|
||||||
Contribute
|
|
||||||
----------
|
|
||||||
|
|
||||||
This project would not exist without all of its users and [contributors][9].
|
|
||||||
|
|
||||||
If you have ideas on how to make the configuration easier to maintain or
|
|
||||||
improve its performance, do not hesitate to fork and send pull requests.
|
|
||||||
|
|
||||||
### Issue Reporting
|
|
||||||
|
|
||||||
- Check that the issue has not already been reported.
|
|
||||||
- Check that the issue has not already been fixed in the latest code.
|
|
||||||
- Open an issue with a clear title and description in grammatically correct,
|
|
||||||
complete sentences.
|
|
||||||
|
|
||||||
### Pull Request
|
|
||||||
|
|
||||||
- Read [how to properly contribute to open source projects on GitHub][10].
|
|
||||||
- Use a topic branch to easily amend a pull request later, if necessary.
|
|
||||||
- Write [good commit messages][11].
|
|
||||||
- Squash commits on the topic branch before opening a pull request.
|
|
||||||
- Use the same coding style and spacing.
|
|
||||||
- Open a [pull request][12] that relates to but one subject with a clear
|
|
||||||
title and description in grammatically correct, complete sentences.
|
|
||||||
|
|
||||||
#### Modules
|
|
||||||
|
|
||||||
- Markdown and man page documentation must be present.
|
|
||||||
- Large functions must be placed in a *functions* directory.
|
|
||||||
- Functions that take arguments must have completion.
|
|
||||||
|
|
||||||
#### Themes
|
|
||||||
|
|
||||||
- A screenshots section must be present in the file header.
|
|
||||||
- The pull request description must have [embedded
|
|
||||||
screenshots][13].
|
|
||||||
|
|
||||||
License
|
|
||||||
-------
|
|
||||||
|
|
||||||
(The MIT License)
|
|
||||||
|
|
||||||
Copyright (c) 2009-2012 Robby Russell, Sorin Ionescu, and contributors.
|
|
||||||
|
|
||||||
Permission is hereby granted, free of charge, to any person obtaining a copy of
|
|
||||||
this software and associated documentation files (the "Software"), to deal in
|
|
||||||
the Software without restriction, including without limitation the rights to
|
|
||||||
use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
|
|
||||||
of the Software, and to permit persons to whom the Software is furnished to do
|
|
||||||
so, subject to the following conditions:
|
|
||||||
|
|
||||||
The above copyright notice and this permission notice shall be included in all
|
|
||||||
copies or substantial portions of the Software.
|
|
||||||
|
|
||||||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
||||||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
||||||
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
||||||
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
||||||
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
||||||
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
||||||
SOFTWARE.
|
|
||||||
|
|
||||||
[1]: http://www.zsh.org
|
|
||||||
[2]: http://i.imgur.com/nBEEZ.png "sorin theme"
|
|
||||||
[3]: http://git-scm.com
|
|
||||||
[4]: https://github.com
|
|
||||||
[5]: http://gitimmersion.com
|
|
||||||
[6]: http://gitref.org
|
|
||||||
[7]: http://www.bash2zsh.com/zsh_refcard/refcard.pdf
|
|
||||||
[8]: http://grml.org/zsh/zsh-lovers.html
|
|
||||||
[9]: https://github.com/sorin-ionescu/prezto/contributors
|
|
||||||
[10]: http://gun.io/blog/how-to-github-fork-branch-and-pull-request
|
|
||||||
[11]: http://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html
|
|
||||||
[12]: https://help.github.com/articles/using-pull-requests
|
|
||||||
[13]: http://daringfireball.net/projects/markdown/syntax#img
|
|
||||||
|
|
117
init.zsh
117
init.zsh
@ -12,11 +12,60 @@
|
|||||||
# Check for the minimum supported version.
|
# Check for the minimum supported version.
|
||||||
min_zsh_version='4.3.11'
|
min_zsh_version='4.3.11'
|
||||||
if ! autoload -Uz is-at-least || ! is-at-least "$min_zsh_version"; then
|
if ! autoload -Uz is-at-least || ! is-at-least "$min_zsh_version"; then
|
||||||
print "prezto: old shell detected, minimum required: $min_zsh_version" >&2
|
printf "prezto: old shell detected, minimum required: %s\n" "$min_zsh_version" >&2
|
||||||
return 1
|
return 1
|
||||||
fi
|
fi
|
||||||
unset min_zsh_version
|
unset min_zsh_version
|
||||||
|
|
||||||
|
# zprezto convenience updater
|
||||||
|
# The function is surrounded by ( ) instead of { } so it starts in a subshell
|
||||||
|
# and won't affect the environment of the calling shell
|
||||||
|
function zprezto-update {
|
||||||
|
(
|
||||||
|
function cannot-fast-forward {
|
||||||
|
local STATUS="$1"
|
||||||
|
[[ -n "${STATUS}" ]] && printf "%s\n" "${STATUS}"
|
||||||
|
printf "Unable to fast-forward the changes. You can fix this by "
|
||||||
|
printf "running\ncd '%s' and then\n'git pull' " "${ZPREZTODIR}"
|
||||||
|
printf "to manually pull and possibly merge in changes\n"
|
||||||
|
}
|
||||||
|
cd -q -- "${ZPREZTODIR}" || return 7
|
||||||
|
local orig_branch="$(git symbolic-ref HEAD 2> /dev/null | cut -d '/' -f 3)"
|
||||||
|
if [[ "$orig_branch" == "master" ]]; then
|
||||||
|
git fetch || return "$?"
|
||||||
|
local UPSTREAM=$(git rev-parse '@{u}')
|
||||||
|
local LOCAL=$(git rev-parse HEAD)
|
||||||
|
local REMOTE=$(git rev-parse "$UPSTREAM")
|
||||||
|
local BASE=$(git merge-base HEAD "$UPSTREAM")
|
||||||
|
if [[ $LOCAL == $REMOTE ]]; then
|
||||||
|
printf "There are no updates.\n"
|
||||||
|
return 0
|
||||||
|
elif [[ $LOCAL == $BASE ]]; then
|
||||||
|
printf "There is an update available. Trying to pull.\n\n"
|
||||||
|
if git pull --ff-only; then
|
||||||
|
printf "Syncing submodules\n"
|
||||||
|
git submodule sync --recursive
|
||||||
|
git submodule update --init --recursive
|
||||||
|
return $?
|
||||||
|
else
|
||||||
|
cannot-fast-forward
|
||||||
|
return 1
|
||||||
|
fi
|
||||||
|
elif [[ $REMOTE == $BASE ]]; then
|
||||||
|
cannot-fast-forward "Commits in master that aren't in upstream."
|
||||||
|
return 1
|
||||||
|
else
|
||||||
|
cannot-fast-forward "Upstream and local have diverged."
|
||||||
|
return 1
|
||||||
|
fi
|
||||||
|
else
|
||||||
|
printf "zprezto install at '%s' is not on the master branch " "${ZPREZTODIR}"
|
||||||
|
printf "(you're on '%s')\nUnable to automatically update.\n" "${orig_branch}"
|
||||||
|
return 1
|
||||||
|
fi
|
||||||
|
return 1
|
||||||
|
)
|
||||||
|
}
|
||||||
#
|
#
|
||||||
# Module Loader
|
# Module Loader
|
||||||
#
|
#
|
||||||
@ -24,14 +73,46 @@ unset min_zsh_version
|
|||||||
# Loads Prezto modules.
|
# Loads Prezto modules.
|
||||||
function pmodload {
|
function pmodload {
|
||||||
local -a pmodules
|
local -a pmodules
|
||||||
|
local -a pmodule_dirs
|
||||||
|
local -a locations
|
||||||
local pmodule
|
local pmodule
|
||||||
local pfunction_glob='^([_.]*|prompt_*_setup|README*)(.N:t)'
|
local pmodule_location
|
||||||
|
local pfunction_glob='^([_.]*|prompt_*_setup|README*|*~)(-.N:t)'
|
||||||
|
|
||||||
|
# Load in any additional directories and warn if they don't exist
|
||||||
|
zstyle -a ':prezto:load' pmodule-dirs 'user_pmodule_dirs'
|
||||||
|
for user_dir in "$user_pmodule_dirs[@]"; do
|
||||||
|
if [[ ! -d "$user_dir" ]]; then
|
||||||
|
echo "$0: Missing user module dir: $user_dir"
|
||||||
|
fi
|
||||||
|
done
|
||||||
|
|
||||||
|
pmodule_dirs=("$ZPREZTODIR/modules" "$ZPREZTODIR/contrib" "$user_pmodule_dirs[@]")
|
||||||
|
|
||||||
# $argv is overridden in the anonymous function.
|
# $argv is overridden in the anonymous function.
|
||||||
pmodules=("$argv[@]")
|
pmodules=("$argv[@]")
|
||||||
|
|
||||||
|
# Load Prezto modules.
|
||||||
|
for pmodule in "$pmodules[@]"; do
|
||||||
|
if zstyle -t ":prezto:module:$pmodule" loaded 'yes' 'no'; then
|
||||||
|
continue
|
||||||
|
else
|
||||||
|
locations=(${pmodule_dirs:+${^pmodule_dirs}/$pmodule(-/FN)})
|
||||||
|
if (( ${#locations} > 1 )); then
|
||||||
|
if ! zstyle -t ':prezto:load' pmodule-allow-overrides 'yes'; then
|
||||||
|
print "$0: conflicting module locations: $locations"
|
||||||
|
continue
|
||||||
|
fi
|
||||||
|
elif (( ${#locations} < 1 )); then
|
||||||
|
print "$0: no such module: $pmodule"
|
||||||
|
continue
|
||||||
|
fi
|
||||||
|
|
||||||
|
# Grab the full path to this module
|
||||||
|
pmodule_location=${locations[-1]}
|
||||||
|
|
||||||
# Add functions to $fpath.
|
# Add functions to $fpath.
|
||||||
fpath=(${pmodules:+${ZDOTDIR:-$HOME}/.zprezto/modules/${^pmodules}/functions(/FN)} $fpath)
|
fpath=(${pmodule_location}/functions(-/FN) $fpath)
|
||||||
|
|
||||||
function {
|
function {
|
||||||
local pfunction
|
local pfunction
|
||||||
@ -40,28 +121,22 @@ function pmodload {
|
|||||||
setopt LOCAL_OPTIONS EXTENDED_GLOB
|
setopt LOCAL_OPTIONS EXTENDED_GLOB
|
||||||
|
|
||||||
# Load Prezto functions.
|
# Load Prezto functions.
|
||||||
for pfunction in ${ZDOTDIR:-$HOME}/.zprezto/modules/${^pmodules}/functions/$~pfunction_glob; do
|
for pfunction in ${pmodule_location}/functions/$~pfunction_glob; do
|
||||||
autoload -Uz "$pfunction"
|
autoload -Uz "$pfunction"
|
||||||
done
|
done
|
||||||
}
|
}
|
||||||
|
|
||||||
# Load Prezto modules.
|
if [[ -s "${pmodule_location}/init.zsh" ]]; then
|
||||||
for pmodule in "$pmodules[@]"; do
|
source "${pmodule_location}/init.zsh"
|
||||||
if zstyle -t ":prezto:module:$pmodule" loaded 'yes' 'no'; then
|
elif [[ -s "${pmodule_location}/${pmodule}.plugin.zsh" ]]; then
|
||||||
continue
|
source "${pmodule_location}/${pmodule}.plugin.zsh"
|
||||||
elif [[ ! -d "${ZDOTDIR:-$HOME}/.zprezto/modules/$pmodule" ]]; then
|
|
||||||
print "$0: no such module: $pmodule" >&2
|
|
||||||
continue
|
|
||||||
else
|
|
||||||
if [[ -s "${ZDOTDIR:-$HOME}/.zprezto/modules/$pmodule/init.zsh" ]]; then
|
|
||||||
source "${ZDOTDIR:-$HOME}/.zprezto/modules/$pmodule/init.zsh"
|
|
||||||
fi
|
fi
|
||||||
|
|
||||||
if (( $? == 0 )); then
|
if (( $? == 0 )); then
|
||||||
zstyle ":prezto:module:$pmodule" loaded 'yes'
|
zstyle ":prezto:module:$pmodule" loaded 'yes'
|
||||||
else
|
else
|
||||||
# Remove the $fpath entry.
|
# Remove the $fpath entry.
|
||||||
fpath[(r)${ZDOTDIR:-$HOME}/.zprezto/modules/${pmodule}/functions]=()
|
fpath[(r)${pmodule_location}/functions]=()
|
||||||
|
|
||||||
function {
|
function {
|
||||||
local pfunction
|
local pfunction
|
||||||
@ -71,7 +146,7 @@ function pmodload {
|
|||||||
setopt LOCAL_OPTIONS EXTENDED_GLOB
|
setopt LOCAL_OPTIONS EXTENDED_GLOB
|
||||||
|
|
||||||
# Unload Prezto functions.
|
# Unload Prezto functions.
|
||||||
for pfunction in ${ZDOTDIR:-$HOME}/.zprezto/modules/$pmodule/functions/$~pfunction_glob; do
|
for pfunction in ${pmodule_location}/functions/$~pfunction_glob; do
|
||||||
unfunction "$pfunction"
|
unfunction "$pfunction"
|
||||||
done
|
done
|
||||||
}
|
}
|
||||||
@ -86,6 +161,12 @@ function pmodload {
|
|||||||
# Prezto Initialization
|
# Prezto Initialization
|
||||||
#
|
#
|
||||||
|
|
||||||
|
# This finds the directory prezto is installed to so plugin managers don't need
|
||||||
|
# to rely on dirty hacks to force prezto into a directory. Additionally, it
|
||||||
|
# needs to be done here because inside the pmodload function ${0:h} evaluates to
|
||||||
|
# the current directory of the shell rather than the prezto dir.
|
||||||
|
ZPREZTODIR=${0:h}
|
||||||
|
|
||||||
# Source the Prezto configuration file.
|
# Source the Prezto configuration file.
|
||||||
if [[ -s "${ZDOTDIR:-$HOME}/.zpreztorc" ]]; then
|
if [[ -s "${ZDOTDIR:-$HOME}/.zpreztorc" ]]; then
|
||||||
source "${ZDOTDIR:-$HOME}/.zpreztorc"
|
source "${ZDOTDIR:-$HOME}/.zpreztorc"
|
||||||
@ -102,6 +183,9 @@ zstyle -a ':prezto:load' zmodule 'zmodules'
|
|||||||
for zmodule ("$zmodules[@]") zmodload "zsh/${(z)zmodule}"
|
for zmodule ("$zmodules[@]") zmodload "zsh/${(z)zmodule}"
|
||||||
unset zmodule{s,}
|
unset zmodule{s,}
|
||||||
|
|
||||||
|
# Load more specific 'run-help' function from $fpath.
|
||||||
|
(( $+aliases[run-help] )) && unalias run-help && autoload -Uz run-help
|
||||||
|
|
||||||
# Autoload Zsh functions.
|
# Autoload Zsh functions.
|
||||||
zstyle -a ':prezto:load' zfunction 'zfunctions'
|
zstyle -a ':prezto:load' zfunction 'zfunctions'
|
||||||
for zfunction ("$zfunctions[@]") autoload -Uz "$zfunction"
|
for zfunction ("$zfunctions[@]") autoload -Uz "$zfunction"
|
||||||
@ -111,4 +195,3 @@ unset zfunction{s,}
|
|||||||
zstyle -a ':prezto:load' pmodule 'pmodules'
|
zstyle -a ':prezto:load' pmodule 'pmodules'
|
||||||
pmodload "$pmodules[@]"
|
pmodload "$pmodules[@]"
|
||||||
unset pmodules
|
unset pmodules
|
||||||
|
|
||||||
|
@ -1,195 +1,166 @@
|
|||||||
Modules
|
# Modules
|
||||||
=======
|
|
||||||
|
|
||||||
Load modules in *zpreztorc*. The order matters.
|
Load modules in _`${ZDOTDIR:-$HOME}/.zpreztorc`_. The order matters.
|
||||||
|
|
||||||
|
```sh
|
||||||
zstyle ':prezto:load' pmodule 'environment' 'terminal'
|
zstyle ':prezto:load' pmodule 'environment' 'terminal'
|
||||||
|
```
|
||||||
|
|
||||||
Archive
|
## Archive
|
||||||
-------
|
|
||||||
|
|
||||||
Provides functions to list and extract archives.
|
Provides functions to list and extract archives.
|
||||||
|
|
||||||
Command-Not-Found
|
## Autosuggestions
|
||||||
-----------------
|
|
||||||
|
|
||||||
Loads the command-not-found tool on Debian-based distributions.
|
Integrates zsh-autosuggestions into Prezto.
|
||||||
|
|
||||||
Completion
|
## Command-Not-Found
|
||||||
----------
|
|
||||||
|
|
||||||
Loads and configures tab completion and provides additional completions from
|
Loads the command-not-found tool on macOS or Debian-based distributions.
|
||||||
the zsh-completions project.
|
|
||||||
|
|
||||||
Directory
|
## Completion
|
||||||
---------
|
|
||||||
|
Loads and configures <kbd>TAB</kbd> completion and provides additional
|
||||||
|
completions from the zsh-completions project.
|
||||||
|
|
||||||
|
## Directory
|
||||||
|
|
||||||
Sets directory options and defines directory aliases.
|
Sets directory options and defines directory aliases.
|
||||||
|
|
||||||
Dpkg
|
## DNF
|
||||||
----
|
|
||||||
|
|
||||||
Defines dpkg aliases and functions.
|
Defines _dnf_ aliases.
|
||||||
|
|
||||||
Editor
|
## Dpkg
|
||||||
------
|
|
||||||
|
Defines _dpkg_ aliases and functions.
|
||||||
|
|
||||||
|
## Editor
|
||||||
|
|
||||||
Sets key bindings.
|
Sets key bindings.
|
||||||
|
|
||||||
Emacs
|
## Emacs
|
||||||
-----
|
|
||||||
|
|
||||||
Enables Emacs dependency management.
|
Enables Emacs dependency management.
|
||||||
|
|
||||||
Environment
|
## Environment
|
||||||
-----------
|
|
||||||
|
|
||||||
Sets general shell options and defines environment variables.
|
Sets general shell options and defines environment variables.
|
||||||
|
|
||||||
Fasd
|
## Fasd
|
||||||
----
|
|
||||||
|
|
||||||
Maintains a frequently used file and directory list for fast access.
|
Maintains a frequently used file and directory list for fast access.
|
||||||
|
|
||||||
Git
|
## Git
|
||||||
---
|
|
||||||
|
|
||||||
Enhances the Git distributed version control system by providing aliases,
|
Enhances the Git distributed version control system by providing aliases,
|
||||||
functions and by exposing repository status information to prompts.
|
functions and by exposing repository status information to prompts.
|
||||||
|
|
||||||
GNU Utility
|
## GNU Utility
|
||||||
-----------
|
|
||||||
|
|
||||||
Provides for the interactive use of GNU utilities on non-GNU systems.
|
Provides for the interactive use of GNU utilities on non-GNU systems.
|
||||||
|
|
||||||
GPG
|
## GPG
|
||||||
---
|
|
||||||
|
|
||||||
Provides for an easier use of GPG by setting up gpg-agent.
|
Provides for an easier use of GPG by setting up gpg-agent.
|
||||||
|
|
||||||
Haskell
|
## Haskell
|
||||||
-------
|
|
||||||
|
|
||||||
Enables local Haskell package installation.
|
Enables local Haskell package installation.
|
||||||
|
|
||||||
Helper
|
## Helper
|
||||||
------
|
|
||||||
|
|
||||||
Provides helper functions for developing modules.
|
Provides helper functions for developing modules.
|
||||||
|
|
||||||
History
|
## History
|
||||||
-------
|
|
||||||
|
|
||||||
Sets history options and defines history aliases.
|
Sets history options and defines history aliases.
|
||||||
|
|
||||||
History Substring Search
|
## History Substring Search
|
||||||
------------------------
|
|
||||||
|
|
||||||
Integrates zsh-history-substring-search into Prezto.
|
Integrates zsh-history-substring-search into Prezto.
|
||||||
|
|
||||||
Homebrew
|
## Homebrew
|
||||||
--------
|
|
||||||
|
|
||||||
Defines Homebrew aliases.
|
Defines Homebrew aliases.
|
||||||
|
|
||||||
Macports
|
## MacPorts
|
||||||
--------
|
|
||||||
|
|
||||||
Defines MacPorts aliases and adds MacPorts directories to path variables.
|
Defines MacPorts aliases and adds MacPorts directories to path variables.
|
||||||
|
|
||||||
Node.js
|
## Node.js
|
||||||
-------
|
|
||||||
|
|
||||||
Provides utility functions for Node.js and loads npm completion.
|
Provides utility functions for Node.js and loads npm completion.
|
||||||
|
|
||||||
Ocaml
|
## OCaml
|
||||||
-----
|
|
||||||
|
|
||||||
Initializes Ocaml package management.
|
Initializes OCaml package management.
|
||||||
|
|
||||||
OSX
|
## OSX
|
||||||
---
|
|
||||||
|
|
||||||
Defines Mac OS X aliases and functions.
|
Defines macOS aliases and functions.
|
||||||
|
|
||||||
Pacman
|
## Pacman
|
||||||
------
|
|
||||||
|
|
||||||
Provides aliases and functions for the Pacman package manager and frontends.
|
Provides aliases and functions for the Pacman package manager and frontends.
|
||||||
|
|
||||||
Perl
|
## Perl
|
||||||
----
|
|
||||||
|
|
||||||
Enables local Perl module installation on Mac OS X and defines alises.
|
Enables local Perl module installation on macOS and defines alises.
|
||||||
|
|
||||||
Prompt
|
## Prompt
|
||||||
------
|
|
||||||
|
|
||||||
Loads prompt themes.
|
Loads prompt themes.
|
||||||
|
|
||||||
Python
|
## Python
|
||||||
------
|
|
||||||
|
|
||||||
Enables local Python and local Python package installation.
|
Enables local Python and local Python package installation.
|
||||||
|
|
||||||
Ruby on Rails
|
## Ruby on Rails
|
||||||
-------------
|
|
||||||
|
|
||||||
Defines Ruby on Rails aliases.
|
Defines Ruby on Rails aliases.
|
||||||
|
|
||||||
Rsync
|
## Rsync
|
||||||
-----
|
|
||||||
|
|
||||||
Defines rsync aliases.
|
Defines rsync aliases.
|
||||||
|
|
||||||
Ruby
|
## Ruby
|
||||||
----
|
|
||||||
|
|
||||||
Configures Ruby local gem installation, loads version managers, and defines
|
Configures Ruby local gem installation, loads version managers, and defines
|
||||||
aliases.
|
aliases.
|
||||||
|
|
||||||
GNU Screen
|
## GNU Screen
|
||||||
----------
|
|
||||||
|
|
||||||
Defines GNU Screen aliases and provides for auto launching it at start-up.
|
Defines GNU Screen aliases and provides for auto launching it at start-up.
|
||||||
|
|
||||||
Spectrum
|
## Spectrum
|
||||||
--------
|
|
||||||
|
|
||||||
Provides for easier use of 256 colors and effects.
|
Provides for easier use of 256 colors and effects.
|
||||||
|
|
||||||
SSH
|
## SSH
|
||||||
---
|
|
||||||
|
|
||||||
Provides for an easier use of SSH by setting up ssh-agent.
|
Provides for an easier use of SSH by setting up ssh-agent.
|
||||||
|
|
||||||
Syntax Highlighting
|
## Syntax Highlighting
|
||||||
-------------------
|
|
||||||
|
|
||||||
Integrates zsh-syntax-highlighting into Prezto.
|
Integrates zsh-syntax-highlighting into Prezto.
|
||||||
|
|
||||||
Terminal
|
## Terminal
|
||||||
--------
|
|
||||||
|
|
||||||
Sets terminal window and tab titles.
|
Sets terminal window and tab titles.
|
||||||
|
|
||||||
Tmux
|
## Tmux
|
||||||
----
|
|
||||||
|
|
||||||
Defines tmux aliases and provides for auto launching it at start-up.
|
Defines tmux aliases and provides for auto launching it at start-up.
|
||||||
|
|
||||||
Utility
|
## Utility
|
||||||
-------
|
|
||||||
|
|
||||||
Defines general aliases and functions.
|
Defines general aliases and functions.
|
||||||
|
|
||||||
Wake-on-LAN
|
## Wake-on-LAN
|
||||||
-----------
|
|
||||||
|
|
||||||
This module provides a wrapper around the wakeonlan tool.
|
This module provides a wrapper around the wakeonlan tool.
|
||||||
|
|
||||||
Yum
|
## Yum
|
||||||
---
|
|
||||||
|
|
||||||
Defines yum aliases.
|
Defines yum aliases.
|
||||||
|
|
53
modules/archive/README.md
Normal file
53
modules/archive/README.md
Normal file
@ -0,0 +1,53 @@
|
|||||||
|
# Archive
|
||||||
|
|
||||||
|
Provides functions to create, list, and extract archives.
|
||||||
|
|
||||||
|
This module must be loaded _before_ the [_`completion`_][1] module so that the
|
||||||
|
provided completion definitions are loaded automatically by _`completion`_
|
||||||
|
module.
|
||||||
|
|
||||||
|
## Functions
|
||||||
|
|
||||||
|
- `archive` creates an archive based on the provided archive name.
|
||||||
|
- `lsarchive` lists the contents of one or more archives.
|
||||||
|
- `unarchive` extracts the contents of one or more archives.
|
||||||
|
|
||||||
|
## Supported Formats
|
||||||
|
|
||||||
|
The following archive formats are supported when the required utilities are
|
||||||
|
installed:
|
||||||
|
|
||||||
|
- _.tar.gz_, _.tgz_ require `tar` (optionally `pigz`).
|
||||||
|
- _.tar.bz2_, _.tbz_ require `tar` (optionally `pbzip2`).
|
||||||
|
- _.tar.xz_, _.txz_ require `tar` with _xz_ support.
|
||||||
|
- _.tar.zma_, _.tlz_ require `tar` with _lzma_ support.
|
||||||
|
- _.tar_ requires `tar`.
|
||||||
|
- _.gz_ requires `gunzip`.
|
||||||
|
- _.bz2_ requires `bunzip2`.
|
||||||
|
- _.xz_ requires `unxz`.
|
||||||
|
- _.lzma_ requires `unlzma`.
|
||||||
|
- _.Z_ requires `uncompress`.
|
||||||
|
- _.zip_, _.jar_ requires `unzip`.
|
||||||
|
- _.rar_ requires `rar` (needed for `archive` support), `unrar` or `lsar` and `unar`.
|
||||||
|
- _.7z_ requires `7za`.
|
||||||
|
- _.deb_ requires `ar`, `tar`.
|
||||||
|
|
||||||
|
Additionally, if `pigz` and/or `pbzip2` are installed, `archive` will use them
|
||||||
|
over their traditional counterparts, `gzip` and `bzip2` respectively, to take
|
||||||
|
full advantage of all available CPU cores for compression.
|
||||||
|
|
||||||
|
## Alternatives
|
||||||
|
|
||||||
|
Specifically on macOS, [The Unarchiver][2] provides a similar command line tool
|
||||||
|
which doesn't depend on a number of other programs being installed.
|
||||||
|
|
||||||
|
## Authors
|
||||||
|
|
||||||
|
_The authors of this module should be contacted via the [issue tracker][3]._
|
||||||
|
|
||||||
|
- [Sorin Ionescu](https://github.com/sorin-ionescu)
|
||||||
|
- [Matt Hamilton](https://github.com/Eriner)
|
||||||
|
|
||||||
|
[1]: ../completion#readme
|
||||||
|
[2]: https://theunarchiver.com/command-line
|
||||||
|
[3]: https://github.com/sorin-ionescu/prezto/issues
|
@ -10,5 +10,4 @@
|
|||||||
|
|
||||||
_arguments \
|
_arguments \
|
||||||
'(-v --verbose)'{-v,--remove}'[verbose archive listing]' \
|
'(-v --verbose)'{-v,--remove}'[verbose archive listing]' \
|
||||||
"*::archive file:_files -g '(#i)*.(tar|tgz|tbz|tbz2|txz|tlz|gz|bz2|xz|lzma|Z|zip|rar|7z)(-.)'" && return 0
|
"*::archive file:_files -g '(#i)*.(tar|tgz|tbz|tbz2|txz|tlz|gz|bz2|xz|lzma|Z|zip|zst|jar|rar|7z)(-.)'" && return 0
|
||||||
|
|
||||||
|
@ -10,5 +10,4 @@
|
|||||||
|
|
||||||
_arguments \
|
_arguments \
|
||||||
'(-r --remove)'{-r,--remove}'[remove archive]' \
|
'(-r --remove)'{-r,--remove}'[remove archive]' \
|
||||||
"*::archive file:_files -g '(#i)*.(tar|tgz|tbz|tbz2|txz|tlz|gz|bz2|xz|lzma|Z|zip|rar|7z|deb)(-.)'" && return 0
|
"*::archive file:_files -g '(#i)*.(tar|tgz|tbz|tbz2|txz|tlz|gz|bz2|xz|lzma|Z|zip|zst|jar|rar|7z|deb)(-.)'" && return 0
|
||||||
|
|
||||||
|
75
modules/archive/functions/archive
Normal file
75
modules/archive/functions/archive
Normal file
@ -0,0 +1,75 @@
|
|||||||
|
#
|
||||||
|
# Creates archive file
|
||||||
|
#
|
||||||
|
# Authors:
|
||||||
|
# Matt Hamilton <m@tthamilton.com>
|
||||||
|
#
|
||||||
|
|
||||||
|
# function archive {
|
||||||
|
|
||||||
|
local archive_name path_to_archive _gzip_bin _bzip2_bin _xz_bin _zstd_bin
|
||||||
|
|
||||||
|
if (( $# < 2 )); then
|
||||||
|
cat >&2 <<EOF
|
||||||
|
usage: $0 [archive_name.zip] [/path/to/include/into/archive ...]
|
||||||
|
|
||||||
|
Where 'archive.zip' uses any of the following extensions:
|
||||||
|
|
||||||
|
.tar.gz, .tar.bz2, .tar.xz, .tar.lzma, .tar.zst, .tar, .zip, .rar, .7z
|
||||||
|
|
||||||
|
There is no '-v' switch; all operations are verbose.
|
||||||
|
EOF
|
||||||
|
return 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
# we are quitting (above) if there are not exactly 2 vars,
|
||||||
|
# so we don't need any argc check here.
|
||||||
|
|
||||||
|
# strip the path, just in case one is provided for some reason
|
||||||
|
archive_name="${1:t}"
|
||||||
|
# let paths be handled by actual archive helper
|
||||||
|
path_to_archive="${@:2}"
|
||||||
|
|
||||||
|
# here, we check for dropin/multi-threaded replacements
|
||||||
|
# this should eventually be moved to modules/archive/init.zsh
|
||||||
|
# as a global alias
|
||||||
|
if (( $+commands[pigz] )); then
|
||||||
|
_gzip_bin='pigz'
|
||||||
|
else
|
||||||
|
_gzip_bin='gzip'
|
||||||
|
fi
|
||||||
|
|
||||||
|
if (( $+commands[pixz] )); then
|
||||||
|
_xz_bin='pixz'
|
||||||
|
else
|
||||||
|
_xz_bin='xz'
|
||||||
|
fi
|
||||||
|
|
||||||
|
if (( $+commands[lbzip2] )); then
|
||||||
|
_bzip2_bin='lbzip2'
|
||||||
|
elif (( $+commands[pbzip2] )); then
|
||||||
|
_bzip2_bin='pbzip2'
|
||||||
|
else
|
||||||
|
_bzip2_bin='bzip2'
|
||||||
|
fi
|
||||||
|
|
||||||
|
_zstd_bin='zstd'
|
||||||
|
|
||||||
|
case "${archive_name}" in
|
||||||
|
(*.tar.gz|*.tgz) tar -cvf "${archive_name}" --use-compress-program="${_gzip_bin}" "${=path_to_archive}" ;;
|
||||||
|
(*.tar.bz2|*.tbz|*.tbz2) tar -cvf "${archive_name}" --use-compress-program="${_bzip2_bin}" "${=path_to_archive}" ;;
|
||||||
|
(*.tar.xz|*.txz) tar -cvf "${archive_name}" --use-compress-program="${_xz_bin}" "${=path_to_archive}" ;;
|
||||||
|
(*.tar.lzma|*.tlz) tar -cvf "${archive_name}" --lzma "${=path_to_archive}" ;;
|
||||||
|
(*.tar.zst|*.tzst) tar -cvf "${archive_name}" --use-compress-program="${_zstd_bin}" "${=path_to_archive}" ;;
|
||||||
|
(*.tar) tar -cvf "${archive_name}" "${=path_to_archive}" ;;
|
||||||
|
(*.zip|*.jar) zip -r "${archive_name}" "${=path_to_archive}" ;;
|
||||||
|
(*.rar) rar a "${archive_name}" "${=path_to_archive}" ;;
|
||||||
|
(*.7z) 7za a "${archive_name}" "${=path_to_archive}" ;;
|
||||||
|
(*.gz) print "\n.gz is only useful for single files, and does not capture permissions. Use .tar.gz" ;;
|
||||||
|
(*.bz2) print "\n.bzip2 is only useful for single files, and does not capture permissions. Use .tar.bz2" ;;
|
||||||
|
(*.xz) print "\n.xz is only useful for single files, and does not capture permissions. Use .tar.xz" ;;
|
||||||
|
(*.lzma) print "\n.lzma is only useful for single files, and does not capture permissions. Use .tar.lzma" ;;
|
||||||
|
(*) print "\nunknown archive type for archive: ${archive_name}" ;;
|
||||||
|
esac
|
||||||
|
|
||||||
|
# }
|
@ -5,6 +5,8 @@
|
|||||||
# Sorin Ionescu <sorin.ionescu@gmail.com>
|
# Sorin Ionescu <sorin.ionescu@gmail.com>
|
||||||
#
|
#
|
||||||
|
|
||||||
|
# function lsarchive {
|
||||||
|
|
||||||
local verbose
|
local verbose
|
||||||
|
|
||||||
if (( $# == 0 )); then
|
if (( $# == 0 )); then
|
||||||
@ -30,7 +32,7 @@ while (( $# > 0 )); do
|
|||||||
continue
|
continue
|
||||||
fi
|
fi
|
||||||
|
|
||||||
case "$1" in
|
case "$1:l" in
|
||||||
(*.tar.gz|*.tgz) tar t${verbose:+v}vzf "$1" ;;
|
(*.tar.gz|*.tgz) tar t${verbose:+v}vzf "$1" ;;
|
||||||
(*.tar.bz2|*.tbz|*.tbz2) tar t${verbose:+v}jf "$1" ;;
|
(*.tar.bz2|*.tbz|*.tbz2) tar t${verbose:+v}jf "$1" ;;
|
||||||
(*.tar.xz|*.txz) tar --xz --help &> /dev/null \
|
(*.tar.xz|*.txz) tar --xz --help &> /dev/null \
|
||||||
@ -39,11 +41,14 @@ while (( $# > 0 )); do
|
|||||||
(*.tar.zma|*.tlz) tar --lzma --help &> /dev/null \
|
(*.tar.zma|*.tlz) tar --lzma --help &> /dev/null \
|
||||||
&& tar --lzma -t${verbose:+v}f "$1" \
|
&& tar --lzma -t${verbose:+v}f "$1" \
|
||||||
|| lzcat "$1" | tar x${verbose:+v}f - ;;
|
|| lzcat "$1" | tar x${verbose:+v}f - ;;
|
||||||
|
(*.tar.zst|*.tzst) tar -I zstd -t${verbose:+v}f "$1" ;;
|
||||||
(*.tar) tar t${verbose:+v}f "$1" ;;
|
(*.tar) tar t${verbose:+v}f "$1" ;;
|
||||||
(*.zip) unzip -l${verbose:+v} "$1" ;;
|
(*.zip|*.jar) unzip -l${verbose:+v} "$1" ;;
|
||||||
(*.rar) unrar &> /dev/null \
|
(*.rar) ( (( $+commands[unrar] )) \
|
||||||
&& unrar ${${verbose:+v}:-l} "$1" \
|
&& unrar ${${verbose:+v}:-l} "$1" ) \
|
||||||
|| rar ${${verbose:+v}:-l} "$1" ;;
|
|| ( (( $+commands[rar] )) \
|
||||||
|
&& rar ${${verbose:+v}:-l} "$1" ) \
|
||||||
|
|| lsar ${verbose:+-l} "$1" ;;
|
||||||
(*.7z) 7za l "$1" ;;
|
(*.7z) 7za l "$1" ;;
|
||||||
(*)
|
(*)
|
||||||
print "$0: cannot list: $1" >&2
|
print "$0: cannot list: $1" >&2
|
||||||
@ -54,3 +59,4 @@ while (( $# > 0 )); do
|
|||||||
shift
|
shift
|
||||||
done
|
done
|
||||||
|
|
||||||
|
# }
|
||||||
|
@ -5,10 +5,14 @@
|
|||||||
# Sorin Ionescu <sorin.ionescu@gmail.com>
|
# Sorin Ionescu <sorin.ionescu@gmail.com>
|
||||||
#
|
#
|
||||||
|
|
||||||
|
# function unarchive {
|
||||||
|
|
||||||
local remove_archive
|
local remove_archive
|
||||||
local success
|
local success
|
||||||
local file_name
|
local file_name
|
||||||
|
local file_path
|
||||||
local extract_dir
|
local extract_dir
|
||||||
|
local _gzip_bin _bzip2_bin _xz_bin _zstd_bin
|
||||||
|
|
||||||
if (( $# == 0 )); then
|
if (( $# == 0 )); then
|
||||||
cat >&2 <<EOF
|
cat >&2 <<EOF
|
||||||
@ -27,6 +31,31 @@ if [[ "$1" == "-r" || "$1" == "--remove" ]]; then
|
|||||||
shift
|
shift
|
||||||
fi
|
fi
|
||||||
|
|
||||||
|
# here, we check for dropin/multi-threaded replacements
|
||||||
|
# this should eventually be moved to modules/archive/init.zsh
|
||||||
|
# as a global alias
|
||||||
|
if (( $+commands[unpigz] )); then
|
||||||
|
_gzip_bin='unpigz'
|
||||||
|
else
|
||||||
|
_gzip_bin='gunzip'
|
||||||
|
fi
|
||||||
|
|
||||||
|
if (( $+commands[pixz] )); then
|
||||||
|
_xz_bin='pixz -d'
|
||||||
|
else
|
||||||
|
_xz_bin='xz'
|
||||||
|
fi
|
||||||
|
|
||||||
|
if (( $+commands[lbunzip2] )); then
|
||||||
|
_bzip2_bin='lbunzip2'
|
||||||
|
elif (( $+commands[pbunzip2] )); then
|
||||||
|
_bzip2_bin='pbunzip2'
|
||||||
|
else
|
||||||
|
_bzip2_bin='bunzip2'
|
||||||
|
fi
|
||||||
|
|
||||||
|
_zstd_bin='zstd'
|
||||||
|
|
||||||
while (( $# > 0 )); do
|
while (( $# > 0 )); do
|
||||||
if [[ ! -s "$1" ]]; then
|
if [[ ! -s "$1" ]]; then
|
||||||
print "$0: file not valid: $1" >&2
|
print "$0: file not valid: $1" >&2
|
||||||
@ -36,34 +65,36 @@ while (( $# > 0 )); do
|
|||||||
|
|
||||||
success=0
|
success=0
|
||||||
file_name="${1:t}"
|
file_name="${1:t}"
|
||||||
|
file_path="${1:A}"
|
||||||
extract_dir="${file_name:r}"
|
extract_dir="${file_name:r}"
|
||||||
case "$1" in
|
case "$1:l" in
|
||||||
(*.tar.gz|*.tgz) tar xvzf "$1" ;;
|
(*.tar.gz|*.tgz) tar -xvf "$1" --use-compress-program="${_gzip_bin}" ;;
|
||||||
(*.tar.bz2|*.tbz|*.tbz2) tar xvjf "$1" ;;
|
(*.tar.bz2|*.tbz|*.tbz2) tar -xvf "$1" --use-compress-program="${_bzip2_bin}" ;;
|
||||||
(*.tar.xz|*.txz) tar --xz --help &> /dev/null \
|
(*.tar.xz|*.txz) tar -xvf "$1" --use-compress-program="${_xz_bin}" ;;
|
||||||
&& tar --xz -xvf "$1" \
|
|
||||||
|| xzcat "$1" | tar xvf - ;;
|
|
||||||
(*.tar.zma|*.tlz) tar --lzma --help &> /dev/null \
|
(*.tar.zma|*.tlz) tar --lzma --help &> /dev/null \
|
||||||
&& tar --lzma -xvf "$1" \
|
&& tar --lzma -xvf "$1" \
|
||||||
|| lzcat "$1" | tar xvf - ;;
|
|| lzcat "$1" | tar -xvf - ;;
|
||||||
(*.tar) tar xvf "$1" ;;
|
(*.tar.zst|*.tzst) tar -xvf "$1" --use-compress-program="${_zstd_bin}" ;;
|
||||||
|
(*.tar) tar -xvf "$1" ;;
|
||||||
(*.gz) gunzip "$1" ;;
|
(*.gz) gunzip "$1" ;;
|
||||||
(*.bz2) bunzip2 "$1" ;;
|
(*.bz2) bunzip2 "$1" ;;
|
||||||
(*.xz) unxz "$1" ;;
|
(*.xz) unxz "$1" ;;
|
||||||
(*.lzma) unlzma "$1" ;;
|
(*.lzma) unlzma "$1" ;;
|
||||||
(*.Z) uncompress "$1" ;;
|
(*.Z) uncompress "$1" ;;
|
||||||
(*.zip) unzip "$1" -d $extract_dir ;;
|
(*.zip|*.jar) unzip "$1" -d $extract_dir ;;
|
||||||
(*.rar) unrar &> /dev/null \
|
(*.rar) ( (( $+commands[unrar] )) \
|
||||||
&& unrar e -ad "$1" \
|
&& unrar x -ad "$1" ) \
|
||||||
|| rar e -ad "$1" ;;
|
|| ( (( $+commands[rar] )) \
|
||||||
|
&& rar x -ad "$1" ) \
|
||||||
|
|| unar -d "$1" ;;
|
||||||
(*.7z) 7za x "$1" ;;
|
(*.7z) 7za x "$1" ;;
|
||||||
(*.deb)
|
(*.deb)
|
||||||
mkdir -p "$extract_dir/control"
|
mkdir -p "$extract_dir/control"
|
||||||
mkdir -p "$extract_dir/data"
|
mkdir -p "$extract_dir/data"
|
||||||
cd "$extract_dir"; ar vx "../${1}" > /dev/null
|
cd "$extract_dir"; ar vx "${file_path}" > /dev/null
|
||||||
cd control; tar xzvf ../control.tar.gz
|
cd control; tar xvf ../control.tar.*
|
||||||
cd ../data; tar xzvf ../data.tar.gz
|
cd ../data; tar xvf ../data.tar.*
|
||||||
cd ..; rm *.tar.gz debian-binary
|
cd ..; rm control.tar.* data.tar.* debian-binary
|
||||||
cd ..
|
cd ..
|
||||||
;;
|
;;
|
||||||
(*)
|
(*)
|
||||||
@ -77,3 +108,4 @@ while (( $# > 0 )); do
|
|||||||
shift
|
shift
|
||||||
done
|
done
|
||||||
|
|
||||||
|
# }
|
||||||
|
62
modules/autosuggestions/README.md
Normal file
62
modules/autosuggestions/README.md
Normal file
@ -0,0 +1,62 @@
|
|||||||
|
# Autosuggestions
|
||||||
|
|
||||||
|
Integrates [zsh-autosuggestions][1] into Prezto, which implements the
|
||||||
|
[Fish shell][2]'s autosuggestions feature, where the user can type in any part
|
||||||
|
of a previously entered command and Zsh suggests commands as you type based on
|
||||||
|
history and completions.
|
||||||
|
|
||||||
|
If this module is used in conjunction with the [_`syntax-highlighting`_][3]
|
||||||
|
module, this module must be loaded _after_ the _`syntax-highlighting`_ module.
|
||||||
|
|
||||||
|
Additionally, if this module is used in conjunction with the
|
||||||
|
[_`history-substring-search`_][4] module, this module must be loaded _after_ the
|
||||||
|
_`history-substring-search`_ module as well.
|
||||||
|
|
||||||
|
To elaborate, the relative order of loading the modules would be
|
||||||
|
_`syntax-highlighting`_, _`history-substring-search`_ and _`autosuggestions`_.
|
||||||
|
|
||||||
|
## Contributors
|
||||||
|
|
||||||
|
New features and bug fixes should be submitted to the [zsh-autosuggestions][1]
|
||||||
|
project according to its rules and regulations. This module will be synchronized
|
||||||
|
against it.
|
||||||
|
|
||||||
|
## Settings
|
||||||
|
|
||||||
|
### Highlighting
|
||||||
|
|
||||||
|
If colors are enabled, _autosuggestions_ will automatically highlight
|
||||||
|
positive results.
|
||||||
|
|
||||||
|
To enable highlighting for this module only, add the following line to
|
||||||
|
_`${ZDOTDIR:-$HOME}/.zpreztorc`_:
|
||||||
|
|
||||||
|
```sh
|
||||||
|
zstyle ':prezto:module:autosuggestions' color 'yes'
|
||||||
|
```
|
||||||
|
|
||||||
|
To set the query found color, add the following line to
|
||||||
|
_`${ZDOTDIR:-$HOME}/.zpreztorc`_:
|
||||||
|
|
||||||
|
```sh
|
||||||
|
zstyle ':prezto:module:autosuggestions:color' found ''
|
||||||
|
```
|
||||||
|
|
||||||
|
## Troubleshooting
|
||||||
|
|
||||||
|
### Autosuggestions from previous sessions don't show up
|
||||||
|
|
||||||
|
For autosuggestions from previous shell sessions to work, please make sure you
|
||||||
|
also have the `history` module enabled.
|
||||||
|
|
||||||
|
## Authors
|
||||||
|
|
||||||
|
_The authors of this module should be contacted via the [issue tracker][5]._
|
||||||
|
|
||||||
|
- [Sorin Ionescu](https://github.com/sorin-ionescu)
|
||||||
|
|
||||||
|
[1]: https://github.com/tarruda/zsh-autosuggestions
|
||||||
|
[2]: https://fishshell.com
|
||||||
|
[3]: ../syntax-highlighting#readme
|
||||||
|
[4]: ../history-substring-search#readme
|
||||||
|
[5]: https://github.com/sorin-ionescu/prezto/issues
|
1
modules/autosuggestions/external
Submodule
1
modules/autosuggestions/external
Submodule
Submodule modules/autosuggestions/external added at a411ef3e09
35
modules/autosuggestions/init.zsh
Normal file
35
modules/autosuggestions/init.zsh
Normal file
@ -0,0 +1,35 @@
|
|||||||
|
#
|
||||||
|
# Integrates zsh-autosuggestions into Prezto.
|
||||||
|
#
|
||||||
|
# Authors:
|
||||||
|
# Sorin Ionescu <sorin.ionescu@gmail.com>
|
||||||
|
#
|
||||||
|
|
||||||
|
# Load dependencies.
|
||||||
|
pmodload 'editor'
|
||||||
|
|
||||||
|
# Source module files.
|
||||||
|
source "${0:h}/external/zsh-autosuggestions.zsh" || return 1
|
||||||
|
|
||||||
|
#
|
||||||
|
# Highlighting
|
||||||
|
#
|
||||||
|
|
||||||
|
# Set highlight color, default 'fg=8'.
|
||||||
|
zstyle -s ':prezto:module:autosuggestions:color' found \
|
||||||
|
'ZSH_AUTOSUGGEST_HIGHLIGHT_STYLE' || ZSH_AUTOSUGGEST_HIGHLIGHT_STYLE='fg=8'
|
||||||
|
|
||||||
|
# Disable highlighting.
|
||||||
|
if ! zstyle -t ':prezto:module:autosuggestions' color; then
|
||||||
|
ZSH_AUTOSUGGEST_HIGHLIGHT_STYLE=''
|
||||||
|
fi
|
||||||
|
|
||||||
|
#
|
||||||
|
# Key Bindings
|
||||||
|
#
|
||||||
|
|
||||||
|
if [[ -n "$key_info" ]]; then
|
||||||
|
# vi
|
||||||
|
bindkey -M viins "$key_info[Control]F" vi-forward-word
|
||||||
|
bindkey -M viins "$key_info[Control]E" vi-add-eol
|
||||||
|
fi
|
13
modules/aws/functions/_aws_switch_profile
Normal file
13
modules/aws/functions/_aws_switch_profile
Normal file
@ -0,0 +1,13 @@
|
|||||||
|
#compdef aws_switch_profile
|
||||||
|
#autoload
|
||||||
|
|
||||||
|
if [[ ! -f ~/.aws/credentials ]]; then
|
||||||
|
return 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
local profiles
|
||||||
|
profiles=$(grep -E "^\[.+\]" ~/.aws/credentials | tr -d '[' | tr -d ']' )
|
||||||
|
|
||||||
|
_arguments "1:toggle:((
|
||||||
|
$profiles
|
||||||
|
))" && return 0
|
33
modules/aws/functions/aws-info
Normal file
33
modules/aws/functions/aws-info
Normal file
@ -0,0 +1,33 @@
|
|||||||
|
#
|
||||||
|
# Exposes information about the AWS_PROFILE environment via the $aws_info associative
|
||||||
|
# array.
|
||||||
|
#
|
||||||
|
|
||||||
|
# function aws-info {
|
||||||
|
|
||||||
|
local profile_format
|
||||||
|
local profile_formatted
|
||||||
|
local aws_prompt
|
||||||
|
local aws_region_prompt
|
||||||
|
|
||||||
|
unset aws_info
|
||||||
|
typeset -gA aws_info
|
||||||
|
|
||||||
|
if (( ${+AWS_SECRET_ACCESS_KEY} )); then
|
||||||
|
aws_prompt="${AWS_PROFILE} "
|
||||||
|
elif (( ${+AWS_PROFILE} )); then
|
||||||
|
aws_prompt=$AWS_PROFILE
|
||||||
|
fi
|
||||||
|
|
||||||
|
if (( ${+AWS_DEFAULT_REGION} )) && [[ ${_aws_region} = "true" ]]; then
|
||||||
|
AWS_REGION=$(cut -d "-" -f 1 <<<$AWS_DEFAULT_REGION | cut -b 1)$(cut -d "-" -f 2 <<<$AWS_DEFAULT_REGION | cut -b 1)$(cut -d "-" -f 3 <<<$AWS_DEFAULT_REGION | cut -b 1)
|
||||||
|
aws_region_prompt=" $AWS_REGION"
|
||||||
|
fi
|
||||||
|
|
||||||
|
if (( ${+AWS_SECRET_ACCESS_KEY} )) || (( ${+AWS_DEFAULT_REGION} )); then
|
||||||
|
zstyle -s ':prezto:module:aws:info:profile' format 'profile_format'
|
||||||
|
zformat -f profile_formatted "$profile_format" "v:${aws_prompt:t}${aws_region_prompt}"
|
||||||
|
aws_info[profile]="$profile_formatted"
|
||||||
|
fi
|
||||||
|
|
||||||
|
# }
|
177
modules/aws/init.zsh
Normal file
177
modules/aws/init.zsh
Normal file
@ -0,0 +1,177 @@
|
|||||||
|
#
|
||||||
|
# Defines aws cli aliases/functions.
|
||||||
|
#
|
||||||
|
# Authors:
|
||||||
|
# Daniel Carrillo
|
||||||
|
#
|
||||||
|
|
||||||
|
# Get the output parameter
|
||||||
|
zstyle -s ':prezto:module:aws' output '_aws_output' || _aws_output='table'
|
||||||
|
zstyle -s ':prezto:module:aws' show_region '_aws_region' || _aws_region='false'
|
||||||
|
zstyle -s ':prezto:module:aws' profile '_aws_profile' || _aws_profile='default'
|
||||||
|
zstyle -s ':prezto:module:aws' sso '_aws_sso' || _aws_sso='false'
|
||||||
|
|
||||||
|
# Return if requirements are not found.
|
||||||
|
if (( ! $+commands[aws] )); then
|
||||||
|
return 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
function _get_aws_profile {
|
||||||
|
if [[ -z "${AWS_PROFILE+1}" ]]; then
|
||||||
|
echo ${_aws_profile}
|
||||||
|
else
|
||||||
|
echo $AWS_PROFILE
|
||||||
|
fi
|
||||||
|
}
|
||||||
|
|
||||||
|
function aws_i {
|
||||||
|
local profile=$(_get_aws_profile)
|
||||||
|
aws ec2 describe-instances --profile $profile --output ${_aws_output} \
|
||||||
|
--query 'Reservations[].Instances[].[Tags[?Key==`Name`] | [0].Value, LaunchTime, State.Name,
|
||||||
|
InstanceType, VpcId, InstanceId, Placement.AvailabilityZone, PrivateIpAddress, PublicIpAddress]'
|
||||||
|
}
|
||||||
|
|
||||||
|
function aws_ebs {
|
||||||
|
local profile=$(_get_aws_profile)
|
||||||
|
aws ec2 describe-volumes --profile $profile --output ${_aws_output} \
|
||||||
|
--query 'Volumes[].[Tags[?Key==`Name`] | [0].Value, VolumeId, Attachments[0].InstanceId, Size, VolumeType, Iops, AvailabilityZone]'
|
||||||
|
}
|
||||||
|
|
||||||
|
function aws_elb {
|
||||||
|
local profile=$(_get_aws_profile)
|
||||||
|
aws elb describe-load-balancers --profile $profile --output ${_aws_output} \
|
||||||
|
--query "LoadBalancerDescriptions[*].{type:'elb',scheme:Scheme,dns:DNSName,vpc:VPCId,name:LoadBalancerName,subnets:Subnets[*] | join(',', @)}"
|
||||||
|
|
||||||
|
local profile=$(_get_aws_profile)
|
||||||
|
aws elbv2 describe-load-balancers --profile $profile --output ${_aws_output} \
|
||||||
|
--query "LoadBalancers[*].{type:Type,scheme:Scheme,dns:DNSName,vpc:VpcId,name:LoadBalancerName,subnets:AvailabilityZones[*].SubnetId | join(',', @)}"
|
||||||
|
}
|
||||||
|
|
||||||
|
function aws_userdata {
|
||||||
|
local profile=$(_get_aws_profile)
|
||||||
|
aws ec2 describe-instance-attribute --profile $profile --output text \
|
||||||
|
--attribute userData --instance-id $1 \
|
||||||
|
--query 'UserData.Value' | base64 -d
|
||||||
|
}
|
||||||
|
|
||||||
|
function aws_vpc {
|
||||||
|
local profile=$(_get_aws_profile)
|
||||||
|
aws ec2 describe-vpcs --profile $profile --output ${_aws_output} \
|
||||||
|
--query 'Vpcs[*].{id:VpcId,cidr:CidrBlock,tag:Tags[0].Value}'
|
||||||
|
}
|
||||||
|
|
||||||
|
function aws_subnets {
|
||||||
|
local profile=$(_get_aws_profile)
|
||||||
|
aws ec2 describe-subnets --profile $profile --output text \
|
||||||
|
--query 'Subnets[].[Tags[?Key==`Name`] | [0].Value, SubnetId, VpcId, CidrBlock]' \
|
||||||
|
| sort -k1 | column -t
|
||||||
|
}
|
||||||
|
|
||||||
|
function aws_ag {
|
||||||
|
local profile=$(_get_aws_profile)
|
||||||
|
aws autoscaling describe-auto-scaling-groups --profile $profile --output ${_aws_output} \
|
||||||
|
--query 'AutoScalingGroups[*].{name:AutoScalingGroupName,az:VPCZoneIdentifier}'
|
||||||
|
}
|
||||||
|
|
||||||
|
function aws_ami {
|
||||||
|
local profile=$(_get_aws_profile)
|
||||||
|
aws ec2 describe-images --profile $profile --output ${_aws_output} \
|
||||||
|
--owner self --query 'Images[*].{date:CreationDate,id:ImageId,name:Name,virt:VirtualizationType,st:State}'
|
||||||
|
}
|
||||||
|
|
||||||
|
function aws_kms_decrypt {
|
||||||
|
local profile=$(_get_aws_profile)
|
||||||
|
|
||||||
|
if [[ -z $1 ]]; then
|
||||||
|
echo "String is missing"
|
||||||
|
return 1
|
||||||
|
fi
|
||||||
|
aws kms --profile $profile decrypt --ciphertext-blob fileb://<(base64 -d <<<$1) \
|
||||||
|
--output text --query Plaintext | base64 -d
|
||||||
|
}
|
||||||
|
|
||||||
|
function aws_ssm_session {
|
||||||
|
local profile=$(_get_aws_profile)
|
||||||
|
|
||||||
|
if [[ -z $1 ]]; then
|
||||||
|
echo "Instance id is missing"
|
||||||
|
return 1
|
||||||
|
fi
|
||||||
|
aws ssm start-session --profile $profile --target $1
|
||||||
|
}
|
||||||
|
|
||||||
|
function aws_ssm_session_any {
|
||||||
|
local profile=$(_get_aws_profile)
|
||||||
|
local id
|
||||||
|
|
||||||
|
if [[ -z $1 ]]; then
|
||||||
|
echo "Instance name is missing"
|
||||||
|
return 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
id=$(aws ec2 describe-instances --profile $profile --output text \
|
||||||
|
--filter "Name=tag:Name,Values=$1" "Name=instance-state-name,Values=running" \
|
||||||
|
--query 'Reservations[0].Instances[0].InstanceId')
|
||||||
|
if [[ $2 == "ssh" ]]; then
|
||||||
|
shift 2
|
||||||
|
AWS_PROFILE=$profile ssh $id $@
|
||||||
|
else
|
||||||
|
aws ssm start-session --profile $profile --target $id
|
||||||
|
fi
|
||||||
|
}
|
||||||
|
|
||||||
|
function aws_cf {
|
||||||
|
local profile=$(_get_aws_profile)
|
||||||
|
|
||||||
|
if ! type "jq" > /dev/null; then
|
||||||
|
echo "ERROR: this function needs jq to be installed"
|
||||||
|
return 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
aws cloudfront list-distributions --profile $profile --output json \
|
||||||
|
--query "DistributionList.Items[*].{id:Id,domain:DomainName,status:Status,
|
||||||
|
origin:Origins.Items[].DomainName | join(' ', @), aliases:Aliases.Items | join(' ', @)}" \
|
||||||
|
| jq -r ".[] | [.id, .domain, .aliases, .status, .origin] | @csv" | tr -d '"' | column --separator="," --table
|
||||||
|
}
|
||||||
|
|
||||||
|
# ~/.ssh/config
|
||||||
|
#
|
||||||
|
# Host i-*
|
||||||
|
# ProxyCommand sh -c "aws ssm start-session --target %h --document-name AWS-StartSSHSession --parameters 'portNumber=%p'"
|
||||||
|
# User <your_user>
|
||||||
|
function ssh_aws_any {
|
||||||
|
host=$1
|
||||||
|
shift
|
||||||
|
extra_params=$@
|
||||||
|
aws_ssm_session_any $host ssh $extra_params
|
||||||
|
}
|
||||||
|
|
||||||
|
function aws_switch_profile {
|
||||||
|
local region
|
||||||
|
|
||||||
|
if [[ -z $1 ]]; then
|
||||||
|
echo "Profile can't be an empty string"
|
||||||
|
return 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
echo "Activating profile $1..."
|
||||||
|
unset -m "AWS_*"
|
||||||
|
export AWS_PROFILE=$1
|
||||||
|
if [[ -f ~/.aws/credentials ]]; then #&& (( ! ${+AWS_DEFAULT_REGION} ))
|
||||||
|
region=$(aws configure get region)
|
||||||
|
if [[ ! -z $region ]]; then
|
||||||
|
export AWS_DEFAULT_REGION=$region
|
||||||
|
else
|
||||||
|
unset AWS_DEFAULT_REGION
|
||||||
|
fi
|
||||||
|
|
||||||
|
if [[ ${_aws_sso} == "true" ]]; then
|
||||||
|
eval $(aws-export-credentials --env-export)
|
||||||
|
fi
|
||||||
|
fi
|
||||||
|
}
|
||||||
|
|
||||||
|
function aws_deactivate_profile {
|
||||||
|
echo "Deactivating aws profile..."
|
||||||
|
unset -m "AWS_*"
|
||||||
|
}
|
23
modules/command-not-found/README.md
Normal file
23
modules/command-not-found/README.md
Normal file
@ -0,0 +1,23 @@
|
|||||||
|
# Command-Not-Found
|
||||||
|
|
||||||
|
When you try to use a command that is not available locally, searches the
|
||||||
|
package manager for a package offering that command and suggests the proper
|
||||||
|
install command.
|
||||||
|
|
||||||
|
Debian and Arch Linux based distributions use the [`command-not-found`][1] tool.
|
||||||
|
|
||||||
|
macOS uses Homebrew's [`command-not-found` clone][2]. Note that unless you have
|
||||||
|
a recent version of Homebrew installed, you might also need to tap the
|
||||||
|
`command-not-found` Homebrew repository [following the instructions][3].
|
||||||
|
|
||||||
|
## Authors
|
||||||
|
|
||||||
|
_The authors of this module should be contacted via the [issue tracker][4]._
|
||||||
|
|
||||||
|
- [Joseph Booker](https://github.com/sargas)
|
||||||
|
- [Indrajit Raychaudhuri](https://github.com/indrajitr)
|
||||||
|
|
||||||
|
[1]: https://code.launchpad.net/command-not-found
|
||||||
|
[2]: https://github.com/Homebrew/homebrew-command-not-found
|
||||||
|
[3]: https://github.com/Homebrew/homebrew-command-not-found#install
|
||||||
|
[4]: https://github.com/sorin-ionescu/prezto/issues
|
@ -3,16 +3,21 @@
|
|||||||
#
|
#
|
||||||
# Authors:
|
# Authors:
|
||||||
# Joseph Jon Booker <joe@neoturbine.net>
|
# Joseph Jon Booker <joe@neoturbine.net>
|
||||||
|
# Indrajit Raychaudhuri <irc+code@indrajit.com>
|
||||||
#
|
#
|
||||||
|
|
||||||
# Load command-not-found on Debian-based distributions.
|
# Load command-not-found on Debian-based distributions.
|
||||||
if [[ -s '/etc/zsh_command_not_found' ]]; then
|
if [[ -s /etc/zsh_command_not_found ]]; then
|
||||||
source '/etc/zsh_command_not_found'
|
source /etc/zsh_command_not_found
|
||||||
# Load command-not-found on Arch Linux-based distributions.
|
# Load command-not-found on Arch Linux-based distributions.
|
||||||
elif [[ -s '/usr/share/doc/pkgfile/command-not-found.zsh' ]]; then
|
elif [[ -s /usr/share/doc/pkgfile/command-not-found.zsh ]]; then
|
||||||
source '/usr/share/doc/pkgfile/command-not-found.zsh'
|
source /usr/share/doc/pkgfile/command-not-found.zsh
|
||||||
|
# Load command-not-found on macOS when Homebrew tap is configured.
|
||||||
|
elif (( $+commands[brew] )) \
|
||||||
|
&& [[ -s ${hb_cnf_handler::="${HOMEBREW_REPOSITORY:-$commands[brew]:A:h:h}/Library/Taps/homebrew/homebrew-command-not-found/handler.sh"} ]]; then
|
||||||
|
source "$hb_cnf_handler"
|
||||||
|
unset hb_cnf_handler
|
||||||
# Return if requirements are not found.
|
# Return if requirements are not found.
|
||||||
else
|
else
|
||||||
return 1
|
return 1
|
||||||
fi
|
fi
|
||||||
|
|
||||||
|
55
modules/completion/README.md
Normal file
55
modules/completion/README.md
Normal file
@ -0,0 +1,55 @@
|
|||||||
|
# Completion
|
||||||
|
|
||||||
|
Loads and configures <kbd>TAB</kbd> completion and provides additional
|
||||||
|
completions from the [zsh-completions][1] project.
|
||||||
|
|
||||||
|
This module must be loaded late _after_ the _`utility`_ module and all other
|
||||||
|
modules that provide completion definitions.
|
||||||
|
|
||||||
|
## Options
|
||||||
|
|
||||||
|
- `COMPLETE_IN_WORD` complete from both ends of a word.
|
||||||
|
- `ALWAYS_TO_END` move cursor to the end of a completed word.
|
||||||
|
- `PATH_DIRS` perform path search even on command names with slashes.
|
||||||
|
- `AUTO_MENU` show completion menu on a successive <kbd>TAB</kbd> press.
|
||||||
|
- `AUTO_LIST` automatically list choices on ambiguous completion.
|
||||||
|
- `AUTO_PARAM_SLASH` if completed parameter is a directory, add a trailing
|
||||||
|
slash (`/`).
|
||||||
|
- `EXTENDED_GLOB` needed for file modification glob modifiers with _compinit_.
|
||||||
|
- `MENU_COMPLETE` do not autoselect the first completion entry.
|
||||||
|
- `FLOW_CONTROL` disable start/stop characters in shell editor.
|
||||||
|
|
||||||
|
## Variables
|
||||||
|
|
||||||
|
- `LS_COLORS` used by default for Zsh [standard style][2] 'list-colors'.
|
||||||
|
|
||||||
|
## Settings
|
||||||
|
|
||||||
|
### Ignore _`/etc/hosts`_ Entries
|
||||||
|
|
||||||
|
To ignore certain entries from static _`/etc/hosts`_ for host completion, add
|
||||||
|
the following lines in _`${ZDOTDIR:-$HOME}/.zpreztorc`_ with the IP addresses of
|
||||||
|
the hosts as they appear in _`/etc/hosts`_. Both IP address and the associated
|
||||||
|
hostname(s) will be ignored during host completion. However, some of the entries
|
||||||
|
ignored from _`/etc/hosts`_ still might appear during completion because of
|
||||||
|
their presence in _ssh_ configuration or history).
|
||||||
|
|
||||||
|
```sh
|
||||||
|
zstyle ':prezto:module:completion:*:hosts' etc-host-ignores \
|
||||||
|
'0.0.0.0' '127.0.0.1'
|
||||||
|
```
|
||||||
|
|
||||||
|
## Contributors
|
||||||
|
|
||||||
|
Completions should be submitted to the [zsh-completions][1] project according to
|
||||||
|
its rules and regulations. This module will be synchronized against it.
|
||||||
|
|
||||||
|
## Authors
|
||||||
|
|
||||||
|
_The authors of this module should be contacted via the [issue tracker][3]._
|
||||||
|
|
||||||
|
- [Sorin Ionescu](https://github.com/sorin-ionescu)
|
||||||
|
|
||||||
|
[1]: https://github.com/zsh-users/zsh-completions
|
||||||
|
[2]: https://zsh.sourceforge.net/Doc/Release/Completion-System.html#Standard-Styles
|
||||||
|
[3]: https://github.com/sorin-ionescu/prezto/issues
|
Submodule modules/completion/external updated: 1d6a2aa024...11ad0a45ff
@ -7,15 +7,23 @@
|
|||||||
#
|
#
|
||||||
|
|
||||||
# Return if requirements are not found.
|
# Return if requirements are not found.
|
||||||
if [[ "$TERM" == 'dumb' ]]; then
|
if [[ $TERM == 'dumb' ]]; then
|
||||||
return 1
|
return 1
|
||||||
fi
|
fi
|
||||||
|
|
||||||
# Add zsh-completions to $fpath.
|
# Add zsh-completions to $fpath.
|
||||||
fpath=("${0:h}/external/src" $fpath)
|
fpath=(${0:h}/external/src $fpath)
|
||||||
|
|
||||||
# Load and initialize the completion system ignoring insecure directories.
|
# Add completion for keg-only brewed curl on macOS when available.
|
||||||
autoload -Uz compinit && compinit -i
|
if (( $+commands[brew] )); then
|
||||||
|
brew_prefix=${HOMEBREW_PREFIX:-${HOMEBREW_REPOSITORY:-$commands[brew]:A:h:h}}
|
||||||
|
# $HOMEBREW_PREFIX defaults to $HOMEBREW_REPOSITORY but is explicitly set to
|
||||||
|
# /usr/local when $HOMEBREW_REPOSITORY is /usr/local/Homebrew.
|
||||||
|
# https://github.com/Homebrew/brew/blob/2a850e02d8f2dedcad7164c2f4b95d340a7200bb/bin/brew#L66-L69
|
||||||
|
[[ $brew_prefix == '/usr/local/Homebrew' ]] && brew_prefix=$brew_prefix:h
|
||||||
|
fpath=($brew_prefix/opt/curl/share/zsh/site-functions(/N) $fpath)
|
||||||
|
unset brew_prefix
|
||||||
|
fi
|
||||||
|
|
||||||
#
|
#
|
||||||
# Options
|
# Options
|
||||||
@ -24,19 +32,52 @@ autoload -Uz compinit && compinit -i
|
|||||||
setopt COMPLETE_IN_WORD # Complete from both ends of a word.
|
setopt COMPLETE_IN_WORD # Complete from both ends of a word.
|
||||||
setopt ALWAYS_TO_END # Move cursor to the end of a completed word.
|
setopt ALWAYS_TO_END # Move cursor to the end of a completed word.
|
||||||
setopt PATH_DIRS # Perform path search even on command names with slashes.
|
setopt PATH_DIRS # Perform path search even on command names with slashes.
|
||||||
setopt AUTO_MENU # Show completion menu on a succesive tab press.
|
setopt AUTO_MENU # Show completion menu on a successive tab press.
|
||||||
setopt AUTO_LIST # Automatically list choices on ambiguous completion.
|
setopt AUTO_LIST # Automatically list choices on ambiguous completion.
|
||||||
setopt AUTO_PARAM_SLASH # If completed parameter is a directory, add a trailing slash.
|
setopt AUTO_PARAM_SLASH # If completed parameter is a directory, add a trailing slash.
|
||||||
|
setopt EXTENDED_GLOB # Needed for file modification glob modifiers with compinit.
|
||||||
unsetopt MENU_COMPLETE # Do not autoselect the first completion entry.
|
unsetopt MENU_COMPLETE # Do not autoselect the first completion entry.
|
||||||
unsetopt FLOW_CONTROL # Disable start/stop characters in shell editor.
|
unsetopt FLOW_CONTROL # Disable start/stop characters in shell editor.
|
||||||
|
|
||||||
|
#
|
||||||
|
# Variables
|
||||||
|
#
|
||||||
|
|
||||||
|
# Standard style used by default for 'list-colors'
|
||||||
|
LS_COLORS=${LS_COLORS:-'di=34:ln=35:so=32:pi=33:ex=31:bd=36;01:cd=33;01:su=31;40;07:sg=36;40;07:tw=32;40;07:ow=33;40;07:'}
|
||||||
|
|
||||||
|
#
|
||||||
|
# Initialization
|
||||||
|
#
|
||||||
|
|
||||||
|
# Load and initialize the completion system ignoring insecure directories with a
|
||||||
|
# cache time of 20 hours, so it should almost always regenerate the first time a
|
||||||
|
# shell is opened each day.
|
||||||
|
autoload -Uz compinit
|
||||||
|
_comp_path="${XDG_CACHE_HOME:-$HOME/.cache}/prezto/zcompdump"
|
||||||
|
# #q expands globs in conditional expressions
|
||||||
|
if [[ $_comp_path(#qNmh-20) ]]; then
|
||||||
|
# -C (skip function check) implies -i (skip security check).
|
||||||
|
compinit -C -d "$_comp_path"
|
||||||
|
else
|
||||||
|
mkdir -p "$_comp_path:h"
|
||||||
|
compinit -i -d "$_comp_path"
|
||||||
|
# Keep $_comp_path younger than cache time even if it isn't regenerated.
|
||||||
|
touch "$_comp_path"
|
||||||
|
fi
|
||||||
|
unset _comp_path
|
||||||
|
|
||||||
#
|
#
|
||||||
# Styles
|
# Styles
|
||||||
#
|
#
|
||||||
|
|
||||||
# Use caching to make completion for cammands such as dpkg and apt usable.
|
# Defaults.
|
||||||
|
zstyle ':completion:*:default' list-colors ${(s.:.)LS_COLORS}
|
||||||
|
zstyle ':completion:*:default' list-prompt '%S%M matches%s'
|
||||||
|
|
||||||
|
# Use caching to make completion for commands such as dpkg and apt usable.
|
||||||
zstyle ':completion::complete:*' use-cache on
|
zstyle ':completion::complete:*' use-cache on
|
||||||
zstyle ':completion::complete:*' cache-path "${ZDOTDIR:-$HOME}/.zcompcache"
|
zstyle ':completion::complete:*' cache-path "${XDG_CACHE_HOME:-$HOME/.cache}/prezto/zcompcache"
|
||||||
|
|
||||||
# Case-insensitive (all), partial-word, and then substring completion.
|
# Case-insensitive (all), partial-word, and then substring completion.
|
||||||
if zstyle -t ':prezto:module:completion:*' case-sensitive; then
|
if zstyle -t ':prezto:module:completion:*' case-sensitive; then
|
||||||
@ -56,7 +97,6 @@ zstyle ':completion:*:corrections' format ' %F{green}-- %d (errors: %e) --%f'
|
|||||||
zstyle ':completion:*:descriptions' format ' %F{yellow}-- %d --%f'
|
zstyle ':completion:*:descriptions' format ' %F{yellow}-- %d --%f'
|
||||||
zstyle ':completion:*:messages' format ' %F{purple} -- %d --%f'
|
zstyle ':completion:*:messages' format ' %F{purple} -- %d --%f'
|
||||||
zstyle ':completion:*:warnings' format ' %F{red}-- no matches found --%f'
|
zstyle ':completion:*:warnings' format ' %F{red}-- no matches found --%f'
|
||||||
zstyle ':completion:*:default' list-prompt '%S%M matches%s'
|
|
||||||
zstyle ':completion:*' format ' %F{yellow}-- %d --%f'
|
zstyle ':completion:*' format ' %F{yellow}-- %d --%f'
|
||||||
zstyle ':completion:*' group-name ''
|
zstyle ':completion:*' group-name ''
|
||||||
zstyle ':completion:*' verbose yes
|
zstyle ':completion:*' verbose yes
|
||||||
@ -66,8 +106,9 @@ zstyle ':completion:*' completer _complete _match _approximate
|
|||||||
zstyle ':completion:*:match:*' original only
|
zstyle ':completion:*:match:*' original only
|
||||||
zstyle ':completion:*:approximate:*' max-errors 1 numeric
|
zstyle ':completion:*:approximate:*' max-errors 1 numeric
|
||||||
|
|
||||||
# Increase the number of errors based on the length of the typed word.
|
# Increase the number of errors based on the length of the typed word. But make
|
||||||
zstyle -e ':completion:*:approximate:*' max-errors 'reply=($((($#PREFIX+$#SUFFIX)/3))numeric)'
|
# sure to cap (at 7) the max-errors to avoid hanging.
|
||||||
|
zstyle -e ':completion:*:approximate:*' max-errors 'reply=($((($#PREFIX+$#SUFFIX)/3>7?7:($#PREFIX+$#SUFFIX)/3))numeric)'
|
||||||
|
|
||||||
# Don't complete unavailable commands.
|
# Don't complete unavailable commands.
|
||||||
zstyle ':completion:*:functions' ignored-patterns '(_*|pre(cmd|exec))'
|
zstyle ':completion:*:functions' ignored-patterns '(_*|pre(cmd|exec))'
|
||||||
@ -76,7 +117,6 @@ zstyle ':completion:*:functions' ignored-patterns '(_*|pre(cmd|exec))'
|
|||||||
zstyle ':completion:*:*:-subscript-:*' tag-order indexes parameters
|
zstyle ':completion:*:*:-subscript-:*' tag-order indexes parameters
|
||||||
|
|
||||||
# Directories
|
# Directories
|
||||||
zstyle ':completion:*:default' list-colors ${(s.:.)LS_COLORS}
|
|
||||||
zstyle ':completion:*:*:cd:*' tag-order local-directories directory-stack path-directories
|
zstyle ':completion:*:*:cd:*' tag-order local-directories directory-stack path-directories
|
||||||
zstyle ':completion:*:*:cd:*:directory-stack' menu yes select
|
zstyle ':completion:*:*:cd:*:directory-stack' menu yes select
|
||||||
zstyle ':completion:*:-tilde-:*' group-order 'named-directories' 'path-directories' 'users' 'expand'
|
zstyle ':completion:*:-tilde-:*' group-order 'named-directories' 'path-directories' 'users' 'expand'
|
||||||
@ -88,13 +128,16 @@ zstyle ':completion:*:history-words' remove-all-dups yes
|
|||||||
zstyle ':completion:*:history-words' list false
|
zstyle ':completion:*:history-words' list false
|
||||||
zstyle ':completion:*:history-words' menu yes
|
zstyle ':completion:*:history-words' menu yes
|
||||||
|
|
||||||
# Environmental Variables
|
# Environment Variables
|
||||||
zstyle ':completion::*:(-command-|export):*' fake-parameters ${${${_comps[(I)-value-*]#*,}%%,*}:#-*-}
|
zstyle ':completion::*:(-command-|export):*' fake-parameters ${${${_comps[(I)-value-*]#*,}%%,*}:#-*-}
|
||||||
|
|
||||||
# Populate hostname completion.
|
# Populate hostname completion. But allow ignoring custom entries from static
|
||||||
|
# */etc/hosts* which might be uninteresting.
|
||||||
|
zstyle -a ':prezto:module:completion:*:hosts' etc-host-ignores '_etc_host_ignores'
|
||||||
|
|
||||||
zstyle -e ':completion:*:hosts' hosts 'reply=(
|
zstyle -e ':completion:*:hosts' hosts 'reply=(
|
||||||
${=${=${=${${(f)"$(cat {/etc/ssh_,~/.ssh/known_}hosts(|2)(N) 2>/dev/null)"}%%[#| ]*}//\]:[0-9]*/ }//,/ }//\[/ }
|
${=${=${=${${(f)"$(cat {/etc/ssh/ssh_,~/.ssh/}known_hosts(|2)(N) 2> /dev/null)"}%%[#| ]*}//\]:[0-9]*/ }//,/ }//\[/ }
|
||||||
${=${(f)"$(cat /etc/hosts(|)(N) <<(ypcat hosts 2>/dev/null))"}%%\#*}
|
${=${(f)"$(cat /etc/hosts(|)(N) <<(ypcat hosts 2> /dev/null))"}%%(\#${_etc_host_ignores:+|${(j:|:)~_etc_host_ignores}})*}
|
||||||
${=${${${${(@M)${(f)"$(cat ~/.ssh/config 2> /dev/null)"}:#Host *}#Host }:#*\**}:#*\?*}}
|
${=${${${${(@M)${(f)"$(cat ~/.ssh/config 2> /dev/null)"}:#Host *}#Host }:#*\**}:#*\?*}}
|
||||||
)'
|
)'
|
||||||
|
|
||||||
@ -116,7 +159,7 @@ zstyle ':completion:*:(rm|kill|diff):*' ignore-line other
|
|||||||
zstyle ':completion:*:rm:*' file-patterns '*:all-files'
|
zstyle ':completion:*:rm:*' file-patterns '*:all-files'
|
||||||
|
|
||||||
# Kill
|
# Kill
|
||||||
zstyle ':completion:*:*:*:*:processes' command 'ps -u $USER -o pid,user,comm -w'
|
zstyle ':completion:*:*:*:*:processes' command 'ps -u $LOGNAME -o pid,user,command -w'
|
||||||
zstyle ':completion:*:*:kill:*:processes' list-colors '=(#b) #([0-9]#) ([0-9a-z-]#)*=01;36=0=01'
|
zstyle ':completion:*:*:kill:*:processes' list-colors '=(#b) #([0-9]#) ([0-9a-z-]#)*=01;36=0=01'
|
||||||
zstyle ':completion:*:*:kill:*' menu yes select
|
zstyle ':completion:*:*:kill:*' menu yes select
|
||||||
zstyle ':completion:*:*:kill:*' force-list always
|
zstyle ':completion:*:*:kill:*' force-list always
|
||||||
@ -139,11 +182,9 @@ if [[ -s "$HOME/.mutt/aliases" ]]; then
|
|||||||
fi
|
fi
|
||||||
|
|
||||||
# SSH/SCP/RSYNC
|
# SSH/SCP/RSYNC
|
||||||
zstyle ':completion:*:(scp|rsync):*' tag-order 'hosts:-host:host hosts:-domain:domain hosts:-ipaddr:ip\ address *'
|
zstyle ':completion:*:(ssh|scp|rsync):*' tag-order 'hosts:-host:host hosts:-domain:domain hosts:-ipaddr:ip\ address *'
|
||||||
zstyle ':completion:*:(scp|rsync):*' group-order users files all-files hosts-domain hosts-host hosts-ipaddr
|
zstyle ':completion:*:(scp|rsync):*' group-order users files all-files hosts-domain hosts-host hosts-ipaddr
|
||||||
zstyle ':completion:*:ssh:*' tag-order 'hosts:-host:host hosts:-domain:domain hosts:-ipaddr:ip\ address *'
|
|
||||||
zstyle ':completion:*:ssh:*' group-order users hosts-domain hosts-host users hosts-ipaddr
|
zstyle ':completion:*:ssh:*' group-order users hosts-domain hosts-host users hosts-ipaddr
|
||||||
zstyle ':completion:*:(ssh|scp|rsync):*:hosts-host' ignored-patterns '*(.|:)*' loopback ip6-loopback localhost ip6-localhost broadcasthost
|
zstyle ':completion:*:(ssh|scp|rsync):*:hosts-host' ignored-patterns '*(.|:)*' loopback ip6-loopback localhost ip6-localhost broadcasthost
|
||||||
zstyle ':completion:*:(ssh|scp|rsync):*:hosts-domain' ignored-patterns '<->.<->.<->.<->' '^[-[:alnum:]]##(.[-[:alnum:]]##)##' '*@*'
|
zstyle ':completion:*:(ssh|scp|rsync):*:hosts-domain' ignored-patterns '<->.<->.<->.<->' '^[-[:alnum:]]##(.[-[:alnum:]]##)##' '*@*'
|
||||||
zstyle ':completion:*:(ssh|scp|rsync):*:hosts-ipaddr' ignored-patterns '^(<->.<->.<->.<->|(|::)([[:xdigit:].]##:(#c,2))##(|%*))' '127.0.0.<->' '255.255.255.255' '::1' 'fe80::*'
|
zstyle ':completion:*:(ssh|scp|rsync):*:hosts-ipaddr' ignored-patterns '^(<->.<->.<->.<->|(|::)([[:xdigit:].]##:(#c,2))##(|%*))' '127.0.0.<->' '255.255.255.255' '::1' 'fe80::*'
|
||||||
|
|
||||||
|
30
modules/directory/README.md
Normal file
30
modules/directory/README.md
Normal file
@ -0,0 +1,30 @@
|
|||||||
|
# Directory
|
||||||
|
|
||||||
|
Sets directory options and defines directory aliases.
|
||||||
|
|
||||||
|
## Options
|
||||||
|
|
||||||
|
- `AUTO_CD` auto changes to a directory without typing `cd`.
|
||||||
|
- `AUTO_PUSHD` pushes the old directory onto the stack on `cd`.
|
||||||
|
- `PUSHD_IGNORE_DUPS` does not store duplicates in the stack.
|
||||||
|
- `PUSHD_SILENT` does not print the directory stack after `pushd` or `popd`.
|
||||||
|
- `PUSHD_TO_HOME` pushes to the home directory when no argument is given.
|
||||||
|
- `CDABLE_VARS` changes directory to a path stored in a variable.
|
||||||
|
- `MULTIOS` writes to multiple descriptors.
|
||||||
|
- `EXTENDED_GLOB` uses extended globbing syntax.
|
||||||
|
- `CLOBBER` does not overwrite existing files with `>` and `>>`. Use `>!` and
|
||||||
|
`>>!` to bypass.
|
||||||
|
|
||||||
|
## Aliases
|
||||||
|
|
||||||
|
- `d` prints the contents of the directory stack.
|
||||||
|
- `1 ... 9` changes the directory to the **n** previous one.
|
||||||
|
|
||||||
|
## Authors
|
||||||
|
|
||||||
|
_The authors of this module should be contacted via the [issue tracker][1]._
|
||||||
|
|
||||||
|
- [James Cox](https://github.com/imajes)
|
||||||
|
- [Sorin Ionescu](https://github.com/sorin-ionescu)
|
||||||
|
|
||||||
|
[1]: https://github.com/sorin-ionescu/prezto/issues
|
@ -16,7 +16,6 @@ setopt PUSHD_IGNORE_DUPS # Do not store duplicates in the stack.
|
|||||||
setopt PUSHD_SILENT # Do not print the directory stack after pushd or popd.
|
setopt PUSHD_SILENT # Do not print the directory stack after pushd or popd.
|
||||||
setopt PUSHD_TO_HOME # Push to home directory when no argument is given.
|
setopt PUSHD_TO_HOME # Push to home directory when no argument is given.
|
||||||
setopt CDABLE_VARS # Change directory to a path stored in a variable.
|
setopt CDABLE_VARS # Change directory to a path stored in a variable.
|
||||||
setopt AUTO_NAME_DIRS # Auto add variable-stored paths to ~ list.
|
|
||||||
setopt MULTIOS # Write to multiple descriptors.
|
setopt MULTIOS # Write to multiple descriptors.
|
||||||
setopt EXTENDED_GLOB # Use extended globbing syntax.
|
setopt EXTENDED_GLOB # Use extended globbing syntax.
|
||||||
unsetopt CLOBBER # Do not overwrite existing files with > and >>.
|
unsetopt CLOBBER # Do not overwrite existing files with > and >>.
|
||||||
@ -28,4 +27,3 @@ unsetopt CLOBBER # Do not overwrite existing files with > and >>.
|
|||||||
|
|
||||||
alias d='dirs -v'
|
alias d='dirs -v'
|
||||||
for index ({1..9}) alias "$index"="cd +${index}"; unset index
|
for index ({1..9}) alias "$index"="cd +${index}"; unset index
|
||||||
|
|
||||||
|
25
modules/dnf/README.md
Normal file
25
modules/dnf/README.md
Normal file
@ -0,0 +1,25 @@
|
|||||||
|
# DNF
|
||||||
|
|
||||||
|
Defines [dnf][1] aliases.
|
||||||
|
|
||||||
|
## Aliases
|
||||||
|
|
||||||
|
- `dnfc` removes package(s) and leaves.
|
||||||
|
- `dnfi` installs package(s).
|
||||||
|
- `dnfh` displays history.
|
||||||
|
- `dnfl` lists packages.
|
||||||
|
- `dnfL` lists installed packages.
|
||||||
|
- `dnfq` displays package information.
|
||||||
|
- `dnfr` removes package(s).
|
||||||
|
- `dnfs` searches for a package.
|
||||||
|
- `dnfu` updates packages.
|
||||||
|
- `dnfU` upgrades packages.
|
||||||
|
|
||||||
|
## Authors
|
||||||
|
|
||||||
|
_The authors of this module should be contacted via the [issue tracker][2]._
|
||||||
|
|
||||||
|
- [Sorin Ionescu](https://github.com/sorin-ionescu)
|
||||||
|
|
||||||
|
[1]: https://fedoraproject.org/wiki/Features/DNF
|
||||||
|
[2]: https://github.com/sorin-ionescu/prezto/issues
|
28
modules/dnf/init.zsh
Normal file
28
modules/dnf/init.zsh
Normal file
@ -0,0 +1,28 @@
|
|||||||
|
#
|
||||||
|
# Defines dnf aliases.
|
||||||
|
#
|
||||||
|
# Authors:
|
||||||
|
# FireWave <firewave@free.fr>
|
||||||
|
# Sorin Ionescu <sorin.ionescu@gmail.com>
|
||||||
|
#
|
||||||
|
|
||||||
|
# Return if requirements are not found.
|
||||||
|
if (( ! $+commands[dnf] )); then
|
||||||
|
return 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
#
|
||||||
|
# Aliases
|
||||||
|
#
|
||||||
|
|
||||||
|
alias dnfc='sudo dnf clean all' # Cleans the cache.
|
||||||
|
alias dnfh='dnf history' # Displays history.
|
||||||
|
alias dnfi='sudo dnf install' # Installs package(s).
|
||||||
|
alias dnfl='dnf list' # Lists packages.
|
||||||
|
alias dnfL='dnf list installed' # Lists installed packages.
|
||||||
|
alias dnfq='dnf info' # Displays package information.
|
||||||
|
alias dnfr='sudo dnf remove' # Removes package(s).
|
||||||
|
alias dnfs='dnf search' # Searches for a package.
|
||||||
|
alias dnfu='sudo dnf update' # Updates packages.
|
||||||
|
alias dnfU='sudo dnf upgrade' # Upgrades packages.
|
||||||
|
|
196
modules/docker/README.md
Normal file
196
modules/docker/README.md
Normal file
@ -0,0 +1,196 @@
|
|||||||
|
# Docker
|
||||||
|
|
||||||
|
Defines [Docker][1] aliases and functions.
|
||||||
|
|
||||||
|
## Aliases
|
||||||
|
|
||||||
|
### Docker
|
||||||
|
|
||||||
|
- `dk` is short for `docker`
|
||||||
|
- `dka` Attach to a running container
|
||||||
|
- `dkb` Build an image from a Dockerfile
|
||||||
|
- `dkd` Inspect changes on a container's filesystem
|
||||||
|
- `dkdf` Show docker filesystem usage
|
||||||
|
- `dke` Run a command in a running container
|
||||||
|
- `dkE` Run an interactive command in a running container
|
||||||
|
- `dkh` Show the history of an image
|
||||||
|
- `dki` List images
|
||||||
|
- `dkin` Return low-level information on a container, image or task
|
||||||
|
- `dkk` Kill a running container
|
||||||
|
- `dkl` Fetch the logs of a container
|
||||||
|
- `dkli` Log in to a Docker registry
|
||||||
|
- `dklo` Log out from a Docker registry
|
||||||
|
- `dkls` is alias for `dkps`
|
||||||
|
- `dkp` Pause all processes within one or more containers
|
||||||
|
- `dkP` Unpause all processes within one or more containers
|
||||||
|
- `dkpl` Pull an image or a repository from a registry
|
||||||
|
- `dkph` Push an image or a repository to a registry
|
||||||
|
- `dkps` List containers
|
||||||
|
- `dkpsa` List all containers (default lists just running)
|
||||||
|
- `dkr` Run a command in a new container
|
||||||
|
- `dkR` Run an interactive command in a new container and automatically remove
|
||||||
|
the container when it exits
|
||||||
|
- `dkRe` like `dkR` and set entry point to `/bin/bash`
|
||||||
|
- `dkrm` Remove one or more containers
|
||||||
|
- `dkrmi` Remove one or more images
|
||||||
|
- `dkrmC` Clean up exited containers
|
||||||
|
- `dkrmI` Clean up dangling images
|
||||||
|
- `dkrmV` Clean up unused volumes ( Docker >= 1.9 )
|
||||||
|
- `dkrn` Rename a container
|
||||||
|
- `dks` Start one or more stopped containers
|
||||||
|
- `dkS` Restart a container
|
||||||
|
- `dkss` Display a live stream of container(s) resource usage statistics
|
||||||
|
- `dksv` Save one or more images to a tar archive (streamed to STDOUT by
|
||||||
|
default)
|
||||||
|
- `dkt` Tag an image into a repository
|
||||||
|
- `dktop` Display the running processes of a container
|
||||||
|
- `dkup` Update configuration of one or more containers
|
||||||
|
- `dkV` Manage Docker volumes
|
||||||
|
- `dkv` Show the Docker version information
|
||||||
|
- `dkw` Block until a container stops, then print its exit code
|
||||||
|
- `dkx` Stop a running container
|
||||||
|
|
||||||
|
#### container (C)
|
||||||
|
|
||||||
|
- `dkC` Manage containers
|
||||||
|
- `dkCa` Attach to a running container
|
||||||
|
- `dkCcp` Copy files/folders between a container and the local filesystem
|
||||||
|
- `dkCd` Inspect changes on a container's filesystem
|
||||||
|
- `dkCe` Run a command in a running container
|
||||||
|
- `dkCin` Display detailed information on one or more containers
|
||||||
|
- `dkCk` Kill one or more running containers
|
||||||
|
- `dkCl` Fetch the logs of a container
|
||||||
|
- `dkCls` List containers
|
||||||
|
- `dkCp` Pause all processes within one or more containers
|
||||||
|
- `dkCpr` Remove all stopped containers
|
||||||
|
- `dkCrn` Rename a container
|
||||||
|
- `dkCS` Restart one or more containers
|
||||||
|
- `dkCrm` Remove one or more containers
|
||||||
|
- `dkCr` Run a command in a new container
|
||||||
|
- `dkCR` Run an interactive command in a new container and automatically remove
|
||||||
|
the container when it exits
|
||||||
|
- `dkCRe` like `dkCR` and set entry point to `/bin/bash`
|
||||||
|
- `dkCs` Start one or more stopped containers
|
||||||
|
- `dkCss` Display a live stream of container(s) resource usage statistics
|
||||||
|
- `dkCx` Stop one or more running containers
|
||||||
|
- `dkCtop` Display the running processes of a container
|
||||||
|
- `dkCP` Unpause all processes within one or more containers
|
||||||
|
- `dkCup` Update configuration of one or more containers
|
||||||
|
- `dkCw` Block until one or more containers stop, then print their exit codes
|
||||||
|
|
||||||
|
#### image (I)
|
||||||
|
|
||||||
|
- `dkI` Manage images
|
||||||
|
- `dkIb` Build an image from a Dockerfile
|
||||||
|
- `dkIh` Show the history of an image
|
||||||
|
- `dkIim` Import the contents from a tarball to create a filesystem image
|
||||||
|
- `dkIin` Display detailed information on one or more images
|
||||||
|
- `dkIls` List images
|
||||||
|
- `dkIpr` Remove unused images
|
||||||
|
- `dkIpl` Pull an image or a repository from a registry
|
||||||
|
- `dkIph` Push an image or a repository to a registry
|
||||||
|
- `dkIrm` Remove one or more images
|
||||||
|
- `dkIsv` Save one or more images to a tar archive (streamed to STDOUT by
|
||||||
|
default)
|
||||||
|
- `dkIt` Tag an image into a repository
|
||||||
|
|
||||||
|
#### volume (V)
|
||||||
|
|
||||||
|
- `dkV` Manage volumes
|
||||||
|
- `dkVin` Display detailed information on one or more volumes
|
||||||
|
- `dkVls` List volumes
|
||||||
|
- `dkVpr` Remove all unused volumes
|
||||||
|
- `dkVrm` Remove one or more volumes
|
||||||
|
|
||||||
|
#### network (N)
|
||||||
|
|
||||||
|
- `dkN` Manage networks
|
||||||
|
- `dkNs` Connect a container to a network
|
||||||
|
- `dkNx` Disconnects a container from a network
|
||||||
|
- `dkNin` Displays detailed information on a network
|
||||||
|
- `dkNls` Lists all the networks created by the user
|
||||||
|
- `dkNpr` Remove all unused networks
|
||||||
|
- `dkNrm` Deletes one or more networks
|
||||||
|
|
||||||
|
#### system (Y)
|
||||||
|
|
||||||
|
- `dkY` Manage Docker
|
||||||
|
- `dkYdf` Show docker filesystem usage
|
||||||
|
- `dkYpr` Remove unused data
|
||||||
|
|
||||||
|
#### stack (K)
|
||||||
|
|
||||||
|
- `dkK` Manage Docker stacks
|
||||||
|
- `dkKls` List stacks
|
||||||
|
- `dkKps` List the tasks in the stack
|
||||||
|
- `dkKrm` Remove the stack
|
||||||
|
|
||||||
|
#### swarm (W)
|
||||||
|
|
||||||
|
- `dkW` Manage Docker Swarm
|
||||||
|
|
||||||
|
### Docker Machine
|
||||||
|
|
||||||
|
- `dkm` is short for `docker-machine`
|
||||||
|
- `dkma` Get or set the active machine
|
||||||
|
- `dkmcp` Copy files between machines
|
||||||
|
- `dkmd` Set up the default machine ; alowing you to use `dkme` without
|
||||||
|
arguments
|
||||||
|
- `dkme` Set up the environment for the Docker client (eg: `dkme staging` to
|
||||||
|
toggle to staging)
|
||||||
|
- `dkmin` Inspect information about a machine
|
||||||
|
- `dkmip` Get the IP address of a machine
|
||||||
|
- `dkmk` Kill a machine
|
||||||
|
- `dkmls` List machines
|
||||||
|
- `dkmpr` Re-provision existing machines
|
||||||
|
- `dkmps` is alias for `dkmls`
|
||||||
|
- `dkmrg` Regenerate TLS Certificates for a machine
|
||||||
|
- `dkmrm` Remove a machine
|
||||||
|
- `dkms` Start a machine
|
||||||
|
- `dkmsh` Log into or run a command on a machine with SSH
|
||||||
|
- `dkmst` Get the status of a machine
|
||||||
|
- `dkmS` Restart a machine
|
||||||
|
- `dkmu` Get the URL of a machine
|
||||||
|
- `dkmup` Upgrade a machine to the latest version of Docker
|
||||||
|
- `dkmV` Show the Docker Machine version or a machine docker version
|
||||||
|
- `dkmx` Stop a machine
|
||||||
|
|
||||||
|
### Docker Compose
|
||||||
|
|
||||||
|
- `dkc` is short for `docker-compose`
|
||||||
|
- `dkcb` Build or rebuild services
|
||||||
|
- `dkcB` Build or rebuild services and do not use cache when building the image
|
||||||
|
- `dkcd` Stop and remove containers, networks, images, and volumes
|
||||||
|
- `dkce` Execute a command in a running container
|
||||||
|
- `dkck` Kill containers
|
||||||
|
- `dkcl` View output from containers
|
||||||
|
- `dkcls` is alias for `dkcps`
|
||||||
|
- `dkcp` Pause services
|
||||||
|
- `dkcP` Unpause services
|
||||||
|
- `dkcpl` Pull service images
|
||||||
|
- `dkcph` Push service images
|
||||||
|
- `dkcps` List containers
|
||||||
|
- `dkcr` Run a one-off command
|
||||||
|
- `dkcR` Run a one-off command and remove container after run.
|
||||||
|
- `dkcrm` Remove stopped containers
|
||||||
|
- `dkcs` Start services
|
||||||
|
- `dkcsc` Set number of containers for a service
|
||||||
|
- `dkcS` Restart services
|
||||||
|
- `dkcu` Create and start containers
|
||||||
|
- `dkcU` Create and start containers in detached mode: Run containers in the
|
||||||
|
background, print new container names
|
||||||
|
- `dkcV` Show the Docker-Compose version information
|
||||||
|
- `dkcx` Stop services
|
||||||
|
|
||||||
|
## Support
|
||||||
|
|
||||||
|
If you're having problems, use the [Prezto issue tracker][2].
|
||||||
|
|
||||||
|
## Acknowledgements
|
||||||
|
|
||||||
|
This module is a copy of [akarzim/zsh-docker-aliases][3] by [François Vantomme][4] (MIT License).
|
||||||
|
|
||||||
|
[1]: https://www.docker.com/
|
||||||
|
[2]: https://github.com/zsh-users/prezto/issues
|
||||||
|
[3]: https://github.com/akarzim/zsh-docker-aliases
|
||||||
|
[4]: https://github.com/akarzim
|
177
modules/docker/alias.zsh
Normal file
177
modules/docker/alias.zsh
Normal file
@ -0,0 +1,177 @@
|
|||||||
|
#
|
||||||
|
# Defines Docker aliases.
|
||||||
|
#
|
||||||
|
# Author:
|
||||||
|
# François Vantomme <akarzim@gmail.com>
|
||||||
|
#
|
||||||
|
|
||||||
|
#
|
||||||
|
# Aliases
|
||||||
|
#
|
||||||
|
|
||||||
|
# Docker
|
||||||
|
alias dk='docker'
|
||||||
|
alias dka='docker attach'
|
||||||
|
alias dkb='docker build'
|
||||||
|
alias dkd='docker diff'
|
||||||
|
alias dkdf='docker system df'
|
||||||
|
alias dke='docker exec'
|
||||||
|
alias dkE='docker exec -it'
|
||||||
|
alias dkh='docker history'
|
||||||
|
alias dki='docker images'
|
||||||
|
alias dkin='docker inspect'
|
||||||
|
alias dkim='docker import'
|
||||||
|
alias dkk='docker kill'
|
||||||
|
alias dkl='docker logs'
|
||||||
|
alias dkli='docker login'
|
||||||
|
alias dklo='docker logout'
|
||||||
|
alias dkls='docker ps'
|
||||||
|
alias dkp='docker pause'
|
||||||
|
alias dkP='docker unpause'
|
||||||
|
alias dkpl='docker pull'
|
||||||
|
alias dkph='docker push'
|
||||||
|
alias dkps='docker ps'
|
||||||
|
alias dkpsa='docker ps -a'
|
||||||
|
alias dkr='docker run'
|
||||||
|
alias dkR='docker run -it --rm'
|
||||||
|
alias dkRe='docker run -it --rm --entrypoint /bin/bash'
|
||||||
|
alias dkRM='docker system prune'
|
||||||
|
alias dkrm='docker rm'
|
||||||
|
alias dkrmi='docker rmi'
|
||||||
|
alias dkrn='docker rename'
|
||||||
|
alias dks='docker start'
|
||||||
|
alias dkS='docker restart'
|
||||||
|
alias dkss='docker stats'
|
||||||
|
alias dksv='docker save'
|
||||||
|
alias dkt='docker tag'
|
||||||
|
alias dktop='docker top'
|
||||||
|
alias dkup='docker update'
|
||||||
|
alias dkV='docker volume'
|
||||||
|
alias dkv='docker version'
|
||||||
|
alias dkw='docker wait'
|
||||||
|
alias dkx='docker stop'
|
||||||
|
|
||||||
|
## Container (C)
|
||||||
|
alias dkC='docker container'
|
||||||
|
alias dkCa='docker container attach'
|
||||||
|
alias dkCcp='docker container cp'
|
||||||
|
alias dkCd='docker container diff'
|
||||||
|
alias dkCe='docker container exec'
|
||||||
|
alias dkCin='docker container inspect'
|
||||||
|
alias dkCk='docker container kill'
|
||||||
|
alias dkCl='docker container logs'
|
||||||
|
alias dkCls='docker container ls'
|
||||||
|
alias dkCp='docker container pause'
|
||||||
|
alias dkCpr='docker container prune'
|
||||||
|
alias dkCrn='docker container rename'
|
||||||
|
alias dkCS='docker container restart'
|
||||||
|
alias dkCrm='docker container rm'
|
||||||
|
alias dkCr='docker container run'
|
||||||
|
alias dkCR='docker container run -it --rm'
|
||||||
|
alias dkCRe='docker container run -it --rm --entrypoint /bin/bash'
|
||||||
|
alias dkCs='docker container start'
|
||||||
|
alias dkCss='docker container stats'
|
||||||
|
alias dkCx='docker container stop'
|
||||||
|
alias dkCtop='docker container top'
|
||||||
|
alias dkCP='docker container unpause'
|
||||||
|
alias dkCup='docker container update'
|
||||||
|
alias dkCw='docker container wait'
|
||||||
|
|
||||||
|
## Image (I)
|
||||||
|
alias dkI='docker image'
|
||||||
|
alias dkIb='docker image build'
|
||||||
|
alias dkIh='docker image history'
|
||||||
|
alias dkIim='docker image import'
|
||||||
|
alias dkIin='docker image inspect'
|
||||||
|
alias dkIls='docker image ls'
|
||||||
|
alias dkIpr='docker image prune'
|
||||||
|
alias dkIpl='docker image pull'
|
||||||
|
alias dkIph='docker image push'
|
||||||
|
alias dkIrm='docker image rm'
|
||||||
|
alias dkIsv='docker image save'
|
||||||
|
alias dkIt='docker image tag'
|
||||||
|
|
||||||
|
## Volume (V)
|
||||||
|
alias dkV='docker volume'
|
||||||
|
alias dkVin='docker volume inspect'
|
||||||
|
alias dkVls='docker volume ls'
|
||||||
|
alias dkVpr='docker volume prune'
|
||||||
|
alias dkVrm='docker volume rm'
|
||||||
|
|
||||||
|
## Network (N)
|
||||||
|
alias dkN='docker network'
|
||||||
|
alias dkNs='docker network connect'
|
||||||
|
alias dkNx='docker network disconnect'
|
||||||
|
alias dkNin='docker network inspect'
|
||||||
|
alias dkNls='docker network ls'
|
||||||
|
alias dkNpr='docker network prune'
|
||||||
|
alias dkNrm='docker network rm'
|
||||||
|
|
||||||
|
## System (Y)
|
||||||
|
alias dkY='docker system'
|
||||||
|
alias dkYdf='docker system df'
|
||||||
|
alias dkYpr='docker system prune'
|
||||||
|
|
||||||
|
## Stack (K)
|
||||||
|
alias dkK='docker stack'
|
||||||
|
alias dkKls='docker stack ls'
|
||||||
|
alias dkKps='docker stack ps'
|
||||||
|
alias dkKrm='docker stack rm'
|
||||||
|
|
||||||
|
## Swarm (W)
|
||||||
|
alias dkW='docker swarm'
|
||||||
|
|
||||||
|
## CleanUp (rm)
|
||||||
|
# Clean up exited containers (docker < 1.13)
|
||||||
|
alias dkrmC='docker rm $(docker ps -qaf status=exited)'
|
||||||
|
# Clean up dangling images (docker < 1.13)
|
||||||
|
alias dkrmI='docker rmi $(docker images -qf dangling=true)'
|
||||||
|
# Clean up dangling volumes (docker < 1.13)
|
||||||
|
alias dkrmV='docker volume rm $(docker volume ls -qf dangling=true)'
|
||||||
|
|
||||||
|
|
||||||
|
# Docker Machine (m)
|
||||||
|
alias dkm='docker-machine'
|
||||||
|
alias dkma='docker-machine active'
|
||||||
|
alias dkmcp='docker-machine scp'
|
||||||
|
alias dkmin='docker-machine inspect'
|
||||||
|
alias dkmip='docker-machine ip'
|
||||||
|
alias dkmk='docker-machine kill'
|
||||||
|
alias dkmls='docker-machine ls'
|
||||||
|
alias dkmpr='docker-machine provision'
|
||||||
|
alias dkmps='docker-machine ps'
|
||||||
|
alias dkmrg='docker-machine regenerate-certs'
|
||||||
|
alias dkmrm='docker-machine rm'
|
||||||
|
alias dkms='docker-machine start'
|
||||||
|
alias dkmsh='docker-machine ssh'
|
||||||
|
alias dkmst='docker-machine status'
|
||||||
|
alias dkmS='docker-machine restart'
|
||||||
|
alias dkmu='docker-machine url'
|
||||||
|
alias dkmup='docker-machine upgrade'
|
||||||
|
alias dkmv='docker-machine version'
|
||||||
|
alias dkmx='docker-machine stop'
|
||||||
|
|
||||||
|
# Docker Compose (c)
|
||||||
|
alias dkc='docker-compose'
|
||||||
|
alias dkcb='docker-compose build'
|
||||||
|
alias dkcB='docker-compose build --no-cache'
|
||||||
|
alias dkcd='docker-compose down'
|
||||||
|
alias dkce='docker-compose exec'
|
||||||
|
alias dkck='docker-compose kill'
|
||||||
|
alias dkcl='docker-compose logs'
|
||||||
|
alias dkcls='docker-compose ps'
|
||||||
|
alias dkcp='docker-compose pause'
|
||||||
|
alias dkcP='docker-compose unpause'
|
||||||
|
alias dkcpl='docker-compose pull'
|
||||||
|
alias dkcph='docker-compose push'
|
||||||
|
alias dkcps='docker-compose ps'
|
||||||
|
alias dkcr='docker-compose run'
|
||||||
|
alias dkcR='docker-compose run --rm'
|
||||||
|
alias dkcrm='docker-compose rm'
|
||||||
|
alias dkcs='docker-compose start'
|
||||||
|
alias dkcsc='docker-compose scale'
|
||||||
|
alias dkcS='docker-compose restart'
|
||||||
|
alias dkcu='docker-compose up'
|
||||||
|
alias dkcU='docker-compose up -d'
|
||||||
|
alias dkcv='docker-compose version'
|
||||||
|
alias dkcx='docker-compose stop'
|
Some files were not shown because too many files have changed in this diff Show More
Reference in New Issue
Block a user