1LYNX(1) General Commands Manual LYNX(1)
2
6 lynx - a general purpose distributed information browser for the World
7 Wide Web
8
10 lynx [options] [path or URL]
11 use "lynx -help" to display a complete list of current options.
13
15 Lynx is a fully-featured World Wide Web (WWW) client for users running
16 cursor-addressable, character-cell display devices (e.g., vt100
17 terminals, vt100 emulators running on Windows 95/NT or Macintoshes, or
18 any other "curses-oriented" display). It will display hypertext markup
19 language (HTML) documents containing links to files residing on the
20 local system, as well as files residing on remote systems running
21 Gopher, HTTP, FTP, WAIS, and NNTP servers. Current versions of Lynx
22 run on Unix, VMS, Windows 95/NT, 386DOS and OS/2 EMX.
23 Lynx can be used to access information on the World Wide Web, or to
25 build information systems intended primarily for local access. For
26 example, Lynx has been used to build several Campus Wide Information
27 Systems (CWIS). In addition, Lynx can be used to build systems
28 isolated within a single LAN.
29
31 At start up, Lynx will load any local file or remote URL specified at
32 the command line. For help with URLs, press "?" or "H" while running
33 Lynx. Then follow the link titled, "Help on URLs."
34 If more than one local file or remote URL is listed on the command
36 line, Lynx will open only the last interactively. All of the names
37 (local files and remote URLs) are added to the G)oto history.
38 Lynx uses only long option names. Option names can begin with double
40 dash as well, underscores and dashes can be intermixed in option names
41 (in the reference below options are with one dash before them and with
42 underscores).
43 Lynx provides many command-line options. Some options require a value
45 (string, number or keyword). These are noted in the reference below.
46 The other options set boolean values in the program. There are three
47 types of boolean options: set, unset and toggle. If no option value is
48 given, these have the obvious meaning: set (to true), unset (to false),
49 or toggle (between true/false). For any of these, an explicit value
50 can be given in different forms to allow for operating system
51 constraints, e.g.,
52 -center:off
53 -center=off
54 -center-
55 Lynx recognizes "1", "+", "on" and "true" for true values, and "0",
56 "-", "off" and "false" for false values. Other option-values are
57 ignored.
58 The default boolean, number and string option values that are compiled
60 into lynx are displayed in the help-message provided by lynx -help.
61 Some of those may differ according to how lynx was built; see the help
62 message itself for these values. The -help option is processed before
63 any option, including those that control reading from the lynx.cfg
64 file. Therefore runtime configuration values are not reflected in the
65 help-message.
66 - If the argument is only '-', then Lynx expects to receive the
68 arguments from the standard input. This is to allow for the
69 potentially very long command line that can be associated with
70 the -get_data or -post_data arguments (see below). It can also
71 be used to avoid having sensitive information in the invoking
72 command line (which would be visible to other processes on most
73 systems), especially when the -auth or -pauth options are used.
74 -accept_all_cookies
76 accept all cookies.
77 -anonymous
79 apply restrictions for anonymous account, see also
80 -restrictions.
81 -assume_charset=MIMEname
83 charset for documents that don't specify it.
84 -assume_local_charset=MIMEname
86 charset assumed for local files, i.e., files which lynx creates
87 such as internal pages for the options menu.
88 -assume_unrec_charset=MIMEname
90 use this instead of unrecognized charsets.
91 -auth=ID:PASSWD
93 set authorization ID and password for protected documents at
94 startup. Be sure to protect any script files which use this
95 switch.
96 -base prepend a request URL comment and BASE tag to text/html outputs
98 for -source dumps.
99 -bibp=URL
101 specify a local bibp server (default http://bibhost/).
102 -blink forces high intensity background colors for color mode, if
104 available and supported by the terminal. This applies to the
105 slang library (for a few terminal emulators), or to OS/2 EMX
106 with ncurses.
107 -book use the bookmark page as the startfile. The default or command
109 line startfile is still set for the Main screen command, and
110 will be used if the bookmark page is unavailable or blank.
111 -buried_news
113 toggles scanning of news articles for buried references, and
114 converts them to news links. Not recommended because email
115 addresses enclosed in angle brackets will be converted to false
116 news links, and uuencoded messages can be trashed.
117 -cache=NUMBER
119 set the NUMBER of documents cached in memory. The default is
120 10.
121 -case enable case-sensitive string searching.
123 -center
125 Toggle center alignment in HTML TABLE.
126 -cfg=FILENAME
128 specifies a Lynx configuration file other than the default
129 lynx.cfg.
130 -child exit on left-arrow in startfile, and disable save to disk.
132 -cmd_log=FILENAME
134 write keystroke commands and related information to the
135 specified file.
136 -cmd_script=FILENAME
138 read keystroke commands from the specified file. You can use
139 the data written using the -cmd_log option. Lynx will ignore
140 other information which the command-logging may have written to
141 the logfile. Each line of the command script contains either a
142 comment beginning with "#", or a keyword:
143 exit causes the script to stop, and forces Lynx to exit
145 immediately.
146 key the character value, in printable form. Cursor and other
148 special keys are given as names, e.g., "Down Arrow".
149 Printable 7-bit ASCII codes are given as-is, and hexadecimal
150 values represent other 8-bit codes.
151 set followed by a "name=value" allows one to override values set
153 in the lynx.cfg file.
154 -color forces color mode on, if available. Default color control
156 sequences which work for many terminal types are assumed if the
157 terminal capability description does not specify how to handle
158 color. Lynx needs to be compiled with the slang library for
159 this flag, it is equivalent to setting the COLORTERM environment
160 variable. (If color support is instead provided by a color-
161 capable curses library like ncurses, Lynx relies completely on
162 the terminal description to determine whether color mode is
163 possible, and this flag is not needed and thus unavailable.) A
164 saved show_color=always setting found in a .lynxrc file at
165 startup has the same effect. A saved show_color=never found in
166 .lynxrc on startup is overridden by this flag.
167 -connect_timeout=N
169 Sets the connection timeout, where N is given in seconds.
170 -cookie_file=FILENAME
172 specifies a file to use to read cookies. If none is specified,
173 the default value is ~/.lynx_cookies for most systems, but
174 ~/cookies for MS-DOS.
175 -cookie_save_file=FILENAME
177 specifies a file to use to store cookies. If none is specified,
178 the value given by -cookie_file is used.
179 -cookies
181 toggles handling of Set-Cookie headers.
182 -core toggles forced core dumps on fatal errors. Turn this option off
184 to ask Lynx to force a core dump if a fatal error occurs.
185 -crawl with -traversal, output each page to a file. with -dump, format
187 output as with -traversal, but to the standard output.
188 -curses_pads
190 toggles the use of curses "pad" feature which supports
191 left/right scrolling of the display.
192 -debug_partial
194 separate incremental display stages with MessageSecs delay
195 -delay add DebugSecs delay after each progress-message
197 -display=DISPLAY
199 set the display variable for X rexec-ed programs.
200 -display_charset=MIMEname
202 set the charset for the terminal output.
203 -dont_wrap_pre
205 inhibit wrapping of text in <pre> when -dump'ing and -crawl'ing,
206 mark wrapped lines in interactive session.
207 -dump dumps the formatted output of the default document or those
209 specified on the command line to standard output. Unlike
210 interactive mode, all documents are processed. This can be used
211 in the following way:
212 lynx -dump http://www.subir.com/lynx.html
214 -editor=EDITOR
216 enable external editing, using the specified EDITOR. (vi, ed,
217 emacs, etc.)
218 -emacskeys
220 enable emacs-like key movement.
221 -enable_scrollback
223 toggles compatibility with communication programs' scrollback
224 keys (may be incompatible with some curses packages).
225 -error_file=FILE
227 define a file where Lynx will report HTTP access codes.
228 -exec enable local program execution (normally not configured).
230 -fileversions
232 include all versions of files in local VMS directory listings.
233 -find_leaks
235 toggle memory leak-checking. Normally this is not compiled-into
236 your executable, but when it is, it can be disabled for a
237 session.
238 -force_empty_hrefless_a
240 force HREF-less 'A' elements to be empty (close them as soon as
241 they are seen).
242 -force_html
244 forces the first document to be interpreted as HTML.
245 -force_secure
247 toggles forcing of the secure flag for SSL cookies.
248 -forms_options
250 toggles whether the Options Menu is key-based or form-based.
251 -from toggles transmissions of From headers.
253 -ftp disable ftp access.
255 -get_data
257 properly formatted data for a get form are read in from the
258 standard input and passed to the form. Input is terminated by a
259 line that starts with '---'.
260 -head send a HEAD request for the mime headers.
262 -help print the Lynx command syntax usage message.
264 -hiddenlinks=[option]
266 control the display of hidden links.
267 merge hidden links show up as bracketed numbers and are numbered
269 together with other links in the sequence of their occurrence in
270 the document.
271 listonly hidden links are shown only on L)ist screens and
273 listings generated by -dump or from the P)rint menu, but appear
274 separately at the end of those lists. This is the default
275 behavior.
276 ignore hidden links do not appear even in listings.
278 -historical
280 toggles use of '>' or '-->' as a terminator for comments.
281 -homepage=URL
283 set homepage separate from start page.
284 -image_links
286 toggles inclusion of links for all images.
287 -index=URL
289 set the default index file to the specified URL.
290 -ismap toggles inclusion of ISMAP links when client-side MAPs are
292 present.
293 -justify
295 do justification of text.
296 -link=NUMBER
298 starting count for lnk#.dat files produced by -crawl.
299 -listonly
301 for -dump, show only the list of links.
302 -localhost
304 disable URLs that point to remote hosts.
305 -locexec
307 enable local program execution from local files only (if Lynx
308 was compiled with local execution enabled).
309 -lss=FILENAME
311 specify filename containing color-style information. The
312 default is lynx.lss.
313 -mime_header
315 prints the MIME header of a fetched document along with its
316 source.
317 -minimal
319 toggles minimal versus valid comment parsing.
320 -nested_tables
322 toggles nested-tables logic (for debugging).
323 -newschunksize=NUMBER
325 number of articles in chunked news listings.
326 -newsmaxchunk=NUMBER
328 maximum news articles in listings before chunking.
329 -nobold
331 disable bold video-attribute.
332 -nobrowse
334 disable directory browsing.
335 -nocc disable Cc: prompts for self copies of mailings. Note that this
337 does not disable any CCs which are incorporated within a mailto
338 URL or form ACTION.
339 -nocolor
341 force color mode off, overriding terminal capabilities and any
342 -color flags, COLORTERM variable, and saved .lynxrc settings.
343 -noexec
345 disable local program execution. (DEFAULT)
346 -nofilereferer
348 disable transmissions of Referer headers for file URLs.
349 -nolist
351 disable the link list feature in dumps.
352 -nolog disable mailing of error messages to document owners.
354 -nomargins
356 disable left/right margins in the default style sheet.
357 -nonrestarting_sigwinch
359 This flag is not available on all systems, Lynx needs to be
360 compiled with HAVE_SIGACTION defined. If available, this flag
361 may cause Lynx to react more immediately to window changes when
362 run within an xterm.
363 -nonumbers
365 disable link- and field-numbering. This overrides
366 -number_fields and -number_links.
367 -nopause
369 disable forced pauses for statusline messages.
370 -noprint
372 disable most print functions.
373 -noredir
375 prevents automatic redirection and prints a message with a link
376 to the new URL.
377 -noreferer
379 disable transmissions of Referer headers.
380 -noreverse
382 disable reverse video-attribute.
383 -nosocks
385 disable SOCKS proxy usage by a SOCKSified Lynx.
386 -nostatus
388 disable the retrieval status messages.
389 -notitle
391 disable title and blank line from top of page.
392 -nounderline
394 disable underline video-attribute.
395 -number_fields
397 force numbering of links as well as form input fields
398 -number_links
400 force numbering of links.
401 -partial
403 toggles display partial pages while loading.
404 -partial_thres=NUMBER
406 number of lines to render before repainting display with
407 partial-display logic
408 -pauth=ID:PASSWD
410 set authorization ID and password for a protected proxy server
411 at startup. Be sure to protect any script files which use this
412 switch.
413 -popup toggles handling of single-choice SELECT options via popup
415 windows or as lists of radio buttons.
416 -post_data
418 properly formatted data for a post form are read in from the
419 standard input and passed to the form. Input is terminated by a
420 line that starts with '---'.
421 -preparsed
423 show HTML source preparsed and reformatted when used with
424 -source or in source view.
425 -prettysrc
427 show HTML source view with lexical elements and tags in color.
428 -print enable print functions. (default)
430 -pseudo_inlines
432 toggles pseudo-ALTs for inline images with no ALT string.
433 -raw toggles default setting of 8-bit character translations or CJK
435 mode for the startup character set.
436 -realm restricts access to URLs in the starting realm.
438 -reload
440 flushes the cache on a proxy server (only the first document
441 affected).
442 -restrictions=[option][,option][,option]...
444 allows a list of services to be disabled selectively. Dashes and
445 underscores in option names can be intermixed. The following
446 list is printed if no options are specified.
447 all - restricts all options listed below.
449 bookmark - disallow changing the location of the bookmark file.
451 bookmark_exec - disallow execution links via the bookmark file.
453 change_exec_perms - disallow changing the eXecute permission on
455 files (but still allow it for directories) when local file
456 management is enabled.
457 default - same as command line option -anonymous. Disables
459 default services for anonymous users. Set to all restricted,
460 except for: inside_telnet, outside_telnet, inside_ftp,
461 outside_ftp, inside_rlogin, outside_rlogin, inside_news,
462 outside_news, telnet_port, jump, mail, print, exec, and goto.
463 The settings for these, as well as additional goto restrictions
464 for specific URL schemes that are also applied, are derived from
465 definitions within userdefs.h.
466 dired_support - disallow local file management.
468 disk_save - disallow saving to disk in the download and print
470 menus.
471 dotfiles - disallow access to, or creation of, hidden (dot)
473 files.
474 download - disallow some downloaders in the download menu (does
476 not imply disk_save restriction).
477 editor - disallow external editing.
479 exec - disable execution scripts.
481 exec_frozen - disallow the user from changing the local
483 execution option.
484 externals - disallow some "EXTERNAL" configuration lines if
486 support for passing URLs to external applications (with the
487 EXTERN command) is compiled in.
488 file_url - disallow using G)oto, served links or bookmarks for
490 file: URLs.
491 goto - disable the 'g' (goto) command.
493 inside_ftp - disallow ftps for people coming from inside your
495 domain (utmp required for selectivity).
496 inside_news - disallow USENET news posting for people coming
498 from inside your domain (utmp required for selectivity).
499 inside_rlogin - disallow rlogins for people coming from inside
501 your domain (utmp required for selectivity).
502 inside_telnet - disallow telnets for people coming from inside
504 your domain (utmp required for selectivity).
505 jump - disable the 'j' (jump) command.
507 multibook - disallow multiple bookmarks.
509 mail - disallow mail.
511 news_post - disallow USENET News posting.
513 options_save - disallow saving options in .lynxrc.
515 outside_ftp - disallow ftps for people coming from outside your
517 domain (utmp required for selectivity).
518 outside_news - disallow USENET news reading and posting for
520 people coming from outside your domain (utmp required for
521 selectivity). This restriction applies to "news", "nntp",
522 "newspost", and "newsreply" URLs, but not to "snews",
523 "snewspost", or "snewsreply" in case they are supported.
524 outside_rlogin - disallow rlogins for people coming from outside
526 your domain (utmp required for selectivity).
527 outside_telnet - disallow telnets for people coming from outside
529 your domain (utmp required for selectivity).
530 print - disallow most print options.
532 shell - disallow shell escapes and lynxexec or lynxprog G)oto's.
534 suspend - disallow Unix Control-Z suspends with escape to shell.
536 telnet_port - disallow specifying a port in telnet G)oto's.
538 useragent - disallow modifications of the User-Agent header.
540 -resubmit_posts
542 toggles forced resubmissions (no-cache) of forms with method
543 POST when the documents they returned are sought with the
544 PREV_DOC command or from the History List.
545 -rlogin
547 disable recognition of rlogin commands.
548 -scrollbar
550 toggles showing scrollbar.
551 -scrollbar_arrow
553 toggles showing arrows at ends of the scrollbar.
554 -selective
556 require .www_browsable files to browse directories.
557 -short_url
559 show very long URLs in the status line with "..." to represent
560 the portion which cannot be displayed. The beginning and end of
561 the URL are displayed, rather than suppressing the end.
562 -show_cursor
564 If enabled the cursor will not be hidden in the right hand
565 corner but will instead be positioned at the start of the
566 currently selected link. Show cursor is the default for systems
567 without FANCY_CURSES capabilities. The default configuration
568 can be changed in userdefs.h or lynx.cfg. The command line
569 switch toggles the default.
570 -show_rate
572 If enabled the transfer rate is shown in bytes/second. If
573 disabled, no transfer rate is shown. Use lynx.cfg or the
574 options menu to select KB/second and/or ETA.
575 -soft_dquotes
577 toggles emulation of the old Netscape and Mosaic bug which
578 treated '>' as a co-terminator for double-quotes and tags.
579 -source
581 works the same as dump but outputs HTML source instead of
582 formatted text. For example
583 lynx -source . >foo.html
585 generates HTML source listing the files in the current
587 directory. Each file is marked by an HREF relative to the
588 parent directory. Add a trailing slash to make the HREF's
589 relative to the current directory:
590 lynx -source ./ >foo.html
592 -stack_dump
594 disable SIGINT cleanup handler
595 -startfile_ok
597 allow non-http startfile and homepage with -validate.
598 -stderr
600 When dumping a document using -dump or -source, Lynx normally
601 does not display alert (error) messages that you see on the
602 screen in the status line. Use the -stderr option to tell Lynx
603 to write these messages to the standard error.
604 -stdin read the startfile from standard input (UNIX only).
606 -syslog=text
608 information for syslog call.
609 -syslog-urls
611 log requested URLs with syslog.
612 -tagsoup
614 initialize parser, using Tag Soup DTD rather than SortaSGML.
615 -telnet
617 disable recognition of telnet commands.
618 -term=TERM
620 tell Lynx what terminal type to assume it is talking to. (This
621 may be useful for remote execution, when, for example, Lynx
622 connects to a remote TCP/IP port that starts a script that, in
623 turn, starts another Lynx process.)
624 -timeout=N
626 For win32, sets the network read-timeout, where N is given in
627 seconds.
628 -tlog toggles between using a Lynx Trace Log and stderr for trace
630 output from the session.
631 -tna turns on "Textfields Need Activation" mode.
633 -trace turns on Lynx trace mode. Destination of trace output depends
635 on -tlog.
636 -trace_mask=value
638 turn on optional traces, which may result in very large trace
639 files. Logically OR the values to combine options:
640 1=SGML character parsing states
641 2=color-style
642 4=TRST (table layout)
643 8=config (lynx.cfg and .lynxrc contents)
644 16=binary string copy/append, used in form data construction.
645 -traversal
647 traverse all http links derived from startfile. When used with
648 -crawl, each link that begins with the same string as startfile
649 is output to a file, intended for indexing. See CRAWL.announce
650 for more information.
651 trim_input_fields
653 trim input text/textarea fields in forms.
654 -underline_links
656 toggles use of underline/bold attribute for links.
657 -underscore
659 toggles use of _underline_ format in dumps.
660 -use_mouse
662 turn on mouse support, if available. Clicking the left mouse
663 button on a link traverses it. Clicking the right mouse button
664 pops back. Click on the top line to scroll up. Click on the
665 bottom line to scroll down. The first few positions in the top
666 and bottom line may invoke additional functions. Lynx must be
667 compiled with ncurses or slang to support this feature. If
668 ncurses is used, clicking the middle mouse button pops up a
669 simple menu. Mouse clicks may only work reliably while Lynx is
670 idle waiting for input.
671 -useragent=Name
673 set alternate Lynx User-Agent header.
674 -validate
676 accept only http URLs (for validation). Complete security
677 restrictions also are implemented.
678 -verbose
680 toggle [LINK], [IMAGE] and [INLINE] comments with filenames of
681 these images.
682 -version
684 print version information.
685 -vikeys
687 enable vi-like key movement.
688 -wdebug
690 enable Waterloo tcp/ip packet debug (print to watt debugfile).
691 This applies only to DOS versions compiled with WATTCP or
692 WATT-32.
693 -width=NUMBER
695 number of columns for formatting of dumps, default is 80.
696 -with_backspaces
698 emit backspaces in output if -dump'ing or -crawl'ing (like 'man'
699 does)
700
702 o Use Up arrow and Down arrow to scroll through hypertext links.
703 o Right arrow or Return will follow a highlighted hypertext link.
705 o Left Arrow will retreat from a link.
707 o Type "H" or "?" for online help and descriptions of key-stroke
709 commands.
710 o Type "K" for a complete list of the current key-stroke command
712 mappings.
713
715 In addition to various "standard" environment variables such as HOME,
716 PATH, USER, DISPLAY, TMPDIR, etc, Lynx utilizes several Lynx-specific
717 environment variables, if they exist.
718 Others may be created or modified by Lynx to pass data to an external
720 program, or for other reasons. These are listed separately below.
721 See also the sections on SIMULATED CGI SUPPORT and NATIVE LANGUAGE
723 SUPPORT, below.
724 Note: Not all environment variables apply to all types of platforms
726 supported by Lynx, though most do. Feedback on platform dependencies
727 is solicited.
728 Environment Variables Used By Lynx:
730 COLORTERM If set, color capability for the terminal is forced
732 on at startup time. The actual value assigned to
733 the variable is ignored. This variable is only
734 meaningful if Lynx was built using the slang
735 screen-handling library.
736 LYNX_CFG This variable, if set, will override the default
738 location and name of the global configuration file
739 (normally, lynx.cfg) that was defined by the
740 LYNX_CFG_FILE constant in the userdefs.h file,
741 during installation. See the userdefs.h file for
742 more information.
743 LYNX_LOCALEDIR If set, this variable overrides the compiled-in
745 location of the locale directory which contains
746 native language (NLS) message text.
747 LYNX_LSS This variable, if set, specifies the location of
749 the default Lynx character style sheet file.
750 [Currently only meaningful if Lynx was built using
751 experimental color style support.]
752 LYNX_SAVE_SPACE This variable, if set, will override the default
754 path prefix for files saved to disk that is defined
755 in the lynx.cfg SAVE_SPACE: statement. See the
756 lynx.cfg file for more information.
757 LYNX_TEMP_SPACE This variable, if set, will override the default
759 path prefix for temporary files that was defined
760 during installation, as well as any value that may
761 be assigned to the TMPDIR variable.
762 MAIL This variable specifies the default inbox Lynx will
764 check for new mail, if such checking is enabled in
765 the lynx.cfg file.
766 NEWS_ORGANIZATION This variable, if set, provides the string used in
768 the Organization: header of USENET news postings.
769 It will override the setting of the ORGANIZATION
770 environment variable, if it is also set (and, on
771 UNIX, the contents of an /etc/organization file, if
772 present).
773 NNTPSERVER If set, this variable specifies the default NNTP
775 server that will be used for USENET news reading
776 and posting with Lynx, via news: URL's.
777 ORGANIZATION This variable, if set, provides the string used in
779 the Organization: header of USENET news postings.
780 On UNIX, it will override the contents of an
781 /etc/organization file, if present.
782 PROTOCOL_proxy Lynx supports the use of proxy servers that can act
784 as firewall gateways and caching servers. They are
785 preferable to the older gateway servers (see
786 WWW_access_GATEWAY, below). Each protocol used by
787 Lynx, (http, ftp, gopher, etc), can be mapped
788 separately by setting environment variables of the
789 form PROTOCOL_proxy (literally: http_proxy,
790 ftp_proxy, gopher_proxy, etc), to
791 "http://some.server.dom:port/". See Lynx Users
792 Guide for additional details and examples.
793 SSL_CERT_DIR Set to the directory containing trusted
795 certificates.
796 SSL_CERT_FILE Set to the full path and filename for your file of
798 trusted certificates.
799 WWW_access_GATEWAY Lynx still supports use of gateway servers, with
801 the servers specified via "WWW_access_GATEWAY"
802 variables (where "access" is lower case and can be
803 "http", "ftp", "gopher" or "wais"), however most
804 gateway servers have been discontinued. Note that
805 you do not include a terminal '/' for gateways, but
806 do for proxies specified by PROTOCOL_proxy
807 environment variables. See Lynx Users Guide for
808 details.
809 WWW_HOME This variable, if set, will override the default
811 startup URL specified in any of the Lynx
812 configuration files.
813 Environment Variables Set or Modified By Lynx:
815 LYNX_PRINT_DATE This variable is set by the Lynx p(rint) function,
817 to the Date: string seen in the document's
818 "Information about" page (= cmd), if any. It is
819 created for use by an external program, as defined
820 in a lynx.cfg PRINTER: definition statement. If
821 the field does not exist for the document, the
822 variable is set to a null string under UNIX, or "No
823 Date" under VMS.
824 LYNX_PRINT_LASTMOD This variable is set by the Lynx p(rint) function,
826 to the Last Mod: string seen in the document's
827 "Information about" page (= cmd), if any. It is
828 created for use by an external program, as defined
829 in a lynx.cfg PRINTER: definition statement. If
830 the field does not exist for the document, the
831 variable is set to a null string under UNIX, or "No
832 LastMod" under VMS.
833 LYNX_PRINT_TITLE This variable is set by the Lynx p(rint) function,
835 to the Linkname: string seen in the document's
836 "Information about" page (= cmd), if any. It is
837 created for use by an external program, as defined
838 in a lynx.cfg PRINTER: definition statement. If
839 the field does not exist for the document, the
840 variable is set to a null string under UNIX, or "No
841 Title" under VMS.
842 LYNX_PRINT_URL This variable is set by the Lynx p(rint) function,
844 to the URL: string seen in the document's
845 "Information about" page (= cmd), if any. It is
846 created for use by an external program, as defined
847 in a lynx.cfg PRINTER: definition statement. If
848 the field does not exist for the document, the
849 variable is set to a null string under UNIX, or "No
850 URL" under VMS.
851 LYNX_TRACE If set, causes Lynx to write a trace file as if the
853 -trace option were supplied.
854 LYNX_TRACE_FILE If set, overrides the compiled-in name of the trace
856 file, which is either Lynx.trace or LY-TRACE.LOG
857 (the latter on the DOS platform). The trace file
858 is in either case relative to the home directory.
859 LYNX_VERSION This variable is always set by Lynx, and may be
861 used by an external program to determine if it was
862 invoked by Lynx. See also the comments in the
863 distribution's sample mailcap file, for notes on
864 usage in such a file.
865 TERM Normally, this variable is used by Lynx to
867 determine the terminal type being used to invoke
868 Lynx. If, however, it is unset at startup time (or
869 has the value "unknown"), or if the -term command-
870 line option is used (see OPTIONS section above),
871 Lynx will set or modify its value to the user
872 specified terminal type (for the Lynx execution
873 environment). Note: If set/modified by Lynx, the
874 values of the LINES and/or COLUMNS environment
875 variables may also be changed.
876
878 If built with the cgi-links option enabled, Lynx allows access to a cgi
879 script directly without the need for an http daemon.
880 When executing such "lynxcgi scripts" (if enabled), the following
882 variables may be set for simulating a CGI environment:
883 CONTENT_LENGTH
885 CONTENT_TYPE
887 DOCUMENT_ROOT
889 HTTP_ACCEPT_CHARSET
891 HTTP_ACCEPT_LANGUAGE
893 HTTP_USER_AGENT
895 PATH_INFO
897 PATH_TRANSLATED
899 QUERY_STRING
901 REMOTE_ADDR
903 REMOTE_HOST
905 REQUEST_METHOD
907 SERVER_SOFTWARE
909 Other environment variables are not inherited by the script, unless
911 they are provided via a LYNXCGI_ENVIRONMENT statement in the
912 configuration file. See the lynx.cfg file, and the (draft) CGI 1.1
913 Specification <http://Web.Golux.Com/coar/cgi/draft-coar-cgi-v11-00.txt>
914 for the definition and usage of these variables.
915 The CGI Specification, and other associated documentation, should be
917 consulted for general information on CGI script programming.
918
920 If configured and installed with Native Language Support, Lynx will
921 display status and other messages in your local language. See the file
922 ABOUT_NLS in the source distribution, or at your local GNU site, for
923 more information about internationalization.
924 The following environment variables may be used to alter default
926 settings:
927 LANG This variable, if set, will override the default
929 message language. It is an ISO 639 two-letter code
930 identifying the language. Language codes are NOT
931 the same as the country codes given in ISO 3166.
932 LANGUAGE This variable, if set, will override the default
934 message language. This is a GNU extension that has
935 higher priority for setting the message catalog
936 than LANG or LC_ALL.
937 LC_ALL and
939 LC_MESSAGES These variables, if set, specify the notion of
941 native language formatting style. They are POSIXly
942 correct.
943 LINGUAS This variable, if set prior to configuration,
945 limits the installed languages to specific values.
946 It is a space-separated list of two-letter codes.
947 Currently, it is hard-coded to a wish list.
948 NLSPATH This variable, if set, is used as the path prefix
950 for message catalogs.
951
953 This is the Lynx v2.8.6 Release; development is in progress for 2.8.7.
954 If you wish to contribute to the further development of Lynx, subscribe
956 to our mailing list. Send email to <lynx-dev-request@nongnu.org> with
957 "subscribe lynx-dev" as the only line in the body of your message.
958 Send bug reports, comments, suggestions to <lynx-dev@nongnu.org> after
960 subscribing.
961 Unsubscribe by sending email to <lynx-dev-request@nongnu.org> with
963 "unsubscribe lynx-dev" as the only line in the body of your message.
964 Do not send the unsubscribe message to the lynx-dev list, itself.
965
967 catgets(3), curses(3), environ(7), execve(2), ftp(1), gettext(GNU),
968 localeconv(3), ncurses(3), setlocale(3), slang(?), termcap(5),
969 terminfo(5), wget(GNU)
970 Note that man page availability and section numbering is somewhat plat‐
972 form dependent, and may vary from the above references.
973 A section shown as (GNU), is intended to denote that the topic may be
975 available via an info page, instead of a man page (i.e., try "info sub‐
976 ject", rather than "man subject").
977 A section shown as (?) denotes that documentation on the topic exists,
979 but is not part of an established documentation retrieval system (see
980 the distribution files associated with the topic, or contact your Sys‐
981 tem Administrator for further information).
982
984 Lynx has incorporated code from a variety of sources along the way.
985 The earliest versions of Lynx included code from Earl Fogel of Comput‐
986 ing Services at the University of Saskatchewan, who implemented HYPER‐
987 REZ in the Unix environment. HYPERREZ was developed by Niel Larson of
988 Think.com and served as the model for the early versions of Lynx.
989 Those versions also incorporated libraries from the Unix Gopher clients
990 developed at the University of Minnesota, and the later versions of
991 Lynx rely on the WWW client library code developed by Tim Berners-Lee
992 and the WWW community. Also a special thanks to Foteos Macrides who
993 ported much of Lynx to VMS and did or organized most of its development
994 since the departures of Lou Montulli and Garrett Blythe from the Uni‐
995 versity of Kansas in the summer of 1994 through the release of v2.7.2,
996 and to everyone on the net who has contributed to Lynx's development
997 either directly (through patches, comments or bug reports) or indirect‐
998 ly (through inspiration and development of other systems).
999
1001 Lou Montulli, Garrett Blythe, Craig Lavender, Michael Grobe, Charles
1002 Rezac
1003 Academic Computing Services
1004 University of Kansas
1005 Lawrence, Kansas 66047
1006 Foteos Macrides
1008 Worcester Foundation for Biomedical Research
1009 Shrewsbury, Massachusetts 01545
1010 Thomas E. Dickey
1012 <dickey@invisible-island.net>
1013 Local LYNX(1)