From f91ba24cc3474be1e1bf2bf8cd348b2877bb2ce4 Mon Sep 17 00:00:00 2001
From: Gregory Nutt <gnutt@nuttx.org>
Date: Wed, 14 Jan 2015 09:17:51 -0600
Subject: [PATCH] Add comments to Micro Python Makefile

---
 interpreters/micropython/Makefile | 17 +++++++++++++++--
 1 file changed, 15 insertions(+), 2 deletions(-)

diff --git a/interpreters/micropython/Makefile b/interpreters/micropython/Makefile
index 05b38b43c..e4b1b7f05 100644
--- a/interpreters/micropython/Makefile
+++ b/interpreters/micropython/Makefile
@@ -34,10 +34,14 @@
 #
 ###########################################################################
 
+# Standard includes
+
 -include $(TOPDIR)/.config
 -include $(TOPDIR)/Make.defs
 include $(APPDIR)/Make.defs
 
+# Set up build configuration and environment
+
 WD := ${shell pwd | sed -e 's/ /\\ /g'}
 
 CONFIG_INTERPRETERS_MICROPYTHON_URL ?= "https://github.com/micropython/micropython/archive"
@@ -50,10 +54,15 @@ WGET ?= wget
 MICROPYTHON_UNPACKNAME = micropython-$(MICROPYTHON_VERSION)
 UNPACK ?= tar -zxf
 
-CROSS_COMPILE ?= $(CROSSDEV)
-
 MICROPYTHON_UNPACKDIR =  $(WD)/$(MICROPYTHON_UNPACKNAME)
 MICROPTHYON_SRCDIR = $(MICROPYTHON_UNPACKDIR)/py
+
+# Get the Micro Python build environment.  mkenv.mk has these dependencies
+#
+#  V             - Enable verbose output (same meaning as in NuttX)
+#  CROSS_COMPILE - Tool prefix (same as CROSSDEV in NuttX)
+
+CROSS_COMPILE ?= $(CROSSDEV)
 -include $(MICROPTHYON_SRCDIR)/mkenv.mk
 
 # qstr definitions (must come before including py.mk)
@@ -72,6 +81,8 @@ INC =  -I. -I$(WD) -I$(MICROPYTHON_UNPACKDIR) -I$(PY_SRC) -I$(BUILD)
 
 CFLAGS +=$(INC)
 
+# Built-in application info
+
 CONFIG_INTERPRETERS_MICROPYTHON_APPNAME ?= micropython
 CONFIG_INTERPRETERS_MICROPYTHON_STACKSIZE ?= 2048
 CONFIG_INTERPRETERS_MICROPYTHON_PRIORITY ?= SCHED_PRIORITY_DEFAULT
@@ -83,6 +94,8 @@ PRIORITY = $(CONFIG_INTERPRETERS_MICROPYTHON_PRIORITY)
 CONFIG_INTERPRETERS_MICROPYTHON_PROGNAME ?= micropython$(EXEEXT)
 PROGNAME = $(CONFIG_INTERPRETERS_MICROPYTHON_PROGNAME)
 
+# Files
+
 ASRCS =
 CSRCS = pyexec.c py_readline.c
 MAINSRC = micropython_main.c