# lynx.cfg file. # The default placement for this file is /usr/local/lib/lynx.cfg (Unix) # or Lynx_Dir:lynx.cfg (VMS) # # Definition pairs are of the form VARIABLE:DEFINITION # NO spaces are allowed between the pair items. # # If you do not have access to /usr/local/bin you may change # the default location of this file in the userdefs.h file and recompile, # or specify it's location on the command line with the "-cfg" # command line option. # # Items may be commented out by putting a '#' as the FIRST char of the line # # All definitions must be flush left and have NO spaces.!!! # # # STARTFILE is the default URL if none is specified on the command line # or via a WWW_HOME environment variable. # note: these files can be remote (http://www.w3.org/default.html) # or local (file://localhost/PATH_TO/FILENAME # replace PATH_TO with the complete path to FILENAME # use Unix SHELL syntax and include the device on VMS systems) # STARTFILE:http://lynx.browser.org/ # HELPFILE must be defined as a URL and must have a # complete path if local: # file://localhost/PATH_TO/lynx_help/lynx_help_main.html # Replace PATH_TO with the path to the lynx_help subdirectory # for this distribution (use SHELL syntax including the device # on VMS systems). # The default HELPFILE is: # http://www.crl.com/~subir/lynx/lynx_help/lynx_help_main.html # This should be changed to the local path. # HELPFILE:http://www.crl.com/~subir/lynx/lynx_help/lynx_help_main.html #HELPFILE:file://localhost/PATH_TO/lynx_help/lynx_help_main.html # DEFAULT_INDEX_FILE is the default file retrieved when the # user presses the 'I' key when viewing any document. # An index to your CWIS can be placed here or a document containing # pointers to lots of interesting places on the web. # DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html # Set GOTOBUFFER to TRUE if you want to have the previous goto URL, # if any, offered for reuse or editing when using the 'g'oto command. # The default is defined in userdefs.h. If left FALSE, the circular # buffer of previously entered goto URLs can still be invoked via the # Up-Arrow or Down-Arrow keys after entering the 'g'oto command. # #GOTOBUFFER:FALSE # JUMP_PROMPT is the default statusline prompt for jumps files (see below). # You can change the prompt here from that defined in userdefs.h. Any # trailing white space will be trimmed, and a single space added by Lynx # following the last non-white character. You must set the default prompt # before setting the default jumps file (below). If a default jumps file # was set via userdefs.h, and you change the prompt here, you must set the # default jumps file again (below) for the change to be implemented. # #JUMP_PROMPT:Jump to (use '?' for list): # JUMPFILE is the default local file checked for shortcut URL's when # the user presses the 'J' (JUMP) key. The user will be prompted for # a shortcut entry (analogously to 'g'oto), and can enter one # or use '?' for a list of the shortcuts with associated links to # their actual URL's. See the sample jumps files in the samples # subdirectory. Make sure your jumps file includes a '?' shortcut # for a file://localhost URL to itself: # #
?
This Shortcut List # # If not defined here or in userdefs.h, the JUMP command will invoke # the NO_JUMPFILE statusline message (see userdefs.h). # # On VMS, use Unix SHELL syntax (including a lead slash) to define it. # # Do not include "file://localhost" in the definition. # # Additional, alternate jumps files can be defined and mapped to # keystrokes at the bottom of lynx.cfg, but you should first define # the default jumps file (mapped by default to 'J', and to 'j' when # the "VI keys" 'o'ption is not ON) here or in userdefs.h, if you # wish to implement the jumps mechanism. # #JUMPFILE:/Lynx_Dir/jumps.html # Set JUMPBUFFER to TRUE if you want to have the previous jump target, # if any, offered for reuse or editing when using the 'J'ump command. # The default is defined in userdefs.h. If left FALSE, the circular # buffer of previously entered targets (shortcuts) can still be invoked # via the Up-Arrow or Down-Arrow keys after entering the 'J'ump command. # If multiple jumps files are installed, the recalls of shortcuts will # be specific to each file. If Lynx was built with PERMIT_GOTO_FROM_JUMP # defined, any random URLs used instead of shortcuts will be stored in the # goto URL buffer, not in the shortcuts buffer(s), and the single character # ':' can be used as a target to invoke the goto URL buffer (as if 'g'oto # followed by Up-Arrow had been entered). # #JUMPBUFFER:FALSE # If SAVE_SPACE is defined, it will be used as a path prefix for the # suggested filename in "Save to Disk" operations from the 'p'rint or # 'd'ownload menus. On VMS, you can use either VMS (e.g., "SYS$LOGIN:") # or Unix syntax (including '~' for the HOME directory). On Unix, you # must use Unix syntax. If the symbol is not defined, or is zero-length # (""), no prefix will be used, and only a filename for saving in the # current default directory will be suggested. # This definition will be overridden if a "LYNX_SAVE_SPACE" environment # variable has been set on Unix, or logical has been defined on VMS. # #SAVE_SPACE:~/foo/ # If LYNX_HOST_NAME is defined here or in userdefs.h, it will be # treated as an alias for the local host name in checks for URLs on # the local host (e.g., when the -localhost switch is set), and this # host name, "localhost", and HTHostName (the fully qualified domain # name of the system on which Lynx is running) will all be passed as # local. A different definition here will override that in userdefs.h. # #LYNX_HOST_NAME:www.cc.ukans.edu # localhost aliases # Any LOCALHOST_ALIAS definitions also will be accepted as local when # the -localhost switch is set. These need not actually be local, i.e., # in contrast to LYNX_HOST_NAME, you can define them to trusted hosts at # other Internet sites. # #LOCALHOST_ALIAS:gopher.server.domain #LOCALHOST_ALIAS:news.server.domain # LOCAL_DOMAIN is used for a tail match with the ut_host element of # the utmp or utmpx structure on systems with utmp capabilities, to # determine if a user is local to your campus or organization when # handling -restrictions=inside_foo or outside_foo settings for ftp, # news, telnet/tn3270 and rlogin URLs. An "inside" user is assumed # if your system does not have utmp capabilities. CHANGE THIS here # if it was not changed in userdefs.h at compilation time. # #LOCAL_DOMAIN:ukans.edu # NOTE: The following paragraph applies for standard Lynx, or if Lynx is # compiled without -DEXP_CHARTRANS. # # CHARACTER_SET defines the default character set, i.e., that assumed # to be installed on the user's terminal. It determines which characters # or strings will be used to represent 8-bit character entities within # HTML. New character sets may be defined by modifying the file # src/LYCharSets.c in the Lynx source code distribution and recompiling. # For Asian (CJK) character sets, it also determines how Kanji code will # be handled. The default is defined in userdefs.h and can be changed # here, and via the 'o'ptions menu. The 'o'ptions menu setting will be # stored in the user's RC file whenever those settings are saved, and # thereafter will be used as the default. The actions of the -raw switch # and LYK_RAW_TOGGLE ('@') are dependent on the character set. For the # Asian (CJK) sets and "ISO Latin 1", the corresponding charset is assumed # in documents, i.e., raw or CJK mode is ON by default, so that -raw or the # initial LYK_RAW_TOGGLE will turn the mode OFF. The inverse is true for # all other character sets. The toggling also can be done via the 'o'ptions # menu. In raw or CJK mode, 8-bit characters are not reverse translated in # relation to the src/CharSets.c entity conversion arrays, i.e., they are # assumed to be appropriate for the current character set. It should be # toggled ON when, for example, "ISO Latin 2" or "KOI8-R character set" is # selected and the document has the corresponding charset, and OFF when an # Asian (CJK) character set is selected but the document has the ISO-8859-1 # charset. # # With chartrans, the above is modified as follows: # # Additional character sets and some of their properties may be defined with # tables in the src/chrtrans directory. It is not necessary to change # src/LYCharSets.c to make these new character sets known to Lynx, (although # definitions for the "older" character sets are still there), but the new ones # have to be listed in src/UCdomap.c and, currently, the makefiles in src/ # and src/chrtrans to be automatically used. See README.* files in src/chrtrans/. # # For Lynx a "character set" has two names: a Display Character Set string # for the Options scree and for setting CHARACTER_SET here, and a # corresponding MIME name (for recognizing properly labelled charset # parameters in HTTP headers etc.). Not all Display Character Set names # crrespond to exactly one valid MIME charset (for example "Other ISO Latin", # "Chinese", "Transparent"), in that case an appropriate valid (and more # specific) MIME name should be used where required. # # The default for "raw mode" (before it is changed by -raw or LYK_RAW_TOGGLE), # if the display character set is not a CJK character set, now depends on the # display character set as well as the ASSUME_CHARSET value (see below) from # either this file or an -assume_charset command line option. The mode # defaults to ON if the ASSUME_CHARSET value corresponds to the display # character set, otherwise to OFF. Note that "raw" does not mean that every # byte will be passed to the screen. HTML character entities may get # expanded and translated, inappropriate control characters filtered out, etc. # Raw mode effectively changes the charset assumption about unlabelled # documents. # (There is a "Transparent" pseudo character set for more "rawness".) # # The default character sets include: # Display Character Set name MIME name # ========================== ========= # ISO Latin 1 iso-8859-1 # ISO Latin 2 iso-8859-2 # Other ISO Latin x-iso-8859-other # DEC Multinational dec-mcs # IBM PC character set cp437 # IBM PC codepage 850 cp850 # Macintosh (8 bit) macintosh # NeXT character set x-next # KOI8-R character set koi8-r # Chinese euc-cn # Japanese (EUC) euc-jp # Japanese (SJIS) shift_jis # Korean euc-kr # Taipei (Big5) big5 # 7 bit approximations us-ascii # Transparent x-transparent # ISO Latin 3 iso-8859-3 # ISO Latin 4 iso-8859-4 # ISO Latin 5 Cyrillic iso-8859-5 # ISO Latin 6 Arabic iso-8859-6 # ISO Latin 7 Greek iso-8859-7 # ISO Latin 8 Hebrew iso-8859-8 # ISO Latin 9 (Latin 5) iso-8859-9 # ISO Latin 10 iso-8859-10 # PC Latin2 CP 852 cp852 # DosCyrillic (cp866) cp866 # MS Windows CP 1250 windows-1250 # WinCyrillic (cp1251) windows-1251 # MS Windows CP 1252 iso-8859-1-windows-3.1-latin-1 # Vietnamese (VISCII) viscii # UNICODE UTF 8 unicode-1-1-utf-8 # RFC 1345 w/o Intro mnemonic+ascii+0 # RFC 1345 Mnemonic mnemonic # #CHARACTER_SET:ISO Latin 1 # IF compiled with -DEXP_CHARTRANS: # ASSUME_CHARSET changes the handling of documents which do not # explicitly specify a charset. Normally Lynx assumes that 8-bit # characters in those document are encoded according to iso-8859-1 # (the official default for the HTTP protocol). When ASSUME_CHARSET # given here or by an -assume_charset command line flag is in effect, # Lynx will treat documents as if they were encoded accordingly. # See above on how this interacts with "raw mode" and the Display # Character Set. # The value should be the MIME name of a character set recognized by # Lynx (case insensitive). # #ASSUME_CHARSET:iso-8859-1 # IF compiled with -DEXP_CHARTRANS: # 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 # is used. # This option may interfere with "raw mode" toggling when local files # are viewed (it is "stronger" than the effective change of the charset # assumption caused by changing "raw mode"), so only use when necessary. # #ASSUME_LOCAL_CHARSET:iso-8859-1 # IF compiled with -DEXP_CHARTRANS: # 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 # to deal with charsets unknown to Lynx, if they are "sufficiently # similar" to one that Lynx does know about, by forcing the same # treatment. There is no default, and you probably should leave this # undefined unless necessary. # #ASSUME_UNREC_CHARSET:iso-8859-1 # 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 # transmitted in that language. Users can override this setting via # the 'o'ptions menu and save that preference in their RC file. # #PREFERRED_LANGUAGE:en # 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. The value # should NOT include "ISO-8859-1" or "US-ASCII", since those values are # always assumed by default. If a file in that character set is available, # the server will send it. Otherwise, the server will send the file in # ISO-8859-1 or US-ASCII. Users can change or eliminate this definition # via the 'o'ptions menu and save that preference in their RC file. # #PREFERRED_CHARSET: # 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 # cannot be opened as a local file (file://localhost/string). Both # can be comma-separated lists. Each prefix must end with a dot, each # suffix must begin with a dot, and either may contain other dots (e.g., # .com.jp). The default lists are defined in userdefs.h and can be # changed here. Each prefix will be used with each suffix, in order, # until a valid Internet host is created, based on a successful DNS # lookup (e.g., foo will be tested as www.foo.com and then www.foo.edu # etc.). The first element can include a :port and/or /path which will # be restored with the expanded host (e.g., wfbr:8002/dir/lynx will # become http://www.wfbr.edu:8002/dir/lynx). The prefixes will not be # used if the first element ends in a dot (or has a dot before the # :port or /path), and similarly the suffixes will not be used if the # the first element begins with a dot (e.g., .nyu.edu will become # http://www.nyu.edu without testing www.nyu.com). Lynx will try to # guess the scheme based on the first field of the expanded host name, # and use "http://" as the default (e.g., gopher.wfbr.edu or gopher.wfbr. # will be made gopher://gopher.wfbr.edu). # #URL_DOMAIN_PREFIXES:www. #URL_DOMAIN_SUFFIXES:.com,.edu,.net,.org # 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 # progress messages. Those set by INFOSECS are also basically # progress messages (e.g., that a prompted input has been cancelled) # and should have the shortest pause. Those set by MESSAGESECS are # informational (e.g., that a function is disabled) and should have # a pause of intermediate duration. Those set by ALERTSECS typically # report a serious problem and should be paused long enough to read # whenever they appear (typically unexpectedly). The default values # are defined in userdefs.h, and can be modified here should longer # pauses be desired for braille-based access to Lynx. # #INFOSECS:1 #MESSAGESECS:2 #ALERTSECS:3 # 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 # attribute is present in the SELECT start tag, Lynx always will create a # vertical list of checkboxes for the OPTIONs. # The default defined here or in userdefs.h can be changed via the 'o'ptions # menu and saved in the RC file, and always can be toggled via the -popup # command line switch. # #USE_SELECT_POPUPS:TRUE # 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 # terminal that can't do bold and reverse video at the same time or # at all. It also can be useful to blind users, as an alternative # or supplement to setting LINKS_AND_FORM_FIELDS_ARE_NUMBERED or # LINKS_ARE_NUMBERED. # The default defined here or in userdefs.h can be changed via the # 'o'ptions menu and saved in the RC file, and always can be toggled # via the -show_cursor command line switch. # #SHOW_CURSOR:FALSE # If BOLD_HEADERS is set to TRUE the HT_BOLD default style will be acted # upon for

