Единственная документация для смешанного проекта (Scala/Java)?

Для проекта с модулями в Scala и Java (рядом), как объединить scaladoc с javadoc для обеспечения единственного представления документации для проекта?

(это могло использовать знатока, или муравья или систему онлайн бронирования, больше общий вопрос).

Любые мысли и события ценятся.

11
задан Jacek Laskowski 27 March 2014 в 18:32
поделиться

2 ответа

С новым скаладоком Scala 2.8, который заменит используемый скаладок на Scala 2.7, различия будут еще более поразительными. Тем не менее, поступил запрос на предоставление функции, которая переводит скалядок в формат javadoc, для использования IDE при отображении справки.

Если эта функция станет доступной, то что-то, что генерирует javadocs из скалядоков, будет теоретически возможным.

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

5
ответ дан 3 December 2019 в 10:44
поделиться

Не так, как Git поддерживает только наличие одной рабочей копии данных репозитория в каталоге репозитория.

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

Всякий раз, когда вы что-то закончили, вы просто нажимаете на «главный» голый репозиторий.

Некоторые подсказки:

man git-clone

git clone --bare

-121--1827319-

Смотрели ли вы сеть при использовании браузера? Возможно, браузер использует кэшированные ресурсы?

-121--3383595-

Scaladocs и javadoc очень разные, с различными форматами. Они просто два разных животного, и я не думаю, что есть смысл объединять их. Итак, AFAIK, Maven не предлагает никакой поддержки этому (что неудивительно), просто генерировать оба по отдельности.

1
ответ дан 3 December 2019 в 10:44
поделиться
Другие вопросы по тегам:

Похожие вопросы: