summaryrefslogtreecommitdiff
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
parent4a805544063b2c59bf139e19d6961195c802a492 (diff)
downloadnetsurf-d4bb6718d6ef488864c7023cd52d6c1851fcc3fd.tar.gz
netsurf-d4bb6718d6ef488864c7023cd52d6c1851fcc3fd.tar.bz2
Updated docs
svn path=/trunk/netsurf/; revision=11758
-rwxr-xr-xatari/doc/DejaVu.txt99
-rwxr-xr-xatari/doc/changes.txt0
-rwxr-xr-xatari/doc/faq.txt66
-rwxr-xr-xatari/doc/readme.txt169
-rwxr-xr-xatari/doc/todo.txt (renamed from atari/doc/todo)0
5 files changed, 316 insertions, 18 deletions
diff --git a/atari/doc/DejaVu.txt b/atari/doc/DejaVu.txt
new file mode 100755
index 000000000..254e2cc42
--- /dev/null
+++ b/atari/doc/DejaVu.txt
@@ -0,0 +1,99 @@
+Fonts are (c) Bitstream (see below). DejaVu changes are in public domain.
+Glyphs imported from Arev fonts are (c) Tavmjong Bah (see below)
+
+Bitstream Vera Fonts Copyright
+------------------------------
+
+Copyright (c) 2003 by Bitstream, Inc. All Rights Reserved. Bitstream Vera is
+a trademark of Bitstream, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of the fonts accompanying this license ("Fonts") and associated
+documentation files (the "Font Software"), to reproduce and distribute the
+Font Software, including without limitation the rights to use, copy, merge,
+publish, distribute, and/or sell copies of the Font Software, and to permit
+persons to whom the Font Software is furnished to do so, subject to the
+following conditions:
+
+The above copyright and trademark notices and this permission notice shall
+be included in all copies of one or more of the Font Software typefaces.
+
+The Font Software may be modified, altered, or added to, and in particular
+the designs of glyphs or characters in the Fonts may be modified and
+additional glyphs or characters may be added to the Fonts, only if the fonts
+are renamed to names not containing either the words "Bitstream" or the word
+"Vera".
+
+This License becomes null and void to the extent applicable to Fonts or Font
+Software that has been modified and is distributed under the "Bitstream
+Vera" names.
+
+The Font Software may be sold as part of a larger software package but no
+copy of one or more of the Font Software typefaces may be sold by itself.
+
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
+OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OF COPYRIGHT, PATENT,
+TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL BITSTREAM OR THE GNOME
+FOUNDATION BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, INCLUDING
+ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL DAMAGES,
+WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF
+THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM OTHER DEALINGS IN THE
+FONT SOFTWARE.
+
+Except as contained in this notice, the names of Gnome, the Gnome
+Foundation, and Bitstream Inc., shall not be used in advertising or
+otherwise to promote the sale, use or other dealings in this Font Software
+without prior written authorization from the Gnome Foundation or Bitstream
+Inc., respectively. For further information, contact: fonts at gnome dot
+org.
+
+Arev Fonts Copyright
+------------------------------
+
+Copyright (c) 2006 by Tavmjong Bah. All Rights Reserved.
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the fonts accompanying this license ("Fonts") and
+associated documentation files (the "Font Software"), to reproduce
+and distribute the modifications to the Bitstream Vera Font Software,
+including without limitation the rights to use, copy, merge, publish,
+distribute, and/or sell copies of the Font Software, and to permit
+persons to whom the Font Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright and trademark notices and this permission notice
+shall be included in all copies of one or more of the Font Software
+typefaces.
+
+The Font Software may be modified, altered, or added to, and in
+particular the designs of glyphs or characters in the Fonts may be
+modified and additional glyphs or characters may be added to the
+Fonts, only if the fonts are renamed to names not containing either
+the words "Tavmjong Bah" or the word "Arev".
+
+This License becomes null and void to the extent applicable to Fonts
+or Font Software that has been modified and is distributed under the
+"Tavmjong Bah Arev" names.
+
+The Font Software may be sold as part of a larger software package but
+no copy of one or more of the Font Software typefaces may be sold by
+itself.
+
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL
+TAVMJONG BAH BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.
+
+Except as contained in this notice, the name of Tavmjong Bah shall not
+be used in advertising or otherwise to promote the sale, use or other
+dealings in this Font Software without prior written authorization
+from Tavmjong Bah. For further information, contact: tavmjong @ free
+. fr.
+
+$Id: LICENSE 2133 2007-11-28 02:46:28Z lechimp $
diff --git a/atari/doc/changes.txt b/atari/doc/changes.txt
new file mode 100755
index 000000000..e69de29bb
--- /dev/null
+++ b/atari/doc/changes.txt
diff --git a/atari/doc/faq.txt b/atari/doc/faq.txt
new file mode 100755
index 000000000..ce5363eb9
--- /dev/null
+++ b/atari/doc/faq.txt
@@ -0,0 +1,66 @@
+
+NETSURF ATARI FAQ
+
+Date: 15.02.2011
+
+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.) 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:
+ A PAGE CRASHES - WHAT CAN I DO?
+
+ Answer:
+ Try to increase the stack memory for netsurf with the stack tool,
+ example:
+ stack -S 3000k ./ns.prg
+
+ If this results in "insufficent memory" messages - look for the
+ FAQ entry.
+
+
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
diff --git a/atari/doc/todo b/atari/doc/todo.txt
index d62fbb35a..d62fbb35a 100755
--- a/atari/doc/todo
+++ b/atari/doc/todo.txt