Какая информация требуется в boot.properties?

Question

Я хочу указать версию Clojure для моего проекта, который использует Boot. Согласно Boot Wiki, способ сделать это - предоставить значение для BOOT_CLOJURE_VERSION в файле boot.properties в моем корневом каталоге проекта. Так что я сделал это:

$ cat boot.properties 
BOOT_CLOJURE_VERSION=1.7.0 

Это, кажется, работает просто отлично:

$ tail -2 ~/.boot/boot.properties 
BOOT_VERSION=2.5.5 
BOOT_CLOJURE_VERSION=1.8.0 
$ cat build.boot 
(deftask version [] 
    (println "Clojure" (clojure-version)) 
    (println "Boot core" *boot-version*) 
    (println "Boot app" *app-version*)) 
$ boot version 
Clojure 1.7.0 
Boot core 2.5.5 
Boot app 2.5.5 

Однако тот же вики страница специально говорит, чтобы создать boot.properties файл так:

$ boot -V > boot.properties 

Этот добавляет две строки в начале, которые выглядят как комментарии для меня, и один в конце, который указывает версию загрузки. У меня нет никаких проблем с указанием версии загрузчика для моего проекта, но страница Вики делает его звук, как будто это требуется:

Примечание: При использовании boot.properties файла вы должны также прикрепить проект к конкретной версии загрузки так как файл должен указывать обе переменные.

Я немного запутался, о том, почему страница специально говорит, чтобы добавить эти три строки boot.properties при опуская их, кажется, не вызывает никаких проблем. Кроме того, если я использую контроль версий, я не вижу необходимости помещать отметку времени в boot.properties. Можно ли опустить эти строки? Если нет, зачем они нужны?

Answer 1

Это, скорее всего, случай устаревшей вики-информации. Из source:

// BOOT_VERSION is decided by the loader; it will respect the 
// boot.properties files, env vars, system properties, etc. 
// or it will use the latest installed version. 

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

2 строки комментариев, добавленные Boot, предназначены только для информационных целей и могут быть безопасно опущены.