From c8589034e9aec63a39ea0ea960f234f4c22eb953 Mon Sep 17 00:00:00 2001 From: James Bursa Date: Fri, 27 Feb 2004 13:56:26 +0000 Subject: [project @ 2004-02-27 13:56:26 by bursa] Remove old doc files (now in netsurfweb cvs). svn path=/import/netsurf/; revision=573 --- !NetSurf/Docs/en/dev,faf | 27 ----------- !NetSurf/Docs/en/images/back,b60 | Bin 422 -> 0 bytes !NetSurf/Docs/en/images/bmenu,b60 | Bin 4785 -> 0 bytes !NetSurf/Docs/en/images/bnmenu,b60 | Bin 10667 -> 0 bytes !NetSurf/Docs/en/images/bwin,b60 | Bin 18338 -> 0 bytes !NetSurf/Docs/en/images/conpan,b60 | Bin 11703 -> 0 bytes !NetSurf/Docs/en/images/conthem,b60 | Bin 28849 -> 0 bytes !NetSurf/Docs/en/images/forward,b60 | Bin 433 -> 0 bytes !NetSurf/Docs/en/images/history,b60 | Bin 481 -> 0 bytes !NetSurf/Docs/en/images/home,b60 | Bin 427 -> 0 bytes !NetSurf/Docs/en/images/imenu,b60 | Bin 4749 -> 0 bytes !NetSurf/Docs/en/images/logofull,b60 | Bin 13366 -> 0 bytes !NetSurf/Docs/en/images/logosmall,b60 | Bin 7988 -> 0 bytes !NetSurf/Docs/en/images/mark,b60 | Bin 419 -> 0 bytes !NetSurf/Docs/en/images/mini,b60 | Bin 4617 -> 0 bytes !NetSurf/Docs/en/images/print,b60 | Bin 443 -> 0 bytes !NetSurf/Docs/en/images/proxy,b60 | Bin 6566 -> 0 bytes !NetSurf/Docs/en/images/reload,b60 | Bin 507 -> 0 bytes !NetSurf/Docs/en/images/save,b60 | Bin 436 -> 0 bytes !NetSurf/Docs/en/images/stop,b60 | Bin 494 -> 0 bytes !NetSurf/Docs/en/images/toolb,b60 | Bin 5972 -> 0 bytes !NetSurf/Docs/en/index,faf | 83 -------------------------------- !NetSurf/Docs/en/info,faf | 59 ----------------------- !NetSurf/Docs/en/intro,faf | 78 ------------------------------ !NetSurf/Docs/en/netsurf,f79 | 62 ------------------------ !NetSurf/Docs/en/themes,faf | 50 ------------------- !NetSurf/Docs/en/user,faf | 88 ---------------------------------- !NetSurf/Docs/intro.en,faf | 79 ++++++++++++++++++++++++++++++ 28 files changed, 79 insertions(+), 447 deletions(-) delete mode 100644 !NetSurf/Docs/en/dev,faf delete mode 100755 !NetSurf/Docs/en/images/back,b60 delete mode 100644 !NetSurf/Docs/en/images/bmenu,b60 delete mode 100644 !NetSurf/Docs/en/images/bnmenu,b60 delete mode 100644 !NetSurf/Docs/en/images/bwin,b60 delete mode 100644 !NetSurf/Docs/en/images/conpan,b60 delete mode 100644 !NetSurf/Docs/en/images/conthem,b60 delete mode 100755 !NetSurf/Docs/en/images/forward,b60 delete mode 100755 !NetSurf/Docs/en/images/history,b60 delete mode 100755 !NetSurf/Docs/en/images/home,b60 delete mode 100644 !NetSurf/Docs/en/images/imenu,b60 delete mode 100644 !NetSurf/Docs/en/images/logofull,b60 delete mode 100644 !NetSurf/Docs/en/images/logosmall,b60 delete mode 100755 !NetSurf/Docs/en/images/mark,b60 delete mode 100755 !NetSurf/Docs/en/images/mini,b60 delete mode 100755 !NetSurf/Docs/en/images/print,b60 delete mode 100644 !NetSurf/Docs/en/images/proxy,b60 delete mode 100755 !NetSurf/Docs/en/images/reload,b60 delete mode 100755 !NetSurf/Docs/en/images/save,b60 delete mode 100755 !NetSurf/Docs/en/images/stop,b60 delete mode 100644 !NetSurf/Docs/en/images/toolb,b60 delete mode 100644 !NetSurf/Docs/en/index,faf delete mode 100644 !NetSurf/Docs/en/info,faf delete mode 100644 !NetSurf/Docs/en/intro,faf delete mode 100644 !NetSurf/Docs/en/netsurf,f79 delete mode 100644 !NetSurf/Docs/en/themes,faf delete mode 100644 !NetSurf/Docs/en/user,faf create mode 100644 !NetSurf/Docs/intro.en,faf (limited to '!NetSurf/Docs') diff --git a/!NetSurf/Docs/en/dev,faf b/!NetSurf/Docs/en/dev,faf deleted file mode 100644 index 8e63d699b..000000000 --- a/!NetSurf/Docs/en/dev,faf +++ /dev/null @@ -1,27 +0,0 @@ - - - -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 generated by Doxygen.

