grails-doc создает копии моих классов в пакете по умолчанию

Question

В моем проекте grails 1.3.7 я поместил все свои классы в com.mycompany.myapp, как и вы. Так что это касается сервисов, контроллеров, классов доменов. У меня есть фильтр, который идет в своем собственном пакете. Мое приложение работает нормально.

Однако, когда я запускаю grails doc, Grails решает создать две страницы для каждого класса:

• один в своем правильном пакете comp.mycompany.myapp со всеми необходимыми Groovy Doc
• другой принимает все вышеперечисленные классы и делает вид, будто они также находятся в пакете по умолчанию.

Итак, target / docs содержит две директории: «DefaultPackage» и «com», причем DefaultPackage содержит копию всего, что находится под com /

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

Как я могу решить эту проблему?

Answer 1

Я тоже сталкивался с той же проблемой и поэтому создал плагин "Документы времени выполнения Grails" (http://grails.org/plugin/grails-runtime-docs), который решает эту проблему и генерирует как Java, так и groovy документы только по 1 копии на класс. Он понимает и классифицирует классы на контроллеры, команды, домены, сервисы и библиотеки тегов. Groovy документация фактически генерируется из среды выполнения, чтобы также включать динамические методы, добавляя «Сводку динамического метода» и «Подробную информацию о динамическом методе» в сгенерированные документы HTML, которые предоставляют информацию об их источнике. Надеюсь, что вы найдете ее полезной.

Answer 2

Это было зарегистрировано как ошибка в GRAILS-6605 . Там нет никакого обходного пути, перечисленного там для ошибки.