В C# я могу присоединить документацию для свойств, методы, события, и так далее, непосредственно в коде с помощью Комментариев Документации XML. Я знаю, как вставить ссылку на конкретный метод: <...
Я использую что-то подобное этому, и оно не отобразит Сводку или Комментарии, когда я попытаюсь использовать Intellisense для этой функции? ''' <сводка>' '' Сводка ''' </summary&...
Существует ли всесторонний список ошибки/предупреждающих сообщений для g ++ компилятор, доступный онлайн? Я ищу что-то подобное документации MSDN, которая описывает то, что каждое сообщение означает и...
я генерирую файлы документации из xml комментариев моего кода c#, при помощи разработчика справочного файла замка из песка. Вы знаете, как включать примеры кода в справочный файл, как стиль MSDN?
Я работаю над довольно большим механизмом стратегии в реальном времени с открытым исходным кодом (Spring). Я недавно добавил набор новых функций C++, вызываемых Lua, и задаюсь вопросом как к лучшему документу их, и в то же время также...
На работе мы используем Замок из песка для создания справочных файлов. Я использовал SandCastleGUI в течение некоторого времени, и я ищу способ создать дополнительные страницы в справочном файле. Эти страницы записаны в...
Я начал использовать Замок из песка некоторое время назад для генерации Веб-сайта Документации для одного из наших проектов. Это работает вполне хорошо, но мы всегда только писали документацию для классов, методы...
Я использую D2007 и пытаюсь зарегистрировать свой исходный код, используя функцию HelpInsight (обеспеченный начиная с D2005). Я главным образом интересуюсь получением работы подсказок HelpInsight. С различной сети-...
Меня интересует, где я могу применить свои XML-комментарии. Должен ли я добавить более общий XML-комментарий в интерфейс и более описательный в реализующий класс? Как это: открытый интерфейс ...
У меня есть метод, возвращающий текущий объект, как мне это задокументировать? / ** * что-то установить * * @ вернуть * /
публичная функция setSomething () {// ... return $ this;
} Или я должен ...
Как добавить строки документации и/или комментарии к библиотекам/пространствам имен Clojure в целом, то есть не только к конкретным функциям в пространстве имен? Я заметил, что исходный код clojure использует комментарий (... )в...
Как задокументировать методы с параметрами, используя строки документации Python? РЕДАКТИРОВАТЬ: PEP 257 дает следующий пример: def complex (real = 0.0, imag = 0.0): "" "Сформируйте комплексное число. Аргументы ключевого слова: ...
Есть ли стандарт интерпретировать синтаксис функциональных интерфейсов API документаций и если да, то как это определено? Вот пример того, как изменить цвет элемента JavaScript ...
Я хотел бы видеть комментарии к отдельным полям. Обычно я чего-то ожидаю от «описывающих» параметров. mysql> описать метрики;
+ ------- + --------------------- + ------ + - --- + --------- + -------...
Я добавил эту строку в мой файл .gemrc: gem: --no-rdoc --no-ri Я использую rvm, однако при установке gem я получаю следующий вывод: Mac-mini: ~ user $ gem install Fastlane успешно ...
В нашей организации у нас есть около 100 программных документов (API, SOAP, технические и т. Д.), Сохраненных в репозитории SVN. Сохранение документов в SVN имеет некоторые преимущества, например, управление версиями. Но доступ ...
Как Могу ли я задокументировать переопределенный метод или реализованный виртуальный метод подкласса? Стоит ли использовать @copydoc? class A {/ ** * Подробное описание ........ * / virtual int foo (int i);
...
Yesterday, Dave DeLong answered a question of mine. It wasn't the answer I was looking for, but in the question he mentioned an alternative way of generating doxygen-style documentation for Objective-...
Я создаю документ проекта VS 2010 C #с помощью построителя файлов справки Sandcastle. Я добавил документацию.xml, сгенерированную компилятором, и файл.sln решения Visual Studio проекта...
Я пытаюсь получить документацию Magento в формате, который я могу использовать в Dash. В статье на сайте Dash описано, как импортировать ряд видов документации в нужный формат,...
Есть ли инструменты для документирования сервера socket.io? Я ищу инструмент, который позволяет документировать пространства имен / событий / конечных точек socket.io так, как это делает почтальон / сваггер (...
Есть ли лучшие практики для документации по файлам конфигурации, особенно для python? В частности, в научных вычислениях обычно используется файл конфигурации в качестве входных данных для управления пакетной обработкой ...
Я создал общедоступную ссылку на публикацию коллекции. Мне интересно, как я могу добавить заметки в этот публичный документ, например, у моего API есть некоторые параметры, и я хочу указать, какие из них ...
Я использую CheckStyle, FindBugs и PMD для проверки моего кода Java. Я исправил почти все ошибки, обнаруженные этими инструментами. Я не могу понять, как написать «комментарий к пакету», который является ошибкой ...
Я добавил < Returns > XML-тег для некоторых из моих методов, но я не вижу его содержимое в IntelliSense. Вот мой код: /// < summary > /// мы все живем в желтой сводке /// < / summary > // ...
Я бы хотел использовать SAML, чтобы разрешить аутентифицированные пользователи веб-сайта для входа на другие федеративные сайты. Говоря языком единого входа, это означает, что мой сайт должен стать поставщиком удостоверений. Кто-нибудь может указать ...
Я заметил, что многие известные проекты с открытым исходным кодом редко содержат значительное количество комментариев и встроенной документации. Учитывая, что основной целью комментирования является прояснение того, что ...
Есть ли способ, как автоматически показывать переменные var1 и var2 и их значения инициализации в документации sphinx? class MyClass: "" "Описание класса" "" def __init __ (self, ...
я не могу создать документацию для этого кода, я думаю, что мой coomad javadoc неправильный, я читал об этом, но не понимаю, может ли кто-нибудь исправить по javadoc cammand class abc
{/ ** documentaion ...