| 2 |
|
<html> |
| 3 |
|
<head> |
| 4 |
|
<title>localuse.html</title> |
| 5 |
< |
<body> |
| 5 |
> |
<body bgcolor=beige> |
| 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. |
| 7 |
> |
<center> |
| 8 |
> |
<h1>Using Scram as a Developer</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 |
> |
<li><h2>Online help</h2> |
| 16 |
> |
Help is available through the use of the help command. |
| 17 |
|
<p>e.g.<br> |
| 18 |
+ |
<table> |
| 19 |
+ |
<tr> |
| 20 |
+ |
<td> |
| 21 |
+ |
<font size=-1><b> |
| 22 |
+ |
scram help</b></font></td><td>will list the available scram commands</td> |
| 23 |
+ |
</tr> |
| 24 |
+ |
<tr> |
| 25 |
+ |
<td> |
| 26 |
|
<font size=-1> |
| 27 |
< |
scram help</font> will list the available scram commands |
| 28 |
< |
<br> |
| 29 |
< |
<font size=-1> |
| 30 |
< |
scram build help </font> List available build targets<br> |
| 31 |
< |
In general : |
| 27 |
> |
<b>scram <em>command</em> help</b></font></td> |
| 28 |
> |
<td> will list the help for that command</td> |
| 29 |
> |
</tr> |
| 30 |
> |
<tr> |
| 31 |
> |
<td> |
| 32 |
|
<font size=-1> |
| 33 |
< |
scram <em>command</em> help</font> will list the help for that command. |
| 34 |
< |
<h2>Creating your local development space</h2> |
| 35 |
< |
This section assumes that you have a locally installed copy of the project |
| 36 |
< |
you wish to work on. ( You can see the available locally installed copies |
| 24 |
< |
with the <font size=-1>scram list</font> command). |
| 33 |
> |
scram build help </font></td><td>Not working right now, but should list |
| 34 |
> |
the available types of build you can perform in that location</td> |
| 35 |
> |
</tr> |
| 36 |
> |
</table> |
| 37 |
|
<p> |
| 38 |
< |
<font size=-1> |
| 38 |
> |
<li><h2>Development Spaces</h2> |
| 39 |
> |
<h3>What are Development Spaces?</h3> |
| 40 |
> |
A development space is an isolated area that you can use to work on a |
| 41 |
> |
given project without affecting anyone else. This development space is |
| 42 |
> |
associated with a specific installation of the project from which it can |
| 43 |
> |
draw resources (e.g libraries, include files, environment) as required. |
| 44 |
> |
<br> |
| 45 |
> |
SCRAM will only attempt to construct libraries/binaries etc. |
| 46 |
> |
if it cannot find appropriate versions in the central installation. |
| 47 |
> |
|
| 48 |
> |
<h3>Creating Your Local Development Space</h3> |
| 49 |
> |
To develop on a given project you first need to have a copy of the project |
| 50 |
> |
installed at your site on which to base your development area. |
| 51 |
> |
You can see the available locally installed copies |
| 52 |
> |
with the command :<p> |
| 53 |
> |
<font size=-1><b>scram list</b></font> |
| 54 |
> |
<p> |
| 55 |
> |
To create your personal space you then issue the command: |
| 56 |
> |
<p> |
| 57 |
> |
<font size=-1><b> |
| 58 |
|
scram project <em>project_name</em> <em>project_version</em> |
| 59 |
+ |
</b> |
| 60 |
|
</font> |
| 61 |
< |
This command will create a development area. The development area will |
| 62 |
< |
reflect the structure and will have the same |
| 61 |
> |
<p> |
| 62 |
> |
Where <em>project_name</em> and <em>project_version</em> correspond to those |
| 63 |
> |
available from the <font size=-1><b>scram list</b></font> command. |
| 64 |
> |
<p> |
| 65 |
> |
The development area will reflect the structure and will have the same |
| 66 |
|
build environment as the base project specified. |
| 67 |
< |
<h2>Using The Development Area</h2> |
| 67 |
> |
<p> |
| 68 |
> |
<li><h2>Using The Development Area</h2> |
| 69 |
|
Assuming you are at the top of your new development area: |
| 70 |
|
<table border=0> |
| 71 |
|
<tr> |
| 72 |
|
<td> |
| 73 |
|
<font size=-1> |
| 74 |
< |
cd src</font></td><td> goto the src directory</td></tr> |
| 74 |
> |
<b>cd src</font></b></td><td> goto the src directory</td></tr> |
| 75 |
|
<tr> |
| 76 |
< |
<td><font size=-1> |
| 77 |
< |
cvs co <em>module</em> (e.g. for cvs based projects)</font></td> |
| 76 |
> |
<td valign=top><font size=-1> |
| 77 |
> |
<b>cvs co <em>module</em></b> (e.g. for cvs based projects)</font></td> |
| 78 |
|
<td>Check out whatever module you require. As an example, you may wish to |
| 79 |
|
develop a module that corresponds to a library. You will need to check-out the |
| 80 |
|
entire module, rather than just the files your working on, as the library |
| 86 |
|
If you wish to use a fixed tagged version or the head of a different |
| 87 |
|
development branch you must specify this with the -r option to cvs. |
| 88 |
|
<p> |
| 89 |
< |
e.g. <font size=-1>cvs co -r beta <em>module</em> |
| 89 |
> |
e.g. <font size=-1><b>cvs co -r beta <em>module</em></b> |
| 90 |
|
</font> |
| 91 |
|
<p> |
| 92 |
|
</td> |
| 93 |
|
</tr> |
| 94 |
< |
<td><font size=-1> |
| 95 |
< |
scram build</td> |
| 94 |
> |
<td valign=top><font size=-1> |
| 95 |
> |
<b> |
| 96 |
> |
scram build</b></td> |
| 97 |
|
</font> |
| 98 |
|
<td>Will perform the default build that corresponds to the directory in which |
| 99 |
|
you type the command.</td> |
| 100 |
|
</tr> |
| 101 |
|
</table> |
| 102 |
+ |
<li><h2>Runtime Environment</h2> |
| 103 |
+ |
Each project you are working on is likeley to have different and possibly |
| 104 |
+ |
even conflicting Environmental requirements during both runtime and build time. |
| 105 |
+ |
SCRAM automatically takes care of the buildtime environment, however it is |
| 106 |
+ |
unable to set your runtime environment for you. It can however tell you what |
| 107 |
+ |
the runtime environment should be for any given project. To see the |
| 108 |
+ |
required environment simply issue the <p> |
| 109 |
+ |
<font size=-1><b>scram runtime [-csh|-sh]</b></font> |
| 110 |
+ |
<p> |
| 111 |
+ |
command from anywhere in a development space. Use the command<p> |
| 112 |
+ |
<font size=-1><b>scram runtime help</b></font> |
| 113 |
+ |
<p> |
| 114 |
+ |
for examples of use. |
| 115 |
+ |
</ol> |
| 116 |
|
<! Style Sheet Footer ---------------Do not change anything after this line--> |
| 117 |
|
<hr> |
| 118 |
|
<table border=1 width=100%> |
