mirror of
https://github.com/dcarrillo/prezto.git
synced 2025-07-01 18:39:26 +00:00
Compare commits
4 Commits
pull/556-p
...
issue/276-
Author | SHA1 | Date | |
---|---|---|---|
5be4a78b55 | |||
2fbc02c689 | |||
87bbbca9bd | |||
cc2f163ad1 |
@ -9,7 +9,8 @@ Installation
|
||||
------------
|
||||
|
||||
Prezto will work with any recent release of Zsh, but the minimum recommended
|
||||
version is 4.3.11.
|
||||
version is 4.3.11. Unfortunately, [Cygwin][9] is not supported due to
|
||||
non-standard core utilities.
|
||||
|
||||
1. Launch Zsh:
|
||||
|
||||
@ -36,7 +37,7 @@ version is 4.3.11.
|
||||
### Troubleshooting
|
||||
|
||||
If you are not able to find certain commands after switching to *Prezto*,
|
||||
modify the `PATH` variable in *~/.zprofile* then open a new Zsh terminal
|
||||
modify the `PATH` variable in *~/.zshenv* then open a new Zsh terminal
|
||||
window or tab.
|
||||
|
||||
Updating
|
||||
@ -85,8 +86,7 @@ License
|
||||
|
||||
(The MIT License)
|
||||
|
||||
Copyright (c) 2009-2011 Robby Russell and contributors.
|
||||
Copyright (c) 2011-2014 Sorin Ionescu and contributors.
|
||||
Copyright (c) 2009-2014 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
|
||||
@ -114,4 +114,5 @@ SOFTWARE.
|
||||
[6]: http://gitref.org
|
||||
[7]: http://www.bash2zsh.com/zsh_refcard/refcard.pdf
|
||||
[8]: http://grml.org/zsh/zsh-lovers.html
|
||||
[9]: http://www.cygwin.com
|
||||
|
||||
|
55
documentation/man/man1/prezto-archive.1
Normal file
55
documentation/man/man1/prezto-archive.1
Normal file
@ -0,0 +1,55 @@
|
||||
.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
|
17
documentation/man/man1/prezto-command-not-found.1
Normal file
17
documentation/man/man1/prezto-command-not-found.1
Normal file
@ -0,0 +1,17 @@
|
||||
.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
|
27
documentation/man/man1/prezto-completion.1
Normal file
27
documentation/man/man1/prezto-completion.1
Normal file
@ -0,0 +1,27 @@
|
||||
.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
|
49
documentation/man/man1/prezto-directory.1
Normal file
49
documentation/man/man1/prezto-directory.1
Normal file
@ -0,0 +1,49 @@
|
||||
.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
|
63
documentation/man/man1/prezto-dpkg.1
Normal file
63
documentation/man/man1/prezto-dpkg.1
Normal file
@ -0,0 +1,63 @@
|
||||
.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
|
22
documentation/man/man1/prezto-environment.1
Normal file
22
documentation/man/man1/prezto-environment.1
Normal file
@ -0,0 +1,22 @@
|
||||
.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
|
31
documentation/man/man1/prezto-gnu-utility.1
Normal file
31
documentation/man/man1/prezto-gnu-utility.1
Normal file
@ -0,0 +1,31 @@
|
||||
.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
|
20
documentation/man/man1/prezto-gpg-agent.1
Normal file
20
documentation/man/man1/prezto-gpg-agent.1
Normal file
@ -0,0 +1,20 @@
|
||||
.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
|
27
documentation/man/man1/prezto-haskell.1
Normal file
27
documentation/man/man1/prezto-haskell.1
Normal file
@ -0,0 +1,27 @@
|
||||
.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
|
29
documentation/man/man1/prezto-helper.1
Normal file
29
documentation/man/man1/prezto-helper.1
Normal file
@ -0,0 +1,29 @@
|
||||
.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
|
55
documentation/man/man1/prezto-history-substring-search.1
Normal file
55
documentation/man/man1/prezto-history-substring-search.1
Normal file
@ -0,0 +1,55 @@
|
||||
.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
|
62
documentation/man/man1/prezto-history.1
Normal file
62
documentation/man/man1/prezto-history.1
Normal file
@ -0,0 +1,62 @@
|
||||
.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
|
35
documentation/man/man1/prezto-macports.1
Normal file
35
documentation/man/man1/prezto-macports.1
Normal file
@ -0,0 +1,35 @@
|
||||
.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
|
29
documentation/man/man1/prezto-node.1
Normal file
29
documentation/man/man1/prezto-node.1
Normal file
@ -0,0 +1,29 @@
|
||||
.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
|
48
documentation/man/man1/prezto-osx.1
Normal file
48
documentation/man/man1/prezto-osx.1
Normal file
@ -0,0 +1,48 @@
|
||||
.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
|
84
documentation/man/man1/prezto-pacman.1
Normal file
84
documentation/man/man1/prezto-pacman.1
Normal file
@ -0,0 +1,84 @@
|
||||
.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
|
74
documentation/man/man1/prezto-perl.1
Normal file
74
documentation/man/man1/prezto-perl.1
Normal file
@ -0,0 +1,74 @@
|
||||
.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
|
108
documentation/man/man1/prezto-prompt.1
Normal file
108
documentation/man/man1/prezto-prompt.1
Normal file
@ -0,0 +1,108 @@
|
||||
.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
|
119
documentation/man/man1/prezto-python.1
Normal file
119
documentation/man/man1/prezto-python.1
Normal file
@ -0,0 +1,119 @@
|
||||
.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
|
56
documentation/man/man1/prezto-rails.1
Normal file
56
documentation/man/man1/prezto-rails.1
Normal file
@ -0,0 +1,56 @@
|
||||
.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
|
34
documentation/man/man1/prezto-rsync.1
Normal file
34
documentation/man/man1/prezto-rsync.1
Normal file
@ -0,0 +1,34 @@
|
||||
.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
|
97
documentation/man/man1/prezto-ruby.1
Normal file
97
documentation/man/man1/prezto-ruby.1
Normal file
@ -0,0 +1,97 @@
|
||||
.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
|
37
documentation/man/man1/prezto-screen.1
Normal file
37
documentation/man/man1/prezto-screen.1
Normal file
@ -0,0 +1,37 @@
|
||||
.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
|
145
documentation/man/man1/prezto-spectrum.1
Normal file
145
documentation/man/man1/prezto-spectrum.1
Normal file
@ -0,0 +1,145 @@
|
||||
.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
|
53
documentation/man/man1/prezto-ssh-agent.1
Normal file
53
documentation/man/man1/prezto-ssh-agent.1
Normal file
@ -0,0 +1,53 @@
|
||||
.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
|
53
documentation/man/man1/prezto-syntax-highlighting.1
Normal file
53
documentation/man/man1/prezto-syntax-highlighting.1
Normal file
@ -0,0 +1,53 @@
|
||||
.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
|
26
documentation/man/man1/prezto-terminal.1
Normal file
26
documentation/man/man1/prezto-terminal.1
Normal file
@ -0,0 +1,26 @@
|
||||
.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
|
61
documentation/man/man1/prezto-tmux.1
Normal file
61
documentation/man/man1/prezto-tmux.1
Normal file
@ -0,0 +1,61 @@
|
||||
.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
|
233
documentation/man/man1/prezto-utility.1
Normal file
233
documentation/man/man1/prezto-utility.1
Normal file
@ -0,0 +1,233 @@
|
||||
.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
|
43
documentation/man/man1/prezto-wakeonlan.1
Normal file
43
documentation/man/man1/prezto-wakeonlan.1
Normal file
@ -0,0 +1,43 @@
|
||||
.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
|
40
documentation/man/man1/prezto-yum.1
Normal file
40
documentation/man/man1/prezto-yum.1
Normal file
@ -0,0 +1,40 @@
|
||||
.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
|
23
documentation/man/man1/prezto-z.1
Normal file
23
documentation/man/man1/prezto-z.1
Normal file
@ -0,0 +1,23 @@
|
||||
.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
|
199
documentation/man/man1/prezto.1
Normal file
199
documentation/man/man1/prezto.1
Normal file
@ -0,0 +1,199 @@
|
||||
.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.
|
@ -9,20 +9,17 @@ Aliases
|
||||
- `cdf` changes the current working director to the current _Finder_
|
||||
directory.
|
||||
- `pushdf` pushes the current working directory onto the directory queue and
|
||||
changes the current working director to the current _Finder_ directory.
|
||||
- `ql` quick looks at files.
|
||||
- `rm-osx-cruft` deletes .DS\_Store, \_\_MACOSX cruft.
|
||||
|
||||
Functions
|
||||
---------
|
||||
|
||||
- `mand` opens _man_ pages in [_Dash.app_][2].
|
||||
- `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]).
|
||||
- `ql` previews files in Quick Look.
|
||||
- `osx-rm-dir-metadata` deletes .DS\_Store, \_\_MACOSX cruft.
|
||||
- `osx-ls-download-history` displays the Mac OS X download history.
|
||||
- `osx-rm-download-history` deletes the Mac OS X download history.
|
||||
|
||||
Authors
|
||||
-------
|
||||
@ -32,6 +29,7 @@ Authors
|
||||
- [Sorin Ionescu](https://github.com/sorin-ionescu)
|
||||
|
||||
[1]: http://www.apple.com/macosx/
|
||||
[2]: http://kapeli.com/dash
|
||||
[2]: http://bruji.com/bwana/
|
||||
[3]: http://www.iterm2.com/
|
||||
[4]: https://github.com/sorin-ionescu/prezto/issues
|
||||
|
@ -30,10 +30,6 @@ 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.
|
||||
|
||||
You can specify the perlbrew location so the environment is automatically loaded.
|
||||
|
||||
zstyle ':prezto:module:perl:perlbrew' location '/path/to/perlbrew'
|
||||
|
||||
Aliases
|
||||
-------
|
||||
|
@ -8,7 +8,7 @@ Local Gem Installation
|
||||
----------------------
|
||||
|
||||
When a Ruby version manager is not detected, local gems are installed in
|
||||
*~/.gems*; otherwise, they are installed according to the manager.
|
||||
*~/Library/Ruby/Gems/1.8* on Mac OS X.
|
||||
|
||||
RVM
|
||||
---
|
||||
@ -20,33 +20,15 @@ home directory.
|
||||
Since RVM is loaded into the shell and is known to override shell commands, it
|
||||
may conflict with shell scripts.
|
||||
|
||||
Load this module as late as possible when using RVM since RVM will complain if
|
||||
it is not first in `$PATH`.
|
||||
|
||||
rbenv
|
||||
-----
|
||||
|
||||
An alternative RVM is to use [rbenv][3], which allows for switching between
|
||||
multiple, isolated Ruby installations in the home directory.
|
||||
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.
|
||||
|
||||
chruby
|
||||
------
|
||||
|
||||
Yet another alternative is [chruby][6], which is simpler than both RVM and
|
||||
rbenv.
|
||||
|
||||
### Settings
|
||||
|
||||
#### Auto-Switch
|
||||
|
||||
To enable auto switching the Ruby version on directory change based on the
|
||||
.ruby-version file, add the following line to *zpreztorc*:
|
||||
|
||||
zstyle ':prezto:module:ruby:chruby' auto-switch 'yes'
|
||||
|
||||
Bundler
|
||||
-------
|
||||
|
||||
@ -105,4 +87,4 @@ Authors
|
||||
[3]: https://github.com/sstephenson/rbenv
|
||||
[4]: http://gembundler.com
|
||||
[5]: https://github.com/sorin-ionescu/prezto/issues
|
||||
[6]: https://github.com/postmodern/chruby
|
||||
|
@ -50,7 +50,6 @@ Aliases
|
||||
|
||||
### Disabled File Globbing
|
||||
|
||||
- `bower`
|
||||
- `fc`
|
||||
- `find`
|
||||
- `ftp`
|
151
documentation/markdown/prezto.md
Normal file
151
documentation/markdown/prezto.md
Normal file
@ -0,0 +1,151 @@
|
||||
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
|
||||
|
2
init.zsh
2
init.zsh
@ -25,7 +25,7 @@ unset min_zsh_version
|
||||
function pmodload {
|
||||
local -a pmodules
|
||||
local pmodule
|
||||
local pfunction_glob='^([_.]*|prompt_*_setup|README*)(-.N:t)'
|
||||
local pfunction_glob='^([_.]*|prompt_*_setup|README*)(.N:t)'
|
||||
|
||||
# $argv is overridden in the anonymous function.
|
||||
pmodules=("$argv[@]")
|
||||
|
@ -107,39 +107,30 @@ function editor-info {
|
||||
}
|
||||
zle -N editor-info
|
||||
|
||||
# Updates editor information when the keymap changes.
|
||||
function zle-keymap-select {
|
||||
# Ensures that $terminfo values are valid and updates editor information when
|
||||
# the keymap changes.
|
||||
function zle-keymap-select zle-line-init zle-line-finish {
|
||||
# The terminal must be in application mode when ZLE is active for $terminfo
|
||||
# values to be valid.
|
||||
if (( $+terminfo[smkx] && $+terminfo[rmkx] )); then
|
||||
case "$0" in
|
||||
(zle-line-init)
|
||||
# Enable terminal application mode.
|
||||
echoti smkx
|
||||
;;
|
||||
(zle-line-finish)
|
||||
# Disable terminal application mode.
|
||||
echoti rmkx
|
||||
;;
|
||||
esac
|
||||
fi
|
||||
|
||||
# Update editor information.
|
||||
zle editor-info
|
||||
}
|
||||
zle -N zle-keymap-select
|
||||
|
||||
# Enables terminal application mode and updates editor information.
|
||||
function zle-line-init {
|
||||
# The terminal must be in application mode when ZLE is active for $terminfo
|
||||
# values to be valid.
|
||||
if (( $+terminfo[smkx] )); then
|
||||
# Enable terminal application mode.
|
||||
echoti smkx
|
||||
fi
|
||||
|
||||
# Update editor information.
|
||||
zle editor-info
|
||||
}
|
||||
zle -N zle-line-init
|
||||
|
||||
# Disables terminal application mode and updates editor information.
|
||||
function zle-line-finish {
|
||||
# The terminal must be in application mode when ZLE is active for $terminfo
|
||||
# values to be valid.
|
||||
if (( $+terminfo[rmkx] )); then
|
||||
# Disable terminal application mode.
|
||||
echoti rmkx
|
||||
fi
|
||||
|
||||
# Update editor information.
|
||||
zle editor-info
|
||||
}
|
||||
zle -N zle-line-finish
|
||||
zle -N zle-line-init
|
||||
|
||||
# Toggles emacs overwrite mode and updates editor information.
|
||||
function overwrite-mode {
|
||||
|
@ -56,3 +56,13 @@ if zstyle -t ':prezto:environment:termcap' color; then
|
||||
export LESS_TERMCAP_us=$'\E[01;32m' # Begins underline.
|
||||
fi
|
||||
|
||||
#
|
||||
# Paths
|
||||
#
|
||||
|
||||
# Set the list of directories that man searches for manuals.
|
||||
manpath=(
|
||||
${ZDOTDIR:-$HOME}/.zprezto/documentation/man
|
||||
$manpath
|
||||
)
|
||||
|
||||
|
@ -12,7 +12,7 @@ fi
|
||||
|
||||
# Set the default paths to gpg-agent files.
|
||||
_gpg_agent_conf="$HOME/.gnupg/gpg-agent.conf"
|
||||
_gpg_agent_env="${TMPDIR:-/tmp}/gpg-agent.env"
|
||||
_gpg_agent_env="$TMPDIR/gpg-agent.env"
|
||||
|
||||
# Start gpg-agent if not started.
|
||||
if ! ps -U "$USER" -o ucomm | grep -q gpg-agent; then
|
||||
|
@ -1,8 +1,8 @@
|
||||
#compdef mand manp
|
||||
#compdef manb manp
|
||||
#autoload
|
||||
|
||||
#
|
||||
# Completes mand and manp.
|
||||
# Completes manb and manp.
|
||||
#
|
||||
# Authors:
|
||||
# Sorin Ionescu <sorin.ionescu@gmail.com>
|
24
modules/osx/functions/manb
Normal file
24
modules/osx/functions/manb
Normal file
@ -0,0 +1,24 @@
|
||||
#
|
||||
# Opens man pages in Bwana.app.
|
||||
#
|
||||
# Authors:
|
||||
# Sorin Ionescu <sorin.ionescu@gmail.com>
|
||||
#
|
||||
|
||||
function manb {
|
||||
local page
|
||||
if (( $# > 0 )); then
|
||||
for page in "$@"; do
|
||||
open "man:$page" 2>/dev/null
|
||||
if (( $? != 0 )); then
|
||||
print "$0: Bwana is not installed" >&2
|
||||
break
|
||||
fi
|
||||
done
|
||||
else
|
||||
print 'What manual page do you want?' >&2
|
||||
fi
|
||||
}
|
||||
|
||||
manb "$@"
|
||||
|
@ -1,21 +0,0 @@
|
||||
#
|
||||
# Opens man pages in Dash.app.
|
||||
#
|
||||
# Authors:
|
||||
# Sorin Ionescu <sorin.ionescu@gmail.com>
|
||||
#
|
||||
|
||||
function mand {
|
||||
if (( $# > 0 )); then
|
||||
open "dash://manpages:$1" 2>/dev/null
|
||||
if (( $? != 0 )); then
|
||||
print "$0: Dash is not installed" >&2
|
||||
break
|
||||
fi
|
||||
else
|
||||
print 'What manual page do you want?' >&2
|
||||
fi
|
||||
}
|
||||
|
||||
mand "$@"
|
||||
|
@ -1,13 +0,0 @@
|
||||
#
|
||||
# Displays the Mac OS X download history.
|
||||
#
|
||||
# Authors:
|
||||
# Sorin Ionescu <sorin.ionescu@gmail.com>
|
||||
#
|
||||
|
||||
local db
|
||||
for db in ~/Library/Preferences/com.apple.LaunchServices.QuarantineEventsV*; do
|
||||
if grep -q 'LSQuarantineEvent' < <(sqlite3 "$db" .tables); then
|
||||
sqlite3 "$db" 'SELECT LSQuarantineDataURLString FROM LSQuarantineEvent'
|
||||
fi
|
||||
done
|
@ -1,11 +0,0 @@
|
||||
#
|
||||
# Deletes .DS_Store and __MACOSX directories.
|
||||
#
|
||||
# Authors:
|
||||
# Sorin Ionescu <sorin.ionescu@gmail.com>
|
||||
#
|
||||
|
||||
find "${@:-$PWD}" \( \
|
||||
-type f -name '.DS_Store' -o \
|
||||
-type d -name '__MACOSX' \
|
||||
\) -print0 | xargs -0 rm -rf
|
@ -1,13 +0,0 @@
|
||||
#
|
||||
# Deletes the Mac OS X download history.
|
||||
#
|
||||
# Authors:
|
||||
# Sorin Ionescu <sorin.ionescu@gmail.com>
|
||||
#
|
||||
|
||||
local db
|
||||
for db in ~/Library/Preferences/com.apple.LaunchServices.QuarantineEventsV*; do
|
||||
if grep -q 'LSQuarantineEvent' < <(sqlite3 "$db" .tables); then
|
||||
sqlite3 "$db" 'DELETE FROM LSQuarantineEvent; VACUUM'
|
||||
fi
|
||||
done
|
@ -7,6 +7,7 @@
|
||||
|
||||
osascript 2>/dev/null <<EOF
|
||||
tell application "Finder"
|
||||
return POSIX path of (target of first window as text)
|
||||
return POSIX path of (target of window 1 as alias)
|
||||
end tell
|
||||
EOF
|
||||
|
||||
|
@ -5,11 +5,14 @@
|
||||
# Sorin Ionescu <sorin.ionescu@gmail.com>
|
||||
#
|
||||
|
||||
osascript 2>&1 <<EOF
|
||||
osascript 2>/dev/null <<EOF
|
||||
set output to ""
|
||||
tell application "Finder" to set the_selection to selection
|
||||
if the_selection is not {}
|
||||
repeat with an_item in the_selection
|
||||
log POSIX path of (an_item as text)
|
||||
end repeat
|
||||
end if
|
||||
set item_count to count the_selection
|
||||
repeat with item_index from 1 to count the_selection
|
||||
if item_index is less than item_count then set the_delimiter to "\n"
|
||||
if item_index is item_count then set the_delimiter to ""
|
||||
set output to output & ((item item_index of the_selection as alias)'s POSIX path) & the_delimiter
|
||||
end repeat
|
||||
EOF
|
||||
|
||||
|
@ -1,10 +0,0 @@
|
||||
#
|
||||
# Previews files in Quick Look.
|
||||
#
|
||||
# Authors:
|
||||
# Sorin Ionescu <sorin.ionescu@gmail.com>
|
||||
#
|
||||
|
||||
if (( $# > 0 )); then
|
||||
qlmanage -p "$@" &> /dev/null
|
||||
fi
|
@ -14,8 +14,26 @@ fi
|
||||
# Aliases
|
||||
#
|
||||
|
||||
# Changes directory to the current Finder directory.
|
||||
# Change directory to the current Finder directory.
|
||||
alias cdf='cd "$(pfd)"'
|
||||
|
||||
# Pushes directory to the current Finder directory.
|
||||
# Push directory to the current Finder directory.
|
||||
alias pushdf='pushd "$(pfd)"'
|
||||
|
||||
#
|
||||
# Functions
|
||||
#
|
||||
|
||||
# Open files in Quick Look.
|
||||
function ql {
|
||||
(( $# > 0 )) && qlmanage -p "$@" &> /dev/null
|
||||
}
|
||||
|
||||
# Delete .DS_Store and __MACOSX directories.
|
||||
function rm-osx-cruft {
|
||||
find "${@:-$PWD}" \( \
|
||||
-type f -name '.DS_Store' -o \
|
||||
-type d -name '__MACOSX' \
|
||||
\) -print0 | xargs -0 rm -rf
|
||||
}
|
||||
|
||||
|
@ -6,7 +6,7 @@
|
||||
# Sorin Ionescu <sorin.ionescu@gmail.com>
|
||||
#
|
||||
|
||||
local tmp="${TMPDIR:-/tmp}/pacman-disowned-$UID-$$"
|
||||
local tmp="$TMPDIR/pacman-disowned-$UID-$$"
|
||||
local db="$tmp/db"
|
||||
local fs="$tmp/fs"
|
||||
|
||||
|
@ -27,9 +27,6 @@ if (( $+commands[$_pacman_frontend] )); then
|
||||
if [[ -s "${0:h}/${_pacman_frontend}.zsh" ]]; then
|
||||
source "${0:h}/${_pacman_frontend}.zsh"
|
||||
fi
|
||||
else
|
||||
_pacman_frontend='pacman'
|
||||
_pacman_sudo='sudo '
|
||||
fi
|
||||
|
||||
#
|
||||
@ -37,49 +34,49 @@ fi
|
||||
#
|
||||
|
||||
# Pacman.
|
||||
alias pac="${_pacman_frontend}"
|
||||
alias pac='pacman'
|
||||
|
||||
# Installs packages from repositories.
|
||||
alias paci="${_pacman_sudo}${_pacman_frontend} --sync"
|
||||
alias paci='sudo pacman --sync'
|
||||
|
||||
# Installs packages from files.
|
||||
alias pacI="${_pacman_sudo}${_pacman_frontend} --upgrade"
|
||||
alias pacI='sudo pacman --upgrade'
|
||||
|
||||
# Removes packages and unneeded dependencies.
|
||||
alias pacx="${_pacman_sudo}${_pacman_frontend} --remove"
|
||||
alias pacx='sudo pacman --remove'
|
||||
|
||||
# Removes packages, their configuration, and unneeded dependencies.
|
||||
alias pacX="${_pacman_sudo}${_pacman_frontend} --remove --nosave --recursive"
|
||||
alias pacX='sudo pacman --remove --nosave --recursive'
|
||||
|
||||
# Displays information about a package from the repositories.
|
||||
alias pacq="${_pacman_frontend} --sync --info"
|
||||
alias pacq='pacman --sync --info'
|
||||
|
||||
# Displays information about a package from the local database.
|
||||
alias pacQ="${_pacman_frontend} --query --info"
|
||||
alias pacQ='pacman --query --info'
|
||||
|
||||
# Searches for packages in the repositories.
|
||||
alias pacs="${_pacman_frontend} --sync --search"
|
||||
alias pacs='pacman --sync --search'
|
||||
|
||||
# Searches for packages in the local database.
|
||||
alias pacS="${_pacman_frontend} --query --search"
|
||||
alias pacS='pacman --query --search'
|
||||
|
||||
# Lists orphan packages.
|
||||
alias pacman-list-orphans="${_pacman_sudo}${_pacman_frontend} --query --deps --unrequired"
|
||||
alias pacman-list-orphans='sudo pacman --query --deps --unrequired'
|
||||
|
||||
# Removes orphan packages.
|
||||
alias pacman-remove-orphans="${_pacman_sudo}${_pacman_frontend} --remove --recursive \$(${_pacman_frontend} --quiet --query --deps --unrequired)"
|
||||
alias pacman-remove-orphans='sudo pacman --remove --recursive $(pacman --quiet --query --deps --unrequired)'
|
||||
|
||||
# Synchronizes the local package and Arch Build System databases against the
|
||||
# repositories.
|
||||
if (( $+commands[abs] )); then
|
||||
alias pacu="${_pacman_sudo}${_pacman_frontend} --sync --refresh && ${_pacman_sudo}abs"
|
||||
alias pacu='sudo pacman --sync --refresh && sudo abs'
|
||||
else
|
||||
alias pacu="${_pacman_sudo}${_pacman_frontend} --sync --refresh"
|
||||
alias pacu='sudo pacman --sync --refresh'
|
||||
fi
|
||||
|
||||
# Synchronizes the local package database against the repositories then
|
||||
# upgrades outdated packages.
|
||||
alias pacU="${_pacman_sudo}${_pacman_frontend} --sync --refresh --sysupgrade"
|
||||
alias pacU='sudo pacman --sync --refresh --sysupgrade'
|
||||
|
||||
unset _pacman_{frontend,sudo}
|
||||
unset _pacman_frontend
|
||||
|
||||
|
@ -11,9 +11,9 @@
|
||||
|
||||
# Disable color.
|
||||
if ! zstyle -t ':prezto:module:pacman:yaourt' color; then
|
||||
alias pacman='yaourt --nocolor'
|
||||
alias pacman='pacman --nocolor'
|
||||
fi
|
||||
|
||||
# Manages .pac* files.
|
||||
alias pacc='yaourt -C'
|
||||
alias pacc='pacman -C'
|
||||
|
||||
|
@ -29,13 +29,6 @@ if [[ "$OSTYPE" == darwin* ]]; then
|
||||
|
||||
unset perl_path
|
||||
unset cache_file
|
||||
|
||||
# Perlbrew
|
||||
zstyle -s ':prezto:module:perl:perlbrew' location '_perlbrew_root'
|
||||
if [[ -s "${_perlbrew_root}/etc/bashrc" ]]; then
|
||||
export PERLBREW_ROOT="${_perlbrew_root}"
|
||||
source "${_perlbrew_root}/etc/bashrc"
|
||||
fi
|
||||
fi
|
||||
|
||||
#
|
||||
|
@ -18,8 +18,6 @@ if (( $+commands[rvm-prompt] )); then
|
||||
version="$(rvm-prompt)"
|
||||
elif (( $+commands[rbenv] )); then
|
||||
version="$(rbenv version-name)"
|
||||
elif (( $+commands[ruby] )); then
|
||||
version="${${$(ruby --version)[(w)1,(w)2]}/ /-}"
|
||||
fi
|
||||
|
||||
# Format version.
|
||||
|
@ -23,13 +23,6 @@ elif [[ -s "$HOME/.rbenv/bin/rbenv" ]]; then
|
||||
elif (( $+commands[rbenv] )); then
|
||||
eval "$(rbenv init - --no-rehash zsh)"
|
||||
|
||||
# Load package manager installed chruby into the shell session.
|
||||
elif (( $+commands[chruby-exec] )); then
|
||||
source "${commands[chruby-exec]:h:h}/share/chruby/chruby.sh"
|
||||
if zstyle -t ':prezto:module:ruby:chruby' auto-switch; then
|
||||
source "${commands[chruby-exec]:h:h}/share/chruby/auto.sh"
|
||||
fi
|
||||
|
||||
# Prepend local gems bin directories to PATH.
|
||||
else
|
||||
path=($HOME/.gem/ruby/*/bin(N) $path)
|
||||
@ -50,14 +43,14 @@ alias rb='ruby'
|
||||
# Bundler
|
||||
if (( $+commands[bundle] )); then
|
||||
alias rbb='bundle'
|
||||
alias rbbe='bundle exec'
|
||||
alias rbbi='bundle install --path vendor/bundle'
|
||||
alias rbbl='bundle list'
|
||||
alias rbbo='bundle open'
|
||||
alias rbbp='bundle package'
|
||||
alias rbbu='bundle update'
|
||||
alias rbbe='rbb exec'
|
||||
alias rbbi='rbb install'
|
||||
alias rbbl='rbb list'
|
||||
alias rbbo='rbb open'
|
||||
alias rbbp='rbb package'
|
||||
alias rbbu='rbb update'
|
||||
alias rbbI='rbbi \
|
||||
&& bundle package \
|
||||
&& rbb package \
|
||||
&& print .bundle >>! .gitignore \
|
||||
&& print vendor/assets >>! .gitignore \
|
||||
&& print vendor/bundle >>! .gitignore \
|
||||
|
@ -15,7 +15,7 @@ fi
|
||||
# Auto Start
|
||||
#
|
||||
|
||||
if [[ -z "$STY" && ( -z "$INSIDE_EMACS" || -z "$EMACS" || -z "$VIM" ) ]] && ( \
|
||||
if [[ -z "$STY" ]] && ( \
|
||||
( [[ -n "$SSH_TTY" ]] && zstyle -t ':prezto:module:screen:auto-start' remote ) ||
|
||||
( [[ -z "$SSH_TTY" ]] && zstyle -t ':prezto:module:screen:auto-start' local ) \
|
||||
); then
|
||||
|
@ -14,10 +14,10 @@ fi
|
||||
_ssh_dir="$HOME/.ssh"
|
||||
|
||||
# Set the path to the environment file if not set by another module.
|
||||
_ssh_agent_env="${_ssh_agent_env:-${TMPDIR:-/tmp}/ssh-agent.env}"
|
||||
_ssh_agent_env="${_ssh_agent_env:-$TMPDIR/ssh-agent.env}"
|
||||
|
||||
# Set the path to the persistent authentication socket.
|
||||
_ssh_agent_sock="${TMPDIR:-/tmp}/ssh-agent.sock"
|
||||
_ssh_agent_sock="$TMPDIR/ssh-agent.sock"
|
||||
|
||||
# Start ssh-agent if not started.
|
||||
if [[ ! -S "$SSH_AUTH_SOCK" ]]; then
|
||||
|
@ -6,7 +6,7 @@
|
||||
#
|
||||
|
||||
# Return if requirements are not found.
|
||||
if [[ "$TERM" == (dumb|linux|*bsd*) ]]; then
|
||||
if [[ "$TERM" == 'dumb' ]]; then
|
||||
return 1
|
||||
fi
|
||||
|
||||
|
@ -16,11 +16,11 @@ fi
|
||||
# Auto Start
|
||||
#
|
||||
|
||||
if [[ -z "$TMUX" && ( -z "$INSIDE_EMACS" || -z "$EMACS" || -z "$VIM" ) ]] && ( \
|
||||
if [[ -z "$TMUX" ]] && ( \
|
||||
( [[ -n "$SSH_TTY" ]] && zstyle -t ':prezto:module:tmux:auto-start' remote ) ||
|
||||
( [[ -z "$SSH_TTY" ]] && zstyle -t ':prezto:module:tmux:auto-start' local ) \
|
||||
); then
|
||||
tmux_session='prezto'
|
||||
tmux_session='#Prezto'
|
||||
|
||||
if ! tmux has-session -t "$tmux_session" 2> /dev/null; then
|
||||
# Ensure that tmux server is started.
|
||||
|
@ -34,7 +34,6 @@ alias mysql='nocorrect mysql'
|
||||
alias rm='nocorrect rm'
|
||||
|
||||
# Disable globbing.
|
||||
alias bower='noglob bower'
|
||||
alias fc='noglob fc'
|
||||
alias find='noglob find'
|
||||
alias ftp='noglob ftp'
|
||||
@ -105,10 +104,6 @@ alias sl='ls' # I often screw this up.
|
||||
# Mac OS X Everywhere
|
||||
if [[ "$OSTYPE" == darwin* ]]; then
|
||||
alias o='open'
|
||||
elif [[ "$OSTYPE" == cygwin* ]]; then
|
||||
alias o='cygstart'
|
||||
alias pbcopy='tee > /dev/clipboard'
|
||||
alias pbpaste='cat /dev/clipboard'
|
||||
else
|
||||
alias o='xdg-open'
|
||||
|
||||
|
@ -87,13 +87,6 @@ zstyle ':prezto:module:editor' key-bindings 'emacs'
|
||||
# Auto set to 'off' on dumb terminals.
|
||||
zstyle ':prezto:module:prompt' theme 'sorin'
|
||||
|
||||
#
|
||||
# Ruby
|
||||
#
|
||||
|
||||
# Auto switch the Ruby version on directory change.
|
||||
# zstyle ':prezto:module:ruby:chruby' auto-switch 'yes'
|
||||
|
||||
#
|
||||
# Screen
|
||||
#
|
||||
|
@ -6,7 +6,7 @@
|
||||
#
|
||||
|
||||
# Ensure that a non-login, non-interactive shell has a defined environment.
|
||||
if [[ "$SHLVL" -eq 1 && ! -o LOGIN && -s "${ZDOTDIR:-$HOME}/.zprofile" ]]; then
|
||||
if [[ "$SHLVL" -eq 1 && ! -o LOGIN ]]; then
|
||||
source "${ZDOTDIR:-$HOME}/.zprofile"
|
||||
fi
|
||||
|
||||
|
Reference in New Issue
Block a user