Стандартные стандарты документации
Примечание. Этот тег использовался в прошлом, но больше не должен использоваться.
Что дает?
Я создаю плагин для создания кода из источника плагина / темы, и я думаю, что тег @uses
был бы идеальным для связывания функций с крючками и крючками для функций.
Я не уверен на 100%, но я предполагаю, что это связано с тем, что использование @uses
может быть покрыто @see
Из документов phpDocumentor
@uses очень похож на @see, см. документацию для @see для получения подробной информации о формате и структуре. Тег @uses отличается от @see двумя способами. @see является односторонней ссылкой, то есть документация, содержащая тег @see, содержит ссылку на другую документацию. Тег @uses автоматически создает виртуальный тег @usedby в другой документации, которая ссылается на документацию, содержащую тег @uses. Другими словами, это точно так же, как @see, за исключением того, что ссылка возврата добавляется автоматически.
Другое отличие состоит в том, что @uses принимает только один элемент для ссылки и описание этого элемента.
Вероятно, представители WP решили, что нет двух одинаковых тегов, но только поддерживать их.
BTW, @uses
– это прекрасный тег. Если вы хотите поддержать его, просто сделайте это и задокументируйте его поддержку в документации.