through

headers. The compilation default is FALSE # (only the indentation styles are acted upon, but see BOLD_H1, below). # On Unix, compilation with -DUNDERLINE_LINKS also will apply to the # HT_BOLD style for headers when BOLD_HEADERS is TRUE. # #BOLD_HEADERS:FALSE # If BOLD_H1 is set to TRUE the HT_BOLD default style will be acted # upon for

headers even if BOLD_HEADERS is FALSE. The compilation # default is FALSE. On Unix, compilation with -DUNDERLINE_LINKS also # will apply to the HT_BOLD style for headers when BOLD_H1 is TRUE. # #BOLD_H1:FALSE # 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. # On Unix, compilation with -DUNDERLINE_LINKS also will apply to the # HT_BOLD style for NAME (ID) anchors when BOLD_NAME_ANCHORS is TRUE. # #BOLD_NAME_ANCHORS:FALSE # The DEFAULT_CACHE_SIZE specifies the number of WWW documents to be # cached in memory at one time. # # This so-called cache size (actually, number) is defined in userdefs.h and # may be modified here and/or with the command line argument -cache=NUMBER # The minimum allowed value is 2, for the current document and at least one # to fetch, and there is no absolute maximum number of cached documents. # On Unix, and VMS not compiled with VAXC, whenever the number is exceeded # the least recently displayed document will be removed from memory. # # On VMS compiled with VAXC, the DEFAULT_VIRTUAL_MEMORY_SIZE specifies the # amount (bytes) of virtual memory that can be allocated and not yet be freed # before previous documents are removed from memory. If the values for both # the DEFAULT_CACHE_SIZE and DEFAULT_VIRTUAL_MEMORY_SIZE are exceeded, then # least recently displayed documents will be freed until one or the other # value is no longer exceeded. The default value was defined in userdefs.h. # # The Unix and VMS but not VAXC implementations use the C library malloc's # and calloc's for memory allocation, and procedures for taking the actual # amount of cache into account still need to be developed. They use only # the DEFAULT_CACHE_SIZE value, and that specifies the absolute maximum # number of documents to cache (rather than the maximum number only if # DEFAULT_VIRTUAL_MEMORY_SIZE has been exceeded, as with VAXC/VAX). # #DEFAULT_CACHE_SIZE:10 #DEFAULT_VIRTUAL_MEMORY_SIZE:512000 # 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 # the PREV_DOC command or via the history list. Lynx always resubmits # forms with method POST when a submit button or a submitting text input # is activated, but normally retrieves the previously returned document # if it had links which you activated, and then go back with the PREV_DOC # command or via the history list. # # The default defined here or in userdefs.h can be toggled via # the -resubmit_forms command line switch. # #ALWAYS_RESUBMIT_POSTS:FALSE # 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 # FALSE, such that a link with "[ISMAP]" as the link name, followed by a # hyphen, will be prepended to the ALT string or "[USEMAP]" pseudo-ALT for # accessing Lynx's text-based rendition of the client-side map (based on # the content of the associated MAP element). If the "[ISMAP]" link is # activated, Lynx will send a 0,0 coordinate pair to the server, which # Lynx-friendly sites can map to a for-text-client document, homologous # to what is intended for the content of a FIG element. # # The compilation default, or default defined here, can be toggled via # the "-ismap" command line switch. # #NO_ISMAP_IF_USEMAP:FALSE # 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 # might not be the same as the current document's URL. # The compilation default is to use the current document's URL in all # cases (i.e., assume the MAP is present below, if it wasn't present # above the point in the HTML stream where the USEMAP attribute was # detected). Lynx's present "single pass" rendering engine precludes # checking below before making the decision on how to resolve a USEMAP # reference consisting solely of a fragment. # #SEEK_FRAG_MAP_IN_CUR:TRUE # 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 # not be the same as the current document's URL. The compilation # default is to use the current document's URL, as is done for the # HREF attribute values of Anchors and LINKs that consist solely of # a fragment. # #SEEK_FRAG_AREA_IN_CUR:TRUE # Local execution links and scripts are completely disabled # in the source code unless they are enabled in the # userdefs.h file and the sources recompiled. Please # see the Lynx source code distribution and the userdefs.h # file for more detail on enabling execution links and scripts. # # If you have enabled execution links or scripts the following # two variables control Lynx's action when an execution link # or script is encountered. # # If LOCAL_EXECUTION_LINKS_ALWAYS_ON is set to TRUE any execution # link or script will be executed no matter where it came from. # This is EXTREMELY dangerous. Since Lynx can access files from # anywhere in the world, you may encounter links or scripts that # will cause damage or compromise the security of your system. # # If LOCAL_EXECUTION_LINKS_ON_BUT_NOT_REMOTE is set to TRUE only # links or scripts that reside on the local machine and are # referenced with a URL beginning with "file://localhost/" or meet # TRUSTED_EXEC or ALWAYS_TRUSTED_EXEC rules (see below) will be # executed. This is much less dangerous than enabling all execution # links, but can still be dangerous. # #LOCAL_EXECUTION_LINKS_ALWAYS_ON:FALSE #LOCAL_EXECUTION_LINKS_ON_BUT_NOT_REMOTE:FALSE # 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 with a URL # beginning with that string. If you wish to restrict the referencing URL's # further, you can extend the string to include a trusted path. You also can # specify a trusted directory for http URL's, which will then be treated as # if they were local rather than remote. For example: # # TRUSTED_EXEC:file://localhost/trusted/ # TRUSTED_EXEC:http://www.wfbr.edu/trusted/ # # If you also wish to restrict the commands which can be executed, create # a series of rules with the path (Unix) or command name (VMS) following # the string, separated by a tab. For example: # # Unix: # TRUSTED_EXEC:file://localhost//bin/cp # TRUSTED_EXEC:file://localhost//bin/rm # VMS: # TRUSTED_EXEC:file://localhost/copy # TRUSTED_EXEC:file://localhost/delete # # Once you specify a TRUSTED_EXEC referencing string, the default is # replaced, and all the referencing strings you desire must be specified # as a series. Similarly, if you associate a command with the referencing # string, you must specify all of the allowable commands as a series of # TRUSTED_EXEC rules for that string. If you specify ALWAYS_TRUSTED_EXEC # rules below, you need not repeat them as TRUSTED_EXEC rules. # # If EXEC_LINKS and JUMPFILE have been defined, any lynxexec or lynxprog # URL's in that file will be permitted, regardless of other settings. If # you also set LOCAL_EXECUTION_LINKS_ON_BUT_NOT_REMOTE:TRUE and a single # TRUSTED_EXEC rule that will always fail (e.g., "none"), then *ONLY* the # lynxexec or lynxprog URL's in JUMPFILE (and any ALWAYS_TRUSTED_EXEC rules, # see below) will be allowed. Note, however, that if Lynx was compiled with # CAN_ANONYMOUS_JUMP set to FALSE (default is TRUE), or -restrictions=jump # is included with the -anonymous switch at run time, then users of an # anonymous account will not be able to access the jumps file or enter # 'j'ump shortcuts, and this selective execution feature will be overridden # as well (i.e., they will only be able to access lynxexec or lynxprog # URLs which meet any ALWAYS_TRUSTED_EXEC rules). # #TRUSTED_EXEC:none # 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, # and may also have disabled jump file links, but still want to allow # execution of particular utility scripts or programs. The format is # like that for TRUSTED_EXEC. For example: # # Unix: # ALWAYS_TRUSTED_EXEC:file://localhost//usr/local/kinetic/bin/usertime # ALWAYS_TRUSTED_EXEC:http://www.more.net//usr/local/kinetic/bin/who.sh # VMS: # ALWAYS_TRUSTED_EXEC:file://localhost/usertime # ALWAYS_TRUSTED_EXEC:http://www.more.net/show users # # The default ALWAYS_TRUSTED_EXEC rule is "none". # #ALWAYS_TRUSTED_EXEC:none # Unix: # ===== # TRUSTED_LYNXCGI rules define the permitted sources and/or paths for # lynxcgi links (if LYNXCGI_LINKS is defined in userdefs.h). The format # is the same as for TRUSTED_EXEC rules (see above), but no defaults are # defined, i.e., if no TRUSTED_LYNXCGI rules are defined here, any source # and path for lynxcgi links will be permitted. Example rules: # # TRUSTED_LYNXCGI:file://localhost/ # TRUSTED_LYNXCGI:/usr/local/etc/httpd/cgi-bin/ # TRUSTED_LYNXCGI:file://localhost//usr/local/www/cgi-bin/ # # VMS: # ==== # Do not define this. # #TRUSTED_LYNXCGI:none # Unix: # ===== # LYNXCGI_ENVIRONMENT adds the current value of the specified # environment variable to the list of environment variables passed on to the # lynxcgi script. Useful variables are HOME, USER, EDITOR, etc... # # VMS: # ==== # Do not define this. # #LYNXCGI_ENVIRONMENT: # Unix: # ===== # LYNXCGI_DOCUMENT_ROOT is the value of DOCUMENT_ROOT that will be passed # to lynxcgi scripts. If set and the URL has PATH_INFO data, then # PATH_TRANSLATED will also be generated. Examples: # LYNXCGI_DOCUMENT_ROOT:/usr/local/etc/httpd/htdocs # LYNXCGI_DOCUMENT_ROOT:/data/htdocs/ # # VMS: # ==== # Do not define this. # #LYNXCGI_DOCUMENT_ROOT: # 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 # https server included a secure attribute for the cookie. The normal # default or that defined here can be toggled via the -force_secure # command line switch. # #FORCE_SSL_COOKIES_SECURE:FALSE # 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! # # NOTE: This can generate A LOT of mail, be warned. # #MAIL_SYSTEM_ERROR_LOGGING:FALSE # 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 # file with a lynxprog URL for invoking mail is available, or your html # pages include an mail launch file URL, the user thereby can access mail # 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 !!! # 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 # instead (e.g., in a public account which will be used by people who # are ignorant about VMS). # #CHECKMAIL:FALSE # 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 INSTALLATION). # Lynx respects RFC 1738 (http://www.ics.uci.edu/pub/ietf/uri/rfc1738.txt) and # and does not accept a host field in news URLs (use nntp: instead news: for # the scheme if you wish to specify an NNTP host in a URL, as explained in the # RFC). If you have not set the variable externally, you can set it at run # time via this configuration file. It will not override an external setting. # Note that on VMS it is set as a process logical rather than symbol, and will # outlive the Lynx image. # #NNTPSERVER:news.server.dom # 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 # 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 # 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 # news group contains more than NEWS_MAX_CHUNK articles, they will be listed # in NEWS_CHUNK_SIZE chunks. You can change the defaults here, and/or on # the command line via -newschunksize=NUMBER and/or -newsmaxchunk=NUMBER # switches. Note that if the chunk size is increased, here or on the command # line, to a value greater than the current maximum, the maximum will be # increased to that number. Conversely, if the maximum is set to a number # less than the current chunk size, the chunk size will be reduced to that # number. Thus, you need use only one of the two switches on the command # line, based on the direction of intended change relative to the compilation # or configuration defaults. The compilation defaults ensure that there will # be at least 10 earlier articles before bothering to chunk and create a link # for earlier articles. # #NEWS_CHUNK_SIZE:30 #NEWS_MAX_CHUNK:40 # 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 # described in the "Supported URL" section of the online 'h'elp. The # posts will be attempted via the nntp server specified in the URL, or # if none was specified, via the NNTPSERVER configuration or environment # variable. Links with these URLs for posting or sending followups are # created by the news gateway when reading group listings or articles # from nntp servers if the server indicates that it permits posting. # The compilation default set in userdefs.h can be changed here. If # the default is TRUE, posting can still be disallowed via the # -restrictions command line switch. # #NEWS_POSTING:TRUE # 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 # directory. If it is in a subdirectory, begin it with a dot-slash # (e.g., ./lynx/.lynxsig). The definition is set in userdefs.h and can # be changed here. # #LYNX_SIG_FILE:.lynxsig # 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 # If COLLAPSE_BR_TAGS is set FALSE, Lynx will not collapse serial BR tags. # Note that the valid way to insert extra blank lines in HTML is via a PRE # block with only newlines in the block. # The default is defined in userdefs.h, and can be overridden here. # #COLLAPSE_BR_TAGS:TRUE # If SET_COOKIES is set FALSE, Lynx will ignore Set-Cookie headers # in http server replies. # The default is defined in userdefs.h, and can be overridden here, # and/or toggled via the -cookies command line switch. # #SET_COOKIES:TRUE # VMS: #===== # The mail command is defined in userdefs.h. It will be spawned as a # subprocess of lynx and used to send replies and error messages. # It can be re-defined here. Your mailer must be able to accept a # subject line through the use of the /subject="SUBJECT" option. # If your mailer uses another syntax, some hacking of the mailmsg() # and reply_by_mail() functions in LYMail.c may be required. # #SYSTEM_MAIL:mail # Unix: #====== # The mail path normally is defined for sendmail (or submit with MMDF) # in userdefs.h. You can change it here, but should first read the # zillions of CERT advisories about security problems with Unix mailers. # You may need some hacking of the mailmsg() and reply_by_mail() functions # in LYMail.c, or interposition of a script, for other mailers. # #SYSTEM_MAIL:/usr/mmdf/bin/submit #SYSTEM_MAIL:/usr/lib/sendmail # 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 # the IN appropriately (e.g., to SMTP, MX, or WINS). # #MAIL_ADRS:"IN%%""%s""" # 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 # headers of such files will indicate that they are Stream_LF with Implied # Carriage Control, which is incorrect, and can cause downloading software # to get confused and unhappy. If you do set it FALSE, you can use the # FIXED512.COM command file, which is included in this distribution, to do # the conversion externally. # #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 # EMACS_KEYS can be turned on by the user in the options # screen or the .lynxrc file. This is just the default. # #EMACS_KEYS_ALWAYS_ON:FALSE # DEFAULT_KEYPAD_MODE specifies whether by default the user # has numbers that work like arrows or else numbered links. # DEFAULT KEYPAD MODE may be set to TRUE for using numbers # as arrows as the default, or FALSE for using numbered links # as the default (LINKS_AND_FORM_FIELDS_ARE_NUMBERED cannot # currently be set by this option.). # #DEFAULT_KEYPAD_MODE_IS_NUMBERS_AS_ARROWS:TRUE # The default search type. # This is a default that can be overridden by the user! # #CASE_SENSITIVE_ALWAYS_ON:FALSE # DEFAULT_BOOKMARK_FILE is a default filename for use as a personal # bookmark file. It will reference a file from the user's home directory. # NOTE that a file ending in .html or other suffix mapped to text/html # should be used to ensure it's treatment as HTML. The built-in default # is lynx_bookmarks.html. On both Unix and VMS, if a subdirectory off of # the HOME directory is desired, the path should begin with "./" (e.g., # ./BM/lynx_bookmarks.html), but the subdirectory must already exist. # Lynx will create the bookmark file, if it does not already exist, on # the first ADD_BOOKMARK attempt if the HOME directory is indicated # (i.e., if the definition is just filename.html without any slashes), # but requires a pre-existing subdirectory to create the file there. # The user can re-define the default bookmark file, as well as a set # of sub-bookmark files if multiple bookmark file support is enabled # (see below), via the 'o'ptions menu, and can save those definitions # in the .lynxrc file. # #DEFAULT_BOOKMARK_FILE:lynx_bookmarks.html # 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 # default bookmark file. FALSE is the default so that one (the default) # bookmark file will be available initially. The definition here will # override that in userdefs.h. The user can turn on multiple bookmark # support via the 'o'ptions menu, and can save that choice as the startup # default via the .lynxrc file. When on, the setting can be STANDARD or # ADVANCED. If support is set to the latter, and the user mode also is # ADVANCED, the VIEW_BOOKMARK command will invoke a statusline prompt at # which the user can enter the letter token (A - Z) of the desired bookmark, # or '=' to get a menu of available bookmark files. The menu always is # presented in NOVICE or INTERMEDIATE mode, or if the support is set to # STANDARD. No prompting or menu display occurs if only one (the startup # default) bookmark file has been defined (define additional ones via the # 'o'ptions menu). The startup default, however set, can be overridden on # the command line via the -restrictions=multibook or the -anonymous or # -validate switches. # #MULTI_BOOKMARK_SUPPORT:FALSE # 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. # It can also be set via the -restrictions=multibook or the -anonymous # or -validate command line switches. # #BLOCK_MULTI_BOOKMARKS:FALSE # 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) # ADVANCED help is replaced by the URL of the current link # #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 get out of. Users can # easily define an editor of their own using the options menu, # so it is not always desirable to set the DEFAULT_EDITOR. # #DEFAULT_EDITOR: # SYSTEM_EDITOR behaves the same as DEFAULT_EDITOR except that it can't be # changed. # #SYSTEM_EDITOR: # Proxy variables # 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 PROTOCOL_proxy environment variables (see INSTALLATION). # If you have not set them externally, you can set them at run time via # this configuration file. They will not override external settings. # The no_proxy variable can be a comma-separated list of hosts which should # not be proxied, or an asterisk to override all proxy variables. # Note that on VMS they are set as process logicals rather than symbols, # to preserve lowercasing, and will outlive the Lynx image. # #http_proxy:http://some.server.dom:port/ #https_proxy:http://some.server.dom:port/ #ftp_proxy:http://some.server.dom:port/ #gopher_proxy:http://some.server.dom:port/ #news_proxy:http://some.server.dom:port/ #newspost_proxy:http://some.server.dom:port/ #newsreply_proxy:http://some.server.dom:port/ #snews_proxy:http://some.server.dom:port/ #snewspost_proxy:http://some.server.dom:port/ #snewsreply_proxy:http://some.server.dom:port/ #nntp_proxy:http://some.server.dom:port/ #wais_proxy:http://some.server.dom:port/ #finger_proxy:http://some.server.dom:port/ #cso_proxy:http://some.server.dom:port/ #no_proxy:host.domain.dom # Printer definitions # any number of printers may be defined by using multiple # printer definition sets. Printers may be any program # that could be useful to your users, they do not necessarily # have to print. # # the definition of a printer is of the form # PRINTER:::: # # is the name that the user will see. # is the command line arguments for printing a file. # The %s will be replaced with the file being printed. # If a second %s is given the second %s will be replaced by # a suggested filename that is prettier than the tempfile # name given in the first %s. This does not remove the first # %s from the command line in any manner. If you need to # use only the second %s file name in your printer command, # then I suggest creating a script which will first copy the # first %s file name to the second %s file name, and then # executing your print command with the second %s file name. # specifies whether the printer should be disabled for # users without printing options. The options are # TRUE or FALSE; # TRUE means the printer will always be ENABLED # regardless of printer or anonymous settings # FALSE means the printer will be DISABLED when # the -noprint option is on, or for anonymous # users which are not allowed to print # # is an optional parameter for indicating the number of # lines per page for the printer. Defaults to 66. Used # for computing the approximate number of pages and # generating a statusline query of whether to proceed if # the document is longer than 4 printer pages. Uses the # current screen length for the computation when the # built in "print to screen" option is selected. # # You must put the whole definition on one line. # # If you must use a colon, precede it with a backslash! # # 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. # # examples #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 #PRINTER:Busy VMS printer:@Lynx_Dir\:VMSPrint sys$print %s:FALSE:58 # Check out the lpansi program in utils/ for printing on vt100 # attached printers. #PRINTER:Use vt100 print sequence to print from your local terminal:lpansi %s:TRUE # Don't use the following printer on anonymous accounts since # allowing shell input is very dangerous. #PRINTER:Specify your own print command:echo -n "Enter a print command\: "; read word; sh -c "$word %s":FALSE # Pass to a sophisticated file viewer (sources for most are available in # ftp://space.mit.edu/pub/davis/most). The most -k switch suppresses the # invocation of hexadecimal display mode if 8-bit or control characters # are present. The +s switch invokes secure mode. #PRINTER:Use Most to view:most -k +s %s:TRUE:23 # Downloader definitions # any number of downloaders may be defined by using multiple # downloader definition sets. Downloaders may be any program # that could be useful to your users, they do not necessarily # have to be a download protocol program. The most common use # of a downloader is to use Ckermit or some other transfer # program so that the user may easily transfer files back to # their local machine over a serial link. # # the definition of a downloader is of the form # DOWNLOADER::: # # is the name that the user will see. # is the command line arguments for downloading a file. # The %s will be replaced with the file being downloaded. # If a second %s is given the second %s will be replaced # by a suggested filename that is nicer than the tempfile # name given in the first %s. This does not replace the # first %s in the command line. If your command needs # the suggest file name on the command line only, then # I suggest creating a script that will first copy the # first %s file name to the second %s file name, and then # execute the downloading command using the second %s file # name (e.g., 'sz' needs such a script interposed). # specifies whether the downloader should be disabled for # anonymous users. The options are # TRUE or FALSE; # TRUE means the downloader will always be ENABLED # regardless of the anonymous settings (however, # all downloading is disabled by -validate). # FALSE means the downloader will be DISABLED when # the user is anonymous. # # You must put the whole definition on one line. # # If you must use a colon, precede it with a backslash! # # examples #DOWNLOADER:Use Most to view:most +s %s:TRUE # (don't use most's -k switch, so that binaries will invoke hexadecimal mode) #DOWNLOADER:Use Kermit to download to the local terminal:kermit -i -s %s -a %s:TRUE #DOWNLOADER:Use Zmodem to download to the local terminal:sz %s:TRUE # (example script in lieu of :sz %s: for offering a suggested filename) # :set %s %s;td=/tmp/Lsz$$;mkdir $td;ln -s $1 $td/"$2";sz $td/"$2";rm -r $td: # 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 program # that could be useful to your users, they do not necessarily # have to be an upload protocol program. 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::: # # 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 # 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) # will not be included in the directory browser's listings. If set FALSE, you # can force it to be treated as TRUE via -restrictions=dotfiles. If set FALSE # and not forced TRUE, the user can regulate it via the 'o'ptions menu (and # may save the preference in the RC file). # #NO_DOT_FILES:TRUE # 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 # sent) and the default can be changed here. The default can be toggled at # run time via the -from switch. Note that transmissions of From headers # have become widely considered to create an invasion of privacy risk. # #NO_FROM_HEADER:TRUE # 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 # URLs, 'j'ump shortcuts, bookmark file links, history list links, or # URLs that include the content from form submissions with method GET. # If left FALSE here, it can be set TRUE at run time via the -noreferer # switch. # #NO_REFERER_HEADER:FALSE # 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 # with the local file system are never indicated to servers, even if # NO_REFERER_HEADER is FALSE. If left FALSE here, it can be set TRUE # at run time via the -nofilereferer switch. # #NO_FILE_REFERER:FALSE # 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. For # ISMAP or other graphic links, the ALT or pseudo-ALT ("[ISMAP]" or "[LINK]") # strings will have '-' and a link labeled "[IMAGE]" for the resolved SRC # appended. # # The default defined here will override that in userdefs.h, and the user # can use LYK_IMAGE_TOGGLE to toggle the feature on or off at run time. # # The default also can be toggled via an "-image_links" command line switch. # #MAKE_LINKS_FOR_ALL_IMAGES:FALSE # If MAKE_PSEUDO_ALTS_FOR_INLINES is FALSE, inline images which do not # specify an ALT string will not have "[INLINE]" inserted as a pseudo-ALT, # i.e., they'll be treated as having ALT="". If MAKE_LINKS_FOR_ALL_IMAGES # is defined or toggled to TRUE, however, the pseudo-ALTs will be created # for inlines, so that they can be used as links to the SRCs. # # The default defined here will override that in userdefs.h, and the user # can use LYK_INLINE_TOGGLE to toggle the feature on or off at run time. # # The default also can be toggled via a "-pseudo_inlines" command line # switch. # #MAKE_PSEUDO_ALTS_FOR_INLINES:TRUE # If SUBSTITUTE_UNDERSCORES is TRUE, the _underline_ format will be used # for emphasis tags in dumps. # # The default defined here will override that in userdefs.h, and the user # can toggle the default via a "-underscore" command line switch. # #SUBSTITUTE_UNDERSCORES:FALSE # 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 # between the '--' and '>' in valid terminators). The compilation default # is FALSE. # # The compilation default, or default defined here, can be toggled via a # "-historical" command line switch, and via the LYK_HISTORICAL command key. # #HISTORICAL_COMMENTS:FALSE # 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 # element. This emulates the Netscape v2.0 comment parsing bug, and # will help Lynx cope with the use of dashes as "decorations", which # consequently has become common in so-called "Enhanced for Netscape" # pages. Note that setting Historical comments on will override the # Minimal or Valid setting. # # The compilation default for MINIMAL_COMMENTS is FALSE, but we'll # set it TRUE here, until Netscape gets its comment parsing right, # and "decorative" dashes cease to be so common. # # The compilation default, or default defined here, can be toggled via a # "-minimal" command line switch, and via the LYK_MINIMAL command key. # MINIMAL_COMMENTS:TRUE # 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 # and Mosaic. The compilation default is FALSE. # # The compilation default, or default defined here, can be toggled via # a "-soft_dquotes" command line switch. # #SOFT_DQUOTES:FALSE # 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 # an absolute URLs with those characters still in it. Such URLs are normally # erroneous and not what is intended by page authors. Lynx will issue # a warning message when this occurs. # # If STRIP_DOTDOT_URLS is FALSE, Lynx will use those URLs for requests # without taking any special actions or issuing Warnings, in most cases # this will result in an error response from the server. # # Note that Lynx never tries to fix similar URLs for protocols other than # http and https, since they are less common and may actually be valid in # some cases. # #STRIP_DOTDOT_URLS:TRUE # 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 # text to recognize the continuity of what has been displayed, so that # previous screenfuls can be reviewed by whatever method the program uses # to scroll back through previous text. For example, the PC comm program # QModem has a key that can be pressed to scroll back; if ENABLE_SCROLLBACK # is TRUE, pressing the scrollback key will access previous screenfuls which # will have been stored on the local PC and will therefore be displayed # instantaneously, instead of needing to be retransmitted by Lynx at the # speed of the comm connection (but Lynx will not know about the change, # so you must restore the last screen before resuming with Lynx commands). # # The compilation default is FALSE (if REVERSE_CLEAR_SCREEN_PROBLEM was not # defined in the Unix Makefile to invoke this behavior as a workaround for # some poor curses implementations). # # The default compilation or configuration setting can be toggled via an # "-enable_scrollback" command line switch. # #ENABLE_SCROLLBACK:FALSE # 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 # enclosed in angle brackets ("") might be converted to false # news links, and uuencoded messages might be corrupted. The conversion is # not done when the display is toggled to source or when 'd'ownloading, so # uuencoded articles can be saved intact regardless of these settings. # # The default setting can be toggled via a "-buried_news" command line # switch. # #SCAN_FOR_BURIED_NEWS_REFS:TRUE # MIME types and viewers! # # file extensions may be assigned to MIME types using # the SUFFIX: definition. # # The SUFFIX definition takes the form of: # SUFFIX:: # for instance the following definition maps the # extension ".gif" to the mime type "image/gif" # SUFFIX:.gif:image/gif # # file suffixes are case INsensitive! # # The suffix definitions listed here in the default lynx.cfg file are # among those established via src/HTInit.c. You can change any of the # defaults by editing that file, or via the global or personal mime.types # files at run time. They will be overridden if you assign them here. # #SUFFIX:.ps:application/postscript #SUFFIX:.eps:application/postscript #SUFFIX:.ai:application/postscript #SUFFIX:.rtf:application/x-rtf #SUFFIX:.snd:audio/basic #SUFFIX:.gif:image/gif #SUFFIX:.rgb:image/x-rgb #SUFFIX:.pict:image/x-pict #SUFFIX:.xbm:image/x-xbitmap #SUFFIX:.tiff:image/x-tiff #SUFFIX:.jpg:image/jpeg #SUFFIX:.jpeg:image/jpeg #SUFFIX:.mpg:video/mpeg #SUFFIX:.mpeg:video/mpeg #SUFFIX:.mov:video/quicktime #SUFFIX:.hqx:application/octet-stream #SUFFIX:.bin:application/octet-stream #SUFFIX:.exe:application/octet-stream #SUFFIX:.tar:application/octet-stream #SUFFIX:.Z:application/octet-stream #SUFFIX:.gz:application/octet-stream #SUFFIX:.zip:application/octet-stream #SUFFIX:.lzh:application/octet-stream #SUFFIX:.lha:application/octet-stream #SUFFIX:.dms:application/octet-stream # 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: #GLOBAL_EXTENSION_MAP:/usr/local/lib/mosaic/mime.types # VMS: #GLOBAL_EXTENSION_MAP:Lynx_Dir:mime.types # # Unix (sought in user's home directory): #PERSONAL_EXTENSION_MAP:.mime.types # VMS (sought in user's sys$login directory): #PERSONAL_EXTENSION_MAP:mime.types # VMS: # ==== # XLOADIMAGE_COMMAND will be used as a default in src/HTInit.c # for viewing image content types when the DECW$DISPLAY logical # is set. Make it the foreign command for your system's X image # viewer (commonly, "xv"). Make it "exit" or something like that # if you don't have one. It can be anything that will handle GIF, # TIFF and other popular image formats. Freeware ports of xv for # VMS are available in the ftp://ftp.wku.edu/vms/unsupported and # http://www.openvms.digital.com/cd/XV310A/ subdirectories. You # 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). # #XLOADIMAGE_COMMAND:xv %s # Unix: # ===== # XLOADIMAGE_COMMAND will be used as a default in src/HTInit.c for # viewing image content types when the DISPLAY environment variable # is set. Make it the full path and name of the xli (also know as # xloadimage or xview) command, or other image viewer. Put 'echo' or # something like it here if you don't have a suitable viewer. It can # be anything that will handle GIF, TIFF and other popular image formats # (xli does). The freeware distribution of xli is available in the # ftp://ftp.x.org/contrib subdirectory. The shareware, xv, also is # suitable. You must also have a "%s" for the filename; "&" for # background is optional. The default is defined in userdefs.h and can be # overridden here, or via the global or personal mailcap files (see below). # Note that open is used as the default for NeXT, instead of the # XLOADIMAGE_COMMAND definition. # #XLOADIMAGE_COMMAND:xli %s & # MIME types may be assigned to external viewers using # the VIEWER definition. # # Note: if you do not define a viewer to a new MIME type # that you assigned above then it will be saved to # disk by default. # # The VIEWER definition takes the form of: # VIEWER::[:environment] # where -mime type is the MIME content type of the file # -viewer command is a system command that can be # used to display the file where %s is replaced # within the command with the physical filename # (e.g. "ghostview %s" becomes "ghostview /tmp/temppsfile") # -environment is optional. The only valid keywords # are currently XWINDOWS and NON_XWINDOWS. If the XWINDOWS # environment is specified then the viewer will only be # defined when the user has the environment variable DISPLAY # (DECW$DISPLAY on VMS) defined. If the NON_XWINDOWS environment # is specified the specified viewer will only be defined when the # user DOES NOT have the environment variable DISPLAY defined. # examples: # VIEWER:image/gif:xli %s:XWINDOWS # VIEWER:image/gif:ascii-view %s:NON_XWINDOWS # VIEWER:application/start-elm:elm # # You must put the whole definition on one line. # # If you must use a colon in the viewer command, precede it with a backslash! # # The MIME_type:viewer:XWINDOWS definitions listed here in the lynx.cfg # file are among those established via src/HTInit.c. For the image types, # HTInit.c uses the XLOADIMAGE_COMMAND definition in userdefs.h or above # (open is used for NeXT). You can change any of these defaults via the # global or personal mailcap files at run time. They will be overridden # if you assign them here. # #VIEWER:application/postscript:ghostview %s&:XWINDOWS #VIEWER:image/gif:xli %s&:XWINDOWS #VIEWER:image/x-xbm:xli %s&:XWINDOWS #VIEWER:image/x-rgb:xli %s&:XWINDOWS #VIEWER:image/x-tiff:xli %s&:XWINDOWS #VIEWER:image/jpeg:xli %s&:XWINDOWS #VIEWER:video/mpeg:mpeg_play %s &:XWINDOWS # 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 RFC-MAILCAP.txt in the docs subdirectory # and the example mailcap file in the samples subdirectory. # # Unix: #GLOBAL_MAILCAP:/usr/local/lib/mosaic/mailcap # VMS: #GLOBAL_MAILCAP:Lynx_Dir:mailcap # # Sought in user's home (Unix) or sys$login (VMS) directory. #PERSONAL_MAILCAP:.mailcap # Key remapping definitions! # # You may redefine the keymapping of any function in Lynx by # using the KEYMAP variable. The form of KEYMAP is: # KEYMAP:: # # You must map upper and lowercase keys separately. # # A representative list of functions mapped to their default keys is # provided below. All of the mappings are commented out by default # since they just map to the default mappings, except for TOGGLE_HELP # (see below). See LYKeymap.c for the complete key mapping. Use the # 'K'eymap command when running Lynx for a list of the current mappings. # # Special keys map to: # Up Arrow: 0x100 # Down Arrow: 0x101 # Right Arrow: 0x102 # Left Arrow: 0x103 # Page Down: 0x104 # Page Up: 0x105 # Keypad Home: 0x106 # Keypad End: 0x107 # Function key 1: 0x108 # vt100 Help Key: 0x108 # vt100 Do Key: 0x109 # vt100 Find Key: 0x10A # vt100 Select Key: 0x10B # vt100 Insert Key: 0x10C # vt100 Remove Key: 0x10D # (0x00) NULL KEY: 0x00E (DO_NOTHING) # #KEYMAP:0x2F: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 #KEYMAP:0x101:NEXT_LINK # Move to the next link #KEYMAP:<:UP_LINK # Move to the link above #KEYMAP:>:DOWN_LINK # Move to the link below #KEYMAP:0x00:RIGHT_LINK # Move to the link to the right #KEYMAP:0x00:LEFT_LINK # Move to the link to the left #KEYMAP:0x7F:HISTORY # Display stack of currently-suspended documents #KEYMAP:0x08:HISTORY # Display stack of currently-suspended documents #KEYMAP:0x103:PREV_DOC # Return to the previous document #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:HELP # Function key Help - Show default help screen #KEYMAP:i:INDEX # Show default index #*** Edit FORM_LINK_SUBMIT_MESSAGE in userdefs.h if you change NOCACHE *** #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 occurence of string within document #KEYMAP:c:COMMENT # Comment to the author of the current document #KEYMAP:e:EDIT # Edit current document #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 tracing of browser operations #KEYMAP:*:IMAGE_TOGGLE # Toggle inclusion of links for all images #KEYMAP:[:INLINE_TOGGLE # Toggle pseudo-ALTs for inlines with no ALT string #KEYMAP:0x00:DO_NOTHING # Does nothing (ignore this key) # 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 # userdefs.h. Otherwise, it will be NOVICE_LINE_TWO. # #KEYMAP:O:TOGGLE_HELP # Show other commands in the novice help menu # 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 # file. You optionally may include a statusline prompt string for the # mapping. You must map upper and lowercase keys separately (beware of # mappings to keys which the user can further remap via the 'o'ptions # menu). The format is: # # JUMPFILE:path:key[:prompt] # # 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. # #JUMPFILE:/Lynx_Dir/ips.html:i:IP or Interest group (? for list): # VMS ONLY: #========== # On VMS, CSwing (an XTree emulation for VTxxx terminals) is intended for # use as the Directory/File Manager (sources, objects, or executables are # available from ftp://narnia.memst.edu/). CSWING_PATH should be defined # here or in userdefs.h to your foreign command for CSwing, with any # regulatory switches you want included. If not defined, or defined as # a zero-length string ("") or "none" (case-insensitive), the support # will be disabled. It will also be disabled if the -nobrowse or # -selective switches are used, or if the file_url restriction is set. # # When enabled, the DIRED_MENU command (normally 'f' or 'F') will invoke # CSwing, normally with the current default directory as an argument to # position the user on that node of the directory tree. However, if the # current document is a local directory listing, or a local file and not # one of the temporary menu or list files, the associated directory will # be passed as an argument, to position the user on that node of the tree. # #CSWING_PATH:swing # Unix ONLY: #=========== # LIST_FORMAT defines the display for local files when Lynx has been # compiled with LONG_LIST defined in the Makefile. The default is set # in userdefs.h, normally to "ls -l" format, and can be changed here # by uncommenting the indicated lines, or adding a definition with a # modified parameter list. # # The percent items in the list are interpreted as follows: # # %p Unix-style permission bits # %l link count # %o owner of file # %g group of file # %d date of last modification # %a anchor pointing to file or directory # %A as above but don't show symbolic links # %k size of file in Kilobytes # %K as above but omit size for directories # %s size of file in bytes # # 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: # #LIST_FORMAT: %a # # If you want a brief output: # #LIST_FORMAT: %4K %-12.12d %a # # If you want the Unix "ls -l" format: # #LIST_FORMAT: %p %4l %-8.8o %-8.8g %7s %-12.12d %a # Unix ONLY: #=========== # DIRED_MENU items are used to compose the F)ull menu list in DIRED mode # The behaviour of the default configuration given here is much the same # as it was when this menu was hard-coded but these items can now be adjusted # to suit local needs. In particular, many of the LYNXDIRED actions can be # replaced with lynxexec, lynxprog and lynxcgi script references. # # NOTE that defining even one DIRED_MENU line overrides all the built-in # definitions, so a complete set must then be defined here. # # Each line consists of the following fields: # # DIRED_MENU:type:suffix:link text:extra text:action # # type: TAG: list only when one or more files are tagged # FILE: list only when the current selection is a regular file # DIR: list only when the current selection is a directory # LINK: list only when the current selection is a symbolic link # # suffix: list only if the current selection ends in this pattern # # link text: the displayed text of the link # # extra text: the text displayed following the link # # action: the URL to be followed upon selection # # 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 # #DIRED_MENU:::New File:(in current directory):LYNXDIRED://NEW_FILE%d #DIRED_MENU:::New Directory:(in current directory):LYNXDIRED://NEW_FOLDER%d #DIRED_MENU:FILE::Install:(of current selection):LYNXDIRED://INSTALL_SRC%p #DIRED_MENU:DIR::Install:(of current selection):LYNXDIRED://INSTALL_SRC%p #DIRED_MENU:FILE::Modify File Name:(of current selection):LYNXDIRED://MODIFY_NAME%p #DIRED_MENU:DIR::Modify Directory Name:(of current selection):LYNXDIRED://MODIFY_NAME%p #DIRED_MENU:LINK::Modify Name:(of selected symbolic link):LYNXDIRED://MODIFY_NAME%p # Following depends on OK_PERMIT #DIRED_MENU:FILE::Modify File Permissions:(of current selection):LYNXDIRED://PERMIT_SRC%p #DIRED_MENU:DIR::Modify Directory Permissions:(of current selection):LYNXDIRED://PERMIT_SRC%p #DIRED_MENU:FILE::Change Location:(of selected file):LYNXDIRED://MODIFY_LOCATION%p #DIRED_MENU:DIR::Change Location:(of selected directory):LYNXDIRED://MODIFY_LOCATION%p #DIRED_MENU:LINK::Change Location:(of selected symbolic link):LYNXDIRED://MODIFY_LOCATION%p #DIRED_MENU:FILE::Remove File:(current selection):LYNXDIRED://REMOVE_SINGLE%p #DIRED_MENU:DIR::Remove Directory:(current selection):LYNXDIRED://REMOVE_SINGLE%p #DIRED_MENU:LINK::Remove Symbolic Link:(current selection):LYNXDIRED://REMOVE_SINGLE%p # Following depends on OK_UUDECODE and !ARCHIVE_ONLY #DIRED_MENU:FILE::UUDecode:(current selection):LYNXDIRED://UUDECODE%p # Following depends on OK_TAR and !ARCHIVE_ONLY #DIRED_MENU:FILE:.tar.Z:Expand:(current selection):LYNXDIRED://UNTAR_Z%p # Following depend on OK_TAR and OK_GZIP and !ARCHIVE_ONLY #DIRED_MENU:FILE:.tar.gz:Expand:(current selection):LYNXDIRED://UNTAR_GZ%p #DIRED_MENU:FILE:.tgz:Expand:(current selection):LYNXDIRED://UNTAR_GZ%p # Following depends on !ARCHIVE_ONLY #DIRED_MENU:FILE:.Z:Uncompress:(current selection):LYNXDIRED://DECOMPRESS%p # Following depends on OK_GZIP and !ARCHIVE_ONLY #DIRED_MENU:FILE:.gz:Uncompress:(current selection):LYNXDIRED://UNGZIP%p # Following depends on OK_ZIP and !ARCHIVE_ONLY #DIRED_MENU:FILE:.zip:Uncompress:(current selection):LYNXDIRED://UNZIP%p # Following depends on OK_TAR and !ARCHIVE_ONLY #DIRED_MENU:FILE:.tar:UnTar:(current selection):LYNXDIRED://UNTAR%p # Following depends on OK_TAR #DIRED_MENU:DIR::Tar:(current selection):LYNXDIRED://TAR%p # Following depends on OK_TAR and OK_GZIP #DIRED_MENU:DIR::Tar and compress:(using GNU gzip):LYNXDIRED://TAR_GZ%p # Following depends on OK_ZIP #DIRED_MENU:DIR::Package and compress:(using zip):LYNXDIRED://ZIP%p #DIRED_MENU:FILE::Compress:(using Unix compress):LYNXDIRED://COMPRESS%p # Following depends on OK_GZIP #DIRED_MENU:FILE::Compress:(using gzip):LYNXDIRED://GZIP%p # Following depends on OK_ZIP #DIRED_MENU:FILE::Compress:(using zip):LYNXDIRED://ZIP%p #DIRED_MENU:TAG::Move all tagged items to another location.::LYNXDIRED://MOVE_TAGGED%d #DIRED_MENU:TAG::Remove all tagged files and directories.::LYNXDIRED://REMOVE_TAGGED #DIRED_MENU:TAG::Untag all tagged items.::LYNXDIRED://CLEAR_TAGGED # Unix ONLY: #=========== # If NO_FORCED_CORE_DUMP is set to TRUE, Lynx will not force # core dumps via abort() calls on fatal errors or assert() # calls to check potentially fatal errors. The compilation # default normally is FALSE, and can be changed here. The # compilation or configuration default can be toggled via # the -core command line switch. # Note that this setting cannot be used to prevent core dumps # with certainty. If this is important, means provided by the # operating system or kernel should be used. # #NO_FORCED_CORE_DUMP:FALSE # COLORS (only available if compiled with SVr4 curses or slang) # # The line must be of the form: # COLOR:Integer:Foreground:Background # # 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 # # 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 # # Uncomment and change any of the compilation defaults. # #COLOR:0:black:white #COLOR:1:blue:white #COLOR:2:yellow:blue #COLOR:3:green:white #COLOR:4:magenta:white #COLOR:5:blue:white #COLOR:6:red:white #COLOR:7:magenta:cyan # External application support. This feature allows lynx to pass a given # URL to an external program. It was written for three reasons. # # 1) To overcome the deficiency of Lynx_386 not supporting ftp and news. # External programs can be used instead by passing the URL. # # 2) To allow for background transfers in multitasking systems. # I use wget for http and ftp transfers via the external command. # # 3) To allow for new URLs to be used through lynx. # URLs can be made up such as mymail: to spawn desired applications # via the external command. # # Restrictions can be imposed using -restrictions=externals at the lynx # command line. This will disallow all EXTERNAL lines in lynx.cfg that # end in FALSE. TRUE lines will still function. # # The lynx.cfg line is as follows: # # EXTERNAL:: %s: # # Any given URL. This can be normal ones like ftp or http or it # can be one made up like mymail. # # The command to run with %s being the URL that will be passed. # In Linux I use "wget -q %s &" (no quotes) to spawn a copy of wget for # downloading http and ftp files in the background. In Win95 I use # "start ncftp %s" to spawn ncftp in a new window. # # This complements the -restrictions=externals feature to allow # for certain externals to be enabled while restricting others. TRUE means # a command will still function while lynx is restricted. WB # # EXTERNAL:ftp:wget %s &:TRUE