X-Git-Url: https://git.grml.org/?a=blobdiff_plain;f=doc%2Fgrmlzshrc.t2t;h=3e577631d81eabd339d691792529b4579d3d5e15;hb=f0145591a2b0f4027396894ce973fce7fe555803;hp=4abcb0e8b1306aec3d2302417493de1792da619d;hpb=b7e2161416537c0b43de6c8ebc64a6098736c150;p=grml-etc-core.git diff --git a/doc/grmlzshrc.t2t b/doc/grmlzshrc.t2t index 4abcb0e..3e57763 100644 --- a/doc/grmlzshrc.t2t +++ b/doc/grmlzshrc.t2t @@ -1,13 +1,13 @@ GRMLZSHRC -June, 2010 +July, 2011 %!target: man %!postproc(man): "^(\.TH.*) 1 " "\1 5 " = NAME = -grmlzshrc - grml's zsh setup +grmlzshrc - Grml's zsh setup = SYNOPSIS = @@ -15,7 +15,7 @@ grmlzshrc - grml's zsh setup = DESCRIPTION = -The grml project provides a fairly exhaustive interactive setup (referred to +The Grml project provides a fairly exhaustive interactive setup (referred to as //grmlzshrc// throughout this document) for the amazing unix shell zsh (http://zsh.sourceforge.net). This is the reference manual for that setup. @@ -26,10 +26,7 @@ features are enabled in every version). //grmlzshrc// behaves differently depending on which user loads it. For the 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). Also the umask(1) for the root user is set to 022, -while for regular users it is set to 002. So read/write permissions -for the regular user and her group are set for new files (keep that -in mind on systems, where regular users share a common group). +VARIABLE (see below). = STARTUP VARIABLES = Some of the behaviour of //grmlzshrc// can be altered by setting certain shell @@ -48,7 +45,7 @@ A non zero value activates a handler, which is called when a command can not be found. The handler is defined by GRML_ZSH_CNF_HANDLER (see below). : **GRML_ALWAYS_LOAD_ALL** -Enables the whole grml setup for root, if set to a non zero value. +Enables the whole Grml setup for root, if set to a non zero value. : **GRML_ZSH_CNF_HANDLER** This variable contains the handler to be used by COMMAND_NOT_FOUND (see above) @@ -62,7 +59,7 @@ grml-small. Where zsh saves the history. Default: ${HOME}/.zsh_history. : **HISTSIZE** -Number of commands to be kept in the history. On a grml-CD this defaults to +Number of commands to be kept in the history. On a Grml-CD this defaults to 500, on a hard disk installation to 5000. : **MAILCHECK** @@ -85,7 +82,7 @@ Show time (user, system and cpu) used by external commands, if they run longer than the defined number of seconds (default: 5). : **SAVEHIST** -Number of commands to be stored in ${HISTFILE}. Defaults to 1000 on a grml-CD +Number of commands to be stored in ${HISTFILE}. Defaults to 1000 on a Grml-CD and to 10000 on an installation on hard disk. : **watch** @@ -430,6 +427,11 @@ user's life. Converts plaintext files to HTML using vim. The output is written to .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. @@ -487,6 +489,11 @@ 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 +files filtered out. + : **cdrecord()** 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 @@ -510,9 +517,24 @@ grml systems with autologin. Changes current directory to the one supplied by argument and lists the files in it, including file names starting with ".". -: **d()** -Presents a numbered listing of the directory stack. Then changes current -working directory to the one chosen by the user. +: **cvsa()** +Adds and commits the given files using cvs(1). The commit message will be +'initial checkin'. + +: **cvsd()** +Shows a cvs diff of the arguments in $PAGER. + +: **cvsl()** +Shows the cvs log in $PAGER. + +: **cvsq()** +Runs a cvs update. + +: **cvsr()** +Generates a changelog using rcs2log and shows it in $PAGER. + +: **cvss()** +Shows cvs status of given files. : **dchange()** Shows the changelog of given package in $PAGER. @@ -540,6 +562,10 @@ defaults to $path. : **disassemble()** Translates C source code to assembly and ouputs both. +: **dmoz()** +Searches for the first argument (optional) in the Open Directory Project +(See http://www.dmoz.org/docs/en/about.html). + : **dnews()** Shows the NEWS file for the given package in $PAGER. @@ -547,12 +573,20 @@ Shows the NEWS file for the given package in $PAGER. Takes packagename as argument. Sets current working directory to /usr/share/doc/ and prints out a directory listing. +: **dwicti()** +Looks up the first argument (optional) in the german Wiktionary +which is an online dictionary (See: http://de.wiktionary.org/). + : **edalias()** Edit given alias. : **edfunc()** Edit given shell function. +: **ewicti()** +Looks up the first argument (optional in the english Wiktionary +which is an online dictionary (See: http://en.wiktionary.org/). + : **exirename()** Renames image files based on date/time informations in their exif headers. @@ -580,6 +614,15 @@ and all files and/or directories beginning with "thumb-" in current directory! : **get_tw_cli()** Fetches 3ware RAID controller software using get_3ware(1). +: **gex()** +Performs an exact (i. e. quoted) web search using Google. + +: **ggogle()** +Searches the arguments on Google Groups, a web to USENET gateway. + +: **google()** +Searches the search engine Google using arguments as search string. + : **greph()** Searches the zsh command history for a regular expression. @@ -646,6 +689,9 @@ environment variables to UTF-8. : **isutfenv()** Returns true, if run within an utf environment, else false. +: **iwclient()** +Searches a wireless interface and runs dhclient(8) on it. + : **lcheck()** Lists libraries that define the symbol containing the string given as parameter. @@ -658,6 +704,9 @@ directory. Prints specified range of (numbered) lines of a file. Usage: linenr [,] +: **lsdisk()** +Uses udev's /dev/disk to list block devices with their LABEL, UUID and IDs. + : **makereadable()** Creates a PostScript and a PDF file (basename as first argument) from source code files. @@ -680,6 +729,9 @@ output (unified format) to a timestamped file. : **memusage()** Prints the summarized memory usage in bytes. +: **mggogle()** +Searches Google Groups for a USENET message-ID. + : **minimal-shell()** Spawns a minimally set up MirBSD Korn shell. It references no files in /usr, so that file system can be unmounted. @@ -707,6 +759,9 @@ Lists files in current directory, which have been modified within the last N days. N is an integer to be passed as first and only argument. If no argument is specified N is set to 1. +: **netcraft()** +Asks netcraft.com for informations about the site given as argument. + : **nt()** A helper function for the "e" glob qualifier to list all files newer than a reference file. @@ -719,8 +774,9 @@ Example usages: % ls -l *(e:'nt /reference/file':) ``` -: **ogg2mp3_192()** -Recodes an ogg file to mp3 with a bitrate of 192. +: **oleo()** +Translates the given word using the english - german online +dictionary dict.leo.org. : **peval()** Evaluates a perl expression; useful as command line @@ -734,9 +790,16 @@ Runs a command in $SHELL with profiling enabled (See startup variable ZSH_PROFILE_RC above). : **purge()** -Removes typical temporary files (i. e. files like "*~", ".*~", "#*#", "*.o", -"a.out", "*.core", "*.cmo", "*.cmi" and ".*.swp") from current directory. -Asks for confirmation. +Removes temporary files from current directory. Asks for confirmation. Uses sudo if necessary. +In detail it purges + - common temp files like "*~", ".*~", "#*#", "*.o", "a.out", "*.orig", "*.rej", "*.cmo", "*.cmi" and ".*.swp" + - core dumps + - debconf backup files: "*.dpkg-old", "*.dkpg-new", "*.dpkg-dist" + - gentoo dispatch-conf backups: ".cfg0000_*", ".mrg0000_*" + - precompiled python code ("*.pyc", "*.pyo") as long as matching "*.py" source is also present + - LaTeX temp files i.e. "*.(log|toc|aux|nav|snm|out|tex.backup|bbl|blg|bib.backup|vrb|lof|lot|hd|idx)" for any present "*.tex" + - ghc temp files, as long as matching "*.hs" or "*.lhs" is also present + - "*.mood(D)" Files which are missing their corresponding audio file : **readme()** Opens all README-like files in current working directory with the program @@ -749,6 +812,11 @@ Reloads functions given as parameters. Checks whether a regular expression (first parameter) matches a string (second parameter) using perl. +: **rundirs()** +Takes as first parameter a quoted string containing an exectuable command or function with arguments. +Following that it takes a bunch of directories, which will then be traversed, executing the +first argument in each one. E.g.: rundirs purge . **/*(/-/) + : **salias()** Creates an alias whith sudo prepended, if $EUID is not zero. Run "salias -h" for details. See also xunfunction() below. @@ -773,8 +841,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 file with the appropriate programs. The -choice is made along the filename ending. +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. @@ -822,14 +893,12 @@ Example usage: % Restart ssh ``` -: **startx()** -Initializes an X session using startx(1) if /etc/X11/xorg.conf exists, else -issues a Warning to use the grml-x(1) script. Can be overridden by using -/usr/bin/startx directly. - : **status()** 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. @@ -882,15 +951,21 @@ The first and only argument is the ICAO code for the desired station. For a list of ICAO codes see "http://en.wikipedia.org/wiki/List_of_airports_by_ICAO_code". +: **wikide()** +Looks up the argument on Wikipedia (german). + +: **wikien()** +Looks up the argument on Wikipedia (english). + +: **wodeb()** +Searches the list of official debian packages for the term given as +first argument. The optional second argument denotes the distribution +(stable, testing or unstable) and defaults to unstable. + : **xcat()** Tries to cat(1) file(s) given as parameter(s). Always returns true. See also xunfunction() below. -: **xinit()** -Initializes an X session using xinit(1) if /etc/X11/xorg.conf exists, else -issues a Warning to use the grml-x(1) script. Can be overridden by using -/usr/bin/xinit directly. - : **xsource()** Tries to source the file(s) given as parameter(s). Always returns true. See zshbuiltins(1) for a detailed description of the source command. @@ -1444,7 +1519,7 @@ Beckert . = COPYRIGHT = -Copyright (c) 2009-2010 grml project +Copyright (c) 2009-2011 Grml project This manpage is distributed under the terms of the GPL version 2.