Как запустить rdoc для отдельных файлов, не перезаписывая все остальные файлы?
Я работаю над очень большим проектом рельсов и хочу стандартизировать использование rdoc в кодовой базе. Я подумал, что могу запустить его один раз для всего проекта (по крайней мере, чтобы сгенерировать документы для самих классов и методов), а затем разработчики могут добавлять отдельные файлы по мере добавления документации.
Проблема в том, что если я запускаю rdoc /path/to/some_file.rb, он затем удаляет все остальные файлы из сгенерированного index.html и включает только один. Запуск rdoc для всего проекта занимает 3-4 минуты, и нет необходимости анализировать весь проект каждый раз, когда добавляются новые комментарии. Вывод rdoc --help не дает никаких решений.
Есть ли способ настроить rdoc так, чтобы он всегда сохранял документы, пока я специально не запустил rdoc для этих файлов снова?
Спасибо за понимание!
Ответы 1
Я не думаю, что rdoc удаляет что-либо из index.html, просто перезаписывает его и фактически не может его модифицировать. Что касается производительности, я не уверен на 100%, но, скорее всего, rdoc не кэширует результаты синтаксического анализа. Площадка работает с опцией -c, --use-cache, и это значительно ускоряет работу.