moved from dev to prod

tools/netsurf/doc/bugs

@@ -0,0 +1,4 @@
+KNOWN BUGS
+
+- "View Source" only works when the configured editor is already launched.
+- Wrong redraw area when parts of the window move out of the screen area.

tools/netsurf/doc/faq.txt

@@ -0,0 +1,74 @@
+
+NETSURF ATARI FAQ
+
+Date: 12.04.2012
+
+01.) CAN NETSURF ALSO BE RUN WITHIN AN TOS ENVIRONMENT?
+02.) I DON'T HAVE AN 15 BIT GRAPHICS CARD, HOW TO RUN NETSURF ANYWAY?
+03.) WHEN I WANT TO RUN NETSURF IT SAYS: "SOCKET NOT CONNECTED".
+04.) I'M GETTING "INSUFFICENT MEMORY" MESSAGES WHEN RUNNING NETSURF.
+05.) SSL DOES NOT WORK - WHAT'S WRONG?
+06.) I'M GETTING THE ERROR: "BASE STYLESHEET FAILED TO LOAD" - WHAT'S WRONG?
+05.) A PAGE CRASHES - WHAT CAN I DO?
+
+1.) Question:
+    CAN NETSURF ALSO BE RUN WITHIN AN TOS ENVIRONMENT?
+
+    Answer:
+    Yes NS can run on classic TOS. More or less.
+    It is intended to run within the FreeMint environment.
+    However there is no support for networking
+    right now. Networking support for FireTOS is maybe possible
+    in the future.
+    NS also has problems with Path conversions on all FileSystems
+    running under TOS. Try setting full paths within the Choices file.
+
+
+2.) Question:
+    I DON'T HAVE AN 15 BIT GRAPHICS CARD, HOW TO RUN NETSURF ANYWAY?
+
+    Answer:
+    You need to trigger the config a bit.
+	enable the following Choices settings:
+
+    atari_font_driver:vdi
+    atari_transparency:0
+    suppress_images:1
+
+    This will run netsurf as a bloat textmode browser :)
+
+3.) Question:
+    WHEN I WANT TO RUN NETSURF IT SAYS: "SOCKET NOT CONNECTED"
+
+    Answer:
+    Take a look at the system requirements! I statet NetSurf needs
+    the latest FreeMiNT 1.17 RELEASE. There was a bug within previous
+    Versions. Please update your kernel. OR install polipo proxy
+    provided as RPM within sparemint distribution. This is an
+    workaround, it should work out of the box. But if you want to
+    use the polipo disk-cache you should edit the config file.
+
+4.) Question:
+    I'M GETTING "INSUFFICENT MEMORY" MESSAGES WHEN RUNNING NETSURF.
+
+    Answer:
+	Try to increase the TPA_INITIALMEM Configuration value within MINT.CNF
+
+5.) Question:
+    SSL DOES NOT WORK - WHAT TO DO?
+
+    Answer:
+    Try to move the shipped cabundle.crt file to the path where NetSurf
+    looks for the SSL certificates (Displayed within statusbar and also
+    verbose log).
+
+6.) Question:
+	I'M GETTING THE ERROR: "BASE STYLESHEET FAILED TO LOAD" - WHAT'S WRONG?
+
+	Answer:
+	NetSurf checks if the base stylesheet is modified. For that - it
+	requires that the system clock is returning reasonable valid values.
+	Make your your system clock is set. (Rember empty NVRAM....)
+	If that doesn't help - make sure the netsurf package was unpacked
+	completly and that all files can be read.
+

tools/netsurf/doc/readme.txt

@@ -0,0 +1,125 @@
+
+
+                               NETSURF
+
+                                  -
+
+                           NATIVE ATARI ALPHA
+
+                  Version 2.9 (Release Version)
+
+Ported by:     m0n0
+Release date:  xx.xx.xx
+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:
+-----------------
+
+ This section describes Features that NetSurf-Core offers but which are not
+ handled by the GEM frontend currently.
+
+ - 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.
+
+
+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
+----------
+
+ - "View Source" only works when the configured editor is already launched.
+ - Wrong redraw area when parts of the window move out of the screen area.
+
+Technical info & outlook
+------------------------
+
+
+Greetings & Thanks
+------------------
+
+ - AtFact for providing help with resource files & images
+ - 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 - 09.09.2011

tools/netsurf/doc/todo.txt

@@ -0,0 +1,18 @@
+TODO's (no priority order) for NetSurf 3.1 - 4.0
+
+ - Optimize drawing of bitmaps on Low-Memory machines
+ - Restore the Palette when Windows get's the Focus
+   -> only needed for <= 256 colors
+ - Make drawing of tiled bitmaps optional ( they are slooow )
+   -> already optimized, still needed?
+ - Make context menu more stable (grab all available context data at popup display)
+ - Implement SystemColor Choices dialog
+ - Add at least one offscreen plotter implementation
+ - Fix utf8 to atari character conversion (legacy VDI text plotter
+   must be able to handle the text argument characters correctly)
+ - Add URL history when typing URL's into url textarea
+ - Have browser_window specific cursor, window specifc cursor
+ - When minimized (not iconyfied) NetSurf doesn't recognize that.
+ - Implement Tabs (up to 4 tab favicons when iconyfied)
+ - merge treeview and gui_window handling
+