Quelles sont les informations requises dans boot.properties?

Question

Je souhaite spécifier la version de Clojure pour mon projet utilisant Boot. Selon le Boot Wiki, la façon de procéder est de fournir une valeur pour BOOT_CLOJURE_VERSION dans un fichier boot.properties dans ma racine de projet. Alors je l'ai fait:

$ cat boot.properties 
BOOT_CLOJURE_VERSION=1.7.0 

Il semble fonctionner très bien:

$ 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 

Toutefois, cette même page wiki dit spécifiquement pour créer comme fichier boot.properties ceci:

$ boot -V > boot.properties 

Cette ajoute deux lignes au début, qui ressemblent à des commentaires pour moi, et une à la fin qui spécifie la version de démarrage. Je n'ai aucun problème avec la spécification de la version de démarrage pour mon projet, mais la page wiki rend son comme si elle est nécessaire:

Note: Lorsque vous utilisez le fichier boot.properties vous devez épingler également le projet à la version de démarrage spécifique comme le fichier doit spécifier les deux variables.

Je suis un peu confus au sujet de pourquoi la page dit spécifiquement d'ajouter ces trois lignes à boot.properties quand les omettre ne semble pas causer de problèmes. De plus, si j'utilise le contrôle de révision, je ne vois pas la nécessité de mettre un horodatage dans boot.properties. Est-il correct d'omettre ces lignes? Si non, pourquoi sont-ils nécessaires?

Answer 1

Il s'agit très probablement d'un cas d'informations wiki obsolètes. De l'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. 

Je suppose que vous pourriez envisager une bonne pratique pour bloquer à la fois la Clojure et la version de démarrage par projet car cela permettra d'éviter des problèmes futurs qui pourraient découler de versions incompatibles.

Les 2 lignes de commentaires ajoutées par Boot ne sont données qu'à titre indicatif et peuvent être omises en toute sécurité.