docs: Update static linking info
authorCharles Giessen <charles@lunarg.com>
Tue, 29 Sep 2020 20:00:21 +0000 (14:00 -0600)
committerCharles Giessen <46324611+charles-lunarg@users.noreply.github.com>
Tue, 29 Sep 2020 21:26:19 +0000 (15:26 -0600)
When static linking was removed as a build option, the documentation
for it was not ammended. This commit changes the text to describe that
it used to be supported, is no longer supported, and why the feature
was removed.

Change-Id: I8da0c1c811be7e9dc5119c4c27c34a5cbb30edf8

loader/LoaderAndLayerInterface.md

index dfd247d4d870f212fa96c44ab2faef9cecaecd5c..cba33db0535afad6a0d1f9564d4a25002751e5e3 100644 (file)
@@ -330,20 +330,18 @@ be completely sure that a loader is present, they can include a loader or
 runtime installer with their application.
 
 ###### Static Linking
-The loader can also be used as a static library (this is shipped in the
-Windows SDK as `VKstatic.1.lib`). Linking to the static loader means that the
-user does not need to have a Vulkan runtime installed, and it also guarantees
-that your application will use a specific version of the loader. However, there
-are several downsides to this approach:
-
-  - The static library can never be updated without re-linking the application
-  - This opens up the possibility that two included libraries could contain
+In previous versions of the loader, it was possible to statically link the loader.
+This was removed and is no longer possible. The decision to remove static linking
+was because of changes to the driver which made older applications that statically
+linked unable to find newer drivers.
+
+Additionally, static linking posed several problems:
+  - The loader can never be updated without re-linking the application
+  - The possibility that two included libraries could contain
   different versions of the loader
-    - This could potentially cause conflicts between the different loader versions
-
-As a result, it is recommended that users prefer linking to the dynamic
-versions of the loader.
+    - Could cause conflicts between the different loader versions
 
+The only exception to this is for macOS, but is not supported or tested.
 
 ##### Indirectly Linking to the Loader
 Applications are not required to link directly to the loader library, instead