home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / lynx2_8.zip / readme.os2 < prev   
Text File  |  1998-06-23  |  10KB  |  210 lines
  1.  
  2.                              Lynx 2.8 for OS/2
  3.                                       
  4. Table of Contents
  5.  
  6.      * [1]Introduction
  7.      * [2]What's new?
  8.      * [3]Installation from binary distribution
  9.      * [4]Installation from source distribution
  10.      * [5]Getting Help
  11.      * [6]Bugs
  12.      * [7]License
  13.        
  14. Introduction
  15.  
  16.    Hello and welcome to Lynx 2.8 for OS/2. This is a port of Lynx 2.8
  17.    from the Lynx-Dev sources. Be sure to read the included [8]README
  18.    file, which is more general than this file, which applies only to the
  19.    OS/2 port.
  20.    
  21. Why Lynx?
  22.  
  23.    Lynx is a full featured text-oriented browser for the World Wide Web.
  24.    Though the trend in recent years has been towards graphical browsers,
  25.    there are still many good reasons for using Lynx. Lynx can be used to
  26.    format WWW output for users with special needs, such as the visually
  27.    impaired. Lynx is also much faster than any other browser out there,
  28.    and is good for doing quick lookups on URLs from a newsreader, for
  29.    example. Lynx lets you cut through the style and get right to the
  30.    substance.
  31.    
  32. What's New?
  33.  
  34.    Lots!
  35.    
  36.    Here are some of the major chages since Lynx 2.7.1. The changes since
  37.    Lynx 2.4, which Lynx/2 was based on are too many to name.
  38.      * New Sorta-SGML parser (^V to toggle between new and old parser)
  39.      * Ncurses color-support (works in OS/2 window or xterm). Two ways of
  40.        selecting colors: color for types of emphasis in lynx.cfg (what
  41.        used to be bold can now be red, for example), or experimental
  42.        color-styles allow you to set color for any HTML element using a
  43.        stylesheet.
  44.      * External commands: use wget or ncftp to do external downloads
  45.        while you keep browsing in Lynx. Or start up a new Lynx window
  46.        from a hyperlink within Lynx!
  47.      * Experimental partial display code lets you see long pages as they
  48.        download.
  49.      * Lots of small interface tweaks and bug fixes.
  50.      * In 2.8.1 and later, OS/2-EMX will be a supported platform for
  51.        Lynx; no need to patch sources to recompile.
  52.        
  53. Installation
  54.  
  55. Hardware and Software Requirements
  56.  
  57.    Hardware
  58.      * An IBM-compatible PC capable of running OS/2 2.1 or later with
  59.        TCP/IP
  60.      * In effect, a 386sx or better with at least 8 MB of RAM.
  61.        
  62.    Software
  63.    
  64.      * OS/2 2.1 or later (I think...should definitely be OK on Warp 3 or
  65.        later).
  66.      * An HPFS partition, as I haven't made any allowances for FAT
  67.        filenames. Actually, FAT might work, but you won't have any online
  68.        help.
  69.      * IBM TCP/IP 2.0 or later (?) Warp 3 IAK, Warp Connect, and Warp 4
  70.        all fit the bill.
  71.      * EMX runtime 0.9c or later.
  72.      * GNU File Utilities. You need at least 'cp', and I'm not sure what
  73.        all else.
  74.        
  75.   Installation Procedure
  76.   
  77.    This is probably a little harder than it needs to be right now. I'll
  78.    try to make it as straightforward as possible.
  79.     1. Unzip the Lynx 2.8 package into a directory. You've probably
  80.        already done this.
  81.     2. If you haven't installed the EMX runtime or the GNU file utils,
  82.        now is a good time. If you don't have the GNU Fileutils and don't
  83.        want to install them, copy the file lcp.exe to cp.exe in the same
  84.        directory as your lynx.exe.
  85.     3. Copy lynx-std.exe and/or lynx-sty.exe to somewhere on your path,
  86.        or to its own directory. Put lynx.cfg somewhere;if lynx has its
  87.        own directory you may want to put it there. This build of Lynx
  88.        will look in the %HOME% directory (the directory specified by the
  89.        HOME environment variable) for both lynx.cfg and lynx.lss.
  90.        Lynx.lss should go in %HOME%. You need to put the helpfiles
  91.        somewhere, too. If lynx has its own directory, put their
  92.        directories under it.
  93.     4. Move the terminfo directory somewhere. Lynx will look for terminfo
  94.        files either in %TERMINFO% or in %HOME%/.terminfo. Lynx will also
  95.        use TERMCAP if it can't find the terminfo files; if you use
  96.        termcap, color won't work.
  97.     5. Set some environment variables in your config.sys:
  98.           + set HOME=x:/pathname (where you want personal configuration
  99.             files, signature files, etc to go)
  100.           + set TMP=x:/tmpspace (a temporary directory)
  101.           + set TERMINFO=x:/terminfo_path (where you moved the terminfo
  102.             directory, e.g. set TERMINFO=d:/emx/terminfo.)
  103.           + set TERM=something (where something is a terminal type
  104.             supported by terminfo and hopefully also termcaps: "ansi" is
  105.             a reasonable if unaesthetic value.)
  106.           + set WWW_HOME=scheme://some.random.url/ (the URL you want Lynx
  107.             to load on startup. For example, set
  108.             WWW_HOME=http://www.ibm.com/.)
  109.           + set LYNX_CONFIG=x:/pathname/lynx.cfg (Path where you put
  110.             lynx.cfg; if lynx.cfg is in %HOME% you don't have to set
  111.             this.).
  112.     6. Edit your lynx.cfg file to suit your needs. Some things in here
  113.        must be changed to suit your configuration (especially your
  114.        domain, and the location to helpfiles, etc.).
  115.     7. Reboot to activate your environment variables; make a desktop
  116.        object for Lynx if you wish. Alternatively, instead of modifying
  117.        config.sys and rebooting, you can make a lynx.cmd file containing
  118.        all of the environment variable settings and running Lynx.
  119.     8. Happy Lynxing!
  120.        
  121.    There are two Lynx executables included in this package. Lynx-std.exe
  122.    is built to use the standard method of color selection; look in
  123.    lynx.cfg for the COLOR directives and associated comments.
  124.    Lynx-sty.exe is built to use color styles for color selection; edit
  125.    lynx.lss to set colors for particular HTML elements. The two methods
  126.    have their own strengths and weaknesses. The color-styles version
  127.    gives you finer control over what colors are used for what kinds of
  128.    text, but you can't really set the main/default background color with
  129.    it. It is also hard to predict exactly what results you will get when
  130.    various HTML tags are combined! The color-styles code is experimental.
  131.    The standard method lets you use fewer colors, but it lets you set the
  132.    overall background color, for example. In my experience, the standard
  133.    method is better in OS/2 windowed or full-screen sessions, while the
  134.    color-styles method is better in an xterm. In fact, it looks [9]really
  135.    good in rxvt.
  136.    
  137. Installation from sources.
  138.  
  139.    In order to compile Lynx for OS/2, you need a number of different
  140.    packages. You can get either the OS/2-specific source distribution
  141.    (from Hobbes or probably whereever you got this package), or get the
  142.    latest sources from [10]the Lynx experimental distribution directory.
  143.    You will need the EMX/GCC compiler, [11]Autoconf for OS/2 and
  144.    [12]Ncurses for OS/2. Unpack the Lynx source. Use autoconf to rebuild
  145.    the configure script (this will require an extremely complete set of
  146.    unix-like utilities for OS/2). Run configure, and edit the resulting
  147.    lynx_cfg.h to your satisfaction. Most things will be fine, but make
  148.    sure that the names of programs (cp, gzip, etc) are correct; that's
  149.    the only thing configure is likely to get wrong. Run 'make', and
  150.    everything should go perfectly smoothly.
  151.    
  152. Getting Help
  153.  
  154.    The best place to start looking for help is in the Lynx help files. If
  155.    you have Lynx set up correctly, you can browse them just by hitting
  156.    'h' or '?'. If not, try looking at them with WebExplorer.
  157.    
  158.    Lots of good information is available from [13]Lynx Links. I may have
  159.    more specific information about Lynx for OS/2 available from my
  160.    [14]Lynx page. If you're totally stuck, you can [15]email me, but
  161.    please don't send me any general Lynx questions, etc; just problems,
  162.    suggestions, or compliments regarding the OS/2 port.
  163.    
  164. Bugs
  165.  
  166.    These are the bugs I know about:
  167.      * Basic dired support works, but many features don't work: you can't
  168.        move or change the permissions on files.
  169.      * There are some glitches in the display with the standard method of
  170.        color selection. If the screen gets missed up and ^L doesn't clear
  171.        it up, try typing v (for the bookmarks page) and ^G to cancel. I
  172.        think it's an ncurses problem; maybe just the terminfo files.
  173.        There are also some display problems in an xterm; use TERM=x10term
  174.        or TERM=rxvt to get around it.
  175.        
  176.    If anyone finds any other bugs, [16]let me know. In particular, I may
  177.    well have missed any number of places where Unix-like pathnames are
  178.    expected.
  179.    
  180. License
  181.  
  182.    Lynx is distributed under the [17]GNU Public License, which you should
  183.    read. There is no warranty, as described in the license agreement.
  184.      _________________________________________________________________
  185.    
  186.    
  187.     Jason.McBrayer@Tulane.edu
  188.     
  189.    Last modified: Tue Jun 23 18:57:32 -0600 1998
  190.  
  191. References
  192.  
  193.    1. file://localhost/./readme_os2.html#intro
  194.    2. file://localhost/./readme_os2.html#new
  195.    3. file://localhost/./readme_os2.html#install
  196.    4. file://localhost/./readme_os2.html#compile
  197.    5. file://localhost/./readme_os2.html#help
  198.    6. file://localhost/./readme_os2.html#bugs
  199.    7. file://localhost/./readme_os2.html#license
  200.    8. file://localhost/./README
  201.    9. file://localhost/./lynx-style.gif
  202.   10. http://sol.slcc.edu/lynx/current/
  203.   11. http://www.arrakis.es/acemx.htm
  204.   12. http://www.arrakis.es/ncemx.htm
  205.   13. http://www.crl.com/~subir/lynx.html
  206.   14. http://studentweb.tulane.edu/~jmcbray/lynx
  207.   15. mailto:Jason.McBrayer@tulane.edu
  208.   16. mailto:Jason.McBrayer@tulane.edu
  209.   17. file://localhost/./COPYING
  210.