From 5ddd54a1f89f238af9424ead912c6790091e6219 Mon Sep 17 00:00:00 2001 From: Kalle Olavi Niemitalo Date: Sat, 20 Sep 2008 23:58:02 +0300 Subject: [PATCH] ELinks 0.11.5 --- configure.in | 2 +- doc/man/man1/elinks.1.in | 194 ++-- doc/man/man5/elinks.conf.5 | 2126 ++++++++++++++++++------------------ doc/man/man5/elinkskeys.5 | 344 +++--- po/be.po | 82 +- po/bg.po | 82 +- po/ca.po | 82 +- po/cs.po | 82 +- po/da.po | 82 +- po/de.po | 82 +- po/el.po | 82 +- po/es.po | 82 +- po/et.po | 82 +- po/fi.po | 82 +- po/fr.po | 82 +- po/gl.po | 82 +- po/hr.po | 82 +- po/hu.po | 82 +- po/id.po | 82 +- po/is.po | 82 +- po/it.po | 82 +- po/lt.po | 82 +- po/nb.po | 82 +- po/nl.po | 82 +- po/pl.po | 82 +- po/pt.po | 82 +- po/pt_BR.po | 82 +- po/ro.po | 82 +- po/ru.po | 82 +- po/sk.po | 82 +- po/sr.po | 82 +- po/sv.po | 82 +- po/tr.po | 82 +- po/uk.po | 82 +- 34 files changed, 2713 insertions(+), 2413 deletions(-) diff --git a/configure.in b/configure.in index 47d505b5..d08a6479 100644 --- a/configure.in +++ b/configure.in @@ -8,7 +8,7 @@ AC_INIT(src/main/main.c) AC_CONFIG_AUX_DIR(config) PACKAGE=elinks -VERSION=0.11.4.GIT +VERSION=0.11.5 AC_SUBST(PACKAGE) AC_SUBST(VERSION) AC_DEFINE_UNQUOTED(PACKAGE, "$PACKAGE", [Package version]) diff --git a/doc/man/man1/elinks.1.in b/doc/man/man1/elinks.1.in index 63118cf2..14337f15 100644 --- a/doc/man/man1/elinks.1.in +++ b/doc/man/man1/elinks.1.in @@ -1,49 +1,49 @@ .\" Title: elinks .\" Author: .\" Generator: DocBook XSL Stylesheets v1.73.2 -.\" Date: 06/20/2008 +.\" Date: 09/20/2008 .\" Manual: The Elinks text-browser -.\" Source: ELinks 0.11.4 +.\" Source: ELinks 0.11.5 .\" -.TH "ELINKS" "1" "06/20/2008" "ELinks 0\.11\.4" "The Elinks text\-browser" +.TH "ELINKS" "1" "09/20/2008" "ELinks 0\&.11\&.5" "The Elinks text\-browser" .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) .ad l .SH "NAME" -elinks - lynx-like alternative character mode WWW browser +elinks \- lynx-like alternative character mode WWW browser .SH "SYNOPSIS" \fIelinks\fR [OPTION]\&... [URL]\&... .sp .SH "DESCRIPTION" -\fIELinks\fR is a text mode WWW browser, supporting colors, table rendering, background downloading, menu driven configuration interface, tabbed browsing and slim code\. +\fIELinks\fR is a text mode WWW browser, supporting colors, table rendering, background downloading, menu driven configuration interface, tabbed browsing and slim code\&. .sp -Frames are supported\. You can have different file formats associated with external viewers\. mailto: and telnet: are supported via external clients\. +Frames are supported\&. You can have different file formats associated with external viewers\&. mailto: and telnet: are supported via external clients\&. .sp -ELinks can handle both local files and remote URLs\. The main supported remote URL protocols are \fIHTTP\fR, \fIHTTPS\fR (with SSL support compiled in) and \fIFTP\fR\. Additional protocol support exists for \fIBitTorrent\fR \fIfinger\fR, \fIGopher\fR, \fISMB\fR and \fINNTP\fR\. +ELinks can handle both local files and remote URLs\&. The main supported remote URL protocols are \fIHTTP\fR, \fIHTTPS\fR (with SSL support compiled in) and \fIFTP\fR\&. Additional protocol support exists for \fIBitTorrent\fR \fIfinger\fR, \fIGopher\fR, \fISMB\fR and \fINNTP\fR\&. .sp -The homepage of \fIELinks\fR can be found at , where the ELinks manual is also hosted\. +The homepage of \fIELinks\fR can be found at , where the ELinks manual is also hosted\&. .sp .SH "OPTIONS" -Most options can be set in the user interface or config file, so usually you do not need to care about them\. Note that this list is roughly equivalent to the output of running ELinks with the option \-\-long\-help\. +Most options can be set in the user interface or config file, so usually you do not need to care about them\&. Note that this list is roughly equivalent to the output of running ELinks with the option \-\-long\-help\&. .PP \-anonymous [0|1] (default: 0) .RS 4 Restricts \fIELinks\fR -so it can run on an anonymous account\. Local file browsing, downloads, and modification of options will be disabled\. Execution of viewers is allowed, but entries in the association table can\'t be added or modified\. +so it can run on an anonymous account\&. Local file browsing, downloads, and modification of options will be disabled\&. Execution of viewers is allowed, but entries in the association table can\'t be added or modified\&. .RE .PP \-auto\-submit [0|1] (default: 0) .RS 4 -Automatically submit the first form in the given URLs\. +Automatically submit the first form in the given URLs\&. .RE .PP \-base\-session (default: 0) .RS 4 Used internally when opening \fIELinks\fR -instances in new windows\. The ID maps to information that will be used when creating the new instance\. You don\'t want to use it\. +instances in new windows\&. The ID maps to information that will be used when creating the new instance\&. You don\'t want to use it\&. .RE .PP \-config\-dir (default: "") @@ -51,58 +51,58 @@ instances in new windows\. The ID maps to information that will be used when cre Path of the directory \fIELinks\fR will read and write its config and runtime state files to instead of -~/\.elinks\. If the path does not begin with a \'/\' it is assumed to be relative to your +~/\&.elinks\&. If the path does not begin with a \'/\' it is assumed to be relative to your \fIHOME\fR -directory\. +directory\&. .RE .PP \-config\-dump .RS 4 -Print a configuration file with options set to the built\-in defaults to stdout\. +Print a configuration file with options set to the built\-in defaults to stdout\&. .RE .PP -\-config\-file (default: "elinks\.conf") +\-config\-file (default: "elinks\&.conf") .RS 4 -Name of the configuration file that all configuration options will be read from and written to\. It should be relative to config\-dir\. +Name of the configuration file that all configuration options will be read from and written to\&. It should be relative to config\-dir\&. .RE .PP \-config\-help .RS 4 -Print help for configuration options and exit\. +Print help for configuration options and exit\&. .RE .PP -\-default\-mime\-type (alias for mime\.default_type) +\-default\-mime\-type (alias for mime\&.default_type) .RS 4 -The default MIME type used for documents of unknown type\. +The default MIME type used for documents of unknown type\&. .RE .PP \-default\-keys [0|1] (default: 0) .RS 4 -When set, all keybindings from configuration files will be ignored\. It forces use of default keybindings and will reset user\-defined ones on save\. +When set, all keybindings from configuration files will be ignored\&. It forces use of default keybindings and will reset user\-defined ones on save\&. .RE .PP \-dump [0|1] (default: 0) .RS 4 -Print formatted plain\-text versions of given URLs to stdout\. +Print formatted plain\-text versions of given URLs to stdout\&. .RE .PP -\-dump\-charset (alias for document\.dump\.codepage) +\-dump\-charset (alias for document\&.dump\&.codepage) .RS 4 -Codepage used when formatting dump output\. +Codepage used when formatting dump output\&. .RE .PP -\-dump\-width (alias for document\.dump\.width) +\-dump\-width (alias for document\&.dump\&.width) .RS 4 -Width of the dump output\. +Width of the dump output\&. .RE .PP \-eval .RS 4 -Specify configuration file directives on the command\-line which will be evaluated after all configuration files has been read\. Example usage: +Specify configuration file directives on the command\-line which will be evaluated after all configuration files has been read\&. Example usage: .sp .RS 4 .nf -\-eval \'set protocol\.file\.allow_special_files = 1\' +\-eval \'set protocol\&.file\&.allow_special_files = 1\' .fi .RE .RE @@ -111,65 +111,65 @@ Specify configuration file directives on the command\-line which will be evaluat .RS 4 Makes \fIELinks\fR -assume documents of unknown types are HTML\. Useful when using +assume documents of unknown types are HTML\&. Useful when using \fIELinks\fR -as an external viewer from MUAs\. This is equivalent to +as an external viewer from MUAs\&. This is equivalent to \-default\-mime\-type -text/html\. +text/html\&. .RE .PP \-?, \-h, \-help .RS 4 -Print usage help and exit\. +Print usage help and exit\&. .RE .PP \-localhost [0|1] (default: 0) .RS 4 Restricts \fIELinks\fR -to work offline and only connect to servers with local addresses (ie\. 127\.0\.0\.1)\. No connections to remote servers will be permitted\. +to work offline and only connect to servers with local addresses (ie\&. 127\&.0\&.0\&.1)\&. No connections to remote servers will be permitted\&. .RE .PP \-long\-help .RS 4 -Print detailed usage help and exit\. +Print detailed usage help and exit\&. .RE .PP \-lookup .RS 4 -Look up specified host and print all DNS resolved IP addresses\. +Look up specified host and print all DNS resolved IP addresses\&. .RE .PP \-no\-connect [0|1] (default: 0) .RS 4 Run \fIELinks\fR -as a separate instance instead of connecting to an existing instance\. Note that normally no runtime state files (bookmarks, history, etc\.) are written to the disk when this option is used\. See also -\-touch\-files\. +as a separate instance instead of connecting to an existing instance\&. Note that normally no runtime state files (bookmarks, history, etc\&.) are written to the disk when this option is used\&. See also +\-touch\-files\&. .RE .PP \-no\-home [0|1] (default: 0) .RS 4 -Disables creation and use of files in the user specific home configuration directory (~/\.elinks)\. It forces default configuration values to be used and disables saving of runtime state files\. +Disables creation and use of files in the user specific home configuration directory (~/\&.elinks)\&. It forces default configuration values to be used and disables saving of runtime state files\&. .RE .PP -\-no\-numbering (alias for document\.dump\.numbering) +\-no\-numbering (alias for document\&.dump\&.numbering) .RS 4 -Prevents printing of link number in dump output\. Note that this really affects only -\-dump, nothing else\. +Prevents printing of link number in dump output\&. Note that this really affects only +\-dump, nothing else\&. .RE .PP -\-no\-references (alias for document\.dump\.references) +\-no\-references (alias for document\&.dump\&.references) .RS 4 -Prevents printing of references (URIs) of document links in dump output\. Note that this really affects only -\-dump, nothing else\. +Prevents printing of references (URIs) of document links in dump output\&. Note that this really affects only +\-dump, nothing else\&. .RE .PP \-remote .RS 4 Control a remote \fIELinks\fR -instance by passing commands to it\. The option takes an additional argument containing the method which should be invoked and any parameters that should be passed to it\. For ease of use, the additional method argument can be omitted in which case any URL arguments will be opened in new tabs in the remote instance\. Following is a list of the supported methods: +instance by passing commands to it\&. The option takes an additional argument containing the method which should be invoked and any parameters that should be passed to it\&. For ease of use, the additional method argument can be omitted in which case any URL arguments will be opened in new tabs in the remote instance\&. Following is a list of the supported methods: .sp .RS 4 \h'-04'\(bu\h'+03' @@ -216,32 +216,32 @@ xfeDoCommand(openBrowser): open new window .RS 4 ID of session ring this \fIELinks\fR -session should connect to\. +session should connect to\&. \fIELinks\fR works in so\-called session rings, whereby all instances of \fIELinks\fR -are interconnected and share state (cache, bookmarks, cookies, and so on)\. By default, all +are interconnected and share state (cache, bookmarks, cookies, and so on)\&. By default, all \fIELinks\fR -instances connect to session ring 0\. You can change that behaviour with this switch and form as many session rings as you want\. Obviously, if the session\-ring with this number doesn\'t exist yet, it\'s created and this \'ELinks\' instance will become the master instance (that usually doesn\'t matter for you as a user much)\. Note that you usually don\'t want to use this unless you\'re a developer and you want to do some testing \- if you want the +instances connect to session ring 0\&. You can change that behaviour with this switch and form as many session rings as you want\&. Obviously, if the session\-ring with this number doesn\'t exist yet, it\'s created and this \'ELinks\' instance will become the master instance (that usually doesn\'t matter for you as a user much)\&. Note that you usually don\'t want to use this unless you\'re a developer and you want to do some testing \- if you want the \fIELinks\fR instances each running standalone, rather use the \-no\-connect -command\-line option\. Also note that normally no runtime state files are written to the disk when this option is used\. See also -\-touch\-files\. +command\-line option\&. Also note that normally no runtime state files are written to the disk when this option is used\&. See also +\-touch\-files\&. .RE .PP \-source [0|1] (default: 0) .RS 4 -Print given URLs in source form to stdout\. +Print given URLs in source form to stdout\&. .RE .PP \-touch\-files [0|1] (default: 0) .RS 4 -When enabled, runtime state files (bookmarks, history, etc\.) are written to disk, even when +When enabled, runtime state files (bookmarks, history, etc\&.) are written to disk, even when \-no\-connect or \-session\-ring -is used\. The option has no effect if not used in conjunction with any of these options\. +is used\&. The option has no effect if not used in conjunction with any of these options\&. .RE .PP \-verbose (default: 1) @@ -265,26 +265,26 @@ The verbose level controls what messages are shown at start up and while running .RS 4 Print \fIELinks\fR -version information and exit\. +version information and exit\&. .RE -Generated using output from ELinks version 0\.11\.4\. +Generated using output from ELinks version 0\&.11\&.5\&. .sp .SH "ENVIRONMENT VARIABLES" .PP COMSPEC, SHELL .RS 4 -The shell used for File \-> OS Shell on DOS/Windows and UNIX, respectively\. +The shell used for File \-> OS Shell on DOS/Windows and UNIX, respectively\&. .RE .PP EDITOR .RS 4 -The program to use for external editor (when editing textareas)\. +The program to use for external editor (when editing textareas)\&. .RE .PP ELINKS_CONFDIR .RS 4 -The location of the directory containing configuration files\. If not set the default is -~/\.elinks/\. +The location of the directory containing configuration files\&. If not set the default is +~/\&.elinks/\&. .RE .PP ELINKS_TWTERM, LINKS_TWTERM @@ -292,7 +292,7 @@ ELINKS_TWTERM, LINKS_TWTERM The command to run when selecting File \-> New window and if TWDISPLAY is defined (default -twterm \-e)\. +twterm \-e)\&. .RE .PP ELINKS_XTERM, LINKS_XTERM @@ -300,109 +300,109 @@ ELINKS_XTERM, LINKS_XTERM The command to run when selecting File \-> New window and if DISPLAY is defined (default -xterm \-e)\. +xterm \-e)\&. .RE .PP FTP_PROXY, HTTP_PROXY, HTTPS_PROXY .RS 4 -The host to proxy the various protocol traffic through\. +The host to proxy the various protocol traffic through\&. .RE .PP NO_PROXY .RS 4 -A comma separated list of URLs which should not be proxied\. +A comma separated list of URLs which should not be proxied\&. .RE .PP HOME .RS 4 -The path to the users home directory\. Used when expanding -~/\. +The path to the users home directory\&. Used when expanding +~/\&. .RE .PP WWW_HOME .RS 4 Homepage location (as in -\fBlynx\fR(1))\. +\fBlynx\fR(1))\&. .RE .SH "FILES" -Configuration files controlled by ELinks are located in the user configuration directory, defaulting to \fI~/\.elinks/\fR\. In addition to the files listed below, a user defined CSS stylesheet can be defined using the \fIdocument\.css\.stylesheet\fR option\. +Configuration files controlled by ELinks are located in the user configuration directory, defaulting to \fI~/\&.elinks/\fR\&. In addition to the files listed below, a user defined CSS stylesheet can be defined using the \fIdocument\&.css\&.stylesheet\fR option\&. .PP -@sysconfdir@/elinks\.conf +@sysconfdir@/elinks\&.conf .RS 4 -Site\-wide configuration file\. +Site\-wide configuration file\&. .RE .PP -~/\.elinks/elinks\.conf +~/\&.elinks/elinks\&.conf .RS 4 -Per\-user config file, loaded after site\-wide configuration\. +Per\-user config file, loaded after site\-wide configuration\&. .RE .PP -~/\.elinks/bookmarks +~/\&.elinks/bookmarks .RS 4 -Bookmarks file\. +Bookmarks file\&. .RE .PP -~/\.elinks/cookies +~/\&.elinks/cookies .RS 4 -Cookies file\. +Cookies file\&. .RE .PP -~/\.elinks/exmodehist +~/\&.elinks/exmodehist .RS 4 -Exmode history file\. +Exmode history file\&. .RE .PP -~/\.elinks/formhist +~/\&.elinks/formhist .RS 4 -Form history file\. +Form history file\&. .RE .PP -~/\.elinks/globhist +~/\&.elinks/globhist .RS 4 -History file containing most recently visited URLs\. +History file containing most recently visited URLs\&. .RE .PP -~/\.elinks/gotohist +~/\&.elinks/gotohist .RS 4 -GoTo URL dialog history file\. +GoTo URL dialog history file\&. .RE .PP -~/\.elinks/hooks\.{js,lua,pl,py,rb,scm} +~/\&.elinks/hooks\&.{js,lua,pl,py,rb,scm} .RS 4 -Browser scripting hooks\. +Browser scripting hooks\&. .RE .PP -~/\.elinks/searchhist +~/\&.elinks/searchhist .RS 4 -Search history file\. +Search history file\&. .RE .PP -~/\.elinks/socket +~/\&.elinks/socket .RS 4 Internal \fIELinks\fR -socket for communication between its instances\. +socket for communication between its instances\&. .RE .PP -~/\.mailcap, /etc/mailcap +~/\&.mailcap, /etc/mailcap .RS 4 -Mappings of MIME types to external handlers\. +Mappings of MIME types to external handlers\&. .RE .PP -~/\.mime\.types, /etc/mime\.types +~/\&.mime\&.types, /etc/mime\&.types .RS 4 -Mappings of file extensions to MIME types\. +Mappings of file extensions to MIME types\&. .RE .SH "BUGS" -Please report any other bugs you find to the either the ELinks mailing list at or if you prefer enter them into the bug tracking system \. More information about how to get in contact with developers and getting help can be found on the community page \. +Please report any other bugs you find to the either the ELinks mailing list at or if you prefer enter them into the bug tracking system \&. More information about how to get in contact with developers and getting help can be found on the community page \&. .sp .SH "LICENSE" -\fIELinks\fR is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; version 2 of the License\. +\fIELinks\fR is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; version 2 of the License\&. .sp .SH "AUTHORS" -The \fILinks\fR browser \- on which \fIELinks\fR is based \- was written by Mikulas Patocka \. \fIELinks\fR was written by Petr Baudis \. See file AUTHORS in the source tree for a list of people contributing to this project\. +The \fILinks\fR browser \- on which \fIELinks\fR is based \- was written by Mikulas Patocka \&. \fIELinks\fR was written by Petr Baudis \&. See file AUTHORS in the source tree for a list of people contributing to this project\&. .sp -This manual page was written by Peter Gervai , using excerpts from a (yet?) unknown \fILinks\fR fan for the \fIDebian GNU/Linux system\fR (but may be used by others)\. Contributions from Francis A\. Holop\. Extended, clarified and made more up\-to\-date by Petr Baudis \. Updated by Zas \. The conversion to Asciidoc and trimming was done by Jonas Fonseca \. +This manual page was written by Peter Gervai , using excerpts from a (yet?) unknown \fILinks\fR fan for the \fIDebian GNU/Linux system\fR (but may be used by others)\&. Contributions from Francis A\&. Holop\&. Extended, clarified and made more up\-to\-date by Petr Baudis \&. Updated by Zas \&. The conversion to Asciidoc and trimming was done by Jonas Fonseca \&. .sp .SH "SEE ALSO" \fBelinkskeys\fR(5), \fBelinks.conf\fR(5), \fBlinks\fR(1), \fBlynx\fR(1), \fBw3m\fR(1), \fBwget\fR(1) diff --git a/doc/man/man5/elinks.conf.5 b/doc/man/man5/elinks.conf.5 index 62a8ea27..c10bc705 100644 --- a/doc/man/man5/elinks.conf.5 +++ b/doc/man/man5/elinks.conf.5 @@ -1,17 +1,17 @@ .\" Title: elinks.conf .\" Author: .\" Generator: DocBook XSL Stylesheets v1.73.2 -.\" Date: 06/20/2008 +.\" Date: 09/20/2008 .\" Manual: ELinks configuration file -.\" Source: ELinks 0.11.4 +.\" Source: ELinks 0.11.5 .\" -.TH "ELINKS\.CONF" "5" "06/20/2008" "ELinks 0\.11\.4" "ELinks configuration file" +.TH "ELINKS\&.CONF" "5" "09/20/2008" "ELinks 0\&.11\&.5" "ELinks configuration file" .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) .ad l .SH "NAME" -elinks.conf - ELinks configuration file +elinks.conf \- ELinks configuration file .SH "SYNOPSIS" .sp .RS 4 @@ -23,14 +23,14 @@ include "" .fi .RE .SH "DESCRIPTION" -The elinks\.conf file contains configuration information for ELinks\. It can be used to configure the behaviour of ELinks in a wide variety of ways: protocol behaviour, keybindings, colors used for rendering and for the user interface\. +The elinks\&.conf file contains configuration information for ELinks\&. It can be used to configure the behaviour of ELinks in a wide variety of ways: protocol behaviour, keybindings, colors used for rendering and for the user interface\&. .sp -It is read at startup and saved only when requested\. All options described in this document can be fully configured from within ELinks so no editing of elinks\.conf is needed\. +It is read at startup and saved only when requested\&. All options described in this document can be fully configured from within ELinks so no editing of elinks\&.conf is needed\&. .sp -Note that MIME\-related options used for specifying handlers of various MIME types are NOT described in this document\. Documentation for these options can be found at the ELinks homepage\. Keybindings can also be specified in elinks\.conf\. This is described in \fBelinkskeys\fR(5)\. +Note that MIME\-related options used for specifying handlers of various MIME types are NOT described in this document\&. Documentation for these options can be found at the ELinks homepage\&. Keybindings can also be specified in elinks\&.conf\&. This is described in \fBelinkskeys\fR(5)\&. .sp .SH "SYNTAX" -The syntax of the configuration file is very simple\. The elinks\.conf file is a free\-form ASCII text file\. The file may contain extra tabs and newlines for formatting purposes\. Keywords in the file are case\-sensitive\. Comments may be placed anywhere within the file (except within quotes)\. Comments begin with the # character and end at the end of the line\. +The syntax of the configuration file is very simple\&. The elinks\&.conf file is a free\-form ASCII text file\&. The file may contain extra tabs and newlines for formatting purposes\&. Keywords in the file are case\-sensitive\&. Comments may be placed anywhere within the file (except within quotes)\&. Comments begin with the # character and end at the end of the line\&. .sp .SH "EXAMPLES" Some sample settings: @@ -39,23 +39,23 @@ Some sample settings: .RS 4 .nf # Use asynchronous DNS resolver? -set connection\.async_dns = 1 -# horizontal text margin\. -set document\.browse\.margin_width = 3 -# Default document codepage\. -set document\.codepage\.assume = "ISO\-8859\-1" +set connection\&.async_dns = 1 +# horizontal text margin\&. +set document\&.browse\&.margin_width = 3 +# Default document codepage\&. +set document\&.codepage\&.assume = "ISO\-8859\-1" # User defined protocol handlers -set protocol\.user\.mailto\.unix = "mutt %h \-s \e"%s\e"" +set protocol\&.user\&.mailto\&.unix = "mutt %h \-s \e"%s\e"" .fi .RE .SH "OPTIONS" .PP bookmarks .RS 4 -Bookmark options\. +Bookmark options\&. .RE .PP -bookmarks\.file_format (default: 0) +bookmarks\&.file_format (default: 0) .RS 4 File format for bookmarks (affects both reading and saving): .sp @@ -70,21 +70,21 @@ format .RE .RE .PP -bookmarks\.folder_state [0|1] (default: 1) +bookmarks\&.folder_state [0|1] (default: 1) .RS 4 When saving bookmarks also store whether folders are expanded or not, so the look of the bookmark dialog is kept across \fIELinks\fR -sessions\. If disabled all folders will appear unexpanded next time +sessions\&. If disabled all folders will appear unexpanded next time \fIELinks\fR -is run\. +is run\&. .RE .PP config .RS 4 -Configuration handling options\. +Configuration handling options\&. .RE .PP -config\.comments (default: 3) +config\&.comments (default: 3) .RS 4 Amount of comments automatically written to the config file: .sp @@ -105,12 +105,12 @@ Amount of comments automatically written to the config file: .RE .RE .PP -config\.indentation (default: 2) +config\&.indentation (default: 2) .RS 4 -Shift width of one indentation level in the configuration file\. Zero means that no indentation is performed at all when saving the configuration\. +Shift width of one indentation level in the configuration file\&. Zero means that no indentation is performed at all when saving the configuration\&. .RE .PP -config\.saving_style (default: 3) +config\&.saving_style (default: 3) .RS 4 Determines what happens when you tell \fIELinks\fR @@ -135,97 +135,97 @@ session are added at the end of the file .RE .RE .PP -config\.i18n [0|1] (default: 0) +config\&.i18n [0|1] (default: 0) .RS 4 -If set to 1, comments in the configuration file will be translated to the language used by UI\. Note that if you have different language set in different terminals, the language used in the configuration file MAY be the same as on the terminal where you saved the file, but it should be generally considered unpredictable\. +If set to 1, comments in the configuration file will be translated to the language used by UI\&. Note that if you have different language set in different terminals, the language used in the configuration file MAY be the same as on the terminal where you saved the file, but it should be generally considered unpredictable\&. .RE .PP -config\.saving_style_w [0|1] (default: 0) +config\&.saving_style_w [0|1] (default: 0) .RS 4 -This is internal option used when displaying a warning about obsolete config\.saving_style\. You shouldn\'t touch it\. +This is internal option used when displaying a warning about obsolete config\&.saving_style\&. You shouldn\'t touch it\&. .RE .PP -config\.show_template [0|1] (default: 0) +config\&.show_template [0|1] (default: 0) .RS 4 -Show template options in autocreated trees in the options manager and save them to the configuration file\. +Show template options in autocreated trees in the options manager and save them to the configuration file\&. .RE .PP connection .RS 4 -Connection options\. +Connection options\&. .RE .PP -connection\.ssl +connection\&.ssl .RS 4 -SSL options\. +SSL options\&. .RE .PP -connection\.ssl\.client_cert +connection\&.ssl\&.client_cert .RS 4 -X509 client certificate options\. +X509 client certificate options\&. .RE .PP -connection\.ssl\.client_cert\.enable [0|1] (default: 0) +connection\&.ssl\&.client_cert\&.enable [0|1] (default: 0) .RS 4 -Enable or not the sending of X509 client certificates to servers which request them\. +Enable or not the sending of X509 client certificates to servers which request them\&. .RE .PP -connection\.ssl\.client_cert\.file (default: "") +connection\&.ssl\&.client_cert\&.file (default: "") .RS 4 -The location of a file containing the client certificate and unencrypted private key in PEM format\. If unset, the file pointed to by the X509_CLIENT_CERT variable is used instead\. +The location of a file containing the client certificate and unencrypted private key in PEM format\&. If unset, the file pointed to by the X509_CLIENT_CERT variable is used instead\&. .RE .PP -connection\.ssl\.cert_verify [0|1] (default: 0) +connection\&.ssl\&.cert_verify [0|1] (default: 0) .RS 4 -Verify the peer\'s SSL certificate\. Note that this needs extensive configuration of OpenSSL by the user\. +Verify the peer\'s SSL certificate\&. Note that this needs extensive configuration of OpenSSL by the user\&. .RE .PP -connection\.async_dns [0|1] (default: 1) +connection\&.async_dns [0|1] (default: 1) .RS 4 -Whether to use asynchronous DNS resolving\. +Whether to use asynchronous DNS resolving\&. .RE .PP -connection\.max_connections (default: 10) +connection\&.max_connections (default: 10) .RS 4 -Maximum number of concurrent connections\. +Maximum number of concurrent connections\&. .RE .PP -connection\.max_connections_to_host (default: 2) +connection\&.max_connections_to_host (default: 2) .RS 4 -Maximum number of concurrent connections to a given host\. +Maximum number of concurrent connections to a given host\&. .RE .PP -connection\.receive_timeout (default: 120) +connection\&.receive_timeout (default: 120) .RS 4 -Receive timeout (in seconds)\. +Receive timeout (in seconds)\&. .RE .PP -connection\.retries (default: 3) +connection\&.retries (default: 3) .RS 4 -Number of tries to establish a connection\. Zero means try forever\. +Number of tries to establish a connection\&. Zero means try forever\&. .RE .PP -connection\.try_ipv4 [0|1] (default: 1) +connection\&.try_ipv4 [0|1] (default: 1) .RS 4 -Whether to try to connect to a host over IPv4\. Note that if connection\.try_ipv6 is enabled too, it takes precedence\. And better do not touch this at all unless you are sure what are you doing\. Note that you can also force a given protocol to be used on a per\-connection basis by using a URL in the style of e\.g\. http4://elinks\.cz/\. +Whether to try to connect to a host over IPv4\&. Note that if connection\&.try_ipv6 is enabled too, it takes precedence\&. And better do not touch this at all unless you are sure what are you doing\&. Note that you can also force a given protocol to be used on a per\-connection basis by using a URL in the style of e\&.g\&. http4://elinks\&.cz/\&. .RE .PP -connection\.try_ipv6 [0|1] (default: 1) +connection\&.try_ipv6 [0|1] (default: 1) .RS 4 -Whether to try to connect to a host over IPv6\. Note that you can also force a given protocol to be used on a per\-connection basis by using a URL in the style of e\.g\. http6://elinks\.cz/\. +Whether to try to connect to a host over IPv6\&. Note that you can also force a given protocol to be used on a per\-connection basis by using a URL in the style of e\&.g\&. http6://elinks\&.cz/\&. .RE .PP -connection\.unrestartable_receive_timeout (default: 600) +connection\&.unrestartable_receive_timeout (default: 600) .RS 4 -Timeout for non\-restartable connections (in seconds)\. +Timeout for non\-restartable connections (in seconds)\&. .RE .PP cookies .RS 4 -Cookies options\. +Cookies options\&. .RE .PP -cookies\.accept_policy (default: 2) +cookies\&.accept_policy (default: 2) .RS 4 Cookies accepting policy: .sp @@ -242,7 +242,7 @@ Cookies accepting policy: .RE .RE .PP -cookies\.max_age (default: \-1) +cookies\&.max_age (default: \-1) .RS 4 Cookie maximum age (in days): .sp @@ -259,47 +259,47 @@ Cookie maximum age (in days): .RE .RE .PP -cookies\.paranoid_security [0|1] (default: 0) +cookies\&.paranoid_security [0|1] (default: 0) .RS 4 -When enabled, we\'ll require three dots in cookies domain for all non\-international domains (instead of just two dots)\. Some countries have generic second level domains (eg\. \.com\.pl, \.co\.uk) and allowing sites to set cookies for these generic domains could potentially be very bad\. Note, it is off by default as it breaks a lot of sites\. +When enabled, we\'ll require three dots in cookies domain for all non\-international domains (instead of just two dots)\&. Some countries have generic second level domains (eg\&. \&.com\&.pl, \&.co\&.uk) and allowing sites to set cookies for these generic domains could potentially be very bad\&. Note, it is off by default as it breaks a lot of sites\&. .RE .PP -cookies\.save [0|1] (default: 1) +cookies\&.save [0|1] (default: 1) .RS 4 -Whether cookies should be loaded from and saved to disk\. +Whether cookies should be loaded from and saved to disk\&. .RE .PP -cookies\.resave [0|1] (default: 1) +cookies\&.resave [0|1] (default: 1) .RS 4 -Save cookies after each change in cookies list? No effect when cookie saving (cookies\.save) is off\. +Save cookies after each change in cookies list? No effect when cookie saving (cookies\&.save) is off\&. .RE .PP document .RS 4 -Document options\. +Document options\&. .RE .PP -document\.browse +document\&.browse .RS 4 -Document browsing options (mainly interactivity)\. +Document browsing options (mainly interactivity)\&. .RE .PP -document\.browse\.accesskey +document\&.browse\&.accesskey .RS 4 -Options for handling of link access keys\. An HTML document can use the ACCESSKEY attribute to assign an access key to an element\. When an access key is pressed, the corresponding element will be given focus\. +Options for handling of link access keys\&. An HTML document can use the ACCESSKEY attribute to assign an access key to an element\&. When an access key is pressed, the corresponding element will be given focus\&. .RE .PP -document\.browse\.accesskey\.auto_follow [0|1] (default: 0) +document\&.browse\&.accesskey\&.auto_follow [0|1] (default: 0) .RS 4 -Automatically follow a link or submit a form if appropriate accesskey is pressed \- this is the standard behaviour, but it\'s considered dangerous\. +Automatically follow a link or submit a form if appropriate accesskey is pressed \- this is the standard behaviour, but it\'s considered dangerous\&. .RE .PP -document\.browse\.accesskey\.display [0|1] (default: 0) +document\&.browse\&.accesskey\&.display [0|1] (default: 0) .RS 4 -Display access key in link info\. +Display access key in link info\&. .RE .PP -document\.browse\.accesskey\.priority (default: 0) +document\&.browse\&.accesskey\&.priority (default: 0) .RS 4 Priority of \'accesskey\' HTML attribute: .sp @@ -316,53 +316,53 @@ Priority of \'accesskey\' HTML attribute: .RE .RE .PP -document\.browse\.forms +document\&.browse\&.forms .RS 4 -Options for handling of the forms interaction\. +Options for handling of the forms interaction\&. .RE .PP -document\.browse\.forms\.auto_submit [0|1] (default: 1) +document\&.browse\&.forms\&.auto_submit [0|1] (default: 1) .RS 4 -Automagically submit a form when enter is pressed with a text field selected\. +Automagically submit a form when enter is pressed with a text field selected\&. .RE .PP -document\.browse\.forms\.confirm_submit [0|1] (default: 1) +document\&.browse\&.forms\&.confirm_submit [0|1] (default: 1) .RS 4 -Ask for confirmation when submitting a form\. +Ask for confirmation when submitting a form\&. .RE .PP -document\.browse\.forms\.input_size (default: 20) +document\&.browse\&.forms\&.input_size (default: 20) .RS 4 -Default form input size if none is specified\. +Default form input size if none is specified\&. .RE .PP -document\.browse\.forms\.insert_mode [0|1] (default: 1) +document\&.browse\&.forms\&.insert_mode [0|1] (default: 1) .RS 4 -The setting for this option affects how key presses are handled when one selects a text\-input form\-field\. When enabled, one must explicitly \'enter\' a selected text\-field to edit it; this prevents text fields from capturing key presses, such as presses of a scroll key, when it is inadvertently selected\. When disabled, key presses are always inserted into a selected text field\. +The setting for this option affects how key presses are handled when one selects a text\-input form\-field\&. When enabled, one must explicitly \'enter\' a selected text\-field to edit it; this prevents text fields from capturing key presses, such as presses of a scroll key, when it is inadvertently selected\&. When disabled, key presses are always inserted into a selected text field\&. .RE .PP -document\.browse\.forms\.editor (default: "") +document\&.browse\&.forms\&.editor (default: "") .RS 4 Path to the executable that \fIELinks\fR -should launch when the user requests to edit a textarea with an external editor\. If this is blank, +should launch when the user requests to edit a textarea with an external editor\&. If this is blank, \fIELinks\fR -will use the value of the environmental variable $EDITOR\. If $EDITOR is empty or not set, +will use the value of the environmental variable $EDITOR\&. If $EDITOR is empty or not set, \fIELinks\fR -will then default to "vi"\. +will then default to "vi"\&. .RE .PP -document\.browse\.forms\.show_formhist [0|1] (default: 0) +document\&.browse\&.forms\&.show_formhist [0|1] (default: 0) .RS 4 -Ask if a login form should be saved to file or not\. This option only disables the dialog, already saved login forms are unaffected\. +Ask if a login form should be saved to file or not\&. This option only disables the dialog, already saved login forms are unaffected\&. .RE .PP -document\.browse\.images +document\&.browse\&.images .RS 4 -Options for handling of images\. +Options for handling of images\&. .RE .PP -document\.browse\.images\.display_style (default: 2) +document\&.browse\&.images\&.display_style (default: 2) .RS 4 Display style for image tags when displayed: .sp @@ -383,7 +383,7 @@ Display style for image tags when displayed: .RE .RE .PP -document\.browse\.images\.filename_maxlen (default: 0) +document\&.browse\&.images\&.filename_maxlen (default: 0) .RS 4 Maximum length of image filename when displayed: .sp @@ -396,7 +396,7 @@ Maximum length of image filename when displayed: .RE .RE .PP -document\.browse\.images\.image_link_tagging (default: 1) +document\&.browse\&.images\&.image_link_tagging (default: 1) .RS 4 When to enclose image links: .sp @@ -413,17 +413,17 @@ When to enclose image links: .RE .RE .PP -document\.browse\.images\.image_link_prefix (default: "[") +document\&.browse\&.images\&.image_link_prefix (default: "[") .RS 4 -Prefix string to use to mark image links\. +Prefix string to use to mark image links\&. .RE .PP -document\.browse\.images\.image_link_suffix (default: "]") +document\&.browse\&.images\&.image_link_suffix (default: "]") .RS 4 -Suffix string to use to mark image links\. +Suffix string to use to mark image links\&. .RE .PP -document\.browse\.images\.label_maxlen (default: 0) +document\&.browse\&.images\&.label_maxlen (default: 0) .RS 4 Maximum length of image label (alt/title): .sp @@ -436,72 +436,72 @@ Maximum length of image label (alt/title): .RE .RE .PP -document\.browse\.images\.show_as_links [0|1] (default: 0) +document\&.browse\&.images\&.show_as_links [0|1] (default: 0) .RS 4 -Display links to images without an alt attribute\. If this option is off, these images are completely invisible\. +Display links to images without an alt attribute\&. If this option is off, these images are completely invisible\&. .RE .PP -document\.browse\.images\.show_any_as_links [0|1] (default: 1) +document\&.browse\&.images\&.show_any_as_links [0|1] (default: 1) .RS 4 -Display links to any images in the document, regardless of them having an alt attribute or not\. If this option is off, the alt attribute contents is shown, but as normal text, not selectable as a link\. +Display links to any images in the document, regardless of them having an alt attribute or not\&. If this option is off, the alt attribute contents is shown, but as normal text, not selectable as a link\&. .RE .PP -document\.browse\.links +document\&.browse\&.links .RS 4 -Options for handling of links to other documents\. +Options for handling of links to other documents\&. .RE .PP -document\.browse\.links\.active_link +document\&.browse\&.links\&.active_link .RS 4 -Options for the active link\. +Options for the active link\&. .RE .PP -document\.browse\.links\.active_link\.colors +document\&.browse\&.links\&.active_link\&.colors .RS 4 -Active link colors\. +Active link colors\&. .RE .PP -document\.browse\.links\.active_link\.colors\.background (default: blue) +document\&.browse\&.links\&.active_link\&.colors\&.background (default: blue) .RS 4 -Default background color\. +Default background color\&. .RE .PP -document\.browse\.links\.active_link\.colors\.text (default: black) +document\&.browse\&.links\&.active_link\&.colors\&.text (default: black) .RS 4 -Default text color\. +Default text color\&. .RE .PP -document\.browse\.links\.active_link\.enable_color [0|1] (default: 0) +document\&.browse\&.links\&.active_link\&.enable_color [0|1] (default: 0) .RS 4 -Enable use of the active link background and text color settings instead of the link colors from the document\. +Enable use of the active link background and text color settings instead of the link colors from the document\&. .RE .PP -document\.browse\.links\.active_link\.bold [0|1] (default: 0) +document\&.browse\&.links\&.active_link\&.bold [0|1] (default: 0) .RS 4 -Make the active link text bold\. +Make the active link text bold\&. .RE .PP -document\.browse\.links\.active_link\.invert [0|1] (default: 1) +document\&.browse\&.links\&.active_link\&.invert [0|1] (default: 1) .RS 4 -Invert the fore\- and background color so the link stands out\. +Invert the fore\- and background color so the link stands out\&. .RE .PP -document\.browse\.links\.active_link\.underline [0|1] (default: 0) +document\&.browse\&.links\&.active_link\&.underline [0|1] (default: 0) .RS 4 -Underline the active link\. +Underline the active link\&. .RE .PP -document\.browse\.links\.color_dirs [0|1] (default: 1) +document\&.browse\&.links\&.color_dirs [0|1] (default: 1) .RS 4 -Highlight links to directories in FTP and local directory listing\. +Highlight links to directories in FTP and local directory listing\&. .RE .PP -document\.browse\.links\.numbering [0|1] (default: 0) +document\&.browse\&.links\&.numbering [0|1] (default: 0) .RS 4 -Display numbers next to the links\. +Display numbers next to the links\&. .RE .PP -document\.browse\.links\.target_blank (default: 0) +document\&.browse\&.links\&.target_blank (default: 0) .RS 4 Define how to handle links having target=_blank set: .sp @@ -522,26 +522,26 @@ Define how to handle links having target=_blank set: .RE .RE .PP -document\.browse\.links\.use_tabindex [0|1] (default: 1) +document\&.browse\&.links\&.use_tabindex [0|1] (default: 1) .RS 4 -Whether to navigate links using tabindex specified ordering\. The TABINDEX attribute in HTML elements specifies the order in which links should receive focus when using the keyboard to navigate the document\. +Whether to navigate links using tabindex specified ordering\&. The TABINDEX attribute in HTML elements specifies the order in which links should receive focus when using the keyboard to navigate the document\&. .RE .PP -document\.browse\.links\.missing_fragment [0|1] (default: 1) +document\&.browse\&.links\&.missing_fragment [0|1] (default: 1) .RS 4 -Open a message box when document has no tag with given id\. +Open a message box when document has no tag with given id\&. .RE .PP -document\.browse\.links\.number_keys_select_link (default: 1) +document\&.browse\&.links\&.number_keys_select_link (default: 1) .RS 4 -Number keys select links rather than specify command prefixes\. This is a tristate: +Number keys select links rather than specify command prefixes\&. This is a tristate: .sp .RS 4 \h'-04'\(bu\h'+03'0: means never .RE .sp .RS 4 -\h'-04'\(bu\h'+03'1: means if document\.browse\.links\.numbering = 1 +\h'-04'\(bu\h'+03'1: means if document\&.browse\&.links\&.numbering = 1 .RE .sp .RS 4 @@ -549,52 +549,52 @@ Number keys select links rather than specify command prefixes\. This is a trista .RE .RE .PP -document\.browse\.links\.warn_malicious [0|1] (default: 1) +document\&.browse\&.links\&.warn_malicious [0|1] (default: 1) .RS 4 -When following a link the user ID part of the URI is checked and if a maliciously crafted URI is detected a warning dialog will ask before following the link\. +When following a link the user ID part of the URI is checked and if a maliciously crafted URI is detected a warning dialog will ask before following the link\&. .RE .PP -document\.browse\.links\.wraparound [0|1] (default: 0) +document\&.browse\&.links\&.wraparound [0|1] (default: 0) .RS 4 -When pressing \'down\' on the last link, jump to the first one, and vice versa\. +When pressing \'down\' on the last link, jump to the first one, and vice versa\&. .RE .PP -document\.browse\.scrolling +document\&.browse\&.scrolling .RS 4 -Scrolling options\. +Scrolling options\&. .RE .PP -document\.browse\.scrolling\.horizontal_extended [0|1] (default: 1) +document\&.browse\&.scrolling\&.horizontal_extended [0|1] (default: 1) .RS 4 -Whether to allow horizontal scrolling when the document does not extend off the screen\. Useful for copy/paste operations\. +Whether to allow horizontal scrolling when the document does not extend off the screen\&. Useful for copy/paste operations\&. .RE .PP -document\.browse\.scrolling\.horizontal_step (default: 8) +document\&.browse\&.scrolling\&.horizontal_step (default: 8) .RS 4 -Number of columns to scroll when a key bound to scroll\-left or scroll\- right is pressed and no prefix was given\. +Number of columns to scroll when a key bound to scroll\-left or scroll\- right is pressed and no prefix was given\&. .RE .PP -document\.browse\.scrolling\.margin (default: 3) +document\&.browse\&.scrolling\&.margin (default: 3) .RS 4 -Size of the virtual margin \- when you click inside of that margin, document scrolls in that direction\. +Size of the virtual margin \- when you click inside of that margin, document scrolls in that direction\&. .RE .PP -document\.browse\.scrolling\.vertical_step (default: 2) +document\&.browse\&.scrolling\&.vertical_step (default: 2) .RS 4 -Number of lines to scroll when a key bound to scroll\-up or scroll\- down is pressed and no prefix was given\. +Number of lines to scroll when a key bound to scroll\-up or scroll\- down is pressed and no prefix was given\&. .RE .PP -document\.browse\.search +document\&.browse\&.search .RS 4 -Options for searching\. +Options for searching\&. .RE .PP -document\.browse\.search\.case [0|1] (default: 0) +document\&.browse\&.search\&.case [0|1] (default: 0) .RS 4 -Whether the search should match the document text while maintaining case sensitivity\. +Whether the search should match the document text while maintaining case sensitivity\&. .RE .PP -document\.browse\.search\.regex (default: 0) +document\&.browse\&.search\&.regex (default: 0) .RS 4 Enable searching with regular expressions: .sp @@ -611,17 +611,17 @@ Enable searching with regular expressions: .RE .RE .PP -document\.browse\.search\.show_hit_top_bottom [0|1] (default: 1) +document\&.browse\&.search\&.show_hit_top_bottom [0|1] (default: 1) .RS 4 -Whether to show a dialog when the search hits the top or bottom of the document\. +Whether to show a dialog when the search hits the top or bottom of the document\&. .RE .PP -document\.browse\.search\.wraparound [0|1] (default: 1) +document\&.browse\&.search\&.wraparound [0|1] (default: 1) .RS 4 -Wrap around when searching\. Currently only used for typeahead\. +Wrap around when searching\&. Currently only used for typeahead\&. .RE .PP -document\.browse\.search\.show_not_found (default: 2) +document\&.browse\&.search\&.show_not_found (default: 2) .RS 4 How to inform the user when nothing is matched: .sp @@ -638,9 +638,9 @@ How to inform the user when nothing is matched: .RE .RE .PP -document\.browse\.search\.typeahead (default: 0) +document\&.browse\&.search\&.typeahead (default: 0) .RS 4 -Start typeahead searching when an unbound key is pressed without any modifiers\. Note that most keys have default bindings, so this feature will not be useful unless you unbind them\. +Start typeahead searching when an unbound key is pressed without any modifiers\&. Note that most keys have default bindings, so this feature will not be useful unless you unbind them\&. .RE .PP when you (when you press a key bound to search\-typeahead or similar) @@ -648,130 +648,130 @@ when you (when you press a key bound to search\-typeahead or similar) 1 automatically starts typeahead searching thru link text 2 automatically starts typeahead searching thru all document text .RE .PP -document\.browse\.margin_width (default: 3) +document\&.browse\&.margin_width (default: 3) .RS 4 -Horizontal text margin\. +Horizontal text margin\&. .RE .PP -document\.browse\.refresh [0|1] (default: 1) +document\&.browse\&.refresh [0|1] (default: 1) .RS 4 Automatically follow document\-specified refresh directives (\fI refresh\fR -tags)\. Web\-page authors use these to instruct the browser to reload a document at a given interval or to load another page\. Regardless of the value the refresh URI is accessible as a link\. Use the document\.browse\.minimum_refresh_time to control the minimum number of seconds a refresh will wait\. +tags)\&. Web\-page authors use these to instruct the browser to reload a document at a given interval or to load another page\&. Regardless of the value the refresh URI is accessible as a link\&. Use the document\&.browse\&.minimum_refresh_time to control the minimum number of seconds a refresh will wait\&. .RE .PP -document\.browse\.minimum_refresh_time (default: 1000) +document\&.browse\&.minimum_refresh_time (default: 1000) .RS 4 -The minimum number of milliseconds that should pass before refreshing\. If set to zero the document refresh time is used unchanged\. It can fix going back in history for some sites that use refreshing with zero values\. +The minimum number of milliseconds that should pass before refreshing\&. If set to zero the document refresh time is used unchanged\&. It can fix going back in history for some sites that use refreshing with zero values\&. .RE .PP -document\.browse\.table_move_order [0|1] (default: 0) +document\&.browse\&.table_move_order [0|1] (default: 0) .RS 4 -Move by columns in table, instead of rows\. +Move by columns in table, instead of rows\&. .RE .PP -document\.cache +document\&.cache .RS 4 -Cache options\. +Cache options\&. .RE .PP -document\.cache\.format +document\&.cache\&.format .RS 4 -Format cache options\. +Format cache options\&. .RE .PP -document\.cache\.format\.size (default: 5) +document\&.cache\&.format\&.size (default: 5) .RS 4 -Number of cached formatted pages\. Do not get too generous here, \'formatted\' means that all the accompanying structures are kept in memory so that you get the cached document immediatelly, but these structures may take a lot \- 2x the size of the HTML source is probably not unusual, but it can be even more if the document consists of a lot of short lines (padded right, if possible) and links and not much other markup\. So if you set this to 256 and then you don\'t like your +Number of cached formatted pages\&. Do not get too generous here, \'formatted\' means that all the accompanying structures are kept in memory so that you get the cached document immediatelly, but these structures may take a lot \- 2x the size of the HTML source is probably not unusual, but it can be even more if the document consists of a lot of short lines (padded right, if possible) and links and not much other markup\&. So if you set this to 256 and then you don\'t like your \fIELinks\fR -eating 90M, don\'t come complaining to us\. ;\-) Also note that the format cache itself is not counted to the memory cache size, but the HTML source of the formatted documents is always cached, even if it is over the memory cache size threshold\. (Then of course no other documents can be cached\.) +eating 90M, don\'t come complaining to us\&. ;\-) Also note that the format cache itself is not counted to the memory cache size, but the HTML source of the formatted documents is always cached, even if it is over the memory cache size threshold\&. (Then of course no other documents can be cached\&.) .RE .PP -document\.cache\.memory +document\&.cache\&.memory .RS 4 -Memory cache options\. +Memory cache options\&. .RE .PP -document\.cache\.memory\.size (default: 1048576) +document\&.cache\&.memory\&.size (default: 1048576) .RS 4 -Memory cache size (in bytes)\. +Memory cache size (in bytes)\&. .RE .PP -document\.cache\.cache_redirects [0|1] (default: 0) +document\&.cache\&.cache_redirects [0|1] (default: 0) .RS 4 -Cache even redirects sent by server (usually thru HTTP by a 302 HTTP code and a Location header)\. This was the original behaviour for quite some time, but it causes problems in a situation very common to various web login systems \- frequently, when accessing a certain location, they will redirect you to a login page if they don\'t receive an auth cookie, the login page then gives you the cookie and redirects you back to the original page, but there you have already cached redirect back to the login page! If this option has value of 0, this malfunction is fixed, but occasionally you may get superfluous (depends on how you take it ;\-) requests to the server\. If this option has value of 1, experienced users can still workaround it by clever combination of usage of reload, jumping around in session history and hitting ctrl+enter\. Note that this option is checked when retrieving the information from cache, not when saving it to cache \- thus if you enable it, even previous redirects will be taken from cache instead of asking the server\. +Cache even redirects sent by server (usually thru HTTP by a 302 HTTP code and a Location header)\&. This was the original behaviour for quite some time, but it causes problems in a situation very common to various web login systems \- frequently, when accessing a certain location, they will redirect you to a login page if they don\'t receive an auth cookie, the login page then gives you the cookie and redirects you back to the original page, but there you have already cached redirect back to the login page! If this option has value of 0, this malfunction is fixed, but occasionally you may get superfluous (depends on how you take it ;\-) requests to the server\&. If this option has value of 1, experienced users can still workaround it by clever combination of usage of reload, jumping around in session history and hitting ctrl+enter\&. Note that this option is checked when retrieving the information from cache, not when saving it to cache \- thus if you enable it, even previous redirects will be taken from cache instead of asking the server\&. .RE .PP -document\.cache\.ignore_cache_control [0|1] (default: 1) +document\&.cache\&.ignore_cache_control [0|1] (default: 1) .RS 4 -Ignore Cache\-Control and Pragma server headers\. When set, the document is cached even with \'Cache\-Control: no\-cache\'\. +Ignore Cache\-Control and Pragma server headers\&. When set, the document is cached even with \'Cache\-Control: no\-cache\'\&. .RE .PP -document\.codepage +document\&.codepage .RS 4 -Charset options\. +Charset options\&. .RE .PP -document\.codepage\.assume (default: System) +document\&.codepage\&.assume (default: System) .RS 4 -Default document codepage\. \'System\' stands for a codepage determined by a selected locale\. +Default document codepage\&. \'System\' stands for a codepage determined by a selected locale\&. .RE .PP -document\.codepage\.force_assumed [0|1] (default: 0) +document\&.codepage\&.force_assumed [0|1] (default: 0) .RS 4 -Ignore charset info sent by server\. +Ignore charset info sent by server\&. .RE .PP -document\.colors +document\&.colors .RS 4 -Default document color settings\. +Default document color settings\&. .RE .PP -document\.colors\.text (default: gray75) +document\&.colors\&.text (default: gray75) .RS 4 -Default text color\. +Default text color\&. .RE .PP -document\.colors\.background (default: black) +document\&.colors\&.background (default: black) .RS 4 -Default background color\. +Default background color\&. .RE .PP -document\.colors\.link (default: blue) +document\&.colors\&.link (default: blue) .RS 4 -Default link color\. +Default link color\&. .RE .PP -document\.colors\.vlink (default: yellow) +document\&.colors\&.vlink (default: yellow) .RS 4 -Default visited link color\. +Default visited link color\&. .RE .PP -document\.colors\.image (default: darkolivegreen) +document\&.colors\&.image (default: darkolivegreen) .RS 4 -Default image link color\. +Default image link color\&. .RE .PP -document\.colors\.bookmark (default: hotpink) +document\&.colors\&.bookmark (default: hotpink) .RS 4 -Default bookmarked link color\. +Default bookmarked link color\&. .RE .PP -document\.colors\.dirs (default: yellow) +document\&.colors\&.dirs (default: yellow) .RS 4 -Default directory color\. See document\.browse\.links\.color_dirs option\. +Default directory color\&. See document\&.browse\&.links\&.color_dirs option\&. .RE .PP -document\.colors\.increase_contrast [0|1] (default: 1) +document\&.colors\&.increase_contrast [0|1] (default: 1) .RS 4 -Increase the contrast between the foreground and background colors to ensure readability\. For example it disallows dark colors on a black background\. Note, this is different from ensuring the contrast with the ensure_contrast option\. +Increase the contrast between the foreground and background colors to ensure readability\&. For example it disallows dark colors on a black background\&. Note, this is different from ensuring the contrast with the ensure_contrast option\&. .RE .PP -document\.colors\.ensure_contrast [0|1] (default: 1) +document\&.colors\&.ensure_contrast [0|1] (default: 1) .RS 4 -Makes sure that the back\- and foreground colors are never equal\. +Makes sure that the back\- and foreground colors are never equal\&. .RE .PP -document\.colors\.use_document_colors (default: 2) +document\&.colors\&.use_document_colors (default: 2) .RS 4 Use colors specified in document: .sp @@ -784,47 +784,47 @@ Use colors specified in document: .RE .sp .RS 4 -\h'-04'\(bu\h'+03'2: is use document colors, including background\. This can mostly look very impressive, but some sites will appear really ugly\. Note, that obviously if the background is not black, it will break the behaviour of transparency\. +\h'-04'\(bu\h'+03'2: is use document colors, including background\&. This can mostly look very impressive, but some sites will appear really ugly\&. Note, that obviously if the background is not black, it will break the behaviour of transparency\&. .RE .RE .PP -document\.css +document\&.css .RS 4 -Options concerning how to use CSS for styling documents\. +Options concerning how to use CSS for styling documents\&. .RE .PP -document\.css\.enable [0|1] (default: 1) +document\&.css\&.enable [0|1] (default: 1) .RS 4 -Enable adding of CSS style info to documents\. +Enable adding of CSS style info to documents\&. .RE .PP -document\.css\.import [0|1] (default: 1) +document\&.css\&.import [0|1] (default: 1) .RS 4 -When enabled any external style sheets that are imported from either CSS itself using the @import keyword or from the HTML using tags in the document header will also be downloaded\. +When enabled any external style sheets that are imported from either CSS itself using the @import keyword or from the HTML using tags in the document header will also be downloaded\&. .RE .PP -document\.css\.stylesheet (default: "") +document\&.css\&.stylesheet (default: "") .RS 4 -The path to the file containing the default user defined Cascading Style Sheet\. It can be used to control the basic layout of HTML documents\. The path is assumed to be relative to -\fIELinks\fR\' home directory\. Leave as "" to use built\-in document styling\. +The path to the file containing the default user defined Cascading Style Sheet\&. It can be used to control the basic layout of HTML documents\&. The path is assumed to be relative to +\fIELinks\fR\' home directory\&. Leave as "" to use built\-in document styling\&. .RE .PP -document\.download +document\&.download .RS 4 -Options regarding files downloading and handling\. +Options regarding files downloading and handling\&. .RE .PP -document\.download\.directory (default: "\./") +document\&.download\&.directory (default: "\&./") .RS 4 -Default download directory\. +Default download directory\&. .RE .PP -document\.download\.set_original_time [0|1] (default: 0) +document\&.download\&.set_original_time [0|1] (default: 0) .RS 4 -Set the timestamp of each downloaded file to the timestamp stored on the server\. +Set the timestamp of each downloaded file to the timestamp stored on the server\&. .RE .PP -document\.download\.overwrite (default: 2) +document\&.download\&.overwrite (default: 2) .RS 4 Prevent overwriting the local files: .sp @@ -833,7 +833,7 @@ Prevent overwriting the local files: .RE .sp .RS 4 -\h'-04'\(bu\h'+03'1: is add a suffix \.{number} (for example \'\.1\') to the name +\h'-04'\(bu\h'+03'1: is add a suffix \&.{number} (for example \'\&.1\') to the name .RE .sp .RS 4 @@ -841,7 +841,7 @@ Prevent overwriting the local files: .RE .RE .PP -document\.download\.notify_bell (default: 0) +document\&.download\&.notify_bell (default: 0) .RS 4 Audio notification when download is completed: .sp @@ -858,62 +858,62 @@ Audio notification when download is completed: .RE .RE .PP -document\.dump +document\&.dump .RS 4 -Dump output options\. +Dump output options\&. .RE .PP -document\.dump\.codepage (default: System) +document\&.dump\&.codepage (default: System) .RS 4 -Codepage used in dump output\. \'System\' stands for a codepage determined by a selected locale\. +Codepage used in dump output\&. \'System\' stands for a codepage determined by a selected locale\&. .RE .PP -document\.dump\.footer (default: "") +document\&.dump\&.footer (default: "") .RS 4 -Footer string used in dumps\. %u is substituted by URL\. +Footer string used in dumps\&. %u is substituted by URL\&. .RE .PP -document\.dump\.header (default: "") +document\&.dump\&.header (default: "") .RS 4 -Header string used in dumps\. %u is substituted by URL\. +Header string used in dumps\&. %u is substituted by URL\&. .RE .PP -document\.dump\.numbering [0|1] (default: 1) +document\&.dump\&.numbering [0|1] (default: 1) .RS 4 -Whether to print link numbers in dump output\. +Whether to print link numbers in dump output\&. .RE .PP -document\.dump\.references [0|1] (default: 1) +document\&.dump\&.references [0|1] (default: 1) .RS 4 -Whether to print references (URIs) of document links in dump output\. +Whether to print references (URIs) of document links in dump output\&. .RE .PP -document\.dump\.separator (document\.dump\.separator (default: "), document\.dump\.width (default: 80) +document\&.dump\&.separator (document\&.dump\&.separator (default: "), document\&.dump\&.width (default: 80) .RS 4 -Width of screen in characters when dumping documents\. +Width of screen in characters when dumping documents\&. .RE .PP -document\.history +document\&.history .RS 4 -History options\. +History options\&. .RE .PP -document\.history\.global +document\&.history\&.global .RS 4 -Global history options\. +Global history options\&. .RE .PP -document\.history\.global\.enable [0|1] (default: 1) +document\&.history\&.global\&.enable [0|1] (default: 1) .RS 4 -Enable global history ("history of all pages visited")\. +Enable global history ("history of all pages visited")\&. .RE .PP -document\.history\.global\.max_items (default: 1024) +document\&.history\&.global\&.max_items (default: 1024) .RS 4 -Maximum number of entries in the global history\. +Maximum number of entries in the global history\&. .RE .PP -document\.history\.global\.display_type (default: 0) +document\&.history\&.global\&.display_type (default: 0) .RS 4 What to display in global history dialog: .sp @@ -926,37 +926,37 @@ What to display in global history dialog: .RE .RE .PP -document\.history\.keep_unhistory [0|1] (default: 1) +document\&.history\&.keep_unhistory [0|1] (default: 1) .RS 4 -Keep unhistory ("forward history")\. +Keep unhistory ("forward history")\&. .RE .PP -document\.html +document\&.html .RS 4 -Options concerning the display of HTML pages\. +Options concerning the display of HTML pages\&. .RE .PP -document\.html\.display_frames [0|1] (default: 1) +document\&.html\&.display_frames [0|1] (default: 1) .RS 4 -Display frames\. +Display frames\&. .RE .PP -document\.html\.display_tables [0|1] (default: 1) +document\&.html\&.display_tables [0|1] (default: 1) .RS 4 -Display tables\. +Display tables\&. .RE .PP -document\.html\.display_subs [0|1] (default: 1) +document\&.html\&.display_subs [0|1] (default: 1) .RS 4 -Display subscripts (as [thing])\. +Display subscripts (as [thing])\&. .RE .PP -document\.html\.display_sups [0|1] (default: 1) +document\&.html\&.display_sups [0|1] (default: 1) .RS 4 -Display superscripts (as ^thing)\. +Display superscripts (as ^thing)\&. .RE .PP -document\.html\.link_display (default: 2) +document\&.html\&.link_display (default: 2) .RS 4 How to render tags from the HTML header: .sp @@ -985,160 +985,160 @@ How to render tags from the HTML header: .RE .RE .PP -document\.html\.underline_links [0|1] (default: 0) +document\&.html\&.underline_links [0|1] (default: 0) .RS 4 -Underline links\. +Underline links\&. .RE .PP -document\.html\.wrap_nbsp [0|1] (default: 0) +document\&.html\&.wrap_nbsp [0|1] (default: 0) .RS 4 -If set do not honour non breaking space (the nbsp entity) but allow to wrap the text\. This can help keeping the width of documents down so no horizontal scrolling is needed\. +If set do not honour non breaking space (the nbsp entity) but allow to wrap the text\&. This can help keeping the width of documents down so no horizontal scrolling is needed\&. .RE .PP -document\.plain +document\&.plain .RS 4 -Options concerning the display of plain text pages\. +Options concerning the display of plain text pages\&. .RE .PP -document\.plain\.display_links [0|1] (default: 0) +document\&.plain\&.display_links [0|1] (default: 0) .RS 4 -Display URIs in the document as links\. +Display URIs in the document as links\&. .RE .PP -document\.plain\.compress_empty_lines [0|1] (default: 0) +document\&.plain\&.compress_empty_lines [0|1] (default: 0) .RS 4 -Compress successive empty lines to only one in displayed text\. +Compress successive empty lines to only one in displayed text\&. .RE .PP -document\.uri_passing +document\&.uri_passing .RS 4 -Rules for passing URIs to external commands\. When one rule is defined the link and tab menu will have a menu item that makes it possible to pass the the link, frame or tab URI to an external command\. If several rules are defined the link and tab menu will have a submenu of items for each rule\. Note, this is mostly useful for launching graphical viewers, since there is no support for releasing the terminal while the command runs\. The action and submenus are also available by binding keys to the frame\-external\-command, the link\-external\-command, and the tab\-external\-command actions\. +Rules for passing URIs to external commands\&. When one rule is defined the link and tab menu will have a menu item that makes it possible to pass the the link, frame or tab URI to an external command\&. If several rules are defined the link and tab menu will have a submenu of items for each rule\&. Note, this is mostly useful for launching graphical viewers, since there is no support for releasing the terminal while the command runs\&. The action and submenus are also available by binding keys to the frame\-external\-command, the link\-external\-command, and the tab\-external\-command actions\&. .RE .PP -document\.uri_passing\._template_ (default: "") +document\&.uri_passing\&._template_ (default: "") .RS 4 -A rule for passing URI to an external command\. The format is: %c in the string means the current URL %% in the string means \'%\' Do _not_ put single\- or double\-quotes around %c\. +A rule for passing URI to an external command\&. The format is: %c in the string means the current URL %% in the string means \'%\' Do _not_ put single\- or double\-quotes around %c\&. .RE .PP ecmascript .RS 4 -ECMAScript options\. +ECMAScript options\&. .RE .PP -ecmascript\.enable [0|1] (default: 1) +ecmascript\&.enable [0|1] (default: 1) .RS 4 -Whether to run those scripts inside of documents\. +Whether to run those scripts inside of documents\&. .RE .PP -ecmascript\.error_reporting [0|1] (default: 0) +ecmascript\&.error_reporting [0|1] (default: 0) .RS 4 -Open a message box when a script reports an error\. +Open a message box when a script reports an error\&. .RE .PP -ecmascript\.ignore_noscript [0|1] (default: 0) +ecmascript\&.ignore_noscript [0|1] (default: 0) .RS 4 -Whether to ignore content enclosed by the