From 92f3368c87b12f97d734881aab1c7c8ae9841b2b Mon Sep 17 00:00:00 2001 From: Michael Drake Date: Fri, 26 Sep 2003 16:40:57 +0000 Subject: [project @ 2003-09-26 16:40:57 by tlsa] New Documentation svn path=/import/netsurf/; revision=316 --- !NetSurf/Docs/en/dev,faf | 27 ++++++++++++++ !NetSurf/Docs/en/images/bmenu,b60 | Bin 0 -> 4785 bytes !NetSurf/Docs/en/images/bnmenu,b60 | Bin 0 -> 10667 bytes !NetSurf/Docs/en/images/bwin,b60 | Bin 0 -> 14747 bytes !NetSurf/Docs/en/images/conpan,b60 | Bin 0 -> 11703 bytes !NetSurf/Docs/en/images/conthem,b60 | Bin 0 -> 28849 bytes !NetSurf/Docs/en/images/imenu,b60 | Bin 0 -> 4749 bytes !NetSurf/Docs/en/images/logofull,b60 | Bin 0 -> 13366 bytes !NetSurf/Docs/en/images/logosmall,b60 | Bin 0 -> 7988 bytes !NetSurf/Docs/en/images/proxy,b60 | Bin 0 -> 6566 bytes !NetSurf/Docs/en/images/toolb,b60 | Bin 0 -> 8469 bytes !NetSurf/Docs/en/index,faf | 64 ++++++++++++++++++++++++++++++++++ !NetSurf/Docs/en/info,faf | 62 ++++++++++++++++++++++++++++++++ !NetSurf/Docs/en/netsurf,f79 | 57 ++++++++++++++++++++++++++++++ !NetSurf/Docs/en/user,faf | 53 ++++++++++++++++++++++++++++ 15 files changed, 263 insertions(+) create mode 100644 !NetSurf/Docs/en/dev,faf create mode 100644 !NetSurf/Docs/en/images/bmenu,b60 create mode 100644 !NetSurf/Docs/en/images/bnmenu,b60 create mode 100644 !NetSurf/Docs/en/images/bwin,b60 create mode 100644 !NetSurf/Docs/en/images/conpan,b60 create mode 100644 !NetSurf/Docs/en/images/conthem,b60 create mode 100644 !NetSurf/Docs/en/images/imenu,b60 create mode 100644 !NetSurf/Docs/en/images/logofull,b60 create mode 100644 !NetSurf/Docs/en/images/logosmall,b60 create mode 100644 !NetSurf/Docs/en/images/proxy,b60 create mode 100644 !NetSurf/Docs/en/images/toolb,b60 create mode 100644 !NetSurf/Docs/en/index,faf create mode 100644 !NetSurf/Docs/en/info,faf create mode 100644 !NetSurf/Docs/en/netsurf,f79 create mode 100644 !NetSurf/Docs/en/user,faf (limited to '!NetSurf/Docs/en') diff --git a/!NetSurf/Docs/en/dev,faf b/!NetSurf/Docs/en/dev,faf new file mode 100644 index 000000000..3b89d6b20 --- /dev/null +++ b/!NetSurf/Docs/en/dev,faf @@ -0,0 +1,27 @@ + + + +NetSurf: The open-source web browser for RISC OS + + + + +

Developer Information

Contribution to the project

As NetSurf is an open source project, everyone is welcome to contribute. If you would like to add some functionality to NetSurf then you can contact the other developers via either the #netsurf-develop IRC channel or mailing list.

Libraries used

NetSurf makes use of the following libraries:

Further information

There is further developer information in the Docs section of the NetSurf CVS repository.

