summaryrefslogtreecommitdiff
path: root/gnu/usr.bin/lynx/lynx.hlp
diff options
context:
space:
mode:
authorAnil Madhavapeddy <avsm@cvs.openbsd.org>2003-05-01 18:59:41 +0000
committerAnil Madhavapeddy <avsm@cvs.openbsd.org>2003-05-01 18:59:41 +0000
commit83a9886c0ab87ef4a00fe5eaa007ca5619e8a528 (patch)
tree245e9a9e918b534bf00cbf3b6919a26e5594f053 /gnu/usr.bin/lynx/lynx.hlp
parent44b1bba2a33b56bcaa32d20a6c76f14845797fb0 (diff)
Update to lynx-2.8.4-rel1, patchset d, now with IPv6 as well
Local patches we maintain to the distribution are: - replace unbounded fscanf with fgets (avsm) - spelling fixes (deraadt) - hppa -O0 workaround (mickey) - default to ftp passive (deraadt) - work with non-exec scripts (deraadt,hin,maja) - be more careful with rlogin username (art) - default to our webpage (deraadt) - install helpfiles locally (maja) - mkdtemp temp space directory (art) - install more recent config.guess (avsm) Tested by beck,millert,grange,fries,miod and others, deraadt@ ok
Diffstat (limited to 'gnu/usr.bin/lynx/lynx.hlp')
-rw-r--r--gnu/usr.bin/lynx/lynx.hlp1246
1 files changed, 735 insertions, 511 deletions
diff --git a/gnu/usr.bin/lynx/lynx.hlp b/gnu/usr.bin/lynx/lynx.hlp
index bc2ca656a0d..843cb202725 100644
--- a/gnu/usr.bin/lynx/lynx.hlp
+++ b/gnu/usr.bin/lynx/lynx.hlp
@@ -1,489 +1,698 @@
1 LYNX
- NAME
- lynx - a general purpose distributed information browser for the World
- Wide Web
-
-2 SYNOPSIS
- Lynx [options] [path or URL]
-
- use "lynx -help" to display a complete list of current options.
-
-2 DESCRIPTION
- Lynx is a fully-featured World Wide Web (WWW) client for users running
- cursor-addressable, character-cell display devices (e.g., vt100 terminals,
- vt100 emulators running on PCs or Macs, or any other "curses-oriented"
- display). It will display hypertext markup language (HTML) documents con-
- taining links to files residing on the local system, as well as files
- residing on remote systems running Gopher, HTTP, FTP, WAIS, and NNTP
- servers. Current versions of Lynx run on Unix, VMS, Windows95/NT,
- 386DOS and OS/2 EMX.
-
- Lynx can be used to access information on the World Wide Web, or to build
- information systems intended primarily for local access. For example, Lynx
- has been used to build several Campus Wide Information Systems (CWIS). In
- addition, Lynx can be used to build systems isolated within a single LAN.
-
-2 OPTIONS
- At start up, Lynx will load any local file or remote URL specified at
- the command line. For help with URLs, press "?" or "h" while running
- Lynx. Then follow the link titled, "Help on URLs."
-
- -
- If the argument is only '-', then Lynx expects to receive
- arguments from stdin. This is to allow for the potentially
- very long command line that can be associated with the
- -get_data or -post_data arguments (see below). Encase it
- in double-quotes ("-").
-
- -accept_all_cookies
- accept all cookies.
+2 Name
+ lynx - a general purpose distributed information browser
+ for the World Wide Web
+
+2 Synopsis
+ lynx [options] [path or URL]
+
+ use "lynx -help" to display a complete list of current
+ options.
+
+2 Description
+ Lynx is a fully-featured World Wide Web (WWW) client for
+ users running cursor-addressable, character-cell display
+ devices (e.g., vt100 terminals, vt100 emulators running on
+ Windows 95/NT or Macintoshes, or any other "curses-
+ oriented" display). It will display hypertext markup
+ language (HTML) documents containing links to files
+ residing on the local system, as well as files residing on
+ remote systems running Gopher, HTTP, FTP, WAIS, and NNTP
+ servers. Current versions of Lynx run on Unix, VMS,
+ Windows 95/NT, 386DOS and OS/2 EMX.
+
+ Lynx can be used to access information on the World Wide
+ Web, or to build information systems intended primarily
+ for local access. For example, Lynx has been used to
+ build several Campus Wide Information Systems (CWIS). In
+ addition, Lynx can be used to build systems isolated
+ within a single LAN.
+
+2 Options
+ At start up, Lynx will load any local file or remote URL
+ specified at the command line. For help with URLs, press
+ "?" or "H" while running Lynx. Then follow the link
+ titled, "Help on URLs."
+
+ Lynx uses only long option names. Option names can begin
+ with double dash as well, underscores and dashes can be
+ intermixed in option names (in the reference below options
+ are with one dash before them and with underscores).
+
+ - If the argument is only '-', then Lynx expects to
+ receive the arguments from stdin. This is to allow
+ for the potentially very long command line that can
+ be associated with the -get_data or -post_data
+ arguments (see below). It can also be used to
+ avoid having sensitive information in the invoking
+ command line (which would be visible to other
+ processes on most systems), especially when the
+ -auth or -pauth options are used.
+
+ -accept_all_cookies
+ accept all cookies.
+
+ -anonymous
+ apply restrictions for anonymous account, see also
+ -restrictions.
+
+ -assume_charset=MIMEname
+ charset for documents that don't specify it.
+
+ -assume_local_charset=MIMEname
+ charset assumed for local files.
+
+ -assume_unrec_charset=MIMEname
+ use this instead of unrecognized charsets.
+
+ -auth=ID:PASSWD
+ set authorization ID and password for protected
+ documents at startup. Be sure to protect any
+ script files which use this switch.
+
+ -base prepend a request URL comment and BASE tag to
+ text/html outputs for -source dumps.
+
+ -bibp=URL
+ specify a local bibp server (default
+ http://bibhost/).
+
+ -blink forces high intensity background colors for color
+ mode, if available and supported by the terminal.
+ This applies to the slang library (for a few
+ terminal emulators), or to OS/2 EMX with ncurses.
+
+ -book use the bookmark page as the startfile. The
+ default or command line startfile is still set for
+ the Main screen command, and will be used if the
+ bookmark page is unavailable or blank.
+
+ -buried_news
+ toggles scanning of news articles for buried
+ references, and converts them to news links. Not
+ recommended because email addresses enclosed in
+ angle brackets will be converted to false news
+ links, and uuencoded messages can be trashed.
+
+ -cache=NUMBER
+ set the NUMBER of documents cached in memory. The
+ default is 10.
+
+ -case enable case-sensitive string searching.
+
+ -center
+ Toggle center alignment in HTML TABLE.
+
+ -cfg=FILENAME
+ specifies a Lynx configuration file other than the
+ default lynx.cfg.
+
+ -child exit on left-arrow in startfile, and disable save
+ to disk.
+
+ -cmd_log=FILENAME
+ write keystroke commands and related information to
+ the specified file.
+
+ -cmd_script=FILENAME
+ read keystroke commands from the specified file.
+ You can use the data written using the -cmd_log
+ option. Lynx will ignore other information which
+ the command-logging may have written to the
+ logfile.
+
+ -color forces color mode on, if available. Default color
+ control sequences which work for many terminal
+ types are assumed if the terminal capability
+ description does not specify how to handle color.
+ Lynx needs to be compiled with the slang library
+ for this flag, it is equivalent to setting the
+ COLORTERM environment variable. (If color support
+ is instead provided by a color-capable curses
+ library like ncurses, Lynx relies completely on the
+ terminal description to determine whether color
+ mode is possible, and this flag is not needed and
+ thus unavailable.) A saved show_color=always
+ setting found in a .lynxrc file at startup has the
+ same effect. A saved show_color=never found in
+ .lynxrc on startup is overridden by this flag.
+
+ -connect_timeout=N
+ Sets the connection timeout, where N is given in
+ seconds. This is not available under DOS (use the
+ sockdelay parameter of WATTCP under DOS).
- -anonymous
- used to specify the anonymous account.
+ -cookie_file=FILENAME
+ specifies a file to use to read cookies. If none
+ is specified, the default value is ~/.lynx_cookies
+ for most systems, but ~/cookies for MS-DOS.
- -assume_charset=MIMEname
- charset for documents that don't specify it.
+ -cookie_save_file=FILENAME
+ specifies a file to use to store cookies. If none
+ is specified, the value given by -cookie_file is
+ used.
- -assume_local_charset=MIMEname
- charset assumed for local files.
+ -cookies
+ toggles handling of Set-Cookie headers.
- -assume_unrec_charset=MIMEname
- use this instead of unrecognized charsets.
+ -core toggles forced core dumps on fatal errors.
- -auth=ID:PASSWD
- set authorization ID and password for protected documents
- at startup. Be sure to protect any script files which use
- this switch.
+ -crawl with -traversal, output each page to a file. with
+ -dump, format output as with -traversal, but to
+ stdout.
- -base
- prepend a request URL comment and BASE tag to text/html
- outputs for -source dumps.
+ -curses_pads
+ toggles the use of curses "pad" feature which
+ supports left/right scrolling of the display.
- -blink
- forces high intensity bg colors for color mode, if available
- and supported by the terminal.
- Lynx needs to be compiled with the slang library for this flag.
+ -debug_partial
+ separate incremental display stages with
+ MessageSecs delay
- -book
- use the bookmark page as the startfile. The default or command
- line startfile is still set for the Main screen command, and will
- be used if the bookmark page is unavailable or blank.
+ -display=DISPLAY
+ set the display variable for X rexec-ed programs.
- -buried_news
- toggles scanning of news articles for buried references, and
- converts them to news links. Not recommended because email
- addresses enclosed in angle brackets will be converted to
- false news links, and uuencoded messages can be trashed.
+ -display_charset=MIMEname
+ set the charset for the terminal output.
- -cache=NUMBER
- set the NUMBER of documents cached in memory. The default is 10.
+ -dont_wrap_pre
+ inhibit wrapping of text in <pre> when -dump'ing
+ and -crawl'ing, mark wrapped lines in interactive
+ session.
- -case
- enable case-sensitive string searching.
+ -dump dumps the formatted output of the default document
+ or one specified on the command line to standard
+ output. This can be used in the following way:
- -cfg=FILENAME
- specifies a Lynx configuration file other than the default lynx.cfg.
+ lynx -dump http://www.trill-home.com/lynx.html
- -child
- exit on left-arrow in startfile, and disable save to disk.
+ -editor=EDITOR
+ enable external editing, using the specified
+ EDITOR. (vi, ed, emacs, etc.)
- -color
- forces color mode on, if available. Default color control sequences
- which work for many terminal types are assumed if the terminal
- capability description does not specify how to handle color.
- Lynx needs to be compiled with the slang library for this flag.
- A saved show_color=always setting found in a .lynxrc file at
- startup has the same effect. A saved show_color=always found
- in .lynxrc on startup is overridden by this flag.
+ -emacskeys
+ enable emacs-like key movement.
- -cookies
- toggles handling of Set-Cookie headers.
+ -enable_scrollback
+ toggles compatibility with communication programs'
+ scrollback keys (may be incompatible with some
+ curses packages).
- -cookie_file=FILENAME
- specifies a file to use to store cookies.
+ -error_file=FILE
+ define a file where Lynx will report HTTP access
+ codes.
- -crawl
- with -traversal, output each page to a file.
- with -dump, format output as with -traversal, but to stdout.
+ -exec enable local program execution (normally not
+ configured).
- -debug_partial
- incremental display stages with MessageSecs delay
+ -fileversions
+ include all versions of files in local VMS
+ directory listings.
- -display=DISPLAY
- set the display variable for X rexec-ed programs.
+ -force_empty_hrefless_a
+ force HREF-less 'A' elements to be empty (close
+ them as soon as they are seen).
- -dump
- dumps the formatted output of the default document or one specified
- on the command line to standard out. This can be used in the
- following way:
- lynx -dump http://www.crl.com/~subir/lynx.html
+ -force_html
+ forces the first document to be interpreted as
- -editor=EDITOR
- enable edit mode using the specified EDITOR. (vi, ed, emacs, etc.)
+ HTML.
- -emacskeys
- enable emacs-like key movement.
+ -force_secure
+ toggles forcing of the secure flag for SSL cookies.
- -enable_scrollback
- toggles compatibility with comm programs' scrollback keys
- (may be incompatible with some curses packages).
+ -forms_options
+ toggles whether the Options Menu is key-based or
+ form-based.
- -error_file=FILE
- define a file where Lynx will report HTTP access codes.
+ -from toggles transmissions of From headers.
- -exec
- enable local program execution (normally not configured).
+ -ftp disable ftp access.
- -fileversions
- include all versions of files in local VMS directory listings.
+ -get_data
+ properly formatted data for a get form are read in
+ from stdin and passed to the form. Input is
+ terminated by a line that starts with '---'.
- -force_html
- forces the first document to be interpreted as HTML.
+ -head send a HEAD request for the mime headers.
- -force_secure
- toggles forcing of the secure flag for SSL cookies.
+ -help print the Lynx command syntax usage message.
- -forms_options
- toggles the style of options (menu or forms).
+ -hiddenlinks=[option]
+ control the display of hidden links.
- -from
- toggles transmissions of From headers.
+ merge hidden links show up as bracketed numbers and
+ are numbered together with other links in the
+ sequence of their occurrence in the document.
- -ftp
- disable ftp access.
+ listonly hidden links are shown only on L)ist
+ screens and listings generated by -dump or from the
+ P)rint menu, but appear separately at the end of
+ those lists. This is the default behavior.
- -get_data
- send form data from stdin using GET method and dump results.
+ ignore hidden links do not appear even in listings.
- -head
- send a HEAD request for the mime headers.
+ -historical
+ toggles use of '>' or '-->' as a terminator for
+ comments.
- -help
- print the Lynx command syntax usage message.
+ -homepage=URL
+ set homepage separate from start page.
- -hiddenlinks=[option]
- control the display of hidden links.
+ -image_links
+ toggles inclusion of links for all images.
- + merge
- hidden links show up as bracketed numbers and are numbered together
- with other links in the sequence of their occurrence in the document.
+ -index=URL
+ set the default index file to the specified URL.
- + listonly
- hidden links are shown only on L)ist screens and listings generated by
- -dump or from the P)rint menu, but appear separately at the end of
- those lists. This is the default behavior.
+ -ismap toggles inclusion of ISMAP links when client-side
+ MAPs are present.
- + ignore
- hidden links do not appear even in listings.
+ -justify
+ do justification of text.
- -historical
- toggles use of '>' or '-->' as a terminator for comments.
+ -link=NUMBER
+ starting count for lnk#.dat files produced by
+ -crawl.
- -homepage=URL
- set homepage separate from start page.
+ -localhost
+ disable URLs that point to remote hosts.
- -image_links
- toggles inclusion of links for all images.
+ -locexec
+ enable local program execution from local files
+ only (if Lynx was compiled with local execution
+ enabled).
- -index=URL
- set the default index file to the specified URL.
+ -lss=FILENAME
+ specify filename containing color-style
+ information. The default is lynx.lss.
- -ismap
- toggles inclusion of ISMAP links when client-side
- MAPs are present.
+ -mime_header
+ prints the MIME header of a fetched document along
+ with its source.
- -link=NUMBER
- starting count for lnk#.dat files produced by -crawl.
+ -minimal
+ toggles minimal versus valid comment parsing.
- -localhost
- disable URLs that point to remote hosts.
+ -newschunksize=NUMBER
+ number of articles in chunked news listings.
- -locexec
- enable local program execution from local files only (if
- Lynx was compiled with local execution enabled).
+ -newsmaxchunk=NUMBER
+ maximum news articles in listings before chunking.
- -mime_header
- prints the MIME header of a fetched document along with its
- source.
+ -nobold
+ disable bold video-attribute.
- -minimal
- toggles minimal versus valid comment parsing.
+ -nobrowse
+ disable directory browsing.
- -newschunksize=NUMBER
- number of articles in chunked news listings.
+ -nocc disable Cc: prompts for self copies of mailings.
+ Note that this does not disable any CCs which are
+ incorporated within a mailto URL or form ACTION.
- -newsmaxchunk=NUMBER
- maximum news articles in listings before chunking.
+ -nocolor
+ force color mode off, overriding terminal
+ capabilities and any -color flags, COLORTERM
+ variable, and saved .lynxrc settings.
- -nobrowse
- disable directory browsing.
+ -noexec
+ disable local program execution. (DEFAULT)
- -nocc
- disable Cc: prompts for self copies of mailings. Note
- that this does not disable any CCs which are incorporated
- within a mailto URL or form ACTION.
+ -nofilereferer
+ disable transmissions of Referer headers for file
+ URLs.
- -nocolor
- force color mode off, overriding terminal capabilities and any
- -color flags, COLORTERM variable, and saved .lynxrc settings.
+ -nolist
+ disable the link list feature in dumps.
- -noexec
- disable local program execution. (DEFAULT)
+ -nolog disable mailing of error messages to document
+ owners.
- -nofilereferer
- disable transmissions of Referer headers for file URLs.
+ -nonrestarting_sigwinch
+ This flag is not available on all systems, Lynx
+ needs to be compiled with HAVE_SIGACTION defined.
+ If available, this flag may cause Lynx to react
+ more immediately to window changes when run within
+ an xterm.
- -nolist
- disable the link list feature in dumps.
+ -nopause
+ disable forced pauses for statusline messages.
- -nolog
- disable mailing of error messages to document owners.
+ -noprint
+ disable most print functions.
- -nopause
- disable forced pauses for statusline messages.
+ -noredir
+ prevents automatic redirection and prints a message
+ with a link to the new URL.
- -noprint
- disable print functions.
+ -noreferer
+ disable transmissions of Referer headers.
- -noredir
- prevents automatic redirection and prints a message with a
- link to the new URL.
+ -noreverse
+ disable reverse video-attribute.
- -noreferer
- disable transmissions of Referer headers.
+ -nosocks
+ disable SOCKS proxy usage by a SOCKSified Lynx.
- -nosocks
- disable SOCKS proxy usage by a SOCKSified Lynx.
+ -nostatus
+ disable the retrieval status messages.
- -nostatus
- disable the retrieval status messages.
+ -nounderline
+ disable underline video-attribute.
- -number_links
- force numbering of links.
+ -number_fields
+ force numbering of links as well as form input
+ fields
- -partial
- display partial pages while downloading.
+ -number_links
+ force numbering of links.
- -partial_thres=NUMBER
- number of lines to render before repainting display
- with partial-display logic
+ -partial
+ toggles display partial pages while loading.
- -pauth=ID:PASSWD
- set authorization ID and password for a protected proxy
- server at startup. Be sure to protect any script files
- which use this switch.
+ -partial_thres=NUMBER
+ number of lines to render before repainting display
+ with partial-display logic
- -popup
- toggles handling of single-choice SELECT options via
- popup windows or as lists of radio buttons.
+ -pauth=ID:PASSWD
+ set authorization ID and password for a protected
+ proxy server at startup. Be sure to protect any
+ script files which use this switch.
- -post_data
- send form data from stdin using POST method and dump results.
+ -popup toggles handling of single-choice SELECT options
+ via popup windows or as lists of radio buttons.
- -preparsed
- show HTML source preparsed and reformatted when used with -source
- or in source view.
+ -post_data
+ properly formatted data for a post form are read in
+ from stdin and passed to the form. Input is
+ terminated by a line that starts with '---'.
- -print
- enable print functions. (default)
+ -preparsed
+ show HTML source preparsed and reformatted when
+ used with -source or in source view.
- -pseudo_inlines
- toggles pseudo-ALTs for inlines with no ALT string.
+ -prettysrc
+ show HTML source view with lexical elements and
+ tags in color.
- -raw
- toggles default setting of 8-bit character translations
- or CJK mode for the startup character set.
+ -print enable print functions. (default)
- -realm
- restricts access to URLs in the starting realm.
+ -pseudo_inlines
+ toggles pseudo-ALTs for inlines with no ALT string.
- -reload
- flushes the cache on a proxy server
- (only the first document affected).
+ -raw toggles default setting of 8-bit character
+ translations or CJK mode for the startup character
+ set.
- -restrictions=[option][,,option]...
- allows a list of services to be disabled selectively. The following
- list is printed if no options are specified.
+ -realm restricts access to URLs in the starting realm.
- all - restricts all options.
+ -reload
+ flushes the cache on a proxy server (only the first
+ document affected).
- bookmark - disallow changing the location of the bookmark file.
+ -restrictions=[option][,option][,option]...
+ allows a list of services to be disabled
+ selectively. Dashes and underscores in option names
+ can be intermixed. The following list is printed if
+ no options are specified.
- bookmark_exec - disallow execution links via the bookmark file.
+ all - restricts all options listed below.
- change_exec_perms - disallow changing the eXecute permission on
- files (but still allow it for directories) when local file
- management is enabled.
+ bookmark - disallow changing the location of the
+ bookmark file.
- default - same as command line option -anonymous. Disables default
- services for anonymous users. Currently set to all restricted
- except for: inside_telnet, outside_telnet, inside_news,
- inside_ftp, outside_ftp, inside_rlogin, outside_rlogin, jump,
- mail and goto. Defaults are setable within userdefs.h.
+ bookmark_exec - disallow execution links via the
+ bookmark file.
- dired_support - disallow local file management.
+ change_exec_perms - disallow changing the eXecute
+ permission on files (but still allow it for
+ directories) when local file management is enabled.
- disk_save - disallow saving to disk in the download and print
- menus.
+ default - same as command line option -anonymous.
+ Disables default services for anonymous users. Set
+ to all restricted, except for: inside_telnet,
+ outside_telnet, inside_ftp, outside_ftp,
+ inside_rlogin, outside_rlogin, inside_news,
- download - disallow downloaders in the download menu.
+ outside_news, telnet_port, jump, mail, print, exec,
+ and goto. The settings for these, as well as
+ additional goto restrictions for specific URL
+ schemes that are also applied, are derived from
+ definitions within userdefs.h.
- editor - disallow editing.
+ dired_support - disallow local file management.
- exec - disable execution scripts.
+ disk_save - disallow saving to disk in the download
+ and print menus.
- exec_frozen - disallow the user from changing the local execution
- option.
+ dotfiles - disallow access to, or creation of,
+ hidden (dot) files.
- file_url - disallow using G)oto, served links or bookmarks for
- file: URLs.
+ download - disallow some downloaders in the
+ download menu (does not imply disk_save
+ restriction).
- goto - disable the 'g' (goto) command.
+ editor - disallow external editing.
- inside_ftp - disallow ftps for people coming from inside your domain
- (utmp required for selectivity).
+ exec - disable execution scripts.
- inside_news - disallow USENET news posting for people coming from
- inside our domain (utmp required for selectivity).
+ exec_frozen - disallow the user from changing the
+ local execution option.
- inside_rlogin - disallow rlogins for people coming from inside your
- domain (utmp required for selectivity).
+ externals - disallow some "EXTERNAL" configuration
+ lines if support for passing URLs to external
+ applications (with the EXTERN command) is compiled
+ in.
- inside_telnet - disallow telnets for people coming from inside your
- domain (utmp required for selectivity).
+ file_url - disallow using G)oto, served links or
+ bookmarks for file: URLs.
- jump - disable the 'j' (jump) command.
+ goto - disable the 'g' (goto) command.
- multibook - disallow multiple bookmark files.
+ inside_ftp - disallow ftps for people coming from
+ inside your domain (utmp required for selectivity).
- mail - disallow mail.
+ inside_news - disallow USENET news posting for
+ people coming from inside your domain (utmp
+ required for selectivity).
- news_post - disallow USENET News posting.
+ inside_rlogin - disallow rlogins for people coming
+ from inside your domain (utmp required for
+ selectivity).
- options_save - disallow saving options in .lynxrc.
+ inside_telnet - disallow telnets for people coming
+ from inside your domain (utmp required for
+ selectivity).
- outside_ftp - disallow ftps for people coming from outside your
- domain (utmp required for selectivity).
+ jump - disable the 'j' (jump) command.
- outside_news - disallow USENET news posting for people coming from
- outside your domain (utmp required for selectivity).
+ multibook - disallow multiple bookmarks.
+ mail - disallow mail.
- outside_rlogin - disallow rlogins for people coming from outside your
- domain (utmp required for selectivity).
+ news_post - disallow USENET News posting.
- outside_telnet - disallow telnets for people coming from outside your
- domain (utmp required for selectivity).
+ options_save - disallow saving options in .lynxrc.
- print - disallow most print options.
+ outside_ftp - disallow ftps for people coming from
+ outside your domain (utmp required for
+ selectivity).
- shell - disallow shell escapes and lynxexec or lynxprog G)oto's.
+ outside_news - disallow USENET news reading and
+ posting for people coming from outside your domain
+ (utmp required for selectivity). This restriction
+ applies to "news", "nntp", "newspost", and
+ "newsreply" URLs, but not to "snews", "snewspost",
+ or "snewsreply" in case they are supported.
- suspend - disallow Unix Control-Z suspends with escape to shell.
+ outside_rlogin - disallow rlogins for people coming
+ from outside your domain (utmp required for
+ selectivity).
- telnet_port - disallow specifying a port in telnet G)oto's.
+ outside_telnet - disallow telnets for people coming
+ from outside your domain (utmp required for
+ selectivity).
- useragent - disallow modifications of the User-Agent header.
+ print - disallow most print options.
- -resubmit_posts
- toggles forced resubmissions (no-cache) of forms with
- method POST when the documents they returned are sought
- with the PREV_DOC command or from the History List.
+ shell - disallow shell escapes and lynxexec or
+ lynxprog G)oto's.
- -rlogin
- disable recognition of rlogin commands.
+ suspend - disallow Unix Control-Z suspends with
+ escape to shell.
- -selective
- require .www_browsable files to browse directories.
+ telnet_port - disallow specifying a port in telnet
+ G)oto's.
- -show_cursor
- If enabled the cursor will not be hidden in the right hand corner
- but will instead be positioned at the start of the currently
- selected link. Show cursor is the default for systems without
- FANCY_CURSES capabilities. The default configuration can be
- changed in userdefs.h or lynx.cfg. The command line switch
- toggles the default.
+ useragent - disallow modifications of the User-
+ Agent header.
- -soft_dquotes
- toggles emulation of the old Netscape and Mosaic bug which
- treated '>' as a co-terminator for double-quotes and tags.
+ -resubmit_posts
+ toggles forced resubmissions (no-cache) of forms
+ with method POST when the documents they returned
+ are sought with the PREV_DOC command or from the
+ History List.
- -source
- works the same as dump but outputs HTML source instead of formatted
- text.
+ -rlogin
+ disable recognition of rlogin commands.
- -stack_dump
- disable SIGINT cleanup handler
+ -scrollbar
+ toggles showing scrollbar.
- -startfile_ok
- allow non-http startfile and homepage with -validate.
+ -scrollbar_arrow
+ toggles showing arrows at ends of the scrollbar.
- -tagsoup
- initialize parser, using Tag Soup DTD rather than SortaSGML.
+ -selective
+ require .www_browsable files to browse directories.
- -telnet
- disable recognition of telnet commands.
+ -short_url
+ show very long URLs in the status line with "..."
+ to represent the portion which cannot be displayed.
+ The beginning and end of the URL are displayed,
+ rather than suppressing the end.
- -term=TERM
- tell Lynx what terminal type to assume its talking to. (This may be
- useful for remote execution, when, for example, Lynx connects to a
- remote TCP/IP port that starts a script that, in turn, starts another
- Lynx process.)
+ -show_cursor
+ If enabled the cursor will not be hidden in the
+ right hand corner but will instead be positioned at
+ the start of the currently selected link. Show
+ cursor is the default for systems without
+ FANCY_CURSES capabilities. The default
+ configuration can be changed in userdefs.h or
+ lynx.cfg. The command line switch toggles the
+ default.
+
+ -show_rate
+ If enabled the transfer rate is shown in
+ bytes/second. If disabled, no transfer rate is
+ shown. Use lynx.cfg or the options menu to select
+ KB/second and/or ETA.
- -tlog
- toggles use of a Lynx Trace Log for the current session.
-
- -trace
- turns on WWW trace mode.
-
- -traversal
- traverse all http links derived from startfile. When used with
- -crawl, each link that begins with the same string as startfile
- is output to a file, intended for indexing. See CRAWL.announce
- for more information.
-
- -underscore
- toggles use of _underline_ format in dumps.
-
- -use_mouse
- turn on xterm mouse support.
- Clicking the left mouse button on a link traverses it.
- Clicking the right mouse button pops back.
- Click in the first line of a page to scroll up.
- Click in the last line of a page to scroll down.
- Lynx must be compiled with ncurses or slang to support this feature.
-
- -useragent=Name
- set alternate Lynx User-Agent header.
-
- -validate
- accept only http URLs (for validation). Complete security
- restrictions also are implemented.
-
- -verbose
- taggles [LINK], [IMAGE] and [INLINE] comments
- with filenames of these images.
-
- -version
- print version information.
-
- -vikeys
- enable vi-like key movement.
-
- -width=NUMBER
- number of columns for formatting of dumps, default is 80.
-
-2 COMMANDS
- o Use Up arrow and Down arrow to scroll through hypertext links.
- o Right arrow or Return will follow a highlighted hypertext link.
- o Left Arrow will retreat from a link.
- o Type "H" or "?" for online help and descriptions of key-stroke commands.
- o Type "K" for a complete list of the current key-stroke command mappings.
-
-2 ENVIRONMENT
+ -soft_dquotes
+ toggles emulation of the old Netscape and Mosaic
+ bug which treated '>' as a co-terminator for
+ double-quotes and tags.
+
+ -source
+ works the same as dump but outputs HTML source
+ instead of formatted text.
+
+ -stack_dump
+ disable SIGINT cleanup handler
+
+ -startfile_ok
+ allow non-http startfile and homepage with
+ -validate.
+
+ -stdin read the startfile from standard input (UNIX only).
+
+ -syslog=text
+ information for syslog call.
+
+ -tagsoup
+ initialize parser, using Tag Soup DTD rather than
+ SortaSGML.
+
+ -telnet
+ disable recognition of telnet commands.
+
+ -term=TERM
+ tell Lynx what terminal type to assume it is
+ talking to. (This may be useful for remote
+ execution, when, for example, Lynx connects to a
+ remote TCP/IP port that starts a script that, in
+ turn, starts another Lynx process.)
+
+ -timeout=N
+ For win32, sets the network read-timeout, where N
+ is given in seconds.
+
+ -tlog toggles between using a Lynx Trace Log and stderr
+ for trace output from the session.
+
+ -tna turns on "Textfields Need Activation" mode.
+
+ -trace turns on Lynx trace mode. Destination of trace
+ output depends on -tlog.
+
+ -trace_mask=value
+ turn on optional traces, which may result in very
+ large trace files. Logically OR the values to
+ combine options:
+ 1=SGML character parsing states
+ 2=color-style
+ 4=TRST (table layout)
+
+ -traversal
+ traverse all http links derived from startfile.
+ When used with -crawl, each link that begins with
+ the same string as startfile is output to a file,
+ intended for indexing. See CRAWL.announce for more
+ information.
+
+ trim_input_fields
+ trim input text/textarea fields in forms.
+
+ -underscore
+ toggles use of _underline_ format in dumps.
+
+ -use_mouse
+ turn on mouse support, if available. Clicking the
+ left mouse button on a link traverses it. Clicking
+ the right mouse button pops back. Click on the top
+ line to scroll up. Click on the bottom line to
+ scroll down. The first few positions in the top
+ and bottom line may invoke additional functions.
+ Lynx must be compiled with ncurses or slang to
+ support this feature. If ncurses is used, clicking
+ the middle mouse button pops up a simple menu.
+ Mouse clicks may only work reliably while Lynx is
+ idle waiting for input.
+
+ -useragent=Name
+ set alternate Lynx User-Agent header.
+
+ -validate
+ accept only http URLs (for validation). Complete
+ security restrictions also are implemented.
+
+ -verbose
+ toggle [LINK], [IMAGE] and [INLINE] comments with
+ filenames of these images.
+
+ -version
+ print version information.
+
+ -vikeys
+ enable vi-like key movement.
+
+ -wdebug
+ enable Waterloo tcp/ip packet debug (print to watt
+ debugfile). This applies only to DOS versions
+ compiled with WATTCP or WATT-32.
+
+ -width=NUMBER
+ number of columns for formatting of dumps, default
+ is 80.
+
+ -with_backspaces
+ emit backspaces in output if -dumping or -crawling
+ (like 'man' does)
+
+2 Commands
+ o Use Up arrow and Down arrow to scroll through hypertext
+ links.
+ o Right arrow or Return will follow a highlighted
+ hypertext link.
+ o Left Arrow will retreat from a link.
+ o Type "H" or "?" for online help and descriptions of key-
+ stroke commands.
+ o Type "K" for a complete list of the current key-stroke
+ command mappings.
+
+2 Environment
In addition to various "standard" environment variables
- such as HOME, PATH, USER, DISPLAY, TMPDIR, etc, Lynx uti-
- lizes several Lynx-specific environment variables, if they
- exist.
+ such as HOME, PATH, USER, DISPLAY, TMPDIR, etc, Lynx
+ utilizes several Lynx-specific environment variables, if
+ they exist.
Others may be created or modified by Lynx to pass data to
an external program, or for other reasons. These are
@@ -498,10 +707,10 @@
Environment Variables Used By Lynx:
- COLORTERM If set, color capability for the ter-
- minal is forced on at startup time.
- The actual value assigned to the vari-
- able is ignored. This variable is
+ COLORTERM If set, color capability for the
+ terminal is forced on at startup time.
+ The actual value assigned to the
+ variable is ignored. This variable is
only meaningful if Lynx was built
using the slang screen-handling
library.
@@ -525,53 +734,55 @@
the default path prefix for files
saved to disk that is defined in the
lynx.cfg SAVE_SPACE: statement. See
- the lynx.cfg file for more informa-
- tion.
+ the lynx.cfg file for more
+ information.
LYNX_TEMP_SPACE This variable, if set, will override
the default path prefix for temporary
- files that was defined during instal-
- lation, as well as any value that may
- be assigned to the TMPDIR variable.
+ files that was defined during
+ installation, as well as any value
+ that may be assigned to the TMPDIR
+ variable.
- MAIL This variable specifies the default
+ MAIL This variable specifies the default
inbox Lynx will check for new mail, if
- such checking is enabled in the
+ such checking is enabled in the
lynx.cfg file.
- NEWS_ORGANIZATION This variable, if set, provides the
- string used in the Organization:
- header of USENET news postings. It
- will override the setting of the ORGA-
- NIZATION environment variable, if it
- is also set (and, on UNIX, the con-
- tents of an /etc/organization file, if
- present).
-
- NNTPSERVER If set, this variable specifies the
- default NNTP server that will be used
- for USENET news reading and posting
+ NEWS_ORGANIZATION This variable, if set, provides the
+ string used in the Organization:
+ header of USENET news postings. It
+ will override the setting of the
+ ORGANIZATION environment variable, if
+ it is also set (and, on UNIX, the
+
+ contents of an /etc/organization file,
+ if present).
+
+ NNTPSERVER If set, this variable specifies the
+ default NNTP server that will be used
+ for USENET news reading and posting
with Lynx, via news: URL's.
- ORGANIZATION This variable, if set, provides the
- string used in the Organization:
- header of USENET news postings. On
+ ORGANIZATION This variable, if set, provides the
+ string used in the Organization:
+ header of USENET news postings. On
UNIX, it will override the contents of
an /etc/organization file, if present.
PROTOCOL_proxy Lynx supports the use of proxy servers
- that can act as firewall gateways and
- caching servers. They are preferable
+ that can act as firewall gateways and
+ caching servers. They are preferable
to the older gateway servers (see
- WWW_access_GATEWAY, below). Each pro-
- tocol used by Lynx, (http, ftp,
+ WWW_access_GATEWAY, below). Each
+ protocol used by Lynx, (http, ftp,
gopher, etc), can be mapped separately
- by setting environment variables of
+ by setting environment variables of
the form PROTOCOL_proxy (literally:
http_proxy, ftp_proxy, gopher_proxy,
- etc), to
- "http://some.server.dom:port/".
- See Lynx Users Guide for additional
+ etc), to
+ "http://some.server.dom:port/". See
+ Lynx Users Guide for additional
details and examples.
WWW_access_GATEWAY Lynx still supports use of gateway
@@ -582,60 +793,66 @@
however most gateway servers have been
discontinued. Note that you do not
include a terminal '/' for gateways,
- but do for proxies specified by PROTO-
- COL_proxy environment variables. See
- Lynx Users Guide for details.
+ but do for proxies specified by
+ PROTOCOL_proxy environment variables.
+ See Lynx Users Guide for details.
- WWW_HOME This variable, if set, will override
- the default startup URL specified in
+ WWW_HOME This variable, if set, will override
+ the default startup URL specified in
any of the Lynx configuration files.
Environment Variables Set or Modified By Lynx:
LYNX_PRINT_DATE This variable is set by the Lynx
- p(rint) function, to the Date: string
- seen in the document's "Information
- about" page (= cmd), if any. It is
- created for use by an external pro-
- gram, as defined in a lynx.cfg
+ p(rint) function, to the Date: string
+ seen in the document's "Information
+ about" page (= cmd), if any. It is
+ created for use by an external
+ program, as defined in a lynx.cfg
PRINTER: definition statement. If the
field does not exist for the document,
- the variable is set to a null string
+ the variable is set to a null string
under UNIX, or "No Date" under VMS.
LYNX_PRINT_LASTMOD This variable is set by the Lynx
- p(rint) function, to the Last Mod:
- string seen in the document's "Infor-
- mation about" page (= cmd), if any.
- It is created for use by an external
- program, as defined in a lynx.cfg
- PRINTER: definition statement. If the
- field does not exist for the document,
- the variable is set to a null string
- under UNIX, or "No LastMod" under VMS.
+ p(rint) function, to the Last Mod:
+ string seen in the document's
+ "Information about" page (= cmd), if
+ any. It is created for use by an
+ external program, as defined in a
+ lynx.cfg PRINTER: definition
+ statement. If the field does not
+ exist for the document, the variable
+ is set to a null string under UNIX, or
+ "No LastMod" under VMS.
LYNX_PRINT_TITLE This variable is set by the Lynx
p(rint) function, to the Linkname:
- string seen in the document's "Infor-
- mation about" page (= cmd), if any.
- It is created for use by an external
- program, as defined in a lynx.cfg
- PRINTER: definition statement. If the
- field does not exist for the document,
- the variable is set to a null string
- under UNIX, or "No Title" under VMS.
+ string seen in the document's
+ "Information about" page (= cmd), if
+ any. It is created for use by an
+ external program, as defined in a
+ lynx.cfg PRINTER: definition
+ statement. If the field does not
+ exist for the document, the variable
+ is set to a null string under UNIX, or
+ "No Title" under VMS.
LYNX_PRINT_URL This variable is set by the Lynx
p(rint) function, to the URL: string
seen in the document's "Information
about" page (= cmd), if any. It is
- created for use by an external pro-
- gram, as defined in a lynx.cfg
+ created for use by an external
+ program, as defined in a lynx.cfg
PRINTER: definition statement. If the
field does not exist for the document,
the variable is set to a null string
under UNIX, or "No URL" under VMS.
+ LYNX_TRACE If set, causes Lynx to write a trace
+ file as if the -trace option were
+ supplied.
+
LYNX_VERSION This variable is always set by Lynx,
and may be used by an external program
to determine if it was invoked by
@@ -645,26 +862,27 @@
TERM Normally, this variable is used by
Lynx to determine the terminal type
- being used to invoke Lynx. If, how-
- ever, it is unset at startup time (or
- has the value "unknown"), or if the
- -term command-line option is used (see
- OPTIONS section above), Lynx will set
- or modify its value to the user speci-
- fied terminal type (for the Lynx exe-
- cution environment). Note: If
+ being used to invoke Lynx. If,
+ however, it is unset at startup time
+
+ (or has the value "unknown"), or if
+ the -term command-line option is used
+ (see OPTIONS section above), Lynx will
+ set or modify its value to the user
+ specified terminal type (for the Lynx
+ execution environment). Note: If
set/modified by Lynx, the values of
the LINES and/or COLUMNS environment
variables may also be changed.
-2 SIMULATED CGI SUPPORT
- If built with the cgi-links option enabled, Lynx allows
- access to a cgi script directly without the need for an
+2 Simulated Cgi Support
+ If built with the cgi-links option enabled, Lynx allows
+ access to a cgi script directly without the need for an
http daemon.
- When executing such "lynxcgi scripts" (if enabled), the
- following variables may be set for simulating a CGI envi-
- ronment:
+ When executing such "lynxcgi scripts" (if enabled), the
+ following variables may be set for simulating a CGI
+ environment:
CONTENT_LENGTH
@@ -692,72 +910,74 @@
SERVER_SOFTWARE
- Other environment variables are not inherited by the
+ Other environment variables are not inherited by the
script, unless they are provided via a LYNXCGI_ENVIRONMENT
- statement in the configuration file. See the lynx.cfg
- file, and the (draft) CGI 1.1 Specification
+ statement in the configuration file. See the lynx.cfg
+ file, and the (draft) CGI 1.1 Specification
<http://Web.Golux.Com/coar/cgi/draft-coar-cgi-v11-00.txt>
for the definition and usage of these variables.
The CGI Specification, and other associated documentation,
- should be consulted for general information on CGI script
+ should be consulted for general information on CGI script
programming.
-2 NATIVE LANGUAGE SUPPORT
- If configured and installed with Native Language Support,
- Lynx will display status and other messages in your local
- language. See the file ABOUT_NLS in the source distribu-
- tion, or at your local GNU site, for more information
- about internationalization.
+2 Native Language Support
+ If configured and installed with Native Language Support,
+ Lynx will display status and other messages in your local
+ language. See the file ABOUT_NLS in the source
+ distribution, or at your local GNU site, for more
+ information about internationalization.
- The following environment variables may be used to alter
+ The following environment variables may be used to alter
default settings:
- LANG This variable, if set, will override
- the default message language. It is
+ LANG This variable, if set, will override
+ the default message language. It is
an ISO 639 two-letter code identifying
- the language. Language codes are NOT
+ the language. Language codes are NOT
the same as the country codes given in
ISO 3166.
- LANGUAGE This variable, if set, will override
+ LANGUAGE This variable, if set, will override
the default message language. This is
- a GNU extension that has higher prior-
- ity for setting the message catalog
- than LANG or LC_ALL.
+ a GNU extension that has higher
+ priority for setting the message
+ catalog than LANG or LC_ALL.
LC_ALL and
- LC_MESSAGES These variables, if set, specify the
- notion of native language formatting
+ LC_MESSAGES These variables, if set, specify the
+ notion of native language formatting
style. They are POSIXly correct.
- LINGUAS This variable, if set prior to config-
- uration, limits the installed lan-
- guages to specific values. It is a
- space-separated list of two-letter
+ LINGUAS This variable, if set prior to
+ configuration, limits the installed
+ languages to specific values. It is a
+ space-separated list of two-letter
codes. Currently, it is hard-coded to
a wish list.
- NLSPATH This variable, if set, is used as the
+ NLSPATH This variable, if set, is used as the
path prefix for message catalogs.
-2 NOTES
- This is the Lynx v2.8.2 Release
+2 Notes
+ This is the Lynx v2.8.4 Release
- If you wish to contribute to the further development of Lynx, subscribe
- to our mailing list. Send email to <majordomo@sig.net> with
- "subscribe lynx-dev" as the only line in the body of your
- message.
+ If you wish to contribute to the further development of
+ Lynx, subscribe to our mailing list. Send email to
+ <majordomo@sig.net> with "subscribe lynx-dev" as the only
+ line in the body of your message.
- Send bug reports, comments, suggestions to <lynx-dev@sig.net>
- after subscribing.
+ Send bug reports, comments, suggestions to <lynx-
+ dev@sig.net> after subscribing.
- Unsubscribe by sending email to <majordomo@sig.net> with
- "unsubscribe lynx-dev" as the only line in the body of your message.
- Do not send the unsubscribe message to the lynx-dev list, itself.
+ Unsubscribe by sending email to <majordomo@sig.net> with
+ "unsubscribe lynx-dev" as the only line in the body of
-2 SEE ALSO
+ your message. Do not send the unsubscribe message to the
+ lynx-dev list, itself.
+
+2 See Also
catgets(3), curses(3), environ(7), execve(2), ftp(1),
gettext(GNU), localeconv(3), ncurses(3), setlocale(3),
slang(?), termcap(5), terminfo(5), wget(GNU)
@@ -768,38 +988,42 @@
A section shown as (GNU), is intended to denote that the
topic may be available via an info page, instead of a man
- page (ie, try "info subject", rather than "man subject").
+ page (i.e., try "info subject", rather than "man subject").
A section shown as (?) denotes that documentation on the
- topic exists, but is not part of an established documenta-
- tion retrieval system (see the distribution files associ-
- ated with the topic, or contact your System Administrator
+ topic exists, but is not part of an established documentation
+ retrieval system (see the distribution files associated
+ with the topic, or contact your System Administrator
for further information).
-2 ACKNOWLEDGMENTS
- Lynx has incorporated code from a variety of sources along the way.
- The earliest versions of Lynx included code from Earl Fogel of Computing
- Services at the University of Saskatchewan, who implemented HYPERREZ
- in the Unix environment. HYPERREZ was developed by Niel Larson of
- Think.com and served as the model for the early versions of Lynx.
- Those versions also incorporated libraries from the Unix Gopher clients
- developed at the University of Minnesota, and the later versions of
- Lynx rely on the WWW client library code developed by Tim Berners-Lee
- and the WWW community. Also a special thanks to Foteos Macrides who
- ported much of Lynx to VMS and did or organized most of its development
- since the departures of Lou Montulli and Garrett Blythe from the
- University of Kansas in the summer of 1994 through the release
- of v2.7.2, and to everyone on the net who has contributed to Lynx's
- development either directly (through patches, comments or bug reports)
- or indirectly (through inspiration and development of other systems).
-
-2 AUTHORS
- Lou Montulli, Garrett Blythe, Craig Lavender, Michael Grobe, Charles Rezac
- Academic Computing Services
- University of Kansas
- Lawrence, Kansas 66047
-
- Foteos Macrides
- Worcester Foundation for Biomedical Research
- Shrewsbury, Massachusetts 01545
-
+2 Acknowledgments
+ Lynx has incorporated code from a variety of sources along
+ the way. The earliest versions of Lynx included code from
+ Earl Fogel of Computing Services at the University of
+ Saskatchewan, who implemented HYPERREZ in the Unix envi-
+ ronment. HYPERREZ was developed by Niel Larson of
+ Think.com and served as the model for the early versions
+ of Lynx. Those versions also incorporated libraries from
+ the Unix Gopher clients developed at the University of
+ Minnesota, and the later versions of Lynx rely on the WWW
+ client library code developed by Tim Berners-Lee and the
+ WWW community. Also a special thanks to Foteos Macrides
+ who ported much of Lynx to VMS and did or organized most
+ of its development since the departures of Lou Montulli
+ and Garrett Blythe from the University of Kansas in the
+ summer of 1994 through the release of v2.7.2, and to ev-
+ eryone on the net who has contributed to Lynx's develop-
+ ment either directly (through patches, comments or bug re-
+ ports) or indirectly (through inspiration and development
+ of other systems).
+
+2 Authors
+ Lou Montulli, Garrett Blythe, Craig Lavender, Michael
+ Grobe, Charles Rezac
+ Academic Computing Services
+ University of Kansas
+ Lawrence, Kansas 66047
+
+ Foteos Macrides
+ Worcester Foundation for Biomedical Research
+ Shrewsbury, Massachusetts 01545