snapshot of project "lynx", label v2-8-3dev_21

1 files changed, 114 insertions, 104 deletions

diff --git a/lynx.hlp b/lynx.hlp
index bbbc54c3..9fdaeff3 100644
--- a/lynx.hlp
+++ b/lynx.hlp
@@ -1,15 +1,15 @@
 1 LYNX
-2 Name
+2 NAME
        lynx  -  a general purpose distributed information browser
        for the World Wide Web
 
-2 Synopsis
+2 SYNOPSIS
        lynx [options] [path or URL]
 
        use "lynx -help" to display a  complete  list  of  current
        options.
 
-2 Description
+2 DESCRIPTION
        Lynx  is  a fully-featured World Wide Web (WWW) client for
        users running cursor-addressable,  character-cell  display
        devices (e.g., vt100 terminals, vt100 emulators running on
@@ -28,7 +28,7 @@
        addition, Lynx can  be  used  to  build  systems  isolated
        within a single LAN.
 
-2 Options
+2 OPTIONS
        At  start  up, Lynx will load any local file or remote URL
        specified at the command line.  For help with URLs,  press
        "?"   or  "H"  while  running  Lynx.  Then follow the link
@@ -126,6 +126,11 @@
        -cookie_file=FILENAME
               specifies a file to use to store cookies.
 
+       -connect_timeout=N
+              Sets the connection timeout, where N  is  given  in
+              seconds.   This is not available under DOS (use the
+              sockdelay parameter of WATTCP under DOS).
+
        -core  toggles forced core dumps on fatal errors.
 
        -crawl with -traversal, output each page to a file.   with
@@ -184,7 +189,8 @@
               toggles forcing of the secure flag for SSL cookies.
 
        -forms_options
-              toggles whether the Options Menu is key-based or form-based.
+              toggles  whether  the  Options Menu is key-based or
+              form-based.
 
        -from  toggles transmissions of From headers.
 
@@ -202,18 +208,18 @@
               control the display of hidden links.
 
               merge hidden links show up as bracketed numbers and
-              are  numbered  together  with  other  links  in the
+              are numbered  together  with  other  links  in  the
               sequence of their occurrence in the document.
 
-              listonly hidden  links  are  shown  only  on  L)ist
+              listonly  hidden  links  are  shown  only  on L)ist
               screens and listings generated by -dump or from the
-              P)rint menu, but appear separately at  the  end  of
+              P)rint  menu,  but  appear separately at the end of
               those lists.  This is the default behavior.
 
               ignore hidden links do not appear even in listings.
 
        -historical
-              toggles use of '>' or '-->'  as  a  terminator  for
+              toggles  use  of  '>'  or '-->' as a terminator for
               comments.
 
        -homepage=URL
@@ -225,7 +231,7 @@
        -index=URL
               set the default index file to the specified URL.
 
-       -ismap toggles  inclusion  of ISMAP links when client-side
+       -ismap toggles inclusion of ISMAP links  when  client-side
               MAPs are present.
 
        -justify
@@ -239,12 +245,12 @@
               disable URLs that point to remote hosts.
 
        -locexec
