Polished

Author: davsclaus

Diff for: core/camel-api/src/main/java/org/apache/camel/spi/PropertiesComponent.java

@@ -170,13 +170,14 @@ default Map<String, Object> loadPropertiesAsMap(Predicate<String> filter) {
 
     /**
      * A list of locations to load properties. You can use comma to separate multiple locations. This option will
-     * override any default locations and only use the locations from this option.
+     * override any default locations and only use the locations from this option. Camel loads by default from
+     * classpath, so use file: as prefix to load from file system.
      */
     void setLocation(String location);
 
     /**
      * Adds the list of locations to the current locations, where to load properties. You can use comma to separate
-     * multiple locations.
+     * multiple locations. Camel loads by default from classpath, so use file: as prefix to load from file system.
      */
     void addLocation(String location);
 

Diff for: core/camel-main/src/main/java/org/apache/camel/main/MainCommandLineSupport.java

@@ -155,7 +155,8 @@ protected void doProcess(String arg, String parameter, LinkedList<String> remain
         });
         addOption(new ParameterOption(
                 "pl", "propertiesLocation",
-                "Sets location(s) to load properties, such as from classpath or file system.",
+                "Sets location(s) to load properties, such as from classpath or file system."
+                                            + " You can use comma to separate multiple locations. Camel loads by default from classpath, so use file: as prefix to load from file system.",
                 "propertiesLocation") {
             protected void doProcess(String arg, String parameter, LinkedList<String> remainingArgs) {
                 setPropertyPlaceholderLocations(parameter);