From 1c591fc174dbd12e6780fd8ff52e80804c712b35 Mon Sep 17 00:00:00 2001 From: Dan Hackney Date: Wed, 30 Dec 2009 19:05:04 -0500 Subject: Update command documentation. Flesh-out and synchronize command documentation with the current state of "uzbl-core.c". Signed-off-by: Dan Hackney --- README | 93 ++++++++++++++++++++++++++++++++++++++++-------------------------- 1 file changed, 57 insertions(+), 36 deletions(-) diff --git a/README b/README index 4cba528..1c38c74 100644 --- a/README +++ b/README @@ -84,87 +84,108 @@ Each command starts with the name of a command or a `uzbl` variable that expands The following commands are recognized: -* `set = ` - - used for changing variables on the fly - - the changes are effective immediately; for example, setting the variable `uri` will make uzbl start loading, and changing `status_format` will make the status bar react immediately - - if you want to unset a string, use `set` with one space after the equals sign -* `print @` - - use this to print the value of a variable. * `back` + - Navigate to the previous URI in the history. * `forward` + - Navigate to the next URI in the history. * `scroll ` - argument can be `begin`, `end`, or an amount given in pixels(?) or as a percentage of the size of the view - set the amount to 100% to scroll a whole page * `reload` + - Reload the current page. * `reload_ign_cache` + - Reload the current page, discarding any cached resources. * `stop` + - Stop loading the current page. * `zoom_in` + - Increase the zoom level. * `zoom_out` + - Decrease the zoom level. +* `toggle_zoom_type` + - Toggles the variable `zoom_type` between "full-content" and "text-only" zoom. In "text-only" zoom, only the text of the page is zoomed, while in "full-content" zoom, images and other page elements are zoomed along with the text. * `uri
` + - Attempt to load `
`. This is equivalent to `set uri =
`. * `js ` - - Execute the javascript in ``. + - Execute the JavaScript in ``. - Remember that the commands must not contain line breaks. * `script ` - - Execute the javascript in ``. + - Execute the JavaScript in ``. * `toggle_status` + - Toggle the display of the status bar. * `spawn ` TODO explain path-alike expansion - Runs a command; see EXTERNAL SCRIPTS for details. - `$PATH` is searched, so giving the full path to commands is not necessary. - Note that the arguments as specified in "EXTERNAL SCRIPTS" are appended at the end, so the argument numbers will be higher. +* `sync_spawn ` + - A synchronous variant of `spawn`, which means `uzbl` will wait for it to return. + - You should only need to use this manually if you want to use a `chain` command in a handler that wants output from the command it runs. * `sh ` - Runs a shell command by expanding `%s` in the `shell_cmd` variable with the specified command; primarily useful as a shortcut for `spawn sh -c ` - Note that the arguments as specified in "EXTERNAL SCRIPTS" are appended at the end, so the argument numbers will be higher. -* `sync_spawn ` * `sync_sh ` - - These are synchronous variants of `spawn` and `sh`, which means `uzbl` will wait for them to return. - - You should only need to use these manually if you want to use a chain command in a handler that wants output from the command it runs. + - Synchronous version of `sh`, See `sync_spawn`. * `talk_to_socket ` - Send a message to `` and wait for a response. `` are concatenated and separated by ASCII NUL bytes. - Expects the socket type to be `SOCK_SEQPACKET` (see connect(2) ). - Waits for 500ms for a response. * `exit` + - Closes `uzbl`. * `search ` + - Search forward for ``. With no string, search for the next occurrence of the previously searched string. * `search_reverse ` - - search with no string will search for the next/previous occurrence of the string previously searched for + - Like `search`, but searches backward. * `search_clear` - - unmark and clear the search string -* `toggle_insert_mode ` TODO new plugin based syntax - - if the optional state is 0, disable insert mode. If 1, enable insert mode. + - Dehighlight matches and clear the search string. +* `dehilight` + - Remove highlighting of search matches. +* `set = ` + - Sets `` to ``. + - The changes are effective immediately; for example, setting the variable `uri` will make `uzbl` start loading, and changing `status_format` will make the status bar react immediately. + - If you want to unset a string, use `set` with one space after the equals sign. * `dump_config` - - dumps your current config (which may have been changed at runtime) to stdout, in a format you can use to pipe into uzbl again (or use as config file) -* `keycmd ` -* `keycmd_nl ` - - keycmd sets the interactive command buffer to ``. If the given string is a valid binding, it will execute. `Keycmd_nl` is like `keycmd`, but it also emulates a press of return, causing bindings with a parameter to execute. For example, `keycmd_nl o google.com` would load the said url if you have a binding like `bind o _ = uri %s`. -* `keycmd_bs` - - erase (backspace) one character from the command buffer -* `chain ..` - - use for chaining multiple commands - - remember to quote the commands; one command must come as one parameter - - if you use `chain` with a handler script which must return some output (such as a cookie handler -- uzbl will wait for and use its output), use sync_spawn or sync_sh instead of spawn or sh in the command that should give the output + - Dumps the current config (which may have been changed at runtime) to stdout. + - Uses a format which can be piped into `uzbl` again or saved as a config file. +* `dump_config_as_events` + - Dump the current config as a series of `VARIABLE_SET` events, which can be handled by an event manager. +* `chain ...` + - Used for chaining multiple commands. + - Remember to quote the commands; one command must come as one parameter. + - If you use `chain` with a handler script which must return some output (such as a cookie handler -- `uzbl` will wait for and use its output), use `sync_spawn` or `sync_sh` instead of `spawn` or `sh` in the command that should give the output. +* `print ` + - Expands variables in `` and prints its output to stdout. Is useful for getting the value of variables. * `event [event_details]` - - send custom event + - Send a custom event. * `request [request_details]` - - send custom request (same idea as events, but to be processed by EM, not uzbl-core) -* `menu_add