1LYNX(1)                     General Commands Manual                    LYNX(1)
2
3
4

NAME

6       lynx  - a general purpose distributed information browser for the World
7       Wide Web
8

SYNOPSIS

10       lynx [options] [path or URL]
11
12       lynx [options] [path or URL] -get_data
13       data
14       --
15
16       lynx [options] [path or URL] -post_data
17       data
18       --
19
20       Use "lynx -help" to display a complete list of current options.
21

DESCRIPTION

23       Lynx is a fully-featured World Wide Web (WWW) client for users  running
24       cursor-addressable,   character-cell   display   devices  (e.g.,  vt100
25       terminals, vt100 emulators running on Windows 95/NT or Macintoshes,  or
26       any other "curses-oriented" display).  It will display hypertext markup
27       language (HTML) documents containing links to  files  residing  on  the
28       local  system,  as  well  as  files  residing on remote systems running
29       Gopher, HTTP, FTP, WAIS, and NNTP servers.  Current  versions  of  Lynx
30       run on Unix, VMS, Windows 95/NT, 386DOS and OS/2 EMX.
31
32       Lynx  can  be  used  to access information on the World Wide Web, or to
33       build information systems intended primarily  for  local  access.   For
34       example,  Lynx  has  been used to build several Campus Wide Information
35       Systems (CWIS).  In  addition,  Lynx  can  be  used  to  build  systems
36       isolated within a single LAN.
37

OPTIONS

