From 43348b37117a1121f6672ca9ed35a93cf16a4739 Mon Sep 17 00:00:00 2001
From: Markus Quaritsch <markus.quaritsch@tugraz.at>
Date: Tue, 9 May 2017 09:54:32 +0200
Subject: [PATCH] adding comment for XSLT

---
 .../Resources/XSLT/SortInputData.xslt          | 18 ++++++++++++++++++
 VectoCore/VectoXML.spp                         |  2 +-
 2 files changed, 19 insertions(+), 1 deletion(-)

diff --git a/VectoCommon/VectoHashing/Resources/XSLT/SortInputData.xslt b/VectoCommon/VectoHashing/Resources/XSLT/SortInputData.xslt
index 8b93f41ce5..2715e0fcee 100644
--- a/VectoCommon/VectoHashing/Resources/XSLT/SortInputData.xslt
+++ b/VectoCommon/VectoHashing/Resources/XSLT/SortInputData.xslt
@@ -1,3 +1,21 @@
+<!--
+    This XSL transformation is intended to be applied as first canonicalization step when computing the hash
+    for VECTO component data or VECTO job data.
+
+    The transformation performs the following operations:
+      - strip off namespace prefixes
+         (although namespace prefixes are considered part of the signature for the purpose of hashing VECTO data
+         it does not provide additional semantics because the file has to validate against a XSD schema anyways 
+         and may cause troubles when re-creating the VECTO data from database systems)
+      - normalize the whitespaces of all attribute values and text nodes
+         leading and trailing whitespaces are removed
+         multiple whitespaces are replaced by a single whitespace
+      - sort entries in fuelconsumption map and loss-maps (i.e, transmission, axlegear, angledrive)
+      - sort entries of torque converter characteristics
+      - sort torque limiation entries 
+      - sort gears
+      - sort axles
+-->
 <xsl:transform version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
 	<xsl:output omit-xml-declaration="no" indent="yes"/>
 	<xsl:template match="*">
diff --git a/VectoCore/VectoXML.spp b/VectoCore/VectoXML.spp
index edbf55c904..38112e2e50 100644
--- a/VectoCore/VectoXML.spp
+++ b/VectoCore/VectoXML.spp
@@ -25,7 +25,7 @@
 	</Folder>
 	<Folder FolderName="XSL Files" ExtStr="xsl;xslt">
 		<File FilePath="E:\QUAM\Workspace\VECTO_API\API\RenderTable.xslt" HomeFolder="Yes"/>
-		<File FilePath="E:\QUAM\Workspace\VECTO_API\API\XSD\SortInputData.xslt" HomeFolder="Yes"/>
+		<File FilePath="E:\QUAM\Workspace\VECTO_quam\VectoCommon\VectoHashing\Resources\XSLT\SortInputData.xslt" HomeFolder="Yes"/>
 	</Folder>
 	<Folder FolderName="XQuery Files" ExtStr="xq;xql;xquery;xqu"/>
 	<Folder FolderName="HTML Files" ExtStr="html;htm;xhtml;asp"/>
-- 
GitLab