-              enable  local  program  execution  from local files
-              only (if Lynx was  compiled  with  local  execution
+              enable local program  execution  from  local  files
+              only  (if  Lynx  was  compiled with local execution
               enabled).
 
        -mime_header
-              prints  the MIME header of a fetched document along
+              prints the MIME header of a fetched document  along
               with its source.
 
        -minimal
@@ -254,7 +260,7 @@
               number of articles in chunked news listings.
 
        -newsmaxchunk=NUMBER
-              maximum news articles in listings before  chunking.
+              maximum  news articles in listings before chunking.
 
        -nobold
               disable bold video-attribute.
@@ -262,20 +268,20 @@
        -nobrowse
               disable directory browsing.
 
-       -nocc  disable  Cc:  prompts  for self copies of mailings.
-              Note that this does not disable any CCs  which  are
+       -nocc  disable Cc: prompts for self  copies  of  mailings.
+              Note  that  this does not disable any CCs which are
               incorporated within a mailto URL or form ACTION.
 
        -nocolor
               force   color   mode   off,   overriding   terminal
-              capabilities  and  any  -color   flags,   COLORTERM
+              capabilities   and   any  -color  flags,  COLORTERM
               variable, and saved .lynxrc settings.
 
        -noexec
               disable local program execution. (DEFAULT)
 
        -nofilereferer
-              disable  transmissions  of Referer headers for file
+              disable transmissions of Referer headers  for  file
               URLs.
 
        -nolist
@@ -285,10 +291,10 @@
               owners.
 
        -nonrestarting_sigwinch
-              This  flag  is  not  available on all systems, Lynx
-              needs to be compiled with  HAVE_SIGACTION  defined.
-              If  available,  this  flag  may cause Lynx to react
-              more immediately to window changes when run  within
+              This flag is not available  on  all  systems,  Lynx
+              needs  to  be compiled with HAVE_SIGACTION defined.
+              If available, this flag may  cause  Lynx  to  react
+              more  immediately to window changes when run within
               an xterm.
 
        -nopause
@@ -317,7 +323,8 @@
               disable underline video-attribute.
 
        -number_fields
-              force numbering of links  as  well  as  form  input
+              force  numbering  of  links  as  well as form input
+
               fields
 
        -number_links
@@ -331,23 +338,23 @@
               with partial-display logic
 
        -pauth=ID:PASSWD
-              set authorization ID and password for  a  protected
-              proxy  server  at  startup.  Be sure to protect any
+              set  authorization  ID and password for a protected
+              proxy server at startup.  Be sure  to  protect  any
               script files which use this switch.
 
-       -popup toggles handling of  single-choice  SELECT  options
+       -popup toggles  handling  of  single-choice SELECT options
               via popup windows or as lists of radio buttons.
 
        -post_data
-              send  form  data  from  stdin using POST method and
+              send form data from stdin  using  POST  method  and
               dump results.
 
        -preparsed
-              show HTML source  preparsed  and  reformatted  when
+              show  HTML  source  preparsed  and reformatted when
               used with -source or in source view.
 
        -prettysrc
-              show  HTML  source  view  with lexical elements and
+              show HTML source view  with  lexical  elements  and
               tags in color.
 
        -print enable print functions. (default)
@@ -355,8 +362,8 @@
        -pseudo_inlines
               toggles pseudo-ALTs for inlines with no ALT string.
 
-       -raw   toggles   default   setting   of   8-bit  character
-              translations or CJK mode for the startup  character
+       -raw   toggles  default   setting   of   8-bit   character
+              translations  or CJK mode for the startup character
               set.
 
        -realm restricts access to URLs in the starting realm.
@@ -366,32 +373,31 @@
               document affected).
 
        -restrictions=[option][,option][,option]...
-              allows  a  list  of   services   to   be   disabled
+              allows   a   list   of   services  to  be  disabled
               selectively. Dashes and underscores in option names
               can be intermixed. The following list is printed if
               no options are specified.
 
               all - restricts all options listed below.
-
-              bookmark  -  disallow  changing the location of the
+              bookmark - disallow changing the  location  of  the
               bookmark file.
 
-              bookmark_exec - disallow execution  links  via  the
+              bookmark_exec  -  disallow  execution links via the
               bookmark file.
 
