| 1 |
<! Style Sheet Header>
|
| 2 |
<html>
|
| 3 |
<head>
|
| 4 |
<title>localuse.html</title>
|
| 5 |
<body bgcolor=beige>
|
| 6 |
<! End Style Sheet Header -----------Insert Text Here --------------------->
|
| 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 |
<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 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 |
<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 |
<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 |
<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 |
<b>cd src</font></b></td><td> goto the src directory</td></tr>
|
| 75 |
<tr>
|
| 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
|
| 81 |
building system uses the local file list to specify the library contents.
|
| 82 |
<p>
|
| 83 |
Once checked out you can cd into the module and edit the files as
|
| 84 |
required.
|
| 85 |
<p><em><b>Note</b> The cvs co command above will give you the development head.
|
| 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><b>cvs co -r beta <em>module</em></b>
|
| 90 |
</font>
|
| 91 |
<p>
|
| 92 |
</td>
|
| 93 |
</tr>
|
| 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%>
|
| 119 |
<td align=left>
|
| 120 |
<a href=mailto:Christopher.Williams@cern.ch
|
| 121 |
>Chris Williams</a>
|
| 122 |
</td>
|
| 123 |
<td align=center>
|
| 124 |
<script language="JavaScript">
|
| 125 |
<!---//hide script from old browsers
|
| 126 |
document.write( "<br>Last updated "+ document.lastModified
|
| 127 |
);
|
| 128 |
//end hiding contents --->
|
| 129 |
</script>
|
| 130 |
</td>
|
| 131 |
<td align=right>Show <a href=/cgi-cmc/pagestat>Stats</a>
|
| 132 |
</td>
|
| 133 |
</table>
|
| 134 |
</body> </html>
|
| 135 |
<! End Style Sheet Footer>
|
