Add comments to modify_msi.vbs.

It took me quite a while to reverse-engineer what it does, and more
importantly, why. Add comment to save time for the next reader.

diff --git a/installer/modify_msi.vbs b/installer/modify_msi.vbs
index 0f0f1a57c5516c766ff52f5ceecf9f5957226213..c1353fc894250533b862cf89e26c5eb620631f66 100755 (executable)
--- a/installer/modify_msi.vbs
+++ b/installer/modify_msi.vbs
@@ -2,6 +2,15 @@
 '  When the dll name of the driver is not of 8.3-format
 '      the modification of the FileName is needed
 '
+' This is to work-around a bug in the WiX Toolset, see
+' http://wixtoolset.org/issues/1422/
+'
+' We remove the short name from the filename field in the File-table
+' of the two DLLs that need to be registered as ODBC drivers. Strictly
+' speaking, that makes the contents of the table invalid, because a short
+' name is mandatory, but Windows Installer seems nevertheless install it
+' just fine.
+'
 option Explicit
 
 Const msiOpenDatabaseModeTransact = 1