+ + \ No newline at end of file diff --git a/!NetSurf/Docs/en/images/bmenu,b60 b/!NetSurf/Docs/en/images/bmenu,b60 new file mode 100644 index 000000000..e12489165 Binary files /dev/null and b/!NetSurf/Docs/en/images/bmenu,b60 differ diff --git a/!NetSurf/Docs/en/images/bnmenu,b60 b/!NetSurf/Docs/en/images/bnmenu,b60 new file mode 100644 index 000000000..7a94035da Binary files /dev/null and b/!NetSurf/Docs/en/images/bnmenu,b60 differ diff --git a/!NetSurf/Docs/en/images/bwin,b60 b/!NetSurf/Docs/en/images/bwin,b60 new file mode 100644 index 000000000..876ecd6d8 Binary files /dev/null and b/!NetSurf/Docs/en/images/bwin,b60 differ diff --git a/!NetSurf/Docs/en/images/conpan,b60 b/!NetSurf/Docs/en/images/conpan,b60 new file mode 100644 index 000000000..5226c7a6c Binary files /dev/null and b/!NetSurf/Docs/en/images/conpan,b60 differ diff --git a/!NetSurf/Docs/en/images/conthem,b60 b/!NetSurf/Docs/en/images/conthem,b60 new file mode 100644 index 000000000..a064e325a Binary files /dev/null and b/!NetSurf/Docs/en/images/conthem,b60 differ diff --git a/!NetSurf/Docs/en/images/imenu,b60 b/!NetSurf/Docs/en/images/imenu,b60 new file mode 100644 index 000000000..487e10e60 Binary files /dev/null and b/!NetSurf/Docs/en/images/imenu,b60 differ diff --git a/!NetSurf/Docs/en/images/logofull,b60 b/!NetSurf/Docs/en/images/logofull,b60 new file mode 100644 index 000000000..9dc185593 Binary files /dev/null and b/!NetSurf/Docs/en/images/logofull,b60 differ diff --git a/!NetSurf/Docs/en/images/logosmall,b60 b/!NetSurf/Docs/en/images/logosmall,b60 new file mode 100644 index 000000000..e0fc6e6f1 Binary files /dev/null and b/!NetSurf/Docs/en/images/logosmall,b60 differ diff --git a/!NetSurf/Docs/en/images/proxy,b60 b/!NetSurf/Docs/en/images/proxy,b60 new file mode 100644 index 000000000..066655eae Binary files /dev/null and b/!NetSurf/Docs/en/images/proxy,b60 differ diff --git a/!NetSurf/Docs/en/images/toolb,b60 b/!NetSurf/Docs/en/images/toolb,b60 new file mode 100644 index 000000000..3d6a0dc74 Binary files /dev/null and b/!NetSurf/Docs/en/images/toolb,b60 differ diff --git a/!NetSurf/Docs/en/index,faf b/!NetSurf/Docs/en/index,faf new file mode 100644 index 000000000..1cba8294b --- /dev/null +++ b/!NetSurf/Docs/en/index,faf @@ -0,0 +1,64 @@ + + + +NetSurf: The open-source web browser for RISC OS + + + + +

Introduction

NetSurf is an open-source web browser for RISC OS. Its aim is to bring the HTML 4 (HyperText Markup Language) and CSS (Cascading Style Sheet) technologies to the RISC OS platform. Currently, NetSurf supports only a fraction of these standards.

Documentation

The NetSurf documentation has been split into the following sections.

+ + + + + + + + + + + + + +

User Information	+ Downloading NetSurf + Different versions + Requirements + Contacting the developers + Current features & limitations + Known bugs +
User Guide	+ Using NetSurf + Toolbar description + Menus + Configuration +
Developer Information	+ Contribution to the project + Libraries used + Further information +

Developers

NetSurf's main developers are:

James Bursa
John Bell
Phil Mellor
Phil Pemberton
Rob Jackson

License

NetSurf is released under the GPL license.

+ +

NetSurf Links

Project homepage
Recent builds
Web CVS interface

+ + + + \ No newline at end of file diff --git a/!NetSurf/Docs/en/info,faf b/!NetSurf/Docs/en/info,faf new file mode 100644 index 000000000..8aca68e98 --- /dev/null +++ b/!NetSurf/Docs/en/info,faf @@ -0,0 +1,62 @@ + + + +NetSurf: The open-source web browser for RISC OS + + + + +

User Information

Downloading NetSurf

NetSurf is currently in beta. The latest version of NetSurf can be obtained from netsurf.strcprstskrzkrk.co.uk. As these builds are generated automatically from CVS, they are likely to be unstable and may crash your machine.

Different Versions

There are 32-bit and 26-bit NetSurf builds. The 26-bit versions are suitable for any processor up to StrongARM and the 32-bit versions will work on ARM6 and higher. Only the 32-bit versions will run on Castle's IYONIX pc.

The 32-bit builds of NetSurf include https support, although they require more memory.

Requirements

NetSurf requires the SharedUnixLibrary to run. Also, you may need to download the Acorn URI module.

Contacting the Developers

If you want to contribute to the NetSurf project, please see the Developer Information. Before submitting a bug report, please check that you have the latest version and check to see if the bug has already been discovered. Bug reports and questions about NetSurf can be raised in the following forms.

Mailing List

The netsurf-develop mailing list is for discussion of NetSurf. If you are interested in NetSurf's development, please subscribe to this list.

IRC Channel

The #netsurf-develop IRC channel on the IRCNet network is also for discussion of NetSurf. Both the ircnet.demon.co.uk and ircnet.easynet.co.uk servers are suitable.

Bug Tracker

Please submit any bugs to the bug tracker.

Current Features & Limitations

The following features have been implemented:

Basic HTML 4, including tables
Parts of CSS (display, text-align, float, width & height)
Local and HTTP fetching
Memory cache
External CSS files
<style> element
Encrypted HTTP or https (32-bit builds only)
Plugin System
Redirects
View Source
Support for Acorn URI Protocol and URI files
HTML forms, using GET method

The following is in progress:

GUI
PNG Support
JPEG Support
GIF Support
File downloads (eg. zip files)
HTML forms, using POST method
Improved Memory handling

We want to release a stable and fairly complete HTML / CSS browser before considering JavaScript support. To see what remains to be done in more detail, please see the TODO lists.

Known Bugs

No way to re-download a webpage, if it has been updated, without quitting NetSurf.
PNGs with transparency don't display correctly unless you have Select.
NetSurf quits when it runs out of memory

