1. Penjelasan
Java memiliki tools untuk mengekstrak dokumen yang
ada pada file Java. Komentar yang harus diekstrak harus ditulis dalam format
tertentu. Komentar ditulis seperti berikut diawali /** (slash bintang bintang)
dan ditutup dengan */ (bintang slash). Setiap baris diawali dengan /* (slash
bintang). Isi komentar boleh mengandung tag HTML. Untuk lebih jelasnya lihat contoh.
Compile program tersebut dengan cara sebagai berikut :
2. Ketentuan
Ketentuan dalam menulis javadoc , antara lain :
- Komentar kelas
Komentar diberikan tepat sebelum deklarasi kelas
- Gunakan tag @author untuk menulis nama pembuat
Contoh :
/**
* Kelas Point adalah kelas yang merepresentasikan titik dalam koordinat kartesian
* Kelas ini <b>tidak</b> menangani rotasi
* @author kelompok enan
*/
public class Point {
}
- Komentar method ditukis tepat sebelum deklarasi method :
- Gunakana tag @param untuk menjelaskan parameter (@param diikuti nama parameter lalu penjelasan parameter)
- Gunakan tag @return untuk menjelaskan hasil kembalian method
- Gunakan tag @see untuk member link method lain yang perlu dilihat
- Tidak semua tag perlu dipakai
contoh :
/**
* Method untuk memeriksa apakah point berada dalam kotak
* @param k kotak yang diperiksa
* @return true jika point berada di dalam kotak, false jika di luar kotak
* @see jarak
*/
boolean didalam(Kotak k){
}
- Komentar kelas
Komentar diberikan tepat sebelum deklarasi kelas
- Gunakan tag @author untuk menulis nama pembuat
Contoh :
/**
* Kelas Point adalah kelas yang merepresentasikan titik dalam koordinat kartesian
* Kelas ini <b>tidak</b> menangani rotasi
* @author kelompok enan
*/
public class Point {
}
- Komentar method ditukis tepat sebelum deklarasi method :
- Gunakana tag @param untuk menjelaskan parameter (@param diikuti nama parameter lalu penjelasan parameter)
- Gunakan tag @return untuk menjelaskan hasil kembalian method
- Gunakan tag @see untuk member link method lain yang perlu dilihat
- Tidak semua tag perlu dipakai
contoh :
/**
* Method untuk memeriksa apakah point berada dalam kotak
* @param k kotak yang diperiksa
* @return true jika point berada di dalam kotak, false jika di luar kotak
* @see jarak
*/
boolean didalam(Kotak k){
}
0 komentar:
Posting Komentar