From 5a43c55c9e034fa068fe5a017cfa9cc7db7af3ea Mon Sep 17 00:00:00 2001 From: Kalle Olavi Niemitalo Date: Sat, 7 Mar 2009 20:48:38 +0200 Subject: [PATCH] Rewrap lines in option documentation. Documentation strings of most options used to contain a "\n" at the end of each source line. When the option manager displayed these strings, it treated each "\n" as a hard newline. On 80x24 terminals however, the option description window has only 60 columes available for the text (with the default setup.h), and the hard newlines were further apart, so the option manager wrapped the text a second time, resulting in rather ugly output where long lones are interleaved with short ones. This could also cause the text to take up too much vertical space and not fit in the window. Replace most of those hard newlines with spaces so that the option manager (or perhaps BFU) will take care of the wrapping. At the same time, rewrap the strings in source code so that the source lines are at most 79 columns wide. In some options though, there is a list of possible values and their meanings. In those lists, if the description of one value does not fit in one line, then continuation lines should be indented. The option manager and BFU are not currently able to do that. So, keep the hard newlines in those lists, but rewrap them to 60 columns so that they are less likely to require further wrapping at runtime. --- src/bfu/leds.c | 6 +- src/bookmarks/bookmarks.c | 19 +- src/config/cmdline.c | 134 ++++--- src/config/options.inc | 554 +++++++++++++++------------ src/cookies/cookies.c | 26 +- src/document/css/css.c | 17 +- src/ecmascript/ecmascript.c | 4 +- src/formhist/formhist.c | 4 +- src/globhist/globhist.c | 3 +- src/mime/backend/default.c | 46 +-- src/mime/backend/mailcap.c | 16 +- src/mime/backend/mimetypes.c | 7 +- src/mime/mime.c | 5 +- src/network/ssl/ssl.c | 31 +- src/protocol/bittorrent/bittorrent.c | 110 +++--- src/protocol/file/cgi.c | 3 +- src/protocol/file/file.c | 15 +- src/protocol/ftp/ftp.c | 11 +- src/protocol/http/http.c | 88 +++-- src/protocol/nntp/nntp.c | 9 +- src/protocol/protocol.c | 8 +- src/protocol/rewrite/rewrite.c | 46 ++- src/protocol/user.c | 9 +- 23 files changed, 647 insertions(+), 524 deletions(-) diff --git a/src/bfu/leds.c b/src/bfu/leds.c index 03f283fb..989acb60 100644 --- a/src/bfu/leds.c +++ b/src/bfu/leds.c @@ -80,7 +80,7 @@ static struct option_info led_options[] = { INIT_OPT_STRING("ui.clock", N_("Format"), "format", 0, "[%H:%M]", - N_("Format string for the digital clock. See the strftime(3)\n" + N_("Format string for the digital clock. See the strftime(3) " "manpage for details.")), /* Compatibility alias. Added: 2004-04-22, 0.9.CVS. */ @@ -93,8 +93,8 @@ static struct option_info led_options[] = { INIT_OPT_BOOL("ui.leds", N_("Enable"), "enable", 0, 1, - N_("Enable LEDs.\n" - "These visual indicators will inform you about various states.")), + N_("Enable LEDs. These visual indicators will inform you " + "about various states.")), NULL_OPTION_INFO, }; diff --git a/src/bookmarks/bookmarks.c b/src/bookmarks/bookmarks.c index 4b0e9132..bf8db05d 100644 --- a/src/bookmarks/bookmarks.c +++ b/src/bookmarks/bookmarks.c @@ -52,29 +52,32 @@ static struct option_info bookmark_options_info[] = { #ifdef CONFIG_XBEL_BOOKMARKS INIT_OPT_INT("bookmarks", N_("File format"), "file_format", 0, 0, 1, 0, - N_("File format for bookmarks (affects both reading and saving):\n" + N_("File format for bookmarks (affects both reading and " + "saving):\n" "0 is the default native ELinks format\n" "1 is XBEL universal XML bookmarks format")), #else INIT_OPT_INT("bookmarks", N_("File format"), "file_format", 0, 0, 1, 0, - N_("File format for bookmarks (affects both reading and saving):\n" + N_("File format for bookmarks (affects both reading and " + "saving):\n" "0 is the default native ELinks format\n" "1 is XBEL universal XML bookmarks format (DISABLED)")), #endif INIT_OPT_BOOL("bookmarks", N_("Save folder state"), "folder_state", 0, 1, - N_("When saving bookmarks also store whether folders are\n" - "expanded or not, so the look of the bookmark dialog is\n" - "kept across ELinks sessions. If disabled all folders will\n" + N_("When saving bookmarks also store whether folders are " + "expanded or not, so the look of the bookmark dialog is " + "kept across ELinks sessions. If disabled all folders will " "appear unexpanded next time ELinks is run.")), INIT_OPT_BOOL("ui.sessions", N_("Periodic snapshotting"), "snapshot", 0, 0, - N_("Automatically save a snapshot of all tabs periodically.\n" - "This will periodically bookmark the tabs of each terminal in a separate folder\n" - "for recovery after a crash.\n\n" + N_("Automatically save a snapshot of all tabs periodically. " + "This will periodically bookmark the tabs of each terminal " + "in a separate folder for recovery after a crash.\n" + "\n" "This feature requires bookmark support.")), NULL_OPTION_INFO diff --git a/src/config/cmdline.c b/src/config/cmdline.c index d521ce25..2c9956a3 100644 --- a/src/config/cmdline.c +++ b/src/config/cmdline.c @@ -736,10 +736,11 @@ struct option_info cmdline_options_info[] = { /* [gettext_accelerator_context(IGNORE)] */ INIT_OPT_BOOL("", N_("Restrict to anonymous mode"), "anonymous", 0, 0, - N_("Restricts ELinks so it can run on an anonymous account.\n" - "Local file browsing, downloads, and modification of options\n" - "will be disabled. Execution of viewers is allowed, but entries\n" - "in the association table can't be added or modified.")), + N_("Restricts ELinks 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.")), INIT_OPT_BOOL("", N_("Autosubmit first form"), "auto-submit", 0, 0, @@ -747,30 +748,30 @@ struct option_info cmdline_options_info[] = { INIT_OPT_INT("", N_("Clone internal session with given ID"), "base-session", 0, 0, INT_MAX, 0, - N_("Used internally when opening ELinks instances in new windows.\n" - "The ID maps to information that will be used when creating the\n" - "new instance. You don't want to use it.")), + N_("Used internally when opening ELinks 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.")), INIT_OPT_COMMAND("", NULL, "confdir", OPT_HIDDEN, redir_cmd, NULL), INIT_OPT_STRING("", N_("Name of directory with configuration file"), "config-dir", 0, "", - N_("Path of the directory ELinks will read and write its\n" - "config and runtime state files to instead of ~/.elinks.\n" - "If the path does not begin with a '/' it is assumed to be\n" + N_("Path of the directory ELinks 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 HOME directory.")), INIT_OPT_COMMAND("", N_("Print default configuration file to stdout"), "config-dump", 0, printconfigdump_cmd, - N_("Print a configuration file with options set to the built-in\n" - "defaults to stdout.")), + N_("Print a configuration file with options set to the " + "built-in defaults to stdout.")), INIT_OPT_COMMAND("", NULL, "conffile", OPT_HIDDEN, redir_cmd, NULL), INIT_OPT_STRING("", N_("Name of configuration file"), "config-file", 0, "elinks.conf", - N_("Name of the configuration file that all configuration\n" - "options will be read from and written to. It should be\n" + N_("Name of the configuration file that all configuration " + "options will be read from and written to. It should be " "relative to config-dir.")), INIT_OPT_COMMAND("", N_("Print help for configuration options"), @@ -779,17 +780,19 @@ struct option_info cmdline_options_info[] = { INIT_OPT_CMDALIAS("", N_("MIME type assumed for unknown document types"), "default-mime-type", 0, "mime.default_type", - N_("The default MIME type used for documents of unknown type.")), + N_("The default MIME type used for documents of unknown " + "type.")), INIT_OPT_BOOL("", N_("Ignore user-defined keybindings"), "default-keys", 0, 0, - N_("When set, all keybindings from configuration files will be\n" - "ignored. It forces use of default keybindings and will reset\n" - "user-defined ones on save.")), + N_("When set, all keybindings from configuration files will " + "be ignored. It forces use of default keybindings and will " + "reset user-defined ones on save.")), INIT_OPT_BOOL("", N_("Print formatted versions of given URLs to stdout"), "dump", 0, 0, - N_("Print formatted plain-text versions of given URLs to stdout.")), + N_("Print formatted plain-text versions of given URLs to " + "stdout.")), INIT_OPT_CMDALIAS("", N_("Codepage to use with -dump"), "dump-charset", 0, "document.dump.codepage", @@ -805,16 +808,16 @@ struct option_info cmdline_options_info[] = { INIT_OPT_COMMAND("", N_("Evaluate configuration file directive"), "eval", 0, eval_cmd, - N_("Specify configuration file directives on the command-line\n" - "which will be evaluated after all configuration files has been\n" - "read. Example usage:\n" + N_("Specify configuration file directives on the command-line " + "which will be evaluated after all configuration files has " + "been read. Example usage:\n" "\t-eval 'set protocol.file.allow_special_files = 1'")), /* lynx compatibility */ INIT_OPT_COMMAND("", N_("Interpret documents of unknown types as HTML"), "force-html", 0, forcehtml_cmd, - N_("Makes ELinks assume documents of unknown types are HTML.\n" - "Useful when using ELinks as an external viewer from MUAs.\n" + N_("Makes ELinks assume documents of unknown types are HTML. " + "Useful when using ELinks as an external viewer from MUAs. " "This is equivalent to -default-mime-type text/html.")), /* XXX: -?, -h and -help share the same caption and should be kept in @@ -829,9 +832,9 @@ struct option_info cmdline_options_info[] = { INIT_OPT_BOOL("", N_("Only permit local connections"), "localhost", 0, 0, - N_("Restricts ELinks to work offline and only connect to servers\n" - "with local addresses (ie. 127.0.0.1). No connections to remote\n" - "servers will be permitted.")), + N_("Restricts ELinks to work offline and only connect to " + "servers with local addresses (ie. 127.0.0.1). No connections " + "to remote servers will be permitted.")), INIT_OPT_COMMAND("", N_("Print detailed usage help and exit"), "long-help", 0, printhelp_cmd, @@ -839,40 +842,46 @@ struct option_info cmdline_options_info[] = { INIT_OPT_COMMAND("", N_("Look up specified host"), "lookup", 0, lookup_cmd, - N_("Look up specified host and print all DNS resolved IP addresses.")), + N_("Look up specified host and print all DNS resolved IP " + "addresses.")), INIT_OPT_BOOL("", N_("Run as separate instance"), "no-connect", 0, 0, - N_("Run ELinks as a separate instance instead of connecting to an\n" - "existing instance. Note that normally no runtime state files\n" - "(bookmarks, history, etc.) are written to the disk when this\n" - "option is used. See also -touch-files.")), + N_("Run ELinks 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.")), INIT_OPT_BOOL("", N_("Disable use of files in ~/.elinks"), "no-home", 0, 0, - N_("Disables creation and use of files in the user specific home\n" - "configuration directory (~/.elinks). It forces default configuration\n" - "values to be used and disables saving of runtime state files.")), + N_("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.")), INIT_OPT_CMDALIAS("", N_("Disable link numbering in dump output"), "no-numbering", OPT_ALIAS_NEGATE, "document.dump.numbering", N_("Prevents printing of link number in dump output.\n" + "\n" "Note that this really affects only -dump, nothing else.")), INIT_OPT_CMDALIAS("", N_("Disable printing of link references in dump output"), "no-references", OPT_ALIAS_NEGATE, "document.dump.references", - N_("Prevents printing of references (URIs) of document links\n" + N_("Prevents printing of references (URIs) of document links " "in dump output.\n" + "\n" "Note that this really affects only -dump, nothing else.")), INIT_OPT_COMMAND("", N_("Control an already running ELinks"), "remote", 0, remote_cmd, - N_("Control a remote ELinks instance by passing commands to it.\n" - "The option takes an additional argument containing the method\n" - "which should be invoked and any parameters that should be passed\n" - "to it. For ease of use, the additional method argument can be\n" - "omitted in which case any URL arguments will be opened in new\n" - "tabs in the remote instance.\n" + N_("Control a remote ELinks 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.\n" + "\n" "Following is a list of the supported methods:\n" "\tping() : look for a remote instance\n" "\topenURL() : prompt URL in current tab\n" @@ -885,20 +894,23 @@ struct option_info cmdline_options_info[] = { INIT_OPT_INT("", N_("Connect to session ring with given ID"), "session-ring", 0, 0, INT_MAX, 0, - N_("ID of session ring this ELinks session should connect to. ELinks\n" - "works in so-called session rings, whereby all instances of ELinks\n" - "are interconnected and share state (cache, bookmarks, cookies,\n" - "and so on). By default, all ELinks instances connect to session\n" - "ring 0. You can change that behaviour with this switch and form as\n" - "many session rings as you want. Obviously, if the session-ring with\n" - "this number doesn't exist yet, it's created and this ELinks instance\n" - "will become the master instance (that usually doesn't matter for you\n" - "as a user much). Note that you usually don't want to use this unless\n" - "you're a developer and you want to do some testing - if you want the\n" - "ELinks instances each running standalone, rather use the -no-connect\n" - "command-line option. Also note that normally no runtime state files\n" - "are written to the disk when this option is used. See also\n" - "-touch-files.")), + N_("ID of session ring this ELinks session should connect to. " + "ELinks works in so-called session rings, whereby all " + "instances of ELinks are interconnected and share state " + "(cache, bookmarks, cookies, and so on). By default, all " + "ELinks 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).\n" + "\n" + "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 " + "ELinks 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.")), INIT_OPT_BOOL("", N_("Print the source of given URLs to stdout"), "source", 0, 0, @@ -908,14 +920,14 @@ struct option_info cmdline_options_info[] = { INIT_OPT_BOOL("", N_("Touch files in ~/.elinks when running with -no-connect/-session-ring"), "touch-files", 0, 0, - N_("When enabled, runtime state files (bookmarks, history, etc.) are\n" - "written to disk, even when -no-connect or -session-ring is used.\n" - "The option has no effect if not used in conjunction with any of\n" - "these options.")), + N_("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.")), INIT_OPT_INT("", N_("Verbose level"), "verbose", 0, 0, VERBOSE_LEVELS - 1, VERBOSE_WARNINGS, - N_("The verbose level controls what messages are shown at\n" + N_("The verbose level controls what messages are shown at " "start up and while running:\n" "\t0 means only show serious errors\n" "\t1 means show serious errors and warnings\n" diff --git a/src/config/options.inc b/src/config/options.inc index 78de2bd5..b9c6a7f2 100644 --- a/src/config/options.inc +++ b/src/config/options.inc @@ -22,7 +22,8 @@ static struct option_info config_options_info[] = { INIT_OPT_INT("config", N_("Comments"), "comments", 0, 0, 3, 3, - N_("Amount of comments automatically written to the config file:\n" + N_("Amount of comments automatically written to the config " + "file:\n" "0 is no comments are written\n" "1 is only the \"blurb\" (name+type) is written\n" "2 is only the description is written\n" @@ -30,39 +31,41 @@ static struct option_info config_options_info[] = { INIT_OPT_INT("config", N_("Indentation"), "indentation", 0, 0, 16, 2, - N_("Shift width of one indentation level in the configuration\n" - "file. Zero means that no indentation is performed at all\n" + N_("Shift width of one indentation level in the configuration " + "file. Zero means that no indentation is performed at all " "when saving the configuration.")), INIT_OPT_INT("config", N_("Saving style"), "saving_style", 0, 0, 3, 3, - N_("Determines what happens when you tell ELinks to save options:\n" + N_("Determines what happens when you tell ELinks to save " + "options:\n" "0 is only values of current options are altered\n" - "1 is values of current options are altered and missing options\n" - " are added at the end of the file\n" + "1 is values of current options are altered and missing\n" + " options are added at the end of the file\n" "2 is the configuration file is rewritten from scratch\n" - "3 is values of current options are altered and missing options\n" - " CHANGED during this ELinks session are added at the end of\n" - " the file")), + "3 is values of current options are altered and missing\n" + " options CHANGED during this ELinks session are added at\n" + " the end of the file")), INIT_OPT_BOOL("config", N_("Comments localization"), "i18n", 0, 0, - N_("If set to 1, comments in the configuration file will be\n" - "translated to the language used by UI. Note that if you have\n" - "different language set in different terminals, the language\n" - "used in the configuration file MAY be the same as on the\n" - "terminal where you saved the file, but it should be generally\n" - "considered unpredictable.")), + N_("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.")), INIT_OPT_BOOL("config", N_("Saving style warnings"), "saving_style_w", 0, 0, - N_("This is internal option used when displaying a warning about\n" - "obsolete config.saving_style. You shouldn't touch it.")), + N_("This is internal option used when displaying a warning " + "about obsolete config.saving_style. You shouldn't touch " + "it.")), INIT_OPT_BOOL("config", N_("Show template"), "show_template", 0, 0, - N_("Show template options in autocreated trees in the options\n" + N_("Show template options in autocreated trees in the options " "manager and save them to the configuration file.")), /* Keep options in alphabetical order. */ @@ -83,12 +86,13 @@ static struct option_info config_options_info[] = { INIT_OPT_INT("connection", N_("Maximum connections per host"), "max_connections_to_host", 0, 1, 8, 2, - N_("Maximum number of concurrent connections to a given host.")), + N_("Maximum number of concurrent connections to a given " + "host.")), INIT_OPT_INT("connection", N_("Connection retries"), "retries", 0, 0, 16, 3, - N_("Number of tries to establish a connection.\n" - "Zero means try forever.")), + N_("Number of tries to establish a connection. " + "Zero means try forever.")), INIT_OPT_INT("connection", N_("Receive timeout"), "receive_timeout", 0, 1, 1800, 120, @@ -97,20 +101,22 @@ static struct option_info config_options_info[] = { #ifdef CONFIG_IPV6 INIT_OPT_BOOL("connection", N_("Try IPv4 when connecting"), "try_ipv4", 0, 1, - N_("Whether to try to connect to a host over IPv4.\n" - "Note that if connection.try_ipv6 is enabled too,\n" - "it takes precedence. And better do not touch this\n" + N_("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.\n" - "Note that you can also force a given protocol\n" - "to be used on a per-connection basis by using a URL\n" + "\n" + "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/.")), #else INIT_OPT_BOOL("connection", N_("Try IPv4 when connecting"), "try_ipv4", 0, 1, - N_("Whether to try to connect to a host over IPv4.\n" + N_("Whether to try to connect to a host over IPv4. " "Do not touch this option.\n" - "Note that you can also force a given protocol\n" - "to be used on a per-connection basis by using a URL\n" + "\n" + "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/.")), #endif @@ -118,8 +124,9 @@ static struct option_info config_options_info[] = { INIT_OPT_BOOL("connection", N_("Try IPv6 when connecting"), "try_ipv6", 0, 1, N_("Whether to try to connect to a host over IPv6.\n" - "Note that you can also force a given protocol\n" - "to be used on a per-connection basis by using a URL\n" + "\n" + "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/.")), #endif @@ -142,16 +149,16 @@ static struct option_info config_options_info[] = { INIT_OPT_TREE("document.browse", N_("Access keys"), "accesskey", 0, - N_("Options for handling of link access keys.\n" - "An HTML document can use the ACCESSKEY attribute to assign\n" - "an access key to an element. When an access key is pressed,\n" + N_("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.")), INIT_OPT_BOOL("document.browse.accesskey", N_("Automatic links following"), "auto_follow", 0, 0, - N_("Automatically follow a link or submit a form if appropriate\n" - "accesskey is pressed - this is the standard behaviour, but it's\n" - "considered dangerous.")), + N_("Automatically follow a link or submit a form if " + "appropriate accesskey is pressed - this is the standard " + "behaviour, but it's considered dangerous.")), INIT_OPT_BOOL("document.browse.accesskey", N_("Display access key in link info"), "display", 0, 0, @@ -160,8 +167,10 @@ static struct option_info config_options_info[] = { INIT_OPT_INT("document.browse.accesskey", N_("Accesskey priority"), "priority", 0, 0, 2, 0, N_("Priority of 'accesskey' HTML attribute:\n" - "0 is first try all normal bindings; if it fails, check accesskey\n" - "1 is first try only frame bindings; if it fails, check accesskey\n" + "0 is first try all normal bindings; if it fails,\n" + " check accesskey\n" + "1 is first try only frame bindings; if it fails,\n" + " check accesskey\n" "2 is first check accesskey (this can be dangerous)")), @@ -171,8 +180,8 @@ static struct option_info config_options_info[] = { INIT_OPT_BOOL("document.browse.forms", N_("Submit form automatically"), "auto_submit", 0, 1, - N_("Automagically submit a form when enter is pressed with a text\n" - "field selected.")), + N_("Automagically submit a form when enter is pressed with a " + "text field selected.")), INIT_OPT_BOOL("document.browse.forms", N_("Confirm submission"), "confirm_submit", 0, 1, @@ -184,20 +193,22 @@ static struct option_info config_options_info[] = { INIT_OPT_BOOL("document.browse.forms", N_("Insert mode"), "insert_mode", 0, 1, - N_("The setting for this option affects how key presses are handled\n" - "when one selects a text-input form-field. When enabled, one must\n" - "explicitly 'enter' a selected text-field to edit it; this prevents\n" - "text fields from capturing key presses, such as presses of a scroll\n" - "key, when it is inadvertently selected. When disabled, key presses\n" - "are always inserted into a selected text field.")), + N_("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.")), INIT_OPT_STRING("document.browse.forms", N_("External editor"), "editor", 0, "", - N_("Path to the executable that ELinks should launch when the user\n" - "requests to edit a textarea with an external editor.\n" - "If this is blank, ELinks will use the value of the environmental\n" - "variable $EDITOR. If $EDITOR is empty or not set, ELinks will then\n" - "default to \"vi\".")), + N_("Path to the executable that ELinks should launch when the " + "user requests to edit a textarea with an external editor.\n" + "\n" + "If this is blank, ELinks will use the value of the " + "environmental variable $EDITOR. If $EDITOR is empty or not " + "set, ELinks will then default to \"vi\".")), INIT_OPT_TREE("document.browse", N_("Images"), @@ -209,15 +220,18 @@ static struct option_info config_options_info[] = { N_("Display style for image tags when displayed:\n" "0 means always display IMG\n" "1 means always display filename\n" - "2 means display alt/title attribute if possible, IMG if not\n" - "3 means display alt/title attribute if possible, filename if not")), + "2 means display alt/title attribute if possible,\n" + " IMG if not\n" + "3 means display alt/title attribute if possible,\n" + " filename if not")), INIT_OPT_INT("document.browse.images", N_("Maximum length for image filename"), "filename_maxlen", 0, 0, 500, 0, N_("Maximum length of image filename when displayed:\n" "0 means always display full filename\n" "1-500 means display filename with this maximal length;\n" - " if it is longer, the middle is substituted by an asterisk")), + " if it is longer, the middle is substituted by\n" + " an asterisk")), /* Compatibility aliases. Added: 2004-12-15, 0.10pre3.CVS. It was * replaced by display_style and filename_maxlen options combination. */ @@ -244,19 +258,20 @@ static struct option_info config_options_info[] = { N_("Maximum length of image label (alt/title):\n" "0 means always display full label\n" "1-500 means display label with this maximal length;\n" - " if it is longer, the middle is substituted by an asterisk")), + " if it is longer, the middle is substituted by\n" + " an asterisk")), INIT_OPT_BOOL("document.browse.images", N_("Display links to images w/o alt"), "show_as_links", 0, 0, - N_("Display links to images without an alt attribute. If this option\n" - "is off, these images are completely invisible.")), + N_("Display links to images without an alt attribute. If this " + "option is off, these images are completely invisible.")), INIT_OPT_BOOL("document.browse.images", N_("Display links to images"), "show_any_as_links", 0, 1, - N_("Display links to any images in the document, regardless of them\n" - "having an alt attribute or not. If this option is off, the alt\n" - "attribute contents is shown, but as normal text, not selectable\n" - "as a link.")), + N_("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.")), INIT_OPT_TREE("document.browse", N_("Links"), @@ -281,7 +296,7 @@ static struct option_info config_options_info[] = { INIT_OPT_BOOL("document.browse.links.active_link", N_("Enable color"), "enable_color", 0, 0, - N_("Enable use of the active link background and text color\n" + N_("Enable use of the active link background and text color " "settings instead of the link colors from the document.")), INIT_OPT_BOOL("document.browse.links.active_link", N_("Bold"), @@ -300,7 +315,8 @@ static struct option_info config_options_info[] = { INIT_OPT_BOOL("document.browse.links", N_("Directory highlighting"), "color_dirs", 0, 1, - N_("Highlight links to directories in FTP and local directory listing.")), + N_("Highlight links to directories in FTP and local directory " + "listing.")), INIT_OPT_BOOL("document.browse.links", N_("Number links"), "numbering", 0, 0, @@ -323,35 +339,36 @@ static struct option_info config_options_info[] = { INIT_OPT_BOOL("document.browse.links", N_("Use tabindex"), "use_tabindex", 0, 1, - N_("Whether to navigate links using tabindex specified ordering.\n" - "The TABINDEX attribute in HTML elements specifies the order\n" - "in which links should receive focus when using the keyboard\n" - "to navigate the document.")), + N_("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.")), INIT_OPT_BOOL("document.browse.links", N_("Missing fragment reporting"), "missing_fragment", 0, 1, - N_("Open a message box when document has no tag with given id.")), + N_("Open a message box when document has no tag with given " + "id.")), INIT_OPT_INT("document.browse.links", N_("Number keys select links"), "number_keys_select_link", 0, 0, 2, 1, - N_("Number keys select links rather than specify command prefixes. This\n" - "is a tristate:\n" + N_("Number keys select links rather than specify command " + "prefixes. This is a tristate:\n" "0 means never\n" "1 means if document.browse.links.numbering = 1\n" "2 means always")), INIT_OPT_BOOL("document.browse.links", N_("Warn about maliciously crafted URIs"), "warn_malicious", 0, 1, - N_("When following a link the user ID part of the URI is\n" - "checked and if a maliciously crafted URI is detected a\n" + N_("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.")), /* TODO - this is somehow implemented by ff, but disabled * for now as it doesn't work. */ INIT_OPT_BOOL("document.browse.links", N_("Wrap-around links cycling"), "wraparound", /* 0 */ 0, 0, - N_("When pressing 'down' on the last link, jump to the first one, and\n" - "vice versa.")), + N_("When pressing 'down' on the last link, jump to the first " + "one, and vice versa.")), INIT_OPT_TREE("document.browse", N_("Scrolling"), @@ -360,24 +377,25 @@ static struct option_info config_options_info[] = { INIT_OPT_INT("document.browse.scrolling", N_("Horizontal step"), "horizontal_step", 0, 1, 9999, 8, - N_("Number of columns to scroll when a key bound to scroll-left or scroll-\n" - "right is pressed and no prefix was given.")), + N_("Number of columns to scroll when a key bound to " + "scroll-left or scroll-right is pressed and no prefix was " + "given.")), INIT_OPT_BOOL("document.browse.scrolling", N_("Extended horizontal scrolling"), "horizontal_extended", 0, 1, - N_("Whether to allow horizontal scrolling when the document\n" - "does not extend off the screen. Useful for copy/paste\n" + N_("Whether to allow horizontal scrolling when the document " + "does not extend off the screen. Useful for copy/paste " "operations.")), INIT_OPT_INT("document.browse.scrolling", N_("Margin"), "margin", 0, 0, 20, 3, - N_("Size of the virtual margin - when you click inside of that margin,\n" - "document scrolls in that direction.")), + N_("Size of the virtual margin - when you click inside of " + "that margin, document scrolls in that direction.")), INIT_OPT_INT("document.browse.scrolling", N_("Vertical step"), "vertical_step", 0, 1, 9999, 2, - N_("Number of lines to scroll when a key bound to scroll-up or scroll-\n" - "down is pressed and no prefix was given.")), + N_("Number of lines to scroll when a key bound to scroll-up " + "or scroll-down is pressed and no prefix was given.")), INIT_OPT_TREE("document.browse", N_("Searching"), @@ -386,8 +404,8 @@ static struct option_info config_options_info[] = { INIT_OPT_BOOL("document.browse.search", N_("Case sensitivity"), "case", 0, 0, - N_("Whether the search should match the document text while maintaining\n" - "case sensitivity.")), + N_("Whether the search should match the document text while " + "maintaining case sensitivity.")), #ifdef HAVE_TRE_REGEX_H INIT_OPT_INT("document.browse.search", N_("Regular expressions"), @@ -400,12 +418,13 @@ static struct option_info config_options_info[] = { INIT_OPT_BOOL("document.browse.search", N_("Show search hit top or bottom dialogs"), "show_hit_top_bottom", 0, 1, - N_("Whether to show a dialog when the search hits the top or bottom of the\n" - "document.")), + N_("Whether to show a dialog when the search hits the top or " + "bottom of the document.")), INIT_OPT_BOOL("document.browse.search", N_("Wraparound"), "wraparound", 0, 1, - N_("Wrap around when searching. Currently only used for typeahead.")), + N_("Wrap around when searching. Currently only used for " + "typeahead.")), INIT_OPT_INT("document.browse.search", N_("Show not found"), "show_not_found", 0, 0, 2, 2, @@ -416,13 +435,17 @@ static struct option_info config_options_info[] = { INIT_OPT_INT("document.browse.search", N_("Typeahead searching"), "typeahead", 0, 0, 2, 0, - N_("Start typeahead searching when an unbound key is pressed without\n" - "any modifiers. Note that most keys have default bindings, so this\n" - "feature will not be useful unless you unbind them.\n\n" - "0 disables this feature; typeahead searching will only be used\n" - " when you press a key bound to search-typeahead or similar\n" + N_("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.\n" + "\n" + "0 disables this feature; typeahead searching will only be\n" + " used when you press a key bound to search-typeahead or\n" + " similar\n" "1 automatically starts typeahead searching thru link text\n" - "2 automatically starts typeahead searching thru all document text")), + "2 automatically starts typeahead searching thru all document\n" + " text")), INIT_OPT_INT("document.browse", N_("Horizontal text margin"), @@ -431,19 +454,21 @@ static struct option_info config_options_info[] = { INIT_OPT_BOOL("document.browse", N_("Document meta refresh"), "refresh", 0, 1, - N_("Automatically follow document-specified refresh directives ('\n" - "refresh' tags). Web-page authors use these to instruct the browser\n" - "to reload a document at a given interval or to load another page.\n" - "Regardless of the value the refresh URI is accessible as a link.\n" - "Use the document.browse.minimum_refresh_time to control the minimum\n" - "number of seconds a refresh will wait.")), + N_("Automatically follow document-specified refresh " + "directives (' refresh' 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.\n" + "\n" + "Use the document.browse.minimum_refresh_time to control the " + "minimum number of seconds a refresh will wait.")), INIT_OPT_INT("document.browse", N_("Document meta refresh minimum time"), "minimum_refresh_time", 0, 0, INT_MAX, 1000, - N_("The minimum number of milliseconds that should pass before\n" - "refreshing. If set to zero the document refresh time is used\n" - "unchanged. It can fix going back in history for some sites that\n" - "use refreshing with zero values.")), + N_("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.")), INIT_OPT_BOOL("document.browse", N_("Tables navigation order"), "table_move_order", 0, 0, @@ -459,28 +484,32 @@ static struct option_info config_options_info[] = { INIT_OPT_BOOL("document.cache", N_("Cache information about redirects"), "cache_redirects", 0, 0, - N_("Cache even redirects sent by server (usually thru HTTP by a 302\n" - "HTTP code and a Location header). This was the original behaviour\n" - "for quite some time, but it causes problems in a situation very\n" - "common to various web login systems - frequently, when accessing\n" - "a certain location, they will redirect you to a login page if they\n" - "don't receive an auth cookie, the login page then gives you the\n" - "cookie and redirects you back to the original page, but there you\n" - "have already cached redirect back to the login page! If this\n" - "option has value of 0, this malfunction is fixed, but occasionally\n" - "you may get superfluous (depends on how you take it ;-) requests to\n" - "the server. If this option has value of 1, experienced users can\n" - "still workaround it by clever combination of usage of reload,\n" - "jumping around in session history and hitting ctrl+enter.\n" - "Note that this option is checked when retrieving the information\n" - "from cache, not when saving it to cache - thus if you enable\n" - "it, even previous redirects will be taken from cache instead of\n" - "asking the server.")), + N_("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.\n" + "\n" + "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.")), INIT_OPT_BOOL("document.cache", N_("Ignore cache-control info from server"), "ignore_cache_control", 0, 1, - N_("Ignore Cache-Control and Pragma server headers.\n" - "When set, the document is cached even with 'Cache-Control: no-cache'.")), + N_("Ignore Cache-Control and Pragma server headers. " + "When set, the document is cached even with 'Cache-Control: " + "no-cache'.")), INIT_OPT_TREE("document.cache", N_("Formatted documents"), "format", 0, @@ -488,28 +517,33 @@ static struct option_info config_options_info[] = { INIT_OPT_INT("document.cache.format", N_("Number"), "size", 0, 0, 256, 5, - N_("Number of cached formatted pages. Do not get too generous\n" - "here, 'formatted' means that all the accompanying structures\n" - "are kept in memory so that you get the cached document\n" - "immediatelly, but these structures may take a lot - 2x the\n" - "size of the HTML source is probably not unusual, but it can\n" - "be even more if the document consists of a lot of short lines\n" - "(padded right, if possible) and links and not much other markup.\n" - "So if you set this to 256 and then you don't like your ELinks\n" - "eating 90M, don't come complaining to us. ;-)\n" - "Also note that the format cache itself is not counted to the\n" - "memory cache size, but the HTML source of the formatted documents\n" - "is always cached, even if it is over the memory cache size\n" - "threshold. (Then of course no other documents can be cached.)")), + N_("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 ELinks eating 90M, don't come " + "complaining to us. ;-)\n" + "\n" + "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.)")), /* FIXME: Write more. */ INIT_OPT_INT("document.cache", N_("Revalidation interval"), "revalidation_interval", 0, -1, 86400, -1, - N_("Period in seconds that a cache entry is considered to be\n" - "up-to-date. When a document is loaded and this interval has elapsed\n" - "since the document was initially loaded or most recently\n" - "revalidated with the server, the server will be checked in case\n" - "there is a more up-to-date version of the document.\n\n" + N_("Period in seconds that a cache entry is considered to be " + "up-to-date. When a document is loaded and this interval has " + "elapsed since the document was initially loaded or most " + "recently revalidated with the server, the server will be " + "checked in case there is a more up-to-date version of the " + "document.\n" + "\n" "A value of -1 disables automatic revalidation.")), INIT_OPT_TREE("document.cache", N_("Memory cache"), @@ -528,7 +562,7 @@ static struct option_info config_options_info[] = { INIT_OPT_CODEPAGE("document.codepage", N_("Default codepage"), "assume", 0, "System", - N_("Default document codepage. 'System' stands for\n" + N_("Default document codepage. 'System' stands for " "a codepage determined by a selected locale.")), INIT_OPT_BOOL("document.codepage", N_("Ignore charset info from server"), @@ -569,6 +603,7 @@ static struct option_info config_options_info[] = { INIT_OPT_COLOR("document.colors", N_("Directory color"), "dirs", 0, "#ffff00", N_("Default directory color.\n" + "\n" "See document.browse.links.color_dirs option.")), /* Compatibility alias: added by jonas at 2005-05-31, 0.11.CVS. */ @@ -577,10 +612,11 @@ static struct option_info config_options_info[] = { INIT_OPT_BOOL("document.colors", N_("Increase contrast"), "increase_contrast", 0, 1, - N_("Increase the contrast between the foreground and background colors\n" - "to ensure readability. For example it disallows dark colors on a\n" - "black background. Note, this is different from ensuring the contrast\n" - "with the ensure_contrast option.")), + N_("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.")), INIT_OPT_BOOL("document.colors", N_("Ensure contrast"), "ensure_contrast", 0, 1, @@ -614,8 +650,8 @@ static struct option_info config_options_info[] = { INIT_OPT_BOOL("document.download", N_("Set original time"), "set_original_time", 0, 0, - N_("Set the timestamp of each downloaded file to the timestamp\n" - "stored on the server.")), + N_("Set the timestamp of each downloaded file to the " + "timestamp stored on the server.")), /* Does automatic resuming make sense as an option? */ INIT_OPT_INT("document.download", N_("Prevent overwriting"), @@ -639,7 +675,7 @@ static struct option_info config_options_info[] = { INIT_OPT_CODEPAGE("document.dump", N_("Codepage"), "codepage", 0, "System", - N_("Codepage used in dump output. 'System' stands for\n" + N_("Codepage used in dump output. 'System' stands for " "a codepage determined by a selected locale.")), INIT_OPT_INT("document.dump", N_("Color mode"), @@ -650,10 +686,12 @@ static struct option_info config_options_info[] = { * TRANSLATORS: This restriction applies only to the * "en" (English) translation. (See doc/Makefile.) */ N_("Color mode for dumps.\n" + "\n" "Some modes may have been disabled at compile time. " "The Setup -> Terminal options dialog lists the modes " "supported by this executable. If you select an " "unsupported mode, ELinks uses 16 colors.\n" + "\n" "The color modes are:\n" "-1 is standard dump mode\n" "0 is mono mode\n" @@ -676,7 +714,7 @@ static struct option_info config_options_info[] = { INIT_OPT_BOOL("document.dump", N_("References"), "references", 0, 1, - N_("Whether to print references (URIs) of document links\n" + N_("Whether to print references (URIs) of document links " "in dump output.")), INIT_OPT_STRING("document.dump", N_("Separator"), @@ -734,8 +772,8 @@ static struct option_info config_options_info[] = { INIT_OPT_BOOL("document.html", N_("Wrap non breaking space"), "wrap_nbsp", 0, 0, - N_("If set do not honour non breaking space (the nbsp entity)\n" - "but allow to wrap the text. This can help keeping the width\n" + N_("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.")), @@ -749,25 +787,29 @@ static struct option_info config_options_info[] = { INIT_OPT_BOOL("document.plain", N_("Compress empty lines"), "compress_empty_lines", 0, 0, - N_("Compress successive empty lines to only one in displayed text.")), + N_("Compress successive empty lines to only one in displayed " + "text.")), INIT_OPT_TREE("document", N_("URI passing"), "uri_passing", OPT_SORT | OPT_AUTOCREATE, - N_("Rules for passing URIs to external commands. When one rule\n" - "is defined the link and tab menu will have a menu item that\n" - "makes it possible to pass the the link, frame or tab URI to\n" - "an external command. If several rules are defined the link and\n" - "tab menu will have a submenu of items for each rule. Note, this\n" - "is mostly useful for launching graphical viewers, since there\n" - "is no support for releasing the terminal while the command runs.\n" - "The action and submenus are also available by binding keys to\n" - "the frame-external-command, the link-external-command, and\n" - "the tab-external-command actions.")), + N_("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.\n" + "\n" + "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.")), INIT_OPT_STRING("document.uri_passing", NULL, "_template_", 0, "", - N_("A rule for passing URI to an external command.\n" + N_("A rule for passing URI to an external command. " "The format is:\n" "%c in the string means the current URL\n" "%% in the string means '%'\n" @@ -783,26 +825,30 @@ static struct option_info config_options_info[] = { INIT_OPT_INT("infofiles", N_("Save interval"), "save_interval", 0, 0, INT_MAX, 300, - N_("Interval at which to trigger information files in ~/.elinks\n" - "to be saved to disk if they have changed (seconds; 0 to disable)")), + N_("Interval at which to trigger information files in " + "~/.elinks to be saved to disk if they have changed " + "(seconds; 0 to disable)")), INIT_OPT_BOOL("infofiles", N_("Use secure file saving"), "secure_save", 0, 1, - N_("First write data to unique temporary file, then rename this file\n" - "upon successfully finishing this. Note that this relates only to\n" - "config files, not downloaded files. You may want to disable\n" - "it if you are using some exotic permissions for concerned files.\n" - "Secure file saving is automagically disabled if file is symlink.\n" - "Warning: some systems (ie. OS/2, Win32) require that destination\n" - "file doesn't exist when rename(3) is called, breaking atomicity,\n" - "and reducing reliability of this feature.")), + N_("First write data to unique temporary file, then rename " + "this file upon successfully finishing this. Note that this " + "relates only to config files, not downloaded files. " + "You may want to disable it if you are using some exotic " + "permissions for concerned files. Secure file saving is " + "automagically disabled if file is symlink.\n" + "\n" + "Warning: some systems (ie. OS/2, Win32) require that " + "destination file doesn't exist when rename(3) is called, " + "breaking atomicity, and reducing reliability of this " + "feature.")), INIT_OPT_BOOL("infofiles", N_("Use fsync(3) with secure file saving"), "secure_save_fsync", 0, 1, - N_("When using secure file saving, call fsync(3), if the OS\n" - "supports it, to force the OS immediately to write the data\n" - "to permanent storage. This is optional for those who wish\n" - "to avoid excessive disk I/O.")), + N_("When using secure file saving, call fsync(3), if the OS " + "supports it, to force the OS immediately to write the " + "data to permanent storage. This is optional for those who " + "wish to avoid excessive disk I/O.")), /* Keep options in alphabetical order. */ @@ -814,7 +860,8 @@ static struct option_info config_options_info[] = { INIT_OPT_TREE("terminal", NULL, "_template_", 0, - N_("Options specific to this terminal type (according to $TERM value).")), + N_("Options specific to this terminal type (according to " + "$TERM value).")), /* TODO: Incorporate some of the following to the option text. * @@ -839,8 +886,8 @@ static struct option_info config_options_info[] = { * understands UTF-8 and has the characters in its font. */ INIT_OPT_INT("terminal._template_", N_("Type"), "type", 0, 0, 4, 0, - N_("Terminal type; matters mostly only when drawing frames and\n" - "dialog box borders:\n" + N_("Terminal type; matters mostly only when drawing frames " + "and dialog box borders:\n" "0 is dumb terminal type, ASCII art\n" "1 is VT100, simple but portable\n" "2 is Linux, you get double frames and other goodies\n" @@ -851,20 +898,21 @@ static struct option_info config_options_info[] = { "latin1_title", 0, 1, N_("When updating the window title of xterm or a similar " "terminal emulator, encode the title in ISO-8859-1 (Latin-1), " - "rather than in the charset used for other text in the window. " - "Cyrillic and other characters get replaced with Latin ones. " - "Xterm requires this unless you explicitly enable UTF-8 " - "titles in it.\n" + "rather than in the charset used for other text in the " + "window. Cyrillic and other characters get replaced with " + "Latin ones. Xterm requires this unless you explicitly " + "enable UTF-8 titles in it.\n" "\n" - "If this option does not take effect immediately, try switching " - "to a different page so that ELinks notices it needs to update " - "the title.")), + "If this option does not take effect immediately, try " + "switching to a different page so that ELinks notices " + "it needs to update the title.")), INIT_OPT_BOOL("terminal._template_", N_("Switch fonts for line drawing"), "m11_hack", 0, 0, - N_("Switch fonts when drawing lines, enabling both local characters\n" - "and lines working at the same time. ELinks uses this option only if\n" - "UTF-8 I/O is disabled and the terminal type is Linux or FreeBSD.")), + N_("Switch fonts when drawing lines, enabling both local " + "characters and lines working at the same time. " + "ELinks uses this option only if UTF-8 I/O is disabled " + "and the terminal type is Linux or FreeBSD.")), /* When CONFIG_UTF8 is defined, any code that reads the "utf_8_io" * option should also check whether the "codepage" option is UTF-8, @@ -873,19 +921,21 @@ static struct option_info config_options_info[] = { * please report any such possibilities as bugs.) */ INIT_OPT_BOOL("terminal._template_", N_("UTF-8 I/O"), "utf_8_io", 0, 0, - N_("Enable I/O in UTF-8 for Unicode terminals. Note that currently,\n" - "only the subset of UTF-8 according to terminal codepage is used.\n" - "ELinks ignores this option if the terminal codepage is UTF-8.")), + N_("Enable I/O in UTF-8 for Unicode terminals. " + "Note that currently, only the subset of UTF-8 according to " + "terminal codepage is used. ELinks ignores this option " + "if the terminal codepage is UTF-8.")), INIT_OPT_BOOL("terminal._template_", N_("Restrict frames in cp850/852"), "restrict_852", 0, 0, - N_("Restrict the characters used when drawing lines. Makes sense\n" - "only with linux terminals using the cp850/852 character sets.")), + N_("Restrict the characters used when drawing lines. " + "Makes sense only with linux terminals using the cp850/852 " + "character sets.")), INIT_OPT_BOOL("terminal._template_", N_("Block cursor"), "block_cursor", 0, 0, - N_("Move cursor to bottom right corner when done drawing.\n" - "This is particularly useful when we have a block cursor,\n" + N_("Move cursor to bottom right corner when done drawing. " + "This is particularly useful when we have a block cursor, " "so that inversed text is displayed correctly.")), INIT_OPT_INT("terminal._template_", N_("Color mode"), @@ -895,12 +945,14 @@ static struct option_info config_options_info[] = { * an outer list entry after an inner list. * TRANSLATORS: This restriction applies only to the * "en" (English) translation. (See doc/Makefile.) */ - N_("The color mode controls what colors are used and how they are " - "output to the terminal.\n" + N_("The color mode controls what colors are used and how they " + "are output to the terminal.\n" + "\n" "Some modes may have been disabled at compile time. " "The Setup -> Terminal options dialog lists the modes " "supported by this executable. If you select an " "unsupported mode, ELinks uses 16 colors.\n" + "\n" "The color modes are:\n" "0 is mono mode, only 2 colors are used\n" "1 is 16 color mode, uses the common ANSI colors\n" @@ -910,22 +962,26 @@ static struct option_info config_options_info[] = { INIT_OPT_BOOL("terminal._template_", N_("Transparency"), "transparency", 0, 0, - N_("If we should not set the background to black. This is particularly\n" - "useful when we have a terminal (typically in some windowing\n" - "environment) with a background image or a transparent background -\n" - "it will be visible in ELinks as well (but ELinks document color handling\n" - "will still assume the background is black so if you have a bright background\n" - "you might experience contrast problems). Note that this option makes\n" - "sense only when colors are enabled.")), + N_("If we should not set the background to black. " + "This is particularly useful when we have a terminal " + "(typically in some windowing environment) with a background " + "image or a transparent background - it will be visible in " + "ELinks as well (but ELinks document color handling will " + "still assume the background is black so if you have a " + "bright background you might experience contrast problems). " + "Note that this option makes sense only when colors are " + "enabled.")), INIT_OPT_BOOL("terminal._template_", N_("Underline"), "underline", 0, 0, - N_("If we should use underline or enhance the color instead.")), + N_("If we should use underline or enhance the color " + "instead.")), INIT_OPT_CODEPAGE("terminal._template_", N_("Codepage"), "charset", 0, "System", - N_("Codepage of charset used for displaying content on terminal.\n" - "'System' stands for a codepage determined by a selected locale.")), + N_("Codepage of charset used for displaying content on " + "terminal. 'System' stands for a codepage determined by " + "a selected locale.")), /* Keep options in alphabetical order. */ @@ -1145,7 +1201,7 @@ static struct option_info config_options_info[] = { INIT_OPT_COLORS(".tabs", N_("Unvisited tab"), "unvisited", "darkblue", "white", "gray", "white", - N_("Tab colors for tabs that have not been\n" + N_("Tab colors for tabs that have not been " "selected since they completed loading.")), INIT_OPT_COLORS(".tabs", N_("Unselected tab"), @@ -1183,30 +1239,34 @@ static struct option_info config_options_info[] = { INIT_OPT_INT("ui.dialogs", N_("Minimal height of listbox widget"), "listbox_min_height", 0, 1, 20, 10, - N_("Minimal height of the listbox widget (used e.g. for bookmarks\n" - "or global history).")), + N_("Minimal height of the listbox widget (used e.g. for " + "bookmarks or global history).")), INIT_OPT_BOOL("ui.dialogs", N_("Drop shadows"), "shadows", 0, 0, - N_("Make dialogs drop shadows (the shadows are solid, you can\n" - "adjust their color by ui.colors.*.dialog.shadow). You may\n" - "also want to eliminate the wide borders by adjusting setup.h.")), + N_("Make dialogs drop shadows (the shadows are solid, you " + "can adjust their color by ui.colors.*.dialog.shadow). " + "You may also want to eliminate the wide borders by " + "adjusting setup.h.")), INIT_OPT_BOOL("ui.dialogs", N_("Underline menu hotkeys"), "underline_hotkeys", 0, 0, - N_("Whether to underline hotkeys in menus to make them more\n" - "visible. Requires that underlining is enabled for the terminal.")), + N_("Whether to underline hotkeys in menus to make them more " + "visible. Requires that underlining is enabled for the " + "terminal.")), INIT_OPT_BOOL("ui.dialogs", N_("Underline button shortcuts"), "underline_button_shortcuts", 0, 0, - N_("Whether to underline button shortcuts to make them more\n" - "visible. Requires that underlining is enabled for the terminal.")), + N_("Whether to underline button shortcuts to make them more " + "visible. Requires that underlining is enabled for the " + "terminal.")), INIT_OPT_TREE("ui", N_("Timer options"), "timer", 0, - N_("Timed action after certain interval of user inactivity. Someone can\n" - "even find this useful, although you may not believe that.")), + N_("Timed action after certain interval of user inactivity. " + "Someone can even find this useful, although you may not " + "believe that.")), #ifdef CONFIG_LEDS INIT_OPT_INT("ui.timer", N_("Enable"), @@ -1226,12 +1286,13 @@ static struct option_info config_options_info[] = { INIT_OPT_INT("ui.timer", N_("Duration"), "duration", 0, 1, 86400, 86400, - N_("Inactivity timeout in seconds. The maximum of one day\n" + N_("Inactivity timeout in seconds. The maximum of one day " "should be enough for just everyone (TM).")), INIT_OPT_STRING("ui.timer", N_("Action"), "action", 0, "", - N_("Keybinding action to be triggered when timer reaches zero.")), + N_("Keybinding action to be triggered when timer reaches " + "zero.")), INIT_OPT_TREE("ui", N_("Window tabs"), @@ -1251,8 +1312,8 @@ static struct option_info config_options_info[] = { INIT_OPT_BOOL("ui.tabs", N_("Wrap-around tabs cycling"), "wraparound", 0, 1, - N_("When moving right from the last tab, jump to the first one, and\n" - "vice versa.")), + N_("When moving right from the last tab, jump to the first " + "one, and vice versa.")), INIT_OPT_BOOL("ui.tabs", N_("Confirm tab closing"), "confirm_close", 0, 0, @@ -1262,8 +1323,9 @@ static struct option_info config_options_info[] = { INIT_OPT_LANGUAGE("ui", N_("Language"), "language", 0, - N_("Language of user interface. 'System' means that the language will\n" - "be extracted from the environment dynamically.")), + N_("Language of user interface. 'System' means that the " + "language will be extracted from the environment " + "dynamically.")), INIT_OPT_BOOL("ui", N_("Display menu bar always"), "show_menu_bar_always", 0, 0, @@ -1279,14 +1341,15 @@ static struct option_info config_options_info[] = { INIT_OPT_BOOL("ui", N_("Display goto dialog in new tabs"), "startup_goto_dialog", 0, 1, - N_("Pop up goto dialog in newly created tabs when there's no homepage\n" - "set. This means also showing goto dialog on startup.")), + N_("Pop up goto dialog in newly created tabs when there's " + "no homepage set. This means also showing goto dialog on " + "startup.")), INIT_OPT_BOOL("ui", N_("Show a message box when file is saved successfully"), "success_msgbox", 0, 1, - N_("When you pressed a [ Save ] button in some manager, this option\n" - "will make sure that a box confirming success of the operation will\n" - "pop up.")), + N_("When you pressed a [ Save ] button in some manager, " + "this option will make sure that a box confirming success " + "of the operation will pop up.")), INIT_OPT_TREE("ui", N_("Sessions"), @@ -1295,30 +1358,35 @@ static struct option_info config_options_info[] = { INIT_OPT_BOOL("ui.sessions", N_("Keep session active"), "keep_session_active", 0, 0, - N_("Keep the session active even if the last terminal exits.")), + N_("Keep the session active even if the last terminal " + "exits.")), INIT_OPT_BOOL("ui.sessions", N_("Auto save session"), "auto_save", 0, 0, N_("Automatically save the session when quitting.\n" + "\n" "This feature requires bookmark support.")), INIT_OPT_BOOL("ui.sessions", N_("Auto restore session"), "auto_restore", 0, 0, N_("Automatically restore the session at start.\n" + "\n" "This feature requires bookmark support.")), INIT_OPT_STRING("ui.sessions", N_("Auto save and restore session folder name"), "auto_save_foldername", 0, "Auto saved session", - N_("Name of the bookmarks folder used for auto saving and restoring session.\n" - "The name has to be unique. Any folders with the same name will be deleted.\n" + N_("Name of the bookmarks folder used for auto saving and " + "restoring session. The name has to be unique. Any folders " + "with the same name will be deleted.\n" + "\n" "This only makes sense with bookmark support.")), INIT_OPT_STRING("ui.sessions", N_("Homepage URI"), "homepage", 0, WWW_HOME_URL, - N_("The URI to load either at startup time when no URI was given\n" - "on the command line or when requested by the goto-url-home action.\n" - "Set to \"\" if the environment variable WWW_HOME should be used\n" - "as homepage URI instead.")), + N_("The URI to load either at startup time when no URI was " + "given on the command line or when requested by the " + "goto-url-home action. Set to \"\" if the environment " + "variable WWW_HOME should be used as homepage URI instead.")), #ifdef HAVE_STRFTIME INIT_OPT_STRING("ui", N_("Date format"), @@ -1328,9 +1396,9 @@ static struct option_info config_options_info[] = { INIT_OPT_BOOL("ui", N_("Set window title"), "window_title", 0, 1, - N_("Set the window title when running in a windowing environment\n" - "in an xterm-like terminal. This way the document's title is\n" - "shown on the window titlebar.")), + N_("Set the window title when running in a windowing " + "environment in an xterm-like terminal. This way the " + "document's title is shown on the window titlebar.")), diff --git a/src/cookies/cookies.c b/src/cookies/cookies.c index 303567d9..011f853c 100644 --- a/src/cookies/cookies.c +++ b/src/cookies/cookies.c @@ -101,27 +101,29 @@ static struct option_info cookies_options[] = { "max_age", 0, -1, 10000, -1, N_("Cookie maximum age (in days):\n" "-1 is use cookie's expiration date if any\n" - "0 is force expiration at the end of session, ignoring cookie's\n" - " expiration date\n" - "1+ is use cookie's expiration date, but limit age to the given\n" - " number of days")), + "0 is force expiration at the end of session, ignoring\n" + " cookie's expiration date\n" + "1+ is use cookie's expiration date, but limit age to the\n" + " given number of days")), INIT_OPT_BOOL("cookies", N_("Paranoid security"), "paranoid_security", 0, 0, - N_("When enabled, we'll require three dots in cookies domain for all\n" - "non-international domains (instead of just two dots). Some countries\n" - "have generic second level domains (eg. .com.pl, .co.uk) and allowing\n" - "sites to set cookies for these generic domains could potentially be\n" - "very bad. Note, it is off by default as it breaks a lot of sites.")), + N_("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.")), INIT_OPT_BOOL("cookies", N_("Saving"), "save", 0, 1, - N_("Whether cookies should be loaded from and saved to disk.")), + N_("Whether cookies should be loaded from and saved to " + "disk.")), INIT_OPT_BOOL("cookies", N_("Resaving"), "resave", 0, 1, - N_("Save cookies after each change in cookies list? No effect when\n" - "cookie saving (cookies.save) is off.")), + N_("Save cookies after each change in cookies list? " + "No effect when cookie saving (cookies.save) is off.")), NULL_OPTION_INFO, }; diff --git a/src/document/css/css.c b/src/document/css/css.c index c7d21def..d361597e 100644 --- a/src/document/css/css.c +++ b/src/document/css/css.c @@ -29,7 +29,8 @@ struct option_info css_options_info[] = { INIT_OPT_TREE("document", N_("Cascading Style Sheets"), "css", OPT_SORT, - N_("Options concerning how to use CSS for styling documents.")), + N_("Options concerning how to use CSS for styling " + "documents.")), INIT_OPT_BOOL("document.css", N_("Enable CSS"), "enable", 0, 1, @@ -37,16 +38,18 @@ struct option_info css_options_info[] = { INIT_OPT_BOOL("document.css", N_("Import external style sheets"), "import", 0, 1, - N_("When enabled any external style sheets that are imported from\n" - "either CSS itself using the @import keyword or from the HTML using\n" - " tags in the document header will also be downloaded.")), + N_("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.")), INIT_OPT_STRING("document.css", N_("Default style sheet"), "stylesheet", 0, "", - N_("The path to the file containing the default user defined\n" - "Cascading Style Sheet. It can be used to control the basic\n" - "layout of HTML documents. The path is assumed to be relative\n" + N_("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 ELinks' home directory.\n" + "\n" "Leave as \"\" to use built-in document styling.")), NULL_OPTION_INFO, diff --git a/src/ecmascript/ecmascript.c b/src/ecmascript/ecmascript.c index 690a2926..8bcbb199 100644 --- a/src/ecmascript/ecmascript.c +++ b/src/ecmascript/ecmascript.c @@ -52,8 +52,8 @@ static struct option_info ecmascript_options[] = { INIT_OPT_BOOL("ecmascript", N_("Ignore