doc/grmlzshrc.t2t

   1 GRMLZSHRC
   2
   3 May, 2009
   4
   5 %!target: man
   6 %!postproc(man): "^(\.TH.*) 1 "  "\1 5 "
   7
   8
   9 = NAME =
  10 grmlzshrc - grml's zsh setup
  11
  12
  13 = SYNOPSIS =
  14 //zsh// [**options**]...
  15
  16
  17 = DESCRIPTION =
  18 The grml project provides a fairly exhaustive interactive setup (referred to
  19 as //grmlzshrc// throughout this document) for the amazing unix shell zsh
  20 (http://zsh.sourceforge.net). This is the reference manual for that
  21 setup (which is currently vastly incomplete; patches welcome).
  22
  23 To use //grmlzshrc//, you need at least version 3.1.7 of zsh (although not all
  24 features are enabled in every version).
  25
  26 //grmlzshrc// behaves differently depending on which user loads it. For the
  27 root user (**EUID** == 0) only a subset of features is loaded by default. This
  28 behaviour can be altered by setting the **GRML_ALWAYS_LOAD_ALL** STARTUP
  29 VARIABLE (see below).
  30
  31 = STARTUP VARIABLES =
  32 Some of the behaviour of //grmlzshrc// can be altered by setting certain shell
  33 variables. These may be set temporarily when starting zsh like this:
  34 \
  35 ``` % BATTERY=1 zsh
  36
  37 Or by setting them permanently in **zshrc.pre** (See AUXILIARY FILES below).
  38
  39 : **BATTERY**
  40 If set to a value greater than zero and //acpi// installed, //grmlzshrc// will
  41 put the battery status into the right hand side interactive prompt.
  42
  43
  44 = FEATURE DESCRIPTION =
  45 This is an in depth description of non-standard features implemented by
  46 //grmlzshrc//.
  47
  48 == DIRSTACK HANDLING ==
  49
  50 == DIRECTORY BASED PROFILES ==
  51
  52 == ACCEPTLINE WRAPPER ==
  53
  54 == PROMPT ==
  55
  56 == GNU/SCREEN STATUS SETTING ==
  57
  58 == PERSISTENT HISTORY ==
  59
  60
  61 = REFERENCE =
  62 == KEYBINDINGS ==
  63
  64 == SHELL FUNCTIONS ==
  65 //grmlzshrc// comes with a wide array of defined shell functions to ease the
  66 user's life.
  67
  68 : urlencode()
  69 Takes a string as its first argument and prints it RFC 2396 URL encoded to
  70 standard out.
  71
  72
  73 = AUXILIARY FILES =
  74 This is a set of files, that - if they exist - can be used to customize the
  75 behaviour of //grmlzshrc//.
  76
  77 : .zshrc.pre
  78 Sourced at the very beginning of //grmlzshrc//. Among other things, it can
  79 be used to permantenly change //grmlzshrc//'s STARTUP VARIABLES (see above):
  80 \
  81 ```
  82 # show battery status in RPROMPT
  83 BATTERY=1
  84 # always load the complete setup, even for root
  85 GRML_ALWAYS_LOAD_ALL=1
  86 ```
  87
  88 : .zshrc.local
  89 Sourced right before loading //grmlzshrc// is finished. There is a global
  90 version of this file (/etc/zsh/zshrc.local) which is sourced before the
  91 user-specific one.
  92
  93
  94 = INSTALLATION ON NON-DEBIAN SYSTEMS =
  95
  96
  97 = CONTRIBUTING =
  98 If you want to help to improve grml's zsh setup, clone the grml-etc-core
  99 repository from git.grml.org:
 100 \
 101 ``` % git clone git://git.grml.org/grml-etc-core.git
 102
 103 Make your changes, commit them; use '**git format-patch**' to create a series
 104 of patches and send those to the following address via '**git send-email**':
 105 \
 106 ``` grml-etc-core@grml.org
 107
 108 Doing so makes sure the right people get your patches for review and
 109 possibly inclusion.
 110
 111
 112 = AUTHOR =
 113 This manpage was written by Frank Terbeck <ft@grml.org>.
 114
 115
 116 = COPYRIGHT =
 117 Copyright (c) 2009, grml project <http://grml.org>
 118
 119 This manpage is distributed under the terms of the GPL version 2.
 120
 121 Most parts of grml's zshrc are distributed under the terms of GPL v2, too,
 122 except for **accept-line()** and **vcs_info()**, which are distributed under
 123 the same conditions as zsh itself (which is BSD-like).