<html xmlns:o="urn:schemas-microsoft-com:office:office" xmlns:w="urn:schemas-microsoft-com:office:word" xmlns="http://www.w3.org/TR/REC-html40">

<head>
<meta http-equiv=Content-Type content="text/html; charset=us-ascii">
<meta name=Generator content="Microsoft Word 11 (filtered medium)">
<style>
<!--
 /* Style Definitions */
 p.MsoNormal, li.MsoNormal, div.MsoNormal
        {margin:0in;
        margin-bottom:.0001pt;
        font-size:12.0pt;
        font-family:"Times New Roman";}
p.MsoBodyText, li.MsoBodyText, div.MsoBodyText
        {margin-top:0in;
        margin-right:0in;
        margin-bottom:12.0pt;
        margin-left:0in;
        text-autospace:none;
        font-size:12.0pt;
        font-family:"Times New Roman";}
a:link, span.MsoHyperlink
        {color:blue;
        text-decoration:underline;}
a:visited, span.MsoHyperlinkFollowed
        {color:purple;
        text-decoration:underline;}
span.EmailStyle17
        {mso-style-type:personal-compose;
        font-family:Arial;
        color:windowtext;}
@page Section1
        {size:8.5in 11.0in;
        margin:1.0in 1.25in 1.0in 1.25in;}
div.Section1
        {page:Section1;}
 /* List Definitions */
 @list l0
        {mso-list-id:1537231834;
        mso-list-type:hybrid;
        mso-list-template-ids:1360415828 67698703 67698713 67698715 67698703 67698713 67698715 67698703 67698713 67698715;}
@list l0:level1
        {mso-level-tab-stop:.5in;
        mso-level-number-position:left;
        text-indent:-.25in;}
@list l1
        {mso-list-id:1769428646;
        mso-list-type:hybrid;
        mso-list-template-ids:-1327882076 67698703 67698713 67698715 67698703 67698713 67698715 67698703 67698713 67698715;}
@list l1:level1
        {mso-level-tab-stop:1.0in;
        mso-level-number-position:left;
        margin-left:1.0in;
        text-indent:-.25in;}
@list l1:level2
        {mso-level-number-format:alpha-lower;
        mso-level-tab-stop:1.5in;
        mso-level-number-position:left;
        margin-left:1.5in;
        text-indent:-.25in;}
ol
        {margin-bottom:0in;}
ul
        {margin-bottom:0in;}
-->
</style>

</head>

<body lang=EN-US link=blue vlink=purple>

<div class=Section1>

<p class=MsoBodyText style='text-align:justify'><font size=2 face=Arial><span
style='font-size:10.0pt;font-family:Arial'>I couldn&#8217;t find much
documentation of UserCodeLibrary attributes in the GReAT User manual. In fact,
the only documentation I found for the feature was, &#8220;<font color=black><span
style='color:black'>UserCodeLibrary<b><span style='font-weight:bold'> </span></b></span>contains
the additional user predefined library files, include files and the
corresponding directories.&#8221; </font>Maybe we could document here exactly
how this feature works.<font color=black><span style='color:black'><o:p></o:p></span></font></span></font></p>

<p class=MsoNormal><font size=2 face=Arial><span style='font-size:10.0pt;
font-family:Arial'>There are four fields that can be filled in to include
external code in a GReAT transformation:<o:p></o:p></span></font></p>

<p class=MsoNormal><font size=2 face=Arial><span style='font-size:10.0pt;
font-family:Arial'><o:p>&nbsp;</o:p></span></font></p>

<p class=MsoNormal><font size=2 face=Arial><span style='font-size:10.0pt;
font-family:Arial'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Include
files?<o:p></o:p></span></font></p>

<p class=MsoNormal><font size=2 face=Arial><span style='font-size:10.0pt;
font-family:Arial'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Library
Files?<o:p></o:p></span></font></p>

<p class=MsoNormal><font size=2 face=Arial><span style='font-size:10.0pt;
font-family:Arial'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Include
Directories?<o:p></o:p></span></font></p>

