Debian Codegraph @

upstream/debian-unstable/man1/lynx.1

raw
1 .\" $LynxId: lynx.man,v 1.197 2026/05/26 08:24:07 tom Exp $
2 .\" **************************************************************************
3 .TH LYNX 1 2026-05-26 "Lynx 2.9.3" "Lynx \(en the \fItext\fP web browser"
4 .
5 .ie \n(.g \{\
6 .ds `` \(lq
7 .ds '' \(rq
8 .ds ' \(aq
9 .\}
10 .el \{\
11 .ie t .ds `` ``
12 .el .ds `` ""
13 .ie t .ds '' ''
14 .el .ds '' ""
15 .ie t .ds ' \(aq
16 .el .ds ' '
17 .\}
18 .
19 .ie n .ds CW R
20 .el \{
21 .ie \n(.g .ds CW CR
22 .el .ds CW CW
23 .\}
24 .
25 .de bP
26 .ie n .IP \(bu 4
27 .el .IP \(bu 2
28 ..
29 .de NS
30 .ie n .sp
31 .el .sp .5
32 .ie n .in +4
33 .el .in +2
34 .nf
35 .ft \*(CW
36 ..
37 .de NE
38 .fi
39 .ft R
40 .ie n .in -4
41 .el .in -2
42 ..
43 .\" **************************************************************************
44 .SH NAME
45 lynx \-
46 a general purpose distributed information browser for the World Wide Web
47 .SH SYNOPSIS
48 .B lynx \fI[options] [optional paths or URLs]
49 .sp
50 .B lynx \fI[options] [path or URL]\fP \fB\-get_data
51 .br
52 .I data
53 .br
54 .B \-\-
55 .sp
56 .B lynx \fI[options] [path or URL]\fP \fB\-post_data
57 .br
58 .I data
59 .br
60 .B \-\-
61 .PP
62 Use \*(``lynx \-help\*('' to display a complete list of current options.
63 .SH DESCRIPTION
64 .hy 0
65 .I
66 Lynx
67 is a fully-featured World Wide Web (WWW) client for users
68 running cursor-addressable, character-cell display devices
69 (e.g., vt100 terminals,
70 vt100 emulators running on Windows or any POSIX platform,
71 or any other \*(``curses-oriented\*('' display).
72 It will display hypertext
73 markup language (HTML) documents containing links to
74 files residing on the local system, as well as files residing on
75 remote systems running Gopher, HTTP, FTP, WAIS, and NNTP servers.
76 .PP
77 .I
78 Lynx
79 has been ported to many systems,
80 including all variants of Unix,
81 Windows (since Windows 95),
82 DOS DJGPP and OS/2,
83 as well as VMS and OS/390.
84 .PP
85 .I
86 Lynx
87 can be used to access information on the World Wide Web, or
88 to build information systems intended primarily for local access.
89 For example,
90 .I
91 Lynx
92 has been used to build several Campus Wide
93 Information Systems (CWIS).
94 In addition,
95 .I
96 Lynx
97 can be used to
98 build systems isolated within a single LAN.
99 .SH OPTIONS
100 At start up, \fILynx\fR will load any local
101 file or remote URL specified at the command line.
102 For help with URLs, press \*(``\fB?\fR\*(''
103 or \*(``\fBH\fR\*('' while running \fILynx\fR.
104 Then follow the link titled, \*(``Help on URLs.\*(''
105 .PP
106 If more than one local file or remote URL is listed on the command line,
107 \fILynx\fP will open only the last interactively.
108 All of the names (local files and remote URLs)
109 are added to the \fBG)oto\fP history.
110 .PP
111 \fILynx\fR uses only long option names.
112 Option names can begin with double dash \*(``\-\-\*('' as well,
113 underscores and dashes can be intermixed in
114 option names (in the reference below, options
115 are shown
116 with one dash \*(``\-\*('' before them, and
117 with underscores \*(``_\*('').
118 .PP
119 \fILynx\fR provides many command-line options.
120 Some options require a value (string, number or keyword).
121 These are noted in the reference below.
122 The other options set boolean values in the program.
123 There are three types of boolean options: set, unset and toggle.
124 If no option value is given, these have the obvious meaning:
125 set (to true), unset (to false), or toggle (between true/false).
126 For any of these, an explicit value can be given in different
127 forms to allow for operating system constraints,
128 e.g.,
129 .NS
130 \fB\-center:off\fP
131 \fB\-center=off\fP
132 \fB\-center\-\fP
133 .NE
134 .PP
135 \fILynx\fR recognizes
136 \*(``1\*('', \*(``+\*('', \*(``on\*('' and \*(``true\*('' for true values, and
137 \*(``0\*('', \*(``\-\*('', \*(``off\*('' and \*(``false\*('' for false values.
138 Other option-values are ignored.
139 .PP
140 The default boolean, number and string option values that are compiled
141 into \fILynx\fP are displayed in the help-message provided by \fBlynx \-help\fP.
142 Some of those may differ according to how \fILynx\fP was built;
143 see the help message itself for these values.
144 The \fB\-help\fP option is processed in the third pass of options-processing,
145 so any option which sets a value,
146 as well as runtime configuration values are reflected in the help-message.
147 .TP 7
148 .B \-
149 If the argument is only \*(``\-\*('', then \fILynx\fP expects to receive
150 the arguments from the standard input.
151 This is to allow for the
152 potentially very long command line that can be associated
153 with the \fB\-get_data\fR or \fB\-post_data\fR arguments (see below).
154 It can also be used to avoid having sensitive information
155 in the invoking command line (which would be visible to
156 other processes on most systems), especially when
157 the \fB\-auth\fR or \fB\-pauth\fR options are used.
158 .TP
159 .B \-accept_all_cookies
160 accept all cookies without prompting if Set-Cookie handling is on.
161 The default is \*(``off\*(''.
162 .TP
163 .B \-anonymous
164 apply restrictions for anonymous account, see also \fB\-restrictions\fR.
165 .TP
166 .B \-assume_charset\fR=\fIMIMEname
167 charset for documents that do not specify it.
168 .TP
169 .B \-assume_local_charset\fR=\fIMIMEname
170 charset assumed for local files,
171 i.e., files which \fILynx\fP creates such as
172 internal pages for the options menu.
173 .TP
174 .B \-assume_unrec_charset\fR=\fIMIMEname
175 use this instead of unrecognized charsets.
176 .TP
177 .B \-auth\fR=\fIID\fR:\fIPASSWD
178 set authorization ID and password for protected documents at startup.
179 Be sure to protect any script files which use
180 this switch.
181 .TP
182 .B \-base
183 prepend a request URL comment and BASE tag to text/html
184 outputs for \fB\-source\fR dumps.
185 .TP
186 .B \-bibhost\fR=\fIURL
187 specify a local bibp server (default http://bibhost/).
188 .TP
189 .B \-blink
190 forces high intensity background colors for color mode, if available
191 and supported by the terminal.
192 This applies to the \fBslang\fR library (for a few terminal emulators),
193 or to OS/2 EMX with \fBncurses\fR.
194 .TP
195 .B \-book
196 use the bookmark page as the startfile.
197 The default or command
198 line startfile is still set for the Main screen command, and will
199 be used if the bookmark page is unavailable or blank.
200 The default is \*(``off\*(''.
201 .TP
202 .B \-buried_news
203 toggles scanning of news articles for buried references, and
204 converts them to news links.
205 Not recommended because email
206 addresses enclosed in angle brackets will be converted to
207 false news links, and uuencoded messages can be trashed.
208 The default is \*(``on\*(''.
209 .TP
210 .B \-cache\fR=\fINUMBER
211 set the NUMBER of documents cached in memory.
212 The default is 10.
213 .TP
214 .B \-case
215 enable case-sensitive string searching.
216 The default is \*(``off\*(''.
217 .TP
218 .B \-center
219 toggles center alignment in HTML TABLE.
220 Normally table cells are centered on the table grid.
221 Set this option \*(``on\*('' to disable centering.
222 The default is \*(``off\*(''.
223 .TP
224 .B \-cfg\fR=\fIFILENAME
225 specifies a \fILynx\fP configuration file other than the default
226 lynx.cfg.
227 .TP
228 .B \-child
229 exit on left-arrow in startfile, and disable save to disk and associated
230 print/mail options.
231 The default is \*(``off\*(''.
232 .TP
233 .B \-child_relaxed
234 exit on left-arrow in startfile, but allow save to disk and associated
235 print/mail options.
236 The default is \*(``off\*(''.
237 .TP
238 .B \-cmd_log\fR=\fIFILENAME
239 write keystroke commands and related information to the specified file.
240 .TP
241 .B \-cmd_script\fR=\fIFILENAME
242 read keystroke commands from the specified file.
243 You can use the data written using the \fB\-cmd_log\fR option.
244 \fILynx\fP will ignore other information which the command-logging may have
245 written to the logfile.
246 Each line of the command script contains either
247 a comment beginning with \*(``#\*('',
248 or a keyword:
249 .RS
250 .TP 3
251 .B exit
252 causes the script to stop, and forces \fILynx\fP to exit immediately.
253 .TP
254 .B key
255 the character value, in printable form.
256 Cursor and other special keys are given as names, e.g., \*(``Down Arrow\*(''.
257 Printable 7-bit ASCII codes are given as-is,
258 and hexadecimal values represent other 8-bit codes.
259 .TP
260 .B set
261 followed by a \*(``name=value\*('' allows one to override values set in the
262 lynx.cfg or \&.lynxrc files.
263 \fILynx\fP tries the cfg-file setting first.
264 .RE
265 .TP
266 .B \-collapse_br_tags
267 toggles collapsing of BR tags.
268 The default is \*(``off\*(''.
269 .TP
270 .B \-color
271 forces color mode on, if available.
272 Default color control sequences
273 which work for many terminal types are assumed if the terminal
274 capability description does not specify how to handle color.
275 \fILynx\fP accepts this flag only when built with the \fBslang\fR library.
276 It is equivalent to setting the \fBCOLORTERM\fR environment variable.
277 .IP
278 If color support is provided by a color-capable curses
279 library such as \fBncurses\fR, \fILynx\fP relies completely on the terminal
280 description to determine whether color mode is possible, and
281 this flag is not needed and thus unavailable.
282 .IP
283 A saved show_color=always setting found in a \&.lynxrc file at
284 startup has the same effect.
285 A saved show_color=never found
286 in \&.lynxrc on startup is overridden by this flag.
287 .TP
288 .B \-connect_timeout\fR=\fIN
289 Sets the connection timeout, where \fIN\fP is given in seconds.
290 The default is 300.
291 .TP
292 .B \-convert_to\fR=\fIPARAM
293 convert input, setting output format in MIME type notation
294 (e.g., \fIwww/present\fP, \fIwww/source\fP),
295 and optionally setting the current character set
296 (i.e., adding \*(``;\*('' followed by \fBcharset=\fIVALUE\fP).
297 .TP
298 .B \-cookie_file\fR=\fIFILENAME
299 specifies a file to use to read cookies.
300 If none is specified, the default value is \s+3~\s-3/.lynx_cookies
301 for most systems, but \s+3~\s-3/cookies for MS-DOS.
302 .TP
303 .B \-cookie_save_file\fR=\fIFILENAME
304 specifies a file to use to store cookies.
305 If none is specified, the value given by
306 \fB\-cookie_file\fR is used.
307 .TP
308 .B \-cookies
309 toggles handling of Set-Cookie headers.
310 The default is \*(``on\*(''.
311 .TP
312 .B \-core
313 toggles forced core dumps on fatal errors.
314 Turn this option off to ask \fILynx\fP to force
315 a core dump if a fatal error occurs.
316 The default is \*(``off\*(''.
317 .TP
318 .B \-crawl
319 with \fB\-traversal,\fR output each page to a file.
320 with \fB\-dump\fR, format output as with \fB\-traversal\fR,
321 but to the standard output.
322 .TP
323 .B \-curses_pads
324 toggles the use of curses \*(``pad\*('' feature which supports
325 left/right scrolling of the display.
326 The default is \*(``on\*(''.
327 .IP
328 The feature is normally available for curses configurations,
329 but inactive.
330 To activate it, use the \*(``|\*('' character or the LINEWRAP_TOGGLE command.
331 Toggling this option makes the feature altogether unavailable.
332 .TP
333 .B \-debug_partial
334 separate incremental display stages with \fIMessageSecs\fP delay
335 The default is \*(``off\*(''.
336 .TP
337 .B \-default_colors
338 toggles the default-colors feature which is normally set in the lynx.cfg file.
339 The default is \*(``on\*(''.
340 .TP
341 .B \-delay
342 add \fIDebugSecs\fP delay after each progress-message.
343 The default is 0.
344 .TP
345 .B \-display\fR=\fIDISPLAY
346 set the $DISPLAY variable for X exec-ed programs.
347 .TP
348 .B \-display_charset\fR=\fIMIMEname
349 set the charset for the terminal output.
350 .TP
351 .B \-dont_wrap_pre
352 inhibit wrapping of text when \fB\-dump\fR'ing and \fB\-crawl\fR'ing,
353 mark wrapped lines of <pre> in interactive session.
354 The default is \*(``off\*(''.
355 .TP
356 .B \-dump
357 dumps the formatted output of the default document or those
358 specified on the command line to standard output.
359 Unlike interactive mode, all documents are processed.
360 This can be used in the following way:
361 .NS
362 lynx \fB\-dump\fR https://lynx.invisible-island.net/
363 .NE
364 .IP
365 Files specified on the command line are formatted as HTML if
366 their names end with one of the standard web suffixes such
367 as \*(``.htm\*('' or \*(``.html\*(''.
368 Use the \fB\-force_html\fP option to format files whose names do not follow
369 this convention.
370 .TP
371 .B \-editor\fR=\fIEDITOR
372 enable external editing, using the specified
373 EDITOR.
374 (vi, ed, emacs, etc.)
375 .TP
376 .B \-emacskeys
377 enable emacs-like key movement.
378 The default is \*(``off\*(''.
379 .TP
380 .B \-enable_scrollback
381 toggles compatibility with communication programs' scrollback keys
382 (may be incompatible with some curses packages).
383 The default is \*(``off\*(''.
384 .TP
385 .B \-error_file\fR=\fIFILE
386 define a file where \fILynx\fP will report HTTP access codes.
387 .TP
388 .B \-exec
389 enable local program execution (normally not configured).
390 .TP
391 .B \-fileversions
392 include all versions of files in local VMS directory listings.
393 .TP
394 .B \-find_leaks
395 toggle memory leak-checking.
396 Normally this is not compiled-into your executable, but when it is,
397 it can be disabled for a session.
398 .TP
399 .B \-fail_on_alert
400 exit with an error code if any alert message is written.
401 The default is \*(``off\*(''.
402 .TP
403 .B \-force_empty_hrefless_a
404 force HREF-less \*(``A\*('' elements to be empty
405 (close them as soon as they are seen).
406 The default is \*(``off\*(''.
407 .TP
408 .B \-force_html
409 forces the first document to be interpreted as HTML.
410 The default is \*(``off\*(''.
411 .IP
412 This option is most useful when processing files specified on the command line
413 which have an unrecognized suffix (or the suffix is associated with a
414 non-HTML type, such as \*(``.txt\*('' for plain text files).
415 .IP
416 \fILynx\fP recognizes these file suffixes as HTML:
417 .NS
418 \*(``.ht3\*('',
419 \*(``.htm\*('',
420 \*(``.html3\*('',
421 \*(``.html\*('',
422 \*(``.htmlx\*('',
423 \*(``.php3\*('',
424 \*(``.php\*('',
425 \*(``.phtml\*('',
426 \*(``.sht\*('', and
427 \*(``.shtml\*(''.
428 .NE
429 .TP
430 .B \-force_secure
431 toggles forcing of the secure flag for SSL cookies.
432 The default is \*(``off\*(''.
433 .TP
434 .B \-forms_options
435 toggles whether the Options Menu is key-based or form-based.
436 The default is \*(``on\*(''.
437 .TP
438 .B \-from
439 toggles transmissions of \fIFrom\fP headers.
440 The default is \*(``on\*(''.
441 .TP
442 .B \-ftp
443 disable ftp access.
444 The default is \*(``off\*(''.
445 .TP
446 .B \-get_data
447 properly formatted data for a \fIget\fP form are read from
448 the standard input and passed to the form.
449 Input is terminated by a line that starts with \*(``\-\-\-\*(''.
450 .IP
451 \fILynx\fP issues an HTTP \fBGET\fP,
452 sending the form to the path or URL given on the
453 command-line and prints the response of the server.
454 If no path or URL is given, \fILynx\fP sends the form to the start-page.
455 .TP
456 .B \-head
457 send a HEAD request for the mime headers.
458 The default is \*(``off\*(''.
459 .TP
460 .B \-help
461 print the \fILynx\fP command syntax usage message, and exit.
462 .TP
463 .B \-hiddenlinks=[option]
464 control the display of hidden links.
465 .RS
466 .TP 3
467 .B merge
468 hidden links show up as bracketed numbers
469 and are numbered together with other links in the sequence of their
470 occurrence in the document.
471 .TP
472 .B listonly
473 hidden links are shown only on \fBL)ist\fP screens and listings generated by
474 .B \-dump
475 or from the \fBP)rint\fP menu, but appear separately at the end of those lists.
476 This is the default behavior.
477 .TP
478 .B ignore
479 hidden links do not appear even in listings.
480 .RE
481 .TP
482 .B \-historical
483 toggles use of \*(``>\*('' or \*(``\-\->\*('' as a terminator for comments.
484 The default is \*(``off\*(''.
485 .TP
486 .B \-homepage\fR=\fIURL
487 set homepage separate from start page.
488 .TP
489 .B \-html5_charset
490 toggles use of HTML5 charset replacements.
491 HTML5 pretends that CP1252 is the same as ISO-8859-1.
492 The default is \*(``off\*(''.
493 .TP
494 .B \-image_links
495 toggles inclusion of links for all images.
496 The default is \*(``off\*(''.
497 .TP
498 .B \-index\fR=\fIURL
499 set the default index file to the specified URL.
500 .TP
501 .B \-ismap
502 toggles inclusion of ISMAP links when client-side
503 MAPs are present.
504 The default is \*(``off\*(''.
505 .TP
506 .B \-justify
507 do justification of text.
508 The default is \*(``off\*(''.
509 .TP
510 .B \-link\fR=\fINUMBER
511 starting count for lnk#.dat files produced by \fB\-crawl\fR.
512 The default is 0.
513 .TP
514 .B \-list_decoded
515 for \fB\-dump\fR, show URL-encoded links decoded.
516 The default is \*(``on\*(''.
517 .IP
518 \fILynx\fP accepts URL-encoded links on the command line,
519 and decodes them for internal use.
520 When printing URLs, it shows them in encoded form by default.
521 Use this option to disable that printed encoding.
522 .TP
523 .B \-list_inline
524 for \fB\-dump\fR, show the links inline with the text.
525 The default is \*(``off\*(''.
526 .TP
527 .B \-listonly
528 for \fB\-dump\fR, show only the list of links.
529 The default is \*(``off\*(''.
530 .TP
531 .B \-localhost
532 disable URLs that point to remote hosts.
533 The default is \*(``off\*(''.
534 .TP
535 .B \-locexec
536 enable local program execution from local files only (if
537 \fILynx\fP was compiled with local execution enabled).
538 The default is \*(``off\*(''.
539 .TP
540 .B \-lss\fR=\fIFILENAME
541 specify filename containing color-style information.
542 The default is lynx.lss.
543 If you give an empty filename, \fILynx\fP uses a built-in monochrome
544 scheme which imitates the non-color-style configuration.
545 .TP
546 .B \-mime_header
547 prints the MIME header of a fetched document along with its source.
548 .TP
549 .B \-minimal
550 toggles minimal versus valid comment parsing.
551 The default is \*(``on\*(''.
552 .TP
553 .B \-nested_tables
554 toggles nested-tables logic (for debugging).
555 The default is \*(``on\*(''.
556 .TP
557 .B \-newschunksize\fR=\fINUMBER
558 number of articles in chunked news listings.
559 .TP
560 .B \-newsmaxchunk\fR=\fINUMBER
561 maximum news articles in listings before chunking.
562 .TP
563 .B \-nobold
564 disable bold video-attribute.
565 .TP
566 .B \-nobrowse
567 disable directory browsing.
568 .TP
569 .B \-nocc
570 disable Cc: prompts for self copies of mailings.
571 Note that this does not disable any CCs which are incorporated
572 within a mailto URL or form ACTION.
573 .TP
574 .B \-nocolor
575 force color mode off, overriding terminal capabilities and any
576 \-color flags, COLORTERM variable, and saved \&.lynxrc settings.
577 .TP
578 .B \-noexec
579 disable local program execution.
580 The default is \*(``on\*(''.
581 .TP
582 .B \-nofilereferer
583 disable transmissions of Referer headers for file URLs.
584 The default is \*(``on\*(''.
585 .TP
586 .B \-nolist
587 disable the link list feature in dumps.
588 The default is \*(``off\*(''.
589 .TP
590 .B \-nolog
591 disable mailing of error messages to document owners.
592 The default is \*(``on\*(''.
593 .TP
594 .B \-nomargins
595 disable left/right margins in the default style sheet.
596 The default is \*(``off\*(''.
597 .TP
598 .B \-nomore
599 disable \-more\- string in statusline messages.
600 .TP
601 .B \-nonrestarting_sigwinch
602 This flag is not available on all systems,
603 \fILynx\fP needs to be compiled with HAVE_SIGACTION defined.
604 If available, this flag \fImay\fR cause \fILynx\fP to react
605 more immediately to window changes when run within
606 an \fBxterm\fR.
607 The default is \*(``off\*(''.
608 .TP
609 .B \-nonumbers
610 disable link- and field-numbering.
611 This overrides \fB\-number_fields\fR and \fB\-number_links\fR.
612 The default is \*(``off\*(''.
613 .TP
614 .B \-nopause
615 disable forced pauses for statusline messages.
616 The default is \*(``off\*(''.
617 .TP
618 .B \-noprint
619 disable most print functions.
620 The default is \*(``off\*(''.
621 .TP
622 .B \-noredir
623 prevents automatic redirection and prints a message with a
624 link to the new URL.
625 The default is \*(``off\*(''.
626 .TP
627 .B \-noreferer
628 disable transmissions of Referer headers.
629 The default is \*(``off\*(''.
630 .TP
631 .B \-noreverse
632 disable reverse video-attribute.
633 .TP
634 .B \-nosocks
635 disable SOCKS proxy usage by a SOCKSified \fILynx\fP.
636 .TP
637 .B \-nostatus
638 disable the retrieval status messages.
639 The default is \*(``off\*(''.
640 .TP
641 .B \-notitle
642 disable title and blank line from top of page.
643 The default is \*(``off\*(''.
644 .TP
645 .B \-nounderline
646 disable underline video-attribute.
647 .TP
648 .B \-nozap\fR=\fIDURATION
649 disables checks for \*(``z\*('' key initially
650 if \fIDURATION\fP is \*(``initially\*(''
651 or completely otherwise.
652 .TP
653 .B \-number_fields
654 force numbering of links as well as form input fields
655 The default is \*(``off\*(''.
656 .TP
657 .B \-number_links
658 force numbering of links.
659 The default is \*(``off\*(''.
660 .TP
661 .B \-partial
662 toggles display partial pages while loading.
663 The default is \*(``on\*(''.
664 .TP
665 .B \-partial_thres\fR=\fINUMBER
666 number of lines to render before repainting display
667 with partial-display logic
668 .TP
669 .B \-passive_ftp
670 toggles passive ftp connections.
671 The default is \*(``on\*(''.
672 .TP
673 .B \-pauth\fR=\fIID\fR:\fIPASSWD
674 set authorization ID and password for a protected proxy server at startup.
675 Be sure to protect any script files which use this switch.
676 .TP
677 .B \-popup
678 toggles handling of single-choice SELECT options via
679 popup windows or as lists of radio buttons.
680 The default is \*(``off\*(''.
681 .TP
682 .B \-post_data
683 properly formatted data for a \fIpost\fP form are read in from
684 the standard input and passed to the form.
685 Input is terminated by a line that starts with \*(``\-\-\-\*(''.
686 .IP
687 \fILynx\fP issues an HTTP \fBPOST\fP,
688 sending the form to the path or URL given on the
689 command-line and prints the response of the server.
690 If no path or URL is given, \fILynx\fP sends the form to the start-page.
691 .TP
692 .B \-preparsed
693 show HTML source preparsed and reformatted when used with \fB\-source\fR
694 or in source view
695 to visualize how lynx behaves with invalid HTML.
696 The default is \*(``off\*(''.
697 .TP
698 .B \-prettysrc
699 show HTML source view with lexical elements and tags in color.
700 The default is \*(``off\*(''.
701 .TP
702 .B \-print
703 enable print functions.
704 (default)
705 This is the opposite of \fB\-noprint\fP.
706 The default is \*(``on\*(''.
707 .TP
708 .B \-pseudo_inlines
709 toggles pseudo-ALTs for inline images with no ALT string.
710 The default is \*(``on\*(''.
711 .TP
712 .B \-raw
713 toggles default setting of 8-bit character translations
714 or CJK mode for the startup character set.
715 The default is \*(``off\*(''.
716 .TP
717 .B \-realm
718 restricts access to URLs in the starting realm.
719 The default is \*(``off\*(''.
720 .TP
721 .B \-read_timeout\fR=\fIN
722 Sets the read-timeout, where \fIN\fP is given in seconds.
723 The default is 18000.
724 .TP
725 .B \-reload
726 flushes the cache on a proxy server
727 (only the first document given on the command-line is affected).
728 The default is \*(``off\*(''.
729 .TP
730 .B \-restrictions\fR=\fI[option][,option][,option]...
731 allows a list of services to be disabled selectively.
732 Dashes and underscores in option names can be intermixed.
733 The following list is printed if no options are specified.
734 .RS
735 .TP 3
736 .B all
737 restricts all options listed below.
738 .TP
739 .B bookmark
740 disallow changing the location of the bookmark
741 file.
742 .TP
743 .B bookmark_exec
744 disallow execution links via the bookmark file.
745 .TP
746 .B change_exec_perms
747 disallow changing the eXecute permission on files
748 (but still allow it for directories) when local file
749 management is enabled.
750 .TP
751 .B default
752 same as command line option \fB\-anonymous\fR.
753 Disables default services for anonymous users.
754 Set to all restricted, except for:
755 .RS
756 .IP
757 .na
758 inside_telnet, outside_telnet,
759 inside_ftp, outside_ftp,
760 inside_rlogin, outside_rlogin,
761 inside_news, outside_news, telnet_port,
762 jump, mail, print, exec, and goto.
763 .ad
764 .RE
765 .IP
766 The settings for these,
767 as well as additional goto restrictions for
768 specific URL schemes that are also applied,
769 are derived from definitions within userdefs.h.
770 .TP
771 .B dired_support
772 disallow local file management.
773 .TP
774 .B disk_save
775 disallow saving to disk in the download and
776 print menus.
777 .TP
778 .B dotfiles
779 disallow access to, or creation of, hidden (dot) files.
780 .TP
781 .B download
782 disallow some downloaders in the download menu (does not
783 imply disk_save restriction).
784 .TP
785 .B editor
786 disallow external editing.
787 .TP
788 .B exec
789 disable execution scripts.
790 .TP
791 .B exec_frozen
792 disallow the user from changing the local
793 execution option.
794 .TP
795 .B externals
796 disallow some \*(``EXTERNAL\*('' configuration lines
797 if support for passing URLs to external
798 applications (with the EXTERN command) is
799 compiled in.
800 .TP
801 .B file_url
802 disallow using \fBG)oto\fP, served links or bookmarks for
803 file: URLs.
804 .TP
805 .B goto
806 disable the \*(``g\*('' (goto) command.
807 .TP
808 .B inside_ftp
809 disallow ftps for people coming from inside your
810 domain (utmp required for selectivity).
811 .TP
812 .B inside_news
813 disallow USENET news posting for people coming
814 from inside your domain (utmp required for selectivity).
815 .TP
816 .B inside_rlogin
817 disallow rlogins for people coming from inside
818 your domain (utmp required for selectivity).
819 .TP
820 .B inside_telnet
821 disallow telnets for people coming from inside
822 your domain (utmp required for selectivity).
823 .TP
824 .B jump
825 disable the \*(``j\*('' (jump) command.
826 .TP
827 .B multibook
828 disallow multiple bookmarks.
829 .TP
830 .B mail
831 disallow mail.
832 .TP
833 .B news_post
834 disallow USENET News posting.
835 .TP
836 .B options_save
837 disallow saving options in \&.lynxrc.
838 .TP
839 .B outside_ftp
840 disallow ftps for people coming from outside your
841 domain (utmp required for selectivity).
842 .TP
843 .B outside_news
844 disallow USENET news reading and posting for people coming
845 from outside your domain (utmp required for selectivity).
846 This restriction applies to
847 \*(``news\*('',
848 \*(``nntp\*('',
849 \*(``newspost\*('', and
850 \*(``newsreply\*('' URLs,
851 but not to \*(``snews\*('', \*(``snewspost\*('',
852 or \*(``snewsreply\*('' in case they are supported.
853 .TP
854 .B outside_rlogin
855 disallow rlogins for people coming from outside
856 your domain (utmp required for selectivity).
857 .TP
858 .B outside_telnet
859 disallow telnets for people coming from
860 outside your domain (utmp required for selectivity).
861 .TP
862 .B print
863 disallow most print options.
864 .TP
865 .B shell
866 disallow shell escapes and lynxexec or lynxprog \fBG)oto\fP's.
867 .TP
868 .B suspend
869 disallow Unix Control-Z suspends with escape to shell.
870 .TP
871 .B telnet_port
872 disallow specifying a port in telnet \fBG)oto\fP's.
873 .TP
874 .B useragent
875 disallow modifications of the User-Agent header.
876 .RE
877 .TP
878 .B \-resubmit_posts
879 toggles forced resubmissions (no-cache) of forms with
880 method POST when the documents they returned are sought
881 with the PREV_DOC command or from the History List.
882 The default is \*(``off\*(''.
883 .TP
884 .B \-rlogin
885 disable recognition of rlogin commands.
886 The default is \*(``off\*(''.
887 .TP
888 .B \-scrollbar
889 toggles showing scrollbar.
890 The default is \*(``off\*(''.
891 .TP
892 .B \-scrollbar_arrow
893 toggles showing arrows at ends of the scrollbar.
894 The default is \*(``on\*(''.
895 .TP
896 .B \-selective
897 require \&.www_browsable files to browse directories.
898 .TP
899 .B \-session\fR=\fIFILENAME
900 resumes from specified file on startup and saves session to that file on exit.
901 .TP
902 .B \-sessionin\fR=\fIFILENAME
903 resumes session from specified file.
904 .TP
905 .B \-sessionout\fR=\fIFILENAME
906 saves session to specified file.
907 .TP
908 .B \-short_url
909 show very long URLs in the status line with \*(``...\*('' to represent the
910 portion which cannot be displayed.
911 The beginning and end of the URL are displayed,
912 rather than suppressing the end.
913 The default is \*(``off\*(''.
914 .TP
915 .B \-show_cfg
916 Print the configuration settings,
917 e.g., as read from \*(``lynx.cfg\*('', and exit.
918 The default is \*(``off\*(''.
919 .TP
920 .B \-show_cursor
921 If enabled the cursor will not be hidden in the right hand
922 corner but will instead be positioned at the start of the
923 currently selected link.
924 Show cursor is the default for systems without FANCY_CURSES capabilities.
925 The default configuration can be changed in userdefs.h or lynx.cfg.
926 The command line switch toggles the default.
927 The default is \*(``on\*(''.
928 .TP
929 .B \-show_rate
930 If enabled the transfer rate is shown in bytes/second.
931 If disabled, no transfer rate is shown.
932 Use lynx.cfg or the options menu to select KB/second and/or ETA.
933 The default is \*(``on\*(''.
934 .TP
935 .B \-socks5_proxy=URL
936 Tells \fIlynx\fP which SOCKS5 proxy to use for connections.
937 Any network traffic,
938 including all DNS resolutions except the one for URL itself,
939 will be redirected through the SOCKS5 proxy.
940 .IP
941 The URL may be given as
942 .NS
943 \*(``proxy.example.com\*('',
944 \*(``proxy.example.com:1080\*('',
945 \*(``192.168.0.1\*('', or
946 \*(``192.168.0.1:1080\*(''
947 .NE
948 .IP
949 (and IPv6 notation if so supported).
950 A SOCKS5 proxy may also be specified via the environment variable
951 .BR SOCKS5_PROXY .
952 This option controls the builtin SOCKS5 support, which is unrelated to
953 the option \fB\-nosocks\fP.
954 .TP
955 .B \-soft_dquotes
956 toggles emulation of the old Netscape and Mosaic bug which
957 treated \*(``>\*('' as a co-terminator for double-quotes and tags.
958 The default is \*(``off\*(''.
959 .TP
960 .B \-source
961 works the same as dump but outputs HTML source instead of
962 formatted text.
963 For example
964 .NS
965 lynx \-source\ .\ >foo.html
966 .NE
967 .IP
968 generates HTML source listing the files in the current directory.
969 Each file is marked by an HREF relative to the parent directory.
970 Add a trailing slash to make the HREF's relative to the current directory:
971 .NS
972 lynx \-source ./ >foo.html
973 .NE
974 .TP
975 .B \-stack_dump
976 disable SIGINT cleanup handler
977 The default is \*(``off\*(''.
978 .TP
979 .B \-startfile_ok
980 allow non-http startfile and homepage with \fB\-validate\fR.
981 The default is \*(``off\*(''.
982 .TP
983 .B \-stderr
984 When dumping a document using \fB\-dump\fR or \fB\-source\fR,
985 \fILynx\fP normally does not display alert (error)
986 messages that you see on the screen in the status line.
987 Use the \fB\-stderr\fR option to tell \fILynx\fP to write these messages
988 to the standard error.
989 The default is \*(``off\*(''.
990 .TP
991 .B \-stdin
992 read the startfile from standard input
993 (UNIX only).
994 The default is \*(``off\*(''.
995 .TP
996 .B \-syslog\fR=\fItext
997 information for syslog call.
998 .TP
999 .B \-syslog_urls
1000 log requested URLs with syslog.
1001 The default is \*(``off\*(''.
1002 .TP
1003 .B \-tagsoup
1004 initialize parser, using Tag Soup DTD rather than SortaSGML.
1005 The default is \*(``off\*(''.
1006 .TP
1007 .B \-telnet
1008 disable recognition of telnet commands.
1009 The default is \*(``off\*(''.
1010 .TP
1011 .B \-term\fR=\fITERM
1012 tell \fILynx\fP what terminal type to assume it is talking to.
1013 (This may be useful for remote execution, when, for example,
1014 \fILynx\fP connects to a remote TCP/IP port that starts a script that,
1015 in turn, starts another \fILynx\fP process.)
1016 .TP
1017 .B \-timeout\fR=\fIN
1018 For win32, sets the network read-timeout, where N is given in seconds.
1019 .TP
1020 .B \-tlog
1021 toggles between using a \fILynx\fP Trace Log and stderr for trace output
1022 from the session.
1023 The default is \*(``on\*(''.
1024 .TP
1025 .B \-tna
1026 turns on \*(``Textfields Need Activation\*('' mode.
1027 The default is \*(``off\*(''.
1028 .TP
1029 .B \-trace
1030 turns on \fILynx\fP trace mode.
1031 Destination of trace output depends
1032 on \fB\-tlog\fP.
1033 The default is \*(``off\*(''.
1034 .TP
1035 .B \-trace_mask\fR=\fIvalue
1036 turn on optional traces, which may result in very large trace files.
1037 Logically OR the values to combine options:
1038 .RS
1039 .TP 3
1040 .B 1
1041 SGML character parsing states
1042 .TP
1043 .B 2
1044 color-style
1045 .TP
1046 .B 4
1047 TRST (table layout)
1048 .TP
1049 .B 8
1050 configuration
1051 (lynx.cfg,
1052 \&.lynxrc,
1053 \&.lynx-keymaps,
1054 mime.types and
1055 mailcap contents)
1056 .TP
1057 .B 16
1058 binary string copy/append, used in form data construction.
1059 .TP
1060 .B 32
1061 cookies
1062 .TP
1063 .B 64
1064 character sets
1065 .TP
1066 .B 128
1067 GridText parsing
1068 .TP
1069 .B 256
1070 timing
1071 .TP
1072 .B 512
1073 detailed URL parsing
1074 .RE
1075 .IP
1076 The default is 0.
1077 .TP
1078 .B \-traversal
1079 traverse all http links derived from startfile.
1080 When used with
1081 \fB\-crawl\fR, each link that begins with the same string as startfile
1082 is output to a file, intended for indexing.
1083 .IP
1084 See CRAWL.announce for more information.
1085 .TP
1086 .B \-trim_blank_lines
1087 toggles trimming of trailing blank lines as well as
1088 the related trimming of blank lines while collapsing BR tags.
1089 The default is \*(``on\*(''.
1090 .TP
1091 .B \-trim_input_fields
1092 trim input text/textarea fields in forms.
1093 The default is \*(``off\*(''.
1094 .TP
1095 .B \-underline_links
1096 toggles use of underline/bold attribute for links.
1097 The default is \*(``off\*(''.
1098 .TP
1099 .B \-underscore
1100 toggles use of _underline_ format in dumps.
1101 The default is \*(``off\*(''.
1102 .TP
1103 .B \-unique_urls
1104 check for duplicate link numbers in
1105 each page and corresponding lists,
1106 and reuse the original link number.
1107 The default is \*(``off\*(''.
1108 .TP
1109 .B \-update_term_title
1110 enables updating the title in terminal emulators.
1111 Use only if your terminal emulator supports that escape code.
1112 Has no effect when used with \fB\-notitle\fP.
1113 The default is \*(``off\*(''.
1114 .TP
1115 .B \-use_mouse
1116 turn on mouse support, if available.
1117 The default is \*(``off\*(''.
1118 .RS
1119 .bP
1120 Clicking the left mouse button on a link traverses it.
1121 .bP
1122 Clicking the right mouse button pops back.
1123 .bP
1124 Click on the top line to scroll up.
1125 .bP
1126 Click on the bottom line to scroll down.
1127 .bP
1128 The first few positions in the top and bottom line may invoke
1129 additional functions.
1130 .RE
1131 .IP
1132 \fILynx\fP must be compiled with
1133 \fBncurses\fR or \fBslang\fR to support this feature.
1134 If \fBncurses\fR is used, clicking the middle mouse button pops up
1135 a simple menu.
1136 Mouse clicks may only work reliably while \fILynx\fP is
1137 idle waiting for input.
1138 .TP
1139 .B \-useragent=Name
1140 set alternate \fILynx\fP User-Agent header.
1141 .TP
1142 .B \-validate
1143 accept only http URLs (for validation).
1144 Complete security restrictions also are implemented.
1145 .TP
1146 .B \-verbose
1147 toggle [LINK], [IMAGE] and [INLINE] comments with filenames of these images.
1148 The default is \*(``off\*(''.
1149 .TP
1150 .B \-version
1151 print version information, and exit.
1152 .TP
1153 .B \-vikeys
1154 enable vi-like key movement.
1155 The default is \*(``off\*(''.
1156 .TP
1157 .B \-wdebug
1158 enable Waterloo tcp/ip packet debug (print to watt debugfile).
1159 This applies only to DOS versions compiled with WATTCP or WATT-32.
1160 .TP
1161 .B \-width\fR=\fINUMBER
1162 number of columns for formatting of dumps, default is 80.
1163 This is limited by the number of columns that \fILynx\fP could display,
1164 typically 1024 (the \fIMAX_LINE\fP symbol).
1165 .TP
1166 .B \-with_backspaces
1167 emit backspaces in output if \fB\-dump\fR'ing or \fB\-crawl\fR'ing
1168 (like \fBman\fP does).
1169 The default is \*(``off\*(''.
1170 .TP
1171 .B \-xhtml_parsing
1172 tells \fILynx\fP that it can ignore certain tags which have no content
1173 in an XHTML 1.0 document.
1174 For example \*(``<p/>\*('' will be discarded.
1175 The default is \*(``off\*(''.
1176 .SH COMMANDS
1177 More than one key can be mapped to a given command.
1178 Here are some of the most useful:
1179 .bP
1180 Use \fBUp arrow\fR and \fBDown arrow\fR to scroll through hypertext links.
1181 .bP
1182 \fBRight arrow\fR or \fBReturn\fR will follow a highlighted hypertext link.
1183 .bP
1184 \fBLeft Arrow\fR or \*(``\fBu\fR\*('' will retreat from a link.
1185 .bP
1186 Type \*(``\fBH\fR\*('', \*(``\fB?\fR\*('', or \fBF1\fR
1187 for online help and descriptions of key-stroke commands.
1188 .bP
1189 Type \*(``\fBk\fR\*('' or \*(``\fBK\fR\*('' for a list of the current key-stroke
1190 command mappings.
1191 .IP
1192 If the same command is mapped to the same letter differing only
1193 by upper/lowercase only the lowercase mapping is shown.
1194 .bP
1195 Type \fBDelete\fR to view history list.
1196 .SH ENVIRONMENT
1197 In addition to various \*(``standard\*('' environment variables such as
1198 \fBDISPLAY\fR,
1199 \fBHOME\fR,
1200 \fBPATH\fR,
1201 \fBSHELL\fR,
1202 \fBTMPDIR\fR,
1203 \fBUSER\fR,
1204 etc.,
1205 \fILynx\fR utilizes several \fILynx\fP-specific environment variables, if they
1206 exist.
1207 .PP
1208 Others may be created or modified by \fILynx\fR to pass data to an external
1209 program, or for other reasons.
1210 These are listed separately below.
1211 .PP
1212 See also the sections on \fBSIMULATED CGI SUPPORT\fR and
1213 \fBNATIVE LANGUAGE SUPPORT\fR, below.
1214 .PP
1215 Note: Not all environment variables apply to all types of platforms
1216 supported by \fILynx\fR, though most do.
1217 Feedback on platform dependencies is solicited.
1218 .PP
1219 Environment Variables Used By \fILynx\fR:
1220 .TP 20
1221 .B COLORTERM
1222 If set, color capability for the terminal is forced on at startup time.
1223 The actual value assigned to the variable is ignored.
1224 This variable is only meaningful if \fILynx\fR was built using the \fBslang\fR
1225 screen-handling library.
1226 .TP
1227 .B LYNX_CFG
1228 This variable, if set, will override the default location and name of
1229 the global configuration file (normally, \fBlynx.cfg\fR) that was defined
1230 by the LYNX_CFG_FILE constant in the userdefs.h file, during installation.
1231 .IP
1232 See the userdefs.h file for more information.
1233 .TP
1234 .B LYNX_CFG_PATH
1235 If set, this variable overrides the compiled-in search-list of directories
1236 used to find the configuration files, e.g., \fBlynx.cfg\fP and \fBlynx.lss\fP.
1237 The list is delimited with ":" (or ";" for Windows) like the \fBPATH\fP
1238 environment variable.
1239 .TP
1240 .B LYNX_HELPFILE
1241 If set, this variable overrides the compiled-in URL and configuration
1242 file URL for the \fILynx\fP help file.
1243 .TP
1244 .B LYNX_LOCALEDIR
1245 If set, this variable overrides the compiled-in location of the
1246 locale directory which contains native language (NLS) message text.
1247 .TP
1248 .B LYNX_LSS
1249 This variable, if set, specifies the location of the default \fILynx\fR
1250 character style sheet file.
1251 [Currently only meaningful if \fILynx\fR was
1252 built using curses color style support.]
1253 .TP
1254 .B LYNX_SAVE_SPACE
1255 This variable, if set, will override the default path prefix for files
1256 saved to disk that is defined in the \fBlynx.cfg SAVE_SPACE:\fR statement.
1257 .IP
1258 See the \fBlynx.cfg\fR file for more information.
1259 .TP
1260 .B LYNX_TEMP_SPACE
1261 This variable, if set, will override the default path prefix for temporary
1262 files that was defined during installation, as well as any value that may
1263 be assigned to the \fBTMPDIR\fR variable.
1264 .TP
1265 .B MAIL
1266 This variable specifies the default inbox \fILynx\fR will check for new
1267 mail, if such checking is enabled in the \fBlynx.cfg\fR file.
1268 .TP
1269 .B NEWS_ORGANIZATION
1270 This variable, if set, provides the string used in the \fBOrganization:\fR
1271 header of \fBUSENET\fR news postings.
1272 It will override the setting of the
1273 ORGANIZATION environment variable, if it is also set (and, on \fBUNIX\fR,
1274 the contents of an /etc/organization file, if present).
1275 .TP
1276 .B NNTPSERVER
1277 If set, this variable specifies the default NNTP server that will be used
1278 for \fBUSENET\fR news reading and posting with \fILynx\fR, via news: URL's.
1279 .TP
1280 .B ORGANIZATION
1281 This variable, if set, provides the string used in the \fBOrganization:\fR
1282 header of \fBUSENET\fR news postings.
1283 On \fBUNIX\fR, it will override the
1284 contents of an /etc/organization file, if present.
1285 .TP
1286 .I PROTOCOL\fB_proxy\fR
1287 \fILynx\fR supports the use of proxy servers that can act as firewall
1288 gateways and caching servers.
1289 They are preferable to the older gateway
1290 servers (see WWW_access_GATEWAY, below).
1291 .IP
1292 Each protocol used by \fILynx\fR,
1293 (http, ftp, gopher, etc), can be mapped separately by setting environment
1294 variables of the form \fIPROTOCOL\fP_proxy.
1295 Protocols are indicated in a URI by the name before \*(``:\*('', e.g.,
1296 \*(``http\*('' in
1297 \*(``http://some.server.dom:port/\*('' for HTML.
1298 .IP
1299 Depending on your system configuration and supported protocols,
1300 the environment variables recognized by \fIlynx\fP may include
1301 .NS
1302 cso_proxy
1303 finger_proxy
1304 ftp_proxy
1305 gopher_proxy
1306 http_proxy
1307 https_proxy
1308 news_proxy
1309 newspost_proxy
1310 newsreply_proxy
1311 nntp_proxy
1312 no_proxy
1313 rlogin_proxy
1314 snews_proxy
1315 snewspost_proxy
1316 snewsreply_proxy
1317 telnet_proxy
1318 tn3270_proxy
1319 wais_proxy
1320 .NE
1321 .IP
1322 See \fBLynx Users Guide\fR for additional details and examples.
1323 .TP
1324 .B RL_CLCOPY_CMD
1325 Pipe the contents of the current link using this command as the target.
1326 .TP
1327 .B RL_PASTE_CMD
1328 Open a pipe to read from this command,
1329 pasting it into the current editable-field or command-prompt.
1330 .TP
1331 .B SOCKS5_PROXY
1332 Is inspected if
1333 .B \-socks5_proxy
1334 has not been used (for the same content).
1335 .TP
1336 .B SSL_CERT_DIR
1337 Set to the directory containing trusted certificates.
1338 .TP
1339 .B SSL_CERT_FILE
1340 Set to the full path and filename for your file of trusted certificates.
1341 .TP
1342 .B WWW_\fIaccess\fB_GATEWAY
1343 \fILynx\fR still supports use of gateway servers, with the servers specified
1344 via \*(``WWW_\fIaccess\fP_GATEWAY\*('' variables
1345 (where \*(``\fIaccess\fP\*('' is lower case and can be
1346 \*(``http\*('', \*(``ftp\*('', \*(``gopher\*('' or \*(``wais\*('').
1347 However most gateway servers have been discontinued.
1348 Note that you do not include a terminal \*(``/\*('' for gateways, but
1349 do for proxies specified by \fIPROTOCOL\fP_proxy environment variables.
1350 .IP
1351 See \fBLynx Users Guide\fR for details.
1352 .TP
1353 .B WWW_HOME
1354 This variable, if set, will override the default startup URL specified
1355 in any of the \fILynx\fR configuration files.
1356 .PP
1357 Environment Variables \fBSet\fR or \fBModified\fR By \fILynx\fR:
1358 .TP 20
1359 .B LYNX_PRINT_DATE
1360 This variable is set by the \fILynx\fR p(rint) function, to the
1361 \fBDate:\fR
1362 string seen in the document's \*(``\fBInformation about\fR\*('' page (= cmd),
1363 if any.
1364 It is created for use by an external program, as defined in a
1365 \fBlynx.cfg PRINTER:\fR definition statement.
1366 If the field does not exist for the document, the variable is set to a
1367 null string under \fBUNIX\fR, or \*(``No Date\*('' under \fBVMS\fR.
1368 .TP
1369 .B LYNX_PRINT_LASTMOD
1370 This variable is set by the \fILynx\fR p(rint) function, to the
1371 \fBLast Mod:\fR
1372 string seen in the document's \*(``\fBInformation about\fR\*('' page (= cmd),
1373 if any.
1374 It is created for use by an external program, as defined in a
1375 \fBlynx.cfg PRINTER:\fR definition statement.
1376 If the field does not exist for the document, the variable is set to a
1377 null string under \fBUNIX\fR, or \*(``No LastMod\*('' under \fBVMS\fR.
1378 .TP
1379 .B LYNX_PRINT_TITLE
1380 This variable is set by the \fILynx\fR p(rint) function, to the
1381 \fBLinkname:\fR
1382 string seen in the document's \*(``\fBInformation about\fR\*('' page (= cmd),
1383 if any.
1384 It is created for use by an external program, as defined in a
1385 \fBlynx.cfg PRINTER:\fR definition statement.
1386 If the field does not exist for the document, the variable is set to a
1387 null string under \fBUNIX\fR, or \*(``No Title\*('' under \fBVMS\fR.
1388 .TP
1389 .B LYNX_PRINT_URL
1390 This variable is set by the \fILynx\fR p(rint) function, to the
1391 \fBURL:\fR
1392 string seen in the document's \*(``\fBInformation about\fR\*('' page (= cmd),
1393 if any.
1394 It is created for use by an external program, as defined in a
1395 \fBlynx.cfg PRINTER:\fR definition statement.
1396 If the field does not exist for the document, the variable is set to a
1397 null string under \fBUNIX\fR, or \*(``No URL\*('' under \fBVMS\fR.
1398 .TP
1399 .B LYNX_TRACE
1400 If set, causes \fILynx\fR to write a trace file as if the \fB\-trace\fR
1401 option were supplied.
1402 .TP
1403 .B LYNX_TRACE_FILE
1404 If set, overrides the compiled-in name of the trace file,
1405 which is either \fBLynx.trace\fP or \fBLY\-TRACE.LOG\fP
1406 (the latter on the DOS/Windows platforms).
1407 The trace file is in either case relative to the home directory.
1408 .TP
1409 .B LYNX_VERSION
1410 This variable is always set by \fILynx\fR, and may be used by an external
1411 program to determine if it was invoked by \fILynx\fR.
1412 .IP
1413 See also the comments
1414 in the distribution's sample \fBmailcap\fR file, for notes on usage in such
1415 a file.
1416 .TP
1417 .B TERM
1418 Normally, this variable is used by \fILynx\fR to determine the terminal type
1419 being used to invoke \fILynx\fR.
1420 If, however, it is unset at startup time
1421 (or has the value \*(``unknown\*(''),
1422 or if the \fB\-term\fR command-line option is used (see \fBOPTIONS\fR section
1423 above), \fILynx\fR will set or modify its value to the user specified
1424 terminal type (for the \fILynx\fR execution environment).
1425 Note: If set/modified by \fILynx\fR, the values of the \fBLINES\fR and/or
1426 \fBCOLUMNS\fR environment variables may also be changed.
1427 .SS "Simulated CGI Support"
1428 If built with the \fBcgi-links\fR option enabled, \fILynx\fR allows access
1429 to a cgi script directly without the need for an http daemon.
1430 .PP
1431 When executing such \*(``lynxcgi scripts\*('' (if enabled),
1432 the following variables may be set for simulating a CGI environment:
1433 .PP
1434 .B CONTENT_LENGTH
1435 .PP
1436 .B CONTENT_TYPE
1437 .PP
1438 .B DOCUMENT_ROOT
1439 .PP
1440 .B HTTP_ACCEPT_CHARSET
1441 .PP
1442 .B HTTP_ACCEPT_LANGUAGE
1443 .PP
1444 .B HTTP_USER_AGENT
1445 .PP
1446 .B PATH_INFO
1447 .PP
1448 .B PATH_TRANSLATED
1449 .PP
1450 .B QUERY_STRING
1451 .PP
1452 .B REMOTE_ADDR
1453 .PP
1454 .B REMOTE_HOST
1455 .PP
1456 .B REQUEST_METHOD
1457 .PP
1458 .B SERVER_SOFTWARE
1459 .PP
1460 Other environment variables are not inherited by the script, unless they
1461 are provided via a LYNXCGI_ENVIRONMENT statement in the configuration file.
1462 See the \fBlynx.cfg\fR file, and the (draft) CGI 1.1 Specification
1463 <http://Web.Golux.Com/coar/cgi/draft\-coar\-cgi\-v11\-00.txt> for the
1464 definition and usage of these variables.
1465 .PP
1466 The CGI Specification, and other associated documentation, should be consulted
1467 for general information on CGI script programming.
1468 .SS "Native Language Support"
1469 If configured and installed with \fBNative Language Support\fR, \fILynx\fR
1470 will display status and other messages in your local language.
1471 See the
1472 file \fBABOUT_NLS\fR in the source distribution, or at your local \fBGNU\fR
1473 site, for more information about internationalization.
1474 .PP
1475 The following environment variables may be used to alter default settings:
1476 .TP 20
1477 .B LANG
1478 This variable, if set, will override the default message language.
1479 It is an \fBISO 639\fR two-letter code identifying the language.
1480 Language codes are \fBNOT\fR the same
1481 as the country codes given in \fBISO 3166\fR.
1482 .TP
1483 .B LANGUAGE
1484 This variable, if set, will override the default message language.
1485 This is a \fBGNU\fR extension that has higher priority for setting
1486 the message catalog than \fBLANG\fR or \fBLC_ALL\fR.
1487 .TP
1488 .B LC_ALL
1489 and
1490 .TP
1491 .B LC_MESSAGES
1492 These variables, if set, specify the notion of native language
1493 formatting style.
1494 They are \fBPOSIXly\fR correct.
1495 .TP
1496 .B LINGUAS
1497 This variable, if set prior to configuration, limits the installed
1498 languages to specific values.
1499 It is a space-separated list of two-letter codes.
1500 Currently, it is hard-coded to a wish list.
1501 .TP
1502 .B NLSPATH
1503 This variable, if set, is used as the path prefix for message catalogs.
1504 .SH NOTES
1505 .SS "Mailing Lists"
1506 If you wish to contribute to the further development
1507 of \fILynx\fR, subscribe to our mailing list.
1508 Send email to
1509 <lynx\-dev\[email protected]>
1510 with \*(``subscribe lynx\-dev\*('' as the only line
1511 in the body of your message.
1512 .PP
1513 Send bug reports, comments, suggestions to <lynx\[email protected]>
1514 after subscribing.
1515 .PP
1516 Unsubscribe by sending email to <lynx\-dev\[email protected]> with
1517 \*(``unsubscribe lynx\-dev\*('' as the only line in the body of your message.
1518 Do not send the unsubscribe message to the lynx\-dev list, itself.
1519 .SS Acknowledgments
1520 \fILynx\fP has incorporated code from a variety of sources along the way.
1521 The earliest versions of \fILynx\fP included code from Earl Fogel of Computing
1522 Services at the University of Saskatchewan, who implemented HYPERREZ
1523 in the Unix environment.
1524 HYPERREZ was developed by Niel Larson of
1525 Think.com and served as the model for the early versions of \fILynx\fP.
1526 Those versions also incorporated libraries from the Unix Gopher clients
1527 developed at the University of Minnesota, and the later versions of
1528 \fILynx\fP rely on the WWW client library code developed by Tim Berners-Lee
1529 and the WWW community.
1530 Also a special thanks to Foteos Macrides who ported
1531 much of \fILynx\fP to VMS and did or organized most of its development since the
1532 departures of Lou Montulli and Garrett Blythe from the University of Kansas
1533 in the summer of 1994 through the release of v2.7.2, and to everyone
1534 on the net who has contributed to \fILynx\fP's development either directly
1535 (through patches, comments or bug reports) or indirectly
1536 (through inspiration and development of other systems).
1537 .SH AUTHORS
1538 Lou Montulli, Garrett Blythe, Craig Lavender, Michael Grobe, Charles Rezac
1539 .br
1540 Academic Computing Services
1541 .br
1542 University of Kansas
1543 .br
1544 Lawrence, Kansas 66047
1545 .PP
1546 Foteos Macrides
1547 .br
1548 Worcester Foundation for Biomedical Research
1549 .br
1550 Shrewsbury, Massachusetts 01545
1551 .PP
1552 Thomas E.\& Dickey
1553 .br
1554 <dickey@invisible\-island.net>
1555 .SH SEE ALSO
1556 \fB\%catgets\fR(3),
1557 \fB\%curses\fR(3),
1558 \fB\%environ\fR(7),
1559 \fB\%ftp\fR(1),
1560 \fB\%gettext\fR(GNU),
1561 \fB\%localeconv\fR(3),
1562 \fB\%ncurses\fR(3),
1563 \fB\%setlocale\fR(3),
1564 \fB\%termcap\fR(5),
1565 \fB\%terminfo\fR(5)