-              change_exec_perms  -  disallow changing the eXecute
-              permission  on  files  (but  still  allow  it   for
+              change_exec_perms - disallow changing  the  eXecute
+              permission   on  files  (but  still  allow  it  for
               directories) when local file management is enabled.
 
-              default - same as command line  option  -anonymous.
+              default  -  same as command line option -anonymous.
               Disables default services for anonymous users.  Set
-              to  all  restricted,  except  for:   inside_telnet,
-              outside_telnet,       inside_ftp,      outside_ftp,
+              to   all  restricted,  except  for:  inside_telnet,
+              outside_telnet,      inside_ftp,       outside_ftp,
               inside_rlogin,     outside_rlogin,     inside_news,
               outside_news, telnet_port, jump, mail, print, exec,
-              and goto.  The  settings  for  these,  as  well  as
-              additional   goto  restrictions  for  specific  URL
-              schemes that are also  applied,  are  derived  from
+              and  goto.   The  settings  for  these,  as well as
+              additional  goto  restrictions  for  specific   URL
+              schemes  that  are  also  applied, are derived from
               definitions within userdefs.h.
 
               dired_support - disallow local file management.
@@ -399,43 +405,44 @@
               disk_save - disallow saving to disk in the download
               and print menus.
 
-              dotfiles - disallow  access  to,  or  creation  of,
+              dotfiles  -  disallow  access  to,  or creation of,
               hidden (dot) files.
 
-              download   -   disallow  some  downloaders  in  the
-              download   menu   (does   not    imply    disk_save
+              download  -  disallow  some  downloaders   in   the
+              download    menu    (does   not   imply   disk_save
               restriction).
 
               editor - disallow external editing.
 
               exec - disable execution scripts.
 
-              exec_frozen  -  disallow the user from changing the
+              exec_frozen - disallow the user from  changing  the
               local execution option.
 
-              externals - disallow some "EXTERNAL"  configuration
-              lines  if  support  for  passing  URLs  to external
-              applications (with the EXTERN command) is  compiled
+              externals  - disallow some "EXTERNAL" configuration
+              lines if  support  for  passing  URLs  to  external
+              applications  (with the EXTERN command) is compiled
               in.
 
-              file_url  -  disallow  using G)oto, served links or
+              file_url - disallow using G)oto,  served  links  or
               bookmarks for file: URLs.
 
               goto - disable the 'g' (goto) command.
 
-              inside_ftp - disallow ftps for people  coming  from
+              inside_ftp  -  disallow ftps for people coming from
               inside your domain (utmp required for selectivity).
 