39       At  start  up, Lynx will load any local file or remote URL specified at
40       the command line.  For help with URLs, press "?"  or "H" while  running
41       Lynx.  Then follow the link titled, "Help on URLs."
42
43       If  more  than  one  local  file or remote URL is listed on the command
44       line, Lynx will open only the last interactively.   All  of  the  names
45       (local files and remote URLs) are added to the G)oto history.
46
47       Lynx  uses  only  long option names. Option names can begin with double
48       dash as well, underscores and dashes can be intermixed in option  names
49       (in  the reference below options are with one dash before them and with
50       underscores).
51
52       Lynx provides many command-line options.  Some options require a  value
53       (string,  number  or keyword).  These are noted in the reference below.
54       The other options set boolean values in the program.  There  are  three
55       types of boolean options: set, unset and toggle.  If no option value is
56       given, these have the obvious meaning: set (to true), unset (to false),
57       or  toggle  (between  true/false).  For any of these, an explicit value
58       can  be  given  in  different  forms  to  allow  for  operating  system
59       constraints, e.g.,
60              -center:off
61              -center=off
62              -center-
63       Lynx  recognizes  "1",  "+",  "on" and "true" for true values, and "0",
64       "-", "off" and "false"  for  false  values.   Other  option-values  are
65       ignored.
66
67       The  default boolean, number and string option values that are compiled
68       into Lynx are displayed in the help-message  provided  by  lynx  -help.
69       Some  of those may differ according to how Lynx was built; see the help
70       message itself for these values.  The -help option is processed in  the
71       third  pass of options-processing, so any option which sets a value, as
72       well as runtime configuration values are reflected in the help-message.
73
74       -      If the argument is only '-', then Lynx expects  to  receive  the
75              arguments  from  the  standard  input.  This is to allow for the
76              potentially very long command line that can be  associated  with
77              the  -get_data or -post_data arguments (see below).  It can also
78              be used to avoid having sensitive information  in  the  invoking
79              command  line (which would be visible to other processes on most
80              systems), especially when the -auth or -pauth options are used.
81
82       -accept_all_cookies
83              accept all cookies.
84
85       -anonymous
86              apply   restrictions   for   anonymous   account,    see    also
87              -restrictions.
88
89       -assume_charset=MIMEname
90              charset for documents that don't specify it.
91
92       -assume_local_charset=MIMEname
93              charset  assumed for local files, i.e., files which Lynx creates
94              such as internal pages for the options menu.
95
96       -assume_unrec_charset=MIMEname
97              use this instead of unrecognized charsets.
98
99       -auth=ID:PASSWD
100              set authorization ID and password  for  protected  documents  at
101              startup.   Be  sure  to  protect any script files which use this
102              switch.
103
104       -base  prepend a request URL comment and BASE tag to text/html  outputs
105              for -source dumps.
106
107       -bibhost=URL
108              specify a local bibp server (default http://bibhost/).
109
110       -blink forces  high  intensity  background  colors  for  color mode, if
111              available and supported by the terminal.  This  applies  to  the
112              slang  library  (for  a  few terminal emulators), or to OS/2 EMX
113              with ncurses.
114
115       -book  use the bookmark page as the startfile.  The default or  command
116              line  startfile  is  still  set for the Main screen command, and
117              will be used if the bookmark page is unavailable or blank.
118
119       -buried_news
120              toggles scanning of news articles  for  buried  references,  and
121              converts  them  to  news  links.   Not recommended because email
122              addresses enclosed in angle brackets will be converted to  false
123              news links, and uuencoded messages can be trashed.
124
125       -cache=NUMBER
126              set  the  NUMBER  of documents cached in memory.  The default is
127              10.
128
129       -case  enable case-sensitive string searching.
130
131       -center
132              Toggle center alignment in HTML TABLE.
133
134       -cfg=FILENAME
135              specifies a Lynx  configuration  file  other  than  the  default
136              lynx.cfg.
137
138       -child exit  on  left-arrow  in startfile, and disable save to disk and
139              associated print/mail options.
140
141       -child_relaxed
142              exit on left-arrow in startfile, but  allow  save  to  disk  and
143              associated print/mail options.
144
145       -cmd_log=FILENAME
146              write   keystroke   commands  and  related  information  to  the
147              specified file.
148
149       -cmd_script=FILENAME
150              read keystroke commands from the specified file.   You  can  use
151              the  data  written  using the -cmd_log option.  Lynx will ignore
152              other information which the command-logging may have written  to
153              the  logfile.  Each line of the command script contains either a
154              comment beginning with "#", or a keyword:
155
156              exit
157                 causes  the  script  to  stop,  and  forces  Lynx   to   exit
158                 immediately.
159
160              key
161                 the  character  value,  in  printable form.  Cursor and other
162                 special  keys  are  given  as  names,  e.g.,  "Down   Arrow".
163                 Printable  7-bit ASCII codes are given as-is, and hexadecimal
164                 values represent other 8-bit codes.
165
166              set
167                 followed by a "name=value" allows one to override values  set
168                 in  the  lynx.cfg  or .lynxrc files.  Lynx tries the cfg-file
169                 setting first.
170
171       -color forces color mode  on,  if  available.   Default  color  control
172              sequences  which work for many terminal types are assumed if the
173              terminal capability description does not specify how  to  handle
174              color.   Lynx  needs  to  be compiled with the slang library for
175              this flag, it is equivalent to setting the COLORTERM environment
176              variable.   (If  color  support  is instead provided by a color-
177              capable curses library like ncurses, Lynx relies  completely  on
178              the  terminal  description  to  determine  whether color mode is
179              possible, and this flag is not needed and thus unavailable.)   A
180              saved  show_color=always  setting  found  in  a  .lynxrc file at
181              startup has the same effect.  A saved show_color=never found  in
182              .lynxrc on startup is overridden by this flag.
183
184       -connect_timeout=N
185              Sets the connection timeout, where N is given in seconds.
186
187       -cookie_file=FILENAME
188              specifies  a file to use to read cookies.  If none is specified,
189              the default value  is  ~/.lynx_cookies  for  most  systems,  but
190              ~/cookies for MS-DOS.
191
192       -cookie_save_file=FILENAME
193              specifies a file to use to store cookies.  If none is specified,
194              the value given by -cookie_file is used.
195
196       -cookies
197              toggles handling of Set-Cookie headers.
198
199       -core  toggles forced core dumps on fatal errors.  Turn this option off
200              to ask Lynx to force a core dump if a fatal error occurs.
201
202       -crawl with -traversal, output each page to a file.  with -dump, format
203              output as with -traversal, but to the standard output.
204
205       -curses_pads
206              toggles  the  use  of  curses  "pad"  feature   which   supports
207              left/right  scrolling  of  the display.  The feature is normally
208              available for curses configurations, but inactive.  To  activate
209              it,  use  the  "|"  character  or  the  LINEWRAP_TOGGLE command.
210              Toggling this option makes the feature altogether unavailable.
211
212       -debug_partial
213              separate incremental display stages with MessageSecs delay
214
215       -delay add DebugSecs delay after each progress-message
216
217       -display=DISPLAY
218              set the display variable for X rexec-ed programs.
219
220       -display_charset=MIMEname
221              set the charset for the terminal output.
222
223       -dont_wrap_pre
224              inhibit wrapping of text when  -dump'ing  and  -crawl'ing,  mark
225              wrapped lines of <pre> in interactive session.
226
227       -dump  dumps  the  formatted  output  of  the default document or those
228              specified on  the  command  line  to  standard  output.   Unlike
229              interactive mode, all documents are processed.  This can be used
230              in the following way:
231
232              lynx -dump http://www.subir.com/lynx.html
233
234       -editor=EDITOR
235              enable external editing, using the specified  EDITOR.  (vi,  ed,
236              emacs, etc.)
237
238       -emacskeys
239              enable emacs-like key movement.
240
241       -enable_scrollback
242              toggles  compatibility  with  communication programs' scrollback
243              keys (may be incompatible with some curses packages).
244
245       -error_file=FILE
246              define a file where Lynx will report HTTP access codes.
247
248       -exec  enable local program execution (normally not configured).
249
250       -fileversions
251              include all versions of files in local VMS directory listings.
252
253       -find_leaks
254              toggle memory leak-checking.  Normally this is not compiled-into
255              your  executable,  but  when  it  is,  it  can be disabled for a
256              session.
257
258       -force_empty_hrefless_a
259              force HREF-less 'A' elements to be empty (close them as soon  as
260              they are seen).
261
262       -force_html
263              forces the first document to be interpreted as HTML.
264
265       -force_secure
266              toggles forcing of the secure flag for SSL cookies.
267
268       -forms_options
269              toggles whether the Options Menu is key-based or form-based.
270
271       -from  toggles transmissions of From headers.
272
273       -ftp   disable ftp access.
274
275       -get_data
276              properly  formatted  data  for  a  get form are read in from the
277              standard input and passed to the form.  Input is terminated by a
278              line that starts with '---'.
279
280       -head  send a HEAD request for the mime headers.
281
282       -help  print the Lynx command syntax usage message, and exit.
283
284       -hiddenlinks=[option]
285              control the display of hidden links.
286
287              merge
288                 hidden  links  show  up as bracketed numbers and are numbered
289                 together with other links in the sequence of their occurrence
290                 in the document.
291
292              listonly
293                 hidden  links  are  shown  only on L)ist screens and listings
294                 generated by -dump  or  from  the  P)rint  menu,  but  appear
295                 separately  at  the  end of those lists.  This is the default
296                 behavior.
297
298              ignore
299                 hidden links do not appear even in listings.
300
301       -historical
302              toggles use of '>' or '-->' as a terminator for comments.
303
304       -homepage=URL
305              set homepage separate from start page.
306
307       -image_links
308              toggles inclusion of links for all images.
309
310       -index=URL
311              set the default index file to the specified URL.
312
313       -ismap toggles inclusion of  ISMAP  links  when  client-side  MAPs  are
314              present.
315
316       -justify
317              do justification of text.
318
319       -link=NUMBER
320              starting count for lnk#.dat files produced by -crawl.
321
322       -listonly
323              for -dump, show only the list of links.
324
325       -localhost
326              disable URLs that point to remote hosts.
327
328       -locexec
329              enable  local  program  execution from local files only (if Lynx
330              was compiled with local execution enabled).
331
332       -lss=FILENAME
333              specify  filename  containing  color-style   information.    The
334              default is lynx.lss.  If you give an empty filename, lynx uses a
335              built-in monochrome scheme which  imitates  the  non-color-style
336              configuration.
337
338       -mime_header
339              prints  the  MIME  header  of  a fetched document along with its
340              source.
341
342       -minimal
343              toggles minimal versus valid comment parsing.
344
345       -nested_tables
346              toggles nested-tables logic (for debugging).
347
348       -newschunksize=NUMBER
349              number of articles in chunked news listings.
350
351       -newsmaxchunk=NUMBER
352              maximum news articles in listings before chunking.
353
354       -nobold
355              disable bold video-attribute.
356
357       -nobrowse
358              disable directory browsing.
359
360       -nocc  disable Cc: prompts for self copies of mailings.  Note that this
361              does  not disable any CCs which are incorporated within a mailto
362              URL or form ACTION.
363
364       -nocolor
365              force color mode off, overriding terminal capabilities  and  any
366              -color flags, COLORTERM variable, and saved .lynxrc settings.
367
368       -noexec
369              disable local program execution. (DEFAULT)
370
371       -nofilereferer
372              disable transmissions of Referer headers for file URLs.
373
374       -nolist
375              disable the link list feature in dumps.
376
377       -nolog disable mailing of error messages to document owners.
378
379       -nomargins
380              disable left/right margins in the default style sheet.
381
382       -nomore
383              disable -more- string in statusline messages.
384
385       -nonrestarting_sigwinch
386              This  flag  is  not  available  on all systems, Lynx needs to be
387              compiled with HAVE_SIGACTION defined.  If available,  this  flag
388              may  cause Lynx to react more immediately to window changes when
389              run within an xterm.
390
391       -nonumbers
392              disable   link-    and    field-numbering.     This    overrides
393              -number_fields and -number_links.
394
395       -nopause
396              disable forced pauses for statusline messages.
397
398       -noprint
399              disable most print functions.
400
401       -noredir
402              prevents  automatic redirection and prints a message with a link
403              to the new URL.
404
405       -noreferer
406              disable transmissions of Referer headers.
407
408       -noreverse
409              disable reverse video-attribute.
410
411       -nosocks
412              disable SOCKS proxy usage by a SOCKSified Lynx.
413
414       -nostatus
415              disable the retrieval status messages.
416
417       -notitle
418              disable title and blank line from top of page.
419
420       -nounderline
421              disable underline video-attribute.
422
423       -number_fields
424              force numbering of links as well as form input fields
425
426       -number_links
427              force numbering of links.
428
429       -partial
430              toggles display partial pages while loading.
431
432       -partial_thres=NUMBER
433              number  of  lines  to  render  before  repainting  display  with
434              partial-display logic
435
436       -passive-ftp
437              toggles passive ftp connections.
438
439       -pauth=ID:PASSWD
440              set  authorization  ID and password for a protected proxy server
441              at startup.  Be sure to protect any script files which use  this
442              switch.
443
444       -popup toggles  handling  of  single-choice  SELECT  options  via popup
445              windows or as lists of radio buttons.
446
447       -post_data
448              properly formatted data for a post form are  read  in  from  the
449              standard input and passed to the form.  Input is terminated by a
450              line that starts with '---'.
451
452       -preparsed
453              show HTML  source  preparsed  and  reformatted  when  used  with
454              -source or in source view.
455
456       -prettysrc
457              show HTML source view with lexical elements and tags in color.
458
459       -print enable print functions. (default)
460
461       -pseudo_inlines
462              toggles pseudo-ALTs for inline images with no ALT string.
463
464       -raw   toggles  default  setting of 8-bit character translations or CJK
465              mode for the startup character set.
466
467       -realm restricts access to URLs in the starting realm.
468
469       -read_timeout=N
470              Sets the read-timeout, where N is given in seconds.
471
472       -reload
473              flushes the cache on a proxy server  (only  the  first  document
474              affected).
475
476       -restrictions=[option][,option][,option]...
477              allows a list of services to be disabled selectively. Dashes and
478              underscores in option names can  be  intermixed.  The  following
479              list is printed if no options are specified.
480
481              all
482                 restricts all options listed below.
483
484              bookmark
485                 disallow changing the location of the bookmark file.
486
487              bookmark_exec
488                 disallow execution links via the bookmark file.
489
490              change_exec_perms
491                 disallow  changing the eXecute permission on files (but still
492                 allow it for  directories)  when  local  file  management  is
493                 enabled.
494
495              default
496                 same  as  command  line  option -anonymous.  Disables default
497                 services for anonymous users.  Set to all restricted,  except
498                 for:  inside_telnet, outside_telnet, inside_ftp, outside_ftp,
499                 inside_rlogin,  outside_rlogin,  inside_news,   outside_news,
500                 telnet_port, jump, mail, print, exec, and goto.  The settings
501                 for these,  as  well  as  additional  goto  restrictions  for
502                 specific  URL schemes that are also applied, are derived from
503                 definitions within userdefs.h.
504
505              dired_support
506                 disallow local file management.
507
508              disk_save
509                 disallow saving to disk in the download and print menus.
510
511              dotfiles
512                 disallow access to, or creation of, hidden (dot) files.
513
514              download
515                 disallow some downloaders in  the  download  menu  (does  not
516                 imply disk_save restriction).
517
518              editor
519                 disallow external editing.
520
521              exec
522                 disable execution scripts.
523
524              exec_frozen
525                 disallow the user from changing the local execution option.
526
527              externals
528                 disallow  some  "EXTERNAL" configuration lines if support for
529                 passing  URLs  to  external  applications  (with  the  EXTERN
530                 command) is compiled in.
531
532              file_url
533                 disallow  using  G)oto,  served  links or bookmarks for file:
534                 URLs.
535
536              goto
537                 disable the 'g' (goto) command.
538
539              inside_ftp
540                 disallow ftps for people coming from inside your domain (utmp
541                 required for selectivity).
542
543              inside_news
544                 disallow  USENET  news  posting for people coming from inside
545                 your domain (utmp required for selectivity).
546
547              inside_rlogin
548                 disallow rlogins for people coming from  inside  your  domain
549                 (utmp required for selectivity).
550
551              inside_telnet
552                 disallow  telnets  for  people coming from inside your domain
553                 (utmp required for selectivity).
554
555              jump
556                 disable the 'j' (jump) command.
557
558              multibook
559                 disallow multiple bookmarks.
560
561              mail
562                 disallow mail.
563
564              news_post
565                 disallow USENET News posting.
566
567              options_save
568                 disallow saving options in .lynxrc.
569
570              outside_ftp
571                 disallow ftps for people  coming  from  outside  your  domain
572                 (utmp required for selectivity).
573
574              outside_news
575                 disallow  USENET  news  reading and posting for people coming
576                 from outside your domain  (utmp  required  for  selectivity).
577                 This  restriction  applies to "news", "nntp", "newspost", and
578                 "newsreply"  URLs,  but  not  to  "snews",  "snewspost",   or
579                 "snewsreply" in case they are supported.
580
581              outside_rlogin
582                 disallow  rlogins  for people coming from outside your domain
583                 (utmp required for selectivity).
584
585              outside_telnet
586                 disallow telnets for people coming from outside  your  domain
587                 (utmp required for selectivity).
588
589              print
590                 disallow most print options.
591
592              shell
593                 disallow shell escapes and lynxexec or lynxprog G)oto's.
594
595              suspend
596                 disallow Unix Control-Z suspends with escape to shell.
597
598              telnet_port
599                 disallow specifying a port in telnet G)oto's.
600
601              useragent
602                 disallow modifications of the User-Agent header.
603
604       -resubmit_posts
605              toggles  forced  resubmissions  (no-cache)  of forms with method
606              POST when the  documents  they  returned  are  sought  with  the
607              PREV_DOC command or from the History List.
608
609       -rlogin
610              disable recognition of rlogin commands.
611
612       -scrollbar
613              toggles showing scrollbar.
614
615       -scrollbar_arrow
616              toggles showing arrows at ends of the scrollbar.
617
618       -selective
619              require .www_browsable files to browse directories.
620
621       -session=FILENAME
622              resumes from specified file on startup and saves session to that
623              file on exit.
624
625       -sessionin=FILENAME
626              resumes session from specified file.
627
628       -sessionout=FILENAME
629              saves session to specified file.
630
631       -short_url
632              show very long URLs in the status line with "..."  to  represent
633              the portion which cannot be displayed.  The beginning and end of
634              the URL are displayed, rather than suppressing the end.
635
636       -show_cfg
637              Print the configuration settings, e.g., as read from "lynx.cfg",
638              and exit.
639
640       -show_cursor
641              If  enabled  the  cursor  will  not  be hidden in the right hand
642              corner but will instead  be  positioned  at  the  start  of  the
643              currently selected link.  Show cursor is the default for systems
644              without FANCY_CURSES capabilities.   The  default  configuration
645              can  be  changed  in  userdefs.h  or lynx.cfg.  The command line
646              switch toggles the default.
647
648       -show_rate
649              If enabled the transfer  rate  is  shown  in  bytes/second.   If
650              disabled,  no  transfer  rate  is  shown.   Use  lynx.cfg or the
651              options menu to select KB/second and/or ETA.
652
653       -soft_dquotes
654              toggles emulation of the  old  Netscape  and  Mosaic  bug  which
655              treated '>' as a co-terminator for double-quotes and tags.
656
657       -source
658              works  the  same  as  dump  but  outputs  HTML source instead of
659              formatted text.  For example
660
661              lynx -source . >foo.html
662
663              generates  HTML  source  listing  the  files  in   the   current
664              directory.   Each  file  is  marked  by  an HREF relative to the
665              parent directory.  Add a  trailing  slash  to  make  the  HREF's
666              relative to the current directory:
667
668              lynx -source ./ >foo.html
669
670       -stack_dump
671              disable SIGINT cleanup handler
672
673       -startfile_ok
674              allow non-http startfile and homepage with -validate.
675
676       -stderr
677              When  dumping  a  document using -dump or -source, Lynx normally
678              does not display alert (error) messages  that  you  see  on  the
679              screen  in the status line.  Use the -stderr option to tell Lynx
680              to write these messages to the standard error.
681
682       -stdin read the startfile from standard input (UNIX only).
683
684       -syslog=text
685              information for syslog call.
686
687       -syslog-urls
688              log requested URLs with syslog.
689
690       -tagsoup
691              initialize parser, using Tag Soup DTD rather than SortaSGML.
692
693       -telnet
694              disable recognition of telnet commands.
695
696       -term=TERM
697              tell Lynx what terminal type to assume it is talking to.   (This
698              may  be  useful  for  remote  execution, when, for example, Lynx
699              connects to a remote TCP/IP port that starts a script  that,  in
700              turn, starts another Lynx process.)
701
702       -timeout=N
703              For  win32,  sets  the network read-timeout, where N is given in
704              seconds.
705
706       -tlog  toggles between using a Lynx Trace  Log  and  stderr  for  trace
707              output from the session.
708
709       -tna   turns on "Textfields Need Activation" mode.
710
711       -trace turns  on  Lynx trace mode.  Destination of trace output depends
712              on -tlog.
713
714       -trace_mask=value
715              turn on optional traces, which may result in  very  large  trace
716              files.  Logically OR the values to combine options:
717
718              1  SGML character parsing states
719
720              2  color-style
721
722              4  TRST (table layout)
723
724              8  configuration  (lynx.cfg,  .lynxrc, .lynx-keymaps, mime.types
725                 and mailcap contents)
726
727              16 binary string copy/append, used in form data construction.
728
729              32 cookies
730
731              64 character sets
732
733              128
734                 GridText parsing
735
736              256
737                 timing
738
739       -traversal
740              traverse all http links derived from startfile.  When used  with
741              -crawl,  each link that begins with the same string as startfile
742              is output to a file, intended for indexing.  See  CRAWL.announce
743              for more information.
744
745       -trim_input_fields
746              trim input text/textarea fields in forms.
747
748       -underline_links
749              toggles use of underline/bold attribute for links.
750
751       -underscore
752              toggles use of _underline_ format in dumps.
753
754       -unique_urls
755              check  for duplicate link numbers in each page and corresponding
756              lists, and reuse the original link number.
757
758       -use_mouse
759              turn on mouse support, if available.  Clicking  the  left  mouse
760              button  on a link traverses it.  Clicking the right mouse button
761              pops back.  Click on the top line to scroll up.   Click  on  the
762              bottom  line to scroll down.  The first few positions in the top
763              and bottom line may invoke additional functions.  Lynx  must  be
764              compiled  with  ncurses  or  slang  to support this feature.  If
765              ncurses is used, clicking the middle  mouse  button  pops  up  a
766              simple  menu.  Mouse clicks may only work reliably while Lynx is
767              idle waiting for input.
768
769       -useragent=Name
770              set alternate Lynx User-Agent header.
771
772       -validate
773              accept only  http  URLs  (for  validation).   Complete  security
774              restrictions also are implemented.
775
776       -verbose
777              toggle  [LINK],  [IMAGE] and [INLINE] comments with filenames of
778              these images.
779
780       -version
781              print version information, and exit.
782
783       -vikeys
784              enable vi-like key movement.
785
786       -wdebug
787              enable Waterloo tcp/ip packet debug (print to  watt  debugfile).
788              This  applies  only  to  DOS  versions  compiled  with WATTCP or
789              WATT-32.
790
791       -width=NUMBER
792              number of columns for formatting of dumps, default is 80.   This
793              is  limited  by  the  number of columns that Lynx could display,
794              typically 1024 (the MAX_LINE symbol).
795
796       -with_backspaces
797              emit backspaces in output if -dump'ing or -crawl'ing (like 'man'
798              does)
799
800       -xhtml_parsing
801              tells Lynx that it can ignore certain tags which have no content
802              in an XHTML 1.0 document.  For example "<p/>" will be discarded.
803

