zshrc: Stop setting $BROWSER
[grml-etc-core.git] / doc / grmlzshrc.t2t
index 33df2e0..f939765 100644 (file)
@@ -28,6 +28,18 @@ root user (**EUID** == 0) only a subset of features is loaded by default. This
 behaviour can be altered by setting the **GRML_ALWAYS_LOAD_ALL** STARTUP
 VARIABLE (see below).
 
+Users may want to keep an up-to-date version of the setup (possibly from the
+git-sources) in //~/.zshrc//. If that happens on a system where the global
+zshrc is also a //grmlzshrc// (but possibly an older one), you can inhibit
+loading the global version by doing:
+\
+```
+echo setopt no_global_rcs >> ~/.zshenv
+```
+
+Note, that this will disable //ANY// global files, except for the global
+zshenv file.
+
 = STARTUP VARIABLES =
 Some of the behaviour of //grmlzshrc// can be altered by setting certain shell
 variables. These may be set temporarily when starting zsh like this:
@@ -286,9 +298,6 @@ available via the usual history lookup widgets.
 //grmlzshrc// sets some environment variables, which influence the
 behaviour of applications.
 
-: **BROWSER**
-If X is running this is set to "firefox", otherwise to "w3m".
-
 : **COLORTERM**
 Set to "yes". Some applications read this to learn about properties
 of the terminal they are running in.
@@ -412,9 +421,18 @@ Deletes a word left of the cursor; seeing '/' as additional word separator.
 : **CTRL-x-1**
 Jump right after the first word.
 
+: **CTRL-x-M()**
+Create directory under cursor or the selected area.
+To select an area press ctrl-@ and use the cursor.
+Use case: you type "mv abc ~/testa/testb/testc/" and remember that the
+directory does not exist yet -> press **CTRL-xM** and problem solved.
+
 : **CTRL-x-p**
 Searches the last occurence of string before the cursor in the command history.
 
+: **CTRL-x-z**
+Display help on keybindings and zsh line editor. Press consecutively to page through content.
+
 : **CTRL-z**
 Brings a job, which got suspended with CTRL-z back to foreground.
 
@@ -427,11 +445,6 @@ user's life.
 Converts plaintext files to HTML using vim. The output is written to
 <filename>.html.
 
-: **2mp3_192()**
-Useful if you own players lacking ogg/flac support.
-Takes a list of "*.ogg" and "*.flac" files and transcodes them to mp3
-with a variable bitrate of at least 192, while preserving basic id3 tags.
-
 : **855resolution()**
 If 915resolution is available, issues a warning to the user to run it instead
 to modify the resolution on intel graphics chipsets.
@@ -484,11 +497,6 @@ Simple backup of a file or directory using cp(1). The target file name is the
 original name plus a time stamp attached. Symlinks and file attributes like mode,
 ownership and timestamps are preserved.
 
-: **brltty()**
-The brltty(1) program provides a braille display, so a blind person can access
-the console screen. This wrapper function works around problems with some
-environments (f. e. utf8).
-
 : **cdiff()**
 Runs a recursive diff(1) over two given directories trying to find the
 smallest set of changes. Three lines of context will be printed and binary
@@ -499,6 +507,10 @@ If the original cdrecord is not installed, issues a warning to the user to
 use the wodim binary instead. Wodim is the debian fork of Joerg Schillings
 cdrecord.
 
+: **cdt()**
+Creates a temporary directory using mktemp. Then changes current
+working directory to it.
+
 : **changed()**
 Lists files in current directory, which have been changed within the
 last N days. N is an integer to be passed as first and only argument.
@@ -841,9 +853,11 @@ Lists the content of a gzipped tar archive in default pager.
 Shows the content of a zip archive in default pager.
 
 : **simple-extract()**
-Tries to uncompress/unpack given files and URIs with the appropriate programs. The
-choice is made along the filename ending. simple-extract will never delete the 
-original archive (even on .gz,.bz2 or .xz) unless you use the '-d' option
+Tries to uncompress/unpack given files with the appropriate programs. If an URI
+starting with https, http or ftp is provided simple-extract tries to download
+and then uncompress/unpack the file. The choice is made along the filename
+ending. simple-extract will not delete the original archive (even on .gz,.bz2 or
+.xz) unless you use the '-d' option.
 
 : **sll()**
 Prints details of symlinks given as arguments.
@@ -897,10 +911,6 @@ Shows some information about current system status.
 : **swiki()**
 Searches articles in the german Wikipedia for the term given as argument.
 
-: **swspeak()**
-Sets up software synthesizer by calling swspeak-setup(8). Kernel boot option
-swspeak must be set for this to work.
-
 : **trans()**
 Translates a word from german to english (-D) or vice versa (-E).
 
@@ -1239,6 +1249,9 @@ Short rmdir(1) (remove directory).
 : **rm** (//nocorrect rm//)
 rm(1) without spelling correction.
 
+: **rmcdir** (//'cd ..; rmdir $OLDPWD || cd $OLDPWD//)
+rmdir current working directory
+
 : **screen** (///usr/bin/screen -c ${HOME}/.screenrc//)
 If invoking user is root, starts screen session with /etc/grml/screenrc
 as config file. If invoked by a regular user, start a screen session
@@ -1522,5 +1535,5 @@ Copyright (c) 2009-2011 Grml project <http://grml.org>
 This manpage is distributed under the terms of the GPL version 2.
 
 Most parts of grml's zshrc are distributed under the terms of GPL v2, too,
-except for **accept-line()** and **vcs_info()**, which are distributed under
-the same conditions as zsh itself (which is BSD-like).
+except for **accept-line()** which are distributed under the same conditions
+as zsh itself (which is BSD-like).