-              inside_news -  disallow  USENET  news  posting  for
-              people   coming   from  inside  your  domain  (utmp
+              inside_news  -  disallow  USENET  news  posting for
+
+              people  coming  from  inside  your   domain   (utmp
               required for selectivity).
 
-              inside_rlogin - disallow rlogins for people  coming
-              from   inside   your   domain  (utmp  required  for
+              inside_rlogin  - disallow rlogins for people coming
+              from  inside  your  domain   (utmp   required   for
               selectivity).
 
-              inside_telnet - disallow telnets for people  coming
-              from   inside   your   domain  (utmp  required  for
+              inside_telnet  - disallow telnets for people coming
+              from  inside  your  domain   (utmp   required   for
               selectivity).
 
               jump - disable the 'j' (jump) command.
@@ -446,45 +453,45 @@
 
               news_post - disallow USENET News posting.
 
-              options_save - disallow saving options in  .lynxrc.
+              options_save  - disallow saving options in .lynxrc.
 
-              outside_ftp  - disallow ftps for people coming from
-              outside   your   domain    (utmp    required    for
+              outside_ftp - disallow ftps for people coming  from
+              outside    your    domain    (utmp   required   for
               selectivity).
 
-              outside_news  -  disallow  USENET  news reading and
-              posting for people coming from outside your  domain
-              (utmp  required for selectivity).  This restriction
-              applies  to   "news",   "nntp",   "newspost",   and
-              "newsreply"  URLs, but not to "snews", "snewspost",
+              outside_news - disallow  USENET  news  reading  and
+              posting  for people coming from outside your domain
+              (utmp required for selectivity).  This  restriction
+              applies   to   "news",   "nntp",   "newspost",  and
+              "newsreply" URLs, but not to "snews",  "snewspost",
               or "snewsreply" in case they are supported.
 
               outside_rlogin - disallow rlogins for people coming
-              from   outside   your  domain  (utmp  required  for
+              from  outside  your  domain  (utmp   required   for
               selectivity).
 
               outside_telnet - disallow telnets for people coming
-              from   outside   your  domain  (utmp  required  for
+              from  outside  your  domain  (utmp   required   for
               selectivity).
 
               print - disallow most print options.
 
-              shell - disallow  shell  escapes  and  lynxexec  or
+              shell  -  disallow  shell  escapes  and lynxexec or
               lynxprog G)oto's.
 
-              suspend  -  disallow  Unix  Control-Z suspends with
+              suspend - disallow  Unix  Control-Z  suspends  with
               escape to shell.
 
-              telnet_port - disallow specifying a port in  telnet
+              telnet_port  - disallow specifying a port in telnet
               G)oto's.
 
-              useragent  -  disallow  modifications  of the User-
+              useragent - disallow  modifications  of  the  User-
               Agent header.
 
        -resubmit_posts
-              toggles forced resubmissions  (no-cache)  of  forms
-              with  method  POST when the documents they returned
-              are sought with the PREV_DOC command  or  from  the
+              toggles  forced  resubmissions  (no-cache) of forms
+              with method POST when the documents  they  returned
+              are  sought  with  the PREV_DOC command or from the
               History List.
 
        -rlogin
@@ -494,51 +501,56 @@
               require .www_browsable files to browse directories.
 
        -short_url
-              show very long URLs in the status line  with  "___"
+              show  very  long URLs in the status line with "___"
               to represent the portion which cannot be displayed.
-              The beginning and end of  the  URL  are  displayed,
+              The  beginning  and  end  of the URL are displayed,
               rather than suppressing the end.
 
        -show_cursor
-              If  enabled  the  cursor  will not be hidden in the
+              If enabled the cursor will not  be  hidden  in  the
               right hand corner but will instead be positioned at
-              the  start  of  the  currently selected link.  Show
-              cursor  is  the   default   for   systems   without
+              the start of the  currently  selected  link.   Show
+              cursor   is   the   default   for  systems  without
               FANCY_CURSES     capabilities.      The     default
               configuration  can  be  changed  in  userdefs.h  or
-              lynx.cfg.   The  command  line  switch  toggles the
+              lynx.cfg.  The  command  line  switch  toggles  the
               default.
 
        -soft_dquotes
-              toggles emulation of the old  Netscape  and  Mosaic
+              toggles  emulation  of  the old Netscape and Mosaic
               bug  which  treated  '>'  as  a  co-terminator  for
               double-quotes and tags.
 
        -source
-              works the same as  dump  but  outputs  HTML  source
+              works  the  same  as  dump  but outputs HTML source
               instead of formatted text.
 
        -stack_dump
               disable SIGINT cleanup handler
 
        -startfile_ok
-              allow   non-http   startfile   and   homepage  with
+              allow  non-http   startfile   and   homepage   with
               -validate.
 
        -tagsoup
-              initialize parser, using Tag Soup DTD  rather  than
+              initialize  parser,  using Tag Soup DTD rather than
               SortaSGML.
 
        -telnet
               disable recognition of telnet commands.
 
        -term=TERM
-              tell  Lynx  what  terminal  type  to  assume  it is
-              talking  to.   (This  may  be  useful  for   remote
-              execution,  when,  for  example, Lynx connects to a
-              remote TCP/IP port that starts a  script  that,  in
+              tell Lynx  what  terminal  type  to  assume  it  is
+              talking   to.   (This  may  be  useful  for  remote
+
+              execution, when, for example, Lynx  connects  to  a
+              remote  TCP/IP  port  that starts a script that, in
               turn, starts another Lynx process.)
 
+       -timeout=N
+              For win32, sets the network read-timeout,  where  N
+              is given in seconds.
+
        -tlog  toggles  between  using a Lynx Trace Log and stderr
               for trace output from the session.
 
@@ -600,7 +612,7 @@
               emit backspaces in output if -dumping or  -crawling
               (like 'man' does)
 
-2 Commands
+2 COMMANDS
        o  Use Up arrow and Down arrow to scroll through hypertext
        links.
        o  Right  arrow  or  Return  will  follow  a   highlighted
@@ -611,7 +623,7 @@
        o Type "K" for a complete list of the  current  key-stroke
        command mappings.
 
-2 Environment
+2 ENVIRONMENT
        In  addition  to  various "standard" environment variables
        such as HOME,  PATH,  USER,  DISPLAY,  TMPDIR,  etc,  Lynx
        utilizes  several  Lynx-specific environment variables, if
@@ -650,7 +662,6 @@
        LYNX_LSS            This variable, if set,  specifies  the
                            location of the default Lynx character
                            style  sheet  file.   [Currently  only
-
                            meaningful  if  Lynx  was  built using
                            experimental color style support.]
 
@@ -658,7 +669,7 @@
                            the  default  path  prefix  for  files
                            saved to disk that is defined  in  the
                            lynx.cfg  SAVE_SPACE:  statement.  See
-                           the    lynx.cfg    file    for   more
+                           the    lynx.cfg    file    for    more
                            information.
 
        LYNX_TEMP_SPACE     This  variable,  if set, will override
@@ -703,9 +714,8 @@
                            by  setting  environment  variables of
                            the  form  PROTOCOL_proxy  (literally:
                            http_proxy,  ftp_proxy,  gopher_proxy,
-                           etc),               to
+                           etc),                               to
                            "http://some.server.dom:port/".    See
-
                            Lynx  Users   Guide   for   additional
                            details and examples.
 
@@ -748,6 +758,7 @@
                            statement.   If  the  field  does  not
                            exist for the document,  the  variable
                            is set to a null string under UNIX, or
+
                            "No LastMod" under VMS.
 
        LYNX_PRINT_TITLE    This  variable  is  set  by  the  Lynx
@@ -760,7 +771,6 @@
                            statement.   If  the  field  does  not
                            exist for the document,  the  variable
                            is set to a null string under UNIX, or
-
                            "No Title" under VMS.
 
        LYNX_PRINT_URL      This  variable  is  set  by  the  Lynx
@@ -795,7 +805,7 @@
                            the  LINES  and/or COLUMNS environment
                            variables may also be changed.
 
-2 Simulated Cgi Support
+2 SIMULATED CGI SUPPORT
        If built with the cgi-links option  enabled,  Lynx  allows
        access  to  a  cgi script directly without the need for an
        http daemon.
@@ -841,7 +851,7 @@
        should be consulted for general information on CGI  script
        programming.
 
-2 Native Language Support
+2 NATIVE LANGUAGE SUPPORT
        If  configured and installed with Native Language Support,
        Lynx will display status and other messages in your  local
        language.    See   the   file   ABOUT_NLS  in  the  source
@@ -880,7 +890,7 @@
        NLSPATH             This variable, if set, is used as  the
                            path prefix for message catalogs.
 
-2 Notes
+2 NOTES
        This is the Lynx v2.8.2 Release
 
        If  you  wish  to contribute to the further development of
@@ -896,7 +906,7 @@
        your  message.  Do not send the unsubscribe message to the
        lynx-dev list, itself.
 
-2 See Also
+2 SEE ALSO
        catgets(3),  curses(3),  environ(7),  execve(2),   ftp(1),
        gettext(GNU),   localeconv(3),  ncurses(3),  setlocale(3),
        slang(?), termcap(5), terminfo(5), wget(GNU)
@@ -910,12 +920,12 @@
        page (i.e., try "info  subject",  rather  than  "man  subject").
 
        A  section  shown as (?) denotes that documentation on the
-       topic exists, but is not part of an established documentation
-       retrieval system (see the distribution files associated
+       topic exists, but is not part of an established documenta
+       tion  retrieval system (see the distribution files associated
        with the topic, or contact your System  Administrator
        for further information).
 
-2 Acknowledgments
+2 ACKNOWLEDGMENTS
        Lynx has incorporated code from a variety of sources along
        the way.  The earliest versions of Lynx included code from
        Earl  Fogel  of  Computing  Services  at the University of
@@ -936,7 +946,7 @@
        ports) or indirectly (through inspiration and  development
        of other systems).
 
-2 Authors
+2 AUTHORS
        Lou  Montulli,  Garrett  Blythe,  Craig  Lavender, Michael
        Grobe, Charles Rezac
        Academic Computing Services