A DESCRIPTION OF THE PROBLEM :
Currently it is not obvious where `java.library.path` has an effect and where it doesn't, because:
- `System.getProperties()` just describes it as "List of paths to search when loading libraries"
- None of the methods where it does have an effect mention it
=> This means you have to guess where it has an effect and can lead to confusion

Expected:
- System#loadLibrary and Runtime#loadLibrary should mention that they consider `java.library.path` (with a Javadoc `{@systemProperty ...}` tag); they should also mention that this might not affect dependent libraries (JDK-8213772)
- System#getProperties should extend the description for `java.library.path` and mention that it only affects System#loadLibrary and Runtime#loadLibrary
- SymbolLookup#libraryLookup(String, Arena) should explicitly mention that it does not consider `java.library.path` (JDK-8311090)