The Java Tutorial FAQ

About the Tutorial

What is "the Java Tutorial"?

The Java Tutorial is a programmer's guide for the Java platform. It has two forms:

  1. The online version — This version is a hyperlinked, interactive set of HTML pages available on the World-Wide Web.
  2. The books — The first edition of The Java(tm) Tutorial was published in the summer of 1996. Since then, two additional books and several new editions of existing books have been published.

Where can I get the tutorial?

You can read the tutorial online. From the front page you can choose a trail or search the java.sun.com version of the tutorial. If you prefer to view the tutorial on your own system, you can download the tutorial free of charge.

If you prefer to read paper, you can buy the book.


How often is the online tutorial updated?

Sometimes we update as often as once a month; sometimes months pass between updates. Frequently we'll make minor fixes to individual pages without updating the whole tutorial. To be notified of updates, please subscribe to our e-mail alias.


What do I need to know about the books before I buy one?

Three Java Tutorial books are now available in bookstores. See our book page for contents and online ordering information.


How much does the tutorial cost?

You can view the online version free and you can download it for free.

For book prices, consult the online booksellers. Links to our books' listings are available through our book page.


What version of the Java 2 Platform does the tutorial reflect?

Except where otherwise noted, the online tutorial reflects the API distributed in the Java 2 SDK, v 1.3 and 1.4. As for the books:


What topics are covered by the tutorial?

Check out The Really Big Index for an automatically generated list of the trails in the tutorial and the lessons they contain.

To get the Table of Contents for the books go to one of the following toc.html files:


Some of the online tutorial isn't finished. What's up with that?

The online tutorial is a dynamic growing document. Read more about that in This Is a Work in Progress!.


What awards has the tutorial won?

The second edition of The Java Tutorial won an Achievement Award in the "Single-Issue Publications" category. The award was given on February 27th, 1999, by the Society of Technical Communications (STC).

On February 21st, 1998 the Northern California branch of the Society for Technical Communications (STC) announced their awards. The first edition of The Java Tutorial won a Merit Award in the category "Single-Issue Publications" (better known as retail books).

In August of 1997, JavaWorld Magazine chose the first edition of The Java Tutorial as a runner-up for Best Training Aid.

About Downloading the Tutorial

How do I download the tutorial?

See Download the Tutorial for information. Unfortunately, we cannot send the tutorial to individuals via e-mail.

If for some reason, you cannot download the tutorial from the web, consider buying the book and using the version of the tutorial contained on the CD included with the book.

Note: If you download the tutorial, feel free to make it available locally at your site. Please do not publicly mirror it to the Web!. See the next question and answer to find out why.


May I mirror the tutorial publicly?

Our policy on distribution is that anyone is permitted have a copy of the online tutorial as long as it's visible only within their own institution (university, business, or whatever) and no one is profiting from the tutorial's distribution.

We've taken this strict position because the many tutorial mirrors mean that search engines generally don't find the most up-to-date version of the tutorial. Instead, search engines find mirror sites, which invariably fall behind. We end up getting e-mail about problems that have been corrected in newer versions of the tutorial. Or perhaps worse, we don't get e-mail and the reputation of the tutorial suffers. We allow local copies because we realize that browsing java.sun.com isn't always practical.

When you tell us about a mirror, we send the offender a friendly e-mail asking them to please move their copy of the tutorial to a place that isn't visible from the outside world.


I'm having trouble unarchiving the tutorial. What should I do?

Many readers can solve this problem by installing or updating software to unarchive compressed files (like Zip files). For example, on the Microsoft Windows platform, you can use WinZip to unarchive the Tutorial.


What do I need to know about the online version before I download it?

Here's what you get when you download the tutorial:

You can also download only examples, only the current Swing trail, or archived versions of tutorial trails that have been removed from or completely updated in the current online and downloaded versions of the tutorial.

About Getting the Tutorial in Other Formats

Can I get a PostScript or PDF version of the tutorial to download?

No. If you want a hard copy of the tutorial, you can buy or borrow the book. To find out why, read the next question and answer.


Why isn't the tutorial available in PostScript or PDF?

We used to offer a PostScript version of the tutorial, but it caused many more problems than it solved. There were problems with fonts, page size in Europe, older versions of PostScript, and so on. PDF format might solve some or all of those problems, but we also got a lot of complaints about the actual document: "it's just a PostScript dump of the HTML," "the links don't make sense on paper," and so on. PDF wouldn't solve those problems. As a result, we no longer provide PostScript, and we won't be providing it or PDF in the future.

Other Questions

Can you help me with my programming problem?

This question is actually a series of similar questions:

Unfortunately we are not staffed to provide answers to these types of questions at this address. Here's our auto-reply. This message lists a bunch of Java developer. resources to help you get an answer to your question.

By the way, we automatically compile (and always run at least once) all of the examples in the tutorial. The examples work for us. If you are having problems with the examples, then you are probably having configuration problems.


subscribe

If you'd like to get an e-mail when we update the tutorial, please subscribe to our announcements list. It's a low-traffic list that only Tutorial team members can post to. For details, see Get Announcements about The Java Tutorial.


What do other readers think of the tutorial?

You can read comments submitted to Amazon.com by readers. Just follow the relevant Amazon.com link from the index page.


Where's the change history for the tutorial?

Read a complete change history of the tutorial.