W3C LMB INSTALL

Installation Guide

This section describes how to install the World-Wide Web Line Mode Browser called "www".

Getting the Program

Often you don't need to compile the browser yourself, precompiled binaries are available for many Unix platforms. If there is no precompiled version for your platform, of if it doesn't work (e.g. the name resolution doesn't work), you should get the source code and compile it yourself. There are special instructions if you are installing under VMS.

There is a lot of precompiled binary versions available in the subdirectory corresponding to your machine architecture.

If you prefer the source code, the the latest source code is available in the following formats:

from our destribution archives.

NOTE Please note that you also need the W3C Reference Library in order to compile the browser.

Unpacking

Unpacking the destribution file depends on which source destribution file you got (compressed tar file, gzip'ed tar file, or a zip file). However, in any case you need to unpack both the W3C Reference Library and the Line Mode Browser.

compressed tar file

        uncompress www_src.tar.Z
        tar xvf www_src.tar

        uncompress libwww_src.tar.Z
        tar xvf libwww_src.tar

gzip'ed tar file

        gunzip www_src.tar.gz
        tar xvf www_src.tar

        gunzip libwww_src.tar.gz
        tar xvf libwww_src.tar

zip file

        unzip www_src.zip

        unzip libwww_src.zip

Compilation

Stop here and jump to the Known Bugs and Patches page to see if you need to apply any patches before you compile.

Compilation on most platforms is done using the BUILD script which figures out what platform you are using. However, there are special instructions for installation on VMS and Windows NT.

If you have build earlier versions of the W3C software and you already have a WWW directory then it is very important that you do the following:

	cd WWW
	make clobber
	./BUILD linemode
in order to make sure that all new code is built. If not then go to newly-created WWW directory, and type:
        ./BUILD linemode
If you encounter problems during compilation or your don't have the compiler which the BUILD script uses then then please read the section on how to modify the BUILD script.

The executable browser, "www" appears in the directory

	../WWW/LineMode/<your.platform>
As an example, in case your platform is SunOs, the directory is "sun4".

Customization

Copy "www" into an appropriate directory which appears in your path. If you can be superuser, this can be /usr/local/bin/www (typically) so that everyone can use "www". If you type "rehash", you will be able to use "www". It will start at a default home page which is at W3C.

You must now check that the default homepage works, and customize it if it is not what you want. The default home page just a place to start.


Tim BL, and Henrik Frystyk, www-bug@w3.org, November 1995