COMMANDS

805       o  Use Up arrow and Down arrow to scroll through hypertext links.
806
807       o  Right arrow or Return will follow a highlighted hypertext link.
808
809       o  Left Arrow will retreat from a link.
810
811       o  Type "H" or "?" for  online  help  and  descriptions  of  key-stroke
812          commands.
813
814       o  Type  "K"  for  a  complete  list  of the current key-stroke command
815          mappings.
816

ENVIRONMENT

818       In addition to various "standard" environment variables such  as  HOME,
819       PATH,  USER,  DISPLAY, TMPDIR, etc, Lynx utilizes several Lynx-specific
820       environment variables, if they exist.
821
822       Others may be created or modified by Lynx to pass data to  an  external
823       program, or for other reasons.  These are listed separately below.
824
825       See  also  the  sections  on  SIMULATED CGI SUPPORT and NATIVE LANGUAGE
826       SUPPORT, below.
827
828       Note:  Not all environment variables apply to all  types  of  platforms
829       supported  by  Lynx, though most do.  Feedback on platform dependencies
830       is solicited.
831
832       Environment Variables Used By Lynx:
833
834       COLORTERM           If set, color capability for the terminal is forced
835                           on  at  startup time.  The actual value assigned to
836                           the variable is ignored.   This  variable  is  only
837                           meaningful  if  Lynx  was  built  using  the  slang
838                           screen-handling library.
839
840       LYNX_CFG            This variable, if set, will  override  the  default
841                           location  and name of the global configuration file
842                           (normally,  lynx.cfg)  that  was  defined  by   the
843                           LYNX_CFG_FILE  constant  in  the  userdefs.h  file,
844                           during installation.  See the userdefs.h  file  for
845                           more information.
846
847       LYNX_HELPFILE       If set, this variable overrides the compiled-in URL
848                           and configuration file URL for the Lynx help file.
849
850       LYNX_LOCALEDIR      If set, this  variable  overrides  the  compiled-in
851                           location  of  the  locale  directory which contains
852                           native language (NLS) message text.
853
854       LYNX_LSS            This variable, if set, specifies  the  location  of
855                           the   default  Lynx  character  style  sheet  file.
856                           [Currently only meaningful if Lynx was built  using
857                           experimental color style support.]
858
859       LYNX_SAVE_SPACE     This  variable,  if  set, will override the default
860                           path prefix for files saved to disk that is defined
861                           in  the  lynx.cfg  SAVE_SPACE:  statement.  See the
862                           lynx.cfg file for more information.
863
864       LYNX_TEMP_SPACE     This variable, if set, will  override  the  default
865                           path  prefix  for  temporary files that was defined
866                           during installation, as well as any value that  may
867                           be assigned to the TMPDIR variable.
868
869       MAIL                This variable specifies the default inbox Lynx will
870                           check for new mail, if such checking is enabled  in
871                           the lynx.cfg file.
872
873       NEWS_ORGANIZATION   This  variable, if set, provides the string used in
874                           the Organization: header of USENET  news  postings.
875                           It  will  override  the setting of the ORGANIZATION
876                           environment variable, if it is also  set  (and,  on
877                           UNIX, the contents of an /etc/organization file, if
878                           present).
879
880       NNTPSERVER          If set, this variable specifies  the  default  NNTP
881                           server  that  will  be used for USENET news reading
882                           and posting with Lynx, via news: URL's.
883
884       ORGANIZATION        This variable, if set, provides the string used  in
885                           the  Organization:  header of USENET news postings.
886                           On UNIX,  it  will  override  the  contents  of  an
887                           /etc/organization file, if present.
888
889       PROTOCOL_proxy      Lynx supports the use of proxy servers that can act
890                           as firewall gateways and caching servers.  They are
891                           preferable   to  the  older  gateway  servers  (see
892                           WWW_access_GATEWAY, below).  Each protocol used  by
893                           Lynx,  (http,  ftp,  gopher,  etc),  can  be mapped
894                           separately by setting environment variables of  the
895                           form    PROTOCOL_proxy    (literally:   http_proxy,
896                           ftp_proxy,       gopher_proxy,       etc),       to
897                           "http://some.server.dom:port/".    See  Lynx  Users
898                           Guide for additional details and examples.
899
900       SSL_CERT_DIR        Set   to   the   directory    containing    trusted
901                           certificates.
902
903       SSL_CERT_FILE       Set  to the full path and filename for your file of
904                           trusted certificates.
905
906       WWW_access_GATEWAY  Lynx still supports use of  gateway  servers,  with
907                           the   servers  specified  via  "WWW_access_GATEWAY"
908                           variables (where "access" is lower case and can  be
909                           "http",  "ftp",  "gopher"  or "wais"), however most
910                           gateway servers have been discontinued.  Note  that
911                           you do not include a terminal '/' for gateways, but
912                           do  for   proxies   specified   by   PROTOCOL_proxy
913                           environment  variables.   See  Lynx Users Guide for
914                           details.
915
916       WWW_HOME            This variable, if set, will  override  the  default
917                           startup   URL   specified   in   any  of  the  Lynx
918                           configuration files.
919
920       Environment Variables Set or Modified By Lynx:
921
922       LYNX_PRINT_DATE     This variable is set by the Lynx p(rint)  function,
923                           to   the   Date:  string  seen  in  the  document's
924                           "Information about" page (= cmd), if  any.   It  is
925                           created  for use by an external program, as defined
926                           in a lynx.cfg PRINTER:  definition  statement.   If
927                           the  field  does  not  exist  for the document, the
928                           variable is set to a null string under UNIX, or "No
929                           Date" under VMS.
930
931       LYNX_PRINT_LASTMOD  This  variable is set by the Lynx p(rint) function,
932                           to the Last Mod:  string  seen  in  the  document's
933                           "Information  about"  page  (= cmd), if any.  It is
934                           created for use by an external program, as  defined
935                           in  a  lynx.cfg  PRINTER: definition statement.  If
936                           the field does not  exist  for  the  document,  the
937                           variable is set to a null string under UNIX, or "No
938                           LastMod" under VMS.
939
940       LYNX_PRINT_TITLE    This variable is set by the Lynx p(rint)  function,
941                           to  the  Linkname:  string  seen  in the document's
942                           "Information about" page (= cmd), if  any.   It  is
943                           created  for use by an external program, as defined
944                           in a lynx.cfg PRINTER:  definition  statement.   If
945                           the  field  does  not  exist  for the document, the
946                           variable is set to a null string under UNIX, or "No
947                           Title" under VMS.
948
949       LYNX_PRINT_URL      This  variable is set by the Lynx p(rint) function,
950                           to  the  URL:  string  seen   in   the   document's
951                           "Information  about"  page  (= cmd), if any.  It is
952                           created for use by an external program, as  defined
953                           in  a  lynx.cfg  PRINTER: definition statement.  If
954                           the field does not  exist  for  the  document,  the
955                           variable is set to a null string under UNIX, or "No
956                           URL" under VMS.
957
958       LYNX_TRACE          If set, causes Lynx to write a trace file as if the
959                           -trace option were supplied.
960
961       LYNX_TRACE_FILE     If set, overrides the compiled-in name of the trace
962                           file, which is either  Lynx.trace  or  LY-TRACE.LOG
963                           (the  latter  on the DOS platform).  The trace file
964                           is in either case relative to the home directory.
965
966       LYNX_VERSION        This variable is always set by  Lynx,  and  may  be
967                           used  by an external program to determine if it was
968                           invoked by Lynx.  See  also  the  comments  in  the
969                           distribution's  sample  mailcap  file, for notes on
970                           usage in such a file.
971
972       TERM                Normally,  this  variable  is  used  by   Lynx   to
973                           determine  the  terminal  type being used to invoke
974                           Lynx.  If, however, it is unset at startup time (or
975                           has  the value "unknown"), or if the -term command-
976                           line option is used (see  OPTIONS  section  above),
977                           Lynx  will  set  or  modify  its  value to the user
978                           specified terminal type  (for  the  Lynx  execution
979                           environment).   Note:  If set/modified by Lynx, the
980                           values of  the  LINES  and/or  COLUMNS  environment
981                           variables may also be changed.
982

