Clarify documentation of whether spring.config.location replaces or augments the default search path

[tomwhoiscontrary]

In the fine manual, we read that (emphasis mine):

If spring.config.location contains directories (as opposed to files) they should end in / (and will be appended with the names generated from spring.config.name before being loaded). The default search path classpath:,classpath:/config,file:,file:config/ is always used, irrespective of the value of spring.config.location. In that way you can set up default values for your application in application.properties (or whatever other basename you choose with spring.config.name) and override it at runtime with a different file, keeping the defaults.

However, @snicoll ventured the opinion that in fact, spring.config.location entirely replaces the default search path. If this is the case, could the documentation be corrected?

[snicoll]

Actually, as I said already, I was wrong so the idea is to clarify the phrasing a bit to make that more obvious.

[dsyer]

That seems pretty clear to me. Anyone have a suggested wording for a replacement?

[snicoll]

I think an example would help. And the irrespective of part is a bit hidden in between a lengthy text. I got caught a few times (today again). But maybe it's just me and Tom? :)

[tomwhoiscontrary]

I think it is fairly clear.

At some point recently, i was griping about some other bits of phrasing on this page. Should i try making a pull request?

And would it be appropriate to mention @TestPropertySource here too?

[tomwhoiscontrary]

Uh @dsyer ...

[snicoll]

Dave your commit is referring to the wrong issue.

[dsyer]

Sorry. Aimed at #4063.

[philwebb]

@tomwhoiscontrary A pull request would be most welcome