1
0
mirror of https://github.com/dcarrillo/prezto.git synced 2025-07-01 18:39:26 +00:00

Compare commits

..

3 Commits

Author SHA1 Message Date
113f6763c2 Add a function to define a style if not defined 2012-10-04 20:57:45 -04:00
59f448d6ed Clean up the borra theme 2012-10-03 19:17:42 -04:00
3456166ab0 Add prompt borra 2012-10-03 02:00:57 +02:00
127 changed files with 1113 additions and 3447 deletions

View File

@ -9,8 +9,7 @@ Installation
------------
Prezto will work with any recent release of Zsh, but the minimum recommended
version is 4.3.11. Unfortunately, [Cygwin][9] is not supported due to
non-standard core utilities.
version is 4.3.10.
1. Launch Zsh:
@ -34,19 +33,31 @@ non-standard core utilities.
5. Open a new Zsh terminal window or tab.
### Mac OS X
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 `PATH` when executed non-interactively.
sudo chmod ugo-x /usr/libexec/path_helper
`path_helper` 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 */etc/paths.d* directory.
Unfortunately, `path_helper` always reads paths from */etc/paths* set by Apple
then paths from */etc/paths.d* set by third party installers, and lastly paths
from the `PATH` environment variable set by the parent process, which
ultimately is set by the user with `export PATH=...` Thus, it reorders path
priorities, and user */bin* directories meant to override system */bin*
directories end up at the tail of the array.
### 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.
Updating
--------
Pull the latest changes and update submodules.
git pull && git submodule update --init --recursive
Usage
-----
@ -71,10 +82,9 @@ accompanying README files to learn of what is available.
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].
The project is managed via [Git][3]. It is highly recommend that you 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
---------
@ -86,7 +96,7 @@ License
(The MIT License)
Copyright (c) 2009-2014 Sorin Ionescu and contributors.
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
@ -114,5 +124,4 @@ 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

View File

