ViewVC Help
View File | Revision Log | Show Annotations | Root Listing
root/cvsroot/COMP/SCRAM/doc/html/external.html
Revision: 1.2
Committed: Mon Aug 28 08:40:56 2000 UTC (24 years, 8 months ago) by williamc
Content type: text/html
Branch: MAIN
CVS Tags: V0_18_5, V0_18_4, V_18_3_TEST, V0_18_2, V0_18_1
Changes since 1.1: +74 -0 lines
Log Message:
Merge in new documentation

File Contents

# User Rev Content
1 williamc 1.2 <! 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 &lt;External> Tag</h2>
16     Use<p>
17     <font color="green">
18     &lt;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>&lt;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 &lt;use> tag in your local
28     project.
29     <p>
30     Note that if the used interface itself specifies an &lt;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     &lt;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     &lt;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>