Java: Classes in Java Applications.David Etheridge

Previous chapters include a number of examples of classes (or partial classes) from the themed application,the main purpose of which is to illustrate programming concepts. It should not have escaped the notice ofthe reader that these examples often include material other than Java statements, usually in a non-bold font.The inclusion of such material raises a question: what is the purpose of documentation is a class definition.Chapter One takes examples from the Java Application Programming Interface (API) and the themedapplication in order to emphasise the critical importance of documentation. The examples are used toshow how documentation is organised in the API and how it is inserted into developer’s code.