Symbian3/SDK/Source/GUID-5986717C-C777-590D-8487-CB8ED488E975.dita
changeset 0 89d6a7a84779
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/Symbian3/SDK/Source/GUID-5986717C-C777-590D-8487-CB8ED488E975.dita	Thu Jan 21 18:18:20 2010 +0000
@@ -0,0 +1,85 @@
+<?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>
\ No newline at end of file