@TomBrito Chociaż to odpowiada na rzeczywiste pytanie, uważam, że konieczność ucieczki przed znakami pojawia się tylko wtedy, gdy są one używane jako nawiasy kątowe (tj. W parach), co z kolei oznacza, że są one częścią jakiegoś kodu (np. jak w przypadku OP). W tej sytuacji uważam, że lepszym rozwiązaniem jest zawinięcie całego fragmentu XML w {@code ...}znaczniki, jak zasugerował Etienne Delavennat w swojej odpowiedzi.
Zoltán
>lub <nie ma dokładnie tego samego znaczenia z nawiasami ostrymi w formacie XML. Ale {@code <>}to dobry wybór.
cinqS
63
Najnowsze wersje obsługi JavaDoc {@literal A <B> C}; Powoduje to prawidłowe wyświetlanie treści (z ucieczką znaków „<” i „>” w wygenerowanym kodzie HTML).
Zgadzam się. XML powinien być opakowany w {@code }tagi. Będzie wyświetlany bardziej naturalnie (z czcionką o stałej szerokości) i nie będzie wyglądał dziwnie w źródłowym javadoc, ponieważ nie musisz osobno wychodzić z nawiasów ostrych.
Odpowiedzi:
Możesz użyć
<
dla < i>
dla > .źródło
{@code ...}
znaczniki, jak zasugerował Etienne Delavennat w swojej odpowiedzi.>
lub<
nie ma dokładnie tego samego znaczenia z nawiasami ostrymi w formacie XML. Ale{@code <>}
to dobry wybór.Najnowsze wersje obsługi JavaDoc {@literal A <B> C}; Powoduje to prawidłowe wyświetlanie treści (z ucieczką znaków „<” i „>” w wygenerowanym kodzie HTML).
Zobacz http://download.oracle.com/javase/1.5.0/docs/guide/javadoc/whatsnew-1.5.0.html
źródło
Biorąc pod uwagę, że XML to rzeczywisty kod, uważam, że fragmenty XML w Javadoc lepiej pasują do tagu {@code A <B> C} niż do tagu {@literal A <B> C}.
Tag {@code} używa czcionki o stałej szerokości, dzięki czemu jego treść wyróżnia się jako rzeczywisty kod.
źródło
{@code }
tagi. Będzie wyświetlany bardziej naturalnie (z czcionką o stałej szerokości) i nie będzie wyglądał dziwnie w źródłowym javadoc, ponieważ nie musisz osobno wychodzić z nawiasów ostrych.Pomiń je jako HTML:
<
i>
źródło
Wystarczy użyć odpowiednika HTML dla jednego z nawiasów ostrych.
<
Może być przedstawiony jako<
lub<
. Oto próbka pobrana z prawdziwego Javadoc:Wyświetla się jako:
źródło
Jeśli ustawisz mavena, aby używał przeceny , możesz po prostu otoczyć go grawitacjami.
`A<B>C`
czyta się trochę ładniej niż{@code A<B>C}
źródło
Interpozycja <pre> i {@code} zapisuje nawiasy ostre i puste linie w javadocs i jest szeroko stosowana, patrz na przykład java.util.Stream.
źródło
Po prostu otocz go w
{@code}
ten sposób:źródło