suckless/dwm - Unnamed repository; edit this file 'description' to name the repository.

about summary refs log tree commit diff stats

Mode	Name	Size
-rw-r--r--	.hgtags	1354	log stats plain blame
-rw-r--r--	LICENSE	1204	log stats plain blame
-rw-r--r--	Makefile	1543	log stats plain blame
-rw-r--r--	README	1088	log stats plain blame
-rw-r--r--	client.c	8155	log stats plain blame
-rw-r--r--	config.arg.h	2878	log stats plain blame
-rw-r--r--	config.default.h	2919	log stats plain blame
-rw-r--r--	config.mk	575	log stats plain blame
-rw-r--r--	draw.c	4920	log stats plain blame
-rw-r--r--	dwm.1	4130	log stats plain blame
-rw-r--r--	dwm.h	7692	log stats plain blame
-rw-r--r--	dwm.png	373	log stats plain blame
-rw-r--r--	event.c	8288	log stats plain blame
-rw-r--r--	main.c	8378	log stats plain blame
-rw-r--r--	tag.c	2475	log stats plain blame
-rw-r--r--	util.c	1225	log stats plain blame
-rw-r--r--	view.c	5258	log stats plain blame

pan> # RFC 1345 w/o Intro mnemonic+ascii+0 # RFC 1345 Mnemonic mnemonic # Transparent x-transparent +.fi # # The value should be the MIME name of a character set recognized by # Lynx (case insensitive). @@ -327,6 +359,7 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html # #CHARACTER_SET:iso-8859-1 +.h2 ASSUME_CHARSET # ASSUME_CHARSET changes the handling of documents which do not # explicitly specify a charset. Normally Lynx assumes that 8-bit # characters in those documents are encoded according to iso-8859-1 @@ -340,6 +373,8 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html # #ASSUME_CHARSET:iso-8859-1 +.h2 ASSUMED_DOC_CHARSET_CHOICE +.h2 DISPLAY_CHARSET_CHOICE # It is possible to reduce the number of charset choices in the 'O'ptions menu # for "display charset" and "assumed document charset" fields via # DISPLAY_CHARSET_CHOICE and ASSUMED_DOC_CHARSET_CHOICE settings correspondingly. @@ -359,8 +394,10 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html # the name with prefix matching given (case insensitive), i.e., # for the charsets listed in the table of recognized charsets, # +.ex # ASSUMED_DOC_CHARSET_CHOICE:cyrillic* # will be equal to specifying +.ex 4 # ASSUMED_DOC_CHARSET_CHOICE:cp866 # ASSUMED_DOC_CHARSET_CHOICE:windows-1251 # ASSUMED_DOC_CHARSET_CHOICE:koi8-r @@ -378,6 +415,7 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html #ASSUMED_DOC_CHARSET_CHOICE:* #DISPLAY_CHARSET_CHOICE:* +.h2 ASSUME_LOCAL_CHARSET # ASSUME_LOCAL_CHARSET is like ASSUME_CHARSET but only applies to local # files. If no setting is given here or by an -assume_local_charset # command line option, the value for ASSUME_CHARSET or -assume_charset @@ -389,6 +427,7 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html # #ASSUME_LOCAL_CHARSET:iso-8859-1 +.h2 PREPEND_CHARSET_TO_SOURCE # PREPEND_CHARSET_TO_SOURCE:TRUE tells Lynx to prepend a META CHARSET line # to text/html source files when they are retrieved for 'd'ownloading # or passed to 'p'rint functions, so HTTP headers will not be lost. @@ -403,6 +442,7 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html # #PREPEND_CHARSET_TO_SOURCE:TRUE +.h2 NCR_IN_BOOKMARKS # NCR_IN_BOOKMARKS:TRUE allows you to save 8-bit characters in bookmark titles # in the unicode format (NCR). This may be useful if you need to switch # display charsets frequently. This is the case when you use Lynx on different @@ -415,6 +455,7 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html # #NCR_IN_BOOKMARKS:FALSE +.h2 FORCE_8BIT_TOUPPER # FORCE_8BIT_TOUPPER overrides locale settings and uses internal 8-bit # case-conversion mechanism for case-insensitive searches in non-ASCII display # character sets. It is FALSE by default and should not be changed unless @@ -422,6 +463,7 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html # #FORCE_8BIT_TOUPPER:FALSE +.h2 OUTGOING_MAIL_CHARSET # While Lynx supports different platforms and display character sets # we need to limit the charset in outgoing mail to reduce # trouble for remote recipients who may not recognize our charset. @@ -431,6 +473,7 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html # #OUTGOING_MAIL_CHARSET: +.h2 ASSUME_UNREC_CHARSET # If Lynx encounters a charset parameter it doesn't recognize, it will # replace the value given by ASSUME_UNREC_CHARSET (or a corresponding # -assume_unrec_charset command line option) for it. This can be used @@ -441,6 +484,7 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html # #ASSUME_UNREC_CHARSET:iso-8859-1 +.h2 PREFERRED_LANGUAGE # PREFERRED_LANGUAGE is the language in MIME notation (e.g., "en", # "fr") which will be indicated by Lynx in its Accept-Language headers # as the preferred language. If available, the document will be @@ -450,6 +494,7 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html # #PREFERRED_LANGUAGE:en +.h2 PREFERRED_CHARSET # PREFERRED_CHARSET specifies the character set in MIME notation (e.g., # "ISO-8859-2", "ISO-8859-5") which Lynx will indicate you prefer in # requests to http servers using an Accept-Charsets header. Users can @@ -467,6 +512,10 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html # #PREFERRED_CHARSET: +.h1 Interaction + +.h2 URL_DOMAIN_PREFIXES +.h2 URL_DOMAIN_SUFFIXES # URL_DOMAIN_PREFIXES and URL_DOMAIN_SUFFIXES are strings which will be # prepended (together with a scheme://) and appended to the first element # of command line or 'g'oto arguments which are not complete URLs and @@ -491,23 +540,30 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html #URL_DOMAIN_PREFIXES:www. #URL_DOMAIN_SUFFIXES:.com,.edu,.net,.org -# Lynx Options Menu style toggle: forms-based or old-style. -# Works if old-style menu is compiled in as well as the forms-based menu. +.h2 FORMS_OPTIONS +# Toggle whether the Options Menu is key-based or form-based; +# the key-based version is available only if specified at compile time. #FORMS_OPTIONS:TRUE +.h2 PARTIAL # Display partial pages while downloading #PARTIAL:TRUE +.h2 PARTIAL_THRES # Set the threshold # of lines Lynx must render before it # redraws the screen in PARTIAL mode. Anything < 0 implies # use of the screen size. #PARTIAL_THRES:-1 +.h2 SHOW_KB_RATE # While getting large files, Lynx shows the approximate rate of transfer. # Set this to change the units shown: # TRUE for KB/sec or FALSE for bytes/sec: default is TRUE. #SHOW_KB_RATE:TRUE +.h2 INFOSECS +.h2 MESSAGESECS +.h2 ALERTSECS # The following three definitions set the number of seconds for # pauses following statusline messages that would otherwise be # replaced immediately, and are more important than the unpaused @@ -525,6 +581,11 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html #MESSAGESECS:2 #ALERTSECS:3 +.h1 Appearance +# These settings category control the appearance of Lynx's screen and the way +# Lynx renders some tags. + +.h2 USE_SELECT_POPUPS # If USE_SELECT_POPUPS is set FALSE, Lynx will present a vertical list of # radio buttons for the OPTIONs in SELECT blocks which lack the MULTIPLE # attribute, instead of using a popup menu. Note that if the MULTIPLE @@ -536,6 +597,7 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html # #USE_SELECT_POPUPS:TRUE +.h2 SHOW_CURSOR # SHOW_CURSOR controls whether or not the cursor is hidden or appears # over the current link in documents or the current option in popups. # Showing the cursor is handy if you are a sighted user with a poor @@ -549,6 +611,7 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html # #SHOW_CURSOR:FALSE +.h2 BOLD_HEADERS # If BOLD_HEADERS is set to TRUE the HT_BOLD default style will be acted # upon for <H1> through <H6> headers. The compilation default is FALSE # (only the indentation styles are acted upon, but see BOLD_H1, below). @@ -557,6 +620,7 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html # #BOLD_HEADERS:FALSE +.h2 BOLD_H1 # If BOLD_H1 is set to TRUE the HT_BOLD default style will be acted # upon for <H1> headers even if BOLD_HEADERS is FALSE. The compilation # default is FALSE. On Unix, compilation with -DUNDERLINE_LINKS also @@ -564,6 +628,7 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html # #BOLD_H1:FALSE +.h2 BOLD_NAME_ANCHORS # If BOLD_NAME_ANCHORS is set to TRUE the content of anchors without # an HREF attribute, (i.e., anchors with a NAME or ID attribute) will # have the HT_BOLD default style. The compilation default is FALSE. @@ -572,6 +637,10 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html # #BOLD_NAME_ANCHORS:FALSE +.h1 Internal Behavior + +.h2 DEFAULT_CACHE_SIZE +.h2 DEFAULT_VIRTUAL_MEMORY_SIZE # The DEFAULT_CACHE_SIZE specifies the number of WWW documents to be # cached in memory at one time. # @@ -599,6 +668,7 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html #DEFAULT_CACHE_SIZE:10 #DEFAULT_VIRTUAL_MEMORY_SIZE:512000 +.h2 SOURCE_CACHE # SOURCE_CACHE sets the source caching behavior for Lynx: # FILE causes Lynx to keep a temporary file for each cached document # containing the HTML source of the document, which it uses to regenerate @@ -613,6 +683,7 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html # #SOURCE_CACHE:NONE +.h2 ALWAYS_RESUBMIT_POSTS # If ALWAYS_RESUBMIT_POSTS is set TRUE, Lynx always will resubmit forms # with method POST, dumping any cache from a previous submission of the # form, including when the document returned by that form is sought with @@ -627,6 +698,9 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html # #ALWAYS_RESUBMIT_POSTS:FALSE +.h1 HTML Parsing + +.h2 NO_ISMAP_IF_USEMAP # If NO_ISMAP_IF_USEMAP is set TRUE, Lynx will not include a link to the # server-side image map if both a server-side and client-side map for the # same image is indicated in the HTML markup. The compilation default is @@ -643,6 +717,7 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html # #NO_ISMAP_IF_USEMAP:FALSE +.h2 SEEK_FRAG_MAP_IN_CUR # If SEEK_FRAG_MAP_IN_CUR is set FALSE, then USEMAP attribute values # (in IMG or OBJECT tags) consisting of only a fragment (USEMAP="#foo") # will be resolved with respect to the current document's base, which @@ -656,6 +731,7 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html # #SEEK_FRAG_MAP_IN_CUR:TRUE +.h2 SEEK_FRAG_AREA_IN_CUR # If SEEK_FRAG_AREA_IN_CUR is set FALSE, then HREF attribute values # in AREA tags consisting of only a fragment (HREF="#foo") will be # resolved with respect to the current document's base, which might @@ -666,6 +742,11 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html # #SEEK_FRAG_AREA_IN_CUR:TRUE +.h1 CGI scripts +# These settings control Lynx's ability to execute various types of scripts. + +.h2 LOCAL_EXECUTION_LINKS_ALWAYS_ON +.h2 LOCAL_EXECUTION_LINKS_ON_BUT_NOT_REMOTE # Local execution links and scripts are by default completely disabled, # unless a change is made to the userdefs.h file to enable them or # the configure script is used with the corresponding options @@ -693,6 +774,7 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html #LOCAL_EXECUTION_LINKS_ALWAYS_ON:FALSE #LOCAL_EXECUTION_LINKS_ON_BUT_NOT_REMOTE:FALSE +.h2 TRUSTED_EXEC # If LOCAL_EXECUTION_LINK_ON_BUT_NOT_REMOTE is TRUE, and no TRUSTED_EXEC # rule is defined, it defaults to "file://localhost/" and any lynxexec # or lynxprog command will be permitted if it was referenced from within @@ -709,9 +791,11 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html # the string, separated by a tab. For example: # # Unix: +# ==== # TRUSTED_EXEC:file://localhost/<tab>/bin/cp # TRUSTED_EXEC:file://localhost/<tab>/bin/rm # VMS: +# === # TRUSTED_EXEC:file://localhost/<tab>copy # TRUSTED_EXEC:file://localhost/<tab>delete # @@ -737,6 +821,7 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html # #TRUSTED_EXEC:none +.h2 ALWAYS_TRUSTED_EXEC # If EXEC_LINKS was defined, any lynxexec or lynxprog URL can be made # always enabled by an ALWAYS_TRUSTED_EXEC rule for it. This is useful for # anonymous accounts in which you have disabled execution links generally, @@ -745,9 +830,11 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html # like that for TRUSTED_EXEC. For example: # # Unix: +# ==== # ALWAYS_TRUSTED_EXEC:file://localhost/<tab>/usr/local/kinetic/bin/usertime # ALWAYS_TRUSTED_EXEC:http://www.more.net/<tab>/usr/local/kinetic/bin/who.sh # VMS: +# === # ALWAYS_TRUSTED_EXEC:file://localhost/<tab>usertime # ALWAYS_TRUSTED_EXEC:http://www.more.net/<tab>show users # @@ -755,6 +842,7 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html # #ALWAYS_TRUSTED_EXEC:none +.h2 TRUSTED_LYNXCGI # Unix: # ===== # TRUSTED_LYNXCGI rules define the permitted sources and/or paths for @@ -773,6 +861,7 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html # #TRUSTED_LYNXCGI:none +.h2 LYNXCGI_ENVIRONMENT # Unix: # ===== # LYNXCGI_ENVIRONMENT adds the current value of the specified @@ -788,6 +877,7 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html # #LYNXCGI_ENVIRONMENT: +.h2 LYNXCGI_DOCUMENT_ROOT # Unix: # ===== # LYNXCGI_DOCUMENT_ROOT is the value of DOCUMENT_ROOT that will be passed @@ -802,6 +892,9 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html # #LYNXCGI_DOCUMENT_ROOT: +.h1 Cookie Handling + +.h2 FORCE_SSL_COOKIES_SECURE # If FORCE_SSL_COOKIES_SECURE is set to TRUE, then SSL encrypted cookies # received from https servers never will be sent unencrypted to http # servers. The compilation default is to impose this block only if the @@ -811,6 +904,9 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html # #FORCE_SSL_COOKIES_SECURE:FALSE +.h1 Internal Behavior + +.h2 MAIL_SYSTEM_ERROR_LOGGING # MAIL_SYSTEM_ERROR_LOGGING will send a message to the owner of # the information, or ALERTMAIL if there is no owner, every time # that a document cannot be accessed! @@ -819,6 +915,7 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html # #MAIL_SYSTEM_ERROR_LOGGING:FALSE +.h2 CHECKMAIL # If CHECKMAIL is set to TRUE, the user will be informed (via a statusline # message) about the existence of any unread mail at startup of Lynx, and # will get statusline messages if subsequent new mail arrives. If a jumps @@ -827,7 +924,8 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html # and read the messages. The checks and statusline reports will not be # performed if Lynx has been invoked with the -restrictions=mail switch. # -# VMS USERS !!! +# VMS USERS !!! +# ============= # New mail is normally broadcast as it arrives, via "unsolicited screen # broadcasts", which can be "wiped" from the Lynx display via the Ctrl-W # command. You may prefer to disable the broadcasts and use CHECKMAIL @@ -836,6 +934,9 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html # #CHECKMAIL:FALSE +.h1 News-groups + +.h2 NNTPSERVER # To enable news reading ability via Lynx, the environment variable NNTPSERVER # must be set so that it points to your site's NNTP server # (see Lynx Users Guide on environment variables). @@ -851,18 +952,22 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html # #NNTPSERVER:news.server.dom +.h2 LIST_NEWS_NUMBERS # If LIST_NEWS_NUMBERS is set TRUE, Lynx will use an ordered list and include # the numbers of articles in news listings, instead of using an unordered # list. The default is defined in userdefs.h, and can be overridden here. # #LIST_NEWS_NUMBERS:FALSE +.h2 LIST_NEWS_DATES # If LIST_NEWS_DATES is set TRUE, Lynx will include the dates of articles in # news listings. The dates always are included in the articles, themselves. # The default is defined in userdefs.h, and can be overridden here. # #LIST_NEWS_DATES:FALSE +.h2 NEWS_CHUNK_SIZE +.h2 NEWS_MAX_CHUNK # NEWS_CHUNK_SIZE and NEWS_MAX_CHUNK regulate the chunking of news article # listings with inclusion of links for listing earlier and/or later articles. # The defaults are defined in HTNews.c as 30 and 40, respectively. If the @@ -882,6 +987,7 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html #NEWS_CHUNK_SIZE:30 #NEWS_MAX_CHUNK:40 +.h2 NEWS_POSTING # Set NEWS_POSTING to FALSE if you do not want to support posting to # news groups via Lynx. If left TRUE, Lynx will use its news gateway to # post new messages or followups to news groups, using the URL schemes @@ -899,6 +1005,7 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html # #NEWS_POSTING:TRUE +.h2 LYNX_SIG_FILE # LYNX_SIG_FILE defines the name of a file containing a signature which # can be appended to email messages and news postings or followups. The # user will be prompted whether to append it. It is sought in the home @@ -908,6 +1015,10 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html # #LYNX_SIG_FILE:.lynxsig +.h1 Interaction +# These settings control interaction of the user with lynx. + +.h2 SCROLLBAR # If SCROLLBAR is set TRUE, Lynx will show scrollbar on windows. With mouse # enabled, the scrollbar strip outside the bar is clickable, and scrolls the # window by pages. The appearance of the scrollbar can be changed from @@ -915,6 +1026,7 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html # for the strip along which the scrollbar moves). #SCROLLBAR:FALSE +.h2 SCROLLBAR_ARROW # If SCROLLBAR_ARROW is set TRUE, Lynx's scrollbar will have arrows at the # ends. With mouse enabled, the arrows are clickable, and scroll the window by # 2 lines. The appearance of the scrollbar arrows can be changed from LYNX_LSS @@ -923,10 +1035,15 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html # the strip. #SCROLLBAR_ARROW:TRUE +.h2 USE_MOUSE # If USE_MOUSE is set TRUE, Lynx (when configured with ncurses) will allow # the user to click with button-1 on links to select them. #USE_MOUSE:FALSE +.h1 HTML Parsing +# These settings control the way Lynx parses HTML. + +.h2 COLLAPSE_BR_TAGS # If COLLAPSE_BR_TAGS is set FALSE, Lynx will not collapse serial BR tags. # If set TRUE, two or more concurrent BRs will be collapsed into a single # line break. Note that the valid way to insert extra blank lines in HTML @@ -934,11 +1051,16 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html # #COLLAPSE_BR_TAGS:TRUE +.h2 TAGSOUP # If TAGSOUP is set, Lynx uses the "Tag Soup DTD" rather than "SortaSGML". # The two approaches differ by the style of error detection and recovery. # Tag Soup DTD allows for improperly nested tags; SortaSGML is stricter. #TAGSOUP:FALSE +.h1 Cookie Handling +# These settings control support of cookies in lynx. + +.h2 SET_COOKIES # If SET_COOKIES is set FALSE, Lynx will ignore Set-Cookie headers # in http server replies. Note that if a COOKIE_FILE is in use (see # below) that contains cookies at startup, Lynx will still send those @@ -953,6 +1075,7 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html # #SET_COOKIES:TRUE +.h2 ACCEPT_ALL_COOKIES # If ACCEPT_ALL_COOKIES is set TRUE, Lynx will accept cookies from all # domains with no user interaction. This is equivalent to automatically # replying to all cookie 'Allow?' prompts with 'A'lways. Note that it @@ -964,6 +1087,8 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html # #ACCEPT_ALL_COOKIES:FALSE +.h2 COOKIE_ACCEPT_DOMAINS +.h2 COOKIE_REJECT_DOMAINS # COOKIE_ACCEPT_DOMAINS and COOKIE_REJECT_DOMAINS are comma-delimited lists # of domains from which Lynx should automatically accept or reject cookies # without asking for confirmation. If the same domain is specified in both @@ -977,6 +1102,9 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html #COOKIE_ACCEPT_DOMAINS: #COOKIE_REJECT_DOMAINS: +.h2 COOKIE_LOOSE_INVALID_DOMAINS +.h2 COOKIE_STRICT_INVALID_DOMAINS +.h2 COOKIE_QUERY_INVALID_DOMAINS # COOKIE_LOOSE_INVALID_DOMAINS, COOKIE_STRICT_INVALID_DOMAINS, and # COOKIE_QUERY_INVALID_DOMAINS are comma-delimited lists of domains. # They control the degree of validity checking that is applied to cookies @@ -999,14 +1127,7 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html #COOKIE_STRICT_INVALID_DOMAINS: #COOKIE_QUERY_INVALID_DOMAINS: -# COOKIE_FILE is the default file from which persistent cookies are read -# at startup (if the file exists), and into which persistent cookies are -# stored before exiting, if Lynx was compiled with EXP_PERSISTENT_COOKIES -# and the PERSISTENT_COOKIES option is enabled. -# The cookie file can also be specified in .lynxrc or on the command line. -# -#COOKIE_FILE:~/.lynx_cookies - +.h2 PERSISTENT_COOKIES # PERSISTENT_COOKIES indicates that cookies should be read at startup from # the COOKIE_FILE, and saved at exit for storage between Lynx sessions. # It is not used if Lynx was compiled without EXP_PERSISTENT_COOKIES. @@ -1015,8 +1136,33 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html # #PERSISTENT_COOKIES:FALSE +.h2 COOKIE_FILE +# COOKIE_FILE is the default file from which persistent cookies are read +# at startup (if the file exists), if Lynx was compiled with +# EXP_PERSISTENT_COOKIES and the PERSISTENT_COOKIES option is enabled. +# The cookie file can also be specified in .lynxrc or on the command line. +# +#COOKIE_FILE:~/.lynx_cookies + +.h2 COOKIE_SAVE_FILE +# COOKIE_SAVE_FILE is the default file in which persistent cookies are +# stored at exit, if Lynx was compiled with EXP_PERSISTENT_COOKIES and the +# PERSISTENT_COOKIES option is enabled. The cookie save file can also be +# specified on the command line. +# +# With an interactive Lynx session, COOKIE_SAVE_FILE will default to +# COOKIE_FILE if it is not set. With a non-interactive Lynx session (e.g., +# -dump), cookies will only be saved to file if COOKIE_SAVE_FILE is set. +# +#COOKIE_SAVE_FILE:~/.lynx_cookies + +.h1 Mail-related +# The settings control mailing facilities of lynx. + +.h2 SYSTEM_MAIL +.h2 SYSTEM_MAIL_FLAGS # VMS: -#===== +# === # The mail command and qualifiers are defined in userdefs.h. Lynx # will spawn a subprocess to send replies and error messages. The # command, and qualifiers (if any), can be re-defined here. If @@ -1028,12 +1174,14 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html # mailmsg() and reply_by_mail() functions in LYMail.c, and send_file_to_mail() # function in LYPrint.c, may be required. # +.ex 2 #SYSTEM_MAIL:PMDF SEND #SYSTEM_MAIL_FLAGS:/headers # +.ex 2 #SYSTEM_MAIL:MAIL #SYSTEM_MAIL_FLAGS: - +# # Unix: #====== # The mail path and flags normally are defined for sendmail (or submit @@ -1041,12 +1189,15 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html # read the zillions of CERT advisories about security problems with Unix # mailers. # +.ex 2 #SYSTEM_MAIL:/usr/mmdf/bin/submit #SYSTEM_MAIL_FLAGS:-mlruxto,cc\* # +.ex 2 #SYSTEM_MAIL:/usr/sbin/sendmail #SYSTEM_MAIL_FLAGS:-t -oi # +.ex 2 #SYSTEM_MAIL:/usr/lib/sendmail #SYSTEM_MAIL_FLAGS:-t -oi @@ -1056,8 +1207,9 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html # #SYSTEM_MAIL:sendmail -f me@my.host -h my.host -r my.smtp.mailer -m SMTP +.h2 MAIL_ADRS # VMS ONLY: -#========== +# ======== # MAIL_ADRS is defined in userdefs.h and normally is structured for PMDF's # IN%"INTERNET_ADDRESS" scheme. The %s is replaced with the address given # by the user. If you are using a different Internet mail transport, change @@ -1065,8 +1217,9 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html # #MAIL_ADRS:"IN%%""%s""" +.h2 USE_FIXED_RECORDS # VMS ONLY: -#========== +# ======== # If USE_FIXED_RECORDS is set to TRUE here or in userdefs.h, Lynx will # convert 'd'ownloaded binary files to FIXED 512 record format before saving # them to disk or acting on a DOWNLOADER option. If set to FALSE, the @@ -1078,29 +1231,48 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html # #USE_FIXED_RECORDS:TRUE -# VI_KEYS can be turned on by the user in the options -# screen or the .lynxrc file. This is just the default. -# -#VI_KEYS_ALWAYS_ON:FALSE +.h1 Input +# These settings control the way Lynx interprets user input. -# EMACS_KEYS can be turned on by the user in the options -# screen or the .lynxrc file. This is just the default. -# +.h2 VI_KEYS_ALWAYS_ON +.h2 EMACS_KEYS_ALWAYS_ON +# Vi or Emacs movement keys, i.e. familiar hjkl or ^N^P^F^B . +# These are defaults, which can be changed in the Options Menu or .lynxrc . +#VI_KEYS_ALWAYS_ON:FALSE #EMACS_KEYS_ALWAYS_ON:FALSE -# DEFAULT_KEYPAD_MODE specifies whether numbers work like arrows or -# numbered links. -# DEFAULT_KEYPAD_MODE set to TRUE indicates numbers act as arrows, +.h2 DEFAULT_KEYPAD_MODE +# DEFAULT_KEYPAD_MODE may be set to NUMBERS_AS_ARROWS +# or LINKS_ARE_NUMBERED +# or LINKS_AND_FIELDS_ARE_NUMBERED +# to specify whether numbers (e.g. [10]) appear before all links, +# allowing immediate access by entering the number on the keyboard, +# or numbers on the numeric key-pad work like arrows; +# the 3rd option causes form fields also to be preceded by numbers. +# The first two options (but not the last) can be changed in lynx.cfg +# and all three can be changed via the Options Menu. +# +#DEFAULT_KEYPAD_MODE:NUMBERS_AS_ARROWS + +.h2 DEFAULT_KEYPAD_MODE_IS_NUMBERS_AS_ARROWS +# Obsolete form of DEFAULT_KEYPAD_MODE, +# numbers work like arrows or numbered links. +# Set to TRUE, indicates numbers act as arrows, # and set to FALSE indicates numbers refer to numbered links on the page. -# LINKS_AND_FORM_FIELDS_ARE_NUMBERED cannot currently be set by this option. +# LINKS_AND_FORM_FIELDS_ARE_NUMBERED cannot be set by this option because +# it allows only two values (true and false). # #DEFAULT_KEYPAD_MODE_IS_NUMBERS_AS_ARROWS:TRUE +.h2 CASE_SENSITIVE_ALWAYS_ON # The default search type. # This is a default that can be overridden by the user! # #CASE_SENSITIVE_ALWAYS_ON:FALSE +.h1 Auxiliary Facilities + +.h2 DEFAULT_BOOKMARK_FILE # DEFAULT_BOOKMARK_FILE is the filename used for storing personal bookmarks. # It will be prepended by the user's home directory. # NOTE that a file ending in .html or other suffix mapped to text/html @@ -1119,6 +1291,7 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html # #DEFAULT_BOOKMARK_FILE:lynx_bookmarks.html +.h2 MULTI_BOOKMARK_SUPPORT # If MULTI_BOOKMARK_SUPPORT is set TRUE, and BLOCK_MULTI_BOOKMARKS (see # below) is FALSE, and sub-bookmarks exist, all bookmark operations will # first prompt the user to select an active sub-bookmark file or the @@ -1140,6 +1313,7 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html # #MULTI_BOOKMARK_SUPPORT:FALSE +.h2 BLOCK_MULTI_BOOKMARKS # If BLOCK_MULTI_BOOKMARKS is set TRUE, multiple bookmark support will # be forced off, and cannot to toggled on via the 'o'ptions menu. The # compilation setting is normally FALSE, and can be overridden here. @@ -1148,6 +1322,9 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html # #BLOCK_MULTI_BOOKMARKS:FALSE +.h1 Interaction + +.h2 DEFAULT_USER_MODE # DEFAULT_USER_MODE sets the default user mode for Lynx users. # NOVICE shows a three line help message at the bottom of the screen. # INTERMEDIATE shows normal amount of help (one line). @@ -1155,26 +1332,47 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html # #DEFAULT_USER_MODE:NOVICE -# DEFAULT_EDITOR sets the default editor for Lynx users. -# If an editor is defined then the user may edit local documents -# using that editor. The editor will also be used for sending -# mail messages. If no editor is defined here or by the user -# the user will not be able to edit local documents and a primitive -# line oriented mail input mode will be used. -# NOTE: Do not define an editor unless you know that every user will -# know how to use it. Most users do not enjoy getting stuck in -# an unknown editor that they can't exit. Users can -# easily define an editor of their own using the options menu, -# so it is not always desirable to set the DEFAULT_EDITOR. +.h1 External Programs + +.h2 DEFAULT_EDITOR +# If DEFAULT_EDITOR is defined, users may edit local documents with it +# & it will also be used for sending mail messages. +# If no editor is defined here or by the user, +# the user will not be able to edit local documents +# and a primitive line-oriented mail-input mode will be used. +# +# For sysadmins: do not define a default editor +# unless you know EVERY user will know how to use it; +# users can easily define their own editor in the Options Menu. # #DEFAULT_EDITOR: -# SYSTEM_EDITOR behaves the same as DEFAULT_EDITOR except that it can't be -# changed. +.h2 SYSTEM_EDITOR +# SYSTEM_EDITOR behaves the same as DEFAULT_EDITOR, +# except that it can't be changed by users. # #SYSTEM_EDITOR: -# Proxy variables +.h1 Internal Behavior +# These settings control internal lynx behavior - the way it interacts with the +# operating system and Internet. Modifying these settings will not change +# the rendition of documents that you browse with lynx, but can change various +# delays and resource utilization. + +.h2 CSO_PROXY +.h2 FINGER_PROXY +.h2 FTP_PROXY +.h2 GOPHER_PROXY +.h2 HTTPS_PROXY +.h2 HTTP_PROXY +.h2 NEWSPOST_PROXY +.h2 NEWSREPLY_PROXY +.h2 NEWS_PROXY +.h2 NNTP_PROXY +.h2 SNEWSPOST_PROXY +.h2 SNEWSREPLY_PROXY +.h2 SNEWS_PROXY +.h2 WAIS_PROXY # Lynx version 2.2 and beyond supports the use of proxy servers that can act as # firewall gateways and caching servers. They are preferable to the older # gateway servers. Each protocol used by Lynx can be mapped separately using @@ -1185,6 +1383,7 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html # VMS these proxy variables are set as process logicals rather than symbols, to # preserve lowercasing, and will outlive the Lynx image. # +.ex 15 #http_proxy:http://some.server.dom:port/ #https_proxy:http://some.server.dom:port/ #ftp_proxy:http://some.server.dom:port/ @@ -1201,14 +1400,17 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html #cso_proxy:http://some.server.dom:port/ #no_proxy:host.domain.dom +.h2 NO_PROXY # The no_proxy variable can be a comma-separated list of strings defining # no-proxy zones in the DNS domain name space. If a tail substring of the # domain-path for a host matches one of these strings, transactions with that # node will not be proxied. +.ex #no_proxy:domain.path1,path2 # # A single asterisk as an entry will override all proxy variables and no # transactions will be proxied. +.ex #no_proxy:* # This is the only allowed use of * in no_proxy. # @@ -1216,10 +1418,17 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html # for the .mil domain as well as the .il domain. If the entry is '.il' this # will not happen. -# PRINTER & DOWNLOADER DEFINITIONS: +.h1 External Programs + +.h2 PRINTER +.h2 DOWNLOADER +.h2 UPLOADER +# PRINTER, DOWNLOADER & UPLOADER DEFINITIONS: # Lynx has 4 pre-defined print options & 1 pre-defined download option, # which are called up on-screen when `p' or `d' are entered; # any number of options can be added by the user, as explained below. +# Uploaders can be defined only for UNIX with DIRED_SUPPORT: +# see the Makefile in the top directory & the header of src/LYUpload.c . # # For `p' pre-defined options are: `Save to local file', `E-mail the file', # `Print to screen' and `Print to local printer attached to vt100'. @@ -1229,10 +1438,13 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html # For `d' the pre-defined option is: `Download to local file'. # # To define your own print or download option use the following formats: +# # PRINTER:<name>:<command>:<option>:<lines/page> +# # DOWNLOADER:<name>:<command>:<option> # # <name> is what you will see on the print/download screen. +# # <command> is the command your system will execute: # the 1st %s in the command will be replaced # by the temporary filename used by Lynx; @@ -1244,10 +1456,12 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html # If the command format of your printer/downloader requires # a different layout, you will need to use a script # (see the last 2 download examples below). +# # <option> TRUE : the printer/downloader will always be ENABLED, # except that downloading is disabled when -validate is used; # FALSE : both will be DISABLED for anonymous users # and printing will be disabled when -noprint is used. +# # <lines/page> (printers: optional) the number of lines/page (default 66): # used to compute the approximate output size # and prompt if the document is > 4 printer pages; @@ -1260,72 +1474,59 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html # `Printer' can be any file-handling program you find useful, # even if it does not physically print anything. # -# Usually, downloading involves the use of (e.g.) Ckermit or ZModem +# Usually, down/up-loading involves the use of (e.g.) Ckermit or ZModem # to transfer files to a user's local machine over a serial link, # but download options do not have to be download-protocol programs. # # Printer examples: +.ex 3 #PRINTER:Computer Center printer:lpr -Pccprt %s:FALSE #PRINTER:Office printer:lpr -POffprt %s:TRUE #PRINTER:VMS printer:print /queue=cc$print %s:FALSE:58 # If you have a very busy VMS print queue # and Lynx deletes the temporary files before they have been queued, # use the VMSPrint.com included in the distribution: +.ex #PRINTER:Busy VMS printer:@Lynx_Dir\:VMSPrint sys$print %s:FALSE:58 # To specify a print option at run-time: # NBB if you have ANONYMOUS users, DO NOT allow this option! +.ex #PRINTER:Specify at run-time:echo -n "Enter a print command\: "; read word; sh -c "$word %s":FALSE # To pass to a sophisticated file viewer: -k suppresses invocation # of hex display mode if 8-bit or control characters are present; # +s invokes secure mode (see ftp://space.mit.edu/pub/davis/most): +.ex #PRINTER:Use Most to view:most -k +s %s:TRUE:23 # # Downloader examples: # in Kermit, -s %s is the filename sent, -a %s the filename on arrival # (if they are given in reverse order here, the command will fail): +.ex #DOWNLOADER:Use Kermit to download to the terminal:kermit -i -s %s -a %s:TRUE # NB don't use -k with Most, so that binaries will invoke hexadecimal mode: +.ex #DOWNLOADER:Use Most to view:most +s %s:TRUE # The following example gives wrong filenames # (`sz' doesn't support a suggested filename parameter): +.ex #DOWNLOADER:Use Zmodem to download to the local terminal:sz %s:TRUE # The following example returns correct filenames # by using a script to make a subdirectory in /tmp, # but may conflict with very strong security or permissions restrictions: +.ex #DOWNLOADER:Use Zmodem to download to the local terminal:set %s %s;td=/tmp/Lsz$$;mkdir $td;ln -s $1 $td/"$2";sz $td/"$2";rm -r $td:TRUE - -# Note for OS/390: The following is strongly recommended /* S/390 -- gil -- 1464 */ -# to undo ASCII->EBCDIC conversion. +.ex 2 +#UPLOADER:Use Kermit to upload from your computer: kermit -i -r -a %s:TRUE +#UPLOADER:Use Zmodem to upload from your computer: rz %s:TRUE # +# Note for OS/390: /* S/390 -- gil -- 1464 */ +# The following is strongly recommended to undo ASCII->EBCDIC conversion. +.ex #DOWNLOADER:Save OS/390 binary file: iconv -f IBM-1047 -t ISO8859-1 %s >%s:FALSE -# Unix ONLY: -#=========== -# Uploader definitions (implemented only with Unix DIRED_SUPPORT; -# see the Makefile in the top directory, -# and the header of ./src/LYUpload.c) -# any number of uploaders may be defined by using multiple -# uploader definition sets. Uploaders may be any programs -# that could be useful to your users; they do not necessarily -# have to be upload protocol programs. The most common use -# of an uploader is to use Ckermit or some other transfer -# program so that the user may easily transfer files from -# their local machine over a serial link. -# -# the definition of an uploader is of the same form as a downloader -# UPLOADER:<uploadername>:<uploader command>:<uploader option> -# -# You must put the whole definition on one line. -# -# If you must use a colon, precede it with a backslash! -# -# If you do not include a %s, you will not be prompted for an -# output filename. -# -# example -#UPLOADER:Use Kermit to upload from your computer: kermit -i -r -a %s:TRUE -#UPLOADER:Use Zmodem to upload from your computer: rz %s:TRUE +.h1 Interaction +.h2 NO_DOT_FILES # If NO_DOT_FILES is TRUE (normal default via userdefs.h), the user will not # be allowed to specify files beginning with a dot in reply to output filename # prompts, and files beginning with a dot (e.g., file://localhost/path/.lynxrc) @@ -1336,6 +1537,9 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html # #NO_DOT_FILES:TRUE +.h1 Internal Behavior + +.h2 NO_FROM_HEADER # If NO_FROM_HEADER is set FALSE, From headers will be sent in transmissions # to http or https servers if the personal_mail_address has been defined via # the 'o'ptions menu. The compilation default is TRUE (no From header is @@ -1345,6 +1549,7 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html # #NO_FROM_HEADER:TRUE +.h2 NO_REFERER_HEADER # If NO_REFERER_HEADER is TRUE, Referer headers never will be sent in # transmissions to servers. Lynx normally sends the URL of the document # from which the link was derived, but not for startfile URLs, 'g'oto @@ -1355,6 +1560,9 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html # #NO_REFERER_HEADER:FALSE +.h1 Internal Behavior + +.h2 NO_FILE_REFERER # If NO_FILE_REFERER is TRUE, Referer headers never will be sent in # transmissions to servers for links or actions derived from documents # or forms with file URLs. This would ensure that paths associated @@ -1364,6 +1572,7 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html # #NO_FILE_REFERER:FALSE +.h2 REFERER_WITH_QUERY # REFERER_WITH_QUERY controls what happens when the URL in a Referer # header to be sent would contain a query part in the form of a '?' # character followed by one or more attribute=value pairs. Query parts @@ -1386,6 +1595,9 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html # #REFERER_WITH_QUERY:DROP +.h1 Appearance + +.h2 VERBOSE_IMAGES # VERBOSE_IMAGES controls whether Lynx replaces [LINK], [INLINE] and [IMAGE] # (for images without ALT) with filenames of these images. # This can be useful in determining what images are important @@ -1396,6 +1608,9 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html # #VERBOSE_IMAGES:TRUE +.h1 HTML Parsing + +.h2 MAKE_LINKS_FOR_ALL_IMAGES # If MAKE_LINKS_FOR_ALL_IMAGES is TRUE, all images will be given links # which can be ACTIVATEd. For inlines, the ALT or pseudo-ALT ("[INLINE]") # strings will be links for the resolved SRC rather than just text. @@ -1406,10 +1621,11 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html # The definition here will override that in userdefs.h # and can be toggled via an "-image_links" command-line switch. # The user can also use the LYK_IMAGE_TOGGLE key (default `*') -# or the `Show Images' option in the (new) Options Form. +# or `Show Images' in the Form-based Options Menu. # #MAKE_LINKS_FOR_ALL_IMAGES:FALSE +.h2 MAKE_PSEUDO_ALTS_FOR_INLINES # If MAKE_PSEUDO_ALTS_FOR_INLINES is FALSE, inline images which don't specify # an ALT string will not have "[INLINE]" inserted as a pseudo-ALT, # i.e. they'll be treated as having ALT="". @@ -1420,10 +1636,13 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html # The definition here will override that in userdefs.h # and can be toggled via a "-pseudo_inlines" command-line switch. # The user can also use the LYK_INLINE_TOGGLE key (default `[') -# or the `Show Images' option in the (new) Options Form. +# or `Show Images' in the Form-based Options Menu. # #MAKE_PSEUDO_ALTS_FOR_INLINES:TRUE +.h1 Appearance + +.h2 SUBSTITUTE_UNDERSCORES # If SUBSTITUTE_UNDERSCORES is TRUE, the _underline_ format will be used # for emphasis tags in dumps. # @@ -1432,6 +1651,9 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html # #SUBSTITUTE_UNDERSCORES:FALSE +.h1 Interaction + +.h2 QUIT_DEFAULT_YES # If QUIT_DEFAULT_YES is TRUE then when the QUIT command is entered, any # response other than n or N will confirm. It should be FALSE if you # prefer the more conservative action of requiring an explicit Y or y to @@ -1439,6 +1661,9 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html # #QUIT_DEFAULT_YES:TRUE +.h1 HTML Parsing + +.h2 HISTORICAL_COMMENTS # If HISTORICAL_COMMENTS is TRUE, Lynx will revert to the "Historical" # behavior of treating any '>' as a terminator for comments, instead of # seeking a valid '-->' terminator (note that white space can be present @@ -1450,6 +1675,7 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html # #HISTORICAL_COMMENTS:FALSE +.h2 MINIMAL_COMMENTS # If MINIMAL_COMMENTS is TRUE, Lynx will not use Valid comment parsing # of '--' pairs as serial comments within an overall comment element, # and instead will seek only a '-->' terminator for the overall comment @@ -1468,6 +1694,7 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html # MINIMAL_COMMENTS:TRUE +.h2 SOFT_DQUOTES # If SOFT_DQUOTES is TRUE, Lynx will emulate the invalid behavior of # treating '>' as a co-terminator of a double-quoted attribute value # and the tag which contains it, as was done in old versions of Netscape @@ -1478,6 +1705,7 @@ MINIMAL_COMMENTS:TRUE # #SOFT_DQUOTES:FALSE +.h2 STRIP_DOTDOT_URLS # If STRIP_DOTDOT_URLS is TRUE, Lynx emulates the invalid behavior of many # browsers to strip a leading "../" segment from relative URLs in HTML # documents with a http or https base URL, if this would otherwise lead to @@ -1495,6 +1723,9 @@ MINIMAL_COMMENTS:TRUE # #STRIP_DOTDOT_URLS:TRUE +.h1 Appearance + +.h2 ENABLE_SCROLLBACK # If ENABLE_SCROLLBACK is TRUE, Lynx will clear the entire screen before # displaying each new screenful of text. Though less efficient for normal # use, this allows programs that maintain a buffer of previously-displayed @@ -1517,6 +1748,7 @@ MINIMAL_COMMENTS:TRUE # #ENABLE_SCROLLBACK:FALSE +.h2 SCAN_FOR_BURIED_NEWS_REFS # If SCAN_FOR_BURIED_NEWS_REFS is set to TRUE, Lynx will scan the bodies # of news articles for buried article and URL references and convert them # to links. The compilation default is TRUE, but some email addresses @@ -1530,6 +1762,7 @@ MINIMAL_COMMENTS:TRUE # #SCAN_FOR_BURIED_NEWS_REFS:TRUE +.h2 PREPEND_BASE_TO_SOURCE # If PREPEND_BASE_TO_SOURCE is set to FALSE, Lynx will not prepend a # Request URL comment and BASE element to text/html source files when # they are retrieved for 'd'ownloading or passed to 'p'rint functions. @@ -1551,6 +1784,7 @@ MINIMAL_COMMENTS:TRUE # some built-in defaults in src/HTInit.c. On the other hand, # definitions here allow some more fields that are not possible # in those files. +# # Extension mappings have an effect mostly for ftp and local files, # they are NOT used to determine the type of content for URLs with # the http protocol. This is because HTTP servers already specify @@ -1560,14 +1794,20 @@ MINIMAL_COMMENTS:TRUE # (see below) for those MIME types requires a certain suffix for the # temporary file passed to it.] +.h1 External Programs + +.h2 GLOBAL_EXTENSION_MAP +.h2 PERSONAL_EXTENSION_MAP # The global and personal EXTENSION_MAP files allow you to assign extensions # to MIME types which will override any of the suffix maps in this (lynx.cfg) # configuration file, or in src/HTInit.c. See the example mime.types file # in the samples subdirectory. # -# Unix: +# Unix: +# ==== #GLOBAL_EXTENSION_MAP:/usr/local/lib/mosaic/mime.types -# VMS: +# VMS: +# === #GLOBAL_EXTENSION_MAP:Lynx_Dir:mime.types # # Unix (sought in user's home directory): @@ -1575,8 +1815,10 @@ MINIMAL_COMMENTS:TRUE # VMS (sought in user's sys$login directory): #PERSONAL_EXTENSION_MAP:mime.types +.h2 SUFFIX_ORDER # With SUFFIX_ORDER the precedence of suffix mappings can be changed. # Two kinds of settings are recognized: +# # PRECEDENCE_OTHER or PRECEDENCE_HERE # Suffix mappings can come from four sources: (1) SUFFIX rules # given here - see below, (2) builtin defaults (HTInit.c), and the @@ -1587,6 +1829,7 @@ MINIMAL_COMMENTS:TRUE # ones elsewhere. This default ordering is called PRECEDENCE_OTHER. # With PRECEDENCE_HERE, the order becomes (2) (3) (4) (1), i.e. # mappings here override others made elsewhere. +# # NO_BUILTIN # This disables all builtin default rules. In other words, (2) in the # list above is skipped. Some recognition for compressed files (".gz", @@ -1601,10 +1844,14 @@ MINIMAL_COMMENTS:TRUE # #SUFFIX_ORDER:PRECEDENCE_OTHER +.h2 SUFFIX # The SUFFIX definition takes the form of: +# # SUFFIX:<file extension>:<mime type>:<encoding>:<quality>:<description> +# # All fields after <mime type> are optional (including the separators # if no more fields follow). +# # <file extension> trailing end of file name. This need not strictly # be a file extension as understood by the OS, a dot # has to be given explicitly if it is indented, for @@ -1614,37 +1861,49 @@ MINIMAL_COMMENTS:TRUE # (the first for filenames with a dot somewhere in # the name, the second without), these are currently # mapped to text/plain in the (HTInit.c) builtin code. +# # <mime type> a MIME content type. It can also contain a charset # parameter, see example below. This should be given in # all lowercase, use <description> for more fancy labels. # It can be left empty if an HTTP style encoding is given. +# # Fields in addition to the usual ones are +# # <encoding> either a mail style trivial encoding (7bit, 8bit, binary) # which could be used on some systems to determine how to # open local files (currently it isn't), and is used to # determine transfer mode for some FTP URLs; or a HTTP style # content encoding (gzip (equivalent to x-gzip), compress) +# # <quality> a floating point quality factor, usually between 0.0 and 1.0 # currently unused in most situations. +# # <description> text that can appear in FTP directory listings, and in # local directory listings (see LIST_FORMAT, code %t) # # For instance the following definition maps the # extension ".gif" to the mime type "image/gif" +.ex # SUFFIX:.gif:image/gif +# # The following can be used if you have a convention to label # HTML files in some character set that differs from your local # default (see also ASSUME_LOCAL_CHARSET) with a different # extension, here ".html-u8". It also demonstrates use of the # description field, note extra separators for omitted fields: +.ex # SUFFIX:.html-u8:text/html;charset=utf-8:::UTF-8 HTML +# # The following shows how a suffix can indicate a combination # of MIME type and compression method. (The ending ".ps.gz" should # already be recognized by default; the form below could be used on # systems that don't allow more than one dot in filenames.) +.ex # SUFFIX:.ps_gz:application/postscript:gzip::gzip'd Postscript +# # The following is meant to match a full filename (but can match # any file ending in "core", so be careful): +.ex # SUFFIX:core:application/x-core-file # # file suffixes are case INsensitive! @@ -1656,6 +1915,7 @@ MINIMAL_COMMENTS:TRUE # Assignments made here are overridden by entries in those files # unless preceded with a SUFFIX_ORDER:PRECEDENCE_HERE. # +.ex 29 #SUFFIX:.ps:application/postscript #SUFFIX:.eps:application/postscript #SUFFIX:.ai:application/postscript @@ -1686,6 +1946,7 @@ MINIMAL_COMMENTS:TRUE #SUFFIX:.html:text/html #SUFFIX:.txt:text/plain +.h2 XLOADIMAGE_COMMAND # VMS: # ==== # XLOADIMAGE_COMMAND will be used as a default in src/HTInit.c @@ -1698,6 +1959,7 @@ MINIMAL_COMMENTS:TRUE # must also have a "%s" for the filename. The default is defined # in userdefs.h and can be overridden here, or via the global or # personal mailcap files (see below). +# # Make this empty (but no commented out) if you don't have such a # viewer or don't want to disable the built-in default viewer # mappings for image types. @@ -1725,6 +1987,7 @@ MINIMAL_COMMENTS:TRUE # #XLOADIMAGE_COMMAND:xli %s & +.h2 VIEWER # MIME types may be assigned to external viewers using # the VIEWER definition. # @@ -1766,6 +2029,7 @@ MINIMAL_COMMENTS:TRUE # global or personal mailcap files. Assignments made here will be overridden # by entries in those files. # +.ex 7 #VIEWER:application/postscript:ghostview %s&:XWINDOWS #VIEWER:image/gif:xli %s&:XWINDOWS #VIEWER:image/x-xbm:xli %s&:XWINDOWS @@ -1774,20 +2038,27 @@ MINIMAL_COMMENTS:TRUE #VIEWER:image/jpeg:xli %s&:XWINDOWS #VIEWER:video/mpeg:mpeg_play %s &:XWINDOWS +.h2 GLOBAL_MAILCAP +.h2 PERSONAL_MAILCAP # The global and personal MAILCAP files allow you to specify external # viewers to be spawned when Lynx encounters different MIME types, which # will override any of the suffix maps in this (lynx.cfg) configuration # file, or in src/HTInit.c. See http://www.internic.net/rfc/rfc1524.txt # and the example mailcap file in the samples subdirectory. # -# Unix: +# Unix: +# ==== #GLOBAL_MAILCAP:/usr/local/lib/mosaic/mailcap -# VMS: +# VMS: +# === #GLOBAL_MAILCAP:Lynx_Dir:mailcap # # Sought in user's home (Unix) or sys$login (VMS) directory. #PERSONAL_MAILCAP:.mailcap +.h1 Input + +.h2 KEYBOARD_LAYOUT # If your terminal (or terminal emulator, or operating system) does not # support 8-bit input (at all or in easy way), you can use Lynx to # generate 8-bit characters from 7-bit ones output by terminal. @@ -1800,6 +2071,7 @@ MINIMAL_COMMENTS:TRUE # This feature is ifdef'd with EXP_KEYBOARD_LAYOUT. #KEYBOARD_LAYOUT:JCUKEN Cyrillic, for AT 101-key kbd +.h2 KEYMAP # Key remapping definitions! # # You may redefine the keymapping of any function in Lynx by @@ -1820,7 +2092,7 @@ MINIMAL_COMMENTS:TRUE # the default mapping unless you change that files manually, # so you are responsible for possible deviations # when you are changing any KEYMAP below). -# +.nf # # Keystrokes for special keys are represented by the following codes: # Up Arrow: 0x100 @@ -1843,6 +2115,7 @@ MINIMAL_COMMENTS:TRUE # reserved code 0x11D (reserved for internal use with -use_mouse) # reserved code 0x290 (reserved for internal use with -use_mouse) # +.fi # Other codes not listed above may be available for additional keys, # depending on operating system and libraries used to compile Lynx. # On some systems, if compiled with recent versions of slang or ncurses @@ -1855,102 +2128,106 @@ MINIMAL_COMMENTS:TRUE # mappings done here: KEYMAP maps the result of that step (which still # represents a key) to a function (which represents an action that Lynx # should perform). - -#KEYMAP:0x5C:SOURCE # Toggle source viewing mode (show HTML source) -#KEYMAP:^R:RELOAD # Reload the current document and redisplay -#KEYMAP:q:QUIT # Ask the user to quit -#KEYMAP:Q:ABORT # Quit without verification -#KEYMAP:0x20:NEXT_PAGE # Move down to next page -#KEYMAP:-:PREV_PAGE # Move up to previous page -#KEYMAP:^P:UP_TWO # Move display up two lines -#KEYMAP:0x10C:UP_TWO # Function key Insert - Move display up two lines -#KEYMAP:^N:DOWN_TWO # Move display down two lines -#KEYMAP:0x10D:DOWN_TWO # Function key Remove - Move display down two lines -#KEYMAP:(:UP_HALF # Move display up half a page -#KEYMAP:):DOWN_HALF # Move display down half a page -#KEYMAP:^W:REFRESH # Refresh the screen -#KEYMAP:^A:HOME # Go to top of current document -#KEYMAP:0x106:HOME # Keypad Home - Go to top of current document -#KEYMAP:0x10A:HOME # Function key Find - Go to top of current document -#KEYMAP:^E:END # Go to bottom of current document -#KEYMAP:0x107:END # Keypad End - Go to bottom of current document -#KEYMAP:0x10B:END # Function key Select - Go to bottom of current document -#KEYMAP:0x100:PREV_LINK # Move to the previous link or page -#KEYMAP:0x101:NEXT_LINK # Move to the next link or page -#KEYMAP:0x10F:FASTBACKW_LINK # Back Tab - Move to previous link or text area -#KEYMAP:^I:FASTFORW_LINK # Tab key - Move always to next link or text area -#KEYMAP:<:UP_LINK # Move to the link above -#KEYMAP:>:DOWN_LINK # Move to the link below -#KEYMAP:0x7F:HISTORY # Show the history list -#KEYMAP:0x08:HISTORY # Show the history list -#KEYMAP:0x103:PREV_DOC # Return to the previous document in history stack -#KEYMAP:0x102:ACTIVATE # Select the current link -#KEYMAP:0x109:ACTIVATE # Function key Do - Select the current link -#KEYMAP:g:GOTO # Goto a random URL -#KEYMAP:G:ECGOTO # Edit the current document's URL and go to it -#KEYMAP:H:HELP # Show default help screen -#KEYMAP:0x108:DWIMHELP # Function key Help - Show a help screen -#KEYMAP:i:INDEX # Show default index +# +.nf +#KEYMAP:0x5C:SOURCE # Toggle source viewing mode (show HTML source) +#KEYMAP:^R:RELOAD # Reload the current document and redisplay +#KEYMAP:q:QUIT # Ask the user to quit +#KEYMAP:Q:ABORT # Quit without verification +#KEYMAP:0x20:NEXT_PAGE # Move down to next page +#KEYMAP:-:PREV_PAGE # Move up to previous page +#KEYMAP:^P:UP_TWO # Move display up two lines +#KEYMAP:0x10C:UP_TWO # Function key Insert - Move display up two lines +#KEYMAP:^N:DOWN_TWO # Move display down two lines +#KEYMAP:0x10D:DOWN_TWO # Function key Remove - Move display down two lines +#KEYMAP:(:UP_HALF # Move display up half a page +#KEYMAP:):DOWN_HALF # Move display down half a page +#KEYMAP:^W:REFRESH # Refresh the screen +#KEYMAP:^A:HOME # Go to top of current document +#KEYMAP:0x106:HOME # Keypad Home - Go to top of current document +#KEYMAP:0x10A:HOME # Function key Find - Go to top of current document +#KEYMAP:^E:END # Go to bottom of current document +#KEYMAP:0x107:END # Keypad End - Go to bottom of current document +#KEYMAP:0x10B:END # Function key Select - Go to bottom of current document +#KEYMAP:0x100:PREV_LINK # Move to the previous link or page +#KEYMAP:0x101:NEXT_LINK # Move to the next link or page +#KEYMAP:0x10F:FASTBACKW_LINK # Back Tab - Move to previous link or text area +#KEYMAP:^I:FASTFORW_LINK # Tab key - Move always to next link or text area +#KEYMAP:<:UP_LINK # Move to the link above +#KEYMAP:>:DOWN_LINK # Move to the link below +#KEYMAP:0x7F:HISTORY # Show the history list +#KEYMAP:0x08:HISTORY # Show the history list +#KEYMAP:0x103:PREV_DOC # Return to the previous document in history stack +#KEYMAP:0x102:ACTIVATE # Select the current link +#KEYMAP:0x109:ACTIVATE # Function key Do - Select the current link +#KEYMAP:g:GOTO # Goto a random URL +#KEYMAP:G:ECGOTO # Edit the current document's URL and go to it +#KEYMAP:H:HELP # Show default help screen +#KEYMAP:0x108:DWIMHELP # Function key Help - Show a help screen +#KEYMAP:i:INDEX # Show default index #*** Edit FORM_LINK_* messages in LYMessages_en.h if you change NOCACHE *** -#KEYMAP:x:NOCACHE # Force submission of form or link with no-cache +#KEYMAP:x:NOCACHE # Force submission of form or link with no-cache #*** Do not change INTERRUPT from 'z' & 'Z' *** -#KEYMAP:z:INTERRUPT # Interrupt network transmission -#KEYMAP:m:MAIN_MENU # Return to the main menu -#KEYMAP:o:OPTIONS # Show the options menu -#KEYMAP:i:INDEX_SEARCH # Search a server based index -#KEYMAP:/:WHEREIS # Find a string within the current document -#KEYMAP:n:NEXT # Find next occurrence of string within document -#KEYMAP:c:COMMENT # Comment to the author of the current document -#KEYMAP:e:EDIT # Edit current document or form's textarea (call: ^Ve) -#KEYMAP:E:ELGOTO # Edit the current link's URL or ACTION and go to it -#KEYMAP:=:INFO # Show info about current document -#KEYMAP:p:PRINT # Show print options -#KEYMAP:a:ADD_BOOKMARK # Add current document to bookmark list -#KEYMAP:v:VIEW_BOOKMARK # View the bookmark list -#KEYMAP:V:VLINKS # List links visited during the current Lynx session -#KEYMAP:!:SHELL # Spawn default shell -#KEYMAP:d:DOWNLOAD # Download current link -#KEYMAP:j:JUMP # Jump to a predefined target -#KEYMAP:k:KEYMAP # Display the current key map -#KEYMAP:l:LIST # List the references (links) in the current document -#KEYMAP:#:TOOLBAR # Go to the Toolbar or Banner in the current document -#KEYMAP:^T:TRACE_TOGGLE # Toggle detailed tracing for debugging -#KEYMAP:;:TRACE_LOG # View trace log if available for the current session -#KEYMAP:*:IMAGE_TOGGLE # Toggle inclusion of links for all images -#KEYMAP:[:INLINE_TOGGLE # Toggle pseudo-ALTs for inlines with no ALT string -#KEYMAP:]:HEAD # Send a HEAD request for current document or link +#KEYMAP:z:INTERRUPT # Interrupt network transmission +#KEYMAP:m:MAIN_MENU # Return to the main menu +#KEYMAP:o:OPTIONS # Show the options menu +#KEYMAP:i:INDEX_SEARCH # Search a server based index +#KEYMAP:/:WHEREIS # Find a string within the current document +#KEYMAP:n:NEXT # Find next occurrence of string within document +#KEYMAP:c:COMMENT # Comment to the author of the current document +#KEYMAP:e:EDIT # Edit current document or form's textarea (call: ^Ve) +#KEYMAP:E:ELGOTO # Edit the current link's URL or ACTION and go to it +#KEYMAP:=:INFO # Show info about current document +#KEYMAP:p:PRINT # Show print options +#KEYMAP:a:ADD_BOOKMARK # Add current document to bookmark list +#KEYMAP:v:VIEW_BOOKMARK # View the bookmark list +#KEYMAP:V:VLINKS # List links visited during the current Lynx session +#KEYMAP:!:SHELL # Spawn default shell +#KEYMAP:d:DOWNLOAD # Download current link +#KEYMAP:j:JUMP # Jump to a predefined target +#KEYMAP:k:KEYMAP # Display the current key map +#KEYMAP:l:LIST # List the references (links) in the current document +#KEYMAP:#:TOOLBAR # Go to the Toolbar or Banner in the current document +#KEYMAP:^T:TRACE_TOGGLE # Toggle detailed tracing for debugging +#KEYMAP:;:TRACE_LOG # View trace log if available for the current session +#KEYMAP:*:IMAGE_TOGGLE # Toggle inclusion of links for all images +#KEYMAP:[:INLINE_TOGGLE # Toggle pseudo-ALTs for inlines with no ALT string +#KEYMAP:]:HEAD # Send a HEAD request for current document or link #*** Must be compiled with USE_EXTERNALS to enable EXTERN *** -#KEYMAP:.:EXTERN # Run external program with url +#KEYMAP:.:EXTERN # Run external program with url #*** Escaping from text input fields with ^V is independent from this: *** -#KEYMAP:^V:SWITCH_DTD # Toggle between SortaSGML and TagSoup HTML parsing -#KEYMAP:0x00:DO_NOTHING # Does nothing (ignore this key) -#KEYMAP:0x10E:DO_NOTHING # Does nothing (ignore this key) +#KEYMAP:^V:SWITCH_DTD # Toggle between SortaSGML and TagSoup HTML parsing +#KEYMAP:0x00:DO_NOTHING # Does nothing (ignore this key) +#KEYMAP:0x10E:DO_NOTHING # Does nothing (ignore this key) # +.fi # In addition to the bindings available by default, the following functions # are not directly mapped to any keys by default, although some of them may # be mapped in specific line-editor bindings (effective while in text input # fields): +.nf # -#KEYMAP:???:RIGHT_LINK # Move to the link to the right -#KEYMAP:???:LEFT_LINK # Move to the link to the left -#KEYMAP:???:LPOS_PREV_LINK # Like PREV_LINK, last column pos if form input -#KEYMAP:???:LPOS_NEXT_LINK # Like NEXT_LINK, last column pos if form input +#KEYMAP:???:RIGHT_LINK # Move to the link to the right +#KEYMAP:???:LEFT_LINK # Move to the link to the left +#KEYMAP:???:LPOS_PREV_LINK # Like PREV_LINK, last column pos if form input +#KEYMAP:???:LPOS_NEXT_LINK # Like NEXT_LINK, last column pos if form input #*** Only useful in form text fields , need PASS or prefixing with ^V: *** -#KEYMAP:???:DWIMHELP # Display help page that may depend on context -#KEYMAP:???:DWIMEDIT # Use external editor for context-dependent purpose +#KEYMAP:???:DWIMHELP # Display help page that may depend on context +#KEYMAP:???:DWIMEDIT # Use external editor for context-dependent purpose #*** Only useful in a form textarea, need PASS or prefixing with ^V: *** -#KEYMAP:???:EDITTEXTAREA # use external editor to edit a form textarea -#KEYMAP:???:GROWTEXTAREA # Add some blank lines to bottom of textarea -#KEYMAP:???:INSERTFILE # Insert file into a textarea (just above cursor) +#KEYMAP:???:EDITTEXTAREA # use external editor to edit a form textarea +#KEYMAP:???:GROWTEXTAREA # Add some blank lines to bottom of textarea +#KEYMAP:???:INSERTFILE # Insert file into a textarea (just above cursor) #*** Only useful with dired support and OK_INSTALL: *** -#KEYMAP:???:INSTALL # install (i.e. copy) local files to new location - +#KEYMAP:???:INSTALL # install (i.e. copy) local files to new location +.fi +# # If TOGGLE_HELP is mapped, in novice mode the second help menu line # can be toggled among NOVICE_LINE_TWO_A, _B, and _C, as defined in # LYMessages_en.h Otherwise, it will be NOVICE_LINE_TWO. # -#KEYMAP:O:TOGGLE_HELP # Show other commands in the novice help menu - +#KEYMAP:O:TOGGLE_HELP # Show other commands in the novice help menu +# # KEYMAP lines can have one or two additional fields. The extended format is # KEYMAP:<KEYSTROKE>:[<MAIN LYNX FUNCTION>]:<OTHER BINDING>[:<SELECT>] # @@ -1961,14 +2238,14 @@ MINIMAL_COMMENTS:TRUE # sense in Dired mode), and SELECT is meaningless. Default built-in override # mappings are # -#KEYMAP:^U:PREV_DOC:DIRED # Return to the previous document -#KEYMAP:.:TAG_LINK:DIRED # Tag a file or directory for later action -#KEYMAP:c:CREATE:DIRED # Create a new file or directory -#KEYMAP:f:DIRED_MENU:DIRED # Display a menu of file operations -#KEYMAP:m:MODIFY:DIRED # Modify name or location of a file or directory -#KEYMAP:r:REMOVE:DIRED # Remove files or directories -#KEYMAP:t:TAG_LINK:DIRED # Tag a file or directory for later action -#KEYMAP:u:UPLOAD:DIRED # Show menu of "Upload Options" +#KEYMAP:^U:PREV_DOC:DIRED # Return to the previous document +#KEYMAP:.:TAG_LINK:DIRED # Tag a file or directory for later action +#KEYMAP:c:CREATE:DIRED # Create a new file or directory +#KEYMAP:f:DIRED_MENU:DIRED # Display a menu of file operations +#KEYMAP:m:MODIFY:DIRED # Modify name or location of a file or directory +#KEYMAP:r:REMOVE:DIRED # Remove files or directories +#KEYMAP:t:TAG_LINK:DIRED # Tag a file or directory for later action +#KEYMAP:u:UPLOAD:DIRED # Show menu of "Upload Options" # # If the OTHER BINDING field does not specify DIRED, then it is taken as a # line-editor action. It is possible to keep the MAIN LYNX FUNCTION field @@ -1981,6 +2258,7 @@ MINIMAL_COMMENTS:TRUE # is in the order in which styles are shown in the Options Menu, starting # with 1 for the Default style). If SELECT is negative (-n), all styles # except n are affected. +.nf # # NOP # Do Nothing # ABORT # Input cancelled @@ -2005,12 +2283,15 @@ MINIMAL_COMMENTS:TRUE # LKCMD # In fields: Invoke key command prompt (default for ^V) # PASS # In fields: handle as non-lineedit key; in prompts: ignore # +.fi # Modify following key (prefixing only works within line-editing, edit actions # of some resulting prefixed keys are built-in, see Line Editor help pages) # SETM1 # Set modifier 1 flag (default for ^X - key prefix) # SETM2 # Set modifier 2 flag (another key prefix - same effect) # # May not always be compiled in: +.nf +# # TPOS # Transpose characters # SETMARK # emacs-like set-mark-command # XPMARK # emacs-like exchange-point-and-mark @@ -2019,16 +2300,23 @@ MINIMAL_COMMENTS:TRUE # SWMAP # Switch input keymap # PASTE # ClipBoard to Lynx - Windows Extension # +.fi # May work differently from expected if not bound to their expected keys: +.nf +# # CHAR # Insert printable char (default for all ASCII printable) # ENTER # Input complete, return char/lynxkeycode (for RETURN/ENTER) # TAB # Input complete, return TAB (for ASCII TAB char ^I) # +.fi # Internal use, probably not useful for binding, listed for completeness: +.nf +# # UNMOD # Fall back to no-modifier command # AIX # Hex 97 # C1CHAR # Insert C1 char if printable # +.fi # If OTHER BINDING specifies PASS, then if the key is pressed in a text input # field it is passed by the built-in line-editor to normal KEYMAP handling, # i.e. this flag acts like an implied ^V escape (always overrides line-editor @@ -2041,6 +2329,7 @@ MINIMAL_COMMENTS:TRUE #KEYMAP:^U::ERASE:1 # set line-edit binding for ^U, for default style #KEYMAP:^[::SETM2:3 # use escape key as modifier - works only sometimes +.h2 JUMPFILE # Alternate jumps files can be defined and mapped to keys here. If the # keys have already been mapped, then those mappings will be replaced, # but you should leave at least one key mapped to the default jumps @@ -2054,9 +2343,14 @@ MINIMAL_COMMENTS:TRUE # where path should begin with a '/' (i.e., not include file://localhost). # Any white space following a prompt string will be trimmed, and a single # space will be added by Lynx. -# +.ex #JUMPFILE:/Lynx_Dir/ips.html:i:IP or Interest group (? for list): +.h1 External Programs +# These settings control the ability of Lynx to invoke various programs for +# the user. + +.h2 CSWING_PATH # VMS ONLY: #========== # On VMS, CSwing (an XTree emulation for VTxxx terminals) is intended for @@ -2077,6 +2371,28 @@ MINIMAL_COMMENTS:TRUE # #CSWING_PATH:swing +.h1 Internal Behavior + +# AUTO_UNCACHE_DIRLISTS determines when local file directory listings are +# automatically regenerated (by re-reading the actual directory from disk). +# Set the value to 0 to avoid automatic regeneration in most cases. This is +# useful for browsing large directories that take some time to read and format. +# An update can still always be forced with the RELOAD key, and specific DIRED +# actions may cause a refresh anyway. Set the value to 1 to force regeneration +# after commands that usually change the directory or some files and would make +# the displayed info stale, like EDIT and REMOVE. Set it to 2 (the default) or +# greater to force regeneration even after leaving the displayed directory +# listing by some action that usually causes no change, like GOTO or entering a +# file with the ACTIVATE key. This option is only honored in DIRED mode (i.e. +# when lynx is compiled with DIRED_SUPPORT and it is not disabled with a +# -restriction). Local directories displayed without DIRED normally act as if +# AUTO_UNCACHE_DIRLISTS:0 was in effect. +# +#AUTO_UNCACHE_DIRLISTS:2 + +.h1 Appearance + +.h2 LIST_FORMAT # Unix ONLY: #=========== # LIST_FORMAT defines the display for local files when Lynx has been @@ -2086,6 +2402,7 @@ MINIMAL_COMMENTS:TRUE # modified parameter list. # # The percent items in the list are interpreted as follows: +.nf # # %p Unix-style permission bits # %l link count @@ -2100,22 +2417,29 @@ MINIMAL_COMMENTS:TRUE # %K as above but omit size for directories # %s size of file in bytes # +.fi # Anything between the percent and the letter is passed on to sprintf. # A double percent yields a literal percent on output. Other characters # are passed through literally. # # If you want only the filename: # +.ex #LIST_FORMAT: %a # # If you want a brief output: # +.ex #LIST_FORMAT: %4K %-12.12d %a # # If you want the Unix "ls -l" format: # +.ex #LIST_FORMAT: %p %4l %-8.8o %-8.8g %7s %-12.12d %a +.h1 External Programs + +.h2 DIRED_MENU # Unix ONLY: #=========== # DIRED_MENU items are used to compose the F)ull menu list in DIRED mode @@ -2128,6 +2452,7 @@ MINIMAL_COMMENTS:TRUE # definitions, so a complete set must then be defined here. # # Each line consists of the following fields: +.nf # # DIRED_MENU:type:suffix:link text:extra text:action # @@ -2147,12 +2472,13 @@ MINIMAL_COMMENTS:TRUE # link text and action are scanned for % sequences that are expanded # at display time as follows: # -# %p path of current selection -# %f filename (last component) of current selection -# %t tagged list (full paths) -# %l list of tagged file names -# %d the current directory +# %p path of current selection +# %f filename (last component) of current selection +# %t tagged list (full paths) +# %l list of tagged file names +# %d the current directory # +.fi #DIRED_MENU:::New File:(in current directory):LYNXDIRED://NEW_FILE%d #DIRED_MENU:::New Directory:(in current directory):LYNXDIRED://NEW_FOLDER%d @@ -2222,6 +2548,9 @@ MINIMAL_COMMENTS:TRUE #DIRED_MENU:TAG::Remove all tagged files and directories.::LYNXDIRED://REMOVE_TAGGED #DIRED_MENU:TAG::Untag all tagged items.::LYNXDIRED://CLEAR_TAGGED +.h1 Internal Behavior + +.h2 NONRESTARTING_SIGWINCH # Some systems only: #=================== # Lynx tries to detect window size changes with a signal handler for @@ -2238,10 +2567,12 @@ MINIMAL_COMMENTS:TRUE # otherwise. The non-restarting behavior can also be changed to TRUE # or FALSE with the -nonrestarting_sigwinch switch, which overrides the # value in this file. +# # Note that Lynx never re-parses document text purely as a result of a # window size change, so text lines may appear truncated after narrowing # the window, until the document is reloaded with ^R or a similar key # or until a different text is loaded. +# # The default is FALSE since there is a possibility that non-restarting # interrupts may be mis-interpreted as fatal input errors in some # configurations (leading to an abrupt program exit), and since this @@ -2251,6 +2582,7 @@ MINIMAL_COMMENTS:TRUE # #NONRESTARTING_SIGWINCH:FALSE +.h2 NO_FORCED_CORE_DUMP # Unix ONLY: #=========== # If NO_FORCED_CORE_DUMP is set to TRUE, Lynx will not force @@ -2265,27 +2597,33 @@ MINIMAL_COMMENTS:TRUE # #NO_FORCED_CORE_DUMP:FALSE +.h1 Appearance + +.h2 COLOR # COLORS (only available if compiled with SVr4 curses or slang) # # The line must be of the form: +# # COLOR:Integer:Foreground:Background +.nf # # The Integer value is interpreted as follows: -# 0 - normal - normal text -# 1 - bold - hyperlinks, see also BOLD_* options above -# 2 - reverse - statusline -# 3 - bold + reverse (not used) -# 4 - underline - text emphasis (EM, I, B tags etc.) -# 5 - bold + underline - hyperlinks within text emphasis -# 6 - reverse + underline - currently selected hyperlink -# 7 - reverse + underline + bold - WHEREIS search hits +# 0 - normal - normal text +# 1 - bold - hyperlinks, see also BOLD_* options above +# 2 - reverse - statusline +# 3 - bold + reverse (not used) +# 4 - underline - text emphasis (EM, I, B tags etc.) +# 5 - bold + underline - hyperlinks within text emphasis +# 6 - reverse + underline - currently selected hyperlink +# 7 - reverse + underline + bold - WHEREIS search hits # # Each Foreground and Background value must be one of: -# black red green brown -# blue magenta cyan lightgray -# gray brightred brightgreen yellow -# brightblue brightmagenta brightcyan white +# black red green brown +# blue magenta cyan lightgray +# gray brightred brightgreen yellow +# brightblue brightmagenta brightcyan white # +.fi # or (if you have configured using --enable-default-colors with ncurses or # slang), "default" may be used for foreground and background. # @@ -2300,6 +2638,9 @@ MINIMAL_COMMENTS:TRUE #COLOR:6:red:white #COLOR:7:magenta:cyan +.h1 External Programs + +.h2 EXTERNAL # External application support. This feature allows Lynx to pass a given # URL to an external program. It was written for three reasons. # @@ -2338,6 +2679,9 @@ MINIMAL_COMMENTS:TRUE # #EXTERNAL:ftp:wget %s &:TRUE +.h1 Internal Behavior + +.h2 RULE # CERN-style rules, EXPERIMENTAL - URL-specific rules # # A CERN-style rules file can be given with RULESFILE. Use the system's @@ -2357,7 +2701,22 @@ MINIMAL_COMMENTS:TRUE # RULE:Fail finger:* # but not others # RULE:Redirect http://old.server/* http://new.server/* - +.h1 Appearance + +.h2 HTMLSRC_ABRACKET +.h2 HTMLSRC_ATTRIB +.h2 HTMLSRC_ATTRNAME_XFORM +.h2 HTMLSRC_ATTRVAL +.h2 HTMLSRC_BADATTR +.h2 HTMLSRC_BADSEQ +.h2 HTMLSRC_BADTAG +.h2 HTMLSRC_COMM +.h2 HTMLSRC_ENTIRE +.h2 HTMLSRC_ENTITY +.h2 HTMLSRC_HREF +.h2 HTMLSRC_SGMLSPECIAL +.h2 HTMLSRC_TAG +.h2 HTMLSRC_TAGNAME_XFORM # Pretty source view settings. These settings are in effect when -prettysrc # is specified. # The following lexical elements (lexemes) are recognized: @@ -2376,47 +2735,56 @@ MINIMAL_COMMENTS:TRUE # <TAGCLOSE>:= !tagname # # The following table gives correspondence between lexeme and lexeme name -# Lexeme LEXEMENAME FURTHER EXPLANATION -# ------------------------------------ -# comment COMM -# tag TAG recognized tag name only -# attribute ATTRIB -# attribute value ATTRVAL -# generalized brackets ABRACKET < > </ -# entity ENTITY -# hyperlink destination HREF -# entire file ENTIRE -# bad sequence BADSEQ bad entity or invalid construct at text +.nf +# Lexeme LEXEMENAME FURTHER EXPLANATION +# ========================================================= +# comment COMM +# tag TAG recognized tag name only +# attribute ATTRIB +# attribute value ATTRVAL +# generalized brackets ABRACKET < > </ +# entity ENTITY +# hyperlink destination HREF +# entire file ENTIRE +# bad sequence BADSEQ bad entity or invalid construct at text # level. -# bad tag BADTAG Unrecognized construct in generalized +# bad tag BADTAG Unrecognized construct in generalized # brackets. -# bad attribute BADATTR The name of the attribute unknown to lynx +# bad attribute BADATTR The name of the attribute unknown to lynx # of the tag known to lynx. (i.e., # attributes of unknown tags will have # markup of ATTRIB) -# sgml special SGMLSPECIAL doctype, sgmlelt, sgmlele, +# sgml special SGMLSPECIAL doctype, sgmlelt, sgmlele, # sgmlattlist, marked section, identifier +.fi +# +# Notes: # -# Notes: # 1) The markup for HTML_ENTIRE will be emitted only once - it will surround # entire file source. +# # 2) The tagnames specified by TAGSPEC should be valid html tag names. +# # 3) If the tag/class combination given by TAGOPEN is not assigned a color # style in lss file (for lynx compiled with lss support), that tag/class # combination will be emitted anyway during internal html markup. Such # combinations will be also reported to the trace log. +# # 4) Lexeme 'tag' means tag name only +# # 5) Angle brackets of html specials won't be surrounded by markup for ABRACKET # -# Examples: +.ex # HTMLSRC_COMM:B I:!I !B -# - html comments will be surrounded by <b><i> and </i></b> in the +# HTML comments will be surrounded by <b><i> and </i></b> in the # internal html markup +.ex # HTMLSRC_ATTRVAL: span.attrval : !span -# - values of the attributes will be surrounded by the +# Values of the attributes will be surrounded by the # <SPAN class=attrval> </SPAN> +.ex # HTMLSRC_HREF:: -# - no special html markup will surround hyperlink destinations ( +# No special html markup will surround hyperlink destinations ( # this means that only default color style for hrefs will be applied # to them) # @@ -2456,6 +2824,7 @@ MINIMAL_COMMENTS:TRUE #HTMLSRC_TAGNAME_XFORM:2 #HTMLSRC_ATTRNAME_XFORM:2 +.h2 PSRCVIEW_NO_ANCHOR_NUMBERING # PSRCVIEW_NO_ANCHOR_NUMBERING - pretty source view setting # If "keypad mode" in 'O'ptions screen is "Links are numbered" or # "Links and form fields are numbered", and PSRCVIEW_NO_ANCHOR_NUMBERING is @@ -2465,6 +2834,9 @@ MINIMAL_COMMENTS:TRUE # Default is FALSE. #PSRCVIEW_NO_ANCHOR_NUMBERING:FALSE +.h1 HTML Parsing + +.h2 FORCE_EMPTY_HREFLESS_A # FORCE_EMPTY_HREFLESS_A - HTML parsing # This option mirrors command-line option with the same name. Default is # FALSE. If true, then any 'A' element without HREF will be closed @@ -2476,6 +2848,9 @@ MINIMAL_COMMENTS:TRUE # #FORCE_EMPTY_HREFLESS_A:FALSE +.h1 Appearance + +.h2 JUSTIFY # JUSTIFY - Appearance # This option mirrors command-line option with same name. Default is TRUE. If # true, most of text (except headers and like this) will be justified. This @@ -2485,6 +2860,9 @@ MINIMAL_COMMENTS:TRUE # #JUSTIFY:TRUE +.h1 Interaction + +.h2 TEXTFIELDS_NEED_ACTIVATION # If TEXTFIELDS_NEED_ACTIVATION is set to TRUE, and lynx was compiled with # TEXTFIELDS_MAY_NEED_ACTIVATION defined, then text input form fields need # to be activated (by pressing the Enter key or similar) before the user @@ -2498,6 +2876,7 @@ MINIMAL_COMMENTS:TRUE # #TEXTFIELDS_NEED_ACTIVATION:FALSE +.h2 LEFTARROW_IN_TEXTFIELD_PROMPT # LEFTARROW_IN_TEXTFIELD_PROMPT # This option controls what happens when a Left Arrow key is pressed while # in the first position of an active text input field. By default, Lynx