- - \ No newline at end of file diff --git a/!NetSurf/Docs/en/images/back,b60 b/!NetSurf/Docs/en/images/back,b60 deleted file mode 100755 index bb3b3d626..000000000 Binary files a/!NetSurf/Docs/en/images/back,b60 and /dev/null differ diff --git a/!NetSurf/Docs/en/images/bmenu,b60 b/!NetSurf/Docs/en/images/bmenu,b60 deleted file mode 100644 index e12489165..000000000 Binary files a/!NetSurf/Docs/en/images/bmenu,b60 and /dev/null differ diff --git a/!NetSurf/Docs/en/images/bnmenu,b60 b/!NetSurf/Docs/en/images/bnmenu,b60 deleted file mode 100644 index 7a94035da..000000000 Binary files a/!NetSurf/Docs/en/images/bnmenu,b60 and /dev/null differ diff --git a/!NetSurf/Docs/en/images/bwin,b60 b/!NetSurf/Docs/en/images/bwin,b60 deleted file mode 100644 index 87876d528..000000000 Binary files a/!NetSurf/Docs/en/images/bwin,b60 and /dev/null differ diff --git a/!NetSurf/Docs/en/images/conpan,b60 b/!NetSurf/Docs/en/images/conpan,b60 deleted file mode 100644 index 5226c7a6c..000000000 Binary files a/!NetSurf/Docs/en/images/conpan,b60 and /dev/null differ diff --git a/!NetSurf/Docs/en/images/conthem,b60 b/!NetSurf/Docs/en/images/conthem,b60 deleted file mode 100644 index a064e325a..000000000 Binary files a/!NetSurf/Docs/en/images/conthem,b60 and /dev/null differ diff --git a/!NetSurf/Docs/en/images/forward,b60 b/!NetSurf/Docs/en/images/forward,b60 deleted file mode 100755 index 7f2c44829..000000000 Binary files a/!NetSurf/Docs/en/images/forward,b60 and /dev/null differ diff --git a/!NetSurf/Docs/en/images/history,b60 b/!NetSurf/Docs/en/images/history,b60 deleted file mode 100755 index 56f7b4f01..000000000 Binary files a/!NetSurf/Docs/en/images/history,b60 and /dev/null differ diff --git a/!NetSurf/Docs/en/images/home,b60 b/!NetSurf/Docs/en/images/home,b60 deleted file mode 100755 index 7046557c5..000000000 Binary files a/!NetSurf/Docs/en/images/home,b60 and /dev/null differ diff --git a/!NetSurf/Docs/en/images/imenu,b60 b/!NetSurf/Docs/en/images/imenu,b60 deleted file mode 100644 index 487e10e60..000000000 Binary files a/!NetSurf/Docs/en/images/imenu,b60 and /dev/null differ diff --git a/!NetSurf/Docs/en/images/logofull,b60 b/!NetSurf/Docs/en/images/logofull,b60 deleted file mode 100644 index 9dc185593..000000000 Binary files a/!NetSurf/Docs/en/images/logofull,b60 and /dev/null differ diff --git a/!NetSurf/Docs/en/images/logosmall,b60 b/!NetSurf/Docs/en/images/logosmall,b60 deleted file mode 100644 index e0fc6e6f1..000000000 Binary files a/!NetSurf/Docs/en/images/logosmall,b60 and /dev/null differ diff --git a/!NetSurf/Docs/en/images/mark,b60 b/!NetSurf/Docs/en/images/mark,b60 deleted file mode 100755 index c3bc4a73d..000000000 Binary files a/!NetSurf/Docs/en/images/mark,b60 and /dev/null differ diff --git a/!NetSurf/Docs/en/images/mini,b60 b/!NetSurf/Docs/en/images/mini,b60 deleted file mode 100755 index 8e4544264..000000000 Binary files a/!NetSurf/Docs/en/images/mini,b60 and /dev/null differ diff --git a/!NetSurf/Docs/en/images/print,b60 b/!NetSurf/Docs/en/images/print,b60 deleted file mode 100755 index b5b03870c..000000000 Binary files a/!NetSurf/Docs/en/images/print,b60 and /dev/null differ diff --git a/!NetSurf/Docs/en/images/proxy,b60 b/!NetSurf/Docs/en/images/proxy,b60 deleted file mode 100644 index 066655eae..000000000 Binary files a/!NetSurf/Docs/en/images/proxy,b60 and /dev/null differ diff --git a/!NetSurf/Docs/en/images/reload,b60 b/!NetSurf/Docs/en/images/reload,b60 deleted file mode 100755 index 65644481b..000000000 Binary files a/!NetSurf/Docs/en/images/reload,b60 and /dev/null differ diff --git a/!NetSurf/Docs/en/images/save,b60 b/!NetSurf/Docs/en/images/save,b60 deleted file mode 100755 index d1ee0740c..000000000 Binary files a/!NetSurf/Docs/en/images/save,b60 and /dev/null differ diff --git a/!NetSurf/Docs/en/images/stop,b60 b/!NetSurf/Docs/en/images/stop,b60 deleted file mode 100755 index 887c34ce6..000000000 Binary files a/!NetSurf/Docs/en/images/stop,b60 and /dev/null differ diff --git a/!NetSurf/Docs/en/images/toolb,b60 b/!NetSurf/Docs/en/images/toolb,b60 deleted file mode 100644 index 4f9d0bd70..000000000 Binary files a/!NetSurf/Docs/en/images/toolb,b60 and /dev/null differ diff --git a/!NetSurf/Docs/en/index,faf b/!NetSurf/Docs/en/index,faf deleted file mode 100644 index 24e33c203..000000000 --- a/!NetSurf/Docs/en/index,faf +++ /dev/null @@ -1,83 +0,0 @@ - - - -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	- Requirements - Contacting the developers - Current features & limitations - Known bugs -
User Guide	- Using NetSurf - Toolbar description - Menus - Keyboard shortcuts - URL shortcuts - Configuration -
Developer Information	- Contribution to the project - Libraries used - Further information -
NetSurf Themes	- Introduction & Overview - Tools required - Creating templates - Sprites - Packaging your theme - Submitting your theme -

