
This is the README file for WordNet 1.7

1. About WordNet

WordNet was developed at Princeton University's Cognitive Science
Laboratory under the direction of George Miller, James S. McDonnell
Distinguished University Professor of Psychology, Emeritus. Over the
years many linguists, lexicographers, students, and software engineers
have contributed to the project.

WordNet is an online lexical reference system.  Word forms in WordNet
are represented in their familiar orthography; word meanings are
represented by synonym sets (synset) - lists of synonymous word forms
that are interchangeable in some context.  Two kinds of relations are
recognized: lexical and semantic.  Lexical relations hold between word
forms; semantic relations hold between word meanings.  

To learn more about WordNet, read "Five Papers on WordNet", available
via anonymous FTP from our Web site and in printed form.  A book,
"WordNet: An Electronic Lexical Database", containing an updated
version of "Five Papers on WordNet" and additional papers by WordNet
users, is available from MIT Press:

    http://mitpress.mit.edu/book-home.tcl?isbn=026206197X

Information about WordNet, access to our online interface, and the
various WordNet packages that you can download are available from our
Web site.  All of the package documentation is also available online,
as well as a FAQ.  On this site we also have information about other
uses of WordNet.

    http://www.cogsci.princeton.edu/~wn/

2. Contacting Us

Ongoing deveopment work and WordNet related projects are done by a
small group of researchers, lexicographers, and systems programmers.
Since our resources are VERY limited, we request that you please
confine correspondence to WordNet topics only.

When reporting a problem, please be as specific as possible, stating
the computer platform you are using, which interface you are using,
and the exact error.  The more details you can provide, the more
likely it is that you will get an answer.  With release 1.7, we have
added a FAQ to our Web site.  Please refer to the FAQ first to see if
your problem or question is already addressed here.

Please address all e-mail concerning WordNet to 'wordnet@princeton.edu'.

We maintain a database of "registered" WordNet users.  We use this
database to send mail to users when necessary (such as announcing a
new release), and also to help keep track of the number of users we
have, which in turn helps us with important items such as funding.  If
you download WordNet, you are encouraged to send e-mail to the address
above, stating which platform you're using.

In addition to the user database, there is a WordNet user discussion
group mailing list.  Information on joining the user mailing list
is in the file README.ml.

3. The WordNet Web Site

We maintain a Web site at http://www.cogsci.princeton.edu/~wn/

From this site users can download WordNet, run a Web interface to
WordNet, and download "Five Papers on WordNet".  We also maintain links
to other related projects and online interfaces to WordNet, and an
extensive (but by no mean complete) bibliography.  We will add links
to user applications and papers.  Please send e-mail to the above
address.

With version 1.7 we have added a FAQ file to our Web site.  If you
have trouble installing or downloading WordNet, have a bug to report,
or any other problem, please refer to the FAQ first.  If you can heal
thyself, please do so.  The FAQ will be updated over time.  And if you
do find a previously unreported problem, please report it to
'wordnet@princeton.edu'.

4. WordNet Packages

WordNet Version 1.7 is the only version available for download at this
time.  See the file CHANGES for information about changes from version
1.6.  

Several different WordNet packages are available.  All are available
from the WordNet FTP site.  Most users require only the "Database
package".  An explanation of each package follows.  Please note that
the packages will not be released all at once, so if you are an early
1.7 user, some of the packages described below may not be available
yet.  Please check back at our Web site for new packages.

4.1 Database Package 

The database package is a complete installation for WordNet 1.7 users.
It includes the 1.7 database files, precompiled binaries for the
supported platforms specified below, source code for the WordNet
browsers and library, and documentation.  The other packages are not
included - they must be downloaded and installed separately.

4.2 Semantic Concordance Package

The semantic concordance package is no longer available as of WordNet
1.7. If you need the Semantic Concordance for WordNet 1.6 (and the 1.6
database), please contact 'wordnet@princeton.edu'.

4.3 Prolog Database Package

The WordNet 1.7 database files are available in a Prolog-readable
format.  Documentation describing the file format is included.  This
package is only downloadable in compressed tar file format, although
once unpackaged it can be used from PC and Macintosh systems since the
files are in ASCII.

4.4 Sense Map Package 

To help users automatically convert 1.6 senses to their corresponding
1.7 senses, we provide sense mapping information in this package.  The
sense map package contains files to map polysemous and monosemous
senses, and documentation that describes the format of these files.
As with the Prolog database, this package is only downloadable in
compressed tar file format, but the files are also in ASCII.

5. Supported Platforms

Precompiled binaries for the WordNet browsers and library are included
in the database package for the following platforms.

Note that these are the platforms that the binaries were compiled on.
Most should work on newer versions of the operating system.

	Sun SPARC Solaris 7        
	Red Hat Linux 7.0
        Windows 98
	Windows 2000
	Windows NT
	Silicon Graphics Irix 6.5.8

Source code is included in the database package so users on different
computer platforms can compile the WordNet library and browsers for
their system.

6. Disk Space Requirements

The WordNet database package requires approximately 31MB of disk
space, depending on computer platform.  The sense index (6.6MB) file
is optional, and can be removed to save space.  The database alone
requires 23.5MB of disk space.

