ViewVC Help
View File | Revision Log | Show Annotations | Root Listing
root/cvsroot/COMP/SCRAM/doc/html/build.html
Revision: 1.2
Committed: Mon Aug 28 08:40:55 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: +91 -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>build.html</title>
5     <body bgcolor=beige>
6     <! End Style Sheet Header -----------Insert Text Here --------------------->
7     <center>
8     <h1>Advanced Use of the scram build command</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     <h2>Default Behaviour</h2>
15     The default build is performed by issuing the starightforward command :
16     <p>
17     <b>scram build</b>
18     <p>
19     The exact default behaviour of the build command is determined by your location
20     in the source code and the build instructions corresponding to that location
21     as defined by the project.
22     This might be, for example, to create a library from all the local
23     .cc files, or build a debug binary object.
24     <p>
25     <h2>Extended Behaviour</h2>
26     The project may also provide additional build options which can be activated
27     through the command : <p>
28     <b>scram build <em>option</em></b>
29     <p>
30     The Options are again very dependent on where you are in the src code structure
31     and what the project configuration has made available. Below is a table of
32     the targets you might expect for a given function.
33     <p>
34     <table border=1>
35     <tr>
36     <th>Functional Class</th><th>Target Description</th></tr>
37     <tr>
38     <td>library</td>
39     <td><table border=1><tr><th>Name</th><th>Description</th></tr>
40     <tr>
41     <td><em>libraryname</em>.a </td><td>An optimised archive libary</td></tr>
42     <tr><td><em>libraryname</em>_d.a </td><td>A debug archive libary</td></tr>
43     <tr><td><em>libraryname</em>.so </td><td>A shared object (extension is machine dependent)</td></tr>
44     <tr><td><em>libraryname</em>_d.so </td>
45     <td>A debug shared object (extension is machine dependent)</td></tr>
46     <tr><td><em>libraryname</em>_Insure.a </td><td>Instrumented Insure archive libary</td></tr>
47     <tr><td><em>libraryname</em>_Insure.so </td><td>Instrumented Insure
48     shared object</td></tr>
49     <tr><td>archive</td><td>Optimised Archive Library</td></tr>
50     <tr><td>archive_debug</td><td>Debug Archive Library</td></tr>
51     <tr><td>archive_Insure</td><td>Insure Library</td></tr>
52     <tr><td>shared</td><td>Shared Object</td></tr>
53     <tr><td>shared_debug</td><td>Debug Shared Object</td></tr>
54     <tr><td>shared_Insure</td><td>Insure Shared Object</td></tr>
55     </table>
56     </td></tr>
57     <tr><td>executables</td>
58     <td><table border=1 width=100%><tr><th>Name</th><th>Description</th></tr>
59     <tr><td>bin</td><td>An executable</td></tr>
60     <tr><td>bin_debug</td><td>A debug executable</td></tr>
61     <tr><td>bin_insure</td><td>An Insure instrumented executable</td></tr>
62     <tr><td>bin_debug_local</td><td>A debug executable where debug libraries
63     will only be taken from the local area, ignoring any debug libs
64     in the central release area.</td></tr>
65     </table>
66     </td></tr>
67     <tr><td>java containers</td>
68     <td><table border=1 width=100%><tr><th>Name</th><th>Description</th></tr>
69     <tr><td>java_debug</td><td>Java debug class</td></tr>
70     <tr><td>java_opt</td><td>Java optimised class</td></tr>
71     <tr><td>java_debug_javadebug</td><td>Java debug compiled with javac_g</td></tr>
72     <tr><td>java_opt_javadebug</td><td>Java debug compiled with javac_g</td></tr>
73     </table>
74     </td></tr>
75     </table>
76    
77     <! Style Sheet Footer ---------------Do not change anything after this line-->
78     <hr>
79     <table border=1 width=100%>
80     <td align=left>
81     <a href=mailto:Christopher.Williams@cern.ch
82     >Chris Williams</a>
83     </td>
84     <td align=center>
85     Last Updated Wed Oct 13 14:54:39 1999
86     </td>
87     <td align=right><a href=/cgi-cmc/pagestat>Show Stats</a>
88     </td>
89     </table>
90     </body> </html>
91     <! End Style Sheet Footer>