1 |
<! Style Sheet Header>
|
2 |
<html>
|
3 |
<head>
|
4 |
<title>localuse.html</title>
|
5 |
<body>
|
6 |
<! End Style Sheet Header -----------Insert Text Here --------------------->
|
7 |
Using scram in development. A simple example
|
8 |
<p>
|
9 |
<h2>Online help</h2>
|
10 |
Apart from these web pages, help is available through the use of the help
|
11 |
command.
|
12 |
<p>e.g.<br>
|
13 |
<font size=-1>
|
14 |
scram help</font> will list the available scram commands
|
15 |
<br>
|
16 |
<font size=-1>
|
17 |
scram build help </font> List available build targets<br>
|
18 |
In general :
|
19 |
<font size=-1>
|
20 |
scram <em>command</em> help</font> will list the help for that command.
|
21 |
<h2>Creating your local development space</h2>
|
22 |
This section assumes that you have a locally installed copy of the project
|
23 |
you wish to work on. ( You can see the available locally installed copies
|
24 |
with the <font size=-1>scram list</font> command).
|
25 |
<p>
|
26 |
<font size=-1>
|
27 |
scram project <em>project_name</em> <em>project_version</em>
|
28 |
</font>
|
29 |
This command will create a development area. The development area will
|
30 |
reflect the structure and will have the same
|
31 |
build environment as the base project specified.
|
32 |
<h2>Using The Development Area</h2>
|
33 |
Assuming you are at the top of your new development area:
|
34 |
<table border=0>
|
35 |
<tr>
|
36 |
<td>
|
37 |
<font size=-1>
|
38 |
cd src</font></td><td> goto the src directory</td></tr>
|
39 |
<tr>
|
40 |
<td><font size=-1>
|
41 |
cvs co <em>module</em> (e.g. for cvs based projects)</font></td>
|
42 |
<td>Check out whatever module you require. As an example, you may wish to
|
43 |
develop a module that corresponds to a library. You will need to check-out the
|
44 |
entire module, rather than just the files your working on, as the library
|
45 |
building system uses the local file list to specify the library contents.
|
46 |
<p>
|
47 |
Once checked out you can cd into the module and edit the files as
|
48 |
required.
|
49 |
<p><em><b>Note</b> The cvs co command above will give you the development head.
|
50 |
If you wish to use a fixed tagged version or the head of a different
|
51 |
development branch you must specify this with the -r option to cvs.
|
52 |
<p>
|
53 |
e.g. <font size=-1>cvs co -r beta <em>module</em>
|
54 |
</font>
|
55 |
<p>
|
56 |
</td>
|
57 |
</tr>
|
58 |
<td><font size=-1>
|
59 |
scram build</td>
|
60 |
</font>
|
61 |
<td>Will perform the default build that corresponds to the directory in which
|
62 |
you type the command.</td>
|
63 |
</tr>
|
64 |
</table>
|
65 |
<! Style Sheet Footer ---------------Do not change anything after this line-->
|
66 |
<hr>
|
67 |
<table border=1 width=100%>
|
68 |
<td align=left>
|
69 |
<a href=mailto:Christopher.Williams@cern.ch
|
70 |
>Chris Williams</a>
|
71 |
</td>
|
72 |
<td align=center>
|
73 |
<script language="JavaScript">
|
74 |
<!---//hide script from old browsers
|
75 |
document.write( "<br>Last updated "+ document.lastModified
|
76 |
);
|
77 |
//end hiding contents --->
|
78 |
</script>
|
79 |
</td>
|
80 |
<td align=right>Show <a href=/cgi-cmc/pagestat>Stats</a>
|
81 |
</td>
|
82 |
</table>
|
83 |
</body> </html>
|
84 |
<! End Style Sheet Footer>
|