The space requirements of the various packages can be found on the
"Download" page on the WordNe Web site.

7. Obtaining WordNet 1.7 Packages via FTP

We prefer that you FTP the WordNet system via anonymous FTP from one
of the following FTP sites:

	In the US: ftp.cogsci.princeton.edu [128.112.144.11]
	In Europe: ftp.ims.uni-stuttgart.de [141.58.127.61]

Anyone who wants to mirror this release on an FTP server should notify
Princeton in advance.

7.1 FTP Packages

In order to facilitate downloading, some of the packages are available
as either a single file or a series of smaller files.  If you download
a package that has been split into smaller files, as indicated by the
suffix ".tar.gz.aX" where "X" is a lower case letter, you must
download all of the individual files in the package.  

Please note that the packages will not be released all at once, so if
you are an early 1.7 user, some of the packages described below may
not be available yet.  Please check back at our Web site for new
packages.

7.1.1 WordNet Database Packages

Includes WordNet 1.7 database, interfaces, sense index, interface and
library source code, and documentation.
	
	wn17.unix.tar.gz	Unix
	wn17.unix.tar.gz.aX	Unix (split into 512K chunks)
	wn17pc.exe		PC
	wn17pcm.*		PC (split into 512K chunks)

7.1.2 Prolog Database

Includes WordNet 1.7 database in Prolog-readable format and
documentation.

	prolog17.tar.gz		All Platforms
	prolog17.tar.gz.aX	All Platforms (split into 512K chunks)

7.1.3 Sense Map Package

Includes files mapping of 1.6 noun senses to 1.7 senses and
documentation. 

	snsmap17.tar.gz		All Platforms

7.1.4 "Five Papers on WordNet"

The paper "Five Papers on WordNet" is available in several different
formats:

	5papers.pdf		PDF file
	5papers.ps		Postscript file
	5papers.tar.Z		compress tar file of nroff source

7.1.5 Other Files
	
	README			this file
	README.*		various other README files
	CHANGES			changes to WordNet made since version 1.6
	LICENSE			WordNet license
	INSTALL.unix		Unix installation instructions
	INSTALL.pc		PC installation instructions
	FAQ			Frequently Asked Questions
	
7.2 Downloading WordNet via FTP

You can download WordNet directly from the Princeton or Stuttgart FTP
sites or via links on the WordNet Web site.  You should download
whichever package files you need and the appropriate INSTALL file for
your system.

	***** REMEMBER TO FTP IN "binary" MODE!!! *****

**************************************************************************
* IF YOU FTP WordNet, PLEASE SEND MAIL TO wordnet@princeton.edu SO WE    *
* CAN UPDATE OUR RECORDS AND KEEP TRACK OF OUR USERS FOR FUTURE MAILINGS *
* AND RELEASES.  EVEN IF YOU ARE A CURRENT USER WHO IS UPGRADING, IT IS  *
* USEFUL TO US TO KNOW THAT YOU HAVE UPGRADED TO 1.7.                    *
**************************************************************************

7.2.1 Princeton FTP Site

	Host:      ftp.cogsci.princeton.edu [128.112.144.11]
	Login:     ftp
	Password:  Your e-mail address
	Directory: pub/wordnet

7.2.2 Stuttgart Mirror FTP Site

	Host:      ftp.ims.uni-stuttgart.de [141.58.127.61]
	Login:     ftp
	Password:  Your e-mail address
	Directory: /pub/WordNet/1.7

Note: 'ls' sometimes doesn't work properly, 'dir' shows everything.

Due to the size of the WordNet distribution, please restrict
downloading to time frames outside office hours (i.e. outside 9 a.m. -
6 p.m.).

All queries regarding the installation of the system, its use and
maintenance should be made to wordnet@princeton.edu only.

7.2.3 Downloading Compressed Tar File Packages

Some of the packages (those with the extension "tar.gz") have been
archived with tar and compressed with 'gzip'.  To install a package
compressed with 'gzip', you need to have 'gzip' (or 'gunzip') on your
system.  If you don't, you can download it from "prep.ai.mit.edu" or
one of the numerous FTP sites that mirror the GNU software.

If you download a package that has been split into smaller files, as
indicated by the suffix ".tar.gz.aX" where "X" is a lower case letter,
you must download all of the individual files in the package.

Note that some of the compressed tar file packages can be used on PC
systems once unbundled, however they must be unpackaged by a tool such
as WinZip that understands how to unbundle files in this format.

7.2.4 Downloading PC Packages

PC packages are distributed as compressed self extracting archives.
Each package is in a single file.  Simply run the downloaded file to
unbundle the archive.

8. Installation

The INSTALL files listed below contain instructions for unbundling
packages on that platform.  You should FTP the appropriate file for
your platform.

	INSTALL.unix		Unix installation instructions
	INSTALL.pc		PC installation instructions

Each package, when unbundled, contains a file, INSTALL, with
installation instructions for that package.

9. Bugs

Before reporting download or installation problems, or bugs, please
check the FAQ file that's on our Web site to see if your situation is
already addressed there.  If not, then report WordNet related
questions to 'wordnet@princeton.edu'.

The FAQ and various README.* files will be udated periodically in
response to problems and such reported by users.
