Пожалуйста, объясните это из FAQ по Subversion?«Не используйте файл, используйте шаблон»

Question

http://subversion.apache.org/faq.html#ignore-commit

В моем проекте есть файл, который должен изменить каждый разработчик, но я не хочу, чтобы эти локальные моды когда-либо фиксировались.Как я могу заставить 'svn commit' игнорировать файл?

Ответ таков: не ставьте этот файл под контроль версий.Вместо этого поместите шаблон файла под контроль версий, что-то вроде «file.tmpl».

Затем, после первоначальной проверки svn, пусть ваши пользователи (или ваша система сборки) сделают обычную копию ОСшаблона с правильным именем файла, и попросите пользователей настроить копию.Файл не версионный, поэтому он никогда не будет зафиксирован.И если вы хотите, вы можете добавить файл в свойство svn: ignore его родительского каталога, чтобы он не отображался как '?'в команде 'svn status'.

http://subversion.apache.org/faq.html#ignore-commit

Единственное использование файлов .tmpl, с которыми я сталкивался при изучении Subversion, - это файлы ловушек, в которых они даюту вас есть шаблон post-commit.tmpl, в котором есть пример сценария оболочки, и вы должны переименовать его без .tmpl и поместить в папку hooks.

Боюсь,Я не понимаю, что означает ответ на этот вопрос.Subversion как-то игнорирует файлы с расширениями .tmpl?Нужно ли переименовывать файл?

Скажем, в моей системе database-config.php в файле на сервере, и я хочу работать на моей локальной машине с другим database-config.php, отражающим локальные условия.Должен ли я назвать это database-config.php.tmpl?

Может кто-нибудь рассказать мне шаг за шагом, как я буду следовать инструкциям в ответе?

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

Answer 1

Как заявлено @Wrikken - добавьте самый стандартный файл с общими предпочтительными настройками и сохраните его в хранилище. Теперь, когда пользователь проверяет это - прежде чем что-либо еще - он должен сначала:

1. Отредактируйте его (например, ooga_Template.cpp) в соответствии с его локальной средой
2. Сохранить как копию - с исходным (ожидаемым) именем файла (например, ooga.cpp)
3. и НЕ версия этого файла (ooga.cpp) (т.е. не присоединяйте его к SVN).

Файл шаблона можно называть как угодно, но да, называть его отличным от оригинального имени файла - настоятельно рекомендуется. Таким образом, этот файл может безвредно размещаться в локальной версии этого файла, и для пользователя будет обязательно изменить файл, прежде чем он сможет его использовать.