Contributors

NetSurf's main developers are:

James Bursa
John Bell
Phil Mellor
Phil Pemberton
Rob Jackson

Other contributors include:

Andrew Poole - (GUI stuff)
Andrew Duffell - (Website work, NetSurf logo and other graphics, beta testing)
James Shaw - (Started the NetSurf project)
Michael Drake - (Most of this documentation, default theme graphics, beta testing)

Also, thanks to everyone else who has helped with bug reports and suggestions. If you feel you should be mentioned on the above list or have any other issues with it, please post to the mailing list or contact me directly.

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 deleted file mode 100644 index bf4d0286d..000000000 --- a/!NetSurf/Docs/en/info,faf +++ /dev/null @@ -1,59 +0,0 @@ - - - -NetSurf: The open-source web browser for RISC OS - - - - -

User Information

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
External CSS files
<style> element
Local and HTTP fetching
Encrypted HTTP or https
HTML forms, using GET and POST methods
Cookie support
Browser authentication
Redirects
Memory cache
Plugin System
View Source (Press F8)
Save as Drawfile (Press Ctrl+Shift+F3)
Support for Acorn URI Protocol and URI files

The following is in progress:

GUI
PNG Support
JPEG Support
GIF Support
File downloads (eg. zip files)
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/intro,faf b/!NetSurf/Docs/en/intro,faf deleted file mode 100644 index 0cd086987..000000000 --- a/!NetSurf/Docs/en/intro,faf +++ /dev/null @@ -1,78 +0,0 @@ - - - -NetSurf | Open Source Web Browser for RISC OS - - - - -

- -

NetSurf is an open-source web browser for RISC OS. Its aim is to -bring HTML 4 and CSS standards to the RISC OS platform. For more -information about NetSurf see the documentation.

- -

Current Status

NetSurf is currently incomplete and many features aren't yet implemented. -If you experience any crashes or unexpected behaviour while using NetSurf -please report the problem to the developers.

- -

NetSurf Links

- -

NetSurf home page: The NetSurf website
SourceForge project -page: SourceForge provides the mailing list, bug tracker, and other services
Test builds: Built automatically from the latest source
Bug -tracker: Please submit bugs to the tracker, or report them to the mailing list
Development -mailing list: Subscribe to the list if you plan to develop or test NetSurf
CVS web interface: Browse the source code using the web interface

- -

Search the web

- - - -

Web Standards

World Wide Web Consortium

- -

RISC OS Links

Drobe Launch Pad
The Icon Bar

- -

NetSurf Themes

Introduction & Overview

NetSurf has inbuilt support for themed icons and status bar tools. This document details how to create your own themes for NetSurf.

Tools Required

In order to create a new theme, you will require the following tools:

A template editor
A sprite file editor

Creating Templates

The best way to go about creating a new theme is to take the templates for the default theme and edit them with a template editor.

The templates file must contain one template. It should be called "toolbar".

Toolbar

The toolbar template must contain the following icons, which must be numbered (as indicated in parentheses):

