2012-05-09 5 views
4

Это скорее вопрос MonoDevelop. Мне очень нравится использовать '///' и получать скелетные контуры комментариев, например VisualStudio. Но мне не нравится иметь дополнительный текст наполнителя, который предоставляется по умолчанию, поскольку он не добавляет никакого реального значения (он просто повторяет то, что я уже набрал!). Для жизни я не могу найти способ сохранить генерацию комментариев XML, но не иметь дополнительный текст. Был обнаружен отчет об ошибке, который был исправлен для этой проблемы (https://bugzilla.novell.com/show_bug.cgi?id=606222), но я не видел, куда должен был обратиться.В MonoDevelop, как вы отключите подробное формирование комментариев при вводе ///

Все, что я хочу, генерируемый:

/// <summary> 
    /// 
    /// </summary> 
    /// <param name="bar"></param> 
    public void Foo(string bar) 
    { 
    } 

TL; DR;

В MonoDevelop есть (и где есть) возможность отключить подробные автогенерированные комментарии, но сохранить комментарии шаблона /// для заголовков методов?

Спасибо.

+0

FWIW, я подтвердил, что вы можете ввести ///, **, затем ** нажмите комбинацию клавиш UNDO, и она удалит лишние формулировки. Но это лишнее нажатие клавиши. Я надеюсь, что кто-то скажет мне, как отключить эту функцию. –

+0

Up-voted. Я использую Doxygen, который поддерживает Markdown. Меньше XML в мире, пожалуйста. – user3183018

ответ

0

Не поддерживается. Я почти уверен, что решение жалоб состояло в том, что отменить было бы два шага, чтобы вы могли легко удалить автоматически заполненные значения.

Добавление вариантов - это скользкий склон. Например, вы можете:

/// <summary> 
/// 
/// </summary> 
/// <param name="bar"></param> 
public void Foo(string bar) 
{ 
} 

Но я мог бы

/// <summary></summary> 
public void Foo(string bar) 
{ 
} 

А кто-то может понадобиться

/// <summary></summary> 
/// <param name="bar"></param> 
public void Foo(string bar) 
{ 
} 

В опции пользовательского интерфейса, чтобы поддержать это было бы очень сложным, и MD уже есть слишком много вариантов, поэтому для каждого нового варианта нужно сделать сильный аргумент. Поведение может быть не идеальным для всех, но это довольно хорошо, и настройка созданных документов все же намного проще, чем набирать их с нуля.

Однако добавление, которое генерирует комментарии is open-source, так что вы можете легко изменить его, как хотите.

+0

Я понимаю. Если бы я не был в середине создания чего-то нового, я бы посмотрел, что ему потребуется, чтобы реализовать. Думаю, с моей точки зрения, поскольку большинство разработчиков приходят из VS, ожидалось бы, что функция комментариев будет аналогичным/идентичным опытом. У меня очень сильные чувства _against_ с использованием системы комментариев типа GhostDoc, поскольку никакая новая информация не добавляется (как она может быть). Я могу жить с отменой - по крайней мере, это дает мне то, что я хочу для шаблона комментария. Благодарю. –

+0

Это справедливый момент, но комментарии, подобные GhostDoc, действительно предназначены для проверки/редактирования в реальных комментариях. Даже если вы на самом деле не меняете их, тот факт, что вы * решили не менять их, должен означать, что вы проверили, что они были правильными, поэтому они всегда должны иметь какое-то значение. –

+0

Итак ... только что получил последнюю каплю MD, и мой компромисс отменен (!) :-(До этого я мог набирать «///», а затем отменить и получить схему, которую я хотел. отменить Я просто оставлен с '///'. –

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