Installing NetSurf on ZETA
==========================

Requirements
  * ZETA 1.2.1 (should also work on other BONE based BeOS x86 systems, untested)
  * A working network connection (BONE)
  * About 8 MB of disk space

Quick way
  Open a Terminal in this folder and run:

      sh install.sh

  It copies NetSurf to /boot/apps/netsurf, registers it with the system (icon and
  file types) and adds NetSurf to Deskbar > Software > Internet.

By hand
  1. Copy the whole "NetSurf" folder to /boot/apps/ and rename it to "netsurf"
     (it must contain the program "NetSurf" and the folder "res" side by side).
  2. In Terminal:  mimeset -f /boot/apps/netsurf/NetSurf
  3. Optional menu entry:
       ln -s /boot/apps/netsurf/NetSurf ~/config/ZetaMenu/Software/Internet/NetSurf

Start it from the Deskbar menu or by double-clicking /boot/apps/netsurf/NetSurf.
Your settings, history and cookies are stored in ~/config/settings/NetSurf/ and
~/config/settings/x-vnd.NetSurf.

Setting the clock automatically (recommended if your clock is wrong)
  extras/timesync/timesync asks time servers (Cloudflare, Google, pool.ntp.org)
  and sets the system clock. Copy it somewhere permanent, e.g.
       cp extras/timesync/timesync ~/config/bin/
  Run "timesync -v" once to test. To run it 60 seconds after every boot (once the
  network is up) add this line to ~/config/boot/UserBootscript:

       (sleep 60; ~/config/bin/timesync > /tmp/timesync.log 2>&1) > /dev/null 2>&1 &

Uninstall
  rm -r /boot/apps/netsurf
  rm ~/config/ZetaMenu/Software/Internet/NetSurf
  rm -r ~/config/settings/NetSurf ~/config/settings/x-vnd.NetSurf   (settings and history)

Troubleshooting
  "SSL peer certificate was not OK" / "certificate validity starts in the future"
      -> the clock is wrong. Fix it (see above).
  "Could not resolve host"
      -> BONE networking/DNS problem outside NetSurf. Check with: ping 1.1.1.1 and
         nslookup www.netsurf-browser.org
  The window closes but the Deskbar entry stays / the app seems frozen after Alt+Q
      -> use this build (1.0); earlier test builds froze on exit.
  A crash writes a short register/stack report to /tmp/ns-crash.log; please attach it
  when reporting a problem.
