За последние 24 часа нас посетили 17443 программиста и 1271 робот. Сейчас ищут 1378 программистов ...

Что означает такой стиль комментирования?

Тема в разделе "Вопросы от блондинок", создана пользователем Catrina, 26 авг 2015.

  1. Catrina

    Catrina Новичок

    С нами с:
    24 апр 2015
    Сообщения:
    321
    Симпатии:
    0
    Нигде не нашла описание, для чего так оформляются комментарии, но встречаются они часто и выглядят вот так:
    Код (PHP):
    1. /**
    2.  * тут текст комментария
    3.  * тут тоже текст комментария
    4.  */
    В первой строке почему-то две звёздочки. Зачем две?
    В каждой следующей тоже по ненужной звёздочке, которые ничего не дают по сути.
    В общем, ничего не понимаю. Расскажите, пожалуйста, зачем всё это нужно.
     
  2. artoodetoo

    artoodetoo Суперстар
    Команда форума Модератор

    С нами с:
    11 июн 2010
    Сообщения:
    11.114
    Симпатии:
    1.244
    Адрес:
    там-сям
    https://ru.wikipedia.org/wiki/PHPDoc
    NetBeans умеет создавать такие.
    Главное предназначение — создание документации.
    Некоторые фреймворки используют аннотации из phpdoc-styled комметариев для автоматической генерации таблиц или вспомогательных файлов.
     
  3. Ganzal

    Ganzal Суперстар
    Команда форума Модератор

    С нами с:
    15 мар 2007
    Сообщения:
    9.893
    Симпатии:
    965
    а еще рефлекция классов показывает комментарии к ним и их содержимому. оказывается...
     
  4. romach

    romach Старожил

    С нами с:
    26 окт 2013
    Сообщения:
    2.904
    Симпатии:
    719
    Ну а как ещё аннотации по твоему должны работать? )
     
  5. Ganzal

    Ganzal Суперстар
    Команда форума Модератор

    С нами с:
    15 мар 2007
    Сообщения:
    9.893
    Симпатии:
    965
    ну я честно думал что он покажет мне например текущее состояние статических свойств но документации я уж никак не ожидал.