Javadoc

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){
     }


Related Posts:

  • Belajar Cosort 3 1.      awk dan nawk Untuk nawk bisa dibilang upgradenya awk, biasanya awk tidak bisa memproses field yang jumlahnya banyak. Example: ada data seperti ini (dengan nama test.txt) A|2|3|4|5 G|2|E|… Read More
  • Belajar Cosort 1 cd  /usr/bin/ --> untuk masuk kedalam direktory /usr/bin/. ls  /usr/bin/ --> untuk melihat isi dalam direktory /usr/bin/. ls -lrth /usr/bin/ --> untuk melihat isi detail dalam direktory /usr/bin/ … Read More
  • Javadoc 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) da… Read More
  • Syukur Sering kali kita mendengar atau bahkan mengucapkan kata itu SYUKUR. Kata yg mudah diucapkan namun sulit sekali untuk diterapkan. Syukur terhadap sesama manusia lebih cenderung disebut dengan perasaan yg saling menghargai… Read More
  • Belajar Cosort 2 pas di `ls` kan keluar listing direktorinya or file, misal: -bash-3.00$ ls *.txt  note satu.txt  note dua.txt  note tiga.txt kemudian di list dulu di satu file -bash-3.00$ ls *.txt > listfile.txt … Read More

0 komentar:

Posting Komentar