Как минимизировать количество изменений между ревизиями с новым выходом кислорода? - PullRequest
6 голосов
/ 09 ноября 2009

Репозиторий Subversion содержит каталоги html, latex и man, которые doxygen генерирует из исходного кода. Даже при небольших изменениях исходного кода новые файлы генерируются со случайными именами, что приводит к значительным изменениям в системе контроля версий.

Есть ли способ обойти это? Как я могу минимизировать наборы изменений между ревизиями, в то же время включая документацию, генерируемую Doxygen? В качестве альтернативы, как я могу найти, какие из генерируемых doxygen файлов больше не используются и должны быть удалены?

1 Ответ

6 голосов
/ 09 ноября 2009

Ненавижу отвечать на вопрос, не предоставляя ответа на конкретный вопрос, но, как правило, плохая идея отслеживать документооборот в вашем хранилище. То же самое относится и к сценариям конфигурации, сгенерированным autoconf.

Если вы беспокоитесь о том, что люди не могут генерировать документы из-за нехватки кислорода, лучше разместить их в своем личном репо на вашем языке и по выбору.

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

Устранение избыточных конфликтов слияния (т. Е. Джо изменил комментарии И документы и теперь должен объединить оба) ИМХО оправдывает экстернализацию сгенерированных документов.

...