SIMULATED CGI SUPPORT

984       If built with the cgi-links option enabled, Lynx allows access to a cgi
985       script directly without the need for an http daemon.
986
987       When executing such  "lynxcgi  scripts"  (if  enabled),  the  following
988       variables may be set for simulating a CGI environment:
989
990       CONTENT_LENGTH
991
992       CONTENT_TYPE
993
994       DOCUMENT_ROOT
995
996       HTTP_ACCEPT_CHARSET
997
998       HTTP_ACCEPT_LANGUAGE
999
1000       HTTP_USER_AGENT
1001
1002       PATH_INFO
1003
1004       PATH_TRANSLATED
1005
1006       QUERY_STRING
1007
1008       REMOTE_ADDR
1009
1010       REMOTE_HOST
1011
1012       REQUEST_METHOD
1013
1014       SERVER_SOFTWARE
1015
1016       Other  environment  variables  are  not inherited by the script, unless
1017       they  are  provided  via  a  LYNXCGI_ENVIRONMENT   statement   in   the
1018       configuration  file.   See  the  lynx.cfg file, and the (draft) CGI 1.1
1019       Specification <http://Web.Golux.Com/coar/cgi/draft-coar-cgi-v11-00.txt>
1020       for the definition and usage of these variables.
1021
1022       The  CGI  Specification,  and other associated documentation, should be
1023       consulted for general information on CGI script programming.
1024

