home *** CD-ROM | disk | FTP | other *** search
/ Dream 52 / Amiga_Dream_52.iso / Linux / Divers / lynx2.8.1dev.10.tar.gz / lynx2.8.1dev.10.tar / lynx2-8 / lynx.hlp < prev    next >
Text File  |  1998-04-18  |  15KB  |  467 lines
  1. 1 LYNX
  2.  NAME
  3.  lynx - a general purpose distributed information browser for the World 
  4.  Wide Web
  5.  
  6. 2 SYNOPSIS
  7.      Lynx [options] [path or URL]
  8.  
  9.      use "lynx -help" to display a complete list of current options.
  10.  
  11. 2 DESCRIPTION
  12.  Lynx is a fully-featured World Wide Web (WWW) client for users running
  13.  cursor-addressable, character-cell display devices (e.g., vt100 terminals,
  14.  vt100 emulators running on PCs or Macs, or any other "curses-oriented"
  15.  display). It will display hypertext markup language (HTML) documents con-
  16.  taining links to files residing on the local system, as well as files
  17.  residing on remote systems running Gopher, HTTP, FTP, WAIS, and NNTP
  18.  servers.  Current versions of Lynx run on Unix and VMS.
  19.  
  20.  Lynx can be used to access information on the World Wide Web, or to build
  21.  information systems intended primarily for local access.  For example, Lynx
  22.  has been used to build several Campus Wide Information Systems (CWIS).  In
  23.  addition, Lynx can be used to build systems isolated within a single LAN.
  24.  
  25. 2 OPTIONS
  26.  At start up, Lynx will load any local file or remote URL specified at 
  27.  the command line.  For help with URLs, press "?" or "h" while running
  28.  Lynx.  Then follow the link titled, "Help on URLs."
  29.  
  30.   -
  31.        If the argument is only '-', then Lynx expects to receive
  32.        arguments from stdin.  This is to allow for the potentially
  33.        very long command line that can be associated with the
  34.        -get_data or -post_data arguments (see below).  Encase it
  35.        in double-quotes ("-").
  36.  
  37.   -anonymous
  38.        used to specify the anonymous account.
  39.  
  40.   -assume_charset=MIMEname
  41.        charset for documents that don't specify it.
  42.  
  43.   -assume_local_charset=MIMEname
  44.        charset assumed for local files.
  45.  
  46.   -assume_unrec_charset=MIMEname
  47.        use this instead of unrecognized charsets.
  48.  
  49.   -auth=ID:PASSWD
  50.        set authorization ID and password for protected documents
  51.        at startup.  Be sure to protect any script files which use
  52.        this switch.
  53.  
  54.   -base
  55.        prepend a request URL comment and BASE tag to text/html
  56.        outputs for -source dumps.
  57.  
  58.   -blink
  59.        forces high intensity bg colors for color mode, if available
  60.        and supported by the terminal.
  61.        Lynx needs to be compiled with the slang library for this flag.
  62.  
  63.   -book
  64.        use the bookmark page as the startfile.  The default or command
  65.        line startfile is still set for the Main screen command, and will
  66.        be used if the bookmark page is unavailable or blank.
  67.  
  68.   -buried_news
  69.        toggles scanning of news articles for buried references, and
  70.        converts them to news links.  Not recommended because email
  71.        addresses enclosed in angle brackets will be converted to
  72.        false news links, and uuencoded messages can be trashed.
  73.  
  74.   -cache=NUMBER
  75.        set the NUMBER of documents cached in memory.  The default is 10.
  76.  
  77.   -case
  78.        enable case-sensitive string searching.
  79.  
  80.   -cfg=FILENAME
  81.        specifies a Lynx configuration file other than the default lynx.cfg.
  82.  
  83.   -child
  84.        exit on left-arrow in startfile, and disable save to disk.
  85.  
  86.   -color
  87.        forces color mode on, if available.  Default color control sequences
  88.        which work for many terminal types are assumed if the terminal
  89.        capability description does not specify how to handle color.
  90.        Lynx needs to be compiled with the slang library for this flag.
  91.        A saved show_color=always setting found in a .lynxrc file at
  92.        startup has the same effect.  A saved show_color=always found
  93.        in .lynxrc on startup is overridden by this flag.
  94.  
  95.   -cookies
  96.        toggles handling of Set-Cookie headers.
  97.  
  98.   -crawl
  99.        with -traversal, output each page to a file.
  100.        with -dump, format output as with -traversal, but to stdout.
  101.  
  102.   -display=DISPLAY
  103.        set the display variable for X rexec-ed programs.
  104.  
  105.   -dump
  106.        dumps the formatted output of the default document or one specified
  107.        on the command line to standard out.  This can be used in the
  108.        following way:
  109.            lynx -dump http://www.crl.com/~subir/lynx.html
  110.  
  111.   -editor=EDITOR
  112.        enable edit mode using the specified EDITOR. (vi, ed, emacs, etc.)
  113.  
  114.   -emacskeys
  115.        enable emacs-like key movement.
  116.  
  117.   -enable_scrollback
  118.        toggles compatibility with comm programs' scrollback keys
  119.        (may be incompatible with some curses packages).
  120.  
  121.   -error_file=FILE
  122.        define a file where Lynx will report HTTP access codes.
  123.  
  124.   -fileversions
  125.        include all versions of files in local VMS directory listings.
  126.  
  127.   -force_html
  128.        forces the first document to be interpreted as HTML.
  129.  
  130.   -force_secure
  131.        toggles forcing of the secure flag for SSL cookies.
  132.  
  133.   -from
  134.        toggles transmissions of From headers.
  135.  
  136.   -ftp 
  137.        disable ftp access.
  138.  
  139.   -get_data
  140.        send form data from stdin using GET method and dump results.
  141.  
  142.   -head
  143.        send a HEAD request for the mime headers.
  144.  
  145.   -help
  146.        print this Lynx command syntax usage message.
  147.  
  148.   -historical
  149.        toggles use of '>' or '-->' as a terminator for comments.
  150.  
  151.   -homepage=URL
  152.        set homepage separate from start page.
  153.  
  154.   -image_links
  155.        toggles inclusion of links for all images.
  156.  
  157.   -index=URL
  158.        set the default index file to the specified URL.
  159.  
  160.   -ismap
  161.        toggles inclusion of ISMAP links when client-side
  162.        MAPs are present.
  163.  
  164.   -link=NUMBER
  165.        starting count for lnk#.dat files produced by -crawl.
  166.  
  167.   -localhost
  168.        disable URLs that point to remote hosts.
  169.  
  170.   -locexec
  171.        enable local program execution from local files only (if
  172.        Lynx was compiled with local execution enabled).
  173.  
  174.   -mime_header
  175.        prints the MIME header of a fetched document along with its
  176.        source.
  177.  
  178.   -minimal
  179.        toggles minimal versus valid comment parsing.
  180.  
  181.   -newschunksize=NUMBER
  182.        number of articles in chunked news listings.
  183.  
  184.   -newsmaxchunk=NUMBER
  185.        maximum news articles in listings before chunking.
  186.  
  187.   -nobrowse
  188.        disable directory browsing.
  189.  
  190.   -nocc
  191.        disable Cc: prompts for self copies of mailings.  Note
  192.        that this does not disable any CCs which are incorporated
  193.        within a mailto URL or form ACTION.
  194.  
  195.   -nocolor
  196.        force color mode off, overriding terminal capabilities and any
  197.        -color flags, COLORTERM variable, and saved .lynxrc settings.
  198.  
  199.   -noexec
  200.        disable local program execution. (DEFAULT)
  201.  
  202.   -nofilereferer
  203.        disable transmissions of Referer headers for file URLs.
  204.  
  205.   -nolist
  206.        disable the link list feature in dumps.
  207.  
  208.   -nolog
  209.        disable mailing of error messages to document owners.
  210.  
  211.   -nopause
  212.        disable forced pauses for statusline messages.
  213.  
  214.   -noprint
  215.        disable print functions.
  216.  
  217.   -noredir
  218.        prevents automatic redirection and prints a message with a
  219.        link to the new URL.
  220.  
  221.   -noreferer
  222.        disable transmissions of Referer headers.
  223.  
  224.   -nosocks
  225.        disable SOCKS proxy usage by a SOCKSified Lynx.
  226.  
  227.   -nostatus
  228.        disable the retrieval status messages.
  229.  
  230.   -number_links
  231.        force numbering of links.
  232.  
  233.   -pauth=ID:PASSWD
  234.        set authorization ID and password for a protected proxy
  235.        server at startup.  Be sure to protect any script files
  236.        which use this switch.
  237.  
  238.   -popup
  239.        toggles handling of single-choice SELECT options via
  240.        popup windows or as lists of radio buttons.
  241.  
  242.   -post_data
  243.        send form data from stdin using POST method and dump results.
  244.  
  245.   -preparsed
  246.        show HTML source preparsed and reformatted when used with -source
  247.        or in source view.
  248.  
  249.   -print
  250.        enable print functions. (default)
  251.  
  252.   -pseudo_inlines
  253.        toggles pseudo-ALTs for inlines with no ALT string.
  254.  
  255.   -raw
  256.        toggles default setting of 8-bit character translations
  257.        or CJK mode for the startup character set.
  258.  
  259.   -realm
  260.        restricts access to URLs in the starting realm.
  261.  
  262.   -reload
  263.        flushes the cache on a proxy server
  264.        (only the first document affected).
  265.  
  266.   -restrictions=[option][,,option]...
  267.        allows a list of services to be disabled selectively.  The following
  268.        list is printed if no options are specified.
  269.  
  270.        all - restricts all options.
  271.  
  272.        bookmark - disallow changing the location of the bookmark file.
  273.  
  274.        bookmark_exec - disallow execution links via the bookmark file.
  275.  
  276.        change_exec_perms - disallow changing the eXecute permission on
  277.            files (but still allow it for directories) when local file
  278.            management is enabled.
  279.  
  280.        default - same as command line option -anonymous. Disables default
  281.            services for anonymous users. Currently set to all restricted
  282.            except for:  inside_telnet, outside_telnet, inside_news,
  283.            inside_ftp, outside_ftp, inside_rlogin, outside_rlogin, jump,
  284.            mail and goto.  Defaults are setable within userdefs.h.
  285.  
  286.        dired_support - disallow local file management.
  287.  
  288.        disk_save - disallow saving to disk in the download and print
  289.            menus.
  290.  
  291.        download - disallow downloaders in the download menu.
  292.  
  293.        editor - disallow editing.
  294.  
  295.        exec - disable execution scripts.
  296.  
  297.        exec_frozen - disallow the user from changing the local execution
  298.            option.
  299.  
  300.        file_url - disallow using G)oto, served links or bookmarks for
  301.            file: URLs.
  302.  
  303.        goto - disable the 'g' (goto) command.
  304.  
  305.        inside_ftp - disallow ftps for people coming from inside your domain
  306.            (utmp required for selectivity).
  307.  
  308.        inside_news - disallow USENET news posting for people coming from
  309.            inside our domain (utmp required for selectivity).
  310.  
  311.        inside_rlogin - disallow rlogins for people coming from inside your
  312.            domain (utmp required for selectivity).
  313.  
  314.        inside_telnet - disallow telnets for people coming from inside your
  315.            domain (utmp required for selectivity).
  316.  
  317.        jump - disable the 'j' (jump) command.
  318.  
  319.        multibook - disallow multiple bookmark files.
  320.  
  321.        mail - disallow mail.
  322.  
  323.        news_post - disallow USENET News posting.
  324.  
  325.        options_save - disallow saving options in .lynxrc.
  326.  
  327.        outside_ftp - disallow ftps for people coming from outside your
  328.            domain (utmp required for selectivity).
  329.  
  330.        outside_news - disallow USENET news posting for people coming from
  331.            outside your domain (utmp required for selectivity).
  332.  
  333.        outside_rlogin - disallow rlogins for people coming from outside your
  334.            domain (utmp required for selectivity).
  335.  
  336.        outside_telnet - disallow telnets for people coming from outside your
  337.            domain (utmp required for selectivity).
  338.  
  339.        print - disallow most print options.
  340.  
  341.        shell - disallow shell escapes and lynxexec or lynxprog G)oto's.
  342.  
  343.        suspend - disallow Unix Control-Z suspends with escape to shell.
  344.  
  345.        telnet_port - disallow specifying a port in telnet G)oto's.
  346.  
  347.        useragent - disallow modifications of the User-Agent header.
  348.  
  349.   -resubmit_posts
  350.        toggles forced resubmissions (no-cache) of forms with
  351.        method POST when the documents they returned are sought
  352.        with the PREV_DOC command or from the History List.
  353.  
  354.   -rlogin
  355.        disable recognition of rlogin commands.
  356.  
  357.   -selective
  358.        require .www_browsable files to browse directories.
  359.  
  360.   -show_cursor
  361.        If enabled the cursor will not be hidden in the right hand corner
  362.        but will instead be positioned at the start of the currently
  363.        selected link.  Show cursor is the default for systems without
  364.        FANCY_CURSES capabilities.  The default configuration can be
  365.        changed in userdefs.h or lynx.cfg.  The command line switch
  366.        toggles the default.
  367.  
  368.   -source
  369.        works the same as dump but outputs HTML source instead of formatted
  370.        text.
  371.  
  372.   -startfile_ok
  373.        allow non-http startfile and homepage with -validate.
  374.  
  375.   -tagsoup
  376.        initialize parser, using Tag Soup DTD rather than SortaSGML.
  377.  
  378.   -telnet
  379.        disable recognition of telnet commands.
  380.  
  381.   -term=TERM
  382.        tell Lynx what terminal type to assume its talking to.  (This may be
  383.        useful for remote execution, when, for example, Lynx connects to a
  384.        remote TCP/IP port that starts a script that, in turn, starts another
  385.        Lynx process.)
  386.  
  387.   -tlog
  388.        toggles use of a Lynx Trace Log for the current session.
  389.  
  390.   -trace
  391.        turns on WWW trace mode.
  392.  
  393.   -traversal
  394.        traverse all http links derived from startfile.  When used with
  395.        -crawl, each link that begins with the same string as startfile
  396.        is output to a file, intended for indexing.  See CRAWL.announce
  397.        for more information.
  398.  
  399.   -underscore
  400.        toggles use of _underline_ format in dumps.
  401.  
  402.   -useragent=Name
  403.        set alternate Lynx User-Agent header.
  404.  
  405.   -validate
  406.        accept only http URLs (for validation).  Complete security
  407.        restrictions also are implemented.
  408.  
  409.   -version
  410.        print version information
  411.  
  412.   -vikeys
  413.        enable vi-like key movement.
  414.  
  415.   -width=NUMBER
  416.        number of columns for formatting of dumps, default is 80.
  417.  
  418. 2 COMMANDS
  419.  o Use Up arrow and Down arrow to scroll through hypertext links.
  420.  o Right arrow or Return will follow a highlighted hypertext link.
  421.  o Left Arrow will retreat from a link.
  422.  o Type "h" or "?" for online help and descriptions of key-stroke commands.
  423.  o Type "k" for a complete list of the current key-stroke command mappings.
  424.  
  425. 2 NOTES
  426.  This is the Lynx v2.8 Release
  427.  
  428.  If you wish to contribute to the further development of Lynx, subscribe
  429.  to our mailing list.  Send email to <majordomo@sig.net> with
  430.  "subscribe lynx-dev" as the only line in the body of your
  431.  message.
  432.  
  433.  Send bug reports, comments, suggestions to <lynx-dev@sig.net>
  434.  after subscribing.
  435.  
  436.  Unsubscribe by sending email to <majordomo@sig.net> with
  437.  "unsubscribe lynx-dev" as the only line in the body of your message.
  438.  Do not send the unsubscribe message to the lynx-dev list, itself.
  439.  
  440. 2 ACKNOWLEDGMENTS
  441.  Lynx has incorporated code from a variety of sources along the way.
  442.  The earliest versions of Lynx included code from Earl Fogel of Computing
  443.  Services at the University of Saskatchewan, who implemented HYPERREZ
  444.  in the Unix environment.  HYPERREZ was developed by Niel Larson of 
  445.  Think.com and served as the model for the early versions of Lynx.
  446.  Those versions also incorporated libraries from the Unix Gopher clients
  447.  developed at the University of Minnesota, and the later versions of 
  448.  Lynx rely on the WWW client library code developed by Tim Berners-Lee
  449.  and the WWW community.  Also a special thanks to Foteos Macrides who
  450.  ported much of Lynx to VMS and did or organized most of its development
  451.  since the departures of Lou Montulli and Garrett Blythe from the
  452.  University of Kansas in the summer of 1994 through the release
  453.  of v2.7.2, and to everyone on the net who has contributed to Lynx's
  454.  development either directly (through patches, comments or bug reports)
  455.  or indirectly (through inspiration and development of other systems).
  456.  
  457. 2 AUTHORS
  458.  Lou Montulli, Garrett Blythe, Craig Lavender, Michael Grobe, Charles Rezac
  459.  Academic Computing Services
  460.  University of Kansas
  461.  Lawrence, Kansas 66047
  462.  
  463.  Foteos Macrides
  464.  Worcester Foundation for Biomedical Research
  465.  Shrewsbury, Massachusetts 01545
  466.  
  467.