X-Git-Url: http://git.grml.org/?a=blobdiff_plain;f=grml-zsh-refcard.tex.in;h=389cc9a984547d12cf464df7db32312d4c5a1356;hb=2b83e07b0599541ec53104b51f9235e81c3e4189;hp=ab4d4d9171dbc7251dd3e0b139a264aebfa9fe34;hpb=62958f2709943ee15c94e80f0928fe23e36f5854;p=grml-gen-zshrefcard.git diff --git a/grml-zsh-refcard.tex.in b/grml-zsh-refcard.tex.in index ab4d4d9..389cc9a 100644 --- a/grml-zsh-refcard.tex.in +++ b/grml-zsh-refcard.tex.in @@ -128,7 +128,7 @@ %%% Unten: Links, Mitte, Rechts \ifoot[]{\vspace{-3pt}GRML-Zsh-Refcard} \cfoot[]{} - \ofoot[]{\vspace{-3pt}\copyright 2005-2008 \href{mailto:julius@grml.org}{Julius Plenz}, + \ofoot[]{\vspace{-3pt}\copyright 2005-2009 \href{mailto:julius@grml.org}{Julius Plenz}, \href{mailto:mika@grml.org}{Michael Prokop} and \href{mailto:ft@grml.org}{Frank Terbeck}} %%% }}} @@ -205,30 +205,25 @@ \subsection*{Configuration files} -\small{The global zsh configuration is located in \textbf{/etc/zsh/zshrc}. User -specific settings are defined in \textbf{/etc/skel/.zshrc} (which can be found -in \kbd{\~}/.zshrc of the user grml, as well). Please note that some -functions/aliases are not active by default for user root (referred to as -'... for user (grml)' below) for of security reasons. Simply run 'zshskel' -(as root) to source /etc/skel/.zshrc. Some aliases/functions are not activated -if the appropriate executable isn't present on your system, either. +\small{Grml's zsh configuration is located in \textbf{/etc/zsh/zshrc}. Please +note that some functions/aliases are not active by default for user root +(referred to as '... for user (grml)' below) for of security reasons. +If you want your root user to use the full setup on your box, put +\textbf{GRML\_ALWAYS\_LOAD\_ALL=1} into root's \kbd{\~}/.zshrc.pre. +Some aliases/functions are not activated if the appropriate executable +isn't present on your system, either. -/etc/zsh/zshrc: this file can be adjusted according to your needs via a file +You can adjust the grml setup globally to your systems via a file named /etc/zsh/zshrc.local, which is not under the control of Debian package -management. This, you need to place all your changes in the file -/etc/zsh/zshrc.local. If you do not have write permission to -/etc/zsh/zshrc, copy the file /etc/zsh/zshrc to \kbd{\~}/.zshrc.global -and it will be sourced by \kbd{\~}/.zshrc. +management. Put important commands which you need on a regular basis into a file named \textbf{\kbd{\~}/.important\_commands}. -Note that /etc/skel/.zshrc itself is not sourced by zsh, but copied to the -\$HOME-directory of your non-root user on user creation. To keep your -\textbf{\kbd{\~}/.zshrc} in sync with upstream's development, just put your -personal stuff into a file named \textbf{\kbd{\~}/.zshrc.local} and point your -\kbd{\~}/.zshrc to /etc/skel/.zshrc by running 'ln -s /etc/skel/.zshrc -\kbd{\~}/.zshrc'.} +You can put personal configuration for a user into a file named +\textbf{\kbd{\~}/.zshrc.local}. Changes you need to have sourced +\textbf{before} the grml zsh setup is loaded can be put into +\textbf{\kbd{\~}/.zshrc.pre}. More information regarding configuration files and some environment variables to adjust runtime behaviour of grml's zsh can be accessed by @@ -242,11 +237,15 @@ You can do this by running: \begin{tiny} \begin{verbatim} -wget -O .zshrc http://git.grml.org/f/grml-etc-core/etc/skel/.zshrc -wget -O .zshrc.global http://git.grml.org/f/grml-etc-core/etc/zsh/zshrc +wget -O .zshrc http://git.grml.org/f/grml-etc-core/etc/zsh/zshrc \end{verbatim} \end{tiny} +This is \textbf{different} from earlier versions of grml's zsh setup. +You only use the zshrc file from /etc/zsh/ \textbf{not} the .zshrc file +from /etc/skel/ these days. You can remove \kbd{\~}/.zshrc.global if it is +still present in your home directory. + \subsection*{Problems?} Please report any problems you encounter while using the grml zsh @@ -269,7 +268,7 @@ values: \command{umask @@INSERT-other-r_umask@@}{new files for root user \kbd{@@INSERT-other-r_umaskstr@@}} \commandlistend -\subsection*{Key-bindings} +\subsection*{Keybindings} Default keybinding mode is Emacs, i.e. you can use Emacs keybinds like \kbd{^A {\rm or} ^E} on the command line. However, you can switch to vi