Netbeans 8.0 ile bir javadoc yorum içinde bir {@ code} bloğundaki "@" sembolünden kaçmaya çalışmak

Question

Netbeans 8.0 kullanarak Javadoc yorumuna bir {@ code} ek açıklama eklemek istiyorum ve düzgün çalışmıyor.

Daha önce bu diğer sorular gördüm (yani How can you escape the @ character in javadoc?) ama html @ ve {@literal @} ikisi de işe görünmüyor kaçış.

/** 
* blah blah blah 
* <p> 
* For example: 
* <pre> 
* {@code 
* {@literal @}begin_specification 
* ... 
* &#64;end_specification 
* } 
* </pre> 
*/ 

Ben Run -> Generate Javadoc vurabilir ve her şeyi hatasız iyi çalışır ama çıkan çıktıda baktığım zaman görüyorum:

Yorumum (hem örneğin uğruna yöntemler kullanılarak) şöyle Bir tarayıcı:

{@literal @}begin_specification 
... 
@end_specification 

İstenilen sonuç bu değil ... Herhangi bir öneri/fikir?

Java için oldukça yeniyim ama geçmişte C/C++ 'da Doxygen gibi şeyler kullandım. Burada yanlış bir şey mi yapıyorum? Java 1.8.0_05 x64 ile NetBeans 8.0 (Build 201403101706) kullanıyorum.

<pre> <code> 
    {@literal @} 
</code> </pre> 

yerine {@code ...} bloğun:

Answer 1

bir yolu kullanmaktır. 86. satırın etrafında this example'a bakın.

Answer 2

Sadece bu konuya NetBeans 8.0.1 ile girdim, bu yüzden yaklaşık 15 dakika boyunca bununla uğraştım. İlk başta javadoc'taki {@code } biçimlendiricisiyle, parens'teki hiçbir şey görünmüyordu, bu yüzden javadoc'taki metinde gerçek aralar vardı. Daha sonra onunla uğraştıktan sonra (<pre> ve diğer birkaç etiketi kullanarak) ve {@link }'u içeren diğer sınıfları açtıktan sonra neyin işe yaramadığını.

Neler olup bittiğinden emin değilsiniz, ancak IDE'nin javadoc renderer'ının tamamen "ısınması" için biraz zamana ihtiyacı vardı. Bu gibi olmayan teknikler gibi, gerçekten bu şekilde ortaya çıktı. Bir javadoc başlığı, bir {@code } blokunu doğru gösterdi, ancak başka bir kelime değil, sadece birkaç kelimeyle. Şimdi her şey doğru şekilde gösteriliyor. Bunun kimseye yardım edeceğinden emin değilim, fakat NetBeans'e yeni bir bugzilla bileti göndereceğimi düşündüğümde, yedekleyip çalışıyorum. Kendi biletime dön ...

Answer 3

Bu bilinen bir hatadır. İlgili hatadan link: bir düzeltme için tarifeli sürümü var

https://bugs.openjdk.java.net/browse/JDK-8130754

2016-10-07 itibarıyla.

Answer 4

Bu hatadan kurtulmanın bir yolu, standart "@" sembolüne benzeyen farklı bir karakter kullanmaktır.Benzer bir bir kaç Unicode karakterleri Bulunan: @

1. (u + 0040): TİCARET AT (kırık normal bir)
2. ⓐ (U 24D0) daire içine alınmış Latin küçük harf bir
bir {@code içinde javadoc yorumunda bunlarla "@Override" geç çalıştı

AT Fullwidth TİCARET: (U FF20) '

küçük TİCARİ: (U FE6B)'

...} etiket. (Bir Netbeans editörü ve bir Mozilla Firefox tarayıcısı kullanıyorum.) Sembollerin tümü, elbette # 1 hariç. Ayrıca, # 3 editörde görünmedi, ancak tarayıcıda iyi çalıştı.