<p class=MsoNormal><font size=2 face=Arial><span style='font-size:10.0pt;
font-family:Arial'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Library
Directories?<o:p></o:p></span></font></p>

<p class=MsoNormal><font size=2 face=Arial><span style='font-size:10.0pt;
font-family:Arial'><o:p>&nbsp;</o:p></span></font></p>

<p class=MsoNormal><font size=2 face=Arial><span style='font-size:10.0pt;
font-family:Arial'>So, what are the answers to the following questions:<o:p></o:p></span></font></p>

<p class=MsoNormal><font size=2 face=Arial><span style='font-size:10.0pt;
font-family:Arial'><o:p>&nbsp;</o:p></span></font></p>

<ol style='margin-top:0in' start=1 type=1>
 <li class=MsoNormal style='mso-list:l0 level1 lfo2'><font size=2 face=Arial><span
     style='font-size:10.0pt;font-family:Arial'>What exactly is the purpose of
     each of these fields?<o:p></o:p></span></font></li>
 <li class=MsoNormal style='mso-list:l0 level1 lfo2'><font size=2 face=Arial><span
     style='font-size:10.0pt;font-family:Arial'>Does the purpose or
     interpretation of some of the fields change based on whether one uses the
     GRE or the CG?<o:p></o:p></span></font></li>
 <li class=MsoNormal style='mso-list:l0 level1 lfo2'><font size=2 face=Arial><span
     style='font-size:10.0pt;font-family:Arial'>What is the effect of
     whitespace in the different fields? Does it act as an entry delimiter?
     Does it cause strange errors to have whitespace in a path name?<o:p></o:p></span></font></li>
 <li class=MsoNormal style='mso-list:l0 level1 lfo2'><font size=2 face=Arial><span
     style='font-size:10.0pt;font-family:Arial'>In which fields are quotation
     marks around paths expected, and in which are they disallowed? In which
     are they optional? If I place quotation marks around a path name, is it
     always okay for that path name to include whitespace?<o:p></o:p></span></font></li>
 <li class=MsoNormal style='mso-list:l0 level1 lfo2'><font size=2 face=Arial><span
     style='font-size:10.0pt;font-family:Arial'>What delimiters should we use
     if, for instance, we need to reference multiple files in &#8220;Include
     files?&#8221;?<o:p></o:p></span></font></li>
</ol>

<p class=MsoNormal><font size=2 face=Arial><span style='font-size:10.0pt;
font-family:Arial'><o:p>&nbsp;</o:p></span></font></p>

<p class=MsoNormal><font size=2 face=Arial><span style='font-size:10.0pt;
font-family:Arial'>At this point, I do not know how to reliably generate a
working project file/make file using any of the UserCodeLibrary fields, except
by including a single header file per UserCodeLibrary atom (using only the &#8220;Include
files?&#8221; field) and copying the needed files into either the CG project
directory or the GReAT\tmp directory. Obviously, this means I can&#8217;t
really distribute a GReAT project to others in such a way that they can build a
transformation using the CG or the GRE without copying around files or editing
the library header files I provide depending on what they want to do. <o:p></o:p></span></font></p>

<p class=MsoNormal><font size=2 face=Arial><span style='font-size:10.0pt;
font-family:Arial'><o:p>&nbsp;</o:p></span></font></p>

<p class=MsoNormal><font size=2 face=Arial><span style='font-size:10.0pt;
font-family:Arial'>Some documentation of how this feature works would really
help.<o:p></o:p></span></font></p>

<p class=MsoNormal><font size=2 face=Arial><span style='font-size:10.0pt;
font-family:Arial'><o:p>&nbsp;</o:p></span></font></p>

<p class=MsoNormal><font size=2 face=Arial><span style='font-size:10.0pt;
font-family:Arial'>--Matt<o:p></o:p></span></font></p>

<p class=MsoNormal><font size=2 face=Arial><span style='font-size:10.0pt;
font-family:Arial'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <o:p></o:p></span></font></p>

</div>

</body>

</html>