*****************************************
Documentation for ihe_pharm_all/tools:
Last Update: 13.07.2011 by Tony Schaller
*****************************************

Open issues: 
- Shell scripts for Linux need to be implemented. 
	They should look similar to the batch files documented below. 
	Only the syntax need to be changed. No logical changes are necessary.
- load of external texts does not currently work with Safari Webbrowser 
	(e.g. select="document('doc-xsl-voc.xml')/...)
- Mark of the web:
	Please notice that Internet Explorer will show up a Security Warning when you open the xml files from the local environment because of the use of Java Script. 
	This occurs only with files on your local environment. When the XML is loaded from the web then this Message will not show up. 
	I tried to get rid of this but unfortunately Microsoft requires a special "Mark of the web" comment within the XML (<!-- saved from url... -->; see http://msdn.microsoft.com/en-us/library/ms537628(v=vs.85).aspx).
	The Mark of the web comment needs to be on a separate line, terminated using CR and LF. Using Saxon I did not succeed to create a CR character in the xml...
	Using Firefox or Safari you will not run into this issue.


Documentation:

stylesheets:
============
This directory contains all stylesheets and all related files. 
The necessary resources will be copied by the scripts into the corresponding output directories.

win32
=====
This directory contains reusable scripts for the Microsoft Windows environment (cmd). 
These scripts are called by the batch files documented below.

make_dist.bat
=============
This script creates all final IHE Pharmacy schematrons (PRE, PADV and DIS).
The final schematrons can be found in .../ihe_pharm_all/dist/output after the execution.
For a human friendly rendering you may open the *-sch.xml files in your webbrowser.

validate_samples.bat
====================
This script verifies all sample CDA documents (currently PRE_Tiani-Cisco-1.xml, PADV_Tiani-Cisco-1.xml and DIS_Tiani-Cisco-1.xml).
The Validation result can be found in .../ihe_pharm_all/validation/output after the execution.
For a human friendly rendering you may open the *-svrlt.xml files in your webbrowser.

do_all.bat
==========
Calls make_dist.bat and validate_samples.bat afterwards. 
Thus it creates all schematrons first and then it verifies all available samples.

make_dist_blank_templates.bat
=============================
This script creates the final schematron from the blank templates (master.sch and entity.sch). 
This is just for verifying purposes to check wheter scripts and blank templates are still correct.