diff --git a/config/src/main/java/com/typesafe/config/ConfigFactory.java b/config/src/main/java/com/typesafe/config/ConfigFactory.java index 36ad5c54..e94112a2 100644 --- a/config/src/main/java/com/typesafe/config/ConfigFactory.java +++ b/config/src/main/java/com/typesafe/config/ConfigFactory.java @@ -57,16 +57,17 @@ public final class ConfigFactory { /** * Like {@link #load(String)} but allows you to specify parse and resolve * options. - * * <p> * To be aware of: using * {@link ConfigResolveOptions#setUseSystemProperties(boolean) - * setUseSystemProperties(false)} with this method has no meaningful effect, + * setUseSystemProperties(false)} with this method has little effect, * because the system properties are merged into the config as overrides * anyway. <code>setUseSystemProperties</code> affects whether to fall back * to system properties when they are not found in the config, but with - * <code>load()</code>, they will be in the config. - * + * <code>load()</code>, they will be in the config. There is one situation + * where <code>setUseSystemProperties(false)</code> comes into play, which + * is that files included into another file may find the system property + * fallbacks but not the overrides. * @param resourceBasename * the classpath resource name with optional extension * @param parseOptions @@ -99,16 +100,18 @@ public final class ConfigFactory { /** * Like {@link #load(Config)} but allows you to specify * {@link ConfigResolveOptions}. - * * <p> * To be aware of: using * {@link ConfigResolveOptions#setUseSystemProperties(boolean) - * setUseSystemProperties(false)} with this method has no meaningful effect, + * setUseSystemProperties(false)} with this method has little effect, * because the system properties are merged into the config as overrides * anyway. <code>setUseSystemProperties</code> affects whether to fall back * to system properties when they are not found in the config, but with - * <code>load()</code>, they will be in the config. - * + * <code>load()</code>, they will be in the config. There is one situation + * where <code>setUseSystemProperties(false)</code> comes into play, which + * is that files included into another file may find the system property + * fallbacks but not the overrides. + * * @param config * the application's portion of the configuration * @param resolveOptions