sysmodellibs/sysmodelgen/doc/sysmodel/Command-lineOptions/Build-Control-options.html
author Bob Rosenberg <bob.rosenberg@nokia.com>
Wed, 13 Oct 2010 16:21:25 +0100
changeset 7 3c36c452f013
permissions -rw-r--r--
Version 2.0 release of System Model Generator, which draws 3.x syntax system definition files

<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
    <!-- Generated by Xbuild version: 5.0.20 -->
    <head>
        <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
	<meta name="show-comments" content="" />
	<title>Build Control Options in System Model Generator Command-line Options</title>    
	<link href="../../_stock/css/reset.css" rel="stylesheet" type="text/css" />
	<link href="../../_stock/css/portal.css" rel="stylesheet" type="text/css" />
	<link href="../../_stock/css/iefix.css" rel="stylesheet" type="text/css" />
	<link href="../../_stock/css/ui.tabs.css" rel="stylesheet" type="text/css" />
	<link href="../../_stock/css/developer.css" rel="stylesheet" type="text/css" />
	<link rel="stylesheet" type="text/css" href="../../_stock/css/ui.css" media="screen" />
	<link rel="stylesheet" type="text/css" href="../../_stock/css/sysdoc.css" media="screen" />
	<link rel="stylesheet" type="text/css" href="../../_stock/css/sdlplugin.css" media="screen" />
    </head>
    <body>
	<div id="main_content">
	    <table width="100%" cellpadding="0" cellspacing="0" border="0">
		<tr>
		    <td valign="top" width="100%">
			<div id="main_content_txt">
			    <div class="main_content_padding">		
                                <div id="main">
                                    <div id="authoredContent">
                                        <div class="section">
<a name="BuildControl"></a><h1>Build Control Options</h1><table class="TableWrap" border="1" cellpadding="1" cellspacing="0"><tr valign="top"><th>Options</th><th>Description</th></tr>