+ + + \ No newline at end of file diff --git a/!NetSurf/Docs/en/netsurf,f79 b/!NetSurf/Docs/en/netsurf,f79 new file mode 100644 index 000000000..c3a53ed3a --- /dev/null +++ b/!NetSurf/Docs/en/netsurf,f79 @@ -0,0 +1,57 @@ +html, body { +margin: 0; +padding: 0; +} + +h1.logofull { +padding: 0; +color: black; +text-align: left; +margin: 0 0 5mm 0; +background-color: #94adff; +border-bottom: medium solid black; +} + +p.logosmall { +padding: 0; +color: black; +text-align: right; +margin: 0 0 5mm 0; +background-color: #94adff; +border-bottom: medium solid black; +} + +h1 img { vertical-align: middle; } +p img { vertical-align: middle; } +h1, h2, h3 { font-family: sans-serif; } +h1, h2, h3, p, dl { margin: 5mm; } +h2, .thanks { padding-top: 5mm; border-top: thin solid black; } + +.screenshot, .footer { +text-align: center; +font-size: x-small; +} + +.contents { +text-align: left; +vertical-align: top; +} + + +.center { text-align: center; } +th { font-size: large; } + +img { border: none; } +div.cell { display: table-cell; } + +.links { display: table-cell; +border-left: thin solid black; +} + +dd { margin-bottom: 0.5em; } +.thanks img { vertical-align: middle; } + +a:link { color: #0000ff} +a:visited { color: #6678ff} +a:hover { color: #7070ff} +a:active {text-decoration: none; color: #7070ff} \ No newline at end of file diff --git a/!NetSurf/Docs/en/user,faf b/!NetSurf/Docs/en/user,faf new file mode 100644 index 000000000..3c852fb9d --- /dev/null +++ b/!NetSurf/Docs/en/user,faf @@ -0,0 +1,53 @@ + + + +NetSurf: The open-source web browser for RISC OS + + + + +

User Guide

Using NetSurf

To run NetSurf, simply double click on the NetSurf application. This will cause the NetSurf icon to appear on the iconbar. Select clicking on this icon will open a browser window. It should be noted that as NetSurf is at a very early stage of development, much of the following information is subject to change without warning.

Browser Window

The Toolbar

The section at the top of the window is called the toolbar. It allows quick access to various functions and information.

Toolbar

Back: Clicking on this button, makes NetSurf go back the the previous page in the history list. If you followed a link from one page to another, this button allows you to get back to the first page.

Reload: Clicking on this button causes NetSurf to reload the current page.

Forward: Clicking on this button allows you to advance through the history list.

Buttons that are grayed out indicate that their function is unavailable. This happens when you open a new browser window. Since the window will be displaying its first page, there would be no previous page and the back button is grayed out. Also, as this is the first page, the forward button is also grayed out.

URL Bar: This shows the location of the current page. Here, you can enter the address of the page you want to view next.

Throbber: This animates while a page is downloading or rendering. It indicates that NetSurf is doing something.

Status Line: This displays information to the user. When you move the pointer over a link, this will show the URL that the link points to. The status line also displays information about NetSurf's progress while retrieving a page.

Menus

NetSurf has two different menus, one is accessed by clicking menu over NetSurf's iconbar icon and the other is opened by clicking menu over a browser window.

Iconbar Menu

The iconbar menu is home to three options. These are Info, Configure and Quit. Info provides a little information about the application, while quit will exit the program, closing all browser windows. The configure option opens a window for configuring NetSurf. This is discussed in greater detail in the Configuring NetSurf section.

Iconbar Menu

Browser Window Menu

The browser window menu contains options relating to the content of that window. Many of these options are unavailable at present as this area of NetSurf is not complete. The following options are currently available:

Browser Menu

+ +

The navigate sub menu contains options useful for navigating the web.

Navigate Submenu

Navigate > Home This take you back to the NetSurf homepage.

Navigate > Back This has the same function as the back button on the toolbar.

Navigate > Forward This has the same function as the forward button on the toolbar.

Configuring NetSurf

You can change the way NetSurf looks and behaves, by configuring the program. The configuration panel is opened by clicking menu over the iconbar icon and selecting Choices.

Configuration Panel
Note: Screenshot taken on RISC OS Select 3

The Cancel button will close the window, discarding any changes you've made. Clicking on OK will save the new settings and close the window. Clicking on one of the other icons will allow you to configure that aspect of NetSurf.

Browser

The browser configuration window contains some general configuration options that apply to the main browser window. Many of these options are unavailable at the moment as NetSurf is still in development.

Proxy

The proxy configuration window allows you to enable and set an HTTP proxy. You can enter the address and port number of the proxy you want to use.

Proxy Setup Window
Note: Screenshot taken on RISC OS Select 3

Theme

NetSurf allows you to change the 'look and feel' of its interface. New themes can be downloaded from the NetSurf themes page and you can select your desired theme from this window.

Theme Selection Window
Note: Screenshot taken on RISC OS Select 3

+ + \ No newline at end of file -- cgit v1.2.3