summaryrefslogtreecommitdiff
path: root/atari/doc/readme.txt
diff options
context:
space:
mode:
authorOle Loots <ole@monochrom.net>2011-02-22 21:06:43 +0000
committerOle Loots <ole@monochrom.net>2011-02-22 21:06:43 +0000
commitd4bb6718d6ef488864c7023cd52d6c1851fcc3fd (patch)
tree890771534f44e52b3971900b3bd7b7fb6f074e5d /atari/doc/readme.txt
parent4a805544063b2c59bf139e19d6961195c802a492 (diff)
downloadnetsurf-d4bb6718d6ef488864c7023cd52d6c1851fcc3fd.tar.gz
netsurf-d4bb6718d6ef488864c7023cd52d6c1851fcc3fd.tar.bz2
Updated docs
svn path=/trunk/netsurf/; revision=11758
Diffstat (limited to 'atari/doc/readme.txt')
-rwxr-xr-xatari/doc/readme.txt169
1 files changed, 151 insertions, 18 deletions
diff --git a/atari/doc/readme.txt b/atari/doc/readme.txt
index ba7ab6eda..9a9a0d23c 100755
--- a/atari/doc/readme.txt
+++ b/atari/doc/readme.txt
@@ -1,28 +1,161 @@
+
+
+ NETSURF
+
+ -
+
+ NATIVE ATARI ALPHA
+
+ Version 3.0 (Development Version)
+
+Ported by: m0n0
+Release date: 20.02.2011
+Contact: ole@monochrom.net
+WWW: http://netsurf-browser.org
+
+
+Table of Contents:
+------------------
+
+0x01 - What is it?
+0x02 - System Requirements
+0x03 - Features
+0x04 - Missing features
+0x05 - Things to test
+0x06 - Additional Notes
+0x07 - Known bugs
+0x08 - Technical information
+
+
+What is it? A web browser!
+--------------------------
+
+ NetSurf is a multi-platform web browser which is written with
+ portability and speed in mind.
+ This is the native Port for the FreeMiNT OS.
+ More info at project website: www.netsurf-browser.org
+
+
+Minimum System Requirements:
+----------------------------
+
+ - 32 MB RAM ( 48 MB recommended for demanding websites )
+ - 32 MHz ( 60 Mhz recommended )
+ - At least 15 Bit Graphics card.
+ - FreeMiNT 1.17.0 release kernel (Please look at FAQ to read
+ about TOS support) for full & correct network support.
+
+
+Main Features:
+--------------
+
+ - Very good HTML 4 & CSS 2.1 rendering
+ - HTTPS
+ - Freetype2 font rendering
+
+
Missing Features:
-----------------
-- Also look at BUGS file!
-- No networking with classic TOS.
-- Frames are not implemented - if you hit an page with frames, you are advised to close the window and open a
- new one.
-- Many of the Menu items are not working yet.
-- No Bookmarks & No History
-- No Download Manager
+ This section describes Features that NetSurf-Core offers but which are not
+ handled by the GEM frontend currently.
+
+- Frames
+- Hotlist / Bookmarks
+- Configuration dialog (use texteditor instead)
+- Grapical website history dialog
+
+
+Installation Notes:
+-------------------
+
+ Unpack the compressed archive that you downloaded,
+ change into the new directory and run ns.prg.
+ If something isn't working - run ns.prg within an console and
+ enable logging:
+
+ ./ns.prg -v
+
+ that makes it possible, that you can identify the problem.
+
Things to test:
---------------
-- Networking code
-- SSL
-- Window Redraw - sometimes it looks like the page is redrawn all the times... (ebay...)
- When you start to scroll, this stops.
- Find out if the redraw stops at some point without the need of the user interaction.
-- Navigate to a lot of pages, note the ones that crashed, please don't report pages that you visited
- after visiting pages with frames... Make sure you don't call pages with frames. I know that it's not working,
- and I know that it can cause BUGS.
-- Have a look at the memory usage...
-- Copy & Paste ( please don't report unsupported characters, I know it's not perfect)
- But you can use CTRL+A to select everything. Try it.
+ - Navigate to a lot of pages, note the ones that crashed, please don't report pages that you visited
+ after visiting pages with frames... Make sure you don't call pages with frames. I know that it's not working,
+ and I know that it can cause BUGS.
+ - Have a look at the memory usage...
+
+
+Additional Notes
+----------------
+
+ If you would like to see the above mentioned features or
+ can't run NetSurf because you only have a 16 or 256 Color system
+ get in contact.
+
+ Please also check the FAQ document.
+
+ Want to have other software ported? Get in contact and make me rich >;-)
+ If you want to help with netsurf, contact me for further info
+ or visit the netsurf svn and add something usefull :)
+
+ This is "just an early" alpha release. I wanted to get things moving on
+ and I think it is good to show the Atari-Users what has been archived
+ so far. This release lacks some features and some of the code written
+ was just coded with an "I have to get this done quickly" attitude.
+ This is especially true for the drawin routines... It doesn't offer
+ offscreen bitmaps, which was one of my goals for a release. But
+ I dropped that in favor of an not-so-delayed release.
+
+
+Known Bugs
+----------
+
+ - Redraw artefacts/fale clipping when moving other applications above
+ NetSurf.
+ - Visiting frames results in unknown behavior
+ (Some pages containing iframes still display,
+ but there are problems with focusing the correct window,
+ which results in missing redraws - clicking the mouse within
+ the window or scrolling resolves the problem).
+ - Double Redraws when used with classic TOS systems.
+ - Window can not be moved out of the desktop area to the right
+ - When leaving the search dialog open and navigate to another
+ page, the behavior is unknown.
+ As a solution: always close the search before you visit another page
+ or click on a link.
+
+
+Technical info & outlook
+------------------------
+
+ 1. There is an stack excess lurking withing mintlibs regex implementation.
+ Some pages can trigger that excess, therefore the initial stack space
+ is set to an very large default value - around 3 MB. You are free to
+ lower that value with freemint stack tool - most pages even work fine
+ with 64k stack space! Yahoo & dict.leo.org are known to trigger the
+ stack excess.
+ Last minute note: because the default maximum TPA value within MINT.CNF
+ I had to adjust the stack value down to 1000k. If you encounter crashes
+ during page rendering - please increase the stack size (SEE FAQ)
+
+
+Greetings & Thanks
+------------------
+
+ - The MiNT Mailing list, they all helped me a lot!
+ - The NetSurf Mailing list guys, especially the Amiga guys.
+ - The NetSurf developers that did a great job!
+ - Everyone that tested this Browser!
+ - Everyone that provides feedback!
+ - The forum.atari-home.de members for giving me much help
+ during setup of my atari!
+
+----
+M0N0 - 19.02.2011
+
\ No newline at end of file