<tr valign="top"><td class="Cell"><p><code>
-csv_columns <var>outfile</var></code></p></td><td class="Cell"><p>Comma-separated list of columns to include in
                       the output CSV.  This does nothing if <code>-csv_output</code> is not present. By default (if 
					   <code>-csv_columns</code> is not present), the columns will be
                       a sorted list of all attributes on all items.
		</p></td></tr><tr valign="top"><td class="Cell"><p><code>
 -csv_labels <var>list</var></code></p></td><td class="Cell"><p>Comma-separated list of columns labels include
                       in the output CSV.  Do not use quotes or commas
                       in label names. This does nothing if <code>-csv_output</code>
                       is not present. If this list is shorter than <code>-csv_columns</code>, the remaining columns will use the
                       attribute name as the label.
		</td></tr><tr valign="top"><td class="Cell"><p><code>
 -xml_output <var>outfile</var></code></p></td><td class="Cell"><p>The name of the file to save a combined system
                       definition XML. Only items shown in the built
                       system model will be included.
		</td></tr><tr valign="top"><td class="Cell"><p><code>
 -w <var>number</var></code></p></td><td class="Cell"><p>Warning levels</p>.
		  <ul> 
			<li>
 
			  <p>
				<code>-w 1</code>: displays errors only (default) 
			  </p> 
			</li>
 
			<li>
 
			  <p>
				<code>-w 2</code>: displays warnings as well as errors 
			  </p> 
			</li>
 
			<li>
 
			  <p>
				<code>-w 3</code>: displays info messages, warnings and errors.
				
			  </p> 
			</li>
 
			<li>
 
			  <p>
				<code>-w 4</code>: displays info messages, warnings and errors
				along with deep syntax validation and reporting. 
			  </p> 
			  <p>
				<b>Note</b>: This option can take a long time in
				computation so do not use this warning level by default. 
			  </p> 
			</li>
 
		  </ul>

		</td></tr><tr valign="top"><td class="Cell"><p><code>
 -lowmem  </code></p></td><td class="Cell"><p>Build the model storing more data in the temp
                       directory and using less runtime memory. If
                       building fails due to an out of memory
                       condition, try running again with the <code>-lowmem</code>
                       option.
		</p></td></tr><tr valign="top"><td class="Cell"><p><code>
 -clean          </code></p></td><td class="Cell"><p>      Caution: if set,  it will delete the contents of
                       the temporary directory.
		</p></td></tr><tr valign="top"><td class="Cell"><p><code>
 -compress      </code></p></td><td class="Cell"><p>       If set, it will attempt to compress the output
                       as an SVGZ file. In order to succeed gzip must
                       be installed and in the <code>PATH</code>. This will also
                       rename the output file from filename.svg to
                       filename.svgz.
	</p>	</td></tr><tr valign="top"><td class="Cell" id="tempdir"><p><code>
 -tempdir <var>dir</var>    </code></p></td><td class="Cell"><p>    Temporary directory for build files. Defaults
                       to <code>drawsvg_temp</code>
	</p>	</td></tr><tr valign="top"><td class="Cell"><p><code>
 -output <var>outfile</var>  </code></p></td><td class="Cell"><p>   The name of the file to save the built System
                       Model SVG. If in the format filename.svgz, it
                       will attempt to compress the file. If
                       compression is not supported, it will rename the
                       output to filename.svg. Defaults to sysmodel.svg
                       or sysmodel.svgz if <code>-compress</code> is set. Defaults
                       to "sysmodel.svg"
	</p>	</td></tr><tr valign="top"><td class="Cell"><p><code>
 -csv_output <var>outfile</var> </code></p></td><td class="Cell"><p>The name of the file to save a CSV description
                       of the built System Model. Only items shown on
                       the system model will be included.
	</p>	</td></tr><tr valign="top"><td class="Cell"><p><code>
 -xslt-param  <var>param</var> <var>string-value</var>    </code></p></td><td class="Cell"><p>     Advanced: Parameters to feed directly to the
                       XSLT transforms. Can specify multiple times.
	</p>	</td></tr><tr valign="top"><td class="Cell"><p><code>
 -dictionary <var>file/uri</var> </code></p></td><td class="Cell"><p>A term dictionary file used to semi-
                       intelligently generate the abbreviations for the
                       names of system model entries. Anything
                       mentioned in the Localization files overrides
                       generated abbreviations.
	</p>	</td></tr><tr valign="top"><td class="Cell"><p><code>
 -log <var>outfile</var>   </code></p></td><td class="Cell"><p>     File in which to store output. Defaults to
                       stdout
	</p>	</td></tr></table><div class="section">
<h2> See also</h2><p>
		<a href="Basic-Options.html#Basicoptions">Basic Options</a> 
	  </p><p>
		<a href="Files-or-uri-options.html#fileorurioptions">Files or URIs Options</a> 
	  </p><p>
		<a href="Labels-options.html#labeloptions">Labels Options</a> 
	  </p><p>
		<a href="Model-Control-options-ref.html#modelcontrol">Model Control Options</a> 
	  </p></div>
</div>

                                    </div>
                                    <div id="printer_copyright">
                                        <div id="printer_copyright_padding">
                                            Copyright &copy;2009&nbsp; Nokia Corporation and/or its subsidiary(-ies). All rights reserved. License: <a href="http://www.symbianfoundation.org/legal/sfl-v10.html">SFL</a>
                                        </div>
                                    </div>
                                </div>
			    </div>
			</div>
		    </td>
		</tr>
	    </table>
	    <div style="clear: both"></div>
	</div>
	<div id="includedFooter">
	    <div id="devnet_footer">
            <div style="float: left;">Copyright &copy;2009&nbsp; Nokia Corporation and/or its subsidiary(-ies). All rights reserved. License: <a href="http://www.symbianfoundation.org/legal/sfl-v10.html">SFL</a>.&nbsp;</div>
            <div id='BUILD_VERSION'></div>
	    </div>
	</div>
</body>
</html>