Throbber (1)
URL entry bar (2)
Status bar (3)
History Button (4)
Refresh Button (5)
Stop Button (6)
Back Button (7)
Forward Button (8)
Bookmark Button (9)
Save Button (10)
Print Button (11)
Home Button (12)

Sprites

Sprites should be contained in a single file named "Sprites".

Throbber sprites should display the various stages of progress and should be named "throbberN", where N is a numerical suffix (eg throbber0, throbber 23 etc).

Button sprites can be called whatever you like. The only limitation is that two sprites are provided per button - one unpressed, the other pressed. Also, the template validation strings for each button should contain the sprite names (eg Sbackl,backp)

Optional Preview Sprite

You may optionally provide a preview sprite for display in the theme configuration dialogue box. The sprite must be in a file called "Preview" and the sprite itself must be called "preview".

Packaging your Theme

The default packaging for NetSurf themes is simply a folder named the same as your theme name (eg "Clear" for the Clear theme). Simply place all the files for your theme into a single directory, name the directory appropriately and create a Zip archive containing your theme.

Submitting your Theme

Themes may be uploaded to the central NetSurf Theme repository at http://netsurf.sourceforge.net/themes/.

- - \ No newline at end of file diff --git a/!NetSurf/Docs/en/user,faf b/!NetSurf/Docs/en/user,faf deleted file mode 100644 index fa5fd84e3..000000000 --- a/!NetSurf/Docs/en/user,faf +++ /dev/null @@ -1,88 +0,0 @@ - - - -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. The standard, or Default, toolbar is shown below.

Toolbar

There are several different variations on this toolbar available, eg this minimal one:

Mini Toolbar

In addition to this, NetSurf supports themes, which allow users to customize the look and feel of the program.

Toolbar Icons

Again, it should be noted that, as NetSurf is in development, many of the icons don't do anything yet. In such situations, the following text describes what the icon will do, when the associated feature has been implemented.

URL Bar: The white writable icon on the toolbar is called the URL Bar and it shows the location of the current page. Here, you can enter the address of the page you want to view next.

Status Line: This text 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.

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

- - - - - - - - - - -

	Back: Clicking on this button makes NetSurf go back to 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. Select click to view the previous page in the current window. Adjust click to view it in a new window.
	Bookmark: Select clicking on this button adds the current location to the bookmarks or favourites. Adjust clicking opens the bookmarks window.
	Forward: Clicking on this button allows you to advance through the history list. Select click to view the next page in the current window. Adjust click to view it in a new window.
	History: Clicking on this button opens a window containing a history tree. Clicking on an item in this window will move to the relevant page in the history.
	Home: Clicking on this button returns to the configured home page.
	Print: Clicking on this button will print the current page.
	Reload: Clicking on this button will make NetSurf fetch and redraw the current page again.
	Save: Clicking on this button will open a save dialogue box, to allow you to save the page for future reference.
	Stop: Clicking on this button stops whatever process that window is doing.

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.

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.

Keyboard Shortcuts

NetSurf supports keyboard shortcuts, which allow quick access to features and make NetSurf easier to use. The supported keypresses and corresponding functions are listed below.

- - - - - - - - - - - -

Shortcut	Function
Page Down	Scroll down by one page
Page Up	Scroll up by one page
Cursor Down	Scroll down one line
Cursor Up	Scroll up one line
Ctrl+Cursor Down	Go to bottom of page
Ctrl+Cursor Up	Go to top of page
F8	View webpage source
F11	View box outlines. This may be useful if you are creating your own webpage. Cyan marks the content's edge, magenta marks the padding's edge and yellow marks the margin's edge.
Ctrl+F2	Closes the window
Ctrl+Shift+F3	Save the page as a Drawfile to !NetSurf.draw

URL Shortcuts

NetSurf also supports URL shortcuts, which allow quick access to various pages. The supported URL shortcuts are listed below. Type them into a NetSurf URL bar to see the corresponding page.

- - - - - -

Shortcut	Page
about:	The NetSurf About page
about:cookies	List of cookies stored by NetSurf
help:	NetSurf documentation
home:	NetSurf home page

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 diff --git a/!NetSurf/Docs/intro.en,faf b/!NetSurf/Docs/intro.en,faf new file mode 100644 index 000000000..d6780e36d --- /dev/null +++ b/!NetSurf/Docs/intro.en,faf @@ -0,0 +1,79 @@ + + + +NetSurf | Open Source Web Browser for RISC OS + + + + + + +

+ +

NetSurf is an open-source web browser for RISC OS. Its aim is to +bring HTML 4 and CSS standards to the RISC OS platform. For more +information about NetSurf see the documentation.

+ +

Current Status

NetSurf is currently incomplete and many features aren't yet implemented. +If you experience any crashes or unexpected behaviour while using NetSurf +please report the problem to the developers.

+ +