NATIVE LANGUAGE SUPPORT

1026       If configured and installed with Native  Language  Support,  Lynx  will
1027       display status and other messages in your local language.  See the file
1028       ABOUT_NLS in the source distribution, or at your local  GNU  site,  for
1029       more information about internationalization.
1030
1031       The  following  environment  variables  may  be  used  to alter default
1032       settings:
1033
1034       LANG                This variable, if set, will  override  the  default
1035                           message language.  It is an ISO 639 two-letter code
1036                           identifying the language.  Language codes  are  NOT
1037                           the same as the country codes given in ISO 3166.
1038
1039       LANGUAGE            This  variable,  if  set, will override the default
1040                           message language.  This is a GNU extension that has
1041                           higher  priority  for  setting  the message catalog
1042                           than LANG or LC_ALL.
1043
1044       LC_ALL              and
1045
1046       LC_MESSAGES         These variables, if  set,  specify  the  notion  of
1047                           native language formatting style.  They are POSIXly
1048                           correct.
1049
1050       LINGUAS             This  variable,  if  set  prior  to  configuration,
1051                           limits  the installed languages to specific values.
1052                           It is a space-separated list of  two-letter  codes.
1053                           Currently, it is hard-coded to a wish list.
1054
1055       NLSPATH             This  variable,  if set, is used as the path prefix
1056                           for message catalogs.
1057

