Что означает @code в Google Closure?

Примером здесь:Что означает @code в Google Closure?

* An implementation of {@code goog.events.Listenable} with full W3C 
* EventTarget-like support (capture/bubble mechanism,

https://developer.pubref.org/static/apidoc/global/closure/goog/events/EventTarget.html

я могу предположить, что это значит, но где я могу найти его точное определение? Я проверил все документы Google Closure Annotation, но не смог найти их. Спасибо :)

источник

2016-10-04 Daming Lu

Я думаю @code это Javadoc тег, в основном это означает, текст внутри не следует рассматривать в качестве HTML, но блок кода вместо. Но в этом случае, я думаю, это просто, чтобы текст выглядел по-разному во время документации как goog.events.Listenable отлично подходит для HTML. – Keith

Кит прав, и должен написать ответ, говорящий столько же. Это может быть код, который был преобразован из Java в Javascript с помощью этих старых тегов Javadoc. В более поздней библиотеке кода закрытия кода для документирования используется документация, а документация создается с помощью [Досье] (https://github.com/jleyba/js-dossier) – owler

Вы можете увидеть выходные документы, о которых вы просили, на Closure API's documentation page for goog.events.EventTarget.

При визуализации JSDocs тег @code вызывает визуализацию кода в скобках с помощью элемента <code></code>.

Источник: js-dossier

Там также гораздо лучше документация от JavaDocs ... документы:

{@code текст}

{@literal} Эквивалент.
Отображает текст в текстовом шрифте без интерпретации текста как разметки HTML или вложенных тегов javadoc. Это позволяет использовать обычные угловые скобки (< и>) вместо объектов HTML (< и >) в комментариях к документу, например, в типах параметров(), неравенствах (3 < 4) или стрелках (< -). Например, документ текст комментария:
```
{@code A<B>C} 
```
отображается в генерируемой HTML страницы без изменений, как:
```
A<B>C 
```
примечательных точкой является то, что не интерпретируется как полужирный и в коде шрифта. Если вам нужна такая же функциональность без шрифта кода, используйте {@literal}.

Источник: docs.oracle.com

источник

2016-10-05 16:28:14

Как и в последующем, это чисто для документации и не имеет специальных что означает закрытие-компилятор. –

ответ

Смежные вопросы