[NaCl SDK] Add a very simple getting_started example at top-level.

native_client_sdk/src/build_tools/generate_make.py

 # Copyright (c) 2012 The Chromium Authors. All rights reserved.
 # Use of this source code is governed by a BSD-style license that can be
 # found in the LICENSE file.
 
 import json
 import os
 import sys
 
 import buildbot_common
 import build_version
 import getos
 from buildbot_common import ErrorExit
 from easy_template import RunTemplateFileIfChanged
 from build_paths import SDK_RESOURCE_DIR
 
 def Trace(msg):
   if Trace.verbose:
     sys.stderr.write(str(msg) + '\n')
 Trace.verbose = False
 
 
 def IsExample(desc):
   dest = desc['DEST']
   return dest.startswith('examples') or dest.startswith('tests')
 
 
 def GenerateSourceCopyList(desc):
   sources = []
+  # Some examples use their own Makefile/sources/etc.
+  if 'TARGETS' not in desc:
+    # Only copy the DATA files.
+    return desc.get('DATA', [])
+
   # Add sources for each target
   for target in desc['TARGETS']:
     sources.extend(target['SOURCES'])
 
   # And HTML and data files
   sources.extend(desc.get('DATA', []))
 
   if IsExample(desc):
     sources.extend(['common.js', 'icon128.png', 'background.js'])
 
@@ skipping 150 matching lines @@
   FindAndCopyFiles(sources, srcroot, srcdirs, out_dir)
 
   # Copy public headers to the include directory.
   for headers_set in desc.get('HEADERS', []):
     headers = headers_set['FILES']
     header_out_dir = os.path.join(dstroot, headers_set['DEST'])
     FindAndCopyFiles(headers, srcroot, srcdirs, header_out_dir)
 
   make_path = os.path.join(out_dir, 'Makefile')
 
+  outdir = os.path.dirname(os.path.abspath(make_path))
+  if getos.GetPlatform() == 'win':
+    AddMakeBat(pepperdir, outdir)
+
+  # If this project has no TARGETS, then we don't need to generate anything.
+  if 'TARGETS' not in desc:
+    return (name, desc['DEST'])
+
   if IsNexe(desc):
     template = os.path.join(SDK_RESOURCE_DIR, 'Makefile.example.template')
   else:
     template = os.path.join(SDK_RESOURCE_DIR, 'Makefile.library.template')
 
   # Ensure the order of |tools| is the same as toolchains; that way if
   # first_toolchain is set, it will choose based on the order of |toolchains|.
   tools = [tool for tool in toolchains if tool in desc['TOOLS']]
   if first_toolchain:
     tools = [tools[0]]
   for target in desc['TARGETS']:
     target.setdefault('CXXFLAGS', [])
     target['CXXFLAGS'].insert(0, '-Wall')
 
   template_dict = {
     'rel_sdk': '/'.join(['..'] * (len(desc['DEST'].split('/')) + 1)),
     'pre': desc.get('PRE', ''),
     'post': desc.get('POST', ''),
     'tools': tools,
     'targets': desc['TARGETS'],
   }
   RunTemplateFileIfChanged(template, make_path, template_dict)
 
-  outdir = os.path.dirname(os.path.abspath(make_path))
-  if getos.GetPlatform() == 'win':
-    AddMakeBat(pepperdir, outdir)
-
   if IsExample(desc):
     ProcessHTML(srcroot, dstroot, desc, toolchains, configs,
                 first_toolchain)
     GenerateManifest(srcroot, dstroot, desc)
 
   return (name, desc['DEST'])
 
 
 def GenerateMasterMakefile(pepperdir, out_path, targets):
   """Generate a Master Makefile that builds all examples.
 
   Args:
     pepperdir: NACL_SDK_ROOT
     out_path: Root for output such that out_path+NAME = full path
     targets: List of targets names
   """
   in_path = os.path.join(SDK_RESOURCE_DIR, 'Makefile.index.template')
   out_path = os.path.join(out_path, 'Makefile')
   rel_path = os.path.relpath(pepperdir, os.path.dirname(out_path))
   template_dict = {
     'projects': targets,
     'rel_sdk' : rel_path,
   }
   RunTemplateFileIfChanged(in_path, out_path, template_dict)
   outdir = os.path.dirname(os.path.abspath(out_path))
   if getos.GetPlatform() == 'win':
     AddMakeBat(pepperdir, outdir)