X-Git-Url: https://git.grml.org/?a=blobdiff_plain;f=doc%2Fgrmlzshrc.t2t;h=1398a7a2bc6ef2f016f8b83cab35919534e1c080;hb=19cfd450e9e597d7aa1483a96a0d5c717047830e;hp=5fc5c2c8311f440cd0823e268f2484e4eb521078;hpb=08b620f9509a55bfc633bfaf50fd94065d72b633;p=grml-etc-core.git diff --git a/doc/grmlzshrc.t2t b/doc/grmlzshrc.t2t index 5fc5c2c..1398a7a 100644 --- a/doc/grmlzshrc.t2t +++ b/doc/grmlzshrc.t2t @@ -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 @@ -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. @@ -449,6 +451,9 @@ Sets all ulimit values to "unlimited". Prints a colored table of available ansi color codes (to be used in escape sequences) and the colors they represent. +: **any()** +Lists processes matching given pattern. + : **aoeu(), asdf(), uiae()** Pressing the 'asdf' keys toggles between dvorak or neon and us keyboard layout. @@ -484,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 @@ -507,9 +517,27 @@ 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. : **debbug()** Searches the Debian bug tracking system (bugs.debian.org) for Bug numbers, @@ -522,6 +550,11 @@ Shows bug report for debian given by number in mailbox format. Tells the user to use grml-debootstrap, if she wants to install debian to harddisk. +: **deswap()** +A trick from $LINUX-KERNELSOURCE/Documentation/power/swsusp.txt. It brings +back interactive responsiveness after suspend, when the system is swapping +heavily. + : **dirspace()** Shows the disk usage of the directories given in human readable format; defaults to $path. @@ -529,10 +562,31 @@ 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. + : **doc()** 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. @@ -546,6 +600,9 @@ Switches the key combinations for changing current workspace under fluxbox(1) from Alt-[0-9] to Alt-F[0-9] and vice versa by rewriting $HOME/.fluxbox/keys. Requires the window manager to reread configuration to take effect. +: **freload()** +Reloads an autoloadable shell function (See autoload in zshbuiltins(1)). + : **genthumbs()** A simple thumbnails generator. Resizes images (i. e. files that end in ".jpg", ".jpeg", ".gif" or ".png") to 100x200. Output files are named "thumb-[,] +: **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. @@ -638,6 +714,10 @@ source code files. : **man2()** Displays manpage in a streched style. +: **manzsh()** +Shows the zshall manpage and jumps to the first match of the regular +expression optionally given as argument (Needs qma(1)). + : **mcd()** Creates directory including parent directories, if necessary. Then changes current working directory to it. @@ -649,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. @@ -676,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. @@ -688,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 @@ -698,6 +785,10 @@ calculator, therefore also available as "calc". : **plap()** Lists all occurrences of the string given as argument in current $PATH. +: **profile()** +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. @@ -724,6 +815,9 @@ findings in default pager. On exit of the pager the user is prompted for a number. The shells readline buffer is then filled with the corresponding command line. +: **setenv()** +Reimplementation of the csh(1) builtin setenv. + : **show-archive()** Lists the contents of a (compressed) archive with the appropriate programs. The choice is made along the filename extension. @@ -738,6 +832,9 @@ Shows the content of a zip archive in default pager. Tries to uncompress/unpack given file with the appropriate programs. The choice is made along the filename ending. +: **sll()** +Prints details of symlinks given as arguments. + : **slow_print()** Prints the arguments slowly by sleeping 0.08 seconds between each character. @@ -774,14 +871,19 @@ certificate. First and only parameter must be a file containing a certificate. Use /dev/stdin as file if you want to pipe a certificate to this function. -: **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. +: **Start(), Restart(), Stop(), Force-Reload(), Reload()** +Functions for controlling daemons. +``` +Example usage: +% Restart ssh +``` : **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. @@ -789,6 +891,9 @@ swspeak must be set for this to work. : **trans()** Translates a word from german to english (-D) or vice versa (-E). +: **uchange()** +Shows upstreams changelog of a given package in $PAGER. + : **udiff()** Makes a unified diff of the command line arguments trying hard to find a smaller set of changes. Descends recursively into subdirectories. Ignores @@ -831,15 +936,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.