4
C++ ile programlama yaparken, Doxygen kullanıyor ve belirli bir sınıfa veya yönteme uymayan ek belgeler için sık sık harici .dox dosyaları oluşturuyoruz - örneğin, dosya biçimi belgeleri (birden çok sınıf tarafından erişilen dosyalar için). Java'da aynısını yapmanın bir yolunu bulmaya çalıştım ama javadoc'un eşdeğer bir özelliği olmadığını, tüm belgelerin bir .java dosyasının yorumlarının içine yazılması gerektiğini ve ona bağlı olduğunu (veya en azından onun paketi). Ben haklı mıyım Bunu yapmanın alternatif bir yolu var mı?Java kod belgelerine dış sayfalar nasıl eklenir?
Sadece bu tür bilgileri içerecek bir paket ve sınıflar oluşturma hakkında ne düşünüyorsunuz (yani, herkes tarafından kullanılmayan boş sınıflar, yalnızca bu belgeleri yerleştirmek için bir yer). Çok çirkin olur mu? –
Evet, bence bu bir hata olur. Kaynak kodunuzu dokümantasyon için kirletmeyin! :) –
Bir yorum dosyası alır bir komut dosyası hakkında - bir .jdoc diyelim, bir stub boş sınıf ile temp .java dosyasında sarar, javadoc derleyici çalışır ve geçici dosyayı siler? –