| 1 |
+ |
<! Style Sheet Header> |
| 2 |
+ |
<html> |
| 3 |
+ |
<head> |
| 4 |
+ |
<title>external.html</title> |
| 5 |
+ |
<body bgcolor=beige> |
| 6 |
+ |
<! End Style Sheet Header -----------Insert Text Here ---------------------> |
| 7 |
+ |
<center> |
| 8 |
+ |
<h1>External Libraries</h1> |
| 9 |
+ |
<font color=red>S</font>oftware <font color=red>C</font>onfiguration, |
| 10 |
+ |
<font color=red>R</font>elease <font color=red>A</font>nd |
| 11 |
+ |
<font color=red>M</font>anagement |
| 12 |
+ |
</center> |
| 13 |
+ |
<hr> |
| 14 |
+ |
<ol> |
| 15 |
+ |
<h2>The <External> Tag</h2> |
| 16 |
+ |
Use<p> |
| 17 |
+ |
<font color="green"> |
| 18 |
+ |
<External ref=<em>Tool_name</em> [use=<em>group name</em>]> |
| 19 |
+ |
</font><p> |
| 20 |
+ |
This tag is used to specify the dependency on an external tool, such as a |
| 21 |
+ |
library package etc. The name of the tool must refer to one of the tools defined |
| 22 |
+ |
in your areas configuration. |
| 23 |
+ |
<p> |
| 24 |
+ |
The optional <b>use=</b> element can be specified where the |
| 25 |
+ |
<a href=export.html><export></a> interface has been defined in another |
| 26 |
+ |
SCRAM managed project. i.e. It allows you to choose subsets of the libraries |
| 27 |
+ |
from other SCRAM projects as if you were using a <use> tag in your local |
| 28 |
+ |
project. |
| 29 |
+ |
<p> |
| 30 |
+ |
Note that if the used interface itself specifies an <External> tag then the |
| 31 |
+ |
specified tool still has to exist in the local configuration. |
| 32 |
+ |
<h2>Example 1</h2> |
| 33 |
+ |
You are working in your local project and wish to link against the X11 libraries |
| 34 |
+ |
<br> |
| 35 |
+ |
Assuming X11 is part of your project environment you can simply |
| 36 |
+ |
Edit your BuildFile and add the line |
| 37 |
+ |
<p> |
| 38 |
+ |
<font color="green"> |
| 39 |
+ |
<External ref=X11> |
| 40 |
+ |
</font> |
| 41 |
+ |
<p> |
| 42 |
+ |
<h2>Example 2</h2> |
| 43 |
+ |
You now wish to work with another SCRAM based project called "foo". |
| 44 |
+ |
If you proceed as in the |
| 45 |
+ |
previous example you are likely to get all possible libraries. |
| 46 |
+ |
<p> |
| 47 |
+ |
You know however that you are only interested in the libraries for the subsystem |
| 48 |
+ |
"bar", then (again assuming your project configuration knows about "foo") add |
| 49 |
+ |
this to your BuildFile |
| 50 |
+ |
<p> |
| 51 |
+ |
<font color="green"> |
| 52 |
+ |
<External ref=foo use=bar> |
| 53 |
+ |
</font> |
| 54 |
+ |
</ol> |
| 55 |
+ |
<! Style Sheet Footer ---------------Do not change anything after this line--> |
| 56 |
+ |
<hr> |
| 57 |
+ |
<table border=1 width=100%> |
| 58 |
+ |
<td align=left> |
| 59 |
+ |
<a href=mailto:Christopher.Williams@cern.ch |
| 60 |
+ |
>Chris Williams</a> |
| 61 |
+ |
</td> |
| 62 |
+ |
<td align=center> |
| 63 |
+ |
<script language="JavaScript"> |
| 64 |
+ |
<!---//hide script from old browsers |
| 65 |
+ |
document.write( "<br>Last updated "+ document.lastModified |
| 66 |
+ |
); |
| 67 |
+ |
//end hiding contents ---> |
| 68 |
+ |
</script> |
| 69 |
+ |
</td> |
| 70 |
+ |
<td align=right>Show <a href=/cgi-cmc/pagestat>Stats</a> |
| 71 |
+ |
</td> |
| 72 |
+ |
</table> |
| 73 |
+ |
</body> </html> |
| 74 |
+ |
<! End Style Sheet Footer> |
