
          PLEASE READ THIS DOCUMENT ENTIRELY BEFORE REPORTING BUGS!


ELinks v0.3 pre 3
=================

Hi all, this is a pre-compiled OS/2 binary of ELinks. For those who don't
know, ELinks is a branch from the main Links development, including several
fixes and enhancements.

Links, in turn, is a text-mode web browser, which is able to correctly
display tables and frames, and to render correctly most pages, even if
they include several graphical elements. It is ideal for quick navigation,
without banners, ads and other unwanted contents.

This build is SSL enabled, and the ZIP contains precompiled DLLs for the
OpenSSL 0.9.6 library.

This build is also Lua enabled, but it DOES NOT contain the Lua interpreter
and libraries. You need to download it from the same site where you downloaded
this package. The name of the Lua package is Lua40.zip.

Lua is a scripting language, and it is used in ELinks to allow the final user
to make customizations in the way the browser works. ELinks contains some
"hooks" that can be used by Lua scripts. Please note that you WILL NOT SEE ANY
DIFFERENCE between a Lua-enhanced version of ELinks and a non-Lua-enhanced
version. ELinks does not include any (enabled) script in the standard
distribution. BTW, I'm including a few contibuted Lua scripts in the /contrib
subdirectory. They are well commented, and installing them is easy (but see
the FAQ at the end of this document). I've done it, and they're working quite
well. They provide some nice functional enhancements.


Requirements
^^^^^^^^^^^^

 - EMX runtime libraries. Better use the latest release (0.9d fix 4)
 - gcc29166.dll (included) for the OpenSSL DLLs
 - The Lua interpreter package (Lua40.zip)

You may want to get the uname.exe utility (from the GNU shell utilities, on
hobbes.nmsu.edu or www.leo.org), though not strictly required (and NOT
included).

Finally, you need to have the HOME environment variable set, because ELinks
will store its configuration files there.


FAQ
^^^

Q: ELinks starts up, but it does nothing. It doesn't respond to keystrokes.
A: You're probably using a version of OS/2 that comes with a 32bit TCP/IP
   stack (or you've upgraded your stack to the 32bit version). ELinks (and
   even plain Links) doesn't work correctly with OS/2's 32bit TCP/IP stack,
   for unknown reasons. A workaround is to put the "-no-connect" option on
   the command line.

Q: What's this elinks.cmd file?
A: I use it to launch ELinks, because I find it more convenient. I'm sharing
   it with you in the hope that you'll find it useful.

Q: Why isn't elinks.cmd working?
A: You're supposed to have the "console" program to make use of it. "console"
   is a little program that is able to set up a VIO window for you, with the
   desired font and of the desired dimensions. You should be able to find
   it on hobbes (http://hobbes.nmsu.edu). The author is Andrew Zabolotny.
   Obviously, you should also customize the directory names, since they
   probably don't exist on your system.

Q: Why does ELinks dumps core everytime I exit from the program?
A: This is ELinks 0.3 pre 3. Note the "pre 3" part of the name... it is a
   non-stable release, which BTW contains enhancements over the current stable
   release. I found it to be quite stable for my work, so I choose not to
   compile the current "stable" release. You can always compile it yourself ;)

Q: When I try to install the new Lua bookmarks system I get a few errors at
   startup, and the usual bookmarks system is used afterwards.
A: You need to enable system_functions in the hooks.lua script, because the
   bm.lua script need to be able to read/write the bookmarks to your hard disk.


Contact info
^^^^^^^^^^^^

My name is Cristiano Guadagnino, and you can reach me at criguada@tin.it.

I am NOT the author of Links or ELinks. I simply compiled it, since the OS/2
community was missing a pre-compiled binary of ELinks with SSL and Lua support.
I am sharing it in the hope that someone will find it useful.


. Links author and main developer: Mikulas Patocka (http://links.browser.org)
. ELinks developer: Petr "Pasky" Baudis (http://pasky.ji.cz/~pasky/dev/elinks/)

