OWB 1.0 for MorphOS

*********************************************************************************
*                                                                               *
* IMPORTANT: if you're really impatient, look at the "Usage/First Run" section. *
*                                                                               *
*********************************************************************************

What is OWB?
------------

OWB is a web browser designed for CE devices such as mobile phones, portable
media players, Set Top Boxes and TV decoders, and any other consumer electronic
product (GPS, home-gateways, Web-radios, PVR, DVD recorders, wireless devices etc.)

Galekid release is the new mixture of WebKit with Sand-Labs flavour. It is
based on a day-to-day merging capability with WebKit while it still provides
the easy to use, easy to implement and easy to test OWBAL abstraction layer.

More information at: http://www.sand-labs.org/owb


MorphOS Port
------------

After about 3 weeks of work, I'm glad to release the first MorphOS version of OWB.

Here are the key features:

- Based on GaleKid 1.0 OWB Branch (December 2008)
- Javascript, CSS, DOM, SVG, Unicode, SSL, ...
- Antialiased fonts and kerning, font families and support for international
  charsets
- MUI Interface
- Cairo technology !!1
- Multiple tabs and windows
- Download manager
- Bookmarks
- Fastlinks
- Context menus
- Copy/Cut/Paste
- Rexx port (openurl support)
- No PayPal donation needed
...


Requirements
------------

MorphOS 2 is strongly advised, but it can still work on a 1.4.x setup with a
recent enough MUI snapshot (2007).

It requires at least 35MB of free memory. Efika users, if you need a stripped
down version, let me know. I can disable SVG support.


Usage
-----

- First run (IMPORTANT! READ!)

  At *first* run, OWB will index your truetype fonts directory (MOSSYS:fonts/_ttf by default).
  This operation can take a long time (expect a few minutes on efika). Progress
  is indicated if you run OWB from shell. Once it's done, a conf/font/fonts.cache
  file is created.

  If you really can't wait, I included a default fonts.cache file that should
  match fonts provided with MorphOS 2.2. Just rename conf/font/fonts.cache_2.2
  to fonts.cache.

  If you wish to use another truetype font directory, please edit conf/font/fonts.conf
  and change the <dir> attribute. By default, it's:

  ...
  <!-- Font directory list -->
	  <dir>MOSSYS:fonts/_ttf</dir>
  ...

  To use japanese fonts or anything else, just add relevant fonts in the configured
  font directory.

- Settings
  A minimal settings window is available. You can set download directory, homepage,
  and font sizes.

- Bookmarks
  OWB can import IBrowse bookmarks. Just copy it to OWB directory as bookmarks.html.
  If you wish to make an entry appear in fastlinks or pulldown menu, just check
  the relevant option in bookmark editor.

- OpenURL configuration
  Rexx Port: OWB.1 (or .<n>)
  Show:SHOW
  Screen To Front: SCREENTOFRONT
  Open: OPEN NAME=%u
  Open in new window: OPEN NAME=%u NEWPAGE

Preempted rants
---------------

- It takes ages to start!
  -> It only happens at first start or when you update your fonts.
     Current OWB version uses FontConfig, which is quite slow at indexing.
     After that, it should start in a second or so.

- It's slow!
  -> OWB is based on WebKit and this version uses Cairo to render. Modern
     browsers tend to be a bit less effective than our good old browsers. :)
     That said, there's still room for optimization.

- It's too memory-hungry!
  -> See above.

- Some SSL websites just display nothing!
  -> Maybe they're not certified. You can either update "curl-ca-bundle.crt" file,
     or ignore SSL errors with: "setenv WEBKIT_IGNORE_SSL_ERRORS 1" (not really recommended).

- It crashes!
  -> OWB is fairly stable (as long as you have enough memory, like any *posix*
     application nowadays...). If you get a reproducible crash, send me a debug log.

... Well, I'm sure I forgot some. :)


What's missing and might be supported in next versions
------------------------------------------------------

- Authentification window (you can still use http://login:pass@host)
- Error (403/404/...) feedback
- Download resume/pause
- Fancy mouse cursors
- URL completion
- Password manager
- Cookie saving
- General ergonomy needs to be enhanced/polished
... and much more. :)

And just remember this is a first release.


History
-------

- 01.02.2009: OWB 1.0
  First public release.


Contact
-------

If you have any suggestion or bug to report, please contact me at: fabien.coeurjoly@wanadoo.fr
But please, don't flood me. I'm quite aware of what's missing already. :)