//
//    readme.txt - http server development notes
//
// portions Copyright (c) 1999-2009 Nokia Corporation and/or its subsidiary(-ies).
// All rights reserved.
// This component and the accompanying materials are made available
// under the terms of "Eclipse Public License v1.0"
// which accompanies this distribution, and is available
// at the URL "http://www.eclipse.org/legal/epl-v10.html".
//
// Initial Contributors:
// Nokia Corporation - initial contribution.
//
// Contributors:
//
// Description:
//
////////////////////////////////////////////////////////////////

Hi !

I've put in the CVS a new version of the webserver.
This versions suports GET(1), HEAD(1), PUT(2), DELETE(2), TRACE & OPTIONS Methods.
It allows the webmaster to define the relationship between extension and content-type (see WSTYPES.CFG)
It allows the webmaster to define his own HTML errors messages.

This version has also 3 new files :

ws.cfg 			-> This the configuration file of the webserver.
wstypes.cfg		-> This file defines the relation ship between extension and content-types.
webserver.log		-> This file is automatically generated by the webserver. It is used by the webmaster
			   to undelete files which has been deleted by a PUT or DELETE method.
By now, this files must be in the root directory. (\epoc32\wins\C\ in the emulator)

WS.CFG
============

BACKUP_PATH=\ws\backups\	-> Set the directory for security copies of deleted files by the PUT & DELETE methods.
ERROR_PATH=\ws\error\		-> Set the directory where the user has his own HTML error messages.
SERVER_PATH=\ws\		-> Set the root directory of the webserver.
DEFAULT_RESOURCE=home.htm	-> Set the default resource name. 
				   (e.g: http:://www.6pack.fi/tcpip/ => http:://www.6pack.fi/tcpip/home.htm)
PORT=2080			-> Set the listen port.

(Note: All the values which are not defined in ws.cfg are set with defaults values.)
WSTYPES.CFG
===========

<extension_name>	<content-type>
(e.g:
html	text/html
htm	text/html
txt	text/plain
gif	image/gif
jpg	image/jpeg
js	application/octet-stream
ps	application/postscript 
)

HTML error files
================

The HTML error files must be named as "errorXXX.htm".
The XXX is the error number. (eg: 404 Not found error will have a "error404.htm" HTML error file)
If there is no error file definied the webserver will use its defaults HTML error messages.

GET & HEAD Methods (1)
======================

This version of the webserver doesn't allow queries in these methods.Although, it will support very soon.

PUT & DELETE Methods (2)
========================

These methods are allowed, but there is no authentication implemented yet. That means everybody can use these
methods with out being authorized !!!
 
/***************************************** NEW VERSION (8 - 2 - 2000) **************************************/
WS.CFG (new fields) 
============

DELETE_METHOD=[Yes/No]	-> Enable/Disable the delete method in the websever.
CGI_PATH=\ws\cgi-bin\	-> Set the directory for CGIs.

GET & HEAD Methods (1)
======================

This version allows queries in these methods.
Range Requests are supported.

POST Method
============

The Post method is supported.

TRACE Method
============

The Trace method is supported.

OPTIONS Method
==============

The Options method is supported.

GENERAL Issues
===============

Chuncked Enconding is NOT supported.
Authentication is NOT supported.
Restricted URI access is NOT supported.
Multi-Host is NOT supported.

/***************************************** NEW VERSION (24 - 3 - 2000) **************************************/

WS.CFG & WSTYPES.CFG
====================

These files are now located in \DATA\ directory.

You can modify them through the new interface in the Webserver. Config data can only be changed with the WebServer
stopped.

GET & HEAD Methods 
==================

Multi-range request are supported.

GENERAL Issues
===============

New User Interface.

No Panic when config files are missing. Now, there are nice warnings.

Console displays HTTP Request and Responses headers.It also displays remote addresses. 
(These messages can be enable/disable) 

Help is still under construction.

Chuncked Enconding is NOT supported.
Authentication is NOT supported.
Restricted URI access is NOT supported.
Multi-Host is NOT supported.