Class 18: Discussion of Exam 1; Javadoc

Held Monday, September 25, 2000

Summary

Today we go over the first examination.

Notes

• For tomorrow, try reading Chapter 4 of Bailey.
  • Please bring questions on and Java stuff you don't understand.
• As hard as I tried, I was not able to get the exam graded. I'm hoping to return it to you tomorrow.
  • We'll still go over parts today.
• Don't forget to work on phase 2 of the project.

Overview

• The exam
• Javadoc
• Equality for doubles and floats.

File Organization

• Why do we take care in organizing our files?
• Who are the readers?
• Include author and version.
• Be consistent.
• Conditionals have one standard form.
• Document special cases.

Javadoc

• Some of the parts I'm particularly concerned about are the parts that relate to the construction of documentation.
• Java includes an "automatic" docuemntation constructor called javadoc.
• We'll play with it.
• Try

  % javadoc -author -version *.java
  

Testing

• Special cases!
• As many cases as possible.
• Interactive or not?
• Where do the results go?
  • Why I pass out as a parameter.

Testing Equality

• It can be dangerous to use == for comparing two doubles. Why?

Definitions

Mostly good.

Hierarchy

• Coming soon ...