NOTES

1059       This is the Lynx v2.8.7 Release; development is in progress for 2.8.8.
1060
1061       If you wish to contribute to the further development of Lynx, subscribe
1062       to  our mailing list.  Send email to <lynx-dev-request@nongnu.org> with
1063       "subscribe lynx-dev" as the only line in the body of your message.
1064
1065       Send bug reports, comments, suggestions to <lynx-dev@nongnu.org>  after
1066       subscribing.
1067
1068       Unsubscribe  by  sending  email  to  <lynx-dev-request@nongnu.org> with
1069       "unsubscribe lynx-dev" as the only line in the body  of  your  message.
1070       Do not send the unsubscribe message to the lynx-dev list, itself.
1071

SEE ALSO

1073       catgets(3),  curses(3),  environ(7),  execve(2),  ftp(1), gettext(GNU),
1074       localeconv(3),   ncurses(3),   setlocale(3),   slang(?),    termcap(5),
1075       terminfo(5), wget(GNU)
1076
1077       Note that man page availability and section numbering is somewhat plat‐
1078       form dependent, and may vary from the above references.
1079
1080       A section shown as (GNU), is intended to denote that the topic  may  be
1081       available via an info page, instead of a man page (i.e., try "info sub‐
1082       ject", rather than "man subject").
1083
1084       A section shown as (?) denotes that documentation on the topic  exists,
1085       but  is  not part of an established documentation retrieval system (see
1086       the distribution files associated with the topic, or contact your  Sys‐
1087       tem Administrator for further information).
1088

ACKNOWLEDGMENTS

1090       Lynx  has  incorporated  code  from a variety of sources along the way.
1091       The earliest versions of Lynx included code from Earl Fogel of  Comput‐
1092       ing  Services at the University of Saskatchewan, who implemented HYPER‐
1093       REZ in the Unix environment.  HYPERREZ was developed by Niel Larson  of
1094       Think.com  and  served  as  the  model  for the early versions of Lynx.
1095       Those versions also incorporated libraries from the Unix Gopher clients
1096       developed  at  the  University  of Minnesota, and the later versions of
1097       Lynx rely on the WWW client library code developed by  Tim  Berners-Lee
1098       and  the  WWW  community.  Also a special thanks to Foteos Macrides who
1099       ported much of Lynx to VMS and did or organized most of its development
1100       since  the  departures of Lou Montulli and Garrett Blythe from the Uni‐
1101       versity of Kansas in the summer of 1994 through the release of  v2.7.2,
1102       and  to  everyone  on the net who has contributed to Lynx's development
1103       either directly (through patches, comments or bug reports) or indirect‐
1104       ly (through inspiration and development of other systems).
1105

AUTHORS

1107       Lou  Montulli,  Garrett  Blythe, Craig Lavender, Michael Grobe, Charles
1108       Rezac
1109       Academic Computing Services
1110       University of Kansas
1111       Lawrence, Kansas 66047
1112
1113       Foteos Macrides
1114       Worcester Foundation for Biomedical Research
1115       Shrewsbury, Massachusetts 01545
1116
1117       Thomas E. Dickey
1118       <dickey@invisible-island.net>
1119
1120
1121
1122                                                                       LYNX(1)
Impressum