Документация для формата XML для файлов, на которые ссылается аргумент kotlinc -Xbuild-file

Question

Где находится документация для формата XML для содержимого файлов, на которые ссылается kotlinc? -Xbuild-file аргумент?

XML выглядит примерно так:

<modules>
    <module name="module-name" type="java-production" outputDir="/Users/user/code/project/build/classes/kotlin/main">
        <sources path="/Users/user/code/project/src/main/kotlin/package/Class.kt"/>
        <javaSourceRoots path="/Users/user/code/project/src/main/java"/>
        <classpath path="/Users/user/code/project/libs/lib.jar"/>
    </module>
</modules>

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

Да, я пытаюсь выполнить конкретную задачу, используя указанные XML-файлы (используя JPMS-модули с kotlinc в рамках сборки Gradle), но даже если кто-то даст мне ответ, который, кажется, работает, я не смогу проверить, что это является оптимальным (не говоря уже о том, чтобы действительно исправить), не зная формат для этого XML. Если я знаю формат XML, я сам могу легко определить правильное использование, так что это пустая трата времени для меня, чтобы подробно описать мой конкретный случай использования, и это пустая трата, чтобы удалить вопрос, чей несубъективный ответ позволит мне завершить моя задача.

Answer 1

Согласно JetBrains, для этого формата XML нет документации, поскольку он не является публичным API.

Но источник парсера для этого формата находится в GitHub:

https://github.com/JetBrains/kotlin/blob/master/compiler/cli/cli-common/src/org/jetbrains/kotlin/cli/common/modules/ModuleXmlParser.java