Symbian3/SDK/Source/GUID-5986717C-C777-590D-8487-CB8ED488E975.dita
author Dominic Pinkman <Dominic.Pinkman@Nokia.com>
Thu, 21 Jan 2010 18:18:20 +0000
changeset 0 89d6a7a84779
permissions -rw-r--r--
Initial contribution of Documentation_content according to Feature bug 1266 bug 1268 bug 1269 bug 1270 bug 1372 bug 1374 bug 1375 bug 1379 bug 1380 bug 1381 bug 1382 bug 1383 bug 1385

<?xml version="1.0" encoding="utf-8"?>
<!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->
<!-- This component and the accompanying materials are made available under the terms of the License 
"Eclipse Public License v1.0" which accompanies this distribution, 
and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->
<!-- Initial Contributors:
    Nokia Corporation - initial contribution.
Contributors: 
-->
<!DOCTYPE concept
  PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
<concept id="GUID-5986717C-C777-590D-8487-CB8ED488E975" xml:lang="en"><title>makmake
command syntax</title><prolog><metadata><keywords/></metadata></prolog><conbody>
<p>Symbian projects are defined by an <filepath>.mmp</filepath> file which
specifies the essential elements of the project. The <filepath>makmake</filepath> tool
then uses this environment neutral file to build makefiles for use in various
environments. These makefiles are then used for project development. </p>
<p><b>Invocation syntax </b> </p>
<p> <codeph>makmake</codeph> [ <varname>options</varname> ] [ <varname>source-path</varname> ] <varname>project</varname> <varname>platform</varname>  </p>
<p>Details of <varname>options</varname>, <varname>source-path</varname>, <varname>project</varname>,
and <varname>platform</varname> are given below. </p>
<p><b>Options </b> </p>
<table id="GUID-BDAF523E-3992-5F10-9509-101F41F14CCF">
<tgroup cols="2"><colspec colname="col0"/><colspec colname="col1"/>
<tbody>
<row>
<entry><p> <codeph> -d</codeph>  </p> </entry>
<entry><p>Indicates that the makefile is to be created in directory <filepath>epoc32\build\</filepath> <varname>path_to_mmp_file</varname> <filepath>\</filepath> <codeph>mmp_basename</codeph> <filepath>\</filepath> <varname>platform</varname> rather
than the directory in which <filepath>makmake</filepath> was invoked. </p> <p>Note
that relative paths within the created makefile will be relative to the directory
in which <filepath>makmake </filepath> was invoked so <filepath>nmake</filepath> should
be invoked from that directory too if the project is to build correctly. </p> </entry>
</row>
<row>
<entry><p> <codeph> -v</codeph>  </p> </entry>
<entry><p>Indicates verbose operation </p> <p>When this flag is specified, <filepath>makmake</filepath> prints
many progress messages. The default is to give error messages only. </p> </entry>
</row>
<row>
<entry><p> <codeph> -mmp</codeph>  </p> </entry>
<entry><p>Provides basic syntax guide to writing <filepath>.mmp</filepath> files
instead of making the makefile. </p> </entry>
</row>
<row>
<entry><p> <codeph> -plat </codeph>  <varname>platform</varname>  </p> </entry>
<entry><p>Provides syntax guide to writing platform-specific sections of <filepath>.mmp</filepath> files,
and information about which macros are defined for preprocessing the <filepath>.mmp</filepath> files. </p> </entry>
</row>
<row>
<entry><p> <codeph>-arm</codeph>  </p> </entry>
<entry><p>Instructs an ARMV5 build to not build the project as THUMB, but
as the appropriate ARM ABI. </p> <p>For details, see <xref href="GUID-EFF3BD37-BC29-52F5-B8AA-6362F0C3E20F.dita">ARMV5
build target</xref>. </p> </entry>
</row>
<row>
<entry><p> <codeph>-debug</codeph>  </p> </entry>
<entry><p>Generates symbolic debug information for release or debug builds. </p> </entry>
</row>
<row>
<entry><p> <codeph>-no_debug</codeph>  </p> </entry>
<entry><p>Does not generate symbolic debug information for release or debug
builds. </p> </entry>
</row>
</tbody>
</tgroup>
</table>
<p>Note that you can either use <codeph>-debug</codeph> to generate or <codeph>-no_debug</codeph> to
not generate the symbolic debug information, irrespective of <codeph>UREL</codeph> or <codeph>UDEB</codeph> build. </p>
<p><b>source-path </b> </p>
<p>This specifies the path of the source <filepath>.mmp</filepath> file, relative
to the current directory. </p>
<p>If omitted, the source <filepath>.mmp</filepath> file is <codeph>project</codeph> <filepath>.mmp</filepath> in
the current directory. </p>
<p>Whether or not the <varname>source-path</varname> is specified, the generated
makefile is always written into the current directory. </p>
<p><b>project </b> </p>
<p>This specifies the project for which to create the makefile. </p>
<p><b>platform </b> </p>
<p>This specifies the target platform, e.g. <codeph>thumb</codeph> or <codeph>winscw</codeph>. </p>
<p><b>Command output </b> </p>
<p>The output makefile name in most cases has the form <varname>project-name</varname>.<varname>platform-name</varname>.
The exceptions are for <codeph>cw_ide</codeph>, which produces a <filepath>.xml</filepath> file,
which can be imported into CodeWarrior, and <codeph>vc6</codeph> and <codeph>vc6winc</codeph>,
which produce <filepath>.dsw</filepath> and <codeph>.dsp</codeph> files. </p>
</conbody></concept>