Find a file
2019-02-11 16:27:47 +01:00
aliases New xbps-query wrapper xqn, searches name only 2019-02-11 16:26:21 +01:00
compdef Fix usage in user folder instead of global 2019-02-11 16:26:21 +01:00
env Move environment variables into separate files per program/language 2019-02-11 16:27:47 +01:00
functions Add bookmark function 2019-02-11 16:27:47 +01:00
modules Add python venvs to prompt 2019-02-11 16:27:47 +01:00
widgets new repository without sensitive information 2013-03-15 08:39:43 +01:00
zplug@5336436631 Add zplug 2019-02-11 16:26:21 +01:00
.gitignore module "vcs": do not track filter dir 2016-01-05 04:25:41 +01:00
.gitmodules Add zplug 2019-02-11 16:26:21 +01:00
.zshrc add symlink zshrc to .zshrc 2019-02-11 16:27:47 +01:00
completion.zsh Clean up modules and loading 2019-02-11 16:26:21 +01:00
README.md fix readme formatting 2013-03-18 13:33:58 +01:00
zlogin Some new features 2014-06-27 07:45:18 +02:00
zplug.zsh Add zplug 2019-02-11 16:26:21 +01:00
zprofile Updates 2018-03-11 12:18:44 +01:00
zshenv Move environment variables into separate files per program/language 2019-02-11 16:27:47 +01:00
zshrc Clean up modules and loading 2019-02-11 16:26:21 +01:00

crater's zsh config

Installation:

system-wide config: Put repository contents in /etc/zsh.

user config: copy env_template to $HOME/.zshenv. Change value of $ZDOTDIR in that file to the path, where the repository resides.
Note that this file is read before any other config files, so if any variables you set in there have wrong values, they are probably overwritten in another file.

modules:

This zsh configuration is modular. A module consists of a folder in the modules/ directory, containing a script file named init and an optional depend file. More files may be included in the folder, they will be ignored by the module loader. The name of the module is the name of its directory.

The init file is executed, when a module is loaded. When and if a module is loaded is determined by its depend file and the environment variables $ZMODLOAD_ONLY and $ZMODLOAD_BLACKLIST.

$ZMODLOAD_BLACKLIST is a list of modules, that will not be loaded.

$ZMODLOAD_ONLY works as a whitelist. If it is set, only modules in this list and modules required by them will be loaded.

A depend file contains the requirements for loading a module. It should contain lines of the form <type> <module>. There are 3 types for dependencies:

  • depend <module>: <module> will be loaded before the depending module (the module whose depend file contains this rule), regardless of $ZMODLOAD_ONLY. If the module is blacklisted, it and the depending module are not loaded. Note that already queued dependencies of the depending module will be loaded anyways.

  • after <module>: <module> will be loaded before the depending module, if it would be loaded anyways. If it is either blacklisted or $ZMODLOAD_ONLY is non-empty but does not contain <module>, it is not loaded. This does not affect loading of the depending module.

  • block <module>: abort loading of the depending module, if <module> is already loaded or contained in $ZMODLOAD_ONLY.