HowTo install Lynx 2.8.7 on AmigaOS3.1
                     ======================================
                           (Guide v0.2 by jedcooper)



                                   DISCLAIMER
                                   ----------

 I'm not responsible for either hard-/software failures, loss of data, friends,
                     wife or anything else run into fault!



History:
--------


v0.2

 -   changed from .pdf to .txt version of this guide
 -   therefore some layout changes to match 80 chars
 -   added short "Usage" description

v0.1

 -   initial release



Requirements:
-------------


 -   68020+/OS2.04+
 -   2MB RAM/4 MB HDD space installed, about 15 MB temporary for installation
 -   Ixemul48+/ixnet48+
 -   RUNNING! TCP/IP Stack (Miami/AmiTCP/Genesis) - I tested it with MiamiDx1.0c
 -   Terminfo database (these are ncurses libraries)



Restrictions:
-------------


 -   No SSL!
 -   No Graphics (of course, it is Lynx!)
     Look: http://upload.wikimedia.org/wikipedia/de/b/b8/Lynx_Browser_2.png



Installation:
-------------


1.)  Get Lynx 2.8.7 binaries here:
     http://aminet.net/package/comm/www/lynx-2.8.7-bin-m68k

2.)  Get Terminfo Database here:
     http://aminet.net/package/dev/gg/ncurses-5.5-1-usr-m68k

     add .lha to the links above and you get the direct download link,
     if you're gonna copy'n'paste and wget'ing that!

3.)  Get the other required stuff ixemul48+/ixnet48+, you should find that for
     yourself if needed on Aminet. And install it...

4.)  Unpack both archives to a temporary directory, f.e. SYS:lynx.temp

     CLI:    makedir SYS:lynx.temp
             LHA/LZX x </archivedir/archivename.lha> SYS:lynx.temp/
             cd SYS:lynx.temp
             list

5.)  Then you should have two directories named: "ncurses-5.5-1-p-usr-m68k" and
     "lynx-2.8.7-bin-m68k"

6.)  Go to the "ncurses-5.5-1-p-usr-m68k" directory and copy all files to the
     lynx directory:
 
     CLI:    cd SYS:lynx.temp/ncurses-5.5-1-p-usr-m68k
             copy #? ALL TO /lynx-2.8.7-bin-m68k

7.)  The important point here is, that the directory structure in ncurses
     matches the one in the lynx directory!
 
     i.e.:   ncurses.../usr          =       lynx.../usr

                        ... and so on ...

8.)  Now the directory structure is correct you may copy it wherever you want.
     I go to the "lynx-2.8.7-bin-m68k" directory and copy it to SYS:Lynx/ 
 
     CLI:    cd SYS:lynx.temp/lynx-2.8.7-bin-m68k
             makedir SYS:Lynx
             copy #? ALL TO SYS:Lynx/

9.)  You may delete your "lynx.temp" directory as we're done here.
 
     CLI:    cd SYS:Lynx/
             delete SYS:lynx.temp ALL

10.) Now we need some assigns to be done. You could either execute the script
     on demand or in your user-startup.
     Open your favourite text-editor and create a file S:lynxassign
 
     CLI:    ed S:lynxassign
 
     ...and put this code in it:
 
      assign lynx: SYS:Lynx
      assign usr: lynx:usr/ add
      assign c: lynx:c/ add
      assign c: lynx:usr/local/bin/ add
      assign bin: lynx:usr/local/bin add
      assign tmp: T: add
      assign share: lynx:usr/local/share/ add
      set TERM amiga
 
     Save it and set the +s flag to execute it without the command execute.
 
     CLI:    protect S:lynxassign SRWED

11.) Go to SYS:Lynx/c and set the +s flag on lynx, too, as it's a shellscript
     and sets the stack and some other options etc.:
 
     CLI:    cd SYS:Lynx/
             protect lynx SRWED



Important notes:
----------------


 -   The "set TERM" command in "S:lynxassign" maybe could set to "amiga-8bit"
     (not tried yet)

 -   Pay attention for RAM on filling up your T: as it is normally assigned
     to RAM:T

 -   Though setting assign of tmp: to a HDD could corrupt your Harddisk in
     case of a GURU!!

 -   Other options might be set in /usr/local/etc/lynx.cfg, I won't explain
     that!

 -   Some "Bad HTML!" errors occure, ignore them. Don't know yet how to set
     them off.

 -   Cookies for default are always asked for being set.



Usage:
------


Now you're ready. Start Lynx from CLI with "lynx <URL>" and/or other options
you might know to browse the web with Lynx.


 -   You may set some paths and cookie behaviour at the "configuration page"
     of Lynx pressing "O" for options. Don't forget to check "Save to disk"
     AND "Accept changes" after done!

 -   Navigation as usual in unix derivates; for (really) short:

      * <G> go to new URL

      * <Left arrow> to go back

      * <Right arrow> to follow link

      * <O> for options menu

      * <Space> for next page

      * <Enter> for checkbox or follow link

      * <Q> for quit

 -   Mouse is not supported, but you may mark and copy to clipboard.

 -   Lynx displays on any reasonable window size



Conclusion:
-----------


For feedback just PM me on a1k.org, amiga.org forum or E-Mail me: jedcooper
(at) geee/emmm/xxxxx dot n/e/t. You know how to "decrypt" that, otherwise
I won't talk to you.