You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@mynewt.apache.org by ad...@apache.org on 2015/11/10 09:00:17 UTC
[10/14] incubator-mynewt-site git commit: removing all files from
asf-site to redo doc structure
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/0d880edf/site/chapter2/project3/index.html
----------------------------------------------------------------------
diff --git a/site/chapter2/project3/index.html b/site/chapter2/project3/index.html
deleted file mode 100644
index 228d192..0000000
--- a/site/chapter2/project3/index.html
+++ /dev/null
@@ -1,212 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta http-equiv="X-UA-Compatible" content="IE=edge">
- <meta name="viewport" content="width=device-width, initial-scale=1.0">
-
-
- <link rel="canonical" href="http://mynewt.incubator.apache.org/index.html/chapter2/project3/">
- <link rel="shortcut icon" href="../../img/favicon.ico">
-
- <title>Project 3 - Mynewt</title>
-
- <link href="../../css/bootstrap-custom.min.css" rel="stylesheet">
- <link href="../../css/font-awesome-4.0.3.css" rel="stylesheet">
- <link href="../../css/base.css" rel="stylesheet">
- <link rel="stylesheet" href="../../css/highlight.css">
-
- <!-- HTML5 shim and Respond.js IE8 support of HTML5 elements and media queries -->
- <!--[if lt IE 9]>
- <script src="https://oss.maxcdn.com/libs/html5shiv/3.7.0/html5shiv.js"></script>
- <script src="https://oss.maxcdn.com/libs/respond.js/1.3.0/respond.min.js"></script>
- <![endif]-->
-
-
- </head>
-
- <body>
-
- <div class="navbar navbar-default navbar-fixed-top" role="navigation">
- <div class="container">
-
- <!-- Collapsed navigation -->
- <div class="navbar-header">
-
- <!-- Expander button -->
- <button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".navbar-collapse">
- <span class="sr-only">Toggle navigation</span>
- <span class="icon-bar"></span>
- <span class="icon-bar"></span>
- <span class="icon-bar"></span>
- </button>
-
-
- <!-- Main title -->
- <a class="navbar-brand" href="../..">Mynewt</a>
- </div>
-
- <!-- Expanded navigation -->
- <div class="navbar-collapse collapse">
-
- <!-- Main navigation -->
- <ul class="nav navbar-nav">
-
-
- <li >
- <a href="../..">Doc Home</a>
- </li>
-
-
-
- <li class="dropdown">
- <a href="#" class="dropdown-toggle" data-toggle="dropdown">Getting Started <b class="caret"></b></a>
- <ul class="dropdown-menu">
-
-
-<li >
- <a href="../../chapter1/newt_concepts/">Newt Concepts</a>
-</li>
-
-
-
-<li >
- <a href="../../chapter1/project1/">Blinky, The First Project</a>
-</li>
-
-
- </ul>
- </li>
-
-
-
- <li class="dropdown active">
- <a href="#" class="dropdown-toggle" data-toggle="dropdown">Getting Acclimated <b class="caret"></b></a>
- <ul class="dropdown-menu">
-
-
-<li >
- <a href="../vocabulary/">Understanding Newt Terms</a>
-</li>
-
-
-
-<li >
- <a href="../project2/">Project 2</a>
-</li>
-
-
-
-<li class="active">
- <a href="./">Project 3</a>
-</li>
-
-
- </ul>
- </li>
-
-
-
- <li class="dropdown">
- <a href="#" class="dropdown-toggle" data-toggle="dropdown">Newt tool Reference <b class="caret"></b></a>
- <ul class="dropdown-menu">
-
-
-<li >
- <a href="../../chapter3/newt_ops/">Command structure</a>
-</li>
-
-
-
-<li >
- <a href="../../chapter3/newt_tool_reference/">Command list</a>
-</li>
-
-
- </ul>
- </li>
-
-
- </ul>
-
-
- <ul class="nav navbar-nav navbar-right">
- <li>
- <a href="#" data-toggle="modal" data-target="#mkdocs_search_modal">
- <i class="fa fa-search"></i> Search
- </a>
- </li>
-
- <li >
- <a rel="next" href="../project2/">
- <i class="fa fa-arrow-left"></i> Previous
- </a>
- </li>
- <li >
- <a rel="prev" href="../../chapter3/newt_ops/">
- Next <i class="fa fa-arrow-right"></i>
- </a>
- </li>
-
-
- </ul>
- </div>
- </div>
-</div>
-
- <div class="container">
-
- <div class="col-md-3"><div class="bs-sidebar hidden-print affix well" role="complementary">
- <ul class="nav bs-sidenav">
-
- <li class="main active"><a href="#how-to-test-an-egg">How to Test an Egg</a></li>
-
-
- </ul>
-</div></div>
- <div class="col-md-9" role="main">
-
-<h2 id="how-to-test-an-egg">How to Test an Egg<a class="headerlink" href="#how-to-test-an-egg" title="Permanent link">¶</a></h2></div>
-
- </div>
-
- <footer class="col-md-12">
- <hr>
-
- <p>Documentation built with <a href="http://www.mkdocs.org/">MkDocs</a>.</p>
- </footer>
-
- <script src="../../js/jquery-1.10.2.min.js"></script>
- <script src="../../js/bootstrap-3.0.3.min.js"></script>
- <script src="../../js/highlight.pack.js"></script>
- <script>var base_url = '../..';</script>
- <script data-main="../../mkdocs/js/search.js" src="../../mkdocs/js/require.js"></script>
- <script src="../../js/base.js"></script>
-
- <div class="modal" id="mkdocs_search_modal" tabindex="-1" role="dialog" aria-labelledby="Search Modal" aria-hidden="true">
- <div class="modal-dialog">
- <div class="modal-content">
- <div class="modal-header">
- <button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">×</span><span class="sr-only">Close</span></button>
- <h4 class="modal-title" id="exampleModalLabel">Search</h4>
- </div>
- <div class="modal-body">
- <p>
- From here you can search these documents. Enter
- your search terms below.
- </p>
- <form role="form">
- <div class="form-group">
- <input type="text" class="form-control" placeholder="Search..." id="mkdocs-search-query">
- </div>
- </form>
- <div id="mkdocs-search-results"></div>
- </div>
- <div class="modal-footer">
- </div>
- </div>
- </div>
- </div>
-
- </body>
-</html>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/0d880edf/site/chapter2/vocabulary/index.html
----------------------------------------------------------------------
diff --git a/site/chapter2/vocabulary/index.html b/site/chapter2/vocabulary/index.html
deleted file mode 100644
index 811d536..0000000
--- a/site/chapter2/vocabulary/index.html
+++ /dev/null
@@ -1,363 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta http-equiv="X-UA-Compatible" content="IE=edge">
- <meta name="viewport" content="width=device-width, initial-scale=1.0">
-
-
- <link rel="canonical" href="http://mynewt.incubator.apache.org/index.html/chapter2/vocabulary/">
- <link rel="shortcut icon" href="../../img/favicon.ico">
-
- <title>Understanding Newt Terms - Mynewt</title>
-
- <link href="../../css/bootstrap-custom.min.css" rel="stylesheet">
- <link href="../../css/font-awesome-4.0.3.css" rel="stylesheet">
- <link href="../../css/base.css" rel="stylesheet">
- <link rel="stylesheet" href="../../css/highlight.css">
-
- <!-- HTML5 shim and Respond.js IE8 support of HTML5 elements and media queries -->
- <!--[if lt IE 9]>
- <script src="https://oss.maxcdn.com/libs/html5shiv/3.7.0/html5shiv.js"></script>
- <script src="https://oss.maxcdn.com/libs/respond.js/1.3.0/respond.min.js"></script>
- <![endif]-->
-
-
- </head>
-
- <body>
-
- <div class="navbar navbar-default navbar-fixed-top" role="navigation">
- <div class="container">
-
- <!-- Collapsed navigation -->
- <div class="navbar-header">
-
- <!-- Expander button -->
- <button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".navbar-collapse">
- <span class="sr-only">Toggle navigation</span>
- <span class="icon-bar"></span>
- <span class="icon-bar"></span>
- <span class="icon-bar"></span>
- </button>
-
-
- <!-- Main title -->
- <a class="navbar-brand" href="../..">Mynewt</a>
- </div>
-
- <!-- Expanded navigation -->
- <div class="navbar-collapse collapse">
-
- <!-- Main navigation -->
- <ul class="nav navbar-nav">
-
-
- <li >
- <a href="../..">Doc Home</a>
- </li>
-
-
-
- <li class="dropdown">
- <a href="#" class="dropdown-toggle" data-toggle="dropdown">Getting Started <b class="caret"></b></a>
- <ul class="dropdown-menu">
-
-
-<li >
- <a href="../../chapter1/newt_concepts/">Newt Concepts</a>
-</li>
-
-
-
-<li >
- <a href="../../chapter1/project1/">Blinky, The First Project</a>
-</li>
-
-
- </ul>
- </li>
-
-
-
- <li class="dropdown active">
- <a href="#" class="dropdown-toggle" data-toggle="dropdown">Getting Acclimated <b class="caret"></b></a>
- <ul class="dropdown-menu">
-
-
-<li class="active">
- <a href="./">Understanding Newt Terms</a>
-</li>
-
-
-
-<li >
- <a href="../project2/">Project 2</a>
-</li>
-
-
-
-<li >
- <a href="../project3/">Project 3</a>
-</li>
-
-
- </ul>
- </li>
-
-
-
- <li class="dropdown">
- <a href="#" class="dropdown-toggle" data-toggle="dropdown">Newt tool Reference <b class="caret"></b></a>
- <ul class="dropdown-menu">
-
-
-<li >
- <a href="../../chapter3/newt_ops/">Command structure</a>
-</li>
-
-
-
-<li >
- <a href="../../chapter3/newt_tool_reference/">Command list</a>
-</li>
-
-
- </ul>
- </li>
-
-
- </ul>
-
-
- <ul class="nav navbar-nav navbar-right">
- <li>
- <a href="#" data-toggle="modal" data-target="#mkdocs_search_modal">
- <i class="fa fa-search"></i> Search
- </a>
- </li>
-
- <li >
- <a rel="next" href="../../chapter1/project1/">
- <i class="fa fa-arrow-left"></i> Previous
- </a>
- </li>
- <li >
- <a rel="prev" href="../project2/">
- Next <i class="fa fa-arrow-right"></i>
- </a>
- </li>
-
-
- </ul>
- </div>
- </div>
-</div>
-
- <div class="container">
-
- <div class="col-md-3"><div class="bs-sidebar hidden-print affix well" role="complementary">
- <ul class="nav bs-sidenav">
-
- <li class="main active"><a href="#understanding-newt-terms">Understanding Newt Terms</a></li>
-
- <li><a href="#nest">Nest</a></li>
-
- <li><a href="#project">Project</a></li>
-
- <li><a href="#egg">Egg</a></li>
-
- <li><a href="#clutch">Clutch</a></li>
-
- <li><a href="#eggshell">Eggshell</a></li>
-
- <li><a href="#target">Target</a></li>
-
- <li><a href="#capability">Capability</a></li>
-
- <li><a href="#identity">Identity</a></li>
-
-
- </ul>
-</div></div>
- <div class="col-md-9" role="main">
-
-<h2 id="understanding-newt-terms">Understanding Newt Terms<a class="headerlink" href="#understanding-newt-terms" title="Permanent link">¶</a></h2>
-<h3 id="nest">Nest<a class="headerlink" href="#nest" title="Permanent link">¶</a></h3>
-<p>The nest is the base directory of your embedded software. It is meant to be the workspace containing a logical collection of the source code for one or more of your projects. A nest can contain multiple projects, and reflect multiple end products. </p>
-<p>As the base repository of your source code, the nest has a master branch and several other branches off it. You may choose any branch to nest on. Each project in your nest will typically consist of several <a href="#egg">eggs</a>. A project could be an egg itself as well. In addition to eggs, a local nest will contain additional items such as <a href="#target">target</a> or build definitions, clutch description files, scripts etc.</p>
-<p>For example, a walk through the "larva" nest at <a href="https://github.com/mynewt/larva.git">https://github.com/mynewt/larva.git</a> shows the following structure. The nest.yml file in the larva directory indicates that it is a nest. An egg will have the egg.yml file in it as shown below. By this nomenclature, each board support package for a particular chip is an egg, the API for the hardware abstraction layer is an egg, and so on. </p>
-<pre><code>larva
- |- nest.yml
- |- compiler
- |- arm-none-eabi-m4
- |- sim
- |- hw (hardware)
- |- bsp (board support package)
- |- nrf52pdk (Nordic nRF52 series chip)
- |- egg.yml
- |- ...
- |- olimex_stm32-e407_devboard (used in chapter1 project)
- |- egg.yml
- |- ...
- |- stm32f3discovery (another board with stm32f3 mcu)
- |- egg.yml
- |- ...
- |- yet another board
- |- egg.yml
- |- ...
- |- hal (hardware abstraction layer APIs)
- |- egg.yml
- |- include
- |- hal_cputime.h
- |- hal_flash.h
- |- hal_gpio.h
- |- ... (header files for other peripherals)
- |- mcu (microcontroller)
- |- stm (STMicro family)
- |- stm32f3xx (STM32f3 series, 32-bit ARM Cortex-M4 core)
- |- egg.yml
- |- src
- |- hal_gpio.c (specific to the STM32f3 mcu)
- |- hal_cputime.c
- |- ... (code for other peripherals)
- |- nordic (Nordic Semiconductor family)
- |- nrf52xxx (nRF52 Series SoC, Cortex-M4F core)
- |- egg.yml
- |- src
- |- hal_gpio.c (specific to the nRF52 mcu )
- |- hal_cputime.c
- |- ... (code for other peripherals)
- |- yet another family of mcu
- |- ...
- |- libs
- |- bootutil (hw architecture independent boot loader library)
- |- egg.yml
- |- src
- |- loader.c
- |- ... (related source code files)
- |- nffs (hw architecture independent Newtron Flash File System)
- |- egg.yml
- |- src
- |- nffs.c
- |- ... (related source code files)
- |- another library
- |- egg.yml
- |- src
- |- ... (related source code files)
- |- project
- |- scripts
-
-
-</code></pre>
-
-<p>The newt tool offers the <code>nest</code> command to create and manage nests. In general, commands represent actions and flags are modifiers for those actions. A command can have children commands and optionally run an action. A full description of the <code>nest</code> command can be found in the newt tool reference in Chapter 3.</p>
-<pre><code>newt nest [flags]
-newt nest [child-commands]
-</code></pre>
-<p>A complete list of all the nest commands can be found in the newt tool reference in <a href="../../chapter3/newt_tool_reference/">Chapter 3</a>.</p>
-<h3 id="project">Project<a class="headerlink" href="#project" title="Permanent link">¶</a></h3>
-<p>Projects represent the individual build configurations of your embedded system and essentially defines your application. The project files are what dictate the resulting binary that is generated. </p>
-<p>Layout-wise, a project is a directory inside a nest and contains eggs required for a certain application. For example, the <code>blinky</code> egg sits in <code>project/blinky</code> directory of the <code>larva</code> nest. This egg is used in the blinky project (application) outlined in <a href="../../chapter1/project1/">Chapter 1</a>. <<em>Note: This Will Change</em>></p>
-<p>A project has the following concepts or properties associated with it. You can find them in the <code><project-name>.yml</code> file in the project directory. For example, the <code>project/blinky</code> directory has the <code>blinky.yml</code> file indicating some or all of the properties below. Only the name of a project is required for the project to exist, however additional properties may need to be specified for the eggs in it to compile properly and produce an executable. </p>
-<ul>
-<li>Project name</li>
-<li>Base path of the project (nest/project/project-name by default)</li>
-<li>Eggs belonging to the project</li>
-<li><a href="#capabilities">Capabilities</a> that are required for the project or target </li>
-<li><a href="#identity">Identity</a> to classify the type of project or target</li>
-<li>Compiler flags to call out any specific compiler requirement</li>
-</ul>
-<p>A project could itself be an egg if it is a distributable package for a specific application. </p>
-<p>The newt tool offers various commands that you can use with a project. For example, if your project is an egg, you can use the following command to install a project from a nest.</p>
-<pre><code>newt egg install [flags] <project egg name>
-</code></pre>
-<h3 id="egg">Egg<a class="headerlink" href="#egg" title="Permanent link">¶</a></h3>
-<p>An egg is a distributable package of libraries. Just as an egg in nature has various parts each of which serves a certain purpose, the Mynewt egg consists of software parcels or modules that have different functions. However, unlike the egg in nature these software modules can exist by itself and may be distributed; therefore, they too are essentially eggs. Once this concept is grasped it is easy to see how an egg may consist of other eggs.</p>
-<p>The two main directories in an egg are <code>/include</code> and <code>/src</code>.</p>
-<p>The newt tool offers several egg commands to list, inspect, install, and do other operations on eggs. For example, the following command</p>
-<pre><code>newt egg list
-</code></pre>
-<p>outputs all the eggs in the current nest where each egg has details on its version, path, and dependencies. A sample output for an egg is given below.</p>
-<pre><code>Egg libs/os, version 0.1.0
-path: /Users/aditihilbert/dev/test_project/libs/os
-deps: libs/testutil@none#stable
-</code></pre>
-<p>A complete list of all the egg commands can be found in the newt tool reference in <a href="../../chapter3/newt_tool_reference/">Chapter 3</a>.</p>
-<h3 id="clutch">Clutch<a class="headerlink" href="#clutch" title="Permanent link">¶</a></h3>
-<p>A clutch is a snapshot of all eggs in a remote nest at any point in time. On any given github branch, a nest with a clutch of eggs will contain a <code>clutch.yml</code> file that specifies the version number, dependencies, and hash value for each constituent egg as well as the name of the entire clutch and the github url for it. [Note: Currently ]</p>
-<p>You may download multiple clutches into your local nest as long as the names of the clutches are different. This allows you to mix and match various features and functionality coming from different clutches of eggs. You can see all the clutches in the <code>.nest/clutches</code> directory in your nest.</p>
-<p>The newt tool offers clutch management commands within the <code>newt nest</code> command. For example, the following command creates a new clutch using all the eggs in the current directory. It requires that a clutch name be specified and the url for the location of that clutch in the online repository. These two inputs go into the <code>clutch.yml</code> file in the nest.</p>
-<pre><code>newt nest generate-clutch <name> <url>
-</code></pre>
-<p>Note that a clutch merely defines the eggs belonging together and requires the eggs to be installed (hatched) for the source code to be populated in the project. </p>
-<h3 id="eggshell">Eggshell<a class="headerlink" href="#eggshell" title="Permanent link">¶</a></h3>
-<p>The term eggshell is used to refer to the eggs of a clutch in a remote repository. They are not useful on your local machine until you actually install them. So they are mere shells of themselves while sitting on the online repository. When you enter the following command outputs the total number of shells in each remote clutch.</p>
-<pre><code>newt nest list-clutches
-</code></pre>
-<p>So, if you had two clutches installed, the output could be:</p>
-<pre><code>Remote clutch larva (eggshells: 19)
-Remote clutch ble_test (eggshells: 15)
-</code></pre>
-<h3 id="target">Target<a class="headerlink" href="#target" title="Permanent link">¶</a></h3>
-<p>A target is the hardware build or its software equivalent (e.g. test, simulator) set for a project. It tells the newt tool how to build the source code within a given nest. Once a new target is created, its architecture and other details needs to be defined. An example of a defined target named "blink_f3disc" is given below.</p>
-<pre><code>blink_f3disc
- compiler_def: debug
- compiler: arm-none-eabi-m4
- name: blink_f3disc
- arch: cortex_m4
- project: blinky
- bsp: hw/bsp/stm32f3discovery
-</code></pre>
-<p>The newt tool offers commands to create, set up and manipulate targets. For example, the create command below creates an empty target named <code>my_target1</code> and the set command sets one detail of its definition, namely the architecture.</p>
-<pre><code>newt target create my_target1
-newt target set my_target1 arch=cortex_m4
-</code></pre>
-<h3 id="capability">Capability<a class="headerlink" href="#capability" title="Permanent link">¶</a></h3>
-<p>Capability is functionality that is exposed by an egg. A capability is tracked by its name and version. An egg may require capabilities exposed by another egg, thus establishing a dependency tracked through the egg.yml files. </p>
-<p>The newt tool can ascertain a map of all the egg capabilities and use it to check dependencies and make sure all the necessary eggs are in a project for a particular target.</p>
-<h3 id="identity">Identity<a class="headerlink" href="#identity" title="Permanent link">¶</a></h3>
-<p>Identity is a property of a target or project in the newt world. A target may inherit it from a project or vice versa. It may be used to determine what eggs to include or how an egg code should behave in a build or which linkerscripts to use. For example, the identity of a lock is different from the identity of a wearable monitor. Even if they were to be built on the same hardware target, different features and behavior are required. Their different identities result in differing sets of eggs in the projects and/or the same egg behaving differently depending on the identity.</p></div>
-
- </div>
-
- <footer class="col-md-12">
- <hr>
-
- <p>Documentation built with <a href="http://www.mkdocs.org/">MkDocs</a>.</p>
- </footer>
-
- <script src="../../js/jquery-1.10.2.min.js"></script>
- <script src="../../js/bootstrap-3.0.3.min.js"></script>
- <script src="../../js/highlight.pack.js"></script>
- <script>var base_url = '../..';</script>
- <script data-main="../../mkdocs/js/search.js" src="../../mkdocs/js/require.js"></script>
- <script src="../../js/base.js"></script>
-
- <div class="modal" id="mkdocs_search_modal" tabindex="-1" role="dialog" aria-labelledby="Search Modal" aria-hidden="true">
- <div class="modal-dialog">
- <div class="modal-content">
- <div class="modal-header">
- <button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">×</span><span class="sr-only">Close</span></button>
- <h4 class="modal-title" id="exampleModalLabel">Search</h4>
- </div>
- <div class="modal-body">
- <p>
- From here you can search these documents. Enter
- your search terms below.
- </p>
- <form role="form">
- <div class="form-group">
- <input type="text" class="form-control" placeholder="Search..." id="mkdocs-search-query">
- </div>
- </form>
- <div id="mkdocs-search-results"></div>
- </div>
- <div class="modal-footer">
- </div>
- </div>
- </div>
- </div>
-
- </body>
-</html>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/0d880edf/site/chapter3/newt_ops/index.html
----------------------------------------------------------------------
diff --git a/site/chapter3/newt_ops/index.html b/site/chapter3/newt_ops/index.html
deleted file mode 100644
index f7e3e18..0000000
--- a/site/chapter3/newt_ops/index.html
+++ /dev/null
@@ -1,245 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta http-equiv="X-UA-Compatible" content="IE=edge">
- <meta name="viewport" content="width=device-width, initial-scale=1.0">
-
-
- <link rel="canonical" href="http://mynewt.incubator.apache.org/index.html/chapter3/newt_ops/">
- <link rel="shortcut icon" href="../../img/favicon.ico">
-
- <title>Command structure - Mynewt</title>
-
- <link href="../../css/bootstrap-custom.min.css" rel="stylesheet">
- <link href="../../css/font-awesome-4.0.3.css" rel="stylesheet">
- <link href="../../css/base.css" rel="stylesheet">
- <link rel="stylesheet" href="../../css/highlight.css">
-
- <!-- HTML5 shim and Respond.js IE8 support of HTML5 elements and media queries -->
- <!--[if lt IE 9]>
- <script src="https://oss.maxcdn.com/libs/html5shiv/3.7.0/html5shiv.js"></script>
- <script src="https://oss.maxcdn.com/libs/respond.js/1.3.0/respond.min.js"></script>
- <![endif]-->
-
-
- </head>
-
- <body>
-
- <div class="navbar navbar-default navbar-fixed-top" role="navigation">
- <div class="container">
-
- <!-- Collapsed navigation -->
- <div class="navbar-header">
-
- <!-- Expander button -->
- <button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".navbar-collapse">
- <span class="sr-only">Toggle navigation</span>
- <span class="icon-bar"></span>
- <span class="icon-bar"></span>
- <span class="icon-bar"></span>
- </button>
-
-
- <!-- Main title -->
- <a class="navbar-brand" href="../..">Mynewt</a>
- </div>
-
- <!-- Expanded navigation -->
- <div class="navbar-collapse collapse">
-
- <!-- Main navigation -->
- <ul class="nav navbar-nav">
-
-
- <li >
- <a href="../..">Doc Home</a>
- </li>
-
-
-
- <li class="dropdown">
- <a href="#" class="dropdown-toggle" data-toggle="dropdown">Getting Started <b class="caret"></b></a>
- <ul class="dropdown-menu">
-
-
-<li >
- <a href="../../chapter1/newt_concepts/">Newt Concepts</a>
-</li>
-
-
-
-<li >
- <a href="../../chapter1/project1/">Blinky, The First Project</a>
-</li>
-
-
- </ul>
- </li>
-
-
-
- <li class="dropdown">
- <a href="#" class="dropdown-toggle" data-toggle="dropdown">Getting Acclimated <b class="caret"></b></a>
- <ul class="dropdown-menu">
-
-
-<li >
- <a href="../../chapter2/vocabulary/">Understanding Newt Terms</a>
-</li>
-
-
-
-<li >
- <a href="../../chapter2/project2/">Project 2</a>
-</li>
-
-
-
-<li >
- <a href="../../chapter2/project3/">Project 3</a>
-</li>
-
-
- </ul>
- </li>
-
-
-
- <li class="dropdown active">
- <a href="#" class="dropdown-toggle" data-toggle="dropdown">Newt tool Reference <b class="caret"></b></a>
- <ul class="dropdown-menu">
-
-
-<li class="active">
- <a href="./">Command structure</a>
-</li>
-
-
-
-<li >
- <a href="../newt_tool_reference/">Command list</a>
-</li>
-
-
- </ul>
- </li>
-
-
- </ul>
-
-
- <ul class="nav navbar-nav navbar-right">
- <li>
- <a href="#" data-toggle="modal" data-target="#mkdocs_search_modal">
- <i class="fa fa-search"></i> Search
- </a>
- </li>
-
- <li >
- <a rel="next" href="../../chapter2/project3/">
- <i class="fa fa-arrow-left"></i> Previous
- </a>
- </li>
- <li >
- <a rel="prev" href="../newt_tool_reference/">
- Next <i class="fa fa-arrow-right"></i>
- </a>
- </li>
-
-
- </ul>
- </div>
- </div>
-</div>
-
- <div class="container">
-
- <div class="col-md-3"><div class="bs-sidebar hidden-print affix well" role="complementary">
- <ul class="nav bs-sidenav">
-
- <li class="main active"><a href="#command-structure">Command Structure</a></li>
-
-
- </ul>
-</div></div>
- <div class="col-md-9" role="main">
-
-<h2 id="command-structure">Command Structure<a class="headerlink" href="#command-structure" title="Permanent link">¶</a></h2>
-<p>In the newt tool, commands represent actions and flags are modifiers for those actions. A command can have children commands which are also simply referred to as commands. One or more arguments may need to be provided to a command to execute it correctly. </p>
-<p>In the example below, the <code>newt</code> command has the child command <code>target set</code>. The first argument 'my_target1' is the name of the target whose attributes are being set. The second argument 'arch=cortex_m4' specifies the value to set the attribute (variable) 'arch' to, which in this case is 'cortex_m4'. </p>
-<pre><code>newt target set my_target1 arch=cortex_m4
-</code></pre>
-<p>Global flags work on all newt commands in the same way. An example is the flag <code>-v, --verbose</code> to ask for a verbose output while executing a command. The help flag <code>-h</code> or <code>--help</code> is available on all commands but provides command specific output, of course. These flags may be specified in either a long or a short form. </p>
-<p>A command may additionally take flags specific to it. For example, the <code>-b</code> flag may be used with <code>newt egg install</code> to tell it which branch to install the egg from. </p>
-<pre><code>newt egg install -b <branchname> <eggname>
-</code></pre>
-<p>In addition to the newt tool <a href="../newt_tool_reference/">reference</a> in this documentation set, command-line help is available for each command (and child command). Simply use the flag <code>-h</code> or <code>--help</code> as shown below:</p>
-<pre><code>$ newt target export --help
-Export build targets from the current nest, and print them to
-standard output. If the -a (or -export-all) option is specified,
-then all targets will be exported. Otherwise, <target-name>
-must be specified, and only that target will be exported.
-
-Usage:
- newt target export [flags]
-
-Examples:
- newt target export [-a -export-all] [<target-name>]
- newt target export -a > my_exports.txt
- newt target export my_target > my_target_export.txt
-
-Flags:
- -a, --export-all=false: If present, export all targets
- -h, --help=false: help for export
-
-Global Flags:
- -l, --loglevel="WARN": Log level, defaults to WARN.
- -q, --quiet=false: Be quiet; only display error output.
- -s, --silent=false: Be silent; don't output anything.
- -v, --verbose=false: Enable verbose output when executing commands.
-</code></pre></div>
-
- </div>
-
- <footer class="col-md-12">
- <hr>
-
- <p>Documentation built with <a href="http://www.mkdocs.org/">MkDocs</a>.</p>
- </footer>
-
- <script src="../../js/jquery-1.10.2.min.js"></script>
- <script src="../../js/bootstrap-3.0.3.min.js"></script>
- <script src="../../js/highlight.pack.js"></script>
- <script>var base_url = '../..';</script>
- <script data-main="../../mkdocs/js/search.js" src="../../mkdocs/js/require.js"></script>
- <script src="../../js/base.js"></script>
-
- <div class="modal" id="mkdocs_search_modal" tabindex="-1" role="dialog" aria-labelledby="Search Modal" aria-hidden="true">
- <div class="modal-dialog">
- <div class="modal-content">
- <div class="modal-header">
- <button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">×</span><span class="sr-only">Close</span></button>
- <h4 class="modal-title" id="exampleModalLabel">Search</h4>
- </div>
- <div class="modal-body">
- <p>
- From here you can search these documents. Enter
- your search terms below.
- </p>
- <form role="form">
- <div class="form-group">
- <input type="text" class="form-control" placeholder="Search..." id="mkdocs-search-query">
- </div>
- </form>
- <div id="mkdocs-search-results"></div>
- </div>
- <div class="modal-footer">
- </div>
- </div>
- </div>
- </div>
-
- </body>
-</html>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/0d880edf/site/chapter3/newt_tool_reference/index.html
----------------------------------------------------------------------
diff --git a/site/chapter3/newt_tool_reference/index.html b/site/chapter3/newt_tool_reference/index.html
deleted file mode 100644
index 9a174f9..0000000
--- a/site/chapter3/newt_tool_reference/index.html
+++ /dev/null
@@ -1,744 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta http-equiv="X-UA-Compatible" content="IE=edge">
- <meta name="viewport" content="width=device-width, initial-scale=1.0">
-
-
- <link rel="canonical" href="http://mynewt.incubator.apache.org/index.html/chapter3/newt_tool_reference/">
- <link rel="shortcut icon" href="../../img/favicon.ico">
-
- <title>Command list - Mynewt</title>
-
- <link href="../../css/bootstrap-custom.min.css" rel="stylesheet">
- <link href="../../css/font-awesome-4.0.3.css" rel="stylesheet">
- <link href="../../css/base.css" rel="stylesheet">
- <link rel="stylesheet" href="../../css/highlight.css">
-
- <!-- HTML5 shim and Respond.js IE8 support of HTML5 elements and media queries -->
- <!--[if lt IE 9]>
- <script src="https://oss.maxcdn.com/libs/html5shiv/3.7.0/html5shiv.js"></script>
- <script src="https://oss.maxcdn.com/libs/respond.js/1.3.0/respond.min.js"></script>
- <![endif]-->
-
-
- </head>
-
- <body>
-
- <div class="navbar navbar-default navbar-fixed-top" role="navigation">
- <div class="container">
-
- <!-- Collapsed navigation -->
- <div class="navbar-header">
-
- <!-- Expander button -->
- <button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".navbar-collapse">
- <span class="sr-only">Toggle navigation</span>
- <span class="icon-bar"></span>
- <span class="icon-bar"></span>
- <span class="icon-bar"></span>
- </button>
-
-
- <!-- Main title -->
- <a class="navbar-brand" href="../..">Mynewt</a>
- </div>
-
- <!-- Expanded navigation -->
- <div class="navbar-collapse collapse">
-
- <!-- Main navigation -->
- <ul class="nav navbar-nav">
-
-
- <li >
- <a href="../..">Doc Home</a>
- </li>
-
-
-
- <li class="dropdown">
- <a href="#" class="dropdown-toggle" data-toggle="dropdown">Getting Started <b class="caret"></b></a>
- <ul class="dropdown-menu">
-
-
-<li >
- <a href="../../chapter1/newt_concepts/">Newt Concepts</a>
-</li>
-
-
-
-<li >
- <a href="../../chapter1/project1/">Blinky, The First Project</a>
-</li>
-
-
- </ul>
- </li>
-
-
-
- <li class="dropdown">
- <a href="#" class="dropdown-toggle" data-toggle="dropdown">Getting Acclimated <b class="caret"></b></a>
- <ul class="dropdown-menu">
-
-
-<li >
- <a href="../../chapter2/vocabulary/">Understanding Newt Terms</a>
-</li>
-
-
-
-<li >
- <a href="../../chapter2/project2/">Project 2</a>
-</li>
-
-
-
-<li >
- <a href="../../chapter2/project3/">Project 3</a>
-</li>
-
-
- </ul>
- </li>
-
-
-
- <li class="dropdown active">
- <a href="#" class="dropdown-toggle" data-toggle="dropdown">Newt tool Reference <b class="caret"></b></a>
- <ul class="dropdown-menu">
-
-
-<li >
- <a href="../newt_ops/">Command structure</a>
-</li>
-
-
-
-<li class="active">
- <a href="./">Command list</a>
-</li>
-
-
- </ul>
- </li>
-
-
- </ul>
-
-
- <ul class="nav navbar-nav navbar-right">
- <li>
- <a href="#" data-toggle="modal" data-target="#mkdocs_search_modal">
- <i class="fa fa-search"></i> Search
- </a>
- </li>
-
- <li >
- <a rel="next" href="../newt_ops/">
- <i class="fa fa-arrow-left"></i> Previous
- </a>
- </li>
- <li class="disabled">
- <a rel="prev" >
- Next <i class="fa fa-arrow-right"></i>
- </a>
- </li>
-
-
- </ul>
- </div>
- </div>
-</div>
-
- <div class="container">
-
- <div class="col-md-3"><div class="bs-sidebar hidden-print affix well" role="complementary">
- <ul class="nav bs-sidenav">
-
- <li class="main active"><a href="#command-list">Command List</a></li>
-
- <li><a href="#available-high-level-commands">Available high-level commands</a></li>
-
- <li><a href="#version">version</a></li>
-
- <li><a href="#help">help</a></li>
-
- <li><a href="#nest">nest</a></li>
-
- <li><a href="#egg">egg</a></li>
-
- <li><a href="#target">target</a></li>
-
-
- </ul>
-</div></div>
- <div class="col-md-9" role="main">
-
-<h2 id="command-list">Command List<a class="headerlink" href="#command-list" title="Permanent link">¶</a></h2>
-<h3 id="available-high-level-commands">Available high-level commands<a class="headerlink" href="#available-high-level-commands" title="Permanent link">¶</a></h3>
-<pre><code>version Display the Newt version number
-help Help about any command
-nest Commands to manage nests & clutches (remote egg repositories)
-egg Commands to list and inspect eggs on a nest
-target Set and view target information
-</code></pre>
-
-<h3 id="version"><em>version</em><a class="headerlink" href="#version" title="Permanent link">¶</a></h3>
-<h4 id="usage">Usage:<a class="headerlink" href="#usage" title="Permanent link">¶</a></h4>
-<pre><code>newt version [flags]
-</code></pre>
-<p>Flags:</p>
-<pre><code>-h, --help=false: help for version
-</code></pre>
-<p>Global Flags:</p>
-<pre><code>-h, --help=false: help for newt
-</code></pre>
-<p>Examples</p>
-<table>
-<thead>
-<tr>
-<th>Sub-command</th>
-<th>Usage</th>
-<th>Explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td>version</td>
-<td>newt version</td>
-<td>Displays the version of newt tool installed</td>
-</tr>
-</tbody>
-</table>
-<h3 id="help"><em>help</em><a class="headerlink" href="#help" title="Permanent link">¶</a></h3>
-<h4 id="usage_1">Usage:<a class="headerlink" href="#usage_1" title="Permanent link">¶</a></h4>
-<pre><code>newt help [input1]
-</code></pre>
-<p>Flags:</p>
-<pre><code>
--h, --help=false: help for newt
--l, --loglevel="WARN": Log level, defaults to WARN.
--q, --quiet=false: Be quiet; only display error output.
--s, --silent=false: Be silent; don't output anything.
--v, --verbose=false: Enable verbose output when executing commands.
-</code></pre>
-
-<p>Examples</p>
-<table>
-<thead>
-<tr>
-<th>Sub-command</th>
-<th>Usage</th>
-<th>Explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td>help</td>
-<td>newt help target</td>
-<td>Displays the help text for the newt command 'target'</td>
-</tr>
-<tr>
-<td>help</td>
-<td>newt help</td>
-<td>Displays the help text for newt tool</td>
-</tr>
-</tbody>
-</table>
-<h3 id="nest"><em>nest</em><a class="headerlink" href="#nest" title="Permanent link">¶</a></h3>
-<h4 id="usage_2">Usage:<a class="headerlink" href="#usage_2" title="Permanent link">¶</a></h4>
-<pre><code>newt nest [command][flags] input1 input2...
-</code></pre>
-<p>Available commands: </p>
-<pre><code>create Create a new nest
-generate-clutch Generate a clutch file from the eggs in the current directory
-add-clutch Add a remote clutch, and put it in the current nest
-list-clutches List the clutches installed in the current nest
-show-clutch Show an individual clutch in the current nest
-</code></pre>
-<p>Flags:</p>
-<pre><code>-h, --help=false: help for nest
-</code></pre>
-<p>Global Flags:</p>
-<pre><code>-h, --help=false: help for newt
--l, --loglevel="WARN": Log level, defaults to WARN.
--q, --quiet=false: Be quiet; only display error output.
--s, --silent=false: Be silent; don't output anything.
--v, --verbose=false: Enable verbose output when executing commands.
-</code></pre>
-<p>Description</p>
-<table>
-<thead>
-<tr>
-<th>Sub-command</th>
-<th>Explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td>create</td>
-<td>Downloads the skeleton of a nest on your local machine from the optional <code>input2</code>nest url, if specified, and creates a new nest directory by the name of <code>input1</code> If <code>input2</code>is not specified, then a default skeleton from the <code>tadpole</code>nest on Mynewt is downloaded. The command lays out a generic directory structure for the nest you are going to build under it and includes some default eggs in it.</td>
-</tr>
-<tr>
-<td>generate-clutch</td>
-<td>Takes a snapshot of the eggs in the current local directory and combines them into a clutch by the name of <code>input1</code>and with the url of <code>input2</code>and generates a standard output of the clutch details that can be redirected to a <code>.yml</code>clutch file. Typically the clutch file name is chosen to match the clutch name which means the standard output should be directed to a clutch file named <code>input1.yml</code></td>
-</tr>
-<tr>
-<td>add-clutch</td>
-<td>Downloads the clutch of the name <code>input1</code>from the master branch of the github repository <code>input2</code>into the current nest. A file named <code>input1.yml</code>file is added in the <code>.nest/clutches</code>subdirectory inside the current local nest. The <code>.nest/</code>directory structure is created automatically if it does not exist.</td>
-</tr>
-<tr>
-<td>list-clutches</td>
-<td>Lists all the clutches present in the current nest, including clutches that may have been added from other nests on github. The output shows all the remote clutch names and the total eggshells in each of the clutches.</td>
-</tr>
-<tr>
-<td>show-clutch</td>
-<td>Shows information about the clutch that has the name given in the <code>input1</code>argument. Output includes the clutch name, url, and all the constituent eggs with their version numbers.</td>
-</tr>
-</tbody>
-</table>
-<p>Command-specific flags</p>
-<table>
-<thead>
-<tr>
-<th>Sub-command</th>
-<th>Available flags</th>
-<th>Explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td>add-clutch</td>
-<td>-b, --branch="<branch-name>"</td>
-<td>Fetches the clutch file with name <code>input1</code>from the specified branch at <code>input1</code>url of the github repository. All subsequent egg installations will be done from that branch.</td>
-</tr>
-</tbody>
-</table>
-<p>Examples</p>
-<table>
-<thead>
-<tr>
-<th>Sub-command</th>
-<th>Usage</th>
-<th>Explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td>create</td>
-<td>newt nest create test_project</td>
-<td>Creates a new nest named "test_project " using the default skeleton0</td>
-</tr>
-<tr>
-<td>create</td>
-<td>newt nest create mynest <nest-url></td>
-<td>Creates a new nest named "mynest" using the skeleton at the <nest-url> specified</td>
-</tr>
-<tr>
-<td>generate-clutch</td>
-<td>newt nest generate-clutch myclutch https://www.github.com/mynewt/larva > myclutch.yml</td>
-<td>Takes a snapshot of the eggs in the current nest to form a clutch named myclutch with the url https://www.github.com/mynewt/larva. The output is written to a file named <code>myclutch.yml</code>and describes the properties and contents of the clutch (name, url, eggs).</td>
-</tr>
-<tr>
-<td>add-clutch</td>
-<td>newt nest add-clutch larva https://www.github.com/mynewt/larva</td>
-<td>Adds the remote clutch named larva at www.github.com/mynewt/larva to the local nest.</td>
-</tr>
-<tr>
-<td>list-clutches</td>
-<td>newt nest list-clutches</td>
-<td>Shows all the remote clutch description files that been downloaded into the current nest</td>
-</tr>
-<tr>
-<td>show-clutch</td>
-<td>newt nest show-clutch larva</td>
-<td>Outputs the details of the clutch named larva such as the github url where the remote sits, the constituent eggs and their versions</td>
-</tr>
-</tbody>
-</table>
-<h3 id="egg"><em>egg</em><a class="headerlink" href="#egg" title="Permanent link">¶</a></h3>
-<h4 id="usage_3">Usage:<a class="headerlink" href="#usage_3" title="Permanent link">¶</a></h4>
-<pre><code>newt egg [command][flag] input1 input2
-</code></pre>
-<p>Available Commands: </p>
-<pre><code>list List eggs in the current nest
-checkdeps Check egg dependencies
-hunt Search for egg from clutches
-show Show the contents of an egg.
-install Install an egg
-remove Remove an egg
-</code></pre>
-<p>Flags:</p>
-<pre><code>-h, --help=false: help for egg
-</code></pre>
-<p>Global Flags:</p>
-<pre><code>-l, --loglevel="WARN": Log level, defaults to WARN.
--q, --quiet=false: Be quiet; only display error output.
--s, --silent=false: Be silent; don't output anything.
--v, --verbose=false: Enable verbose output when executing commands.
-</code></pre>
-<p>Description</p>
-<table>
-<thead>
-<tr>
-<th>Sub-command</th>
-<th>Explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td>list</td>
-<td>List all the eggs in the current nest. The output shows the name, version, path, and any additional attributes of each egg in the nest such as dependencies, capabilities, and linker scripts. The newt command gets the attributes of each egg from the corresponsing egg.yml description file.</td>
-</tr>
-<tr>
-<td>checkdeps</td>
-<td>Resolve all dependencies in the local nest. This command goes through all eggs currently installed, checks their dependencies, and prints any unresolved dependencies between eggs.</td>
-</tr>
-<tr>
-<td>hunt</td>
-<td>Hunts for an egg, specified by <code>input1</code> The local nest, along with all remote nests (clutches) are searched. All matched eggs are shown along with the clutch informaton. Installed eggs are called out as such. The command can be invoked from anywhere in the nest.</td>
-</tr>
-<tr>
-<td>show</td>
-<td>Show the contents of the egg named <code>input2</code>found in the clutch named <code>input1</code> The clutch name is optional; if only the egg name is given as the argument it is resolved using all the clutches installed in the current nest. If the egg is present in multiple clutches it will list all of them along with the clutch information for each.</td>
-</tr>
-<tr>
-<td>install</td>
-<td>Install the egg specified by <code>input2</code>from the clutch named <code>input1</code> The command downloads the egg from the github repository using the URL in the clutch description file (typically donwloaded as 'input1@<branch-name>.yml' in .nest/clutches). It also downloads all the dependencies (constituent eggs) as decribed in the egg's description file ('egg.yml') and installs all of them. The clutch name is optional. If only the egg name is given as the argument, the command looks for the egg name in all the clutches in the local nest and installs accordingly. An egg is installed by this command only if it has not already been installed.</td>
-</tr>
-<tr>
-<td>remove</td>
-<td>Remove an egg named <code>input2</code>from clutch <code>input1</code> if clutch is specified. Otherwise only one input required - that of the name of the egg to be removed from the local nest.</td>
-</tr>
-</tbody>
-</table>
-<p>Command-specific flags</p>
-<table>
-<thead>
-<tr>
-<th>Sub-command</th>
-<th>Available flags</th>
-<th>Explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td>install</td>
-<td>-b, --branch="<branch-name>"</td>
-<td>Installs the eggs from the branch name or tag of the clutch specified</td>
-</tr>
-</tbody>
-</table>
-<p>Examples</p>
-<table>
-<thead>
-<tr>
-<th>Sub-command</th>
-<th>Usage</th>
-<th>Explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td>list</td>
-<td>newt egg list</td>
-<td>CList all of the eggs in the current nest and the details of the eggs.</td>
-</tr>
-<tr>
-<td>checkdeps</td>
-<td>newt egg checkdeps</td>
-<td>Checks all the dependencies between eggs in the nest. Lists any unresolved dependencies.</td>
-</tr>
-<tr>
-<td>hunt</td>
-<td>newt egg hunt blinky</td>
-<td>Hunts for the egg named 'blinky'. The command can be invoked from anywhere in the nest. Results show if the egg is installed and which clutch, if any, has the egg.</td>
-</tr>
-<tr>
-<td>show</td>
-<td>newt egg show larva libs/os</td>
-<td>Show the contents of the egg named 'libs/os' in the clutch named larva. The contents are essentially derived from the egg's 'egg.yml' file.</td>
-</tr>
-<tr>
-<td>install</td>
-<td>newt egg install hw/bsp/stm32f3discovery</td>
-<td>Downloads and installs the egg named "stm32f3discovery" (specified with its full path name inside the remote nest) along with all its dependencies from the remote nest on github. Since no clutch is specified, the URL for the remote nest in the clutch description file found in the local nest (in .nest/clutches for the project) is used.</td>
-</tr>
-<tr>
-<td>remove</td>
-<td>newt egg remove larva blinky</td>
-<td>Removes the egg named blinky only from the clutch named larva</td>
-</tr>
-<tr>
-<td>remove</td>
-<td>newt egg remove blinky</td>
-<td>Removes the egg named blinky from the local nest</td>
-</tr>
-</tbody>
-</table>
-<h3 id="target"><em>target</em><a class="headerlink" href="#target" title="Permanent link">¶</a></h3>
-<h4 id="usage_4">Usage:<a class="headerlink" href="#usage_4" title="Permanent link">¶</a></h4>
-<p>Usage: </p>
-<pre><code>newt target [command] input1 [flag1] [flag2]
-</code></pre>
-<p>Available Commands: </p>
-<pre><code>set Set target configuration variable
-unset Unset target configuration variable
-delete Delete target
-create Create a target
-show View target configuration variables
-build Build target
-test Test target
-export Export target
-import Import target
-download Download image to target
-debug Download image to target and start an openocd/gdb session
-</code></pre>
-<p>Flags:</p>
-<pre><code>-h, --help=false: help for target
-</code></pre>
-<p>Global Flags:</p>
-<pre><code>-l, --loglevel="WARN": Log level, defaults to WARN.
--q, --quiet=false: Be quiet; only display error output.
--s, --silent=false: Be silent; don't output anything.
--v, --verbose=false: Enable verbose output when executing commands.
-</code></pre>
-<p>Description</p>
-<table>
-<thead>
-<tr>
-<th>Sub-command</th>
-<th>Explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td>set</td>
-<td>Set attributes of the target. Currently the list of possible attributes are:<code>arch, compiler, compiler_def, project, bsp, egg, identities, capabilities, dependencies, cflags, lflags</code> Typically only the first 5 need to be set for a hardware target. For a simulated target, e.g. for software testing purposes, <code>arch=sim</code> <code>compiler=sim</code> and <code>egg=<egg name to be tested></code> You cannot set both the project and egg for a target.</td>
-</tr>
-<tr>
-<td>unset</td>
-<td>Unset attributes of the target in its configuration.</td>
-</tr>
-<tr>
-<td>delete</td>
-<td>Deletes only the description for the target. Does not delete the target directory with associated binaries. If you want to clean out the binaries, list files, and executables use<code>newt target build <target-name> clean</code><strong>before</strong> deleting the target!</td>
-</tr>
-<tr>
-<td>create</td>
-<td>Creates a target description or build definition by the name <code>input1</code> By default it assigns the sim (simulator) architecture to it which allows you to build new projects and software on your native OS and try it out.</td>
-</tr>
-<tr>
-<td>show</td>
-<td>Display the configuration defined for the target named <code>input1</code> If no <code>input1</code>is specified then show the details for all the targets in the nest.</td>
-</tr>
-<tr>
-<td>build</td>
-<td>Build the source code into an image that can be loaded on the hardware associated with the target named <code>input1</code>to do the application enabled by the 'project' associated with that target (via the target definition). It creates 'bin/' and 'bin/<input1>/' subdirectories inside the base directory for the project, compiles and generates binaries and executables, and places them in 'bin/<input1>/.</td>
-</tr>
-<tr>
-<td>test</td>
-<td>Test an egg on the target named <code>input1</code> The egg is either supplied as an argument to the command line invocation of <code>newt target test</code>or added as part of the target definition. If only the target is specified as <code>input1</code> then the egg in the target's definition is automatically chosen to be tested. You currently cannot test an entire project on a hardware target. The test command is envisioned for use if one or two eggs gets updated and each needs to be tested against a target. Alternatively, a script may be written for a series of tests on several eggs.</td>
-</tr>
-<tr>
-<td>export</td>
-<td>Exports the configurations of the specified target <code>input1</code> If -a or -export-all flag is used, then all targets are exported and printed out to standard out. You may redirect the output to a file.</td>
-</tr>
-<tr>
-<td>import</td>
-<td>Import one or more target configuration from standard input or a file. Each target starts with <code>@target=<target-name></code>followed by the attributes. The list of targets should end with <code>@endtargets</code></td>
-</tr>
-<tr>
-<td>size</td>
-<td>Outputs the RAM and flash consumption by the components of the specified target <code>input1</code></td>
-</tr>
-<tr>
-<td>download</td>
-<td>Downloads the binary executable <code><target-name>.elf.bin</code>to the board.</td>
-</tr>
-<tr>
-<td>debug</td>
-<td>Downloads the binary executable <code><target-name>.elf.bin</code>to the board and starts up the openocd/gdb combination session. gdb takes over the terminal.</td>
-</tr>
-</tbody>
-</table>
-<p>Command-specific flags</p>
-<table>
-<thead>
-<tr>
-<th>Sub-command</th>
-<th>Available flags</th>
-<th>Explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td>build</td>
-<td>clean</td>
-<td>All the binaries and object files for the specified target will be removed. The subdirectory named after the specified target within that project is removed.</td>
-</tr>
-<tr>
-<td>build clean</td>
-<td>all</td>
-<td>All the binaries and object files for all targets are removed, and subdirectories of all targets for the project are removed. However, the entire repository is not emptied since any eggs or projects that the specified target doesn't reference are not touched.</td>
-</tr>
-<tr>
-<td>export</td>
-<td>-a, -export-all</td>
-<td>Export all targets. <code>input1</code>is not necessary when this flag is used.</td>
-</tr>
-<tr>
-<td>import</td>
-<td>-a, -import-all</td>
-<td>Import all targets typed into standard input or redirected from a file.</td>
-</tr>
-</tbody>
-</table>
-<p>Examples</p>
-<table>
-<thead>
-<tr>
-<th>Sub-command</th>
-<th>Usage</th>
-<th>Explanation</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td>set</td>
-<td>newt target set myblinky compiler=arm-none-eabi-m4</td>
-<td>Set the compiler for the 'myblinky' target to the gcc compiler for embedded ARM chips.</td>
-</tr>
-<tr>
-<td>unset</td>
-<td>newt target unset myblinky compiler</td>
-<td>Remove the setting for the compiler for the 'myblinky' target.</td>
-</tr>
-<tr>
-<td>delete</td>
-<td>newt target delete myblinky</td>
-<td>Delete the target description for the target named 'myblinky'. Note that it does not remove any binaries or clean out the directory for this target.</td>
-</tr>
-<tr>
-<td>create</td>
-<td>newt target create blink_f3disc</td>
-<td>Create a new target description by the name 'blink_f3disc'. The architecture is 'sim' by default and can be changed using subcommand 'set' above.</td>
-</tr>
-<tr>
-<td>show</td>
-<td>newt target show myblinky</td>
-<td>Show the target attributes set for 'myblinky'</td>
-</tr>
-<tr>
-<td>build</td>
-<td>newt target build blink_f3disc</td>
-<td>Compile the source code for the target named blink_f3disc and generate binaries that can be loaded into the target hardware.</td>
-</tr>
-<tr>
-<td>test</td>
-<td>newt target test test_target egg=libs/os</td>
-<td>Tests the egg named 'libs/os' against the target named 'test_target'</td>
-</tr>
-<tr>
-<td>export</td>
-<td>newt target export -a > my_exports.txt</td>
-<td>Export all build targets from the current nest, and redirect output to a file named 'my_exports.txt'.</td>
-</tr>
-<tr>
-<td>export</td>
-<td>newt target export -export-all</td>
-<td>Export all build targets from the current nest, and print them to standard output on the screen.</td>
-</tr>
-<tr>
-<td>export</td>
-<td>newt target export my_target</td>
-<td>Export only target named 'my_target' and print it to standard output on the screen.</td>
-</tr>
-<tr>
-<td>import</td>
-<td>newt target import ex_tgt_1 < exported_targets.txt</td>
-<td>Imports the target configuration for 'ex_tgt_1' in 'exported_targets.txt'.</td>
-</tr>
-<tr>
-<td>import</td>
-<td>newt target import -a < in_targets.txt</td>
-<td>Imports all the targets specified in the file named <code>in_targets.txt</code> A sample file is shown after this table.</td>
-</tr>
-<tr>
-<td>size</td>
-<td>newt target size blink_nordic</td>
-<td>Inspects and lists the RAM and Flash memory use by each component (object files and libraries) of the target.</td>
-</tr>
-<tr>
-<td>download</td>
-<td>newt target -v -lVERBOSE download blinky</td>
-<td>Downloads <code>blinky.elf.bin</code>to the hardware in verbose mode with logging turned on at VERBOSE level.</td>
-</tr>
-<tr>
-<td>debug</td>
-<td>newt target debug blinky</td>
-<td>Downloads <code>blinky.elf.bin</code>to the hardware, opens up a gdb session with <code>blinky.elf</code>in the terminal, and halts for further input in gdb.</td>
-</tr>
-</tbody>
-</table>
-<p>Example content for <code>in_targets.txt</code> file used for importing targets <code>test3</code> and <code>test4</code>. </p>
-<blockquote>
-<p>@target=test3<br />
-project=blinked<br />
-arch=sim<br />
-compiler_def=debug<br />
-compiler=arm-none-eabi-m4<br />
-@target=test4<br />
-project=super_blinky<br />
-arch=sim<br />
-compiler_def=debug<br />
-compiler=arm-none-eabi-m4<br />
-@endtargets</p>
-</blockquote></div>
-
- </div>
-
- <footer class="col-md-12">
- <hr>
-
- <p>Documentation built with <a href="http://www.mkdocs.org/">MkDocs</a>.</p>
- </footer>
-
- <script src="../../js/jquery-1.10.2.min.js"></script>
- <script src="../../js/bootstrap-3.0.3.min.js"></script>
- <script src="../../js/highlight.pack.js"></script>
- <script>var base_url = '../..';</script>
- <script data-main="../../mkdocs/js/search.js" src="../../mkdocs/js/require.js"></script>
- <script src="../../js/base.js"></script>
-
- <div class="modal" id="mkdocs_search_modal" tabindex="-1" role="dialog" aria-labelledby="Search Modal" aria-hidden="true">
- <div class="modal-dialog">
- <div class="modal-content">
- <div class="modal-header">
- <button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">×</span><span class="sr-only">Close</span></button>
- <h4 class="modal-title" id="exampleModalLabel">Search</h4>
- </div>
- <div class="modal-body">
- <p>
- From here you can search these documents. Enter
- your search terms below.
- </p>
- <form role="form">
- <div class="form-group">
- <input type="text" class="form-control" placeholder="Search..." id="mkdocs-search-query">
- </div>
- </form>
- <div id="mkdocs-search-results"></div>
- </div>
- <div class="modal-footer">
- </div>
- </div>
- </div>
- </div>
-
- </body>
-</html>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/0d880edf/site/css/base.css
----------------------------------------------------------------------
diff --git a/site/css/base.css b/site/css/base.css
deleted file mode 100644
index 8bfc7de..0000000
--- a/site/css/base.css
+++ /dev/null
@@ -1,275 +0,0 @@
-body {
- padding-top: 70px;
- background: url(../img/grid.png) repeat-x;
- background-attachment: fixed;
- background-color: #f8f8f8;
-}
-
-body > div.container {
- min-height: 400px;
-}
-
-ul.nav li.main {
- font-weight: bold;
-}
-
-div.col-md-3 {
- padding-left: 0;
-}
-
-div.col-md-9 {
- padding-bottom: 100px;
-}
-
-div.source-links {
- float: right;
-}
-
-div.col-md-9 img {
- max-width: 100%;
- display: inline;
- padding: 4px;
- line-height: 1.428571429;
- background-color: #fff;
- border: 1px solid #ddd;
- border-radius: 4px;
- margin: 20px auto 30px auto;
-}
-
-h1, h2, h3 {
- color: #444;
-}
-
-h1[id]:before, h2[id]:before, h3[id]:before, h4[id]:before, h5[id]:before, h6[id]:before {
- content: "";
- display: block;
- margin-top: -75px;
- height: 75px;
- pointer-events: none;
-}
-
-h1 {
- font-weight: 400;
- font-size: 42px;
-}
-
-h2, h3, h4, h5, h6 {
- font-weight: 300;
-}
-
-hr {
- border-top: 1px solid #aaa;
-}
-
-pre, .rst-content tt {
- max-width: 100%;
- background: #fff;
- border: solid 1px #e1e4e5;
- color: #e74c3c;
- overflow-x: auto;
-}
-
-code.code-large, .rst-content tt.code-large {
- font-size: 90%;
-}
-
-code {
- padding: 2px 5px;
- color: #c7254e;
- background-color: #f9f2f4;
- font-size: 75%;
-}
-
-code, kbd, pre, samp {
- font-family: monospace,serif;
- font-size: 12px !important;
-}
-
-footer {
- margin-top: 30px;
- margin-bottom: 10px;
- text-align: center;
- font-weight: 200;
-}
-
-.modal-dialog {
- margin-top: 60px;
-}
-
-/*
- * Side navigation
- *
- * Scrollspy and affixed enhanced navigation to highlight sections and secondary
- * sections of docs content.
- */
-
-/* By default it's not affixed in mobile views, so undo that */
-.bs-sidebar.affix {
- position: static;
-}
-
-.bs-sidebar.well {
- padding: 0;
-}
-
-/* First level of nav */
-.bs-sidenav {
- padding-top: 10px;
- padding-bottom: 10px;
- border-radius: 5px;
-}
-
-/* All levels of nav */
-.bs-sidebar .nav > li > a {
- display: block;
- padding: 5px 20px;
- z-index: 1;
-}
-.bs-sidebar .nav > li > a:hover,
-.bs-sidebar .nav > li > a:focus {
- text-decoration: none;
- border-right: 1px solid;
-}
-.bs-sidebar .nav > .active > a,
-.bs-sidebar .nav > .active:hover > a,
-.bs-sidebar .nav > .active:focus > a {
- font-weight: bold;
- background-color: transparent;
- border-right: 1px solid;
-}
-
-/* Nav: second level (shown on .active) */
-.bs-sidebar .nav .nav {
- display: none; /* Hide by default, but at >768px, show it */
- margin-bottom: 8px;
-}
-.bs-sidebar .nav .nav > li > a {
- padding-top: 3px;
- padding-bottom: 3px;
- padding-left: 30px;
- font-size: 90%;
-}
-
-/* Show and affix the side nav when space allows it */
-@media (min-width: 992px) {
- .bs-sidebar .nav > .active > ul {
- display: block;
- }
- /* Widen the fixed sidebar */
- .bs-sidebar.affix,
- .bs-sidebar.affix-bottom {
- width: 213px;
- }
- .bs-sidebar.affix {
- position: fixed; /* Undo the static from mobile first approach */
- top: 80px;
- }
- .bs-sidebar.affix-bottom {
- position: absolute; /* Undo the static from mobile first approach */
- }
- .bs-sidebar.affix-bottom .bs-sidenav,
- .bs-sidebar.affix .bs-sidenav {
- margin-top: 0;
- margin-bottom: 0;
- }
-}
-@media (min-width: 1200px) {
- /* Widen the fixed sidebar again */
- .bs-sidebar.affix-bottom,
- .bs-sidebar.affix {
- width: 263px;
- }
-}
-
-.headerlink {
- font-family: FontAwesome;
- font-size: 14px;
- display: none;
- padding-left: .5em;
-}
-
-h1:hover .headerlink, h2:hover .headerlink, h3:hover .headerlink, h4:hover .headerlink, h5:hover .headerlink, h6:hover .headerlink{
- display:inline-block;
-}
-
-
-
-.admonition {
- padding: 15px;
- margin-bottom: 20px;
- border: 1px solid transparent;
- border-radius: 4px;
- text-align: left;
-}
-
-.admonition.note {
- color: #3a87ad;
- background-color: #d9edf7;
- border-color: #bce8f1;
-}
-
-.admonition.warning {
- color: #c09853;
- background-color: #fcf8e3;
- border-color: #fbeed5;
-}
-
-.admonition.danger {
- color: #b94a48;
- background-color: #f2dede;
- border-color: #eed3d7;
-}
-
-.admonition-title {
- font-weight: bold;
- text-align: left;
-}
-
-
-.dropdown-submenu {
- position: relative;
-}
-
-.dropdown-submenu>.dropdown-menu {
- top: 0;
- left: 100%;
- margin-top: -6px;
- margin-left: -1px;
- -webkit-border-radius: 0 6px 6px 6px;
- -moz-border-radius: 0 6px 6px;
- border-radius: 0 6px 6px 6px;
-}
-
-.dropdown-submenu:hover>.dropdown-menu {
- display: block;
-}
-
-.dropdown-submenu>a:after {
- display: block;
- content: " ";
- float: right;
- width: 0;
- height: 0;
- border-color: transparent;
- border-style: solid;
- border-width: 5px 0 5px 5px;
- border-left-color: #ccc;
- margin-top: 5px;
- margin-right: -10px;
-}
-
-.dropdown-submenu:hover>a:after {
- border-left-color: #fff;
-}
-
-.dropdown-submenu.pull-left {
- float: none;
-}
-
-.dropdown-submenu.pull-left>.dropdown-menu {
- left: -100%;
- margin-left: 10px;
- -webkit-border-radius: 6px 0 6px 6px;
- -moz-border-radius: 6px 0 6px 6px;
- border-radius: 6px 0 6px 6px;
-}