home *** CD-ROM | disk | FTP | other *** search
/ PC Online 1997 July / PCO_07_97.ISO / filesbbs / OS2 / LYNX271.ARJ / LYNX271.ZIP / readme.os2 < prev    next >
Encoding:
Text File  |  1997-05-22  |  8.5 KB  |  189 lines
  1.  
  2.                             Lynx 2.7.1 for OS/2
  3.                                       
  4. Table of Contents
  5.  
  6.      * [1]Introduction
  7.      * [2]Installation
  8.      * [3]Getting Help
  9.      * [4]Bugs
  10.      * [5]License
  11.        
  12. Introduction
  13.  
  14.    Hello and welcome to Lynx 2.7.1 for OS/2. This is a port of Lynx 2.7.1
  15.    from the Lynx-Dev sources (Unix and VMS). It should be fairly
  16.    complete, but it hasn't been tested very thoroughly. Be sure to read
  17.    the included [6]README file, which is more general than this file,
  18.    which applies only to the OS/2 port.
  19.    
  20. Why Lynx?
  21.  
  22.    Lynx is a full featured text-oriented browser for the World Wide Web.
  23.    Though the trend in recent years has been towards graphical browsers,
  24.    there are still many good reasons for using Lynx. Lynx can be used to
  25.    format WWW output for users with special needs, such as the visually
  26.    impaired. Lynx is also much faster than any other browser out there,
  27.    and is good for doing quick lookups on URLs from a newsreader, for
  28.    example. Lynx lets you cut through the style and get right to the
  29.    substance.
  30.    
  31. Why port Lynx 2.7.1 to OS/2?
  32.  
  33.    As you may know, there already is a Lynx port for OS/2: [7]Lynx/2,
  34.    ported by [8]Derek J. Decker. Actually, ported is too weak of a term,
  35.    since Lynx/2 has so many enhancements it's hard to know where to start
  36.    listing them. Let me say up front that this port is not intended to
  37.    supersede Lynx/2. Hardcore OS/2 Lynxers will want to have both. Lynx/2
  38.    has a lot of things this port doesn't have, most importantly: better
  39.    table support, user-selectable colors, and support for Java applets.
  40.    Lynx/2 is a lot less rough around the edges, takes account of things
  41.    like FAT-compatible filenames, for example, and is easier to install.
  42.    
  43.    However, Lynx/2 is based on the Lynx 2.4 codebase. Lynx 2.7.1 has a
  44.    lot of things that Lynx 2.4 didn't. You can get a feel for these new
  45.    features by looking at the help files included with this package. The
  46.    highlights include frame support, some table support, lots of
  47.    user-customizable settings for things like comment handling, and
  48.    fairly thorough support for HTML 3.0 and HTML 3.2. Lynx/2 has some of
  49.    these things added in (tables and frames, notably). I needed a
  50.    text-mode browser that would do HTML 3.2, though, and that's one area
  51.    where Lynx 2.7.1 is ahead of Lynx/2.
  52.    
  53.    Another feature of this port is that it works in an xterm under
  54.    [9]XFree86-OS/2 as well as in an OS/2 fullscreen or windowed session.
  55.    This is important to me because of the shortage of browsers that run
  56.    under XFree86-OS/2. Lynx/2 doesn't run under XFree86-OS/2 because it
  57.    uses direct VIO calls, while this Lynx 2.7.1 port uses only ANSI
  58.    routines for screen writes. So if you're an XFree86 user, you may want
  59.    to use Lynx/2 on your PM desktop, and Lynx 2.7.1 on your XFree86
  60.    desktop. Lynx 2.7.1 can also be displayed on an attached terminal.
  61.    
  62. Installation
  63.  
  64. Hardware and Software Requirements
  65.  
  66.    Hardware
  67.    
  68.      * An IBM-compatible PC capable of running OS/2 2.1 or later with
  69.        TCP/IP
  70.      * In effect, a 386sx or better with at least 8 MB of RAM.
  71.        
  72.    Software
  73.    
  74.      * OS/2 2.1 or later (I think...should definitely be OK on Warp 3 or
  75.        later).
  76.      * An HPFS partition, as I haven't made any allowances for FAT
  77.        filenames. Actually, FAT might work, but you won't have any online
  78.        help.
  79.      * IBM TCP/IP 2.0 or later (?) Warp 3 IAK, Warp Connect, and Warp 4
  80.        all fit the bill.
  81.      * EMX runtime 0.9c or later.
  82.      * GNU File Utilities. You need at least 'cp', and I'm not sure what
  83.        all else.
  84.        
  85.   Installation Procedure
  86.   
  87.    This is probably a little harder than it needs to be right now. I'll
  88.    try to make it as straightforward as possible.
  89.    
  90.     1. Unzip the Lynx 2.7.1 package into a directory. You've probably
  91.        already done this.
  92.     2. If you haven't installed the EMX runtime or the GNU file utils,
  93.        now is a good time.
  94.     3. Copy lynx.exe to somewhere on your path, or to its own directory .
  95.        Put lynx.cfg somewhere; if lynx has its own directory put it
  96.        there. Don't use x:/MPTN/ETC (your ETC directory) if you have
  97.        Lynx/2 installed, or you will have conflicts. You need to put the
  98.        helpfiles somewhere, too. If lynx has its own directory, put their
  99.        directories under it.
  100.     4. Unzip the terminfo zipfile to its own directory somewhere.
  101.     5. Set some environment variables in your config.sys:
  102.           + set HOME=x:/pathname (where you want personal configuration
  103.             files, signature files, etc to go)
  104.           + set TMP=x:/tmpspace (a temporary directory)
  105.           + set TERMINFO=x:/terminfo_path (where you unzipped the
  106.             terminfo files)
  107.           + set TERM=something (where something is a terminal type
  108.             supported by terminfo and hopefully also termcaps: "ansi" is
  109.             a reasonable if unaesthetic value.)
  110.           + set WWW_HOME=scheme://some.random.url/ (the URL you want Lynx
  111.             to load on startup.)
  112.           + set LYNX_CONFIG=x:/pathname/lynx.cfg (Path where you put
  113.             lynx.cfg).
  114.     6. Edit your lynx.cfg file to suit your needs. Some things in here
  115.        must be changed to suit your configuration (especially your
  116.        domain, and the location to helpfiles, etc.).
  117.     7. Reboot to activate your environment variables; make a desktop
  118.        object for lynx.exe if you wish.
  119.     8. Happy Lynxing!
  120.        
  121. Getting Help
  122.  
  123.    The best place to start looking for help is in the Lynx help files. If
  124.    you have Lynx set up correctly, you can browse them just by hitting
  125.    'h' or '?'. If not, try looking at them with WebExplorer.
  126.    
  127.    Lots of good information is available from [10]Lynx Links. I may have
  128.    more specific information about Lynx for OS/2 available from my
  129.    [11]Lynx page. If you're totally stuck, you can [12]email me, but
  130.    please don't send me any general Lynx questions, etc; just problems,
  131.    suggestions, or compliments regarding the OS/2 port.
  132.    
  133. Bugs
  134.  
  135.    These are the bugs I know about:
  136.      * Page Up/ Page Down, and other such keys don't work in an OS/2
  137.        fullscreen or windowed session. In the meantime, learn the Lynx
  138.        keystrokes for paging. Oddly enough, they do work in an xterm.
  139.      * The dark blue used for underlined text is hard to see in a VIO
  140.        window. Maybe if someone understands terminfo better than me, they
  141.        can change this to another color.
  142.      * DIRED support is compiled in, but doesn't work. If no one cares
  143.        about it, I'll probably just compile it out, eventually.
  144.      * In some places, absolute paths starting with '\' or '/' work. In
  145.        others, they don't. Relative paths and absolute paths starting
  146.        with drive letters should always work.  References to the home
  147.        directory as "~" don't seem to work, either.
  148.      * Removal of bookmark entries doesn't work.  Use 'e' to edit your
  149.        bookmarks page instead.
  150.        
  151.    If anyone finds any other bugs, [13]let me know. In particular, I may
  152.    well have missed any number of places where Unix-like pathnames are
  153.    expected.
  154.    
  155. License
  156.  
  157.    Lynx is distributed under the [14]GNU Public License, which you should
  158.    read. There is no warranty, as described in the license agreement.
  159.    Source code for Lynx is available from [15]lynx.browser.org (use the
  160.    Lynx 2.7.1 release code), while patches for compiling Lynx under OS/2
  161.    are included in this package. If you want to recompile Lynx for OS/2,
  162.    you will need to find the OS/2 ncurses port. I got it from [16]here,
  163.    but I'm not responsible for the ncurses port.
  164.      _________________________________________________________________
  165.    
  166.    
  167.     Jason.McBrayer@Tulane.edu
  168.     
  169.    Last modified: Tue May 20 15:12:26 -0600 1997
  170.  
  171. References
  172.  
  173.    1. file://localhost/./readme_os2.html#intro
  174.    2. file://localhost/./readme_os2.html#install
  175.    3. file://localhost/./readme_os2.html#help
  176.    4. file://localhost/./readme_os2.html#bugs
  177.    5. file://localhost/./readme_os2.html#license
  178.    6. file://localhost/./README
  179.    7. http://www.cris.com/~Djd/products.html
  180.    8. mailto:djd@cris.com
  181.    9. http://borneo.gmd.de/~veit/os2/xfree86os2.html
  182.   10. http://www.crl.com/~subir/lynx.html
  183.   11. http://studentweb.tulane.edu/~jmcbray/lynx
  184.   12. mailto:Jason.McBrayer@tulane.edu
  185.   13. mailto:Jason.McBrayer@tulane.edu
  186.   14. file://localhost/./COPYING
  187.   15. http://lynx.browser.org/
  188.   16. ftp://phi.sinica.edu.tw/pub/aspac/os2/port/ncur197aOS2.zip
  189.