@ -1,55 +0,0 @@
.TH Archive
.PP
Provides functions to extract and list popular archive formats.
.SH Functions
.RS
.IP \(bu 2
\fB\fCextract\fR extracts the contents of one or more archives.
.IP \(bu 2
\fB\fCls-archive\fR lists the contents of one or more archives.
.RE
.SH Supported Formats
.PP
The following archive formats are supported when the required utilities are
installed:
.RS
.IP \(bu 2
\fI.tar.gz\fP, \fI.tgz\fP require \fB\fCtar\fR.
.IP \(bu 2
\fI.tar.bz2\fP, \fI.tbz\fP require \fB\fCtar\fR.
.IP \(bu 2
\fI.tar.xz\fP, \fI.txz\fP require \fB\fCtar\fR with \fIxz\fP support.
.IP \(bu 2
\fI.tar.zma\fP, \fI.tlz\fP require \fB\fCtar\fR with \fIlzma\fP support.
.IP \(bu 2
\fI.tar\fP requires \fB\fCtar\fR.
.IP \(bu 2
\fI.gz\fP requires \fB\fCgunzip\fR.
.IP \(bu 2
\fI.bz2\fP requires \fB\fCbunzip2\fR.
.IP \(bu 2
\fI.xz\fP requires \fB\fCunxz\fR.
.IP \(bu 2
\fI.lzma\fP requires \fB\fCunlzma\fR.
.IP \(bu 2
\fI.Z\fP requires \fB\fCuncompress\fR.
.IP \(bu 2
\fI.zip\fP requires \fB\fCunzip\fR.
.IP \(bu 2
\fI.rar\fP requires \fB\fCunrar\fR.
.IP \(bu 2
\fI.7z\fP requires \fB\fC7za\fR.
.IP \(bu 2
\fI.deb\fP requires \fB\fCar\fR, \fB\fCtar\fR.
.RE
.SH Authors
.PP
\fIThe authors of this module should be contacted via the issue tracker
.UR https://github.com/sorin-ionescu/prezto/issues
.UE .\fP
.RS
.IP \(bu 2
Sorin Ionescu
.UR https://github.com/sorin-ionescu
.UE
.RE

View File

@ -1,17 +0,0 @@
.TH Command\-Not\-Found
.PP
Loads the command\-not\-found
.UR https://code.launchpad.net/command-not-found
.UE
tool on Debian\-based distributions.
.SH Authors
.PP
\fIThe authors of this module should be contacted via the issue tracker
.UR https://github.com/sorin-ionescu/prezto/issues
.UE .\fP
.RS
.IP \(bu 2
Joseph Booker
.UR https://github.com/sargas
.UE
.RE

View File

@ -1,27 +0,0 @@
.TH Completion
.PP
Loads and configures tab completion and provides additional completions from
the zsh\-completions
.UR https://github.com/zsh-users/zsh-completions
.UE
project.
.PP
This module must be loaded \fBafter\fP the \fIutility\fP module.
.SH Contributors
.PP
Completions should be submitted to the zsh\-completions
.UR https://github.com/zsh-users/zsh-completions
.UE
project according
to its rules and regulations. This module will be synchronized against it.
.SH Authors
.PP
\fIThe authors of this module should be contacted via the issue tracker
.UR https://github.com/sorin-ionescu/prezto/issues
.UE .\fP
.RS
.IP \(bu 2
Sorin Ionescu
.UR https://github.com/sorin-ionescu
.UE
.RE

View File

@ -1,49 +0,0 @@
.TH Directory
.PP
Sets directory options and defines directory aliases.
.SH Options
.RS
.IP \(bu 2
\fB\fCAUTO_CD\fR auto changes to a directory without typing \fB\fCcd\fR.
.IP \(bu 2
\fB\fCAUTO_PUSHD\fR pushes the old directory onto the stack on \fB\fCcd\fR.
.IP \(bu 2
\fB\fCPUSHD_IGNORE_DUPS\fR does not store duplicates in the stack.
.IP \(bu 2
\fB\fCPUSHD_SILENT\fR does not print the directory stack after \fB\fCpushd\fR or \fB\fCpopd\fR.
.IP \(bu 2
\fB\fCPUSHD_TO_HOME\fR pushes to the home directory when no argument is given.
.IP \(bu 2
\fB\fCCDABLE_VARS\fR changes directory to a path stored in a variable.
.IP \(bu 2
\fB\fCAUTO_NAME_DIRS\fR auto adds variable\-stored paths to \fB\fC~\fR list.
.IP \(bu 2
\fB\fCMULTIOS\fR writes to multiple descriptors.
.IP \(bu 2
\fB\fCEXTENDED_GLOB\fR uses extended globbing syntax.
.IP \(bu 2
\fB\fCCLOBBER\fR does not overwrite existing files with \fB\fC>\fR and \fB\fC>>\fR. Use \fB\fC>!\fR and
\fB\fC>>!\fR to bypass.
.RE
.SH Aliases
.RS
.IP \(bu 2
\fB\fCd\fR prints the contents of the directory stack.
.IP \(bu 2
\fB\fC1 ... 9\fR changes the directory to the \fBn\fP previous one.
.RE
.SH Authors
.PP
\fIThe authors of this module should be contacted via the issue tracker
.UR https://github.com/sorin-ionescu/prezto/issues
.UE .\fP
.RS
.IP \(bu 2
James Cox
.UR https://github.com/imajes
.UE
.IP \(bu 2
Sorin Ionescu
.UR https://github.com/sorin-ionescu
.UE
.RE

View File

@ -1,63 +0,0 @@
.TH Dpkg
.PP
Defines dpkg
.UR http://wiki.debian.org/Teams/Dpkg
.UE
aliases and functions.
.SH Aliases
.RS
.IP \(bu 2
\fB\fCdebc\fR cleans the cache.
.IP \(bu 2
\fB\fCdebf\fR displays a file's packake.
.IP \(bu 2
\fB\fCdebi\fR installs packages from repositories.
.IP \(bu 2
\fB\fCdebI\fR installs packages from files.
.IP \(bu 2
\fB\fCdebq\fR displays package information.
.IP \(bu 2
\fB\fCdebu\fR updates the packages lists.
.IP \(bu 2
\fB\fCdebU\fR upgrades outdated packages.
.IP \(bu 2
\fB\fCdebx\fR removes packages.
.IP \(bu 2
\fB\fCdebX\fR removes packages, their configuration, and unneeded dependencies.
.IP \(bu 2
\fB\fCdebs\fR searches for packages.
.IP \(bu 2
\fB\fCdeb-build\fR creates a basic .deb package.
.IP \(bu 2
\fB\fCdeb-kclean\fR removes all kernel images and headers, except for the ones in
use.
.RE
.SH Functions
.RS
.IP \(bu 2
\fB\fCdeb-clone\fR generates a script that can be used to duplicate a dpkg\-based
system.
.IP \(bu 2
\fB\fCdeb-history\fR displays dpkg history.
.IP \(bu 2
\fB\fCdeb-kbuild\fR makes a dpkg Linux kernel package.
.RE
.SH Authors
.PP
\fIThe authors of this module should be contacted via the issue tracker
.UR https://github.com/sorin-ionescu/prezto/issues
.UE .\fP
.RS
.IP \(bu 2
Daniel Bolton
.UR https://github.com/dbb
.UE
.IP \(bu 2
Benjamin Boudreau
.UR https://github.com/dreur
.UE
.IP \(bu 2
Sorin Ionescu
.UR https://github.com/sorin-ionescu
.UE
.RE

View File

@ -1,22 +0,0 @@
.TH Environment
.PP
Sets general shell options and defines environment variables.
.PP
This module must be loaded first.
.SH Environment Variables
.SH Contributors
.PP
This module \fBMUST NOT\fP rely on any command not built in Zsh.
.PP
Non\-interactive environment variables should be defined in \fIzshenv\fP.
.SH Authors
.PP
\fIThe authors of this module should be contacted via the issue tracker
.UR https://github.com/sorin-ionescu/prezto/issues
.UE .\fP
.RS
.IP \(bu 2
Sorin Ionescu
.UR https://github.com/sorin-ionescu
.UE
.RE

View File

@ -1,31 +0,0 @@
.TH GNU Utility
.PP
Provides for the interactive use of GNU utilities on non\-GNU systems.
.PP
Installing GNU utilities on non\-GNU systems in \fB\fC$PATH\fR without a prefix, i.e.
\fB\fCls\fR instead of \fB\fCgls\fR, is not recommended since scripts that target other
utilities will be broken.
.PP
However, for interactive use, prefixed commands can be wrapped in their
non\-prefixed counterparts.
.PP
This module must be loaded \fBbefore\fP the \fIutility\fP module.
.SH Settings
.SS Prefix
.PP
To use a different prefix, add the following to \fIzpreztorc\fP, and replace 'g' with
the desired prefix:
.nf
zstyle ':prezto:module:gnu-utility' prefix 'g'
.fi
.SH Authors
.PP
\fIThe authors of this module should be contacted via the issue tracker
.UR https://github.com/sorin-ionescu/prezto/issues
.UE .\fP
.RS
.IP \(bu 2
Sorin Ionescu
.UR https://github.com/sorin-ionescu
.UE
.RE

View File

@ -1,20 +0,0 @@
.TH GPG\-Agent
.PP
Provides for an easier use of gpg\-agent
.UR http://linux.die.net/man/1/gpg-agent
.UE .
.SH Authors
.PP
\fIThe authors of this module should be contacted via the issue tracker
.UR https://github.com/sorin-ionescu/prezto/issues
.UE .\fP
.RS
.IP \(bu 2
Florian Walch
.UR https://github.com/fwalch
.UE
.IP \(bu 2
Sorin Ionescu
.UR https://github.com/sorin-ionescu
.UE
.RE

View File

@ -1,27 +0,0 @@
.TH Haskell
.PP
Enables local Haskell package installation.
.SH Per\-user Package Installation
.PP
Cabal
.UR http://www.haskell.org/cabal/
.UE , the Haskell package manager, can install packages into per user
directories.
.PP
This module prepends per user directories to the relevant path variables to
enable the execution of user installed executables and the reading of
documentation.
.SS Usage
.PP
Install packages into per user directories with \fB\fCcabal install --user\fR.
.SH Authors
.PP
\fIThe authors of this module should be contacted via the issue tracker
.UR https://github.com/sorin-ionescu/prezto/issues
.UE .\fP
.RS
.IP \(bu 2
Sebastian Wiesner
.UR https://github.com/lunaryorn
.UE
.RE

View File

@ -1,29 +0,0 @@
.TH Helper
.PP
Provides helper functions for developing modules.
.SH Functions
.RS
.IP \(bu 2
\fB\fCadd-zsh-trap\fR adds a function name to a list to be called when a trap is
triggered.
.IP \(bu 2
\fB\fCis-autoloadable\fR checks if a file can be autoloaded by trying to load it
in a subshell.
.IP \(bu 2
\fB\fCis-callable\fR checks if a name is a command, function, or alias.
.IP \(bu 2
\fB\fCis-true\fR checks a boolean variable for "true".
.IP \(bu 2
\fB\fCcoalesce\fR prints the first non\-empty string in the arguments array.
.RE
.SH Authors
.PP
\fIThe authors of this module should be contacted via the issue tracker
.UR https://github.com/sorin-ionescu/prezto/issues
.UE .\fP
.RS
.IP \(bu 2
Sorin Ionescu
.UR https://github.com/sorin-ionescu
.UE
.RE

View File

@ -1,55 +0,0 @@
.TH History Substring Search
.PP
Integrates zsh\-history\-substring\-search
.UR https://github.com/zsh-users/zsh-history-substring-search
.UE
into Prezto, which implements
the Fish shell
.UR http://fishshell.com
.UE 's history search feature, where the user can type in any
part of a previously entered command and press up and down to cycle through
matching commands.
.PP
If this module is used in conjuncture with the \fIsyntax\-highlighting\fP module, it
must be loaded \fBafter\fP it.
.SH Contributors
.PP
New features and bug fixes should be submitted to the
zsh\-history\-substring\-search
.UR https://github.com/zsh-users/zsh-history-substring-search
.UE
project according to its rules and
regulations. This module will be synchronized against it.
.SH Settings
.SS Case Sensitivity
.PP
To enable case\-sensitivity for this module only, add the following line to
\fIzpreztorc\fP:
.nf
zstyle ':prezto:module:history-substring-search' case-sensitive 'yes'
.fi
.SS Highlighting
.PP
If colors are enabled, \fIhistory\-substring\-search\fP will automatically highlight
positive results.
.PP
To enable highlighting for this module only, add the following line to
\fIzpreztorc\fP:
.nf
zstyle ':prezto:module:history-substring-search' color 'yes'
.fi
.SH Authors
.PP
\fIThe authors of this module should be contacted via the issue tracker
.UR https://github.com/sorin-ionescu/prezto/issues
.UE .\fP
.RS
.IP \(bu 2
Suraj N. Kurapati
.UR https://github.com/sunaku
.UE
.IP \(bu 2
Sorin Ionescu
.UR https://github.com/sorin-ionescu
.UE
.RE

View File

@ -1,62 +0,0 @@
.TH History
.PP
Sets history
.UR http://zsh.sourceforge.net/Guide/zshguide02.html#l16
.UE
options and defines history aliases.
.SH Variables
.RS
.IP \(bu 2
\fB\fCHISTFILE\fR stores the path to the history file.
.IP \(bu 2
\fB\fCHISTSIZE\fR stores the maximum number of events to save in the internal history.
.IP \(bu 2
\fB\fCSAVEHIST\fR stores the maximum number of events to save in the history file.
.RE
.SH Options
.RS
.IP \(bu 2
\fB\fCBANG_HIST\fR treats the \fB!\fP character specially during expansion.
.IP \(bu 2
\fB\fCEXTENDED_HISTORY\fR writes the history file in the \fI:start:elapsed;command\fP format.
.IP \(bu 2
\fB\fCINC_APPEND_HISTORY\fR writes to the history file immediately, not when the shell exits.
.IP \(bu 2
\fB\fCSHARE_HISTORY\fR shares history between all sessions.
.IP \(bu 2
\fB\fCHIST_EXPIRE_DUPS_FIRST\fR expires a duplicate event first when trimming history.
.IP \(bu 2
\fB\fCHIST_IGNORE_DUPS\fR does not record an event that was just recorded again.
.IP \(bu 2
\fB\fCHIST_IGNORE_ALL_DUPS\fR deletes an old recorded event if a new event is a duplicate.
.IP \(bu 2
\fB\fCHIST_FIND_NO_DUPS\fR does not display a previously found event.
.IP \(bu 2
\fB\fCHIST_IGNORE_SPACE\fR does not record an event starting with a space.
.IP \(bu 2
\fB\fCHIST_SAVE_NO_DUPS\fR does not write a duplicate event to the history file.
.IP \(bu 2
\fB\fCHIST_VERIFY\fR does not execute immediately upon history expansion.
.IP \(bu 2
\fB\fCHIST_BEEP\fR beeps when accessing non\-existent history.
.RE
.SH Aliases
.RS
.IP \(bu 2
\fB\fChistory-stat\fR lists the ten most used commands
.RE
.SH Authors
.PP
\fIThe authors of this module should be contacted via the issue tracker
.UR https://github.com/sorin-ionescu/prezto/issues
.UE .\fP
.RS
.IP \(bu 2
Robby Russell
.UR https://github.com/robbyrussell
.UE
.IP \(bu 2
Sorin Ionescu
.UR https://github.com/sorin-ionescu
.UE
.RE

View File

@ -1,35 +0,0 @@
.TH Macports
.PP
Defines MacPorts aliases and adds MacPorts directories to path variables.
.SH Aliases
.RS
.IP \(bu 2
\fB\fCportc\fR cleans the files used to build ports.
.IP \(bu 2
\fB\fCporti\fR installs a port.
.IP \(bu 2
\fB\fCports\fR searches for a port.
.IP \(bu 2
\fB\fCportu\fR upgrades a port.
.IP \(bu 2
\fB\fCportU\fR upgrades MacPorts, the ports collection, and outdated ports.
.IP \(bu 2
\fB\fCportx\fR uninstalls a port.
.IP \(bu 2
\fB\fCportX\fR uninstalls inactive ports.
.RE
.SH Authors
.PP
\fIThe authors of this module should be contacted via the issue tracker
.UR https://github.com/sorin-ionescu/prezto/issues
.UE .\fP
.RS
.IP \(bu 2
Matt Cable
.UR https://github.com/curiousstranger
.UE
.IP \(bu 2
Sorin Ionescu
.UR https://github.com/sorin-ionescu
.UE
.RE

View File

@ -1,29 +0,0 @@
.TH Node.js
.PP
Provides utility functions for Node.js
.UR http://nodejs.org
.UE
and loads npm
.UR http://npmjs.org
.UE
completion.
.SH Functions
.RS
.IP \(bu 2
\fB\fCnode-doc\fR opens the Node.js online API documentation
.UR http://nodejs.org/api
.UE
in the default
browser.
.RE
.SH Authors
.PP
\fIThe authors of this module should be contacted via the issue tracker
.UR https://github.com/sorin-ionescu/prezto/issues
.UE .\fP
.RS
.IP \(bu 2
Sorin Ionescu
.UR https://github.com/sorin-ionescu
.UE
.RE

View File

@ -1,48 +0,0 @@
.TH OSX
.PP
Defines Mac OS X
.UR http://www.apple.com/macosx/
.UE
aliases and functions.
.SH Aliases
.RS
.IP \(bu 2
\fB\fCcdf\fR changes the current working director to the current \fIFinder\fP
directory.
.IP \(bu 2
\fB\fCpushdf\fR pushes the current working directory onto the directory queue and
.IP \(bu 2
\fB\fCql\fR quick looks at files.
.IP \(bu 2
\fB\fCrm-osx-cruft\fR deletes .DS_Store, __MACOSX cruft.
.RE
.SH Functions
.RS
.IP \(bu 2
\fB\fCmanb\fR opens \fIman\fP pages in \fIBwana.app\fP
.UR http://bruji.com/bwana/
.UE .
.IP \(bu 2
\fB\fCmanp\fR opens \fIman\fP pages in \fIPreview.app\fP.
.IP \(bu 2
\fB\fCpfd\fR prints the current \fIFinder\fP directory.
.IP \(bu 2
\fB\fCpfs\fR prints the current \fIFinder\fP selection.
.IP \(bu 2
\fB\fCtab\fR creates a new tab (works in both \fITerminal\fP and \fIiTerm\fP
.UR http://www.iterm2.com/
.UE ).
.IP \(bu 2
\fB\fCtrash\fR moves files and folders to \fITrash\fP.
.RE
.SH Authors
.PP
\fIThe authors of this module should be contacted via the issue tracker
.UR https://github.com/sorin-ionescu/prezto/issues
.UE .\fP
.RS
.IP \(bu 2
Sorin Ionescu
.UR https://github.com/sorin-ionescu
.UE
.RE

View File

@ -1,84 +0,0 @@
.TH Pacman
.PP
Provides aliases and functions for the Pacman
.UR http://www.archlinux.org/pacman/
.UE
package manager and
frontends.
.SH Settings
.PP
To enable a Pacman frontend, for example, Yaourt
.UR http://archlinux.fr/yaourt-en
.UE , add the following line to
\fIzpreztorc\fP:
.nf
zstyle ':prezto:module:pacman' frontend 'yaourt'
.fi
.PP
If you have enabled color globally in \fIzpreztorc\fP, you may disable it for certain
commands.
.PP
To disable \fB\fCyaourt\fR highlighting, add the following line to \fIzpreztorc\fP:
.nf
zstyle ':prezto:module:pacman:yaourt' color 'no'
.fi
.SH Aliases
.SS Pacman
.RS
.IP \(bu 2
\fB\fCpac\fR is short for \fB\fCpacman\fR.
.IP \(bu 2
\fB\fCpaci\fR installs packages from repositories.
.IP \(bu 2
\fB\fCpacI\fR installs packages from files.
.IP \(bu 2
\fB\fCpacx\fR removes packages and unneeded dependencies.
.IP \(bu 2
\fB\fCpacX\fR removes packages, their configuration, and unneeded dependencies.
.IP \(bu 2
\fB\fCpacq\fR displays information about a package from the repositories.
.IP \(bu 2
\fB\fCpacQ\fR displays information about a package from the local database.
.IP \(bu 2
\fB\fCpacs\fR searches for packages in the repositories.
.IP \(bu 2
\fB\fCpacS\fR searches for packages in the local database.
.IP \(bu 2
\fB\fCpacu\fR synchronizes the local package and Arch Build System (requires \fB\fCabs\fR)
databases against the repositories.
.IP \(bu 2
\fB\fCpacU\fR synchronizes the local package database against the repositories then
upgrades outdated packages.
.IP \(bu 2
\fB\fCpacman-list-orphans\fR lists orphan packages.
.IP \(bu 2
\fB\fCpacman-remove-orphans\fR removes orphan packages.
.RE
.SS Frontends
.SS Yaourt
.RS
.IP \(bu 2
\fB\fCpacc\fR manages \fI.pac\\fP* files.
.RE
.SH Functions
.RS
.IP \(bu 2
\fB\fCpacman-list-explicit\fR lists explicitly installed pacman packages.
.IP \(bu 2
\fB\fCpacman-list-disowned\fR lists pacman disowned files.
.RE
.SH Authors
.PP
\fIThe authors of this module should be contacted via the issue tracker
.UR https://github.com/sorin-ionescu/prezto/issues
.UE .\fP
.RS
.IP \(bu 2
Benjamin Boudreau
.UR https://github.com/dreur
.UE
.IP \(bu 2
Sorin Ionescu
.UR https://github.com/sorin-ionescu
.UE
.RE

View File

@ -1,74 +0,0 @@
.TH Perl
.PP
Enables local Perl
.UR http://www.perl.org
.UE
module installation on Mac OS X and defines alises.
.SH Local Module Installation
.PP
Perl versions older than 5.14 do not support the local installation of Perl
modules natively. This module allows for local installation of Perl modules on
Mac OS X in \fI~/Library/Perl/5.12\fP by altering the environment.
.SS Usage
.PP
For Perl versions older than 5.14, install \fIlocal::lib\fP.
.nf
curl -L -C - -O http://search.cpan.org/CPAN/authors/id/A/AP/APEIRON/local-lib-1.008004.tar.gz
tar xvf local-lib-1.008004.tar.gz
cd local-lib-1.008004
perl Makefile.PL --bootstrap=$HOME/Library/Perl/5.12
make && make test && make install
.fi
.PP
Install \fIcpanminus\fP:
.nf
curl -L http://cpanmin.us | perl - --self-upgrade
.fi
.SH Perlbrew
.PP
An alternative to the above is to use Perlbrew
.UR http://perlbrew.pl
.UE , which allows for the
management of multiple, isolated Perl installations in the home directory.
.SH Aliases
.SS General
.RS
.IP \(bu 2
\fB\fCpl\fR is short for \fB\fCperl\fR.
.IP \(bu 2
\fB\fCpld\fR looks up Perl documentation (\fB\fCperldoc\fR).
.IP \(bu 2
\fB\fCple\fR executes a one line program in a loop (\fB\fCperl -wlne\fR).
.RE
.SS Perlbrew
.RS
.IP \(bu 2
\fB\fCplb\fR manages Perl environments.
.IP \(bu 2
\fB\fCplba\fR lists available Perl versions.
.IP \(bu 2
\fB\fCplbi\fR installs a Perl version.
.IP \(bu 2
\fB\fCplbl\fR lists installed Perl versions.
.IP \(bu 2
\fB\fCplbo\fR temporarily turns off Perlbrew.
.IP \(bu 2
\fB\fCplbO\fR turns off Perlbrew.
.IP \(bu 2
\fB\fCplbs\fR switches to a Perl version.
.IP \(bu 2
\fB\fCplbu\fR uninstalls a Perl version.
.IP \(bu 2
\fB\fCplbx\fR temporarily sets the Perl version to use.
.RE
.SH Authors
.PP
\fIThe authors of this module should be contacted via the issue tracker
.UR https://github.com/sorin-ionescu/prezto/issues
.UE .\fP
.RS
.IP \(bu 2
Sorin Ionescu
.UR https://github.com/sorin-ionescu
.UE
.RE

View File

@ -1,108 +0,0 @@
.TH Prompt
.PP
Loads prompt themes
.UR http://zsh.sourceforge.net/Doc/Release/User-Contributions.html#Prompt-Themes
.UE .
.SH Settings
.PP
To select a prompt theme, add the following to \fIzpreztorc\fP, and replace \fBname\fP
with the name of the theme you wish to load. Setting it to \fBrandom\fP will load
a random theme.
.nf
zstyle ':prezto:module:prompt' theme 'name'
.fi
.SH Theming
.PP
A prompt theme is an autoloadable function file with a special name,
\fB\fCprompt_name_setup\fR, placed anywhere in \fB\fC$fpath\fR, but for the purpose of this
project, themes \fBshould\fP be placed in the \fImodules/prompt/functions\fP
directory.
.SS Theme Functions
.PP
There are three theme functions, a setup function, a help function, and
a preview function. The setup function \fBmust\fP always be defined. The help
function and the preview functions are optional.
.SS prompt_name_setup
.PP
This function is called by the \fB\fCprompt\fR function to install the theme. This
function may define other functions as necessary to maintain the prompt,
including a function that displays help or a function used to preview it.
.PP
\fBDo not call this function directly.\fP
.PP
The most basic example of this function can be seen bellow.
.nf
function prompt_name_setup {
PROMPT='%m%# '
RPROMPT=''
}
.fi
.SS prompt_name_help
.PP
If the \fB\fCprompt_name_setup\fR function is customizable via parameters, a help
function \fBshould\fP be defined. The user will access it via \fB\fCprompt -h name\fR.
.PP
The most basic example of this function can be seen bellow.
.nf
function prompt_name_help {
cat <<EOH
This prompt is color-scheme-able. You can invoke it thus:
prompt theme [<color1>] [<color2>]
where the color is for the left-hand prompt.
EOH
}
.fi
.SS prompt_name_preview
.PP
If the \fB\fCprompt_name_setup\fR function is customizable via parameters, a preview
function \fBshould\fP be defined. The user will access it via \fB\fCprompt -p name\fR.
.PP
The most basic example of this function can be seen bellow.
.nf
function prompt_name_preview {
if (( $# > 0 )); then
prompt_preview_theme theme "$@"
else
prompt_preview_theme theme red green blue
print
prompt_preview_theme theme yellow magenta black
fi
}
.fi
.SS Hook Functions
.PP
There are many Zsh hook
.UR http://zsh.sourceforge.net/Doc/Release/Functions.html#Hook-Functions
.UE
functions, but mostly the \fIprecmd\fP hook will be
used.
.SS prompt_name_precmd
.PP
This hook is called before the prompt is displayed and is useful for getting
information to display in a prompt.
.PP
When calling functions to get information to display in a prompt, do not assume
that all the dependencies have been loaded. Always check for the availability of
a function before you calling it.
.PP
\fBDo not register hook functions. They will be registered by the \fB\fCprompt\fR function.\fP
.PP
The most basic example of this function can be seen bellow.
.nf
function prompt_name_precmd {
if (( $+functions[git-info] )); then
git-info
fi
}
.fi
.SH Authors
.PP
\fIThe authors of this module should be contacted via the issue tracker
.UR https://github.com/sorin-ionescu/prezto/issues
.UE .\fP
.RS
.IP \(bu 2
Sorin Ionescu
.UR https://github.com/sorin-ionescu
.UE
.RE

View File

@ -1,119 +0,0 @@
.TH Python
.PP
Enables local Python and local Python package installation.
.SH Local Python Installation
.PP
pythonz
.UR http://saghul.github.com/pythonz/
.UE
builds and installs multiple Python versions locally in the home
directory.
.PP
This module prepends the pythonz directory to the path variable to enable the
execution of \fB\fCpythonz\fR.
.SS Usage
.PP
Install Python versions with \fB\fCpythonz install\fR into \fI~/.pythonz/pythons\fP.
.SH Local Package Installation
.PP
Since version 2.6, Python supports per user package installation, as defined in
PEP 370
.UR http://www.python.org/dev/peps/pep-0370/
.UE .
.PP
This module prepends per user site directories to the relevant path variables
to enable the execution of user installed scripts and the reading of
documentation.
.SS Usage
.PP
Install packages into the per user site directory with \fB\fCeasy_install --user\fR or
\fB\fCpip install --user\fR.
.SH virtualenvwrapper
.PP
virtualenvwrapper
.UR http://www.doughellmann.com/projects/virtualenvwrapper/
.UE
is a frontend to the popular virtualenv
.UR http://pypi.python.org/pypi/virtualenv
.UE
utility.
.PP
virtualenv creates isolated Python environments and virtualenvwrapper provides
convenient shell functions to create, switch, and manage them.
.SS Usage
.PP
Install virtualenvwrapper.
.PP
Virtual environments are stored in \fI~/.virtualenvs\fP.
.PP
There are configuration variables that have to be set to enable certain features.
If you wish to use these features, export the variables in \fI~/.zshenv\fP
.PP
The variable \fB\fC$PROJECT_HOME\fR tells virtualenvwrapper where to place project
working directories. It must be set and the directory created before \fB\fCmkproject\fR
is used. Replace \fIDeveloper\fP with your projects directory.
.nf
export PROJECT_HOME="$HOME/Developer"
.fi
.PP
The variable \fB\fC$VIRTUALENVWRAPPER_VIRTUALENV_ARGS\fR tells virtualenvwrapper what
arguments to pass to \fB\fCvirtualenv\fR. For example, set the value to
\fI\-\-no\-site\-packages\fP to ensure that all new environments are isolated from the
system site\-packages directory.
.nf
export VIRTUALENVWRAPPER_VIRTUALENV_ARGS='--no-site-packages'
.fi
.SH Aliases
.RS
.IP \(bu 2
\fB\fCpy\fR is short for \fB\fCpython\fR.
.RE
.SS Pythonz
.RS
.IP \(bu 2
\fB\fCpyz\fR is short for \fB\fCpythonz\fR.
.IP \(bu 2
\fB\fCpyzc\fR removes stale source folders and archives.
.IP \(bu 2
\fB\fCpyzi\fR installs Python versions.
.IP \(bu 2
\fB\fCpyzl\fR lists installed Python versions.
.IP \(bu 2
\fB\fCpyzL\fR lists available Python versions.
.IP \(bu 2
\fB\fCpyzu\fR updates itself to the latest version.
.IP \(bu 2
\fB\fCpyzx\fR uninstalls Python versions.
.RE
.SH Functions
.RS
.IP \(bu 2
\fB\fCpython-info\fR exposes information about the Python environment via the
\fB\fC$python_info\fR associative array.
.RE
.SH Theming
.PP
To display the name of the current virtual enviroment in a prompt, define the
following style in the \fB\fCprompt_theme_setup\fR function.
.nf
# %v - virtualenv name.
zstyle ':prezto:module:python' virtualenv 'virtualenv:%v'
.fi
.PP
Then add \fB\fC$python_info[virtualenv]\fR to \fB\fC$PROMPT\fR or \fB\fC$RPROMPT\fR and call
\fB\fCpython-info\fR in the \fB\fCprompt_theme_preexec\fR hook function.
.SH Authors
.PP
\fIThe authors of this module should be contacted via the issue tracker
.UR https://github.com/sorin-ionescu/prezto/issues
.UE .\fP
.RS
.IP \(bu 2
Sorin Ionescu
.UR https://github.com/sorin-ionescu
.UE
.IP \(bu 2
Sebastian Wiesner
.UR https://github.com/lunaryorn
.UE
.RE

View File

@ -1,56 +0,0 @@
.TH Ruby on Rails
.PP
Defines Ruby on Rails
.UR http://rubyonrails.org
.UE
aliases.
.SH Aliases
.RS
.IP \(bu 2
\fB\fCror\fR is short for \fB\fCrails\fR.
.IP \(bu 2
\fB\fCrorc\fR starts the Rails console.
.IP \(bu 2
\fB\fCrordc\fR starts the Rails console connected to the database.
.IP \(bu 2
\fB\fCrordm\fR migrates the database.
.IP \(bu 2
\fB\fCrordM\fR migrates the database and recreates the test database.
.IP \(bu 2
\fB\fCrordr\fR rolls the database schema back to the previous version.
.IP \(bu 2
\fB\fCrorg\fR generates new code.
.IP \(bu 2
\fB\fCrorl\fR displays the log.
.IP \(bu 2
\fB\fCrorlc\fR truncates logs to zero bytes.
.IP \(bu 2
\fB\fCrorp\fR installs a plugin.
.IP \(bu 2
\fB\fCrorr\fR runs code in the application environment.
.IP \(bu 2
\fB\fCrors\fR starts the Rails server.
.IP \(bu 2
\fB\fCrorsd\fR starts the Rails server with the debugger.
.IP \(bu 2
\fB\fCrorx\fR destroys newly generated code.
.RE
.SH Authors
.PP
\fIThe authors of this module should be contacted via the issue tracker
.UR https://github.com/sorin-ionescu/prezto/issues
.UE .\fP
.RS
.IP \(bu 2
Robby Russell
.UR https://github.com/robbyrussell
.UE
.IP \(bu 2
Jake Bell
.UR https://github.com/theunraveler
.UE
.IP \(bu 2
Sorin Ionescu
.UR https://github.com/sorin-ionescu
.UE
.RE

View File

@ -1,34 +0,0 @@
.TH Rsync
.PP
Defines rsync
.UR http://rsync.samba.org
.UE
aliases.
.PP
Mac OS X users are encouraged to use Bombich's rsync
.UR http://www.bombich.com/rsync.html
.UE , which has HFS+
enhancements.
.SH Aliases
.RS
.IP \(bu 2
\fB\fCrsync-copy\fR copies files and directories from \fIsource\fP to \fIdestination\fP.
.IP \(bu 2
\fB\fCrsync-move\fR moves files and directories from \fIsource\fP to \fIdestination\fP.
.IP \(bu 2
\fB\fCrsync-update\fR updates files and directories on \fIdestination\fP.
.IP \(bu 2
\fB\fCrsync-synchronize\fR synchronizes files and directories between \fIsource\fP and
\fIdestination\fP.
.RE
.SH Authors
.PP
\fIThe authors of this module should be contacted via the issue tracker
.UR https://github.com/sorin-ionescu/prezto/issues
.UE .\fP
.RS
.IP \(bu 2
Sorin Ionescu
.UR https://github.com/sorin-ionescu
.UE
.RE

View File

@ -1,97 +0,0 @@
.TH Ruby
.PP
Configures Ruby
.UR http://www.ruby-lang.org
.UE
local gem installation, loads version managers, and defines
aliases.
.SH Local Gem Installation
.PP
When a Ruby version manager is not detected, local gems are installed in
\fI~/Library/Ruby/Gems/1.8\fP on Mac OS X.
.SH RVM
.PP
An alternative to the above is to use The Ruby Version Manager (RVM)
.UR https://rvm.io
.UE , which
allows for managing multiple, isolated Ruby installations and gem sets in the
home directory.
.PP
Since RVM is loaded into the shell and is known to override shell commands, it
may conflict with shell scripts.
.SH rbenv
.PP
An alternative RVM is to use rbenv
.UR https://github.com/sstephenson/rbenv
.UE , which allows for switching between multiple,
isolated Ruby installations in the home directory.
.PP
While it is not as feature rich as RVM, it is not loaded into the shell and is
not known to cause conflicts with shell scripts.
.SH Bundler
.PP
Manage gems that are not meant to be used as commands, such as application
dependencies, with Bundler
.UR http://gembundler.com
.UE .
.SH Aliases
.SS General
.RS
.IP \(bu 2
\fB\fCrb\fR is short for \fB\fCruby\fR.
.RE
.SS Bundler
.RS
.IP \(bu 2
\fB\fCrbb\fR manages ruby dependencies (\fB\fCbundle\fR).
.IP \(bu 2
\fB\fCrbbe\fR executes a script in the context of the current bundle.
.IP \(bu 2
\fB\fCrbbi\fR installs the gems specified in the \fIGemfile\fP in \fIvendor/bundle\fP.
.IP \(bu 2
\fB\fCrbbI\fR installs the following:
.RS
.IP \(bu 2
gems specified in the \fIGemfile\fP in \fIvendor/bundle\fP.
.IP \(bu 2
packages the gems into \fIvendor/cache\fP.
.IP \(bu 2
appends bundler directories to \fI.gitignore\fP.
.RE
.IP \(bu 2
\fB\fCrbbl\fR lists all gems in the current bundle.
.IP \(bu 2
\fB\fCrbbo\fR opens an installed gem in the editor.
.IP \(bu 2
\fB\fCrbbp\fR packages gem files into \fIvendor/cache\fP.
.IP \(bu 2
\fB\fCrbbu\fR updates gems to their latest version.
.RE
.SH Functions
.RS
.IP \(bu 2
\fB\fCruby-info\fR exposes information about the Ruby environment via the
\fB\fC$ruby_info\fR associative array.
.RE
.SH Theming
.PP
To display the name of the current Ruby version in a prompt, define the
following style in the \fB\fCprompt_theme_setup\fR function.
.nf
# %v - ruby version.
zstyle ':prezto:module:ruby' version 'version:%v'
.fi
.PP
Then add \fB\fC$ruby_info[version]\fR to \fB\fC$PROMPT\fR or \fB\fC$RPROMPT\fR and call
\fB\fCruby-info\fR in the \fB\fCprompt_theme_preexec\fR hook function.
.SH Authors
.PP
\fIThe authors of this module should be contacted via the issue tracker
.UR https://github.com/sorin-ionescu/prezto/issues
.UE .\fP
.RS
.IP \(bu 2
Sorin Ionescu
.UR https://github.com/sorin-ionescu
.UE
.RE

View File

@ -1,37 +0,0 @@
.TH GNU Screen
.PP
Defines GNU Screen
.UR http://www.gnu.org/software/screen/
.UE
aliases and provides for auto launching it at start\-up.
.SH Settings
.SS Auto\-Start
.PP
Starts a GNU Screen session automatically when Zsh is launched.
.PP
To enable this feature, add the following line to \fIzpreztorc\fP:
.nf
zstyle ':prezto:module:screen' auto-start 'yes'
.fi
.SH Aliases
.RS
.IP \(bu 2
\fB\fCscr\fR is short for \fB\fCscreen\fR.
.IP \(bu 2
\fB\fCscrl\fR lists sessions/socket directory.
.IP \(bu 2
\fB\fCscrn\fR starts a new session.
.IP \(bu 2
\fB\fCscrr\fR attaches to a session if one exists or start a new one.
.RE
.SH Authors
.PP
\fIThe authors of this module should be contacted via the issue tracker
.UR https://github.com/sorin-ionescu/prezto/issues
.UE .\fP
.RS
.IP \(bu 2
Sorin Ionescu
.UR https://github.com/sorin-ionescu
.UE
.RE

View File

@ -1,145 +0,0 @@
.TH Spectrum
.PP
Provides for easier use of 256 colors and effects.
.PP
To learn more about text formatting, read That 256 Color Thing
.UR http://lucentbeing.com/blog/that-256-color-thing/
.UE .
.SH Variables
.RS
.IP \(bu 2
\fB\fCBG\fR provides background colors.
.IP \(bu 2
\fB\fCFG\fR provides foreground colors.
.IP \(bu 2
\fB\fCFX\fR provides effects.
.RE
.SS Background and Foreground
.PP
Terminals support 8, 16, 88, and 256 colors. Check if a terminal supports 256
colors with \fB\fCtput colors\fR before use.
.PP
The following colors are supported.
.RS
.IP \(bu 2
0 to 255
.IP \(bu 2
black
.IP \(bu 2
red
.IP \(bu 2
green
.IP \(bu 2
yellow
.IP \(bu 2
blue
.IP \(bu 2
magenta
.IP \(bu 2
cyan
.IP \(bu 2
white
.RE
.SS Effects
.PP
Though there are many effects, most terminals support at least bold formatting.
.PP
\fBNot all effects work on all terminals; use them sparingly.\fP
.TS
allbox;
cb cb
l l
l l
l l
l l
l l
l l
l l
l l
l l
l l
l l
l l
l l
l l
l l
l l
l l
l l
l l
l l
l l
l l
l l
l l
l l
l l
l l
l l
l l
l l
l l
l l
l l
l l
l l
l l
l l
.
Enable Disable
none
normal
bold no\-bold
faint no\-faint
standout no\-standout
underline no\-underline
blink no\-blink
fast\-blink no\-fast\-blink
reverse no\-reverse
conceal no\-conceal
strikethrough no\-strikethrough
gothic no\-gothic
double\-underline no\-double\-underline
proportional no\-proportional
overline no\-overline
no\-border
border\-rectangle no\-border\-rectangle
border\-circle no\-border\-circle
no\-ideogram\-marking
underline\-or\-right no\-underline\-or\-right
double\-underline\-or\-right no\-double\-underline\-or\-right
overline\-or\-left no\-overline\-or\-left
double\-overline\-or\-left no\-double\-overline\-or\-left
stress no\-stress
font\-default
font\-first no\-font\-first
font\-second no\-font\-second
font\-third no\-font\-third
font\-fourth no\-font\-fourth
font\-fifth no\-font\-fifth
font\-sixth no\-font\-sixth
font\-seventh no\-font\-seventh
font\-eigth no\-font\-eigth
font\-ninth no\-font\-ninth
.TE
.SS Plain Text
.PP
Use \fB\fC$BG[none]\fR, \fB\fC$FG[none]\fR, or \fB\fC$FX[none]\fR to turn off formatting.
.SH Authors
.PP
\fIThe authors of this module should be contacted via the issue tracker
.UR https://github.com/sorin-ionescu/prezto/issues
.UE .\fP
.RS
.IP \(bu 2
P.C. Shyamshankar
.UR https://github.com/sykora
.UE
.IP \(bu 2
Sorin Ionescu
.UR https://github.com/sorin-ionescu
.UE
.RE

View File

@ -1,53 +0,0 @@
.TH SSH\-Agent
.PP
Provides for an easier use of ssh\-agent
.UR http://www.openbsd.org/cgi-bin/man.cgi?query=ssh-agent&sektion=1
.UE .
.SH Settings
.SS Agent Forwarding
.PP
To enable ssh\-agent forwarding, add the following line to \fIzpreztorc\fP:
.nf
zstyle ':prezto:module:ssh-agent' forwarding 'yes'
.fi
.SS Identities
.PP
To load multiple identities, add the following line to \fIzpreztorc\fP:
.nf
zstyle ':prezto:module:ssh-agent' identities 'id_rsa' 'id_rsa2' 'id_github'
.fi
.SH Authors
.PP
\fIThe authors of this module should be contacted via the issue tracker
.UR https://github.com/sorin-ionescu/prezto/issues
.UE .\fP
.RS
.IP \(bu 2
Robby Russell
.UR https://github.com/robbyrussell
.UE
.IP \(bu 2
Theodore Robert Campbell Jr
.UR https://github.com/trcjr
.UE
.IP \(bu 2
Joseph M. Reagle Jr.
.UR https://github.com/reagle
.UE
.IP \(bu 2
Florent Thoumie
.UR https://github.com/flz
.UE
.IP \(bu 2
Jonas Pfenniger
.UR https://github.com/zimbatm
.UE
.IP \(bu 2
Gareth Owen
.UR https://github.com/gwjo
.UE
.IP \(bu 2
Sorin Ionescu
.UR https://github.com/sorin-ionescu
.UE
.RE

View File

@ -1,53 +0,0 @@
.TH Syntax Highlighting
.PP
Integrates zsh\-syntax\-highlighting
.UR https://github.com/zsh-users/zsh-syntax-highlighting
.UE
into Prezto.
.PP
This module should be loaded \fIsecond to last\fP, where last is the \fIprompt\fP
module, unless used in conjuncture with the \fIhistory\-substring\-search\fP module
where it must be loaded \fBbefore\fP it.
.SH Contributors
.PP
New features and bug fixes should be submitted to the
zsh\-syntax\-highlighting
.UR https://github.com/zsh-users/zsh-syntax-highlighting
.UE
project according to its rules and regulations.
This module will be synchronized against it.
.SH Settings
.SS Highlighting
.PP
To enable highlighting for this module only, add the following line to
\fIzpreztorc\fP:
.nf
zstyle ':prezto:module:syntax-highlighting' color 'yes'
.fi
.SS Highlighters
.PP
Syntax highlighting is accomplished by pluggable highlighters
.UR https://github.com/zsh-users/zsh-syntax-highlighting/tree/master/highlighters
.UE . This module
enables the \fImain\fP, \fIbrackets\fP, and \fIcursor\fP highlighters by default.
.PP
To enable all highlighters, add the following to \fIzpreztorc\fP:
.nf
zstyle ':prezto:module:syntax-highlighting' highlighters \
'main' \
'brackets' \
'pattern' \
'cursor' \
'root'
.fi
.SH Authors
.PP
\fIThe authors of this module should be contacted via the issue tracker
.UR https://github.com/sorin-ionescu/prezto/issues
.UE .\fP
.RS
.IP \(bu 2
Sorin Ionescu
.UR https://github.com/sorin-ionescu
.UE
.RE

View File

@ -1,26 +0,0 @@
.TH Terminal
.PP
Sets terminal window and tab titles.
.SH Settings
.SS Auto\-Title
.PP
To auto set the terminal window and tab titles with the current command or
directory, add the following to \fIzpreztorc\fP:
.nf
zstyle ':prezto:module:terminal' auto-title 'yes'
.fi
.SH Authors
.PP
\fIThe authors of this module should be contacted via the issue tracker
.UR https://github.com/sorin-ionescu/prezto/issues
.UE .\fP
.RS
.IP \(bu 2
James Cox
.UR https://github.com/imajes
.UE
.IP \(bu 2
Sorin Ionescu
.UR https://github.com/sorin-ionescu
.UE
.RE

View File

@ -1,61 +0,0 @@
.TH Tmux
.PP
Defines tmux
.UR http://tmux.sourceforge.net
.UE
aliases and provides for auto launching it at start\-up.
.SH Settings
.SS Auto\-Start
.PP
Starts a tmux session automatically when Zsh is launched.
.PP
To enable this feature, add the following line to \fIzpreztorc\fP:
.nf
zstyle ':prezto:module:tmux' auto-start 'yes'
.fi
.PP
It will create a background session named \fI#Prezto\fP and attach every new shell
to it.
.PP
To avoid keeping open sessions, this module sets \fB\fCdestroy-unattached off\fR on
the background session and \fB\fCdestroy-unattached on\fR on every other session
(global setting).
.SH Aliases
.RS
.IP \(bu 2
\fB\fCtmuxa\fR attaches or switches to a tmux session.
.IP \(bu 2
\fB\fCtmuxl\fR lists sessions managed by the tmux server.
.RE
.SH Caveats
.PP
On Mac OS X, launching tmux can cause the error \fBlaunch_msg(...): Socket is not
connected\fP to be displayed, which can be fixed by installing
reattach\-to\-user\-namespace
.UR ChrisJohnsen/tmux-MacOSX-pasteboard
.UE , available in Homebrew
.UR mxcl/homebrew
.UE , and adding the
following to \fItmux.conf\fP:
.PP
set\-option \-g default\-command "reattach\-to\-user\-namespace \-l $SHELL \-l"
.PP
Furthermore, tmux is known to cause \fBkernel panics\fP on Mac OS X. A discussion
about this and Prezto has already been opened
.UR http://git.io/jkPqHg
.UE .
.SH Authors
.PP
\fIThe authors of this module should be contacted via the issue tracker
.UR https://github.com/sorin-ionescu/prezto/issues
.UE .\fP
.RS
.IP \(bu 2
Sorin Ionescu
.UR https://github.com/sorin-ionescu
.UE
.IP \(bu 2
Colin Hebert
.UR https://github.com/ColinHebert
.UE
.RE

View File

@ -1,233 +0,0 @@
.TH Utility
.PP
Defines general aliases and functions.
.SH Settings
.SS Highlighting
.PP
If you have enabled color globally in \fIzpreztorc\fP, you may disable it for certain
commands.
.PP
To disable \fB\fCls\fR color, add the following line to \fIzpreztorc\fP; when coloring is
disabled, type indicators (*, /, =>, @, =, |, %) will be appended to entries.
.nf
zstyle ':prezto:module:utility:ls' color 'no'
.fi
.PP
To disable \fB\fCdiff\fR highlighting, add the following line to \fIzpreztorc\fP:
.nf
zstyle ':prezto:module:utility:diff' color 'no'
.fi
.PP
To disable \fB\fCwdiff\fR highlighting, add the following line to \fIzpreztorc\fP:
.nf
zstyle ':prezto:module:utility:wdiff' color 'no'
.fi
.PP
To disable \fB\fCmake\fR highlighting, add the following line to \fIzpreztorc\fP:
.nf
zstyle ':prezto:module:utility:make' color 'no'
.fi
.SH Aliases
.SS Disabled Spelling Correction
.RS
.IP \(bu 2
\fB\fCack\fR
.IP \(bu 2
\fB\fCcd\fR
.IP \(bu 2
\fB\fCcp\fR
.IP \(bu 2
\fB\fCebuild\fR
.IP \(bu 2
\fB\fCgcc\fR
.IP \(bu 2
\fB\fCgist\fR
.IP \(bu 2
\fB\fCgrep\fR
.IP \(bu 2
\fB\fCheroku\fR
.IP \(bu 2
\fB\fCln\fR
.IP \(bu 2
\fB\fCman\fR
.IP \(bu 2
\fB\fCmkdir\fR
.IP \(bu 2
\fB\fCmv\fR
.IP \(bu 2
\fB\fCmysql\fR
.IP \(bu 2
\fB\fCrm\fR
.RE
.SS Disabled File Globbing
.RS
.IP \(bu 2
\fB\fCfc\fR
.IP \(bu 2
\fB\fCfind\fR
.IP \(bu 2
\fB\fCftp\fR
.IP \(bu 2
\fB\fChistory\fR
.IP \(bu 2
\fB\fClocate\fR
.IP \(bu 2
\fB\fCrake\fR
.IP \(bu 2
\fB\fCrsync\fR
.IP \(bu 2
\fB\fCscp\fR
.IP \(bu 2
\fB\fCsftp\fR
.RE
.SS General
.RS
.IP \(bu 2
\fB\fC_\fR executes a command as another user (\fB\fCsudo\fR).
.IP \(bu 2
\fB\fCb\fR opens the default web browser.
.IP \(bu 2
\fB\fCcp\fR copies files and directories interactively.
.IP \(bu 2
\fB\fCe\fR opens the default editor.
.IP \(bu 2
\fB\fCln\fR links files and directories interactively.
.IP \(bu 2
\fB\fCmkdir\fR creates directories, including intermediary directories.
.IP \(bu 2
\fB\fCmv\fR moves files and directories interactively.
.IP \(bu 2
\fB\fCp\fR opens the default pager.
.IP \(bu 2
\fB\fCpo\fR removes a directory from the stack and changes to it (\fB\fCpopd\fR).
.IP \(bu 2
\fB\fCpu\fR changes the directory and pushes the old directory onto the stack
(\fB\fCpushd\fR).
.IP \(bu 2
\fB\fCrm\fR removes files and directories interactively.
.IP \(bu 2
\fB\fCtype\fR displays all the attribute values of a shell parameter.
.RE
.SS Files and Directories
.RS
.IP \(bu 2
\fB\fCls\fR lists with directories grouped first (GNU only).
.IP \(bu 2
\fB\fCl\fR lists in one column, hidden files.
.IP \(bu 2
\fB\fCll\fR lists human readable sizes.
.IP \(bu 2
\fB\fClr\fR lists human readable sizes, recursively.
.IP \(bu 2
\fB\fCla\fR lists human readable sizes, hidden files.
.IP \(bu 2
\fB\fClm\fR lists human readable sizes, hidden files through pager.
.IP \(bu 2
\fB\fClx\fR lists sorted by extension (GNU only).
.IP \(bu 2
\fB\fClk\fR lists sorted by size, largest last.
.IP \(bu 2
\fB\fClt\fR lists sorted by date, most recent last.
.IP \(bu 2
\fB\fClc\fR lists sorted by date, most recent last, shows change time.
.IP \(bu 2
\fB\fClu\fR lists sorted by date, most recent last, shows access time.
.IP \(bu 2
\fB\fCsl\fR lists directory contents (\fB\fCls\fR).
.RE
.SS Mac OS X Everywhere
.RS
.IP \(bu 2
\fB\fCo\fR opens files and directories (\fB\fCopen\fR or \fB\fCxdg-open\fR).
.IP \(bu 2
\fB\fCget\fR downloads files (\fB\fCcurl\fR or \fB\fCwget\fR).
.IP \(bu 2
\fB\fCpbcopy\fR copies to the pasteboard (\fB\fCpbcopy\fR, \fB\fCxclip\fR or \fB\fCxsel\fR).
.IP \(bu 2
\fB\fCpbpaste\fR pastes from the pasteboard (\fB\fCpbcopy\fR, \fB\fCxclip\fR or \fB\fCxsel\fR).
.IP \(bu 2
\fB\fCpbc\fR copies to the pasteboard (\fB\fCpbcopy\fR).
.IP \(bu 2
\fB\fCpbp\fR pastes from the pasteboard (\fB\fCpbpaste\fR).
.RE
.SS Resource Usage
.RS
.IP \(bu 2
\fB\fCdf\fR displays free disk space using human readable units.
.IP \(bu 2
\fB\fCdu\fR displays disk usage using human readable units.
.IP \(bu 2
\fB\fCtop\fR displays information about processes (aliased to \fB\fChtop\fR, if installed).
.IP \(bu 2
\fB\fCtopc\fR displays information about processes sorted by CPU usage (\fB\fChtop\fR not
installed).
.IP \(bu 2
\fB\fCtopm\fR displays information about processes sorted by RAM usage (\fB\fChtop\fR not
installed).
.RE
.SS Miscellaneous
.RS
.IP \(bu 2
\fB\fChttp-serve\fR serves a directory via HTTP.
.RE
.SH Functions
.SS General
.RS
.IP \(bu 2
\fB\fCslit\fR prints columns \fI1, 2, 3 ... n\fP.
.RE
.SS Files and Directories
.RS
.IP \(bu 2
\fB\fCcdls\fR changes to a directory and lists its contents.
.IP \(bu 2
\fB\fCdut\fR displays the grand total disk usage using human readable units.
.IP \(bu 2
\fB\fCfind-exec\fR finds files and executes a command on them.
.IP \(bu 2
\fB\fCmkdcd\fR makes a directory and changes to it.
.IP \(bu 2
\fB\fCpopdls\fR pops an entry off the directory stack and lists its contents.
.IP \(bu 2
\fB\fCpushdls\fR pushes an entry onto the directory stack and lists its contents.
.RE
.SS Developer
.RS
.IP \(bu 2
\fB\fCdiff\fR highlights diff output (requires \fB\fCcolordiff\fR or \fB\fCGit\fR).
.IP \(bu 2
\fB\fCmake\fR highlights make output (requires \fB\fCcolormake\fR).
.IP \(bu 2
\fB\fCwdiff\fR highlights wdiff output (requires \fB\fCwdiff\fRor \fB\fCGit\fR).
.RE
.SS Resource usage
.RS
.IP \(bu 2
\fB\fCpsu\fR displays user owned processes status.
.RE
.SS Search and Replace
.RS
.IP \(bu 2
\fB\fCprep\fR provides a grep\-like pattern search.
.IP \(bu 2
\fB\fCpsub\fR provides a sed\-like pattern substitution.
.RE
.SH Authors
.PP
\fIThe authors of this module should be contacted via the issue tracker
.UR https://github.com/sorin-ionescu/prezto/issues
.UE .\fP
.RS
.IP \(bu 2
Robby Russell
.UR https://github.com/robbyrussell
.UE
.IP \(bu 2
Suraj N. Kurapati
.UR https://github.com/sunaku
.UE
.IP \(bu 2
Sorin Ionescu
.UR https://github.com/sorin-ionescu
.UE
.RE

View File

@ -1,43 +0,0 @@
.TH Wake\-on\-LAN
.PP
This module provides a wrapper around the wakeonlan
.UR http://gsd.di.uminho.pt/jpo/software/wakeonlan/
.UE
tool.
.SH Usage
.PP
To use this wrapper, create the \fI~/.wakeonlan\fP directory, and place in it one
file for each device you would like to be able to wake. Give the file a name
that describes the device, such as its hostname.
.PP
Each file should contain a line with the MAC address of the target device and
the network broadcast address. For instance, there might be a file
\fI~/.wakeonlan/leto\fP with the following contents:
.nf
00:11:22:33:44:55:66 192.168.0.255
.fi
.PP
To wake that device, use the following command:
.nf
wake leto
.fi
.PP
For more information on the configuration file format, read the
wakeonlan man page
.UR http://man.cx/wakeonlan
.UE .
.SH Authors
.PP
\fIThe authors of this module should be contacted via issue tracker
.UR https://github.com/sorin-ionescu/prezto/issues
.UE .\fP
.RS
.IP \(bu 2
Paul Dann
.UR https://github.com/giddie
.UE
.IP \(bu 2
Sorin Ionescu
.UR https://github.com/sorin-ionescu
.UE
.RE

View File

@ -1,40 +0,0 @@
.TH Yum
.PP
Defines yum
.UR http://yum.baseurl.org
.UE
aliases.
.SH Aliases
.RS
.IP \(bu 2
\fB\fCyumc\fR removes package(s) and leaves.
.IP \(bu 2
\fB\fCyumi\fR installs package(s).
.IP \(bu 2
\fB\fCyumh\fR displays history.
.IP \(bu 2
\fB\fCyuml\fR lists packages.
.IP \(bu 2
\fB\fCyumL\fR lists installed packages.
.IP \(bu 2
\fB\fCyumq\fR displays package information.
.IP \(bu 2
\fB\fCyumr\fR removes package(s).
.IP \(bu 2
\fB\fCyums\fR searches for a package.
.IP \(bu 2
\fB\fCyumu\fR updates packages.
.IP \(bu 2
\fB\fCyumU\fR upgrates packages.
.RE
.SH Authors
.PP
\fIThe authors of this module should be contacted via the issue tracker
.UR https://github.com/sorin-ionescu/prezto/issues
.UE .\fP
.RS
.IP \(bu 2
Sorin Ionescu
.UR https://github.com/sorin-ionescu
.UE
.RE

View File

@ -1,23 +0,0 @@
.TH Z
.PP
Integrates z
.UR https://github.com/rupa/z
.UE
into Prezto, which maintains a frequently used directory
list for fast directory changes.
.SH Aliases
.RS
.IP \(bu 2
\fB\fCj\fR changes the current working directory to the most \fIfrecent\fP match.
.RE
.SH Authors
.PP
\fIThe authors of this module should be contacted via the issue tracker
.UR https://github.com/sorin-ionescu/prezto/issues
.UE .\fP
.RS
.IP \(bu 2
Sorin Ionescu
.UR https://github.com/sorin-ionescu
.UE
.RE

View File

@ -1,199 +0,0 @@
.TH Prezto Instantly Awesome Zsh
.PP
Prezto is the configuration framework for Zsh
.UR http://www.zsh.org
.UE ; it enriches the command line
interface environment with sane defaults, aliases, functions, auto completion,
and prompt themes.
.SH Installation
.PP
Prezto will work with any recent release of Zsh, but the minimum recommended
version is 4.3.10.
.nr step0 0 1
.RS
.IP \n+[step0]
Launch Zsh:
.nf
zsh
.fi
.IP \n+[step0]
Clone the repository:
.nf
git clone --recursive https://github.com/sorin-ionescu/prezto.git "${ZDOTDIR:-$HOME}/.zprezto"
.fi
.IP \n+[step0]
Create a new Zsh configuration by copying the Zsh configuration files
provided:
.nf
setopt EXTENDED_GLOB
for rcfile in "${ZDOTDIR:-$HOME}"/.zprezto/runcoms/^README.md(.N); do
ln -s "$rcfile" "${ZDOTDIR:-$HOME}/.${rcfile:t}"
done
.fi
.IP \n+[step0]
Set Zsh as your default shell:
.nf
chsh -s /bin/zsh
.fi
.IP \n+[step0]
Open a new Zsh terminal window or tab.
.RE
.SS Mac OS X
.PP
If you have administrator privileges, you must fix an Apple\-introduced problem
in Mac OS X 10.5 Leopard by executing the following command, or BASH and Zsh
will have the wrong \fB\fCPATH\fR when executed non\-interactively.
.nf
sudo chmod ugo-x /usr/libexec/path_helper
.fi
.PP
\fB\fCpath_helper\fR is intended to make it easier for installers to add new paths to
the environment without having to edit shell configuration files by adding
a file with a path to the \fI/etc/paths.d\fP directory.
.PP
Unfortunately, \fB\fCpath_helper\fR always reads paths from \fI/etc/paths\fP set by Apple
then paths from \fI/etc/paths.d\fP set by third party installers, and lastly paths
from the \fB\fCPATH\fR environment variable set by the parent process, which
ultimately is set by the user with \fB\fCexport PATH=...\fR Thus, it reorders path
priorities, and user \fI/bin\fP directories meant to override system \fI/bin\fP
directories end up at the tail of the array.
.SS Troubleshooting
.PP
If you are not able to find certain commands after switching to \fIPrezto\fP,
modify the \fB\fCPATH\fR variable in \fI~/.zshenv\fP then open a new Zsh terminal
window or tab.
.SH Usage
.PP
Prezto has many features disabled by default. Read the source code and
accompanying README files to learn of what is available.
.SS Modules
.nr step1 0 1
.RS
.IP \n+[step1]
Browse \fI/modules\fP to see what is available.
.IP \n+[step1]
Load the modules you need in \fI~/.zpreztorc\fP then open a new Zsh terminal
window or tab.
.RE
.SS Themes
.nr step2 0 1
.RS
.IP \n+[step2]
For a list of themes, type \fB\fCprompt -l\fR.
.IP \n+[step2]
To preview a theme, type \fB\fCprompt -p name\fR.
.IP \n+[step2]
Load the theme you like in \fI~/.zpreztorc\fP then open a new Zsh terminal
window or tab.
.PP
[sorin theme]2
.UR http://i.imgur.com/ij8Lv.png
.UE
.RE
.SH Customization
.PP
The project is managed via Git
.UR http://git-scm.com
.UE . It is highly recommend that you commit
your changes and push them to GitHub
.UR https://github.com
.UE
to not lose them. If you do not know
how to use Git, follow this tutorial
.UR http://gitimmersion.com
.UE
and bookmark this reference
.UR http://gitref.org
.UE .
.SH Resources
.PP
The Zsh Reference Card
.UR http://www.bash2zsh.com/zsh_refcard/refcard.pdf
.UE
and the zsh\-lovers
.UR http://grml.org/zsh/zsh-lovers.html
.UE
man page are indispensable.
.SH Contribute
.PP
This project would not exist without all of its users and contributors
.UR https://github.com/sorin-ionescu/prezto/contributors
.UE .
.PP
If you have ideas on how to make the configuration easier to maintain or
improve its performance, do not hesitate to fork and send pull requests.
.SS Issue Reporting
.RS
.IP \(bu 2
Check that the issue has not already been reported.
.IP \(bu 2
Check that the issue has not already been fixed in the latest code.
.IP \(bu 2
Open an issue with a clear title and description in grammatically correct,
complete sentences.
.RE
.SS Pull Request
.RS
.IP \(bu 2
Read how to properly contribute to open source projects on GitHub
.UR http://gun.io/blog/how-to-github-fork-branch-and-pull-request
.UE .
.IP \(bu 2
Use a topic branch to easily amend a pull request later, if necessary.
.IP \(bu 2
Write good commit messages
.UR http://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html
.UE .
.IP \(bu 2
Squash commits on the topic branch before opening a pull request.
.IP \(bu 2
Use the same coding style and spacing.
.IP \(bu 2
Open a pull request
.UR https://help.github.com/articles/using-pull-requests
.UE
that relates to but one subject with a clear
title and description in grammatically correct, complete sentences.
.RE
.SS Modules
.RS
.IP \(bu 2
A \fIREADME.md\fP must be present.
.IP \(bu 2
Large functions must be placed in a \fIfunctions\fP directory.
.IP \(bu 2
Functions that take arguments must have completion.
.RE
.SS Themes
.RS
.IP \(bu 2
A screenshots section must be present in the file header.
.IP \(bu 2
The pull request description must have embedded
screenshots
.UR http://daringfireball.net/projects/markdown/syntax#img
.UE .
.RE
.SH License
.PP
(The MIT License)
.PP
Copyright (c) 2009\-2012 Robby Russell, Sorin Ionescu, and contributors.
.PP
Permission is hereby granted, free of charge, to any person obtaining a copy of
this software and associated documentation files (the "Software"), to deal in
the Software without restriction, including without limitation the rights to
use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
of the Software, and to permit persons to whom the Software is furnished to do
so, subject to the following conditions:
.PP
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
.PP
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

View File

@ -1,63 +0,0 @@
Editor
======
Sets key bindings.
Settings
--------
### Key bindings
To enable key bindings, add the following to *zpreztorc*, and replace 'bindings'
with 'emacs' or 'vi'.
zstyle ':prezto:module:editor' key-bindings 'bindings'
### Dot Expansion
To enable the auto conversion of .... to ../.., add the following to
*zpreztorc*.
zstyle ':prezto:module:editor' dot-expansion 'yes'
Theming
-------
To indicate when the editor is in the primary keymap (emacs or viins), add
the following to your `theme_prompt_setup` function.
zstyle ':prezto:module:editor:info:keymap:primary' format '>>>'
To indicate when the editor is in the primary keymap (emacs or viins) insert
mode, add the following to your `theme_prompt_setup` function.
zstyle ':prezto:module:editor:info:keymap:primary:insert' format 'I'
To indicate when the editor is in the primary keymap (emacs or viins) overwrite
mode, add the following to your `theme_prompt_setup` function.
zstyle ':prezto:module:editor:info:keymap:primary:overwrite' format 'O'
To indicate when the editor is in the alternate keymap (vicmd), add the
following to your `theme_prompt_setup` function.
zstyle ':prezto:module:editor:info:keymap:alternate' format '<<<'
To indicate when the editor is completing, add the following to your
`theme_prompt_setup` function.
zstyle ':prezto:module:editor:info:completing' format '...'
Then add `$editor_info[context]`, where context is *keymap*, *insert*, or
*overwrite*, to `$PROMPT` or `$RPROMPT` and call `editor-info` in the
`prompt_name_preexec` hook function.
Authors
-------
*The authors of this module should be contacted via the [issue tracker][1].*
- [Sorin Ionescu](https://github.com/sorin-ionescu)
[1]: https://github.com/sorin-ionescu/oh-my-zsh/issues

View File

@ -1,33 +0,0 @@
Emacs
=====
Enables Emacs dependency management.
Dependency management
---------------------
[Carton][1] installs and manages Emacs packages for Emacs package development
and Emacs configuration.
This module prepends the Carton directory to the path variable to enable the
execution of `carton`.
Aliases
-------
### Carton
- `cai` installs dependencies.
- `cau` updates dependencies.
- `caI` initializes the current directory for dependency management.
- `cae` executes a command which correct dependencies.
Authors
-------
*The authors of this module should be contacted via the [issue tracker][2].*
- [Sebastian Wiesner](https://github.com/lunaryorn)
[1]: https://github.com/rejeep/carton
[2]: https://github.com/sorin-ionescu/prezto/issues

View File

@ -1,27 +0,0 @@
GPG
===
Provides for an easier use of [GPG][1] by setting up [gpg-agent][2].
### SSH
To enable OpenSSH Agent protocol emulation, and make `gpg-agent` a drop-in
replacement for `ssh-agent`, add the following line to
*~/.gnupg/gpg-agent.conf*:
enable-ssh-support
When OpenSSH Agent protocol emulation is enabled, this module will load the SSH
module for additional processing.
Authors
-------
*The authors of this module should be contacted via the [issue tracker][3].*
- [Sorin Ionescu](https://github.com/sorin-ionescu)
[1]: http://www.gnupg.org
[2]: http://linux.die.net/man/1/gpg-agent
[3]: https://github.com/sorin-ionescu/prezto/issues

View File

@ -1,26 +0,0 @@
Homebrew
========
Defines Homebrew aliases.
Aliases
-------
- `brewc` cleans outdated brews and their cached archives.
- `brewC` cleans outdated brews, including keg-only, and their cached archives.
- `brewi` installs a formula.
- `brewl` lists installed formulae.
- `brews` searches for a formula.
- `brewU` upgrades Homebrew and outdated brews.
- `brewu` upgrades Homebrew.
- `brewx` uninstalls a formula.
Authors
-------
*The authors of this module should be contacted via the [issue tracker][1].*
- [Sorin Ionescu](https://github.com/sorin-ionescu)
[1]: https://github.com/sorin-ionescu/prezto/issues

View File

@ -1,46 +0,0 @@
Node.js
=======
Provides utility functions for [Node.js][1], loads the Node Version Manager, and
enables [npm][2] completion.
nvm
---
[nvm][5] allows for managing multiple, isolated Node.js installations in the
home directory.
Functions
---------
- `node-doc` opens the Node.js online [API documentation][3] in the default
browser.
- `node-info` exposes information about the Node.js environment via the
`$node_info` associative array.
Theming
-------
To display the version number of the current Node.js version, define the
following style inside the `prompt_name_setup` function.
# %v - Node.js version.
zstyle ':prezto:module:node:info:version' format 'version:%v'
Then add `$node_info[version]` to either `$PROMPT` or `$RPROMPT` and call
`node-info` in `prompt_name_preexec` hook function.
Authors
-------
*The authors of this module should be contacted via the [issue tracker][4].*
- [Sorin Ionescu](https://github.com/sorin-ionescu)
- [Zeh Rizzatti](https://github.com/zehrizzatti)
[1]: http://nodejs.org
[2]: http://npmjs.org
[3]: http://nodejs.org/api
[4]: https://github.com/sorin-ionescu/prezto/issues
[5]: https://github.com/creationix/nvm

View File

@ -1,28 +0,0 @@
SSH
===
Provides for an easier use of [SSH][1] by setting up [ssh-agent][2].
This module is disabled on Mac OS X due to custom Apple SSH support rendering it
unnecessary.
Settings
--------
### Identities
To load multiple identities, add the following line to *zpreztorc*:
zstyle ':prezto:module:ssh:load' identities 'id_rsa' 'id_dsa' 'id_github'
Authors
-------
*The authors of this module should be contacted via the [issue tracker][3].*
- [Sorin Ionescu](https://github.com/sorin-ionescu)
[1]: http://www.openssh.com
[2]: http://www.openbsd.org/cgi-bin/man.cgi?query=ssh-agent&sektion=1
[3]: https://github.com/sorin-ionescu/prezto/issues

View File

@ -1,45 +0,0 @@
Terminal
========
Sets terminal window and tab titles.
Settings
--------
### Auto-Title
To auto set the terminal window and tab titles with the current command or
directory, add the following to *zpreztorc*:
zstyle ':prezto:module:terminal' auto-title 'yes'
Auto titling is disabled inside terminal multiplexers, except inside dvtm, since
it interferes with window names defined in configuration files and profile
managers.
To format terminal window and tab titles, add the following to *zpreztorc*:
zstyle ':prezto:module:terminal:window-title' format '%n@%m: %s'
zstyle ':prezto:module:terminal:tab-title' format '%m: %s'
`%s` will be replaced with the current working directory path or the currently
executing program name.
For a list of sequences, see [Expansion of Prompt Sequences][1].
Functions
---------
- `set-tab-title` sets the terminal tab title.
- `set-window-title` sets the terminal or terminal multiplexer window title.
Authors
-------
*The authors of this module should be contacted via the [issue tracker][2].*
- [Sorin Ionescu](https://github.com/sorin-ionescu)
[1]: http://zsh.sourceforge.net/Doc/Release/Prompt-Expansion.html#Expansion-of-Prompt-Sequences
[2]: https://github.com/sorin-ionescu/prezto/issues

View File

@ -1,151 +0,0 @@
Prezto — Instantly Awesome Zsh
==============================
Prezto is the configuration framework for [Zsh][1]; it enriches the command line
interface environment with sane defaults, aliases, functions, auto completion,
and prompt themes.
Installation
------------
Prezto will work with any recent release of Zsh, but the minimum recommended
version is 4.3.10.
1. Launch Zsh:
zsh
2. Clone the repository:
git clone --recursive https://github.com/sorin-ionescu/prezto.git "${ZDOTDIR:-$HOME}/.zprezto"
3. Create a new Zsh configuration by copying the Zsh configuration files
provided:
setopt EXTENDED_GLOB
for rcfile in "${ZDOTDIR:-$HOME}"/.zprezto/runcoms/^README.md(.N); do
ln -s "$rcfile" "${ZDOTDIR:-$HOME}/.${rcfile:t}"
done
4. Set Zsh as your default shell:
chsh -s /bin/zsh
5. Open a new Zsh terminal window or tab.
### Troubleshooting
If you are not able to find certain commands after switching to *Prezto*,
modify the `PATH` variable in *~/.zshenv* then open a new Zsh terminal
window or tab.
Usage
-----
Prezto has many features disabled by default. Read the source code and
accompanying README files to learn of what is available.
### Modules
1. Browse */modules* to see what is available.
2. Load the modules you need in *~/.zpreztorc* then open a new Zsh terminal
window or tab.
### Themes
1. For a list of themes, type `prompt -l`.
2. To preview a theme, type `prompt -p name`.
3. Load the theme you like in *~/.zpreztorc* then open a new Zsh terminal
window or tab.
![sorin theme][2]
Customization
-------------
The project is managed via [Git][3]. It is highly recommended that you fork this
project; so, that you can commit your changes and push them to [GitHub][4] to
not lose them. If you do not know how to use Git, follow this [tutorial][5] and
bookmark this [reference][6].
Resources
---------
The [Zsh Reference Card][7] and the [zsh-lovers][8] man page are indispensable.
Contribute
----------
This project would not exist without all of its users and [contributors][9].
If you have ideas on how to make the configuration easier to maintain or
improve its performance, do not hesitate to fork and send pull requests.
### Issue Reporting
- Check that the issue has not already been reported.
- Check that the issue has not already been fixed in the latest code.
- Open an issue with a clear title and description in grammatically correct,
complete sentences.
### Pull Request
- Read [how to properly contribute to open source projects on GitHub][10].
- Use a topic branch to easily amend a pull request later, if necessary.
- Write [good commit messages][11].
- Squash commits on the topic branch before opening a pull request.
- Use the same coding style and spacing.
- Open a [pull request][12] that relates to but one subject with a clear
title and description in grammatically correct, complete sentences.
#### Modules
- Markdown and man page documentation must be present.
- Large functions must be placed in a *functions* directory.
- Functions that take arguments must have completion.
#### Themes
- A screenshots section must be present in the file header.
- The pull request description must have [embedded
screenshots][13].
License
-------
(The MIT License)
Copyright (c) 2009-2012 Robby Russell, Sorin Ionescu, and contributors.
Permission is hereby granted, free of charge, to any person obtaining a copy of
this software and associated documentation files (the "Software"), to deal in
the Software without restriction, including without limitation the rights to
use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
of the Software, and to permit persons to whom the Software is furnished to do
so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
[1]: http://www.zsh.org
[2]: http://i.imgur.com/nBEEZ.png "sorin theme"
[3]: http://git-scm.com
[4]: https://github.com
[5]: http://gitimmersion.com
[6]: http://gitref.org
[7]: http://www.bash2zsh.com/zsh_refcard/refcard.pdf
[8]: http://grml.org/zsh/zsh-lovers.html
[9]: https://github.com/sorin-ionescu/prezto/contributors
[10]: http://gun.io/blog/how-to-github-fork-branch-and-pull-request
[11]: http://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html
[12]: https://help.github.com/articles/using-pull-requests
[13]: http://daringfireball.net/projects/markdown/syntax#img

View File

@ -10,7 +10,7 @@
#
# Check for the minimum supported version.
min_zsh_version='4.3.11'
min_zsh_version='4.3.10'
if ! autoload -Uz is-at-least || ! is-at-least "$min_zsh_version"; then
print "prezto: old shell detected, minimum required: $min_zsh_version" >&2
return 1

View File

@ -8,7 +8,7 @@ Load modules in *zpreztorc*. The order matters.
Archive
-------
Provides functions to list and extract archives.
Provides functions to extract and list popular archive formats.
Command-Not-Found
-----------------
@ -31,41 +31,20 @@ Dpkg
Defines dpkg aliases and functions.
Editor
------
Sets key bindings.
Emacs
-----
Enables Emacs dependency management.
Environment
-----------
Sets general shell options and defines environment variables.
Fasd
----
Maintains a frequently used file and directory list for fast access.
Git
---
Enhances the Git distributed version control system by providing aliases,
functions and by exposing repository status information to prompts.
GNU Utility
-----------
Provides for the interactive use of GNU utilities on non-GNU systems.
GPG
---
GPG-Agent
---------
Provides for an easier use of GPG by setting up gpg-agent.
Provides for an easier use of gpg-agent.
Haskell
-------
@ -77,20 +56,15 @@ Helper
Provides helper functions for developing modules.
History
-------
Sets history options and defines history aliases.
History Substring Search
------------------------
Integrates zsh-history-substring-search into Prezto.
Homebrew
--------
History
-------
Defines Homebrew aliases.
Sets history options and defines history aliases.
Macports
--------
@ -102,11 +76,6 @@ Node.js
Provides utility functions for Node.js and loads npm completion.
Ocaml
-----
Initializes Ocaml package management.
OSX
---
@ -158,10 +127,10 @@ Spectrum
Provides for easier use of 256 colors and effects.
SSH
---
SSH-Agent
---------
Provides for an easier use of SSH by setting up ssh-agent.
Provides for an easier use of ssh-agent.
Syntax Highlighting
-------------------
@ -193,3 +162,9 @@ Yum
Defines yum aliases.
Z
-
Integrates z into Prezto, which maintains a frequently used directory list for
fast directory changes.

View File

@ -1,13 +1,13 @@
Archive
=======
Provides functions to list and extract archives.
Provides functions to extract and list popular archive formats.
Functions
---------
- `lsarchive` lists the contents of one or more archives.
- `unarchive` extracts the contents of one or more archives.
- `extract` extracts the contents of one or more archives.
- `ls-archive` lists the contents of one or more archives.
Supported Formats
-----------------
@ -26,7 +26,7 @@ installed:
- *.lzma* requires `unlzma`.
- *.Z* requires `uncompress`.
- *.zip* requires `unzip`.
- *.rar* requires `unrar` or `rar`.
- *.rar* requires `unrar`.
- *.7z* requires `7za`.
- *.deb* requires `ar`, `tar`.

View File

@ -1,8 +1,8 @@
#compdef unarchive
#compdef extract
#autoload
#
# Completes unarchive.
# Completes extract.
#
# Authors:
# Sorin Ionescu <sorin.ionescu@gmail.com>

View File

@ -1,8 +1,8 @@
#compdef lsarchive
#compdef ls-archive
#autoload
#
# Completes lsarchive.
# Completes ls-archive.
#
# Authors:
# Sorin Ionescu <sorin.ionescu@gmail.com>

View File

@ -1,5 +1,5 @@
#
# Extracts the contents of archives.
# Extracts the contents of popular archive formats.
#
# Authors:
# Sorin Ionescu <sorin.ionescu@gmail.com>
@ -53,9 +53,7 @@ while (( $# > 0 )); do
(*.lzma) unlzma "$1" ;;
(*.Z) uncompress "$1" ;;
(*.zip) unzip "$1" -d $extract_dir ;;
(*.rar) unrar &> /dev/null \
&& unrar e -ad "$1" \
|| rar e -ad "$1" ;;
(*.rar) unrar e -ad "$1" ;;
(*.7z) 7za x "$1" ;;
(*.deb)
mkdir -p "$extract_dir/control"

View File

@ -1,5 +1,5 @@
#
# Lists the contents of archives.
# Lists the contents of popular archive formats.
#
# Authors:
# Sorin Ionescu <sorin.ionescu@gmail.com>
@ -41,9 +41,7 @@ while (( $# > 0 )); do
|| lzcat "$1" | tar x${verbose:+v}f - ;;
(*.tar) tar t${verbose:+v}f "$1" ;;
(*.zip) unzip -l${verbose:+v} "$1" ;;
(*.rar) unrar &> /dev/null \
&& unrar ${${verbose:+v}:-l} "$1" \
|| rar ${${verbose:+v}:-l} "$1" ;;
(*.rar) unrar ${${verbose:+v}:-l} "$1" ;;
(*.7z) 7za l "$1" ;;
(*)
print "$0: cannot list: $1" >&2

View File

@ -1,8 +1,7 @@
Command-Not-Found
=================
Displays installation information for not found commands by loading the
[command-not-found][1] tool on Debian-based and Arch Linux-based distributions.
Loads the [command-not-found][1] tool on Debian-based distributions.
Authors
-------

View File

@ -5,14 +5,10 @@
# Joseph Jon Booker <joe@neoturbine.net>
#
# Load command-not-found on Debian-based distributions.
if [[ -s '/etc/zsh_command_not_found' ]]; then
source '/etc/zsh_command_not_found'
# Load command-not-found on Arch Linux-based distributions.
elif [[ -s '/usr/share/doc/pkgfile/command-not-found.zsh' ]]; then
source '/usr/share/doc/pkgfile/command-not-found.zsh'
# Return if requirements are not found.
else
if [[ ! -s '/etc/zsh_command_not_found' ]]; then
return 1
fi
source '/etc/zsh_command_not_found'

View File

@ -30,6 +30,9 @@ setopt AUTO_PARAM_SLASH # If completed parameter is a directory, add a traili
unsetopt MENU_COMPLETE # Do not autoselect the first completion entry.
unsetopt FLOW_CONTROL # Disable start/stop characters in shell editor.
# Treat these characters as part of a word.
WORDCHARS='*?_-.[]~&;!#$%^(){}<>'
#
# Styles
#
@ -93,7 +96,7 @@ zstyle ':completion::*:(-command-|export):*' fake-parameters ${${${_comps[(I)-va
# Populate hostname completion.
zstyle -e ':completion:*:hosts' hosts 'reply=(
${=${=${=${${(f)"$(cat {/etc/ssh_,~/.ssh/known_}hosts(|2)(N) 2>/dev/null)"}%%[#| ]*}//\]:[0-9]*/ }//,/ }//\[/ }
${=${${(f)"$(cat {/etc/ssh_,~/.ssh/known_}hosts(|2)(N) 2>/dev/null)"}%%[#| ]*}//,/ }
${=${(f)"$(cat /etc/hosts(|)(N) <<(ypcat hosts 2>/dev/null))"}%%\#*}
${=${${${${(@M)${(f)"$(cat ~/.ssh/config 2>/dev/null)"}:#Host *}#Host }:#*\**}:#*\?*}}
)'
@ -141,8 +144,8 @@ fi
# SSH/SCP/RSYNC
zstyle ':completion:*:(scp|rsync):*' tag-order 'hosts:-host:host hosts:-domain:domain hosts:-ipaddr:ip\ address *'
zstyle ':completion:*:(scp|rsync):*' group-order users files all-files hosts-domain hosts-host hosts-ipaddr
zstyle ':completion:*:ssh:*' tag-order 'hosts:-host:host hosts:-domain:domain hosts:-ipaddr:ip\ address *'
zstyle ':completion:*:ssh:*' group-order users hosts-domain hosts-host users hosts-ipaddr
zstyle ':completion:*:ssh:*' tag-order users 'hosts:-host:host hosts:-domain:domain hosts:-ipaddr:ip\ address *'
zstyle ':completion:*:ssh:*' group-order hosts-domain hosts-host users hosts-ipaddr
zstyle ':completion:*:(ssh|scp|rsync):*:hosts-host' ignored-patterns '*(.|:)*' loopback ip6-loopback localhost ip6-localhost broadcasthost
zstyle ':completion:*:(ssh|scp|rsync):*:hosts-domain' ignored-patterns '<->.<->.<->.<->' '^[-[:alnum:]]##(.[-[:alnum:]]##)##' '*@*'
zstyle ':completion:*:(ssh|scp|rsync):*:hosts-ipaddr' ignored-patterns '^(<->.<->.<->.<->|(|::)([[:xdigit:].]##:(#c,2))##(|%*))' '127.0.0.<->' '255.255.255.255' '::1' 'fe80::*'

View File

@ -7,16 +7,16 @@ Aliases
-------
- `debc` cleans the cache.
- `debf` displays a file's package.
- `debf` displays a file's packake.
- `debi` installs packages from repositories.
- `debI` installs packages from files.
- `debq` displays package information.
- `debu` updates the package lists.
- `debu` updates the packages lists.
- `debU` upgrades outdated packages.
- `debx` removes packages.
- `debX` removes packages, their configuration, and unneeded dependencies.
- `debs` searches for packages.
- `deb-build` creates a basic deb package.
- `deb-build` creates a basic .deb package.
- `deb-kclean` removes all kernel images and headers, except for the ones in
use.

View File

@ -19,7 +19,7 @@ fi
# Cleans the cache.
alias debc='sudo apt-get clean && sudo apt-get autoclean'
# Displays a file's package.
# Displays a file's packake.
alias debf='apt-file search --regexp'
# Installs packages from repositories.
@ -31,7 +31,7 @@ alias debI='sudo dpkg -i'
# Displays package information.
alias debq='apt-cache show'
# Updates the package lists.
# Updates the packages lists.
alias debu='sudo apt-get update'
# Upgrades outdated packages.
@ -50,7 +50,7 @@ else
alias debs='apt-cache search'
fi
# Creates a basic deb package.
# Creates a basic .deb package.
alias deb-build='time dpkg-buildpackage -rfakeroot -us -uc'
# Removes all kernel images and headers, except for the ones in use.

View File

@ -4,6 +4,42 @@
# Authors:
# Sorin Ionescu <sorin.ionescu@gmail.com>
#
# Usage:
# To enable key bindings, add the following to zpreztorc, and replace 'map'
# with 'emacs' or 'vi.
#
# zstyle ':prezto:module:editor' keymap 'map'
#
# To enable the auto conversion of .... to ../.., add the following to
# zpreztorc.
#
# zstyle ':prezto:module:editor' dot-expansion 'yes'
#
# To indicate when the editor is in the primary keymap (emacs or viins), add
# the following to your theme prompt setup function.
#
# zstyle ':prezto:module:editor:info:keymap:primary' format '>>>'
#
# To indicate when the editor is in the primary keymap (emacs or viins) insert
# mode, add the following to your theme prompt setup function.
#
# zstyle ':prezto:module:editor:info:keymap:primary:insert' format 'I'
#
# To indicate when the editor is in the primary keymap (emacs or viins)
# overwrite mode, add the following to your theme prompt setup function.
#
# zstyle ':prezto:module:editor:info:keymap:primary:overwrite' format 'O'
#
# To indicate when the editor is in the alternate keymap (vicmd), add the
# following to your theme prompt setup function.
#
# zstyle ':prezto:module:editor:info:keymap:alternate' format '<<<'
#
# To indicate when the editor is completing, add the following to your theme
# prompt setup function.
#
# zstyle ':prezto:module:editor:info:completing' format '...'
#
# Return if requirements are not found.
if [[ "$TERM" == 'dumb' ]]; then
@ -21,9 +57,6 @@ setopt BEEP
# Variables
#
# Treat these characters as part of a word.
WORDCHARS='*?_-.[]~&;!#$%^(){}<>'
# Use human-friendly identifiers.
zmodload zsh/terminfo
typeset -gA key_info
@ -57,11 +90,12 @@ key_info=(
'BackTab' "$terminfo[kcbt]"
)
# Set empty $key_info values to an invalid UTF-8 sequence to induce silent
# bindkey failure.
# Do not bind any keys if there are empty values in $key_info.
for key in "${(k)key_info[@]}"; do
if [[ -z "$key_info[$key]" ]]; then
key_info["$key"]='<27>'
print "prezto: one or more keys are non-bindable" >&2
unset key{,_info}
return 1
fi
done
@ -107,25 +141,8 @@ function editor-info {
}
zle -N editor-info
# Ensures that $terminfo values are valid and updates editor information when
# the keymap changes.
# 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
@ -236,6 +253,10 @@ bindkey -M vicmd "v" edit-command-line
bindkey -M vicmd "u" undo
bindkey -M vicmd "$key_info[Control]R" redo
# Switch to command mode.
bindkey -M viins "jk" vi-cmd-mode
bindkey -M viins "kj" vi-cmd-mode
if (( $+widgets[history-incremental-pattern-search-backward] )); then
bindkey -M vicmd "?" history-incremental-pattern-search-backward
bindkey -M vicmd "/" history-incremental-pattern-search-forward
@ -306,14 +327,14 @@ fi
#
# Set the key layout.
zstyle -s ':prezto:module:editor' key-bindings 'key_bindings'
if [[ "$key_bindings" == (emacs|) ]]; then
zstyle -s ':prezto:module:editor' keymap 'keymap'
if [[ "$keymap" == (emacs|) ]]; then
bindkey -e
elif [[ "$key_bindings" == vi ]]; then
elif [[ "$keymap" == vi ]]; then
bindkey -v
else
print "prezto: editor: invalid key bindings: $key_bindings" >&2
print "prezto: invalid keymap: $keymap" >&2
fi
unset key{,map,bindings}
unset key{map,}

View File

@ -1,25 +0,0 @@
#
# Configures Emacs dependency management.
#
# Authors: Sebastian Wiesner <lunaryorn@gmail.com>
#
# Return if requirements are not found.
if [[ ! -d "$HOME/.cask" ]]; then
return 1
fi
# Prepend Cask bin directory.
path=($HOME/.cask/bin $path)
# Load Carton completion
source "$HOME/.cask/etc/cask_completion.zsh" 2> /dev/null
#
# Aliases
#
alias cai='cask install'
alias cau='cask update'
alias caI='cask init'
alias cae='cask exec'

View File

@ -17,8 +17,6 @@ zle -N self-insert url-quote-magic
#
setopt BRACE_CCL # Allow brace character class list expansion.
setopt COMBINING_CHARS # Combine zero-length punctuation characters (accents)
# with the base character.
setopt RC_QUOTES # Allow 'Henry''s Garage' instead of 'Henry'\''s Garage'.
unsetopt MAIL_WARNING # Don't print a warning message if a mail file has been accessed.
@ -56,13 +54,3 @@ 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
)

View File

@ -1,8 +1,7 @@
Git
===
Enhances the [Git][1] distributed version control system by providing aliases,
functions and by exposing repository status information to prompts.
Enhances the [Git][1] distributed version control system by providing aliases, functions and by exposing repository status information to prompts.
Git **1.7.2** is the [minimum required version][7].
@ -13,7 +12,7 @@ Settings
The format of the [git-log][8] output is configurable via the following style,
where context is *brief*, *oneline*, and *medium*, which will be passed to the
`--pretty=format:` switch.
`--prety=format:` switch.
zstyle ':prezto:module:git:log:context' format ''
@ -39,8 +38,8 @@ Aliases
- `gbc` creates a new branch.
- `gbl` lists branches and their commits.
- `gbL` lists local and remote branches and their commits.
- `gbs` lists branches and their commits with ancestry graphs.
- `gbS` lists local and remote branches and their commits with ancestry
- `gbs` lists branches and their commits with ancestery graphs.
- `gbS` lists local and remote branches and their commits with ancestery
graphs.
- `gbx` deletes a branch.
- `gbX` deletes a branch irrespective of its merged status.
@ -54,27 +53,16 @@ Aliases
- `gca` stages all modified and deleted files.
- `gcm` records changes to the repository with the given message.
- `gco` checks out a branch or paths to work tree.
- `gcO` checks out hunks from the index or the tree interactively.
- `gcO` checks out paths to work tree using the *HEAD* commit.
- `gcf` amends the tip of the current branch using the same log message as
*HEAD*.
- `gcF` amends the tip of the current branch.
- `gcp` applies changes introduced by existing commits.
- `gcP` applies changes introduced by existing commits without committing.
- `gcr` reverts existing commits by reverting patches and recording new
commits.
- `gcR` removes the *HEAD* commit.
- `gcs` displays various types of objects.
- `gcl` lists lost commits.
### Conflict
- `gCl` lists unmerged files.
- `gCa` adds unmerged file contents to the index.
- `gCe` executes merge-tool on all unmerged file.
- `gCo` checks out our changes for unmerged paths.
- `gCO` checks out our changes for all unmerged paths.
- `gCt` checks out their changes for unmerged paths.
- `gCT` checks out their changes for all unmerged paths.
- `gcl` displays lost commits.
### Data
@ -97,8 +85,8 @@ Aliases
- `gg` displays lines matching a pattern.
- `ggi` displays lines matching a pattern ignoring case.
- `ggl` lists files matching a pattern.
- `ggL` lists files that are not matching a pattern.
- `ggl` displays files matching a pattern.
- `ggL` displays files are not matching a pattern.
- `ggv` displays lines not matching a pattern.
- `ggw` displays lines matching a pattern at word boundary.
@ -109,11 +97,21 @@ Aliases
- `giu` adds file contents to the index (updates only known files).
- `gid` displays changes between the index and a named commit (diff).
- `giD` displays changes between the index and a named commit (word diff).
- `gir` resets the current HEAD to the specified state.
- `giR` resets the current index interactively.
- `gir` resets current HEAD to the specified state.
- `giR` resets current index to the specified state.
- `gix` removes files/directories from the index (recursively).
- `giX` removes files/directories from the index (recursively and forced).
### Conflict
- `gCl` lists unmerged files.
- `gCa` adds unmerged file contents to the index.
- `gCe` executes merge-tool on all unmerged file.
- `gCo` checks out our changes for unmerged paths.
- `gCO` checks out our changes for all unmerged paths.
- `gCt` checks out their changes for unmerged paths.
- `gCT` checks out their changes for all unmerged paths.
### Log
- `gl` displays the log.
@ -155,12 +153,12 @@ Aliases
### Remote
- `gR` manages tracked repositories.
- `gRl` lists remote names and their URLs.
- `gRl` displays remote names and URLs.
- `gRa` adds a new remote.
- `gRx` removes a remote.
- `gRm` renames a remote.
- `gRu` fetches remotes updates.
- `gRp` prunes all stale remote tracking branches.
- `gRc` deletes all stale remote tracking branches.
- `gRs` displays information about a given remote.
- `gRb` opens a remote on [GitHub][3] in the default browser.
@ -170,9 +168,10 @@ Aliases
- `gsa` applies the changes recorded in a stash to the working directory.
- `gsx` drops a stashed state.
- `gsX` drops all the stashed states.
- `gsd` lists dropped stashed states.
- `gsl` lists stashed states.
- `gsL` lists dropped stashed states.
- `gsd` displays changes between the stash and its original parent.
- `gsL` displays the changes recorded in the stash as a diff between the
stashed state and its original parent.
- `gsp` removes and applies a single stashed state from the stash list.
- `gsr` recovers a given stashed state.
- `gss` stashes the changes of the dirty working directory, including untracked.
@ -247,47 +246,25 @@ setting a style is as follows.
zstyle ':prezto:module:git:info:context:subcontext' format 'string'
### Main Contexts
| Name | Format Code | Description
| --------- | :---------: | ---------------------------------------------------
| action | %s | Special action name
| added | %a | Added files count
| ahead | %A | Commits ahead of remote count
| behind | %B | Commits behind of remote count
| branch | %b | Branch name
| commit | %c | Commit hash
| position | %p | Commits from the nearest tag count
| remote | %R | Remote name
| stashed | %S | Stashed states count
### Concise Contexts
| Name | Format Code | Description
| --------- | :---------: | ---------------------------------------------------
| clean | %C | Clean state
| dirty | %D | Dirty files count
| indexed | %i | Indexed files count
| unindexed | %I | Unindexed files count
| untracked | %u | Untracked files count
The following contexts must be enabled with the following zstyle:
zstyle ':prezto:module:git:info' verbose 'yes'
### Verbose Contexts
| Name | Format Code | Description
| --------- | :---------: | ---------------------------------------------------
| added | %a | Added files count
| clean | %C | Clean state
| deleted | %d | Deleted files count
| dirty | %D | Dirty files count
| modified | %m | Modified files count
| position | %p | Commits from the nearest tag count
| remote | %R | Remote name
| renamed | %r | Renamed files count
| stashed | %S | Stashed states count
| unmerged | %U | Unmerged files count
| untracked | %u | Untracked files count
### Special Action Contexts
[**Main Contexts**]
| Name | Format | Description
| -------------------- | :---------: | -----------------------------------------
@ -299,6 +276,7 @@ The following contexts must be enabled with the following zstyle:
| rebase | value | Rebasing
| rebase-interactive | value | Rebasing interactively
| rebase-merge | value | Rebasing merge
[**Special Action Contexts**]
First, format the repository state attributes. For example, to format the branch
and remote names, define the following styles.
@ -312,7 +290,7 @@ Second, format how the above attributes are displayed in prompts.
'prompt' ' git(%b)' \
'rprompt' '[%R]'
Last, add `$git_info[prompt]` to `$PROMPT` and `$git_info[rprompt]` to
Last, add `$git_info[prompt]` to `$PROMPT` and `$git_info[prompt]` to
`$RPROMPT` respectively and call `git-info` in the `prompt_name_preexec` hook
function.

View File

@ -42,13 +42,12 @@ alias gbs='git show-branch'
alias gbS='git show-branch -a'
# Commit (c)
alias gc='git commit --verbose'
alias gca='git commit --verbose --all'
alias gc='git commit'
alias gca='git commit --all'
alias gcm='git commit --message'
alias gco='git checkout'
alias gcO='git checkout --patch'
alias gcO='git checkout HEAD --'
alias gcf='git commit --amend --reuse-message HEAD'
alias gcF='git commit --verbose --amend'
alias gcp='git cherry-pick --ff'
alias gcP='git cherry-pick --no-commit'
alias gcr='git revert'
@ -56,15 +55,6 @@ alias gcR='git reset "HEAD^"'
alias gcs='git show'
alias gcl='git-commit-lost'
# Conflict (C)
alias gCl='git status | sed -n "s/^.*both [a-z]*ed: *//p"'
alias gCa='git add $(gCl)'
alias gCe='git mergetool $(gCl)'
alias gCo='git checkout --ours --'
alias gCO='gCo $(gCl)'
alias gCt='git checkout --theirs --'
alias gCT='gCt $(gCl)'
# Data (d)
alias gd='git ls-files'
alias gdc='git ls-files --cached'
@ -95,10 +85,19 @@ alias giu='git add --update'
alias gid='git diff --no-ext-diff --cached'
alias giD='git diff --no-ext-diff --cached --word-diff'
alias gir='git reset'
alias giR='git reset --patch'
alias giR='git reset --keep'
alias gix='git rm -r --cached'
alias giX='git rm -rf --cached'
# Conflict (C)
alias gCl='git status | sed -n "s/^.*both [a-z]*ed: *//p"'
alias gCa='git add $(gCl)'
alias gCe='git mergetool $(gCl)'
alias gCo='git checkout --ours --'
alias gCO='gCo $(gCl)'
alias gCt='git checkout --theirs --'
alias gCT='gCt $(gCl)'
# Log (l)
alias gl='git log --topo-order --pretty=format:${_git_log_medium_format}'
alias gls='git log --topo-order --stat --pretty=format:${_git_log_medium_format}'
@ -138,7 +137,7 @@ alias gRa='git remote add'
alias gRx='git remote rm'
alias gRm='git remote rename'
alias gRu='git remote update'
alias gRp='git remote prune'
alias gRc='git remote prune'
alias gRs='git remote show'
alias gRb='git-hub-browse'
@ -147,9 +146,9 @@ alias gs='git stash'
alias gsa='git stash apply'
alias gsx='git stash drop'
alias gsX='git-stash-clear-interactive'
alias gsd='git-stash-dropped'
alias gsl='git stash list'
alias gsL='git-stash-dropped'
alias gsd='git stash show --patch --stat'
alias gsL='git stash show --patch --stat'
alias gsp='git stash pop'
alias gsr='git-stash-recover'
alias gss='git stash save --include-untracked'

View File

@ -89,6 +89,31 @@ function _git-action {
return 1
}
# Turns off git-info for the current repository.
function _git-info-abort {
if ! is-true "$_git_info_executing"; then
return 1
fi
cat >&2 <<EOF
Gathering status for certain repositories is time intensive.
By pressing CTRL + C, you have turned off prompt Git status
for this repository.
To revert, execute:
git-info on
EOF
unset _git_info_executing
git config --bool prompt.showinfo false
git-info
return 0
}
add-zsh-trap INT _git-info-abort
# Gets the Git status information.
function git-info {
# Extended globbing is needed to parse repository status.
@ -101,13 +126,13 @@ function git-info {
local added=0
local added_format
local added_formatted
local ahead=0
local ahead
local ahead_and_behind
local ahead_and_behind_cmd
local ahead_format
local ahead_formatted
local ahead_or_behind
local behind=0
local behind
local behind_format
local behind_formatted
local branch
@ -126,11 +151,9 @@ function git-info {
local dirty_format
local dirty_formatted
local ignore_submodules
local indexed=0
local indexed_format
local indexed_formatted
local -A info_formats
local info_format
local line_number=0
local modified=0
local modified_format
local modified_formatted
@ -148,10 +171,6 @@ function git-info {
local stashed_format
local stashed_formatted
local status_cmd
local status_mode
local unindexed=0
local unindexed_format
local unindexed_formatted
local unmerged=0
local unmerged_format
local unmerged_formatted
@ -184,152 +203,44 @@ function git-info {
return 1
fi
# Ignore submodule status.
zstyle -s ':prezto:module:git:status:ignore' submodules 'ignore_submodules'
# Used to abort and turn git-info off on SIGINT.
_git_info_executing=true
# Format commit.
zstyle -s ':prezto:module:git:info:commit' format 'commit_format'
if [[ -n "$commit_format" ]]; then
commit="$(git rev-parse HEAD 2> /dev/null)"
if [[ -n "$commit" ]]; then
zformat -f commit_formatted "$commit_format" "c:$commit"
fi
fi
# Use porcelain status for easy parsing.
status_cmd='git status --porcelain'
# Format stashed.
zstyle -s ':prezto:module:git:info:stashed' format 'stashed_format'
if [[ -n "$stashed_format" && -f "$(git-dir)/refs/stash" ]]; then
stashed="$(git stash list 2> /dev/null | wc -l | awk '{print $1}')"
if [[ -n "$stashed" ]]; then
zformat -f stashed_formatted "$stashed_format" "S:$stashed"
fi
fi
# Format action.
zstyle -s ':prezto:module:git:info:action' format 'action_format'
if [[ -n "$action_format" ]]; then
action="$(_git-action)"
if [[ -n "$action" ]]; then
zformat -f action_formatted "$action_format" "s:$action"
fi
fi
# Get the branch.
branch="${$(git symbolic-ref HEAD 2> /dev/null)#refs/heads/}"
# Format branch.
zstyle -s ':prezto:module:git:info:branch' format 'branch_format'
if [[ -n "$branch" && -n "$branch_format" ]]; then
zformat -f branch_formatted "$branch_format" "b:$branch"
fi
# Format position.
zstyle -s ':prezto:module:git:info:position' format 'position_format'
if [[ -z "$branch" && -n "$position_format" ]]; then
position="$(git describe --contains --all HEAD 2> /dev/null)"
if [[ -n "$position" ]]; then
zformat -f position_formatted "$position_format" "p:$position"
fi
fi
# Format remote.
zstyle -s ':prezto:module:git:info:remote' format 'remote_format'
if [[ -n "$branch" && -n "$remote_format" ]]; then
# Gets the remote name.
remote_cmd='git rev-parse --symbolic-full-name --verify HEAD@{upstream}'
remote="${$(${(z)remote_cmd} 2> /dev/null)##refs/remotes/}"
if [[ -n "$remote" ]]; then
zformat -f remote_formatted "$remote_format" "R:$remote"
fi
fi
zstyle -s ':prezto:module:git:info:ahead' format 'ahead_format'
zstyle -s ':prezto:module:git:info:behind' format 'behind_format'
if [[ -n "$branch" && ( -n "$ahead_format" || -n "$behind_format" ) ]]; then
# Gets the commit difference counts between local and remote.
ahead_and_behind_cmd='git rev-list --count --left-right HEAD...@{upstream}'
# Get ahead and behind counts.
ahead_and_behind="$(${(z)ahead_and_behind_cmd} 2> /dev/null)"
# Format ahead.
if [[ -n "$ahead_format" ]]; then
ahead="$ahead_and_behind[(w)1]"
if (( ahead > 0 )); then
zformat -f ahead_formatted "$ahead_format" "A:$ahead"
fi
# Ignore submodule status.
zstyle -s ':prezto:module:git:status:ignore' submodules 'ignore_submodules'
if [[ -n "$ignore_submodules" ]]; then
status_cmd+=" --ignore-submodules=${ignore_submodules}"
fi
# Format behind.
if [[ -n "$behind_format" ]]; then
behind="$ahead_and_behind[(w)2]"
if (( behind > 0 )); then
zformat -f behind_formatted "$behind_format" "B:$behind"
fi
fi
# Format commit.
commit="$(git rev-parse HEAD 2> /dev/null)"
if [[ -n "$commit" ]]; then
zstyle -s ':prezto:module:git:info:commit' format 'commit_format'
zformat -f commit_formatted "$commit_format" "c:$commit"
fi
# Get status type.
if ! zstyle -t ':prezto:module:git:info' verbose; then
# Format indexed.
zstyle -s ':prezto:module:git:info:indexed' format 'indexed_format'
if [[ -n "$indexed_format" ]]; then
((
indexed+=$(
git diff-index \
--no-ext-diff \
--name-only \
--cached \
--ignore-submodules=${ignore_submodules:-none} \
HEAD \
2> /dev/null \
| wc -l
)
))
if (( indexed > 0 )); then
zformat -f indexed_formatted "$indexed_format" "i:$indexed"
fi
# Format stashed.
if [[ -f "$(git-dir)/refs/stash" ]]; then
stashed="$(git stash list 2> /dev/null | wc -l | awk '{print $1}')"
zstyle -s ':prezto:module:git:info:stashed' format 'stashed_format'
zformat -f stashed_formatted "$stashed_format" "S:$stashed"
fi
# Format unindexed.
zstyle -s ':prezto:module:git:info:unindexed' format 'unindexed_format'
if [[ -n "$unindexed_format" ]]; then
((
unindexed+=$(
git diff-files \
--no-ext-diff \
--name-only \
--ignore-submodules=${ignore_submodules:-none} \
2> /dev/null \
| wc -l
)
))
if (( unindexed > 0 )); then
zformat -f unindexed_formatted "$unindexed_format" "I:$unindexed"
# Format action.
action="$(_git-action)"
if [[ -n "$action" ]]; then
zstyle -s ':prezto:module:git:info:action' format 'action_format'
zformat -f action_formatted "$action_format" "s:$action"
fi
fi
# Format untracked.
zstyle -s ':prezto:module:git:info:untracked' format 'untracked_format'
if [[ -n "$untracked_format" ]]; then
((
untracked+=$(
git ls-files \
--other \
--exclude-standard \
2> /dev/null \
| wc -l
)
))
if (( untracked > 0 )); then
zformat -f untracked_formatted "$untracked_format" "u:$untracked"
fi
fi
(( dirty = indexed + unindexed + untracked ))
else
# Use porcelain status for easy parsing.
status_cmd="git status --porcelain --ignore-submodules=${ignore_submodules:-none}"
# Get current status.
while IFS=$'\n' read line; do
@ -345,45 +256,82 @@ function git-info {
(( dirty++ ))
done < <(${(z)status_cmd} 2> /dev/null)
# Format branch.
branch="${$(git symbolic-ref -q HEAD)##refs/heads/}"
if [[ -n "$branch" ]]; then
zstyle -s ':prezto:module:git:info:branch' format 'branch_format'
zformat -f branch_formatted "$branch_format" "b:$branch"
# Format remote.
remote="${$(${(z)remote_cmd} 2> /dev/null)##refs/remotes/}"
if [[ -n "$remote" ]]; then
zstyle -s ':prezto:module:git:info:remote' format 'remote_format'
zformat -f remote_formatted "$remote_format" "R:$remote"
# Get ahead and behind counts.
ahead_and_behind="$(${(z)ahead_and_behind_cmd} 2> /dev/null)"
# Format ahead.
ahead="$ahead_and_behind[(w)1]"
if (( $ahead > 0 )); then
zstyle -s ':prezto:module:git:info:ahead' format 'ahead_format'
zformat -f ahead_formatted "$ahead_format" "A:$ahead"
fi
# Format behind.
behind="$ahead_and_behind[(w)2]"
if (( $behind > 0 )); then
zstyle -s ':prezto:module:git:info:behind' format 'behind_format'
zformat -f behind_formatted "$behind_format" "B:$behind"
fi
fi
else
# Format position.
position="$(git describe --contains --all HEAD 2> /dev/null)"
if [[ -n "$position" ]]; then
zstyle -s ':prezto:module:git:info:position' format 'position_format'
zformat -f position_formatted "$position_format" "p:$position"
fi
fi
# Format added.
if (( added > 0 )); then
if (( $added > 0 )); then
zstyle -s ':prezto:module:git:info:added' format 'added_format'
zformat -f added_formatted "$added_format" "a:$added_format"
fi
# Format deleted.
if (( deleted > 0 )); then
if (( $deleted > 0 )); then
zstyle -s ':prezto:module:git:info:deleted' format 'deleted_format'
zformat -f deleted_formatted "$deleted_format" "d:$deleted_format"
fi
# Format modified.
if (( modified > 0 )); then
if (( $modified > 0 )); then
zstyle -s ':prezto:module:git:info:modified' format 'modified_format'
zformat -f modified_formatted "$modified_format" "m:$modified"
fi
# Format renamed.
if (( renamed > 0 )); then
if (( $renamed > 0 )); then
zstyle -s ':prezto:module:git:info:renamed' format 'renamed_format'
zformat -f renamed_formatted "$renamed_format" "r:$renamed"
fi
# Format unmerged.
if (( unmerged > 0 )); then
if (( $unmerged > 0 )); then
zstyle -s ':prezto:module:git:info:unmerged' format 'unmerged_format'
zformat -f unmerged_formatted "$unmerged_format" "U:$unmerged"
fi
# Format untracked.
if (( untracked > 0 )); then
if (( $untracked > 0 )); then
zstyle -s ':prezto:module:git:info:untracked' format 'untracked_format'
zformat -f untracked_formatted "$untracked_format" "u:$untracked"
fi
fi
# Format dirty and clean.
if (( dirty > 0 )); then
if (( $dirty > 0 )); then
zstyle -s ':prezto:module:git:info:dirty' format 'dirty_format'
zformat -f dirty_formatted "$dirty_format" "D:$dirty"
else
@ -394,28 +342,27 @@ function git-info {
zstyle -a ':prezto:module:git:info:keys' format 'info_formats'
for info_format in ${(k)info_formats}; do
zformat -f REPLY "$info_formats[$info_format]" \
"a:$added_formatted" \
"A:$ahead_formatted" \
"B:$behind_formatted" \
"D:$dirty_formatted" \
"R:$remote_formatted" \
"S:$stashed_formatted" \
"U:$unmerged_formatted" \
"a:$added_formatted" \
"b:$branch_formatted" \
"C:$clean_formatted" \
"c:$commit_formatted" \
"d:$deleted_formatted" \
"D:$dirty_formatted" \
"i:$indexed_formatted" \
"I:$unindexed_formatted" \
"m:$modified_formatted" \
"p:$position_formatted" \
"R:$remote_formatted" \
"r:$renamed_formatted" \
"s:$action_formatted" \
"S:$stashed_formatted" \
"U:$unmerged_formatted" \
"u:$untracked_formatted"
git_info[$info_format]="$REPLY"
done
unset REPLY
unset _git_info_executing
return 0
}

View File

@ -7,8 +7,8 @@ Installing GNU utilities on non-GNU systems in `$PATH` without a prefix, i.e.
`ls` instead of `gls`, is not recommended since scripts that target other
utilities will be broken.
This module wraps GNU utilities in functions without a prefix for interactive
use.
However, for interactive use, prefixed commands can be wrapped in their
non-prefixed counterparts.
This module must be loaded **before** the *utility* module.

View File

@ -0,0 +1,25 @@
GPG-Agent
=========
Provides for an easier use of [gpg-agent][1].
Settings
--------
### SSH-Agent Protocol Emulation
To enable SSH-Agent protocol emulation, add the following line to *zpreztorc*:
zstyle ':prezto:module:gpg-agent' ssh-support 'yes'
Authors
-------
*The authors of this module should be contacted via the [issue tracker][2].*
- [Florian Walch](https://github.com/fwalch)
- [Sorin Ionescu](https://github.com/sorin-ionescu)
[1]: http://linux.die.net/man/1/gpg-agent
[2]: https://github.com/sorin-ionescu/prezto/issues

View File

@ -0,0 +1,44 @@
#
# Provides for an easier use of gpg-agent.
#
# Authors:
# Florian Walch <florian.walch@gmx.at>
# Sorin Ionescu <sorin.ionescu@gmail.com>
#
# Return if requirements are not found.
if (( ! $+commands[gpg-agent] )); then
return 1
fi
_gpg_env="$HOME/.gnupg/gpg-agent.env"
function _gpg-agent-start {
local ssh_support
zstyle -b ':prezto:module:gpg-agent' ssh-support 'ssh_support' \
|| ssh_support=''
gpg-agent \
--daemon ${ssh_support:+'--enable-ssh-support'}
--write-env-file "${_gpg_env}" > /dev/null
chmod 600 "${_gpg_env}"
source "${_gpg_env}" > /dev/null
}
# Source GPG agent settings, if applicable.
if [[ -s "${_gpg_env}" ]]; then
source "${_gpg_env}" > /dev/null
ps -ef | grep "${SSH_AGENT_PID}" | grep -q 'gpg-agent' || {
_gpg-agent-start
}
else
_gpg-agent-start
fi
export GPG_AGENT_INFO
export SSH_AUTH_SOCK
export SSH_AGENT_PID
export GPG_TTY="$(tty)"

View File

@ -1,44 +0,0 @@
#
# Provides for an easier use of GPG by setting up gpg-agent.
#
# Authors:
# Sorin Ionescu <sorin.ionescu@gmail.com>
#
# Return if requirements are not found.
if (( ! $+commands[gpg-agent] )); then
return 1
fi
# Set the default paths to gpg-agent files.
_gpg_agent_conf="$HOME/.gnupg/gpg-agent.conf"
_gpg_agent_env="$TMPDIR/gpg-agent.env"
# Start gpg-agent if not started.
if ! ps -U "$USER" -o ucomm | grep -q gpg-agent; then
eval "$(gpg-agent --daemon | tee "$_gpg_agent_env")"
else
# Export environment variables.
source "$_gpg_agent_env" 2> /dev/null
fi
# Inform gpg-agent of the current TTY for user prompts.
export GPG_TTY="$(tty)"
# Integrate with the SSH module.
if grep 'enable-ssh-support' "$_gpg_agent_conf" &> /dev/null; then
# Override the ssh-agent environment file default path.
_ssh_agent_env="$_gpg_agent_env"
# Load the SSH module for additional processing.
pmodload 'ssh'
fi
# Clean up.
unset _gpg_agent_{conf,env}
# Disable GUI prompts inside SSH.
if [[ -n "$SSH_CONNECTION" ]]; then
export PINENTRY_USER_DATA='USE_CURSES=1'
fi

View File

@ -10,9 +10,12 @@ if (( ! $+commands[ghc] )); then
return 1
fi
# Prepend Cabal per user directories to PATH.
if [[ "$OSTYPE" == darwin* && -d $HOME/Library/Haskell ]]; then
# Prepend Cabal per user directories to PATH/MANPATH.
if [[ "$OSTYPE" == darwin* ]]; then
path=($HOME/Library/Haskell/bin(/N) $path)
manpath=($HOME/Library/Haskell/man(/N) $manpath)
else
path=($HOME/.cabal/bin(/N) $path)
manpath=($HOME/.cabal/man(/N) $manpath)
fi

View File

@ -13,6 +13,7 @@ Functions
- `is-callable` checks if a name is a command, function, or alias.
- `is-true` checks a boolean variable for "true".
- `coalesce` prints the first non-empty string in the arguments array.
- `zstyle-` defines a style if it is already not defined.
Authors
-------

View File

@ -6,6 +6,14 @@
# Sorin Ionescu <sorin.ionescu@gmail.com>
#
# Trap signals were generated with 'kill -l'.
# DEBUG, EXIT, and ZERR are Zsh signals.
_trap_signals=(
ABRT ALRM BUS CHLD CONT EMT FPE HUP ILL INFO INT IO KILL PIPE PROF QUIT
SEGV STOP SYS TERM TRAP TSTP TTIN TTOU URG USR1 USR2 VTALRM WINCH XCPU XFSZ
DEBUG EXIT ZERR
)
# Adds a function name to a list to be called when a trap is triggered.
function add-zsh-trap {
if (( $# < 2 )); then
@ -13,7 +21,7 @@ function add-zsh-trap {
return 1
fi
if [[ -z "$signals[(r)$1]" ]]; then
if [[ -z "$_trap_signals[(r)$1]" ]]; then
print "$0: unknown signal: $1" >&2
return 1
fi

View File

@ -30,3 +30,7 @@ function coalesce {
return 1
}
# Defines a style if it is already not defined.
function zstyle- {
zstyle -T "$1" "$2" && zstyle "$@"
}

View File

@ -36,18 +36,6 @@ To enable highlighting for this module only, add the following line to
zstyle ':prezto:module:history-substring-search' color 'yes'
To set the query found color, add the following line to *zpreztorc*:
zstyle ':prezto:module:history-substring-search:color' found ''
To set the query not found color, add the following line to *zpreztorc*:
zstyle ':prezto:module:history-substring-search:color' not-found ''
To set the search globbing flags, add the following line to *zpreztorc*:
zstyle ':prezto:module:history-substring-search' globbing-flags ''
Authors
-------

View File

@ -10,26 +10,14 @@
pmodload 'editor'
# Source module files.
source "${0:h}/external/zsh-history-substring-search.zsh" || return 1
source "${0:h}/external/zsh-history-substring-search.zsh"
#
# Search
# Styles
#
zstyle -s ':prezto:module:history-substring-search:color' found \
'HISTORY_SUBSTRING_SEARCH_HIGHLIGHT_FOUND' \
|| HISTORY_SUBSTRING_SEARCH_HIGHLIGHT_FOUND='bg=magenta,fg=white,bold'
zstyle -s ':prezto:module:history-substring-search:color' not-found \
'HISTORY_SUBSTRING_SEARCH_HIGHLIGHT_NOT_FOUND' \
|| HISTORY_SUBSTRING_SEARCH_HIGHLIGHT_NOT_FOUND='bg=red,fg=white,bold'
zstyle -s ':prezto:module:history-substring-search' globbing-flags \
'HISTORY_SUBSTRING_SEARCH_GLOBBING_FLAGS' \
|| HISTORY_SUBSTRING_SEARCH_GLOBBING_FLAGS='i'
if zstyle -t ':prezto:module:history-substring-search' case-sensitive; then
HISTORY_SUBSTRING_SEARCH_GLOBBING_FLAGS="${HISTORY_SUBSTRING_SEARCH_GLOBBING_FLAGS//i}"
unset HISTORY_SUBSTRING_SEARCH_GLOBBING_FLAGS
fi
if ! zstyle -t ':prezto:module:history-substring-search' color; then
@ -40,7 +28,7 @@ fi
# Key Bindings
#
if [[ -n "$key_info" ]]; then
if [[ -n $key_info ]]; then
# Emacs
bindkey -M emacs "$key_info[Control]P" history-substring-search-up
bindkey -M emacs "$key_info[Control]N" history-substring-search-down

View File

@ -1,25 +0,0 @@
#
# Defines Homebrew aliases.
#
# Authors:
# Sorin Ionescu <sorin.ionescu@gmail.com>
#
# Return if requirements are not found.
if [[ "$OSTYPE" != darwin* ]]; then
return 1
fi
#
# Aliases
#
alias brewc='brew cleanup'
alias brewC='brew cleanup --force'
alias brewi='brew install'
alias brewl='brew list'
alias brews='brew search'
alias brewu='brew upgrade'
alias brewU='brew update && brew upgrade'
alias brewx='brew remove'

View File

@ -15,6 +15,18 @@ fi
# Paths
#
# Set the list of directories that info searches for manuals.
infopath=(
/opt/local/share/info
$infopath
)
# Set the list of directories that man searches for manuals.
manpath=(
/opt/local/share/man
$manpath
)
# Set the list of directories that Zsh searches for programs.
path=(
/opt/local/{bin,sbin}

23
modules/node/README.md Normal file
View File

@ -0,0 +1,23 @@
Node.js
=======
Provides utility functions for [Node.js][1] and loads [npm][2] completion.
Functions
---------
- `node-doc` opens the Node.js online [API documentation][3] in the default
browser.
Authors
-------
*The authors of this module should be contacted via the [issue tracker][4].*
- [Sorin Ionescu](https://github.com/sorin-ionescu)
[1]: http://nodejs.org
[2]: http://npmjs.org
[3]: http://nodejs.org/api
[4]: https://github.com/sorin-ionescu/prezto/issues

View File

@ -1,25 +0,0 @@
#
# Exposes information about the Node.js environment via the $node_info
# associative array.
#
# Authors:
# Zeh Rizzatti <zehrizzatti@gmail.com>
#
local version
local version_format
local version_formatted
unset node_info
typeset -gA node_info
if (( $+functions[nvm_version] )); then
version="${$(nvm_version)#v}"
fi
if [[ -n "$version" ]]; then
zstyle -s ':prezto:module:node:info:version' format 'version_format'
zformat -f version_formatted "$version_format" "v:$version"
node_info[version]="$version_formatted"
fi

View File

@ -1,16 +1,10 @@
#
# Loads the Node Version Manager and enables npm completion.
# Completes npm.
#
# Authors:
# Sorin Ionescu <sorin.ionescu@gmail.com>
# Zeh Rizzatti <zehrizzatti@gmail.com>
#
# Load NVM into the shell session.
if [[ -s "$HOME/.nvm/nvm.sh" ]]; then
source "$HOME/.nvm/nvm.sh"
fi
# Return if requirements are not found.
if (( ! $+commands[node] )); then
return 1

View File

@ -1,28 +0,0 @@
Ocaml
=====
Initializes [Ocaml][1] package management.
OPAM
----
[OPAM][2] is a package manager for Ocaml.
This module enables local package installation with OPAM by extending the
relevant path and Ocaml variables.
### Usage
Install packages to your local package directory with `opam install`.
Authors
-------
*The authors of this module should be contacted via the [issue tracker][3].*
- [Sebastian Wiesner](https://github.com/lunaryorn)
[1]: http://ocaml.org/
[2]: http://opam.ocamlpro.com/
[3]: https://github.com/sorin-ionescu/prezto/issues

View File

@ -1,15 +0,0 @@
#
# Initializes Ocaml package management.
#
# Authors:
# Sebastian Wiesner <lunaryorn@gmail.com>
#
# Return if requirements are not found.
if (( ! $+commands[opam] )); then
return 1
fi
# Initialize OPAM.
eval "$(opam config env)"

View File

@ -20,6 +20,7 @@ Functions
- `pfd` prints the current _Finder_ directory.
- `pfs` prints the current _Finder_ selection.
- `tab` creates a new tab (works in both _Terminal_ and [_iTerm_][3]).
- `trash` moves files and folders to _Trash_.
Authors
-------

View File

@ -0,0 +1,27 @@
#
# Moves directories and files to Trash.
#
# Authors:
# Sorin Ionescu <sorin.ionescu@gmail.com>
#
print -N "${@:a}" | xargs -0 osascript -e '
on run theFilePaths
tell application "Finder"
set thePOSIXFiles to {}
repeat with aFilePath in theFilePaths
set aPOSIXFile to aFilePath as POSIX file
if exists aPOSIXFile
set end of thePOSIXFiles to aPOSIXFile
end if
end repeat
move every item of thePOSIXFiles to trash
end tell
end run
' &>/dev/null
if (( $? != 0)); then
print "$0: failed to move one or more items" >&2
return 1
fi

View File

@ -6,7 +6,7 @@
# Sorin Ionescu <sorin.ionescu@gmail.com>
#
local tmp="$TMPDIR/pacman-disowned-$UID-$$"
local tmp="${TMPDIR:-/tmp}/pacman-disowned-$UID-$$"
local db="$tmp/db"
local fs="$tmp/fs"

View File

@ -55,10 +55,10 @@ alias pacq='pacman --sync --info'
alias pacQ='pacman --query --info'
# Searches for packages in the repositories.
alias pacs='pacman --sync --search'
alias pacs='pacman --sync --recursive'
# Searches for packages in the local database.
alias pacS='pacman --query --search'
alias pacS='pacman --query --recursive'
# Lists orphan packages.
alias pacman-list-orphans='sudo pacman --query --deps --unrequired'

View File

@ -20,6 +20,8 @@ if [[ "$OSTYPE" == darwin* ]]; then
perl_path="$HOME/Library/Perl/5.12"
if [[ -f "$perl_path/lib/perl5/local/lib.pm" ]]; then
manpath=("$perl_path/man" $manpath)
if [[ ! -s "$cache_file" ]]; then
perl -I$perl_path/lib/perl5 -Mlocal::lib=$perl_path >! "$cache_file"
fi
@ -29,6 +31,12 @@ if [[ "$OSTYPE" == darwin* ]]; then
unset perl_path
unset cache_file
# Set environment variables for launchd processes.
for env_var in PERL_LOCAL_LIB_ROOT PERL_MB_OPT PERL_MM_OPT PERL5LIB; do
launchctl setenv "$env_var" "${(P)env_var}" &!
done
unset env_var
fi
#

View File

@ -34,7 +34,7 @@ including a function that displays help or a function used to preview it.
**Do not call this function directly.**
The most basic example of this function can be seen below.
The most basic example of this function can be seen bellow.
function prompt_name_setup {
PROMPT='%m%# '

View File

@ -0,0 +1,223 @@
#
# A two line customizable theme (colored in blue and white by default).
#
# Author:
# shura <shura1991@gmail.com>
#
# Features:
# - Two lines.
# - VCS integration.
# - Customizable.
#
# Settings (:prezto:module:prompt:theme:borra):
# - plugins: list of plugins (array)
# - prefix: right-side of plugin wrapper (string)
# - separator: plugin separator (string)
# - suffix: left-side of plugin wrapper (string)
# - top: beginning of first line (string)
# - bottom: beginning of second line (string)
# - prompt: right-side of second line (string)
# - rprompt: right prompt enable or disable (bool)
#
# Plugins settings (:prezto:module:prompt:theme:borra:plugin:$plugin):
# Version Control Systems:
# - enable: vcs enable backends (array)
# - format: vcs backends format (string):
# * %b: backend name (to write a bold-end, escape it using %%b)
# * %i: formatted text according to zstyle ':vcs_info:*' formats (or actionformats)
# User and Host:
# - format: username and hostname format (string):
# * %u: username
# * %h: hostname
# Example:
# zstyle ':prezto:module:prompt:theme:borra' separator ' '
#
# Screenshots:
# http://i.imgur.com/rEgWv.png
# http://ascii.io/a/1310
#
function +borra-pts {
print -n '/dev/%y'
}
function +borra-rvm-info {
if (( ! $+functions[rvm] )); then
return 1
fi
local rb="$(rvm-prompt s)"
if [[ -z "${rb}" ]]; then
print "$(rvm-prompt i v p r)" || print "${rb}"
fi
}
function +borra-userhost {
local format
local res
zstyle -s ':prezto:module:prompt:theme:borra:plugin:userhost' format 'format'
zformat -f res "$format" u:'%(!.%SROOT%s.%n)' h:'%m'
print -n "$res"
}
function +borra-vcs-info {
local res=""
local sep="$1"
local backend
local enabled
local format
local s
vcs_info # need VCS_INFO_backends
zstyle -a ':prezto:module:prompt:theme:borra:plugin:vcs' enable 'enabled'
zstyle -s ':prezto:module:prompt:theme:borra:plugin:vcs' format 'format'
for backend in ${VCS_INFO_backends[@]}; do
if (( $+enabled[$backend] )); then
continue
fi
zstyle ':vcs_info:*' enable "$backend"
vcs_info || continue
if [[ -z "${vcs_info_msg_0_}" ]]; then
continue
fi
zformat -f s "$format" "b:$backend" "i:$vcs_info_msg_0_"
res+="$(prompt_borra_wrap_plugin "$s" "$sep")"
if [[ -z "$sep" && ! -z "$res" ]]; then
zstyle -s ':prezto:module:prompt:theme:borra' separator 'sep'
fi
done
print -n -- "$res"
return 23
}
function +vi-git-status-untracked {
if [[ -n $(git ls-files --other --exclude-standard 2> /dev/null) ]]; then
hook_com[unstaged]=' %F{red}⚑%f'
fi
}
function prompt_borra_set_zstyle_if_not_set {
zstyle -T "$1" "$2" && zstyle "$@"
}
function prompt_borra_wrap_plugin {
local prefix
local suffix
zstyle -s ':prezto:module:prompt:theme:borra' prefix 'prefix'
zstyle -s ':prezto:module:prompt:theme:borra' suffix 'suffix'
print -n -- "${2}${prefix}${1}${suffix}"
}
function prompt_borra_render_item {
local res
res="$($1 "$2" 2>/dev/null)"
case "$?" in
(0)
prompt_borra_wrap_plugin "$res" "$2"
;;
(23)
print -n "$res"
;;
(*)
return 1
;;
esac
}
function prompt_borra_render_plugins {
local res=""
local plugin
local -a plugins
local sep
zstyle -a ':prezto:module:prompt:theme:borra' plugins 'plugins'
for plugin in "$plugins[@]"; do
res+="$(prompt_borra_render_item "+borra-$plugin" "$sep")"
if [[ -z "$sep" && ! -z "$res" ]]; then
zstyle -s ':prezto:module:prompt:theme:borra' separator 'sep'
fi
done
print -n "$res"
}
function prompt_borra_create_prompt {
local plugins="$(prompt_borra_render_plugins)"
local res=""
local top
local bottom
local prompt
if [[ ! -z "$plugins" ]]; then
zstyle -s ':prezto:module:prompt:theme:borra' top 'top'
zstyle -s ':prezto:module:prompt:theme:borra' bottom 'bottom'
res="
${top}${plugins}
${bottom}"
fi
zstyle -s ':prezto:module:prompt:theme:borra' prompt 'prompt'
print -n "${res}${prompt}"
}
function prompt_borra_precmd {
local rprompt
PROMPT="$(prompt_borra_create_prompt)"
zstyle -b ':prezto:module:prompt:theme:borra' rprompt 'rprompt'
if [[ "$rprompt" = yes ]]; then
RPROMPT='%(?..%F{red}%? ↵%f)'
else
RPROMPT=''
fi
}
function prompt_borra_setup {
setopt LOCAL_OPTIONS
unsetopt XTRACE KSH_ARRAYS
prompt_opts=(cr percent subst)
# Load required functions.
autoload -Uz add-zsh-hook
autoload -Uz vcs_info
# Add hook for calling git-info before each command.
add-zsh-hook precmd prompt_borra_precmd
# Call vcs_info to populate $VCS_INFO_backends.
vcs_info
prompt_borra_set_zstyle_if_not_set ':prezto:module:prompt:theme:borra' plugins 'userhost' 'pts' 'rvm-info' 'vcs-info'
prompt_borra_set_zstyle_if_not_set ':prezto:module:prompt:theme:borra' prefix '%F{blue}(%f'
prompt_borra_set_zstyle_if_not_set ':prezto:module:prompt:theme:borra' separator '%F{blue}-%f'
prompt_borra_set_zstyle_if_not_set ':prezto:module:prompt:theme:borra' suffix '%F{blue}%)%f'
prompt_borra_set_zstyle_if_not_set ':prezto:module:prompt:theme:borra' top '%F{blue}╭-%f'
prompt_borra_set_zstyle_if_not_set ':prezto:module:prompt:theme:borra' bottom '%F{blue}╰─%f'
prompt_borra_set_zstyle_if_not_set ':prezto:module:prompt:theme:borra' prompt '%F{blue}(%f%B%$((COLUMNS / 2))<...<%~%<<%b%F{blue})%F{yellow}>%f '
prompt_borra_set_zstyle_if_not_set ':prezto:module:prompt:theme:borra' rprompt 'yes'
prompt_borra_set_zstyle_if_not_set ':prezto:module:prompt:theme:borra:plugin:vcs' enable "$VCS_INFO_backends[@]"
prompt_borra_set_zstyle_if_not_set ':prezto:module:prompt:theme:borra:plugin:vcs' format '%b: %i'
prompt_borra_set_zstyle_if_not_set ':prezto:module:prompt:theme:borra:plugin:userhost' format '%u%F{blue}@%f%h'
# Set vcs_info parameters.
zstyle ':vcs_info:*' check-for-changes 'true'
zstyle ':vcs_info:*' unstagedstr ' %F{yellow}⚑%f'
zstyle ':vcs_info:*' stagedstr ' %F{green}⚑%f'
zstyle ':vcs_info:*' actionformats '%b%u%c [%a]'
zstyle ':vcs_info:*' formats '%b%u%c'
zstyle ':vcs_info:*+set-message:*' hooks 'git-status-untracked'
}
prompt_borra_setup "$@"

View File

@ -46,14 +46,10 @@ function prompt_sorin_setup {
# Add hook for calling git-info before each command.
add-zsh-hook precmd prompt_sorin_precmd
# Set editor-info parameters.
zstyle ':prezto:module:editor:info:completing' format '%B%F{red}...%f%b'
zstyle ':prezto:module:editor:info:keymap:primary' format ' %B%F{red}%F{yellow}%F{green}%f%b'
zstyle ':prezto:module:editor:info:keymap:primary:overwrite' format ' %F{red}♺%f'
zstyle ':prezto:module:editor:info:keymap:alternate' format ' %B%F{green}%F{yellow}%F{red}%f%b'
# Set git-info parameters.
zstyle ':prezto:module:git:info' verbose 'yes'
zstyle ':prezto:module:git:info:action' format ':%%B%F{yellow}%s%f%%b'
zstyle ':prezto:module:git:info:added' format ' %%B%F{green}✚%f%%b'
zstyle ':prezto:module:git:info:ahead' format ' %%B%F{yellow}⬆%f%%b'
@ -62,7 +58,7 @@ function prompt_sorin_setup {
zstyle ':prezto:module:git:info:commit' format ':%F{green}%.7c%f'
zstyle ':prezto:module:git:info:deleted' format ' %%B%F{red}✖%f%%b'
zstyle ':prezto:module:git:info:modified' format ' %%B%F{blue}✱%f%%b'
zstyle ':prezto:module:git:info:position' format ':%F{red}%p%f'
zstyle ':prezto:module:git:info:position' format ':%F{green}%p%f'
zstyle ':prezto:module:git:info:renamed' format ' %%B%F{magenta}➜%f%%b'
zstyle ':prezto:module:git:info:stashed' format ' %%B%F{cyan}✭%f%%b'
zstyle ':prezto:module:git:info:unmerged' format ' %%B%F{yellow}═%f%%b'

View File

@ -6,15 +6,15 @@ Enables local Python and local Python package installation.
Local Python Installation
-------------------------
[pyenv][4] builds and installs multiple Python versions locally in the home
[pythonz][4] builds and installs multiple Python versions locally in the home
directory.
This module prepends the pyenv directory to the path variable to enable the
execution of `pyenv`.
This module prepends the pythonz directory to the path variable to enable the
execution of `pythonz`.
### Usage
Install Python versions with `pyenv install` into *~/.pyenv/versions*.
Install Python versions with `pythonz install` into *~/.pythonz/pythons*.
Local Package Installation
--------------------------
@ -66,6 +66,16 @@ Aliases
- `py` is short for `python`.
### Pythonz
- `pyz` is short for `pythonz`.
- `pyzc` removes stale source folders and archives.
- `pyzi` installs Python versions.
- `pyzl` lists installed Python versions.
- `pyzL` lists available Python versions.
- `pyzu` updates itself to the latest version.
- `pyzx` uninstalls Python versions.
Functions
---------
@ -95,6 +105,6 @@ Authors
[1]: http://www.python.org/dev/peps/pep-0370/
[2]: http://www.doughellmann.com/projects/virtualenvwrapper/
[3]: http://pypi.python.org/pypi/virtualenv
[4]: https://github.com/yyuu/pyenv
[4]: http://saghul.github.com/pythonz/
[5]: https://github.com/sorin-ionescu/prezto/issues

View File

@ -6,35 +6,31 @@
# Sebastian Wiesner <lunaryorn@googlemail.com>
#
# Load manually installed pyenv into the shell session.
if [[ -s "$HOME/.pyenv/bin/pyenv" ]]; then
path=("$HOME/.pyenv/bin" $path)
eval "$(pyenv init -)"
# Load package manager installed pyenv into the shell session.
elif (( $+commands[pyenv] )); then
eval "$(pyenv init -)"
# Prepend PEP 370 per user site packages directory, which defaults to
# ~/Library/Python on Mac OS X and ~/.local elsewhere, to PATH.
else
if [[ "$OSTYPE" == darwin* ]]; then
path=($HOME/Library/Python/*/bin(N) $path)
else
# This is subject to change.
path=($HOME/.local/bin $path)
fi
# Load pythonz into the shell session.
if [[ -s $HOME/.pythonz/bin/pythonz ]]; then
path=($HOME/.pythonz/bin $path)
fi
# Return if requirements are not found.
if (( ! $+commands[python] && ! $+commands[pyenv] )); then
if (( ! $+commands[python] && ! $+commands[pythonz] )); then
return 1
fi
# Prepend PEP 370 per user site packages directory, which defaults to
# ~/Library/Python on Mac OS X and ~/.local elsewhere, to PATH/MANPATH.
if [[ "$OSTYPE" == darwin* ]]; then
path=($HOME/Library/Python/*/bin(N) $path)
manpath=($HOME/Library/Python/*/{,share/}man(N) $manpath)
else
# This is subject to change.
path=($HOME/.local/bin $path)
manpath=($HOME/.local/{,share/}man(N) $manpath)
fi
# Load virtualenvwrapper into the shell session.
if (( $+commands[virtualenvwrapper_lazy.sh] )); then
# Set the directory where virtual environments are stored.
export WORKON_HOME="$HOME/.virtualenvs"
export WORKON_HOME=$HOME/.virtualenvs
# Disable the virtualenv prompt.
VIRTUAL_ENV_DISABLE_PROMPT=1
@ -48,3 +44,14 @@ fi
alias py='python'
# pythonz
if (( $+commands[pythonz] )); then
alias pyz='pythonz'
alias pyzc='pythonz cleanup'
alias pyzi='pythonz install'
alias pyzl='pythonz list'
alias pyzL='pythonz list -a'
alias pyzu='pythonz update'
alias pyzx='pythonz uninstall'
fi

View File

@ -7,30 +7,39 @@
# Sorin Ionescu <sorin.ionescu@gmail.com>
#
# Load dependencies.
pmodload 'ruby'
# Return if requirements are not found.
if (( ! $+commands[bundle] )); then
if (( ! $+commands[rails] )); then
return 1
fi
#
# Aliases
# Aliases (Compatible with Rails 2)
#
alias ror='bundle exec rails'
alias rorc='bundle exec rails console'
alias rordc='bundle exec rails dbconsole'
alias rordm='bundle exec rake db:migrate'
alias rordM='bundle exec rake db:migrate db:test:clone'
alias rordr='bundle exec rake db:rollback'
alias rorg='bundle exec rails generate'
alias rorl='tail -f "$(ruby-app-root)/log/development.log"'
alias rorlc='bundle exec rake log:clear'
alias rorp='bundle exec rails plugin'
alias rorr='bundle exec rails runner'
alias rors='bundle exec rails server'
alias rorsd='bundle exec rails server --debugger'
alias rorx='bundle exec rails destroy'
alias ror='rails'
alias rorc='_rails-command console'
alias rordc='_rails-command dbconsole'
alias rordm='rake db:migrate'
alias rordM='rake db:migrate db:test:clone'
alias rordr='rake db:rollback'
alias rorg='_rails-command generate'
alias rorl='tail -f log/development.log'
alias rorlc='rake log:clear'
alias rorp='_rails-command plugin'
alias rorr='_rails-command runner'
alias rors='_rails-command server'
alias rorsd='_rails-command server --debugger'
alias rorx='_rails-command destroy'
#
# Functions
#
function _rails-command {
if [[ -e "script/server" ]]; then
ruby script/"$@"
else
ruby script/rails "$@"
fi
}

Some files were not shown because too many files have changed in this diff Show More