Reworking pre-compile scripts for Windows (#1594)

* Updated pre-compile scripts for OSVVM.

* Reworked script for Vivado.

* Reworked script for ISE.

* Reworked UVVM compile script. Cannot be tested due to missing feature in GHDL see #1593.

* Reworked scripts for Altera, Intel and Lattice.

* Updated module imports.

* Adjusted warnings.

* Read OSVVM package files from compile-order file 'osvvm.pro'.

* Support OSVVM and OSVVMLibraries as source directory.

* Added support for OSVVM models to precompile script.

* First update to the pre-compile scripts documentation.

* Minimized file headers and redundant documentation. Using PowerShell's feature to document files, functions and modules.

* Updated README in precompile scripts directory.

* license: update headers of pyGHDL, scripts/windows, libraries/vendors

* Fixed ForegroundColor and InvocationName.

Co-authored-by: umarcor <unai.martinezcorral@ehu.eus>

1 files changed, 33 insertions, 38 deletions

diff --git a/libraries/vendors/config.psm1 b/libraries/vendors/config.psm1
index c04223a90..a58b2c4a1 100644
--- a/libraries/vendors/config.psm1
+++ b/libraries/vendors/config.psm1
@@ -1,36 +1,31 @@
-# EMACS settings: -*-	tab-width: 2; indent-tabs-mode: t -*-
-# vim: tabstop=2:shiftwidth=2:noexpandtab
-# kate: tab-width 2; replace-tabs off; indent-width 2;
-# 
 # ==============================================================================
-#	Authors:						Patrick Lehmann
-# 
-#	PowerShell Module:	Configurable directories to local installed tools
-# 
-# Description:
-# ------------------------------------
-#	This PowerShell module exports variables containing the users local tool
-#	environment.
+#  Authors:
+#    Patrick Lehmann
 #
 # ==============================================================================
-#	Copyright (C) 2015-2016 Patrick Lehmann - Dresden, Germany
-#	Copyright (C) 2017-2018 Patrick Lehmann - Freiburg, Germany
-#	
-#	GHDL is free software; you can redistribute it and/or modify it under
-#	the terms of the GNU General Public License as published by the Free
-#	Software Foundation; either version 2, or (at your option) any later
-#	version.
-#	
-#	GHDL is distributed in the hope that it will be useful, but WITHOUT ANY
-#	WARRANTY; without even the implied warranty of MERCHANTABILITY or
-#	FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
-#	for more details.
-#	
-#	You should have received a copy of the GNU General Public License
-#	along with GHDL; see the file COPYING.  If not, write to the Free
-#	Software Foundation, 59 Temple Place - Suite 330, Boston, MA
-#	02111-1307, USA.
+#  Copyright (C) 2017-2021 Patrick Lehmann - Boetzingen, Germany
+#  Copyright (C) 2015-2016 Patrick Lehmann - Dresden, Germany
+#
+#  This program is free software: you can redistribute it and/or modify
+#  it under the terms of the GNU General Public License as published by
+#  the Free Software Foundation, either version 2 of the License, or
+#  (at your option) any later version.
+#
+#  This program is distributed in the hope that it will be useful,
+#  but WITHOUT ANY WARRANTY; without even the implied warranty of
+#  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+#  GNU General Public License for more details.
+#
+#  You should have received a copy of the GNU General Public License
+#  along with this program.  If not, see <gnu.org/licenses>.
 # ==============================================================================
+
+# .SYNOPSIS
+# Configuration files to store settings and installation directories for 3rd party tools..
+#
+# .DESCRIPTION
+# This configuaration file stores settings for pre-compile scripts, so scripts
+# can be called with less command line arguments.
 #
 [CmdletBinding()]
 param(
@@ -40,7 +35,7 @@ param(
 $Module_VendorToolName = $VendorToolName
 
 # Configure your tools here. Use absolute paths, without trailing directory
-#	delimiter. Empty strings indicate not installed tools
+# delimiter. Empty strings indicate not installed tools
 $Settings = @{
 	"AlteraQuartus" =		@{
 		"InstallationDirectory" = "";								# "C:\Altera\16.0\quartus";
@@ -48,22 +43,22 @@ $Settings = @{
 		"DestinationDirectory" =  "altera"
 	};
 	"IntelQuartus" =		@{
-		"InstallationDirectory" = "";								# "C:\IntelFPGA\17.1\quartus";
+		"InstallationDirectory" = "";								# "C:\IntelFPGA\20.1\quartus";
 		"SourceDirectory" =       "eda\sim_lib";
 		"DestinationDirectory" =  "intel"
 	};
 	"LatticeDiamond" =	@{
-		"InstallationDirectory" = "";								# "C:\Lattice\Diamond\3.8_x64";
+		"InstallationDirectory" = "";								# "C:\Lattice\Diamond\3.10_x64";
 		"SourceDirectory" =       "cae_library\simulation\vhdl";
 		"DestinationDirectory" =  "lattice"
 	};
 	"OSVVM" =						@{
-		"InstallationDirectory" = "";								# "C:\git\GitHub\osvvm";
+		"InstallationDirectory" = "";								# "C:\git\GitHub\OSVVM";
 		"SourceDirectory" =       ".";
 		"DestinationDirectory" =  "."
 	};
 	"UVVM" =						@{
-		"InstallationDirectory" = "";								# "C:\git\GitHub\uvvm_alls";
+		"InstallationDirectory" = "";								# "C:\git\GitHub\UVVM";
 		"SourceDirectory" =       ".";
 		"DestinationDirectory" =  "."
 	};
@@ -73,7 +68,7 @@ $Settings = @{
 		"DestinationDirectory" =  "xilinx-ise"
 	};
 	"XilinxVivado" =		@{
-		"InstallationDirectory" = "";								# "C:\Xilinx\Vivado\2017.4";
+		"InstallationDirectory" = "";								# "C:\Xilinx\Vivado\2020.2";
 		"SourceDirectory" =       "data\vhdl\src";
 		"DestinationDirectory" =  "xilinx-vivado"
 	}
@@ -84,7 +79,7 @@ function Get-VendorToolInstallationDirectory
 {	<#
 		.SYNOPSIS
 		Undocumented
-		
+
 		.DESCRIPTION
 		Undocumented
 	#>
@@ -95,7 +90,7 @@ function Get-VendorToolSourceDirectory
 {	<#
 		.SYNOPSIS
 		Undocumented
-		
+
 		.DESCRIPTION
 		Undocumented
 	#>
@@ -106,7 +101,7 @@ function Get-VendorToolDestinationDirectory
 {	<#
 		.SYNOPSIS
 		Undocumented
-		
+
 		.DESCRIPTION
 		Undocumented
 	#>