home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Spezial / SPEZIAL2_97.zip / SPEZIAL2_97.iso / ANWEND / ONLINE / OS2LYN_1 / README.OS2 < prev    next >
Text File  |  1997-07-12  |  9KB  |  192 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. If you don't have the GNU Fileutils and don't
  94.        want to install them, copy the file lcp.exe to cp.exe in the same
  95.        directory as your lynx.exe.
  96.     3. Copy lynx.exe to somewhere on your path, or to its own directory .
  97.        Put lynx.cfg somewhere; if lynx has its own directory put it
  98.        there. Don't use x:/MPTN/ETC (your ETC directory) if you have
  99.        Lynx/2 installed, or you will have conflicts. You need to put the
  100.        helpfiles somewhere, too. If lynx has its own directory, put their
  101.        directories under it.
  102.     4. Unzip the terminfo zipfile to its own directory somewhere.
  103.     5. Set some environment variables in your config.sys:
  104.           + set HOME=x:/pathname (where you want personal configuration
  105.             files, signature files, etc to go)
  106.           + set TMP=x:/tmpspace (a temporary directory)
  107.           + set TERMINFO=x:/terminfo_path (where you unzipped the
  108.             terminfo files)
  109.           + set TERM=something (where something is a terminal type
  110.             supported by terminfo and hopefully also termcaps: "ansi" is
  111.             a reasonable if unaesthetic value.)
  112.           + set WWW_HOME=scheme://some.random.url/ (the URL you want Lynx
  113.             to load on startup.)
  114.           + set LYNX_CONFIG=x:/pathname/lynx.cfg (Path where you put
  115.             lynx.cfg).
  116.     6. Edit your lynx.cfg file to suit your needs. Some things in here
  117.        must be changed to suit your configuration (especially your
  118.        domain, and the location to helpfiles, etc.).
  119.     7. Reboot to activate your environment variables; make a desktop
  120.        object for lynx.exe if you wish. Alternatively, instead of
  121.        modifying config.sys, you can make a lynx.cmd file containing all
  122.        of the environment variable settings and running lynx.exe.
  123.     8. Happy Lynxing!
  124.        
  125. Getting Help
  126.  
  127.    The best place to start looking for help is in the Lynx help files. If
  128.    you have Lynx set up correctly, you can browse them just by hitting
  129.    'h' or '?'. If not, try looking at them with WebExplorer.
  130.    
  131.    Lots of good information is available from [10]Lynx Links. I may have
  132.    more specific information about Lynx for OS/2 available from my
  133.    [11]Lynx page. If you're totally stuck, you can [12]email me, but
  134.    please don't send me any general Lynx questions, etc; just problems,
  135.    suggestions, or compliments regarding the OS/2 port.
  136.    
  137. Bugs
  138.  
  139.    These are the bugs I know about:
  140.      * In some places, absolute paths starting with '\' or '/' work. In
  141.        others, they don't. Relative paths and absolute paths starting
  142.        with drive letters should always work. References to the home
  143.        directory as "~" don't seem to work, either.
  144.      * Removal of bookmark entries doesn't work. Use 'e' to edit your
  145.        bookmarks page instead until I find and fix this.
  146.      * Earlier bugs relating to the PageUp/PageDown/Home/End keys and to
  147.        unreadable colours have been fixed with the inclusion of a new set
  148.        of terminfo files. DIRED support has been compiled out, since it
  149.        didn't work and no one asked to have it fixed.
  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. If you can't get it from
  164.    the original source, you can try [17]here but don't count on that file
  165.    to always be there.
  166.      _________________________________________________________________
  167.    
  168.    
  169.     Jason.McBrayer@Tulane.edu
  170.     
  171.    Last modified: Sat Jul 12 11:09:31 -0600 1997
  172.  
  173. References
  174.  
  175.    1. file://localhost/D:/Projects/lynx2-7-1/distrib/readme_os2.html#intro
  176.    2. file://localhost/D:/Projects/lynx2-7-1/distrib/readme_os2.html#install
  177.    3. file://localhost/D:/Projects/lynx2-7-1/distrib/readme_os2.html#help
  178.    4. file://localhost/D:/Projects/lynx2-7-1/distrib/readme_os2.html#bugs
  179.    5. file://localhost/D:/Projects/lynx2-7-1/distrib/readme_os2.html#license
  180.    6. file://localhost/D:/Projects/lynx2-7-1/distrib/README
  181.    7. http://www.cris.com/~Djd/products.html
  182.    8. mailto:djd@cris.com
  183.    9. http://borneo.gmd.de/~veit/os2/xfree86os2.html
  184.   10. http://www.crl.com/~subir/lynx.html
  185.   11. http://studentweb.tulane.edu/~jmcbray/lynx
  186.   12. mailto:Jason.McBrayer@tulane.edu
  187.   13. mailto:Jason.McBrayer@tulane.edu
  188.   14. file://localhost/D:/Projects/lynx2-7-1/distrib/COPYING
  189.   15. http://lynx.browser.org/
  190.   16. ftp://phi.sinica.edu.tw/pub/aspac/os2/port/ncur197aOS2.zip
  191.   17. http://studentweb.tulane.edu/~jmcbray/lynx/ncur197aOS2.zip
  192.