mirror of
https://github.com/dcarrillo/prezto.git
synced 2025-07-01 23:19:25 +00:00
Move README files to documentation/markdown
This commit is contained in:
@ -1,195 +0,0 @@
|
||||
Modules
|
||||
=======
|
||||
|
||||
Load modules in *zpreztorc*. The order matters.
|
||||
|
||||
zstyle ':prezto:load' pmodule 'environment' 'terminal'
|
||||
|
||||
Archive
|
||||
-------
|
||||
|
||||
Provides functions to list and extract archives.
|
||||
|
||||
Command-Not-Found
|
||||
-----------------
|
||||
|
||||
Loads the command-not-found tool on Debian-based distributions.
|
||||
|
||||
Completion
|
||||
----------
|
||||
|
||||
Loads and configures tab completion and provides additional completions from
|
||||
the zsh-completions project.
|
||||
|
||||
Directory
|
||||
---------
|
||||
|
||||
Sets directory options and defines directory aliases.
|
||||
|
||||
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
|
||||
---
|
||||
|
||||
Provides for an easier use of GPG by setting up gpg-agent.
|
||||
|
||||
Haskell
|
||||
-------
|
||||
|
||||
Enables local Haskell package installation.
|
||||
|
||||
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
|
||||
--------
|
||||
|
||||
Defines Homebrew aliases.
|
||||
|
||||
Macports
|
||||
--------
|
||||
|
||||
Defines MacPorts aliases and adds MacPorts directories to path variables.
|
||||
|
||||
Node.js
|
||||
-------
|
||||
|
||||
Provides utility functions for Node.js and loads npm completion.
|
||||
|
||||
Ocaml
|
||||
-----
|
||||
|
||||
Initializes Ocaml package management.
|
||||
|
||||
OSX
|
||||
---
|
||||
|
||||
Defines Mac OS X aliases and functions.
|
||||
|
||||
Pacman
|
||||
------
|
||||
|
||||
Provides aliases and functions for the Pacman package manager and frontends.
|
||||
|
||||
Perl
|
||||
----
|
||||
|
||||
Enables local Perl module installation on Mac OS X and defines alises.
|
||||
|
||||
Prompt
|
||||
------
|
||||
|
||||
Loads prompt themes.
|
||||
|
||||
Python
|
||||
------
|
||||
|
||||
Enables local Python and local Python package installation.
|
||||
|
||||
Ruby on Rails
|
||||
-------------
|
||||
|
||||
Defines Ruby on Rails aliases.
|
||||
|
||||
Rsync
|
||||
-----
|
||||
|
||||
Defines rsync aliases.
|
||||
|
||||
Ruby
|
||||
----
|
||||
|
||||
Configures Ruby local gem installation, loads version managers, and defines
|
||||
aliases.
|
||||
|
||||
GNU Screen
|
||||
----------
|
||||
|
||||
Defines GNU Screen aliases and provides for auto launching it at start-up.
|
||||
|
||||
Spectrum
|
||||
--------
|
||||
|
||||
Provides for easier use of 256 colors and effects.
|
||||
|
||||
SSH
|
||||
---
|
||||
|
||||
Provides for an easier use of SSH by setting up ssh-agent.
|
||||
|
||||
Syntax Highlighting
|
||||
-------------------
|
||||
|
||||
Integrates zsh-syntax-highlighting into Prezto.
|
||||
|
||||
Terminal
|
||||
--------
|
||||
|
||||
Sets terminal window and tab titles.
|
||||
|
||||
Tmux
|
||||
----
|
||||
|
||||
Defines tmux aliases and provides for auto launching it at start-up.
|
||||
|
||||
Utility
|
||||
-------
|
||||
|
||||
Defines general aliases and functions.
|
||||
|
||||
Wake-on-LAN
|
||||
-----------
|
||||
|
||||
This module provides a wrapper around the wakeonlan tool.
|
||||
|
||||
Yum
|
||||
---
|
||||
|
||||
Defines yum aliases.
|
||||
|
@ -1,41 +0,0 @@
|
||||
Archive
|
||||
=======
|
||||
|
||||
Provides functions to list and extract archives.
|
||||
|
||||
Functions
|
||||
---------
|
||||
|
||||
- `lsarchive` lists the contents of one or more archives.
|
||||
- `unarchive` extracts the contents of one or more archives.
|
||||
|
||||
Supported Formats
|
||||
-----------------
|
||||
|
||||
The following archive formats are supported when the required utilities are
|
||||
installed:
|
||||
|
||||
- *.tar.gz*, *.tgz* require `tar`.
|
||||
- *.tar.bz2*, *.tbz* require `tar`.
|
||||
- *.tar.xz*, *.txz* require `tar` with *xz* support.
|
||||
- *.tar.zma*, *.tlz* require `tar` with *lzma* support.
|
||||
- *.tar* requires `tar`.
|
||||
- *.gz* requires `gunzip`.
|
||||
- *.bz2* requires `bunzip2`.
|
||||
- *.xz* requires `unxz`.
|
||||
- *.lzma* requires `unlzma`.
|
||||
- *.Z* requires `uncompress`.
|
||||
- *.zip* requires `unzip`.
|
||||
- *.rar* requires `unrar` or `rar`.
|
||||
- *.7z* requires `7za`.
|
||||
- *.deb* requires `ar`, `tar`.
|
||||
|
||||
Authors
|
||||
-------
|
||||
|
||||
*The authors of this module should be contacted via the [issue tracker][1].*
|
||||
|
||||
- [Sorin Ionescu](https://github.com/sorin-ionescu)
|
||||
|
||||
[1]: https://github.com/sorin-ionescu/prezto/issues
|
||||
|
@ -1,16 +0,0 @@
|
||||
Command-Not-Found
|
||||
=================
|
||||
|
||||
Displays installation information for not found commands by loading the
|
||||
[command-not-found][1] tool on Debian-based and Arch Linux-based distributions.
|
||||
|
||||
Authors
|
||||
-------
|
||||
|
||||
*The authors of this module should be contacted via the [issue tracker][2].*
|
||||
|
||||
- [Joseph Booker](https://github.com/sargas)
|
||||
|
||||
[1]: https://code.launchpad.net/command-not-found
|
||||
[2]: https://github.com/sorin-ionescu/prezto/issues
|
||||
|
@ -1,24 +0,0 @@
|
||||
Completion
|
||||
==========
|
||||
|
||||
Loads and configures tab completion and provides additional completions from
|
||||
the [zsh-completions][1] project.
|
||||
|
||||
This module must be loaded **after** the *utility* module.
|
||||
|
||||
Contributors
|
||||
------------
|
||||
|
||||
Completions should be submitted to the [zsh-completions][1] project according
|
||||
to its rules and regulations. This module will be synchronized against it.
|
||||
|
||||
Authors
|
||||
-------
|
||||
|
||||
*The authors of this module should be contacted via the [issue tracker][2].*
|
||||
|
||||
- [Sorin Ionescu](https://github.com/sorin-ionescu)
|
||||
|
||||
[1]: https://github.com/zsh-users/zsh-completions
|
||||
[2]: https://github.com/sorin-ionescu/prezto/issues
|
||||
|
@ -1,36 +0,0 @@
|
||||
Directory
|
||||
=========
|
||||
|
||||
Sets directory options and defines directory aliases.
|
||||
|
||||
Options
|
||||
-------
|
||||
|
||||
- `AUTO_CD` auto changes to a directory without typing `cd`.
|
||||
- `AUTO_PUSHD` pushes the old directory onto the stack on `cd`.
|
||||
- `PUSHD_IGNORE_DUPS` does not store duplicates in the stack.
|
||||
- `PUSHD_SILENT` does not print the directory stack after `pushd` or `popd`.
|
||||
- `PUSHD_TO_HOME` pushes to the home directory when no argument is given.
|
||||
- `CDABLE_VARS` changes directory to a path stored in a variable.
|
||||
- `AUTO_NAME_DIRS` auto adds variable-stored paths to `~` list.
|
||||
- `MULTIOS` writes to multiple descriptors.
|
||||
- `EXTENDED_GLOB` uses extended globbing syntax.
|
||||
- `CLOBBER` does not overwrite existing files with `>` and `>>`. Use `>!` and
|
||||
`>>!` to bypass.
|
||||
|
||||
Aliases
|
||||
-------
|
||||
|
||||
- `d` prints the contents of the directory stack.
|
||||
- `1 ... 9` changes the directory to the **n** previous one.
|
||||
|
||||
Authors
|
||||
-------
|
||||
|
||||
*The authors of this module should be contacted via the [issue tracker][1].*
|
||||
|
||||
- [James Cox](https://github.com/imajes)
|
||||
- [Sorin Ionescu](https://github.com/sorin-ionescu)
|
||||
|
||||
[1]: https://github.com/sorin-ionescu/prezto/issues
|
||||
|
@ -1,42 +0,0 @@
|
||||
Dpkg
|
||||
====
|
||||
|
||||
Defines [dpkg][1] aliases and functions.
|
||||
|
||||
Aliases
|
||||
-------
|
||||
|
||||
- `debc` cleans the cache.
|
||||
- `debf` displays a file's package.
|
||||
- `debi` installs packages from repositories.
|
||||
- `debI` installs packages from files.
|
||||
- `debq` displays package information.
|
||||
- `debu` updates the package 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-kclean` removes all kernel images and headers, except for the ones in
|
||||
use.
|
||||
|
||||
Functions
|
||||
---------
|
||||
|
||||
- `deb-clone` generates a script that can be used to duplicate a dpkg-based
|
||||
system.
|
||||
- `deb-history` displays dpkg history.
|
||||
- `deb-kbuild` makes a dpkg Linux kernel package.
|
||||
|
||||
Authors
|
||||
-------
|
||||
|
||||
*The authors of this module should be contacted via the [issue tracker][2].*
|
||||
|
||||
- [Daniel Bolton](https://github.com/dbb)
|
||||
- [Benjamin Boudreau](https://github.com/dreur)
|
||||
- [Sorin Ionescu](https://github.com/sorin-ionescu)
|
||||
|
||||
[1]: http://wiki.debian.org/Teams/Dpkg
|
||||
[2]: https://github.com/sorin-ionescu/prezto/issues
|
||||
|
@ -1,63 +0,0 @@
|
||||
Editor
|
||||
======
|
||||
|
||||
Sets key bindings.
|
||||
|
||||
Settings
|
||||
--------
|
||||
|
||||
### Key bindings
|
||||
|
||||
To enable key bindings, add the following to *zpreztorc*, and replace 'bindings'
|
||||
with 'emacs' or 'vi'.
|
||||
|
||||
zstyle ':prezto:module:editor' key-bindings 'bindings'
|
||||
|
||||
### Dot Expansion
|
||||
|
||||
To enable the auto conversion of .... to ../.., add the following to
|
||||
*zpreztorc*.
|
||||
|
||||
zstyle ':prezto:module:editor' dot-expansion 'yes'
|
||||
|
||||
Theming
|
||||
-------
|
||||
|
||||
To indicate when the editor is in the primary keymap (emacs or viins), add
|
||||
the following to your `theme_prompt_setup` function.
|
||||
|
||||
zstyle ':prezto:module:editor:info:keymap:primary' format '>>>'
|
||||
|
||||
To indicate when the editor is in the primary keymap (emacs or viins) insert
|
||||
mode, add the following to your `theme_prompt_setup` function.
|
||||
|
||||
zstyle ':prezto:module:editor:info:keymap:primary:insert' format 'I'
|
||||
|
||||
To indicate when the editor is in the primary keymap (emacs or viins) overwrite
|
||||
mode, add the following to your `theme_prompt_setup` function.
|
||||
|
||||
zstyle ':prezto:module:editor:info:keymap:primary:overwrite' format 'O'
|
||||
|
||||
To indicate when the editor is in the alternate keymap (vicmd), add the
|
||||
following to your `theme_prompt_setup` function.
|
||||
|
||||
zstyle ':prezto:module:editor:info:keymap:alternate' format '<<<'
|
||||
|
||||
To indicate when the editor is completing, add the following to your
|
||||
`theme_prompt_setup` function.
|
||||
|
||||
zstyle ':prezto:module:editor:info:completing' format '...'
|
||||
|
||||
Then add `$editor_info[context]`, where context is *keymap*, *insert*, or
|
||||
*overwrite*, to `$PROMPT` or `$RPROMPT` and call `editor-info` in the
|
||||
`prompt_name_preexec` hook function.
|
||||
|
||||
Authors
|
||||
-------
|
||||
|
||||
*The authors of this module should be contacted via the [issue tracker][1].*
|
||||
|
||||
- [Sorin Ionescu](https://github.com/sorin-ionescu)
|
||||
|
||||
[1]: https://github.com/sorin-ionescu/oh-my-zsh/issues
|
||||
|
@ -1,33 +0,0 @@
|
||||
Emacs
|
||||
=====
|
||||
|
||||
Enables Emacs dependency management.
|
||||
|
||||
Dependency management
|
||||
---------------------
|
||||
|
||||
[Carton][1] installs and manages Emacs packages for Emacs package development
|
||||
and Emacs configuration.
|
||||
|
||||
This module prepends the Carton directory to the path variable to enable the
|
||||
execution of `carton`.
|
||||
|
||||
Aliases
|
||||
-------
|
||||
|
||||
### Carton
|
||||
|
||||
- `cai` installs dependencies.
|
||||
- `cau` updates dependencies.
|
||||
- `caI` initializes the current directory for dependency management.
|
||||
- `cae` executes a command which correct dependencies.
|
||||
|
||||
Authors
|
||||
-------
|
||||
|
||||
*The authors of this module should be contacted via the [issue tracker][2].*
|
||||
|
||||
- [Sebastian Wiesner](https://github.com/lunaryorn)
|
||||
|
||||
[1]: https://github.com/rejeep/carton
|
||||
[2]: https://github.com/sorin-ionescu/prezto/issues
|
@ -1,26 +0,0 @@
|
||||
Environment
|
||||
===========
|
||||
|
||||
Sets general shell options and defines environment variables.
|
||||
|
||||
This module must be loaded first.
|
||||
|
||||
Environment Variables
|
||||
---------------------
|
||||
|
||||
Contributors
|
||||
------------
|
||||
|
||||
This module **MUST NOT** rely on any command not built in Zsh.
|
||||
|
||||
Non-interactive environment variables should be defined in *zshenv*.
|
||||
|
||||
Authors
|
||||
-------
|
||||
|
||||
*The authors of this module should be contacted via the [issue tracker][1].*
|
||||
|
||||
- [Sorin Ionescu](https://github.com/sorin-ionescu)
|
||||
|
||||
[1]: https://github.com/sorin-ionescu/prezto/issues
|
||||
|
@ -1,39 +0,0 @@
|
||||
Fasd
|
||||
====
|
||||
|
||||
[Fasd][1] is a command-line productivity booster, inspired by tools like
|
||||
[autojump][2], [z][3] and [v][4], it offers quick access to files and
|
||||
directories by keeping track of files and directories that were previously
|
||||
accessed.
|
||||
|
||||
For completion to work, this module must be loaded **after** the *completion*
|
||||
module.
|
||||
|
||||
The Prezto Fasd configuration differs from the default. The default aliases have
|
||||
been disabled.
|
||||
|
||||
Aliases
|
||||
-------
|
||||
|
||||
- `j` changes the current working directory interactively.
|
||||
|
||||
Completion
|
||||
----------
|
||||
|
||||
Type `,`, `f,`, `d,` in front of a comma-separated query or type `,,`, `,,f`,
|
||||
`,,d` at the end of a comma-separated query then hit <kbd>tab</kbd>.
|
||||
|
||||
Authors
|
||||
-------
|
||||
|
||||
*The authors of this module should be contacted via the [issue tracker][5].*
|
||||
|
||||
- [Wei Dai](https://github.com/clvv)
|
||||
- [Sorin Ionescu](https://github.com/sorin-ionescu)
|
||||
|
||||
[1]: https://github.com/clvv/fasd
|
||||
[2]: https://github.com/joelthelion/autojump
|
||||
[3]: https://github.com/rupa/z
|
||||
[4]: https://github.com/rupa/v
|
||||
[5]: https://github.com/sorin-ionescu/prezto/issues
|
||||
|
@ -1,335 +0,0 @@
|
||||
Git
|
||||
===
|
||||
|
||||
Enhances the [Git][1] distributed version control system by providing aliases,
|
||||
functions and by exposing repository status information to prompts.
|
||||
|
||||
Git **1.7.2** is the [minimum required version][7].
|
||||
|
||||
Settings
|
||||
--------
|
||||
|
||||
### Log
|
||||
|
||||
The format of the [git-log][8] output is configurable via the following style,
|
||||
where context is *brief*, *oneline*, and *medium*, which will be passed to the
|
||||
`--pretty=format:` switch.
|
||||
|
||||
zstyle ':prezto:module:git:log:context' format ''
|
||||
|
||||
### Status
|
||||
|
||||
Retrieving the status of a repository with submodules can take a long time.
|
||||
Submodules may be ignored when they are *dirty*, *untracked*, *all*, or *none*.
|
||||
|
||||
zstyle ':prezto:module:git:status:ignore' submodules 'all'
|
||||
|
||||
This setting affects all aliases and functions that call `git-status`.
|
||||
|
||||
Aliases
|
||||
-------
|
||||
|
||||
### Git
|
||||
|
||||
- `g` is short for `git`.
|
||||
|
||||
### Branch
|
||||
|
||||
- `gb` lists, creates, renames, and deletes branches.
|
||||
- `gbc` creates a new branch.
|
||||
- `gbl` lists branches and their commits.
|
||||
- `gbL` lists local and remote branches and their commits.
|
||||
- `gbs` lists branches and their commits with ancestry graphs.
|
||||
- `gbS` lists local and remote branches and their commits with ancestry
|
||||
graphs.
|
||||
- `gbx` deletes a branch.
|
||||
- `gbX` deletes a branch irrespective of its merged status.
|
||||
- `gbm` renames a branch.
|
||||
- `gbM` renames a branch even if the new branch name already exists.
|
||||
|
||||
|
||||
### Commit
|
||||
|
||||
- `gc` records changes to the repository.
|
||||
- `gca` stages all modified and deleted files.
|
||||
- `gcm` records changes to the repository with the given message.
|
||||
- `gco` checks out a branch or paths to work tree.
|
||||
- `gcO` checks out hunks from the index or the tree interactively.
|
||||
- `gcf` amends the tip of the current branch using the same log message as
|
||||
*HEAD*.
|
||||
- `gcF` amends the tip of the current branch.
|
||||
- `gcp` applies changes introduced by existing commits.
|
||||
- `gcP` applies changes introduced by existing commits without committing.
|
||||
- `gcr` reverts existing commits by reverting patches and recording new
|
||||
commits.
|
||||
- `gcR` removes the *HEAD* commit.
|
||||
- `gcs` displays various types of objects.
|
||||
- `gcl` lists lost commits.
|
||||
|
||||
### Conflict
|
||||
|
||||
- `gCl` lists unmerged files.
|
||||
- `gCa` adds unmerged file contents to the index.
|
||||
- `gCe` executes merge-tool on all unmerged file.
|
||||
- `gCo` checks out our changes for unmerged paths.
|
||||
- `gCO` checks out our changes for all unmerged paths.
|
||||
- `gCt` checks out their changes for unmerged paths.
|
||||
- `gCT` checks out their changes for all unmerged paths.
|
||||
|
||||
### Data
|
||||
|
||||
- `gd` displays information about files in the index and the work tree.
|
||||
- `gdc` lists cached files.
|
||||
- `gdx` lists deleted files.
|
||||
- `gdm` lists modified files.
|
||||
- `gdu` lists untracked files.
|
||||
- `gdk` lists killed files.
|
||||
- `gdi` lists ignored files.
|
||||
|
||||
### Fetch
|
||||
|
||||
- `gf` downloads objects and references from another repository.
|
||||
- `gfc` clones a repository into a new directory.
|
||||
- `gfm` fetches from and merges with another repository or local branch.
|
||||
- `gfr` fetches from and rebases on another repository or local branch.
|
||||
|
||||
### Grep
|
||||
|
||||
- `gg` displays lines matching a pattern.
|
||||
- `ggi` displays lines matching a pattern ignoring case.
|
||||
- `ggl` lists files matching a pattern.
|
||||
- `ggL` lists files that are not matching a pattern.
|
||||
- `ggv` displays lines not matching a pattern.
|
||||
- `ggw` displays lines matching a pattern at word boundary.
|
||||
|
||||
### Index
|
||||
|
||||
- `gia` adds file contents to the index.
|
||||
- `giA` adds file contents to the index interactively.
|
||||
- `giu` adds file contents to the index (updates only known files).
|
||||
- `gid` displays changes between the index and a named commit (diff).
|
||||
- `giD` displays changes between the index and a named commit (word diff).
|
||||
- `gir` resets the current HEAD to the specified state.
|
||||
- `giR` resets the current index interactively.
|
||||
- `gix` removes files/directories from the index (recursively).
|
||||
- `giX` removes files/directories from the index (recursively and forced).
|
||||
|
||||
### Log
|
||||
|
||||
- `gl` displays the log.
|
||||
- `gls` displays the stats log.
|
||||
- `gld` displays the diff log.
|
||||
- `glo` displays the one line log.
|
||||
- `glg` displays the graph log.
|
||||
- `glb` displays the brief commit log.
|
||||
- `glc` displays the commit count for each contributor in descending order.
|
||||
|
||||
### Merge
|
||||
|
||||
- `gm` joins two or more development histories together.
|
||||
- `gmC` joins two or more development histories together but does not commit.
|
||||
- `gmF` joins two or more development histories together but does not commit
|
||||
generating a merge commit even if the merge resolved as a fast-forward.
|
||||
- `gma` aborts the conflict resolution, and reconstructs the pre-merge state.
|
||||
- `gmt` runs the merge conflict resolution tools to resolve conflicts.
|
||||
|
||||
### Push
|
||||
|
||||
- `gp` updates remote refs along with associated objects.
|
||||
- `gpf` forcefully updates remote refs along with associated objects.
|
||||
- `gpa` updates remote branches along with associated objects.
|
||||
- `gpA` updates remote branches and tags along with associated objects.
|
||||
- `gpt` updates remote tags along with associated objects.
|
||||
- `gpc` updates remote refs along with associated objects and adds *origin*
|
||||
as an upstream reference for the current branch.
|
||||
- `gpp` pulls and pushes from origin to origin.
|
||||
|
||||
### Rebase
|
||||
|
||||
- `gr` forward-ports local commits to the updated upstream head.
|
||||
- `gra` aborts the rebase.
|
||||
- `grc` continues the rebase after merge conflicts are resolved.
|
||||
- `gri` makes a list of commits to be rebased and opens the editor.
|
||||
- `grs` skips the current patch.
|
||||
|
||||
### Remote
|
||||
|
||||
- `gR` manages tracked repositories.
|
||||
- `gRl` lists remote names and their URLs.
|
||||
- `gRa` adds a new remote.
|
||||
- `gRx` removes a remote.
|
||||
- `gRm` renames a remote.
|
||||
- `gRu` fetches remotes updates.
|
||||
- `gRp` prunes all stale remote tracking branches.
|
||||
- `gRs` displays information about a given remote.
|
||||
- `gRb` opens a remote on [GitHub][3] in the default browser.
|
||||
|
||||
### Stash
|
||||
|
||||
- `gs` stashes the changes of the dirty working directory.
|
||||
- `gsa` applies the changes recorded in a stash to the working directory.
|
||||
- `gsx` drops a stashed state.
|
||||
- `gsX` drops all the stashed states.
|
||||
- `gsl` lists stashed states.
|
||||
- `gsL` lists dropped stashed states.
|
||||
- `gsd` displays changes between the stash and its original parent.
|
||||
- `gsp` removes and applies a single stashed state from the stash list.
|
||||
- `gsr` recovers a given stashed state.
|
||||
- `gss` stashes the changes of the dirty working directory, including untracked.
|
||||
- `gsS` stashes the changes of the dirty working directory interactively.
|
||||
- `gsw` stashes the changes of the dirty working directory retaining the index.
|
||||
|
||||
### Submodule
|
||||
|
||||
- `gS` initializes, updates, or inspects submodules.
|
||||
- `gSa` adds given a repository as a submodule.
|
||||
- `gSf` evaluates a shell command in each of checked out submodules.
|
||||
- `gSi` initializes submodules.
|
||||
- `gSI` initializes and clones submodules recursively.
|
||||
- `gSl` lists the commits of all submodules.
|
||||
- `gSm` moves a submodule.
|
||||
- `gSs` synchronizes submodules' remote URL to the value specified in
|
||||
.gitmodules.
|
||||
- `gSu` fetches and merges the latest changes for all submodule.
|
||||
- `gSx` removes a submodule.
|
||||
|
||||
### Working directory
|
||||
|
||||
- `gws` displays working-tree status in the short format.
|
||||
- `gwS` displays working-tree status.
|
||||
- `gwd` displays changes between the working tree and the index (diff).
|
||||
- `gwD` displays changes between the working tree and the index (word diff).
|
||||
- `gwr` resets the current HEAD to the specified state, does not touch the
|
||||
index nor the working tree.
|
||||
- `gwR` resets the current HEAD, index and working tree to the specified state.
|
||||
- `gwc` removes untracked files from the working tree (dry-run).
|
||||
- `gwC` removes untracked files from the working tree.
|
||||
- `gwx` removes files from the working tree and from the index recursively.
|
||||
- `gwX` removes files from the working tree and from the index recursively and
|
||||
forcefully.
|
||||
|
||||
### Shadows
|
||||
|
||||
The following aliases may shadow system commands:
|
||||
|
||||
- `gpt` shadows the [GUID partition table maintenance utility][4].
|
||||
- `gs` shadows the [Ghostscript][5].
|
||||
|
||||
If you frequently use the above commands, you may wish to remove said aliases
|
||||
from this module or to disable them at the bottom of the zshrc with `unalias`.
|
||||
|
||||
You can temporarily bypass an alias by prefixing it with a backward slash:
|
||||
`\gpt`.
|
||||
|
||||
Functions
|
||||
---------
|
||||
|
||||
- `git-branch-current` displays the current branch.
|
||||
- `git-commit-lost` lists lost commits.
|
||||
- `git-dir` displays the path to the Git directory.
|
||||
- `git-hub-browse` opens the [GitHub][3] repository in the default browser.
|
||||
- `git-hub-shorten-url` shortens GitHub URLs.
|
||||
- `git-info` exposes repository information via the `$git_info` associative
|
||||
array.
|
||||
- `git-root` displays the path to the working tree root.
|
||||
- `git-stash-clear-interactive` asks for confirmation before clearing the stash.
|
||||
- `git-stash-dropped` lists dropped stashed states.
|
||||
- `git-stash-recover` recovers given dropped stashed states.
|
||||
- `git-submodule-move` moves a submodule.
|
||||
- `git-submodule-remove` removes a submodule.
|
||||
|
||||
Theming
|
||||
-------
|
||||
|
||||
To display information about the current repository in a prompt, define the
|
||||
following styles in the `prompt_name_setup` function, where the syntax for
|
||||
setting a style is as follows.
|
||||
|
||||
zstyle ':prezto:module:git:info:context:subcontext' format 'string'
|
||||
|
||||
### Main Contexts
|
||||
|
||||
| Name | Format Code | Description
|
||||
| --------- | :---------: | ---------------------------------------------------
|
||||
| action | %s | Special action name
|
||||
| ahead | %A | Commits ahead of remote count
|
||||
| behind | %B | Commits behind of remote count
|
||||
| branch | %b | Branch name
|
||||
| commit | %c | Commit hash
|
||||
| position | %p | Commits from the nearest tag count
|
||||
| remote | %R | Remote name
|
||||
| stashed | %S | Stashed states count
|
||||
|
||||
### Concise Contexts
|
||||
|
||||
| Name | Format Code | Description
|
||||
| --------- | :---------: | ---------------------------------------------------
|
||||
| clean | %C | Clean state
|
||||
| dirty | %D | Dirty files count
|
||||
| indexed | %i | Indexed files count
|
||||
| unindexed | %I | Unindexed files count
|
||||
| untracked | %u | Untracked files count
|
||||
|
||||
The following contexts must be enabled with the following zstyle:
|
||||
|
||||
zstyle ':prezto:module:git:info' verbose 'yes'
|
||||
|
||||
### Verbose Contexts
|
||||
|
||||
| Name | Format Code | Description
|
||||
| --------- | :---------: | ---------------------------------------------------
|
||||
| added | %a | Added files count
|
||||
| clean | %C | Clean state
|
||||
| deleted | %d | Deleted files count
|
||||
| dirty | %D | Dirty files count
|
||||
| modified | %m | Modified files count
|
||||
| renamed | %r | Renamed files count
|
||||
| unmerged | %U | Unmerged files count
|
||||
| untracked | %u | Untracked files count
|
||||
|
||||
### Special Action Contexts
|
||||
|
||||
| Name | Format | Description
|
||||
| -------------------- | :---------: | -----------------------------------------
|
||||
| apply | value | Applying patches
|
||||
| bisect | value | Binary searching for changes
|
||||
| cherry-pick | value | Cherry picking
|
||||
| cherry-pick-sequence | value | Cherry picking sequence
|
||||
| merge | value | Merging
|
||||
| rebase | value | Rebasing
|
||||
| rebase-interactive | value | Rebasing interactively
|
||||
| rebase-merge | value | Rebasing merge
|
||||
|
||||
First, format the repository state attributes. For example, to format the branch
|
||||
and remote names, define the following styles.
|
||||
|
||||
zstyle ':prezto:module:git:info:branch' format 'branch:%b'
|
||||
zstyle ':prezto:module:git:info:remote' format 'remote:%R'
|
||||
|
||||
Second, format how the above attributes are displayed in prompts.
|
||||
|
||||
zstyle ':prezto:module:git:info:keys' format \
|
||||
'prompt' ' git(%b)' \
|
||||
'rprompt' '[%R]'
|
||||
|
||||
Last, add `$git_info[prompt]` to `$PROMPT` and `$git_info[rprompt]` to
|
||||
`$RPROMPT` respectively and call `git-info` in the `prompt_name_preexec` hook
|
||||
function.
|
||||
|
||||
Authors
|
||||
-------
|
||||
|
||||
*The authors of this module should be contacted via the [issue tracker][6].*
|
||||
|
||||
- [Sorin Ionescu](https://github.com/sorin-ionescu)
|
||||
- [Colin Hebert](https://github.com/ColinHebert)
|
||||
|
||||
[1]: http://www.git-scm.com
|
||||
[2]: https://github.com/defunkt/hub
|
||||
[3]: https://www.github.com
|
||||
[4]: http://www.manpagez.com/man/8/gpt/
|
||||
[5]: http://linux.die.net/man/1/gs
|
||||
[6]: https://github.com/sorin-ionescu/prezto/issues
|
||||
[7]: https://github.com/sorin-ionescu/prezto/issues/219
|
||||
[8]: http://www.kernel.org/pub/software/scm/git/docs/git-log.html
|
||||
|
@ -1,33 +0,0 @@
|
||||
GNU Utility
|
||||
===========
|
||||
|
||||
Provides for the interactive use of GNU utilities on non-GNU systems.
|
||||
|
||||
Installing GNU utilities on non-GNU systems in `$PATH` without a prefix, i.e.
|
||||
`ls` instead of `gls`, is not recommended since scripts that target other
|
||||
utilities will be broken.
|
||||
|
||||
This module wraps GNU utilities in functions without a prefix for interactive
|
||||
use.
|
||||
|
||||
This module must be loaded **before** the *utility* module.
|
||||
|
||||
Settings
|
||||
--------
|
||||
|
||||
### Prefix
|
||||
|
||||
To use a different prefix, add the following to *zpreztorc*, and replace 'g' with
|
||||
the desired prefix:
|
||||
|
||||
zstyle ':prezto:module:gnu-utility' prefix 'g'
|
||||
|
||||
Authors
|
||||
-------
|
||||
|
||||
*The authors of this module should be contacted via the [issue tracker][1].*
|
||||
|
||||
- [Sorin Ionescu](https://github.com/sorin-ionescu)
|
||||
|
||||
[1]: https://github.com/sorin-ionescu/prezto/issues
|
||||
|
@ -1,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
|
||||
|
@ -1,29 +0,0 @@
|
||||
Haskell
|
||||
=======
|
||||
|
||||
Enables local Haskell package installation.
|
||||
|
||||
Per-user Package Installation
|
||||
-----------------------------
|
||||
|
||||
[Cabal][1], the Haskell package manager, can install packages into per user
|
||||
directories.
|
||||
|
||||
This module prepends per user directories to the relevant path variables to
|
||||
enable the execution of user installed executables and the reading of
|
||||
documentation.
|
||||
|
||||
### Usage
|
||||
|
||||
Install packages into per user directories with `cabal install --user`.
|
||||
|
||||
Authors
|
||||
-------
|
||||
|
||||
*The authors of this module should be contacted via the [issue tracker][2].*
|
||||
|
||||
- [Sebastian Wiesner](https://github.com/lunaryorn)
|
||||
|
||||
[1]: http://www.haskell.org/cabal/
|
||||
[2]: https://github.com/sorin-ionescu/prezto/issues
|
||||
|
@ -1,25 +0,0 @@
|
||||
Helper
|
||||
======
|
||||
|
||||
Provides helper functions for developing modules.
|
||||
|
||||
Functions
|
||||
---------
|
||||
|
||||
- `add-zsh-trap` adds a function name to a list to be called when a trap is
|
||||
triggered.
|
||||
- `is-autoloadable` checks if a file can be autoloaded by trying to load it
|
||||
in a subshell.
|
||||
- `is-callable` checks if a name is a command, function, or alias.
|
||||
- `is-true` checks a boolean variable for "true".
|
||||
- `coalesce` prints the first non-empty string in the arguments array.
|
||||
|
||||
Authors
|
||||
-------
|
||||
|
||||
*The authors of this module should be contacted via the [issue tracker][1].*
|
||||
|
||||
- [Sorin Ionescu](https://github.com/sorin-ionescu)
|
||||
|
||||
[1]: https://github.com/sorin-ionescu/prezto/issues
|
||||
|
@ -1,62 +0,0 @@
|
||||
History Substring Search
|
||||
========================
|
||||
|
||||
Integrates [zsh-history-substring-search][1] into Prezto, which implements
|
||||
the [Fish shell][2]'s history search feature, where the user can type in any
|
||||
part of a previously entered command and press up and down to cycle through
|
||||
matching commands.
|
||||
|
||||
If this module is used in conjuncture with the *syntax-highlighting* module, it
|
||||
must be loaded **after** it.
|
||||
|
||||
Contributors
|
||||
------------
|
||||
|
||||
New features and bug fixes should be submitted to the
|
||||
[zsh-history-substring-search][1] project according to its rules and
|
||||
regulations. This module will be synchronized against it.
|
||||
|
||||
Settings
|
||||
--------
|
||||
|
||||
### Case Sensitivity
|
||||
|
||||
To enable case-sensitivity for this module only, add the following line to
|
||||
*zpreztorc*:
|
||||
|
||||
zstyle ':prezto:module:history-substring-search' case-sensitive 'yes'
|
||||
|
||||
### Highlighting
|
||||
|
||||
If colors are enabled, *history-substring-search* will automatically highlight
|
||||
positive results.
|
||||
|
||||
To enable highlighting for this module only, add the following line to
|
||||
*zpreztorc*:
|
||||
|
||||
zstyle ':prezto:module:history-substring-search' color 'yes'
|
||||
|
||||
To set the query found color, add the following line to *zpreztorc*:
|
||||
|
||||
zstyle ':prezto:module:history-substring-search:color' found ''
|
||||
|
||||
To set the query not found color, add the following line to *zpreztorc*:
|
||||
|
||||
zstyle ':prezto:module:history-substring-search:color' not-found ''
|
||||
|
||||
To set the search globbing flags, add the following line to *zpreztorc*:
|
||||
|
||||
zstyle ':prezto:module:history-substring-search' globbing-flags ''
|
||||
|
||||
Authors
|
||||
-------
|
||||
|
||||
*The authors of this module should be contacted via the [issue tracker][3].*
|
||||
|
||||
- [Suraj N. Kurapati](https://github.com/sunaku)
|
||||
- [Sorin Ionescu](https://github.com/sorin-ionescu)
|
||||
|
||||
[1]: https://github.com/zsh-users/zsh-history-substring-search
|
||||
[2]: http://fishshell.com
|
||||
[3]: https://github.com/sorin-ionescu/prezto/issues
|
||||
|
@ -1,44 +0,0 @@
|
||||
History
|
||||
=======
|
||||
|
||||
Sets [history][1] options and defines history aliases.
|
||||
|
||||
Variables
|
||||
---------
|
||||
|
||||
- `HISTFILE` stores the path to the history file.
|
||||
- `HISTSIZE` stores the maximum number of events to save in the internal history.
|
||||
- `SAVEHIST` stores the maximum number of events to save in the history file.
|
||||
|
||||
Options
|
||||
-------
|
||||
|
||||
- `BANG_HIST` treats the **!** character specially during expansion.
|
||||
- `EXTENDED_HISTORY` writes the history file in the *:start:elapsed;command* format.
|
||||
- `INC_APPEND_HISTORY` writes to the history file immediately, not when the shell exits.
|
||||
- `SHARE_HISTORY` shares history between all sessions.
|
||||
- `HIST_EXPIRE_DUPS_FIRST` expires a duplicate event first when trimming history.
|
||||
- `HIST_IGNORE_DUPS` does not record an event that was just recorded again.
|
||||
- `HIST_IGNORE_ALL_DUPS` deletes an old recorded event if a new event is a duplicate.
|
||||
- `HIST_FIND_NO_DUPS` does not display a previously found event.
|
||||
- `HIST_IGNORE_SPACE` does not record an event starting with a space.
|
||||
- `HIST_SAVE_NO_DUPS` does not write a duplicate event to the history file.
|
||||
- `HIST_VERIFY` does not execute immediately upon history expansion.
|
||||
- `HIST_BEEP` beeps when accessing non-existent history.
|
||||
|
||||
Aliases
|
||||
-------
|
||||
|
||||
- `history-stat` lists the ten most used commands
|
||||
|
||||
Authors
|
||||
-------
|
||||
|
||||
*The authors of this module should be contacted via the [issue tracker][2].*
|
||||
|
||||
- [Robby Russell](https://github.com/robbyrussell)
|
||||
- [Sorin Ionescu](https://github.com/sorin-ionescu)
|
||||
|
||||
[1]: http://zsh.sourceforge.net/Guide/zshguide02.html#l16
|
||||
[2]: https://github.com/sorin-ionescu/prezto/issues
|
||||
|
@ -1,26 +0,0 @@
|
||||
Homebrew
|
||||
========
|
||||
|
||||
Defines Homebrew aliases.
|
||||
|
||||
Aliases
|
||||
-------
|
||||
|
||||
- `brewc` cleans outdated brews and their cached archives.
|
||||
- `brewC` cleans outdated brews, including keg-only, and their cached archives.
|
||||
- `brewi` installs a formula.
|
||||
- `brewl` lists installed formulae.
|
||||
- `brews` searches for a formula.
|
||||
- `brewU` upgrades Homebrew and outdated brews.
|
||||
- `brewu` upgrades Homebrew.
|
||||
- `brewx` uninstalls a formula.
|
||||
|
||||
Authors
|
||||
-------
|
||||
|
||||
*The authors of this module should be contacted via the [issue tracker][1].*
|
||||
|
||||
- [Sorin Ionescu](https://github.com/sorin-ionescu)
|
||||
|
||||
[1]: https://github.com/sorin-ionescu/prezto/issues
|
||||
|
@ -1,26 +0,0 @@
|
||||
Macports
|
||||
========
|
||||
|
||||
Defines MacPorts aliases and adds MacPorts directories to path variables.
|
||||
|
||||
Aliases
|
||||
-------
|
||||
|
||||
- `portc` cleans the files used to build ports.
|
||||
- `porti` installs a port.
|
||||
- `ports` searches for a port.
|
||||
- `portu` upgrades a port.
|
||||
- `portU` upgrades MacPorts, the ports collection, and outdated ports.
|
||||
- `portx` uninstalls a port.
|
||||
- `portX` uninstalls inactive ports.
|
||||
|
||||
Authors
|
||||
-------
|
||||
|
||||
*The authors of this module should be contacted via the [issue tracker][1].*
|
||||
|
||||
- [Matt Cable](https://github.com/curiousstranger)
|
||||
- [Sorin Ionescu](https://github.com/sorin-ionescu)
|
||||
|
||||
[1]: https://github.com/sorin-ionescu/prezto/issues
|
||||
|
@ -1,46 +0,0 @@
|
||||
Node.js
|
||||
=======
|
||||
|
||||
Provides utility functions for [Node.js][1], loads the Node Version Manager, and
|
||||
enables [npm][2] completion.
|
||||
|
||||
nvm
|
||||
---
|
||||
|
||||
[nvm][5] allows for managing multiple, isolated Node.js installations in the
|
||||
home directory.
|
||||
|
||||
Functions
|
||||
---------
|
||||
|
||||
- `node-doc` opens the Node.js online [API documentation][3] in the default
|
||||
browser.
|
||||
- `node-info` exposes information about the Node.js environment via the
|
||||
`$node_info` associative array.
|
||||
|
||||
Theming
|
||||
-------
|
||||
|
||||
To display the version number of the current Node.js version, define the
|
||||
following style inside the `prompt_name_setup` function.
|
||||
|
||||
# %v - Node.js version.
|
||||
zstyle ':prezto:module:node:info:version' format 'version:%v'
|
||||
|
||||
Then add `$node_info[version]` to either `$PROMPT` or `$RPROMPT` and call
|
||||
`node-info` in `prompt_name_preexec` hook function.
|
||||
|
||||
Authors
|
||||
-------
|
||||
|
||||
*The authors of this module should be contacted via the [issue tracker][4].*
|
||||
|
||||
- [Sorin Ionescu](https://github.com/sorin-ionescu)
|
||||
- [Zeh Rizzatti](https://github.com/zehrizzatti)
|
||||
|
||||
[1]: http://nodejs.org
|
||||
[2]: http://npmjs.org
|
||||
[3]: http://nodejs.org/api
|
||||
[4]: https://github.com/sorin-ionescu/prezto/issues
|
||||
[5]: https://github.com/creationix/nvm
|
||||
|
@ -1,35 +0,0 @@
|
||||
OSX
|
||||
===
|
||||
|
||||
Defines [Mac OS X][1] aliases and functions.
|
||||
|
||||
Aliases
|
||||
-------
|
||||
|
||||
- `cdf` changes the current working director to the current _Finder_
|
||||
directory.
|
||||
- `pushdf` pushes the current working directory onto the directory queue and
|
||||
- `ql` quick looks at files.
|
||||
- `rm-osx-cruft` deletes .DS\_Store, \_\_MACOSX cruft.
|
||||
|
||||
Functions
|
||||
---------
|
||||
|
||||
- `manb` opens _man_ pages in [_Bwana.app_][2].
|
||||
- `manp` opens _man_ pages in _Preview.app_.
|
||||
- `pfd` prints the current _Finder_ directory.
|
||||
- `pfs` prints the current _Finder_ selection.
|
||||
- `tab` creates a new tab (works in both _Terminal_ and [_iTerm_][3]).
|
||||
|
||||
Authors
|
||||
-------
|
||||
|
||||
*The authors of this module should be contacted via the [issue tracker][4].*
|
||||
|
||||
- [Sorin Ionescu](https://github.com/sorin-ionescu)
|
||||
|
||||
[1]: http://www.apple.com/macosx/
|
||||
[2]: http://bruji.com/bwana/
|
||||
[3]: http://www.iterm2.com/
|
||||
[4]: https://github.com/sorin-ionescu/prezto/issues
|
||||
|
@ -1,66 +0,0 @@
|
||||
Pacman
|
||||
======
|
||||
|
||||
Provides aliases and functions for the [Pacman][1] package manager and
|
||||
frontends.
|
||||
|
||||
Settings
|
||||
--------
|
||||
|
||||
To enable a Pacman frontend, for example, [Yaourt][2], add the following line to
|
||||
*zpreztorc*:
|
||||
|
||||
zstyle ':prezto:module:pacman' frontend 'yaourt'
|
||||
|
||||
If you have enabled color globally in *zpreztorc*, you may disable it for certain
|
||||
commands.
|
||||
|
||||
To disable `yaourt` highlighting, add the following line to *zpreztorc*:
|
||||
|
||||
zstyle ':prezto:module:pacman:yaourt' color 'no'
|
||||
|
||||
Aliases
|
||||
-------
|
||||
|
||||
### Pacman
|
||||
|
||||
- `pac` is short for `pacman`.
|
||||
- `paci` installs packages from repositories.
|
||||
- `pacI` installs packages from files.
|
||||
- `pacx` removes packages and unneeded dependencies.
|
||||
- `pacX` removes packages, their configuration, and unneeded dependencies.
|
||||
- `pacq` displays information about a package from the repositories.
|
||||
- `pacQ` displays information about a package from the local database.
|
||||
- `pacs` searches for packages in the repositories.
|
||||
- `pacS` searches for packages in the local database.
|
||||
- `pacu` synchronizes the local package and Arch Build System (requires `abs`)
|
||||
databases against the repositories.
|
||||
- `pacU` synchronizes the local package database against the repositories then
|
||||
upgrades outdated packages.
|
||||
- `pacman-list-orphans` lists orphan packages.
|
||||
- `pacman-remove-orphans` removes orphan packages.
|
||||
|
||||
### Frontends
|
||||
|
||||
#### Yaourt
|
||||
|
||||
- `pacc` manages *.pac\** files.
|
||||
|
||||
Functions
|
||||
---------
|
||||
|
||||
- `pacman-list-explicit` lists explicitly installed pacman packages.
|
||||
- `pacman-list-disowned` lists pacman disowned files.
|
||||
|
||||
Authors
|
||||
-------
|
||||
|
||||
*The authors of this module should be contacted via the [issue tracker][3].*
|
||||
|
||||
- [Benjamin Boudreau](https://github.com/dreur)
|
||||
- [Sorin Ionescu](https://github.com/sorin-ionescu)
|
||||
|
||||
[1]: http://www.archlinux.org/pacman/
|
||||
[2]: http://archlinux.fr/yaourt-en
|
||||
[3]: https://github.com/sorin-ionescu/prezto/issues
|
||||
|
@ -1,64 +0,0 @@
|
||||
Perl
|
||||
====
|
||||
|
||||
Enables local [Perl][1] module installation on Mac OS X and defines alises.
|
||||
|
||||
Local Module Installation
|
||||
-------------------------
|
||||
|
||||
Perl versions older than 5.14 do not support the local installation of Perl
|
||||
modules natively. This module allows for local installation of Perl modules on
|
||||
Mac OS X in *~/Library/Perl/5.12* by altering the environment.
|
||||
|
||||
### Usage
|
||||
|
||||
For Perl versions older than 5.14, install *local::lib*.
|
||||
|
||||
curl -L -C - -O http://search.cpan.org/CPAN/authors/id/A/AP/APEIRON/local-lib-1.008004.tar.gz
|
||||
tar xvf local-lib-1.008004.tar.gz
|
||||
cd local-lib-1.008004
|
||||
perl Makefile.PL --bootstrap=$HOME/Library/Perl/5.12
|
||||
make && make test && make install
|
||||
|
||||
Install *cpanminus*:
|
||||
|
||||
curl -L http://cpanmin.us | perl - --self-upgrade
|
||||
|
||||
Perlbrew
|
||||
--------
|
||||
|
||||
An alternative to the above is to use [Perlbrew][2], which allows for the
|
||||
management of multiple, isolated Perl installations in the home directory.
|
||||
|
||||
Aliases
|
||||
-------
|
||||
|
||||
### General
|
||||
|
||||
- `pl` is short for `perl`.
|
||||
- `pld` looks up Perl documentation (`perldoc`).
|
||||
- `ple` executes a one line program in a loop (`perl -wlne`).
|
||||
|
||||
### Perlbrew
|
||||
|
||||
- `plb` manages Perl environments.
|
||||
- `plba` lists available Perl versions.
|
||||
- `plbi` installs a Perl version.
|
||||
- `plbl` lists installed Perl versions.
|
||||
- `plbo` temporarily turns off Perlbrew.
|
||||
- `plbO` turns off Perlbrew.
|
||||
- `plbs` switches to a Perl version.
|
||||
- `plbu` uninstalls a Perl version.
|
||||
- `plbx` temporarily sets the Perl version to use.
|
||||
|
||||
Authors
|
||||
-------
|
||||
|
||||
*The authors of this module should be contacted via the [issue tracker][3].*
|
||||
|
||||
- [Sorin Ionescu](https://github.com/sorin-ionescu)
|
||||
|
||||
[1]: http://www.perl.org
|
||||
[2]: http://perlbrew.pl
|
||||
[3]: https://github.com/sorin-ionescu/prezto/issues
|
||||
|
@ -1,112 +0,0 @@
|
||||
Prompt
|
||||
======
|
||||
|
||||
Loads prompt [themes][1].
|
||||
|
||||
Settings
|
||||
--------
|
||||
|
||||
To select a prompt theme, add the following to *zpreztorc*, and replace **name**
|
||||
with the name of the theme you wish to load. Setting it to **random** will load
|
||||
a random theme.
|
||||
|
||||
zstyle ':prezto:module:prompt' theme 'name'
|
||||
|
||||
Theming
|
||||
-------
|
||||
|
||||
A prompt theme is an autoloadable function file with a special name,
|
||||
`prompt_name_setup`, placed anywhere in `$fpath`, but for the purpose of this
|
||||
project, themes **should** be placed in the *modules/prompt/functions*
|
||||
directory.
|
||||
|
||||
### Theme Functions
|
||||
|
||||
There are three theme functions, a setup function, a help function, and
|
||||
a preview function. The setup function **must** always be defined. The help
|
||||
function and the preview functions are optional.
|
||||
|
||||
#### prompt_name_setup
|
||||
|
||||
This function is called by the `prompt` function to install the theme. This
|
||||
function may define other functions as necessary to maintain the prompt,
|
||||
including a function that displays help or a function used to preview it.
|
||||
|
||||
**Do not call this function directly.**
|
||||
|
||||
The most basic example of this function can be seen below.
|
||||
|
||||
function prompt_name_setup {
|
||||
PROMPT='%m%# '
|
||||
RPROMPT=''
|
||||
}
|
||||
|
||||
#### prompt_name_help
|
||||
|
||||
If the `prompt_name_setup` function is customizable via parameters, a help
|
||||
function **should** be defined. The user will access it via `prompt -h name`.
|
||||
|
||||
The most basic example of this function can be seen bellow.
|
||||
|
||||
function prompt_name_help {
|
||||
cat <<EOH
|
||||
This prompt is color-scheme-able. You can invoke it thus:
|
||||
|
||||
prompt theme [<color1>] [<color2>]
|
||||
|
||||
where the color is for the left-hand prompt.
|
||||
EOH
|
||||
}
|
||||
|
||||
#### prompt_name_preview
|
||||
|
||||
If the `prompt_name_setup` function is customizable via parameters, a preview
|
||||
function **should** be defined. The user will access it via `prompt -p name`.
|
||||
|
||||
The most basic example of this function can be seen bellow.
|
||||
|
||||
function prompt_name_preview {
|
||||
if (( $# > 0 )); then
|
||||
prompt_preview_theme theme "$@"
|
||||
else
|
||||
prompt_preview_theme theme red green blue
|
||||
print
|
||||
prompt_preview_theme theme yellow magenta black
|
||||
fi
|
||||
}
|
||||
|
||||
### Hook Functions
|
||||
|
||||
There are many Zsh [hook][2] functions, but mostly the *precmd* hook will be
|
||||
used.
|
||||
|
||||
#### prompt_name_precmd
|
||||
|
||||
This hook is called before the prompt is displayed and is useful for getting
|
||||
information to display in a prompt.
|
||||
|
||||
When calling functions to get information to display in a prompt, do not assume
|
||||
that all the dependencies have been loaded. Always check for the availability of
|
||||
a function before you calling it.
|
||||
|
||||
**Do not register hook functions. They will be registered by the `prompt` function.**
|
||||
|
||||
The most basic example of this function can be seen bellow.
|
||||
|
||||
function prompt_name_precmd {
|
||||
if (( $+functions[git-info] )); then
|
||||
git-info
|
||||
fi
|
||||
}
|
||||
|
||||
Authors
|
||||
-------
|
||||
|
||||
*The authors of this module should be contacted via the [issue tracker][3].*
|
||||
|
||||
- [Sorin Ionescu](https://github.com/sorin-ionescu)
|
||||
|
||||
[1]: http://zsh.sourceforge.net/Doc/Release/User-Contributions.html#Prompt-Themes
|
||||
[2]: http://zsh.sourceforge.net/Doc/Release/Functions.html#Hook-Functions
|
||||
[3]: https://github.com/sorin-ionescu/prezto/issues
|
||||
|
@ -1,100 +0,0 @@
|
||||
Python
|
||||
======
|
||||
|
||||
Enables local Python and local Python package installation.
|
||||
|
||||
Local Python Installation
|
||||
-------------------------
|
||||
|
||||
[pyenv][4] builds and installs multiple Python versions locally in the home
|
||||
directory.
|
||||
|
||||
This module prepends the pyenv directory to the path variable to enable the
|
||||
execution of `pyenv`.
|
||||
|
||||
### Usage
|
||||
|
||||
Install Python versions with `pyenv install` into *~/.pyenv/versions*.
|
||||
|
||||
Local Package Installation
|
||||
--------------------------
|
||||
|
||||
Since version 2.6, Python supports per user package installation, as defined in
|
||||
[PEP 370][1].
|
||||
|
||||
This module prepends per user site directories to the relevant path variables
|
||||
to enable the execution of user installed scripts and the reading of
|
||||
documentation.
|
||||
|
||||
### Usage
|
||||
|
||||
Install packages into the per user site directory with `easy_install --user` or
|
||||
`pip install --user`.
|
||||
|
||||
virtualenvwrapper
|
||||
-----------------
|
||||
|
||||
[virtualenvwrapper][2] is a frontend to the popular [virtualenv][3] utility.
|
||||
|
||||
virtualenv creates isolated Python environments and virtualenvwrapper provides
|
||||
convenient shell functions to create, switch, and manage them.
|
||||
|
||||
### Usage
|
||||
|
||||
Install virtualenvwrapper.
|
||||
|
||||
Virtual environments are stored in *~/.virtualenvs*.
|
||||
|
||||
There are configuration variables that have to be set to enable certain features.
|
||||
If you wish to use these features, export the variables in *~/.zshenv*
|
||||
|
||||
The variable `$PROJECT_HOME` tells virtualenvwrapper where to place project
|
||||
working directories. It must be set and the directory created before `mkproject`
|
||||
is used. Replace *Developer* with your projects directory.
|
||||
|
||||
export PROJECT_HOME="$HOME/Developer"
|
||||
|
||||
The variable `$VIRTUALENVWRAPPER_VIRTUALENV_ARGS` tells virtualenvwrapper what
|
||||
arguments to pass to `virtualenv`. For example, set the value to
|
||||
*--no-site-packages* to ensure that all new environments are isolated from the
|
||||
system site-packages directory.
|
||||
|
||||
export VIRTUALENVWRAPPER_VIRTUALENV_ARGS='--no-site-packages'
|
||||
|
||||
Aliases
|
||||
-------
|
||||
|
||||
- `py` is short for `python`.
|
||||
|
||||
Functions
|
||||
---------
|
||||
|
||||
- `python-info` exposes information about the Python environment via the
|
||||
`$python_info` associative array.
|
||||
|
||||
Theming
|
||||
-------
|
||||
|
||||
To display the name of the current virtual enviroment in a prompt, define the
|
||||
following style in the `prompt_name_setup` function.
|
||||
|
||||
# %v - virtualenv name.
|
||||
zstyle ':prezto:module:python:info:virtualenv' format 'virtualenv:%v'
|
||||
|
||||
Then add `$python_info[virtualenv]` to `$PROMPT` or `$RPROMPT` and call
|
||||
`python-info` in the `prompt_name_preexec` hook function.
|
||||
|
||||
Authors
|
||||
-------
|
||||
|
||||
*The authors of this module should be contacted via the [issue tracker][5].*
|
||||
|
||||
- [Sorin Ionescu](https://github.com/sorin-ionescu)
|
||||
- [Sebastian Wiesner](https://github.com/lunaryorn)
|
||||
|
||||
[1]: http://www.python.org/dev/peps/pep-0370/
|
||||
[2]: http://www.doughellmann.com/projects/virtualenvwrapper/
|
||||
[3]: http://pypi.python.org/pypi/virtualenv
|
||||
[4]: https://github.com/yyuu/pyenv
|
||||
[5]: https://github.com/sorin-ionescu/prezto/issues
|
||||
|
@ -1,35 +0,0 @@
|
||||
Ruby on Rails
|
||||
=============
|
||||
|
||||
Defines [Ruby on Rails][1] aliases.
|
||||
|
||||
Aliases
|
||||
-------
|
||||
|
||||
- `ror` is short for `rails`.
|
||||
- `rorc` starts the Rails console.
|
||||
- `rordc` starts the Rails console connected to the database.
|
||||
- `rordm` migrates the database.
|
||||
- `rordM` migrates the database and recreates the test database.
|
||||
- `rordr` rolls the database schema back to the previous version.
|
||||
- `rorg` generates new code.
|
||||
- `rorl` displays the log.
|
||||
- `rorlc` truncates logs to zero bytes.
|
||||
- `rorp` installs a plugin.
|
||||
- `rorr` runs code in the application environment.
|
||||
- `rors` starts the Rails server.
|
||||
- `rorsd` starts the Rails server with the debugger.
|
||||
- `rorx` destroys newly generated code.
|
||||
|
||||
Authors
|
||||
-------
|
||||
|
||||
*The authors of this module should be contacted via the [issue tracker][2].*
|
||||
|
||||
- [Robby Russell](https://github.com/robbyrussell)
|
||||
- [Jake Bell](https://github.com/theunraveler)
|
||||
- [Sorin Ionescu](https://github.com/sorin-ionescu)
|
||||
|
||||
[1]: http://rubyonrails.org
|
||||
[2]: https://github.com/sorin-ionescu/prezto/issues
|
||||
|
@ -1,28 +0,0 @@
|
||||
Rsync
|
||||
=====
|
||||
|
||||
Defines [rsync][1] aliases.
|
||||
|
||||
Mac OS X users are encouraged to use [Bombich's rsync][2], which has HFS+
|
||||
enhancements.
|
||||
|
||||
Aliases
|
||||
-------
|
||||
|
||||
- `rsync-copy` copies files and directories from *source* to *destination*.
|
||||
- `rsync-move` moves files and directories from *source* to *destination*.
|
||||
- `rsync-update` updates files and directories on *destination*.
|
||||
- `rsync-synchronize` synchronizes files and directories between *source* and
|
||||
*destination*.
|
||||
|
||||
Authors
|
||||
-------
|
||||
|
||||
*The authors of this module should be contacted via the [issue tracker][3].*
|
||||
|
||||
- [Sorin Ionescu](https://github.com/sorin-ionescu)
|
||||
|
||||
[1]: http://rsync.samba.org
|
||||
[2]: http://help.bombich.com/kb/overview/credits#opensource
|
||||
[3]: https://github.com/sorin-ionescu/prezto/issues
|
||||
|
@ -1,90 +0,0 @@
|
||||
Ruby
|
||||
====
|
||||
|
||||
Configures [Ruby][1] local gem installation, loads version managers, and defines
|
||||
aliases.
|
||||
|
||||
Local Gem Installation
|
||||
----------------------
|
||||
|
||||
When a Ruby version manager is not detected, local gems are installed in
|
||||
*~/Library/Ruby/Gems/1.8* on Mac OS X.
|
||||
|
||||
RVM
|
||||
---
|
||||
|
||||
An alternative to the above is to use [The Ruby Version Manager (RVM)][2], which
|
||||
allows for managing multiple, isolated Ruby installations and gem sets in the
|
||||
home directory.
|
||||
|
||||
Since RVM is loaded into the shell and is known to override shell commands, it
|
||||
may conflict with shell scripts.
|
||||
|
||||
rbenv
|
||||
-----
|
||||
|
||||
An alternative RVM is to use [rbenv][3], which allows for switching between multiple,
|
||||
isolated Ruby installations in the home directory.
|
||||
|
||||
While it is not as feature rich as RVM, it is not loaded into the shell and is
|
||||
not known to cause conflicts with shell scripts.
|
||||
|
||||
Bundler
|
||||
-------
|
||||
|
||||
Manage gems that are not meant to be used as commands, such as application
|
||||
dependencies, with [Bundler][4].
|
||||
|
||||
Aliases
|
||||
-------
|
||||
|
||||
### General
|
||||
|
||||
- `rb` is short for `ruby`.
|
||||
|
||||
### Bundler
|
||||
|
||||
- `rbb` manages ruby dependencies (`bundle`).
|
||||
- `rbbe` executes a script in the context of the current bundle.
|
||||
- `rbbi` installs the gems specified in the *Gemfile* in *vendor/bundle*.
|
||||
- `rbbI` installs the following:
|
||||
- gems specified in the *Gemfile* in *vendor/bundle*.
|
||||
- packages the gems into *vendor/cache*.
|
||||
- appends bundler directories to *.gitignore*.
|
||||
- `rbbl` lists all gems in the current bundle.
|
||||
- `rbbo` opens an installed gem in the editor.
|
||||
- `rbbp` packages gem files into *vendor/cache*.
|
||||
- `rbbu` updates gems to their latest version.
|
||||
|
||||
Functions
|
||||
---------
|
||||
|
||||
- `ruby-app-root` displays the path to the Ruby application root directory.
|
||||
- `ruby-info` exposes information about the Ruby environment via the
|
||||
`$ruby_info` associative array.
|
||||
|
||||
Theming
|
||||
-------
|
||||
|
||||
To display the name of the current Ruby version in a prompt, define the
|
||||
following style in the `prompt_name_setup` function.
|
||||
|
||||
# %v - ruby version.
|
||||
zstyle ':prezto:module:ruby:info:version' format 'version:%v'
|
||||
|
||||
Then add `$ruby_info[version]` to `$PROMPT` or `$RPROMPT` and call
|
||||
`ruby-info` in the `prompt_name_preexec` hook function.
|
||||
|
||||
Authors
|
||||
-------
|
||||
|
||||
*The authors of this module should be contacted via the [issue tracker][5].*
|
||||
|
||||
- [Sorin Ionescu](https://github.com/sorin-ionescu)
|
||||
|
||||
[1]: http://www.ruby-lang.org
|
||||
[2]: https://rvm.io
|
||||
[3]: https://github.com/sstephenson/rbenv
|
||||
[4]: http://gembundler.com
|
||||
[5]: https://github.com/sorin-ionescu/prezto/issues
|
||||
|
@ -1,41 +0,0 @@
|
||||
GNU Screen
|
||||
==========
|
||||
|
||||
Defines [GNU Screen][1] aliases and provides for auto launching it at start-up.
|
||||
|
||||
Settings
|
||||
--------
|
||||
|
||||
### Auto-Start
|
||||
|
||||
Starts a GNU Screen session automatically when Zsh is launched.
|
||||
|
||||
To enable this feature when launching Zsh in a local terminal, add the
|
||||
following line to *zpreztorc*:
|
||||
|
||||
zstyle ':prezto:module:screen:auto-start' local 'yes'
|
||||
|
||||
To enable this feature when launching Zsh in a SSH connection, add the
|
||||
following line to *zpreztorc*:
|
||||
|
||||
zstyle ':prezto:module:screen:auto-start' remote 'yes'
|
||||
|
||||
Aliases
|
||||
-------
|
||||
|
||||
- `scr` is short for `screen`.
|
||||
- `scrl` lists sessions/socket directory.
|
||||
- `scrn` starts a new session.
|
||||
- `scrr` attaches to a session if one exists or start a new one.
|
||||
|
||||
Authors
|
||||
-------
|
||||
|
||||
*The authors of this module should be contacted via the [issue tracker][2].*
|
||||
|
||||
- [Sorin Ionescu](https://github.com/sorin-ionescu)
|
||||
- [Georges Discry](https://github.com/gdiscry)
|
||||
|
||||
[1]: http://www.gnu.org/software/screen/
|
||||
[2]: https://github.com/sorin-ionescu/prezto/issues
|
||||
|
@ -1,92 +0,0 @@
|
||||
Spectrum
|
||||
========
|
||||
|
||||
Provides for easier use of 256 colors and effects.
|
||||
|
||||
To learn more about text formatting, read [That 256 Color Thing][1].
|
||||
|
||||
Variables
|
||||
---------
|
||||
|
||||
- `BG` provides background colors.
|
||||
- `FG` provides foreground colors.
|
||||
- `FX` provides effects.
|
||||
|
||||
### Background and Foreground
|
||||
|
||||
Terminals support 8, 16, 88, and 256 colors. Check if a terminal supports 256
|
||||
colors with `tput colors` before use.
|
||||
|
||||
The following colors are supported.
|
||||
|
||||
- 0 to 255
|
||||
- black
|
||||
- red
|
||||
- green
|
||||
- yellow
|
||||
- blue
|
||||
- magenta
|
||||
- cyan
|
||||
- white
|
||||
|
||||
### Effects
|
||||
|
||||
Though there are many effects, most terminals support at least bold formatting.
|
||||
|
||||
**Not all effects work on all terminals; use them sparingly.**
|
||||
|
||||
| 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 |
|
||||
|
||||
### Plain Text
|
||||
|
||||
Use `$BG[none]`, `$FG[none]`, or `$FX[none]` to turn off formatting.
|
||||
|
||||
Authors
|
||||
-------
|
||||
|
||||
*The authors of this module should be contacted via the [issue tracker][2].*
|
||||
|
||||
- [P.C. Shyamshankar](https://github.com/sykora)
|
||||
- [Sorin Ionescu](https://github.com/sorin-ionescu)
|
||||
|
||||
[1]: http://lucentbeing.com/blog/that-256-color-thing/
|
||||
[2]: https://github.com/sorin-ionescu/prezto/issues
|
||||
|
@ -1,28 +0,0 @@
|
||||
SSH
|
||||
===
|
||||
|
||||
Provides for an easier use of [SSH][1] by setting up [ssh-agent][2].
|
||||
|
||||
This module is disabled on Mac OS X due to custom Apple SSH support rendering it
|
||||
unnecessary.
|
||||
|
||||
Settings
|
||||
--------
|
||||
|
||||
### Identities
|
||||
|
||||
To load multiple identities, add the following line to *zpreztorc*:
|
||||
|
||||
zstyle ':prezto:module:ssh:load' identities 'id_rsa' 'id_dsa' 'id_github'
|
||||
|
||||
Authors
|
||||
-------
|
||||
|
||||
*The authors of this module should be contacted via the [issue tracker][3].*
|
||||
|
||||
- [Sorin Ionescu](https://github.com/sorin-ionescu)
|
||||
|
||||
[1]: http://www.openssh.com
|
||||
[2]: http://www.openbsd.org/cgi-bin/man.cgi?query=ssh-agent&sektion=1
|
||||
[3]: https://github.com/sorin-ionescu/prezto/issues
|
||||
|
@ -1,63 +0,0 @@
|
||||
Syntax Highlighting
|
||||
===================
|
||||
|
||||
Integrates [zsh-syntax-highlighting][1] into Prezto.
|
||||
|
||||
This module should be loaded *second to last*, where last is the *prompt*
|
||||
module, unless used in conjuncture with the *history-substring-search* module
|
||||
where it must be loaded **before** it.
|
||||
|
||||
Contributors
|
||||
------------
|
||||
|
||||
New features and bug fixes should be submitted to the
|
||||
[zsh-syntax-highlighting][1] project according to its rules and regulations.
|
||||
This module will be synchronized against it.
|
||||
|
||||
Settings
|
||||
--------
|
||||
|
||||
### Highlighting
|
||||
|
||||
To enable highlighting for this module only, add the following line to
|
||||
*zpreztorc*:
|
||||
|
||||
zstyle ':prezto:module:syntax-highlighting' color 'yes'
|
||||
|
||||
### Highlighters
|
||||
|
||||
Syntax highlighting is accomplished by pluggable [highlighters][2]. This module
|
||||
enables the *main*, *brackets*, and *cursor* highlighters by default.
|
||||
|
||||
To enable all highlighters, add the following to *zpreztorc*:
|
||||
|
||||
zstyle ':prezto:module:syntax-highlighting' highlighters \
|
||||
'main' \
|
||||
'brackets' \
|
||||
'pattern' \
|
||||
'cursor' \
|
||||
'root'
|
||||
|
||||
### Highlighting Styles
|
||||
|
||||
Each syntax highlighter defines styles used to highlight tokens.
|
||||
|
||||
To highlight, for example, builtins, commands, and functions in blue instead of
|
||||
green, add the following to *zpreztorc*:
|
||||
|
||||
zstyle ':prezto:module:syntax-highlighting' styles \
|
||||
'builtin' 'bg=blue' \
|
||||
'command' 'bg=blue' \
|
||||
'function' 'bg=blue'
|
||||
|
||||
Authors
|
||||
-------
|
||||
|
||||
*The authors of this module should be contacted via the [issue tracker][3].*
|
||||
|
||||
- [Sorin Ionescu](https://github.com/sorin-ionescu)
|
||||
|
||||
[1]: https://github.com/zsh-users/zsh-syntax-highlighting
|
||||
[2]: https://github.com/zsh-users/zsh-syntax-highlighting/tree/master/highlighters
|
||||
[3]: https://github.com/sorin-ionescu/prezto/issues
|
||||
|
@ -1,45 +0,0 @@
|
||||
Terminal
|
||||
========
|
||||
|
||||
Sets terminal window and tab titles.
|
||||
|
||||
Settings
|
||||
--------
|
||||
|
||||
### Auto-Title
|
||||
|
||||
To auto set the terminal window and tab titles with the current command or
|
||||
directory, add the following to *zpreztorc*:
|
||||
|
||||
zstyle ':prezto:module:terminal' auto-title 'yes'
|
||||
|
||||
Auto titling is disabled inside terminal multiplexers, except inside dvtm, since
|
||||
it interferes with window names defined in configuration files and profile
|
||||
managers.
|
||||
|
||||
To format terminal window and tab titles, add the following to *zpreztorc*:
|
||||
|
||||
zstyle ':prezto:module:terminal:window-title' format '%n@%m: %s'
|
||||
zstyle ':prezto:module:terminal:tab-title' format '%m: %s'
|
||||
|
||||
`%s` will be replaced with the current working directory path or the currently
|
||||
executing program name.
|
||||
|
||||
For a list of sequences, see [Expansion of Prompt Sequences][1].
|
||||
|
||||
Functions
|
||||
---------
|
||||
|
||||
- `set-tab-title` sets the terminal tab title.
|
||||
- `set-window-title` sets the terminal or terminal multiplexer window title.
|
||||
|
||||
Authors
|
||||
-------
|
||||
|
||||
*The authors of this module should be contacted via the [issue tracker][2].*
|
||||
|
||||
- [Sorin Ionescu](https://github.com/sorin-ionescu)
|
||||
|
||||
[1]: http://zsh.sourceforge.net/Doc/Release/Prompt-Expansion.html#Expansion-of-Prompt-Sequences
|
||||
[2]: https://github.com/sorin-ionescu/prezto/issues
|
||||
|
@ -1,63 +0,0 @@
|
||||
Tmux
|
||||
====
|
||||
|
||||
Defines [tmux][1] aliases and provides for auto launching it at start-up.
|
||||
|
||||
Settings
|
||||
--------
|
||||
|
||||
### Auto-Start
|
||||
|
||||
Starts a tmux session automatically when Zsh is launched.
|
||||
|
||||
To enable this feature when launching Zsh in a local terminal, add the
|
||||
following line to *zpreztorc*:
|
||||
|
||||
zstyle ':prezto:module:tmux:auto-start' local 'yes'
|
||||
|
||||
To enable this feature when launching Zsh in a SSH connection, add the
|
||||
following line to *zpreztorc*:
|
||||
|
||||
zstyle ':prezto:module:tmux:auto-start' remote 'yes'
|
||||
|
||||
In both cases, it will create a background session named _#Prezto_ and attach
|
||||
every new shell to it.
|
||||
|
||||
To avoid keeping open sessions, this module sets `destroy-unattached off` on
|
||||
the background session and `destroy-unattached on` on every other session
|
||||
(global setting).
|
||||
|
||||
Aliases
|
||||
-------
|
||||
|
||||
- `tmuxa` attaches or switches to a tmux session.
|
||||
- `tmuxl` lists sessions managed by the tmux server.
|
||||
|
||||
Caveats
|
||||
-------
|
||||
|
||||
On Mac OS X, launching tmux can cause the error **launch_msg(...): Socket is not
|
||||
connected** to be displayed, which can be fixed by installing
|
||||
[reattach-to-user-namespace][3], available in [Homebrew][4], and adding the
|
||||
following to *tmux.conf*:
|
||||
|
||||
set-option -g default-command "reattach-to-user-namespace -l $SHELL -l"
|
||||
|
||||
Furthermore, tmux is known to cause **kernel panics** on Mac OS X. A discussion
|
||||
about this and Prezto has already been [opened][2].
|
||||
|
||||
Authors
|
||||
-------
|
||||
|
||||
*The authors of this module should be contacted via the [issue tracker][5].*
|
||||
|
||||
- [Sorin Ionescu](https://github.com/sorin-ionescu)
|
||||
- [Colin Hebert](https://github.com/ColinHebert)
|
||||
- [Georges Discry](https://github.com/gdiscry)
|
||||
|
||||
[1]: http://tmux.sourceforge.net
|
||||
[2]: https://github.com/sorin-ionescu/prezto/issues/62
|
||||
[3]: https://github.com/ChrisJohnsen/tmux-MacOSX-pasteboard
|
||||
[4]: https://github.com/mxcl/homebrew
|
||||
[5]: https://github.com/sorin-ionescu/prezto/issues
|
||||
|
@ -1,158 +0,0 @@
|
||||
Utility
|
||||
=======
|
||||
|
||||
Defines general aliases and functions.
|
||||
|
||||
Settings
|
||||
--------
|
||||
|
||||
### Highlighting
|
||||
|
||||
If you have enabled color globally in *zpreztorc*, you may disable it for certain
|
||||
commands.
|
||||
|
||||
To disable `ls` color, add the following line to *zpreztorc*; when coloring is
|
||||
disabled, type indicators (\*, /, =>, @, =, |, %) will be appended to entries.
|
||||
|
||||
zstyle ':prezto:module:utility:ls' color 'no'
|
||||
|
||||
To disable `diff` highlighting, add the following line to *zpreztorc*:
|
||||
|
||||
zstyle ':prezto:module:utility:diff' color 'no'
|
||||
|
||||
To disable `wdiff` highlighting, add the following line to *zpreztorc*:
|
||||
|
||||
zstyle ':prezto:module:utility:wdiff' color 'no'
|
||||
|
||||
To disable `make` highlighting, add the following line to *zpreztorc*:
|
||||
|
||||
zstyle ':prezto:module:utility:make' color 'no'
|
||||
|
||||
Aliases
|
||||
-------
|
||||
|
||||
### Disabled Spelling Correction
|
||||
|
||||
- `ack`
|
||||
- `cd`
|
||||
- `cp`
|
||||
- `ebuild`
|
||||
- `gcc`
|
||||
- `gist`
|
||||
- `grep`
|
||||
- `heroku`
|
||||
- `ln`
|
||||
- `man`
|
||||
- `mkdir`
|
||||
- `mv`
|
||||
- `mysql`
|
||||
- `rm`
|
||||
|
||||
### Disabled File Globbing
|
||||
|
||||
- `fc`
|
||||
- `find`
|
||||
- `ftp`
|
||||
- `history`
|
||||
- `locate`
|
||||
- `rake`
|
||||
- `rsync`
|
||||
- `scp`
|
||||
- `sftp`
|
||||
|
||||
### General
|
||||
|
||||
- `_` executes a command as another user (`sudo`).
|
||||
- `b` opens the default web browser.
|
||||
- `cp` copies files and directories interactively.
|
||||
- `e` opens the default editor.
|
||||
- `ln` links files and directories interactively.
|
||||
- `mkdir` creates directories, including intermediary directories.
|
||||
- `mv` moves files and directories interactively.
|
||||
- `p` opens the default pager.
|
||||
- `po` removes a directory from the stack and changes to it (`popd`).
|
||||
- `pu` changes the directory and pushes the old directory onto the stack
|
||||
(`pushd`).
|
||||
- `rm` removes files and directories interactively.
|
||||
- `type` displays all the attribute values of a shell parameter.
|
||||
|
||||
### Files and Directories
|
||||
|
||||
- `ls` lists with directories grouped first (GNU only).
|
||||
- `l` lists in one column, hidden files.
|
||||
- `ll` lists human readable sizes.
|
||||
- `lr` lists human readable sizes, recursively.
|
||||
- `la` lists human readable sizes, hidden files.
|
||||
- `lm` lists human readable sizes, hidden files through pager.
|
||||
- `lx` lists sorted by extension (GNU only).
|
||||
- `lk` lists sorted by size, largest last.
|
||||
- `lt` lists sorted by date, most recent last.
|
||||
- `lc` lists sorted by date, most recent last, shows change time.
|
||||
- `lu` lists sorted by date, most recent last, shows access time.
|
||||
- `sl` lists directory contents (`ls`).
|
||||
|
||||
### Mac OS X Everywhere
|
||||
|
||||
- `o` opens files and directories (`open` or `xdg-open`).
|
||||
- `get` downloads files (`curl` or `wget`).
|
||||
- `pbcopy` copies to the pasteboard (`pbcopy`, `xclip` or `xsel`).
|
||||
- `pbpaste` pastes from the pasteboard (`pbcopy`, `xclip` or `xsel`).
|
||||
- `pbc` copies to the pasteboard (`pbcopy`).
|
||||
- `pbp` pastes from the pasteboard (`pbpaste`).
|
||||
|
||||
### Resource Usage
|
||||
|
||||
- `df` displays free disk space using human readable units.
|
||||
- `du` displays disk usage using human readable units.
|
||||
- `top` displays information about processes (aliased to `htop`, if installed).
|
||||
- `topc` displays information about processes sorted by CPU usage (`htop` not
|
||||
installed).
|
||||
- `topm` displays information about processes sorted by RAM usage (`htop` not
|
||||
installed).
|
||||
|
||||
### Miscellaneous
|
||||
|
||||
- `http-serve` serves a directory via HTTP.
|
||||
|
||||
Functions
|
||||
---------
|
||||
|
||||
### General
|
||||
|
||||
- `slit` prints columns *1, 2, 3 ... n*.
|
||||
|
||||
### Files and Directories
|
||||
|
||||
- `cdls` changes to a directory and lists its contents.
|
||||
- `dut` displays the grand total disk usage using human readable units.
|
||||
- `find-exec` finds files and executes a command on them.
|
||||
- `mkdcd` makes a directory and changes to it.
|
||||
- `popdls` pops an entry off the directory stack and lists its contents.
|
||||
- `pushdls` pushes an entry onto the directory stack and lists its contents.
|
||||
|
||||
### Developer
|
||||
|
||||
- `diff` highlights diff output (requires `colordiff` or `Git`).
|
||||
- `make` highlights make output (requires `colormake`).
|
||||
- `wdiff` highlights wdiff output (requires `wdiff `or `Git`).
|
||||
|
||||
### Resource usage
|
||||
|
||||
- `psu` displays user owned processes status.
|
||||
|
||||
### Search and Replace
|
||||
|
||||
- `prep` provides a grep-like pattern search.
|
||||
- `psub` provides a sed-like pattern substitution.
|
||||
|
||||
Authors
|
||||
-------
|
||||
|
||||
*The authors of this module should be contacted via the [issue tracker][1].*
|
||||
|
||||
- [Robby Russell](https://github.com/robbyrussell)
|
||||
- [Suraj N. Kurapati](https://github.com/sunaku)
|
||||
- [Sorin Ionescu](https://github.com/sorin-ionescu)
|
||||
|
||||
[1]: https://github.com/sorin-ionescu/prezto/issues
|
||||
|
@ -1,37 +0,0 @@
|
||||
Wake-on-LAN
|
||||
===========
|
||||
|
||||
This module provides a wrapper around the [wakeonlan][1] tool.
|
||||
|
||||
Usage
|
||||
-----
|
||||
|
||||
To use this wrapper, create the *~/.wakeonlan* 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.
|
||||
|
||||
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
|
||||
*~/.wakeonlan/leto* with the following contents:
|
||||
|
||||
00:11:22:33:44:55:66 192.168.0.255
|
||||
|
||||
To wake that device, use the following command:
|
||||
|
||||
wake leto
|
||||
|
||||
For more information on the configuration file format, read the
|
||||
[wakeonlan man page][2].
|
||||
|
||||
Authors
|
||||
-------
|
||||
|
||||
*The authors of this module should be contacted via [issue tracker][3].*
|
||||
|
||||
- [Paul Dann](https://github.com/giddie)
|
||||
- [Sorin Ionescu](https://github.com/sorin-ionescu)
|
||||
|
||||
[1]: http://gsd.di.uminho.pt/jpo/software/wakeonlan/
|
||||
[2]: http://man.cx/wakeonlan
|
||||
[3]: https://github.com/sorin-ionescu/prezto/issues
|
||||
|
@ -1,29 +0,0 @@
|
||||
Yum
|
||||
===
|
||||
|
||||
Defines [yum][1] aliases.
|
||||
|
||||
Aliases
|
||||
-------
|
||||
|
||||
- `yumc` removes package(s) and leaves.
|
||||
- `yumi` installs package(s).
|
||||
- `yumh` displays history.
|
||||
- `yuml` lists packages.
|
||||
- `yumL` lists installed packages.
|
||||
- `yumq` displays package information.
|
||||
- `yumr` removes package(s).
|
||||
- `yums` searches for a package.
|
||||
- `yumu` updates packages.
|
||||
- `yumU` upgrates packages.
|
||||
|
||||
Authors
|
||||
-------
|
||||
|
||||
*The authors of this module should be contacted via the [issue tracker][2].*
|
||||
|
||||
- [Sorin Ionescu](https://github.com/sorin-ionescu)
|
||||
|
||||
[1]: http://yum.baseurl.org
|
||||
[2]: https://github.com/sorin-ionescu/prezto/issues
|
||||
|
Reference in New Issue
Block a user