Initial commit of the new website
diff --git a/_projectCommon.php b/_projectCommon.php
deleted file mode 100644
index 0fe02c9..0000000
--- a/_projectCommon.php
+++ /dev/null
@@ -1,23 +0,0 @@
-<?php
-/*******************************************************************************
- * Copyright (c) 2014 Eclipse Foundation and others.
- * All rights reserved. This program and the accompanying materials
- * are made available under the terms of the Eclipse Public License v1.0
- * which accompanies this distribution, and is available at
- * http://eclipse.org/legal/epl-v10.html
- *
- * Contributors:
- * Christopher Guindon (Eclipse Foundation) - Initial implementation
- *******************************************************************************/
-
- # Set the theme for your project's web pages.
- # See the Committer Tools "Phoenix" secion in the How Do I? for list of themes
- # https://dev.eclipse.org/committers/
- $theme = "solstice";
-
- # Define your project-wide Nav bars here.
- # Format is Link text, link URL (can be http://www.someothersite.com/), target (_self, _blank).
- $Nav->addNavSeparator("Solstice", "/eclipse.org-common/themes/solstice/docs/");
- $Nav->addCustomNav("Documentation", "/eclipse.org-common/themes/solstice/docs/", "_self", NULL);
- $Nav->addCustomNav("Source code", "http://git.eclipse.org/c/www.eclipse.org/eclipse.org-common.git/tree/themes/solstice/", "_self", NULL);
- $Nav->addCustomNav("Using Phoenix", "http://wiki.eclipse.org/Using_Phoenix", "_self", NULL);
diff --git a/categories/index.xml b/categories/index.xml
new file mode 100644
index 0000000..9accc79
--- /dev/null
+++ b/categories/index.xml
@@ -0,0 +1,14 @@
+<?xml version="1.0" encoding="utf-8" standalone="yes" ?>
+<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom">
+ <channel>
+ <title>Categories on Eclipse Mita</title>
+ <link>/categories/</link>
+ <description>Recent content in Categories on Eclipse Mita</description>
+ <generator>Hugo -- gohugo.io</generator>
+ <language>en-us</language>
+
+ <atom:link href="/categories/index.xml" rel="self" type="application/rss+xml" />
+
+
+ </channel>
+</rss>
\ No newline at end of file
diff --git a/concepts/eventLoop.png b/concepts/eventLoop.png
new file mode 100644
index 0000000..92c95b3
--- /dev/null
+++ b/concepts/eventLoop.png
Binary files differ
diff --git a/concepts/index.html b/concepts/index.html
new file mode 100644
index 0000000..1290b28
--- /dev/null
+++ b/concepts/index.html
@@ -0,0 +1,641 @@
+<!DOCTYPE html>
+
+
+
+
+ <html class="no-js">
+
+ <head lang="en-us">
+ <meta charset="utf-8">
+ <meta name="viewport" content="width=device-width,user-scalable=no,initial-scale=1,maximum-scale=1">
+ <meta http-equiv="X-UA-Compatible" content="IE=10" />
+ <title>Concepts - Eclipse Mita</title>
+ <meta name="generator" content="Hugo 0.42.1" />
+
+
+ <meta name="description" content="The documentation of Eclipse Mita.">
+
+ <link rel="canonical" href="../concepts/">
+
+
+ <meta property="og:url" content="/concepts/">
+ <meta property="og:title" content="Eclipse Mita">
+ <meta property="og:image" content="/images/mita.svg">
+ <meta name="apple-mobile-web-app-title" content="Eclipse Mita">
+ <meta name="apple-mobile-web-app-capable" content="yes">
+ <meta name="apple-mobile-web-app-status-bar-style" content="black-translucent">
+
+ <link rel="shortcut icon" type="image/x-icon" href="../images/favicon.ico">
+ <link rel="icon" type="image/x-icon" href="../images/favicon.ico">
+
+ <style>
+ @font-face {
+ font-family: 'Icon';
+ src: url('/fonts/icon.eot');
+ src: url('/fonts/icon.eot')
+ format('embedded-opentype'),
+ url('/fonts/icon.woff')
+ format('woff'),
+ url('/fonts/icon.ttf')
+ format('truetype'),
+ url('/fonts/icon.svg')
+ format('svg');
+ font-weight: normal;
+ font-style: normal;
+ }
+ </style>
+
+ <link rel="stylesheet" href="../stylesheets/application.css">
+ <link rel="stylesheet" href="../stylesheets/temporary.css">
+ <link rel="stylesheet" href="../stylesheets/palettes.css">
+ <link rel="stylesheet" href="../stylesheets/highlight/highlight.css">
+
+
+
+
+ <link rel="stylesheet" href="//fonts.googleapis.com/css?family=Ubuntu:400,700|Ubuntu+Mono">
+ <style>
+ body, input {
+ font-family: 'Ubuntu', Helvetica, Arial, sans-serif;
+ }
+ pre, code {
+ font-family: 'Ubuntu Mono', 'Courier New', 'Courier', monospace;
+ }
+ </style>
+
+
+ <link rel="stylesheet" href="../css/custom.css">
+
+ <script src="../javascripts/modernizr.js"></script>
+
+
+
+ </head>
+ <body class="palette-primary-blue-grey palette-accent-light-blue">
+
+
+
+
+<div class="backdrop">
+ <div class="backdrop-paper"></div>
+</div>
+
+<input class="toggle" type="checkbox" id="toggle-drawer">
+<input class="toggle" type="checkbox" id="toggle-search">
+<label class="toggle-button overlay" for="toggle-drawer"></label>
+
+<header class="header">
+ <nav aria-label="Header">
+ <div class="bar default">
+ <div class="button button-menu" role="button" aria-label="Menu">
+ <label class="toggle-button icon icon-menu" for="toggle-drawer">
+ <span></span>
+ </label>
+ </div>
+ <div class="stretch">
+ <div class="title">
+ Concepts
+ </div>
+ </div>
+
+
+ <div class="button button-twitter" role="button" aria-label="Twitter">
+ <a href="https://twitter.com/eclipse_mita" title="@eclipse_mita on Twitter" target="_blank" class="toggle-button icon icon-twitter"></a>
+ </div>
+
+
+
+ <div class="button button-github" role="button" aria-label="GitHub">
+ <a href="https://github.com/eclipse/mita" title="@eclipse/mita on GitHub" target="_blank" class="toggle-button icon icon-github"></a>
+ </div>
+
+
+
+ </div>
+ <div class="bar search">
+ <div class="button button-close" role="button" aria-label="Close">
+ <label class="toggle-button icon icon-back" for="toggle-search"></label>
+ </div>
+ <div class="stretch">
+ <div class="field">
+ <input class="query" type="text" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck>
+ </div>
+ </div>
+ <div class="button button-reset" role="button" aria-label="Search">
+ <button class="toggle-button icon icon-close" id="reset-search"></button>
+ </div>
+ </div>
+</nav>
+</header>
+
+<main class="main">
+ <div class="drawer">
+ <nav aria-label="Navigation">
+ <a href="../" class="project">
+ <div class="banner">
+
+ <div class="logo">
+ <img src="../images/mita.svg">
+ </div>
+
+ <div class="name">
+ <strong>Eclipse Mita </strong>
+
+ </div>
+ </div>
+ </a>
+
+ <div class="scrollable">
+ <div class="wrapper">
+
+
+ <div class="toc">
+
+ <ul>
+
+
+
+
+
+<li>
+
+
+
+
+
+<a title="Download" href="http://github.com/eclipse/mita">
+
+ Download
+</a>
+
+
+
+
+</li>
+
+
+
+<li>
+
+
+
+
+
+<a class="current" title="Concepts" href="../concepts/">
+
+ Concepts
+</a>
+
+
+<ul id="scrollspy">
+</ul>
+
+
+
+</li>
+
+
+
+<li>
+
+ <span class="section">Language</span>
+ <ul>
+
+
+
+
+
+
+<a title="Introduction" href="../language/introduction/">
+
+ Introduction
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Basics" href="../language/basics/">
+
+ Basics
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Packages" href="../language/packages/">
+
+ Packages
+</a>
+
+
+
+
+
+
+
+
+
+<a title="System Setup" href="../language/setup/">
+
+ System Setup
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Types" href="../language/types/">
+
+ Types
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Arrays" href="../language/arrays/">
+
+ Arrays
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Functions" href="../language/functions/">
+
+ Functions
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Foreign Function Interface" href="../language/foreignfunctioninterface/">
+
+ Foreign Function Interface
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Events" href="../language/events/">
+
+ Events
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Exceptions" href="../language/exceptions/">
+
+ Exceptions
+</a>
+
+
+
+
+ </ul>
+
+</li>
+
+
+
+<li>
+
+ <span class="section">Platforms</span>
+ <ul>
+
+
+
+
+
+
+<a title="XDK110" href="../platforms/xdk110/">
+
+ XDK110
+</a>
+
+
+
+
+ </ul>
+
+</li>
+
+
+ </ul>
+
+
+
+ </div>
+ </div>
+ </div>
+</nav>
+
+ </div>
+
+ <article class="article">
+ <div class="wrapper">
+ <h1>Concepts </h1>
+
+
+
+<h2 id="platform">Platform</h2>
+
+<div class="admonition note">
+<p class="admonition-title">TLDR; A platform is the thing you are writing programs for.</p>
+<p>Platforms describe the thing that you are writing software for; this thing is literally the piece of hardware and software platform running on it.
+You do not have create that platform.
+Platforms consist of something you can configure (<em>configuration items</em>),
+something you can read from at runtime (<em>modalities</em>),
+something you can send and receive data through (<em>signals</em>)
+and something you can react to (<em>events</em>).</p>
+</div>
+
+<p>Mita compiles to C code. There are a lot of specifics which we need to know so that we can generate code which runs on your embedded device.
+The compiler needs to know how to start up the device, how to work with time, what components are available, what events they have, how to use and configure them.</p>
+
+<p>Mita encapsulates all this information in what we call a <em>platform</em>. Platforms are provided by third parties (e.g. the vendor who built an embedded IoT development kit), not you the developer.
+As part of that platform we get a <em>platform description</em> and a bunch of <em>code generators</em> capable of producing different aspects of the C code we generate.</p>
+
+<p>In this section we will not go in detail on the generators, but talk about the <em>platform description</em>. The terminology introduced here matters to you as user of Mita.
+We use it when talking about Mita programs, and subsequently throughout this documentation.</p>
+
+<h3 id="system-resource">System Resource</h3>
+
+<p>An IoT platform consists of many different components.
+It will have some form of connectivity (think WiFi, LoRa or Bluetooth),
+a bunch of sensors such as an accelerometer or temperature sensor,
+and maybe some low-level input/output like <a href="https://en.wikipedia.org/wiki/GPIO">general-purpose IO</a>, <a href="https://en.wikipedia.org/wiki/Serial_Peripheral_Interface_Bus">SPI</a> or <a href="https://en.wikipedia.org/wiki/I2C">I2C</a>.</p>
+
+<p>In Mita we call those components system resources, as they are finite resources available to you as developer.
+Some system resources can be instantiated multiple times (see the <a href="../language/setup/">setup section</a>), others only exist once.
+However, all system resources share the same features. They can be configured using <em>configuration-items</em>, can provide data at runtime using <em>modalities</em>, can offer means to communicate with the outside world using <em>signals</em> and can provide <em>events</em> for you to react to.</p>
+
+<h3 id="configuration-items">Configuration Items</h3>
+
+<p>Configuration items are the things of a system resource that can be configured.
+For example, an acceleration sensor might have a range in which it is capable of operating. This range can be changed.
+Or a light sensor might take some time to measure how much light is available - the more time spent measuring the better the measurement, but the longer it takes. This measurement time can be configured.
+Configuration items all have a data type and are prescribed by the platform definition.</p>
+
+<p>For example, the Bosch Cross Domain Development Kit (<a href="../platforms/xdk110/">XDK110 platform</a>) supports a light sensor where one can configure the measurement time (they call it <em>integration time</em>):</p>
+<div class="highlight"><pre class="chroma"><code class="language-TypeScript" data-lang="TypeScript"><span class="kr">package</span> <span class="nx">main</span><span class="p">;</span>
+<span class="kr">import</span> <span class="nx">platforms</span><span class="p">.</span><span class="nx">xdk110</span><span class="p">;</span>
+
+<span class="nx">setup</span> <span class="nx">light</span> <span class="p">{</span>
+ <span class="nx">integration_time</span> <span class="o">=</span> <span class="nx">MS_200</span><span class="p">;</span>
+<span class="p">}</span></code></pre></div>
+<h3 id="modalities">Modalities</h3>
+
+<p>Modalities are things that can change at runtime, for example sensor values or the signal strength of a radio. Modalities are prescribed by the platform definition. You as developer do not have to set them up but they are simply available to you.
+There is a read method defined for them which allows you to read the modality at any time. For example, take the light sensor of the (<a href="../platforms/xdk110/">XDK110 platform</a>):</p>
+<div class="highlight"><pre class="chroma"><code class="language-TypeScript" data-lang="TypeScript"><span class="kr">package</span> <span class="nx">main</span><span class="p">;</span>
+<span class="kr">import</span> <span class="nx">platforms</span><span class="p">.</span><span class="nx">xdk110</span><span class="p">;</span>
+
+<span class="nx">every</span> <span class="mi">100</span> <span class="nx">milliseconds</span> <span class="p">{</span>
+ <span class="kd">let</span> <span class="nx">lightLevel</span> <span class="o">=</span> <span class="nx">light</span><span class="p">.</span><span class="nx">intensity</span><span class="p">.</span><span class="nx">read</span><span class="p">();</span>
+<span class="p">}</span></code></pre></div>
+<p>Modalities have special behavior when it comes to reading several of them at once. For example, a three-axis sensor will return values for all three axis in the same sample (think of a three-axis accelerometer). Thus when reading the x, y and z modalities one after the other, as developers we would expect them to come from the same sample:</p>
+<div class="highlight"><pre class="chroma"><code class="language-TypeScript" data-lang="TypeScript"><span class="kr">package</span> <span class="nx">main</span><span class="p">;</span>
+<span class="kr">import</span> <span class="nx">platforms</span><span class="p">.</span><span class="nx">xdk110</span><span class="p">;</span>
+
+<span class="nx">every</span> <span class="mi">100</span> <span class="nx">milliseconds</span> <span class="p">{</span>
+ <span class="kd">let</span> <span class="nx">x</span> <span class="o">=</span> <span class="nx">accelerometer</span><span class="p">.</span><span class="nx">x_axis</span><span class="p">.</span><span class="nx">read</span><span class="p">();</span>
+ <span class="kd">let</span> <span class="nx">y</span> <span class="o">=</span> <span class="nx">accelerometer</span><span class="p">.</span><span class="nx">y_axis</span><span class="p">.</span><span class="nx">read</span><span class="p">();</span>
+ <span class="kd">let</span> <span class="nx">z</span> <span class="o">=</span> <span class="nx">accelerometer</span><span class="p">.</span><span class="nx">z_axis</span><span class="p">.</span><span class="nx">read</span><span class="p">();</span>
+
+ <span class="c1">// x, y, z come from the same sample
+</span><span class="c1"></span><span class="p">}</span></code></pre></div>
+<p>The code generator that ships with the system resource (in this case the code generator provided by the <a href="../platforms/xdk110/">XDK110 platform</a>) can choose to group modality access, so that the data read from them is coherent.</p>
+
+<h3 id="signals">Signals</h3>
+
+<p>Signals provide means to exchange data with the outside world.
+It depends on the system resource that defines the signal what is represented by that signal.
+To understand what they are, let’s look at a few examples of <em>signal instances</em> first:</p>
+
+<ul>
+<li>Bluetooth Low Energy has GATT characteristics through which data is exchanged. In Mita, a GATT characteristic is a signal instance.</li>
+<li>REST-style APIs talk about resources on which one perform actions (e.g. read or write). In Mita such a resource is a signal instance.</li>
+<li>MQTT publishes messages to specific topics. In Mita a particular MQTT topic is a signal instance that one can publish and subscribe to.</li>
+<li>In I2C buses communication is centered around registers which can be read or written to. In Mita an I2C register is a signal instance.</li>
+<li>General purpose IO enables users to configure the hardware pins to specific behavior. In Mita a particular GPIO pin is a signal instance.</li>
+</ul>
+
+<p>As developers we configure those signal instances within the setup block of a system resource. For example:</p>
+<div class="highlight"><pre class="chroma"><code class="language-TypeScript" data-lang="TypeScript"><span class="kr">package</span> <span class="nx">main</span><span class="p">;</span>
+<span class="kr">import</span> <span class="nx">platforms</span><span class="p">.</span><span class="nx">xdk110</span><span class="p">;</span>
+
+<span class="nx">setup</span> <span class="nx">backend</span> : <span class="kt">HttpRestClient</span> <span class="p">{</span>
+ <span class="kd">var</span> <span class="nx">temperature</span> <span class="o">=</span> <span class="nx">resource</span><span class="p">(</span><span class="nx">endpoint</span><span class="o">=</span><span class="s2">"/temperature"</span><span class="p">,</span> <span class="nx">writeMethod</span><span class="o">=</span><span class="nx">PUT</span><span class="p">);</span>
+<span class="p">}</span></code></pre></div>
+<p>What is a signal then? A signal is the “prototype” of a signal instance.
+It’s the thing provided by the platform specification that prescribes that the <code>HttpRestClient</code> has a <code>resource</code>.</p>
+
+<h2 id="event-loop">Event Loop</h2>
+
+<div class="admonition note">
+<p class="admonition-title">TLDR; The event loop executes all code in your program.</p>
+<p>All events that your program handles, thus all code that your program consists off, is executed sequentally by the event loop.
+This eases code generation and prevents concurrency issues. It also means there is no concurrency at all, thus you get no timing
+guarantees and long running operations can block all your code.</p>
+</div>
+
+<p>Mita is an event based language, because this programming style maps well to how IoT devices work. Most of the time an IoT device is sleeping to conserve energy.
+Every now and then it will wake up, either based on time or some external event, do some measurement, computation and communication, and go back to sleep.
+Mita lets you write programs that match this pattern well by reacting to events.</p>
+
+<p><img src="eventLoop.png" alt="Event Loop" /></p>
+
+<p>All events that happen on the system are placed in the <em>event loop</em> and handled sequentially.
+This strategy has two main advantages.
+Firstly, all code runs in a well defined context, namely the event loop task, as compared to some executing in an interrupt service routine context, some in a timer context and some in a task context. This makes it easier to generate predictable code.
+Secondly, we do not have to worry about concurrency (yet). All code runs sequentually, there simply is no concurrency we would have to worry about.</p>
+
+<p>However, it also suffers from two major drawbacks: no timing guarantees and no concurrency.
+As developers we do not get guarantees how long it will take between an event happening and our code reacting to it.
+If, for example, a previous event handler is “running late”, we might react to the event far too late.
+Also, all our code running sequentally is a blessing (see above) and a curse. It means that while a long-running operation is on-going our whole program has to wait for that operation to complete.
+For example, making an HTTP request over a slow network can take a long time, all the while our device will be dead waiting for that event to complete.</p>
+
+<p>Future versions of Mita will address these issues and allow for some forms of concurrency.</p>
+
+<h2 id="element-size-inference">Element Size Inference</h2>
+
+<div class="admonition note">
+<p class="admonition-title">TLDR; Element Size Inference is the way we manage memory.</p>
+<p>Mita allocates all memory on the stack, there is no <code>malloc</code> or <code>free</code>. To do this we need to know at compile time how much memory
+we need for things. Developers (most of the time) do not have to tell us how much memory is required, we infer it using <em>element size inference</em>.</p>
+</div>
+
+<p>Mita allocates all memory on the stack, there is no <code>malloc</code> or <code>free</code>.
+This makes the memory use of our programs more predictable and easier to debug (free’ing some memory you’re still using is a really bad idea).
+It also means that, at compile time, we have to know how much memory we need. In C you, the developer, have to tell the compiler. In Mita we try to infer
+that from your code. This way you do not have tell us how much space your string needs, or how big that array literal is. For example:</p>
+<div class="highlight"><pre class="chroma"><code class="language-TypeScript" data-lang="TypeScript"><span class="nx">fn</span> <span class="nx">main() {</span>
+ <span class="kd">var</span> <span class="nx">message</span> <span class="o">=</span> <span class="s2">"{ \"sensor\": \""</span><span class="p">;</span>
+ <span class="k">if</span><span class="p">(</span><span class="nx">isAccelerometerActive</span><span class="p">())</span> <span class="p">{</span>
+ <span class="nx">message</span> <span class="o">+=</span> <span class="s2">"accel"</span><span class="p">;</span>
+ <span class="p">}</span> <span class="k">else</span> <span class="p">{</span>
+ <span class="nx">message</span> <span class="o">+=</span> <span class="s2">"gyro"</span><span class="p">;</span>
+ <span class="p">}</span>
+ <span class="nx">message</span> <span class="o">+=</span> <span class="sb">`", "value": </span><span class="si">${</span><span class="nx">getSensorValue</span><span class="p">()</span><span class="si">}</span><span class="sb"> }`</span><span class="p">;</span>
+
+ <span class="nx">println</span><span class="p">(</span><span class="nx">message</span><span class="p">);</span>
+<span class="p">}</span></code></pre></div>
+<p>Notice how we never had to say how big message is or will become. Towards the end we even append some interpolated string and the compiler is still able to infer the worst-case size of the string.</p>
+
+<p>We also use this feature to do many checks at compile time. For example, if we can infer the size of your array and the position you’re trying access at compile time,
+we can tell you if that access will work out or not; before you run your code.</p>
+
+
+ <aside class="copyright" role="note">
+
+ © 2018 The Eclipse Mita Project –
+
+ Documentation built with
+ <a href="https://www.gohugo.io" target="_blank">Hugo</a>
+ using the
+ <a href="http://github.com/digitalcraftsman/hugo-material-docs" target="_blank">Material</a> theme.
+ </aside>
+
+ <footer class="footer">
+
+
+<nav class="pagination" aria-label="Footer">
+ <div class="previous">
+
+ <a href="../download/" title="Download">
+ <span class="direction">
+ Previous
+ </span>
+ <div class="page">
+ <div class="button button-previous" role="button" aria-label="Previous">
+ <i class="icon icon-back"></i>
+ </div>
+ <div class="stretch">
+ <div class="title">
+ Download
+ </div>
+ </div>
+ </div>
+ </a>
+
+ </div>
+
+ <div class="next">
+
+ </div>
+</nav>
+
+
+
+
+
+ </footer>
+ </div>
+ </article>
+
+ <div class="results" role="status" aria-live="polite">
+ <div class="scrollable">
+ <div class="wrapper">
+ <div class="meta"></div>
+ <div class="list"></div>
+ </div>
+ </div>
+ </div>
+</main>
+
+ <script>
+
+ var base_url = '';
+ var repo_id = '';
+
+ </script>
+
+ <script src="../javascripts/application.js"></script>
+
+
+ <script>
+ /* Add headers to scrollspy */
+ var headers = document.getElementsByTagName("h2");
+ var scrollspy = document.getElementById('scrollspy');
+
+ if(scrollspy) {
+ if(headers.length > 0) {
+ for(var i = 0; i < headers.length; i++) {
+ var li = document.createElement("li");
+ li.setAttribute("class", "anchor");
+
+ var a = document.createElement("a");
+ a.setAttribute("href", "#" + headers[i].id);
+ a.setAttribute("title", headers[i].innerHTML);
+ a.innerHTML = headers[i].innerHTML;
+
+ li.appendChild(a)
+ scrollspy.appendChild(li);
+ }
+ } else {
+ scrollspy.parentElement.removeChild(scrollspy)
+ }
+
+
+ /* Add permanent link next to the headers */
+ var headers = document.querySelectorAll("h1, h2, h3, h4, h5, h6");
+
+ for(var i = 0; i < headers.length; i++) {
+ var a = document.createElement("a");
+ a.setAttribute("class", "headerlink");
+ a.setAttribute("href", "#" + headers[i].id);
+ a.setAttribute("title", "Permanent link")
+ a.innerHTML = "#";
+ headers[i].appendChild(a);
+ }
+ }
+ </script>
+
+
+
+ <script src="//cdnjs.cloudflare.com/ajax/libs/highlight.js/9.8.0/highlight.min.js"></script>
+ <script>hljs.initHighlightingOnLoad();</script>
+ </body>
+</html>
+
diff --git a/content/en_index.php b/content/en_index.php
deleted file mode 100644
index f4e6422..0000000
--- a/content/en_index.php
+++ /dev/null
@@ -1,30 +0,0 @@
-<?php
-/*******************************************************************************
- * Copyright (c) 2014 Eclipse Foundation and others.
- * All rights reserved. This program and the accompanying materials
- * are made available under the terms of the Eclipse Public License v1.0
- * which accompanies this distribution, and is available at
- * http://eclipse.org/legal/epl-v10.html
- *
- * Contributors:
- * Christopher Guindon (Eclipse Foundation) - Initial implementation
- *******************************************************************************/
-?>
-
-<!-- Main content area -->
-<div id="midcolumn">
- <h1><?php print $pageTitle;?></h1>
- <p><a href="solstice-starterkit.zip" class="btn btn-warning">Download Starterkit</a></p>
-</div>
-<!-- ./end #midcolumn -->
-
-<!-- Start of the right column -->
-<div id="rightcolumn">
- <div class="sideitem">
- <h2>Related Links</h2>
- <ul>
- <li><a target="_self" href="/eclipse.org-common/themes/solstice/docs/">Documentation</a></li>
- </ul>
- </div>
-</div>
-<!-- ./end #rightcolumn -->
diff --git a/css/custom.css b/css/custom.css
new file mode 100644
index 0000000..bc2c56b
--- /dev/null
+++ b/css/custom.css
@@ -0,0 +1,13 @@
+.project .logo img {
+ background-color: transparent;
+ border-radius: 0px;
+}
+
+.header, .footer {
+ /* background: linear-gradient(30deg, #324D5C, #FFE33C) !important; */
+ background: linear-gradient(-30deg, #FFC848, #1EC4B4) !important;
+}
+
+.article code {
+ background-color: transparent;
+}
\ No newline at end of file
diff --git a/css/pygments.css b/css/pygments.css
new file mode 100644
index 0000000..8070f2f
--- /dev/null
+++ b/css/pygments.css
@@ -0,0 +1,61 @@
+.highlight .hll { background-color: #ffffcc }
+.highlight .c { color: #408080; font-style: italic } /* Comment */
+.highlight .err { border: 1px solid #FF0000 } /* Error */
+.highlight .k { color: #008000; font-weight: bold } /* Keyword */
+.highlight .o { color: #666666 } /* Operator */
+.highlight .cm { color: #408080; font-style: italic } /* Comment.Multiline */
+.highlight .cp { color: #BC7A00 } /* Comment.Preproc */
+.highlight .c1 { color: #408080; font-style: italic } /* Comment.Single */
+.highlight .cs { color: #408080; font-style: italic } /* Comment.Special */
+.highlight .gd { color: #A00000 } /* Generic.Deleted */
+.highlight .ge { font-style: italic } /* Generic.Emph */
+.highlight .gr { color: #FF0000 } /* Generic.Error */
+.highlight .gh { color: #000080; font-weight: bold } /* Generic.Heading */
+.highlight .gi { color: #00A000 } /* Generic.Inserted */
+.highlight .go { color: #808080 } /* Generic.Output */
+.highlight .gp { color: #000080; font-weight: bold } /* Generic.Prompt */
+.highlight .gs { font-weight: bold } /* Generic.Strong */
+.highlight .gu { color: #800080; font-weight: bold } /* Generic.Subheading */
+.highlight .gt { color: #0040D0 } /* Generic.Traceback */
+.highlight .kc { color: #008000; font-weight: bold } /* Keyword.Constant */
+.highlight .kd { color: #008000; font-weight: bold } /* Keyword.Declaration */
+.highlight .kn { color: #008000; font-weight: bold } /* Keyword.Namespace */
+.highlight .kp { color: #008000 } /* Keyword.Pseudo */
+.highlight .kr { color: #008000; font-weight: bold } /* Keyword.Reserved */
+.highlight .kt { color: #B00040 } /* Keyword.Type */
+.highlight .m { color: #666666 } /* Literal.Number */
+.highlight .s { color: #BA2121 } /* Literal.String */
+.highlight .na { color: #7D9029 } /* Name.Attribute */
+.highlight .nb { color: #008000 } /* Name.Builtin */
+.highlight .nc { color: #0000FF; font-weight: bold } /* Name.Class */
+.highlight .no { color: #880000 } /* Name.Constant */
+.highlight .nd { color: #AA22FF } /* Name.Decorator */
+.highlight .ni { color: #999999; font-weight: bold } /* Name.Entity */
+.highlight .ne { color: #D2413A; font-weight: bold } /* Name.Exception */
+.highlight .nf { color: #0000FF } /* Name.Function */
+.highlight .nl { color: #A0A000 } /* Name.Label */
+.highlight .nn { color: #0000FF; font-weight: bold } /* Name.Namespace */
+.highlight .nt { color: #008000; font-weight: bold } /* Name.Tag */
+.highlight .nv { color: #19177C } /* Name.Variable */
+.highlight .ow { color: #AA22FF; font-weight: bold } /* Operator.Word */
+.highlight .w { color: #bbbbbb } /* Text.Whitespace */
+.highlight .mf { color: #666666 } /* Literal.Number.Float */
+.highlight .mh { color: #666666 } /* Literal.Number.Hex */
+.highlight .mi { color: #666666 } /* Literal.Number.Integer */
+.highlight .mo { color: #666666 } /* Literal.Number.Oct */
+.highlight .sb { color: #BA2121 } /* Literal.String.Backtick */
+.highlight .sc { color: #BA2121 } /* Literal.String.Char */
+.highlight .sd { color: #BA2121; font-style: italic } /* Literal.String.Doc */
+.highlight .s2 { color: #BA2121 } /* Literal.String.Double */
+.highlight .se { color: #BB6622; font-weight: bold } /* Literal.String.Escape */
+.highlight .sh { color: #BA2121 } /* Literal.String.Heredoc */
+.highlight .si { color: #BB6688; font-weight: bold } /* Literal.String.Interpol */
+.highlight .sx { color: #008000 } /* Literal.String.Other */
+.highlight .sr { color: #BB6688 } /* Literal.String.Regex */
+.highlight .s1 { color: #BA2121 } /* Literal.String.Single */
+.highlight .ss { color: #19177C } /* Literal.String.Symbol */
+.highlight .bp { color: #008000 } /* Name.Builtin.Pseudo */
+.highlight .vc { color: #19177C } /* Name.Variable.Class */
+.highlight .vg { color: #19177C } /* Name.Variable.Global */
+.highlight .vi { color: #19177C } /* Name.Variable.Instance */
+.highlight .il { color: #666666 } /* Literal.Number.Integer.Long */
diff --git a/description.html b/description.html
deleted file mode 100644
index 10edabc..0000000
--- a/description.html
+++ /dev/null
@@ -1 +0,0 @@
-This project was just provisioned, so there isn't much to see here. You can find links to the propsal on this page. Stay tuned for great things.
\ No newline at end of file
diff --git a/download/index.html b/download/index.html
new file mode 100644
index 0000000..c20e281
--- /dev/null
+++ b/download/index.html
@@ -0,0 +1,505 @@
+<!DOCTYPE html>
+
+
+
+
+ <html class="no-js">
+
+ <head lang="en-us">
+ <meta charset="utf-8">
+ <meta name="viewport" content="width=device-width,user-scalable=no,initial-scale=1,maximum-scale=1">
+ <meta http-equiv="X-UA-Compatible" content="IE=10" />
+ <title>Download - Eclipse Mita</title>
+ <meta name="generator" content="Hugo 0.42.1" />
+
+
+ <meta name="description" content="The documentation of Eclipse Mita.">
+
+ <link rel="canonical" href="../download/">
+
+
+ <meta property="og:url" content="/download/">
+ <meta property="og:title" content="Eclipse Mita">
+ <meta property="og:image" content="/images/mita.svg">
+ <meta name="apple-mobile-web-app-title" content="Eclipse Mita">
+ <meta name="apple-mobile-web-app-capable" content="yes">
+ <meta name="apple-mobile-web-app-status-bar-style" content="black-translucent">
+
+ <link rel="shortcut icon" type="image/x-icon" href="../images/favicon.ico">
+ <link rel="icon" type="image/x-icon" href="../images/favicon.ico">
+
+ <style>
+ @font-face {
+ font-family: 'Icon';
+ src: url('/fonts/icon.eot');
+ src: url('/fonts/icon.eot')
+ format('embedded-opentype'),
+ url('/fonts/icon.woff')
+ format('woff'),
+ url('/fonts/icon.ttf')
+ format('truetype'),
+ url('/fonts/icon.svg')
+ format('svg');
+ font-weight: normal;
+ font-style: normal;
+ }
+ </style>
+
+ <link rel="stylesheet" href="../stylesheets/application.css">
+ <link rel="stylesheet" href="../stylesheets/temporary.css">
+ <link rel="stylesheet" href="../stylesheets/palettes.css">
+ <link rel="stylesheet" href="../stylesheets/highlight/highlight.css">
+
+
+
+
+ <link rel="stylesheet" href="//fonts.googleapis.com/css?family=Ubuntu:400,700|Ubuntu+Mono">
+ <style>
+ body, input {
+ font-family: 'Ubuntu', Helvetica, Arial, sans-serif;
+ }
+ pre, code {
+ font-family: 'Ubuntu Mono', 'Courier New', 'Courier', monospace;
+ }
+ </style>
+
+
+ <link rel="stylesheet" href="../css/custom.css">
+
+ <script src="../javascripts/modernizr.js"></script>
+
+
+
+ </head>
+ <body class="palette-primary-blue-grey palette-accent-light-blue">
+
+
+
+
+<div class="backdrop">
+ <div class="backdrop-paper"></div>
+</div>
+
+<input class="toggle" type="checkbox" id="toggle-drawer">
+<input class="toggle" type="checkbox" id="toggle-search">
+<label class="toggle-button overlay" for="toggle-drawer"></label>
+
+<header class="header">
+ <nav aria-label="Header">
+ <div class="bar default">
+ <div class="button button-menu" role="button" aria-label="Menu">
+ <label class="toggle-button icon icon-menu" for="toggle-drawer">
+ <span></span>
+ </label>
+ </div>
+ <div class="stretch">
+ <div class="title">
+ Download
+ </div>
+ </div>
+
+
+ <div class="button button-twitter" role="button" aria-label="Twitter">
+ <a href="https://twitter.com/eclipse_mita" title="@eclipse_mita on Twitter" target="_blank" class="toggle-button icon icon-twitter"></a>
+ </div>
+
+
+
+ <div class="button button-github" role="button" aria-label="GitHub">
+ <a href="https://github.com/eclipse/mita" title="@eclipse/mita on GitHub" target="_blank" class="toggle-button icon icon-github"></a>
+ </div>
+
+
+
+ </div>
+ <div class="bar search">
+ <div class="button button-close" role="button" aria-label="Close">
+ <label class="toggle-button icon icon-back" for="toggle-search"></label>
+ </div>
+ <div class="stretch">
+ <div class="field">
+ <input class="query" type="text" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck>
+ </div>
+ </div>
+ <div class="button button-reset" role="button" aria-label="Search">
+ <button class="toggle-button icon icon-close" id="reset-search"></button>
+ </div>
+ </div>
+</nav>
+</header>
+
+<main class="main">
+ <div class="drawer">
+ <nav aria-label="Navigation">
+ <a href="../" class="project">
+ <div class="banner">
+
+ <div class="logo">
+ <img src="../images/mita.svg">
+ </div>
+
+ <div class="name">
+ <strong>Eclipse Mita </strong>
+
+ </div>
+ </div>
+ </a>
+
+ <div class="scrollable">
+ <div class="wrapper">
+
+
+ <div class="toc">
+
+ <ul>
+
+
+
+
+
+<li>
+
+
+
+
+
+<a title="Download" href="http://github.com/eclipse/mita">
+
+ Download
+</a>
+
+
+
+
+</li>
+
+
+
+<li>
+
+
+
+
+
+<a title="Concepts" href="../concepts/">
+
+ Concepts
+</a>
+
+
+
+
+</li>
+
+
+
+<li>
+
+ <span class="section">Language</span>
+ <ul>
+
+
+
+
+
+
+<a title="Introduction" href="../language/introduction/">
+
+ Introduction
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Basics" href="../language/basics/">
+
+ Basics
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Packages" href="../language/packages/">
+
+ Packages
+</a>
+
+
+
+
+
+
+
+
+
+<a title="System Setup" href="../language/setup/">
+
+ System Setup
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Types" href="../language/types/">
+
+ Types
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Arrays" href="../language/arrays/">
+
+ Arrays
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Functions" href="../language/functions/">
+
+ Functions
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Foreign Function Interface" href="../language/foreignfunctioninterface/">
+
+ Foreign Function Interface
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Events" href="../language/events/">
+
+ Events
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Exceptions" href="../language/exceptions/">
+
+ Exceptions
+</a>
+
+
+
+
+ </ul>
+
+</li>
+
+
+
+<li>
+
+ <span class="section">Platforms</span>
+ <ul>
+
+
+
+
+
+
+<a title="XDK110" href="../platforms/xdk110/">
+
+ XDK110
+</a>
+
+
+
+
+ </ul>
+
+</li>
+
+
+ </ul>
+
+
+
+ </div>
+ </div>
+ </div>
+</nav>
+
+ </div>
+
+ <article class="article">
+ <div class="wrapper">
+ <h1>Download </h1>
+
+ <p>TBD</p>
+
+
+ <aside class="copyright" role="note">
+
+ © 2018 The Eclipse Mita Project –
+
+ Documentation built with
+ <a href="https://www.gohugo.io" target="_blank">Hugo</a>
+ using the
+ <a href="http://github.com/digitalcraftsman/hugo-material-docs" target="_blank">Material</a> theme.
+ </aside>
+
+ <footer class="footer">
+
+
+<nav class="pagination" aria-label="Footer">
+ <div class="previous">
+
+ <a href="../language/exceptions/" title="Exceptions">
+ <span class="direction">
+ Previous
+ </span>
+ <div class="page">
+ <div class="button button-previous" role="button" aria-label="Previous">
+ <i class="icon icon-back"></i>
+ </div>
+ <div class="stretch">
+ <div class="title">
+ Exceptions
+ </div>
+ </div>
+ </div>
+ </a>
+
+ </div>
+
+ <div class="next">
+
+ <a href="../concepts/" title="Concepts">
+ <span class="direction">
+ Next
+ </span>
+ <div class="page">
+ <div class="stretch">
+ <div class="title">
+ Concepts
+ </div>
+ </div>
+ <div class="button button-next" role="button" aria-label="Next">
+ <i class="icon icon-forward"></i>
+ </div>
+ </div>
+ </a>
+
+ </div>
+</nav>
+
+
+
+
+
+ </footer>
+ </div>
+ </article>
+
+ <div class="results" role="status" aria-live="polite">
+ <div class="scrollable">
+ <div class="wrapper">
+ <div class="meta"></div>
+ <div class="list"></div>
+ </div>
+ </div>
+ </div>
+</main>
+
+ <script>
+
+ var base_url = '';
+ var repo_id = '';
+
+ </script>
+
+ <script src="../javascripts/application.js"></script>
+
+
+ <script>
+ /* Add headers to scrollspy */
+ var headers = document.getElementsByTagName("h2");
+ var scrollspy = document.getElementById('scrollspy');
+
+ if(scrollspy) {
+ if(headers.length > 0) {
+ for(var i = 0; i < headers.length; i++) {
+ var li = document.createElement("li");
+ li.setAttribute("class", "anchor");
+
+ var a = document.createElement("a");
+ a.setAttribute("href", "#" + headers[i].id);
+ a.setAttribute("title", headers[i].innerHTML);
+ a.innerHTML = headers[i].innerHTML;
+
+ li.appendChild(a)
+ scrollspy.appendChild(li);
+ }
+ } else {
+ scrollspy.parentElement.removeChild(scrollspy)
+ }
+
+
+ /* Add permanent link next to the headers */
+ var headers = document.querySelectorAll("h1, h2, h3, h4, h5, h6");
+
+ for(var i = 0; i < headers.length; i++) {
+ var a = document.createElement("a");
+ a.setAttribute("class", "headerlink");
+ a.setAttribute("href", "#" + headers[i].id);
+ a.setAttribute("title", "Permanent link")
+ a.innerHTML = "#";
+ headers[i].appendChild(a);
+ }
+ }
+ </script>
+
+
+
+ <script src="//cdnjs.cloudflare.com/ajax/libs/highlight.js/9.8.0/highlight.min.js"></script>
+ <script>hljs.initHighlightingOnLoad();</script>
+ </body>
+</html>
+
diff --git a/faq/index.html b/faq/index.html
new file mode 100644
index 0000000..5043e39
--- /dev/null
+++ b/faq/index.html
@@ -0,0 +1,513 @@
+<!DOCTYPE html>
+
+
+
+
+ <html class="no-js">
+
+ <head lang="en-us">
+ <meta charset="utf-8">
+ <meta name="viewport" content="width=device-width,user-scalable=no,initial-scale=1,maximum-scale=1">
+ <meta http-equiv="X-UA-Compatible" content="IE=10" />
+ <title>Frequently Asked Questions - Eclipse Mita</title>
+ <meta name="generator" content="Hugo 0.42.1" />
+
+
+ <meta name="description" content="The documentation of Eclipse Mita.">
+
+ <link rel="canonical" href="../faq/">
+
+
+ <meta property="og:url" content="/faq/">
+ <meta property="og:title" content="Eclipse Mita">
+ <meta property="og:image" content="/images/mita.svg">
+ <meta name="apple-mobile-web-app-title" content="Eclipse Mita">
+ <meta name="apple-mobile-web-app-capable" content="yes">
+ <meta name="apple-mobile-web-app-status-bar-style" content="black-translucent">
+
+ <link rel="shortcut icon" type="image/x-icon" href="../images/favicon.ico">
+ <link rel="icon" type="image/x-icon" href="../images/favicon.ico">
+
+ <style>
+ @font-face {
+ font-family: 'Icon';
+ src: url('/fonts/icon.eot');
+ src: url('/fonts/icon.eot')
+ format('embedded-opentype'),
+ url('/fonts/icon.woff')
+ format('woff'),
+ url('/fonts/icon.ttf')
+ format('truetype'),
+ url('/fonts/icon.svg')
+ format('svg');
+ font-weight: normal;
+ font-style: normal;
+ }
+ </style>
+
+ <link rel="stylesheet" href="../stylesheets/application.css">
+ <link rel="stylesheet" href="../stylesheets/temporary.css">
+ <link rel="stylesheet" href="../stylesheets/palettes.css">
+ <link rel="stylesheet" href="../stylesheets/highlight/highlight.css">
+
+
+
+
+ <link rel="stylesheet" href="//fonts.googleapis.com/css?family=Ubuntu:400,700|Ubuntu+Mono">
+ <style>
+ body, input {
+ font-family: 'Ubuntu', Helvetica, Arial, sans-serif;
+ }
+ pre, code {
+ font-family: 'Ubuntu Mono', 'Courier New', 'Courier', monospace;
+ }
+ </style>
+
+
+ <link rel="stylesheet" href="../css/custom.css">
+
+ <script src="../javascripts/modernizr.js"></script>
+
+
+
+ </head>
+ <body class="palette-primary-blue-grey palette-accent-light-blue">
+
+
+
+
+<div class="backdrop">
+ <div class="backdrop-paper"></div>
+</div>
+
+<input class="toggle" type="checkbox" id="toggle-drawer">
+<input class="toggle" type="checkbox" id="toggle-search">
+<label class="toggle-button overlay" for="toggle-drawer"></label>
+
+<header class="header">
+ <nav aria-label="Header">
+ <div class="bar default">
+ <div class="button button-menu" role="button" aria-label="Menu">
+ <label class="toggle-button icon icon-menu" for="toggle-drawer">
+ <span></span>
+ </label>
+ </div>
+ <div class="stretch">
+ <div class="title">
+ Frequently Asked Questions
+ </div>
+ </div>
+
+
+ <div class="button button-twitter" role="button" aria-label="Twitter">
+ <a href="https://twitter.com/eclipse_mita" title="@eclipse_mita on Twitter" target="_blank" class="toggle-button icon icon-twitter"></a>
+ </div>
+
+
+
+ <div class="button button-github" role="button" aria-label="GitHub">
+ <a href="https://github.com/eclipse/mita" title="@eclipse/mita on GitHub" target="_blank" class="toggle-button icon icon-github"></a>
+ </div>
+
+
+
+ </div>
+ <div class="bar search">
+ <div class="button button-close" role="button" aria-label="Close">
+ <label class="toggle-button icon icon-back" for="toggle-search"></label>
+ </div>
+ <div class="stretch">
+ <div class="field">
+ <input class="query" type="text" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck>
+ </div>
+ </div>
+ <div class="button button-reset" role="button" aria-label="Search">
+ <button class="toggle-button icon icon-close" id="reset-search"></button>
+ </div>
+ </div>
+</nav>
+</header>
+
+<main class="main">
+ <div class="drawer">
+ <nav aria-label="Navigation">
+ <a href="../" class="project">
+ <div class="banner">
+
+ <div class="logo">
+ <img src="../images/mita.svg">
+ </div>
+
+ <div class="name">
+ <strong>Eclipse Mita </strong>
+
+ </div>
+ </div>
+ </a>
+
+ <div class="scrollable">
+ <div class="wrapper">
+
+
+ <div class="toc">
+
+ <ul>
+
+
+
+
+
+<li>
+
+
+
+
+
+<a title="Download" href="http://github.com/eclipse/mita">
+
+ Download
+</a>
+
+
+
+
+</li>
+
+
+
+<li>
+
+
+
+
+
+<a title="Concepts" href="../concepts/">
+
+ Concepts
+</a>
+
+
+
+
+</li>
+
+
+
+<li>
+
+ <span class="section">Language</span>
+ <ul>
+
+
+
+
+
+
+<a title="Introduction" href="../language/introduction/">
+
+ Introduction
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Basics" href="../language/basics/">
+
+ Basics
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Packages" href="../language/packages/">
+
+ Packages
+</a>
+
+
+
+
+
+
+
+
+
+<a title="System Setup" href="../language/setup/">
+
+ System Setup
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Types" href="../language/types/">
+
+ Types
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Arrays" href="../language/arrays/">
+
+ Arrays
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Functions" href="../language/functions/">
+
+ Functions
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Foreign Function Interface" href="../language/foreignfunctioninterface/">
+
+ Foreign Function Interface
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Events" href="../language/events/">
+
+ Events
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Exceptions" href="../language/exceptions/">
+
+ Exceptions
+</a>
+
+
+
+
+ </ul>
+
+</li>
+
+
+
+<li>
+
+ <span class="section">Platforms</span>
+ <ul>
+
+
+
+
+
+
+<a title="XDK110" href="../platforms/xdk110/">
+
+ XDK110
+</a>
+
+
+
+
+ </ul>
+
+</li>
+
+
+ </ul>
+
+
+
+ </div>
+ </div>
+ </div>
+</nav>
+
+ </div>
+
+ <article class="article">
+ <div class="wrapper">
+ <h1>Frequently Asked Questions </h1>
+
+
+
+<h3 id="who-is-builds-mita">Who is builds Mita?</h3>
+
+<p>BCDS</p>
+
+<h3 id="why-would-you-invent-a-new-programming-language">Why would you invent a new programming language?</h3>
+
+<p>Because nothing that was out there was suitable.</p>
+
+
+ <aside class="copyright" role="note">
+
+ © 2018 The Eclipse Mita Project –
+
+ Documentation built with
+ <a href="https://www.gohugo.io" target="_blank">Hugo</a>
+ using the
+ <a href="http://github.com/digitalcraftsman/hugo-material-docs" target="_blank">Material</a> theme.
+ </aside>
+
+ <footer class="footer">
+
+
+<nav class="pagination" aria-label="Footer">
+ <div class="previous">
+
+ <a href="../language/setup/" title="System Setup">
+ <span class="direction">
+ Previous
+ </span>
+ <div class="page">
+ <div class="button button-previous" role="button" aria-label="Previous">
+ <i class="icon icon-back"></i>
+ </div>
+ <div class="stretch">
+ <div class="title">
+ System Setup
+ </div>
+ </div>
+ </div>
+ </a>
+
+ </div>
+
+ <div class="next">
+
+ <a href="../language/types/" title="Types">
+ <span class="direction">
+ Next
+ </span>
+ <div class="page">
+ <div class="stretch">
+ <div class="title">
+ Types
+ </div>
+ </div>
+ <div class="button button-next" role="button" aria-label="Next">
+ <i class="icon icon-forward"></i>
+ </div>
+ </div>
+ </a>
+
+ </div>
+</nav>
+
+
+
+
+
+ </footer>
+ </div>
+ </article>
+
+ <div class="results" role="status" aria-live="polite">
+ <div class="scrollable">
+ <div class="wrapper">
+ <div class="meta"></div>
+ <div class="list"></div>
+ </div>
+ </div>
+ </div>
+</main>
+
+ <script>
+
+ var base_url = '';
+ var repo_id = '';
+
+ </script>
+
+ <script src="../javascripts/application.js"></script>
+
+
+ <script>
+ /* Add headers to scrollspy */
+ var headers = document.getElementsByTagName("h2");
+ var scrollspy = document.getElementById('scrollspy');
+
+ if(scrollspy) {
+ if(headers.length > 0) {
+ for(var i = 0; i < headers.length; i++) {
+ var li = document.createElement("li");
+ li.setAttribute("class", "anchor");
+
+ var a = document.createElement("a");
+ a.setAttribute("href", "#" + headers[i].id);
+ a.setAttribute("title", headers[i].innerHTML);
+ a.innerHTML = headers[i].innerHTML;
+
+ li.appendChild(a)
+ scrollspy.appendChild(li);
+ }
+ } else {
+ scrollspy.parentElement.removeChild(scrollspy)
+ }
+
+
+ /* Add permanent link next to the headers */
+ var headers = document.querySelectorAll("h1, h2, h3, h4, h5, h6");
+
+ for(var i = 0; i < headers.length; i++) {
+ var a = document.createElement("a");
+ a.setAttribute("class", "headerlink");
+ a.setAttribute("href", "#" + headers[i].id);
+ a.setAttribute("title", "Permanent link")
+ a.innerHTML = "#";
+ headers[i].appendChild(a);
+ }
+ }
+ </script>
+
+
+
+ <script src="//cdnjs.cloudflare.com/ajax/libs/highlight.js/9.8.0/highlight.min.js"></script>
+ <script>hljs.initHighlightingOnLoad();</script>
+ </body>
+</html>
+
diff --git a/fonts/icon.eot b/fonts/icon.eot
new file mode 100755
index 0000000..8f81638
--- /dev/null
+++ b/fonts/icon.eot
Binary files differ
diff --git a/fonts/icon.svg b/fonts/icon.svg
new file mode 100755
index 0000000..86250e7
--- /dev/null
+++ b/fonts/icon.svg
@@ -0,0 +1,22 @@
+<?xml version="1.0" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd" >
+<svg xmlns="http://www.w3.org/2000/svg">
+<metadata>Generated by IcoMoon</metadata>
+<defs>
+<font id="icon" horiz-adv-x="1024">
+<font-face units-per-em="1024" ascent="960" descent="-64" />
+<missing-glyph horiz-adv-x="1024" />
+<glyph unicode=" " horiz-adv-x="512" d="" />
+<glyph unicode="" glyph-name="search" d="M661.333 341.334h-33.92l-11.733 11.733c41.813 48.427 66.987 111.36 66.987 180.267 0 153.173-124.16 277.333-277.333 277.333s-277.333-124.16-277.333-277.333 124.16-277.333 277.333-277.333c68.907 0 131.84 25.173 180.267 66.773l11.733-11.733v-33.707l213.333-212.907 63.573 63.573-212.907 213.333zM405.333 341.334c-106.027 0-192 85.973-192 192s85.973 192 192 192 192-85.973 192-192-85.973-192-192-192z" />
+<glyph unicode="" glyph-name="arrow-back" d="M853.333 469.334h-519.253l238.293 238.293-60.373 60.373-341.333-341.333 341.333-341.333 60.373 60.373-238.293 238.293h519.253v85.333z" />
+<glyph unicode="" glyph-name="chevron-right" d="M426.667 682.667l-60.373-60.373 195.627-195.627-195.627-195.627 60.373-60.373 256 256z" />
+<glyph unicode="" glyph-name="close" d="M810.667 664.96l-60.373 60.373-238.293-238.293-238.293 238.293-60.373-60.373 238.293-238.293-238.293-238.293 60.373-60.373 238.293 238.293 238.293-238.293 60.373 60.373-238.293 238.293z" />
+<glyph unicode="" glyph-name="menu" d="M128 170.667h768v85.333h-768v-85.333zM128 384h768v85.333h-768v-85.333zM128 682.667v-85.333h768v85.333h-768z" />
+<glyph unicode="" glyph-name="arrow-forward" d="M512 768l-60.373-60.373 238.293-238.293h-519.253v-85.333h519.253l-238.293-238.293 60.373-60.373 341.333 341.333z" />
+<glyph unicode="" glyph-name="twitter" d="M1024 744.249c-37.676-16.708-78.164-28.002-120.66-33.080 43.372 26 76.686 67.17 92.372 116.23-40.596-24.078-85.556-41.56-133.41-50.98-38.32 40.83-92.922 66.34-153.346 66.34-116.022 0-210.088-94.058-210.088-210.078 0-16.466 1.858-32.5 5.44-47.878-174.6 8.764-329.402 92.4-433.018 219.506-18.084-31.028-28.446-67.116-28.446-105.618 0-72.888 37.088-137.192 93.46-174.866-34.438 1.092-66.832 10.542-95.154 26.278-0.020-0.876-0.020-1.756-0.020-2.642 0-101.788 72.418-186.696 168.522-206-17.626-4.8-36.188-7.372-55.348-7.372-13.538 0-26.698 1.32-39.528 3.772 26.736-83.46 104.32-144.206 196.252-145.896-71.9-56.35-162.486-89.934-260.916-89.934-16.958 0-33.68 0.994-50.116 2.94 92.972-59.61 203.402-94.394 322.042-94.394 386.422 0 597.736 320.124 597.736 597.744 0 9.108-0.206 18.168-0.61 27.18 41.056 29.62 76.672 66.62 104.836 108.748z" />
+<glyph unicode="" glyph-name="github" d="M512.008 926.025c-282.738 0-512.008-229.218-512.008-511.998 0-226.214 146.704-418.132 350.136-485.836 25.586-4.738 34.992 11.11 34.992 24.632 0 12.204-0.48 52.542-0.696 95.324-142.448-30.976-172.504 60.41-172.504 60.41-23.282 59.176-56.848 74.916-56.848 74.916-46.452 31.778 3.51 31.124 3.51 31.124 51.4-3.61 78.476-52.766 78.476-52.766 45.672-78.27 119.776-55.64 149.004-42.558 4.588 33.086 17.852 55.68 32.506 68.464-113.73 12.942-233.276 56.85-233.276 253.032 0 55.898 20.004 101.574 52.76 137.428-5.316 12.9-22.854 64.972 4.952 135.5 0 0 43.006 13.752 140.84-52.49 40.836 11.348 84.636 17.036 128.154 17.234 43.502-0.198 87.336-5.886 128.256-17.234 97.734 66.244 140.656 52.49 140.656 52.49 27.872-70.528 10.35-122.6 5.036-135.5 32.82-35.856 52.694-81.532 52.694-137.428 0-196.654-119.778-239.95-233.79-252.624 18.364-15.89 34.724-47.046 34.724-94.812 0-68.508-0.596-123.644-0.596-140.508 0-13.628 9.222-29.594 35.172-24.566 203.322 67.776 349.842 259.626 349.842 485.768 0 282.78-229.234 511.998-511.992 511.998z" />
+<glyph unicode="" glyph-name="download" d="M810.667 554.667h-170.667v256h-256v-256h-170.667l298.667-298.667 298.667 298.667zM213.333 170.667v-85.333h597.333v85.333h-597.333z" />
+<glyph unicode="" glyph-name="star" d="M512 201.814l263.68-159.147-69.973 299.947 232.96 201.813-306.773 26.027-119.893 282.88-119.893-282.88-306.773-26.027 232.96-201.813-69.973-299.947z" />
+<glyph unicode="" glyph-name="warning" d="M554 340.667v172h-84v-172h84zM554 170.667v86h-84v-86h84zM42 42.667l470 810 470-810h-940z" />
+<glyph unicode="" glyph-name="hint" d="M614 682.667h240v-426h-300l-16 84h-240v-298h-84v726h384z" />
+</font></defs></svg>
\ No newline at end of file
diff --git a/fonts/icon.ttf b/fonts/icon.ttf
new file mode 100755
index 0000000..b5ab560
--- /dev/null
+++ b/fonts/icon.ttf
Binary files differ
diff --git a/fonts/icon.woff b/fonts/icon.woff
new file mode 100755
index 0000000..ed0f20d
--- /dev/null
+++ b/fonts/icon.woff
Binary files differ
diff --git a/images/colors.png b/images/colors.png
new file mode 100644
index 0000000..45e4b60
--- /dev/null
+++ b/images/colors.png
Binary files differ
diff --git a/images/favicon.ico b/images/favicon.ico
new file mode 100644
index 0000000..e85006a
--- /dev/null
+++ b/images/favicon.ico
Binary files differ
diff --git a/images/logo.png b/images/logo.png
new file mode 100644
index 0000000..573aca1
--- /dev/null
+++ b/images/logo.png
Binary files differ
diff --git a/images/mita.svg b/images/mita.svg
new file mode 100644
index 0000000..880b66f
--- /dev/null
+++ b/images/mita.svg
@@ -0,0 +1,17 @@
+<?xml version="1.0" standalone="no"?>
+<!-- Generator: Gravit.io -->
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" style="isolation:isolate" viewBox="0 0 500 500" width="500" height="500">
+ <defs>
+ <clipPath id="_clipPath_VuNucpW7cQwLtTTU5grk9Tkq80f6x7FU">
+ <rect width="500" height="500" />
+ </clipPath>
+ </defs>
+ <g clip-path="url(#_clipPath_VuNucpW7cQwLtTTU5grk9Tkq80f6x7FU)">
+ <rect x="53" y="98" width="401" height="323" transform="matrix(1,0,0,1,0,0)" fill="rgb(255,255,255)" />
+ <linearGradient id="_lgradient_7" x1="92.83340056514918%" y1="93.48144566964737%" x2="4.566034411302978%" y2="3.8780185622426133%">
+ <stop offset="0%" stop-opacity="1" style="stop-color:#FFC848" />
+ <stop offset="99.99999999999999%" stop-opacity="1" style="stop-color:#1EC4B4" />
+ </linearGradient>
+ <path d=" M 67.559 10 C 35.904 10 10 35.898 10 67.546 L 10 432.448 C 10 464.102 35.904 490 67.559 490 L 432.454 490 C 464.102 490 490.006 464.102 490.006 432.448 L 490.006 67.546 C 490.006 35.898 464.102 10 432.454 10 L 67.559 10 M 141.765 145.628 C 138.877 145.628 136.279 146.785 134.422 148.642 L 134.368 148.696 C 132.505 150.559 131.348 153.157 131.348 156.045 L 131.348 226.172 C 131.348 235.221 128.086 243.546 122.685 250.008 C 128.086 256.477 131.348 264.796 131.348 273.844 L 131.348 343.972 C 131.348 346.859 132.505 349.464 134.368 351.32 L 134.422 351.375 C 136.279 353.231 138.877 354.389 141.765 354.389 L 141.765 381.227 C 131.565 381.227 122.269 377.043 115.499 370.298 L 115.445 370.243 C 108.699 363.474 104.509 354.172 104.509 343.972 L 104.509 273.844 C 104.509 270.993 103.334 268.389 101.447 266.496 C 99.554 264.603 96.95 263.427 94.099 263.427 L 94.099 236.589 C 96.98 236.589 99.584 235.432 101.447 233.569 L 101.447 233.521 C 103.334 231.628 104.509 229.024 104.509 226.172 L 104.509 156.045 C 104.509 145.845 108.699 136.549 115.445 129.779 L 115.499 129.725 C 122.269 122.979 131.565 118.79 141.765 118.79 L 141.765 145.628 M 67.559 10 M 358.952 118.792 C 369.152 118.792 378.454 122.982 385.218 129.721 L 385.272 129.776 C 392.018 136.545 396.207 145.847 396.207 156.041 L 396.207 226.175 C 396.207 229.026 397.383 231.63 399.27 233.517 L 399.27 233.571 C 401.138 235.434 403.737 236.592 406.618 236.592 L 406.618 263.43 C 403.773 263.43 401.163 264.605 399.27 266.492 C 397.383 268.391 396.207 270.995 396.207 273.841 L 396.207 343.974 C 396.207 354.168 392.018 363.47 385.272 370.24 L 385.218 370.294 C 378.454 377.04 369.152 381.229 358.952 381.229 L 358.952 354.391 C 361.84 354.391 364.438 353.234 366.301 351.377 L 366.349 351.323 C 368.212 349.46 369.369 346.862 369.369 343.974 L 369.369 273.841 C 369.369 264.792 372.63 256.473 378.032 250.011 C 372.63 243.542 369.369 235.223 369.369 226.175 L 369.369 156.041 C 369.369 153.159 368.212 150.561 366.349 148.699 L 366.301 148.644 C 364.438 146.788 361.84 145.63 358.952 145.63 L 358.952 118.792 M 67.559 10 Z M 146.594 168.764 L 249.432 247.259 L 352.625 168.499 L 352.625 202.197 L 249.432 280.963 L 146.594 202.462 L 146.594 168.764 Z " fill="url(#_lgradient_7)" />
+ </g>
+</svg>
diff --git a/images/screen.png b/images/screen.png
new file mode 100644
index 0000000..cb10504
--- /dev/null
+++ b/images/screen.png
Binary files differ
diff --git a/index.html b/index.html
new file mode 100644
index 0000000..afc7251
--- /dev/null
+++ b/index.html
@@ -0,0 +1,464 @@
+<!DOCTYPE html>
+
+
+
+
+ <html class="no-js">
+
+ <head lang="en-us">
+ <meta charset="utf-8">
+ <meta name="viewport" content="width=device-width,user-scalable=no,initial-scale=1,maximum-scale=1">
+ <meta http-equiv="X-UA-Compatible" content="IE=10" />
+ <title>Eclipse Mita</title>
+ <meta name="generator" content="Hugo 0.42.1" />
+
+
+ <meta name="description" content="The documentation of Eclipse Mita.">
+
+ <link rel="canonical" href="./">
+
+
+ <meta property="og:url" content="/">
+ <meta property="og:title" content="Eclipse Mita">
+ <meta property="og:image" content="/images/mita.svg">
+ <meta name="apple-mobile-web-app-title" content="Eclipse Mita">
+ <meta name="apple-mobile-web-app-capable" content="yes">
+ <meta name="apple-mobile-web-app-status-bar-style" content="black-translucent">
+
+ <link rel="shortcut icon" type="image/x-icon" href="./images/favicon.ico">
+ <link rel="icon" type="image/x-icon" href="./images/favicon.ico">
+
+ <style>
+ @font-face {
+ font-family: 'Icon';
+ src: url('/fonts/icon.eot');
+ src: url('/fonts/icon.eot')
+ format('embedded-opentype'),
+ url('/fonts/icon.woff')
+ format('woff'),
+ url('/fonts/icon.ttf')
+ format('truetype'),
+ url('/fonts/icon.svg')
+ format('svg');
+ font-weight: normal;
+ font-style: normal;
+ }
+ </style>
+
+ <link rel="stylesheet" href="./stylesheets/application.css">
+ <link rel="stylesheet" href="./stylesheets/temporary.css">
+ <link rel="stylesheet" href="./stylesheets/palettes.css">
+ <link rel="stylesheet" href="./stylesheets/highlight/highlight.css">
+
+
+
+
+ <link rel="stylesheet" href="//fonts.googleapis.com/css?family=Ubuntu:400,700|Ubuntu+Mono">
+ <style>
+ body, input {
+ font-family: 'Ubuntu', Helvetica, Arial, sans-serif;
+ }
+ pre, code {
+ font-family: 'Ubuntu Mono', 'Courier New', 'Courier', monospace;
+ }
+ </style>
+
+
+ <link rel="stylesheet" href="./css/custom.css">
+
+ <script src="./javascripts/modernizr.js"></script>
+
+
+ <link href="./index.xml" rel="alternate" type="application/rss+xml" title="Eclipse Mita" />
+ <link href="./index.xml" rel="feed" type="application/rss+xml" title="Eclipse Mita" />
+
+
+ </head>
+ <body class="palette-primary-blue-grey palette-accent-light-blue">
+
+
+
+
+<div class="backdrop">
+ <div class="backdrop-paper"></div>
+</div>
+
+<input class="toggle" type="checkbox" id="toggle-drawer">
+<input class="toggle" type="checkbox" id="toggle-search">
+<label class="toggle-button overlay" for="toggle-drawer"></label>
+
+<header class="header">
+ <nav aria-label="Header">
+ <div class="bar default">
+ <div class="button button-menu" role="button" aria-label="Menu">
+ <label class="toggle-button icon icon-menu" for="toggle-drawer">
+ <span></span>
+ </label>
+ </div>
+ <div class="stretch">
+ <div class="title">
+ Eclipse Mita
+ </div>
+ </div>
+
+
+ <div class="button button-twitter" role="button" aria-label="Twitter">
+ <a href="https://twitter.com/eclipse_mita" title="@eclipse_mita on Twitter" target="_blank" class="toggle-button icon icon-twitter"></a>
+ </div>
+
+
+
+ <div class="button button-github" role="button" aria-label="GitHub">
+ <a href="https://github.com/eclipse/mita" title="@eclipse/mita on GitHub" target="_blank" class="toggle-button icon icon-github"></a>
+ </div>
+
+
+
+ </div>
+ <div class="bar search">
+ <div class="button button-close" role="button" aria-label="Close">
+ <label class="toggle-button icon icon-back" for="toggle-search"></label>
+ </div>
+ <div class="stretch">
+ <div class="field">
+ <input class="query" type="text" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck>
+ </div>
+ </div>
+ <div class="button button-reset" role="button" aria-label="Search">
+ <button class="toggle-button icon icon-close" id="reset-search"></button>
+ </div>
+ </div>
+</nav>
+</header>
+
+<main class="main">
+ <div class="drawer">
+ <nav aria-label="Navigation">
+ <a href="./" class="project">
+ <div class="banner">
+
+ <div class="logo">
+ <img src="./images/mita.svg">
+ </div>
+
+ <div class="name">
+ <strong>Eclipse Mita </strong>
+
+ </div>
+ </div>
+ </a>
+
+ <div class="scrollable">
+ <div class="wrapper">
+
+
+ <div class="toc">
+
+ <ul>
+
+
+
+
+
+<li>
+
+
+
+
+
+<a title="Download" href="http://github.com/eclipse/mita">
+
+ Download
+</a>
+
+
+
+
+</li>
+
+
+
+<li>
+
+
+
+
+
+<a title="Concepts" href="./concepts/">
+
+ Concepts
+</a>
+
+
+
+
+</li>
+
+
+
+<li>
+
+ <span class="section">Language</span>
+ <ul>
+
+
+
+
+
+
+<a title="Introduction" href="./language/introduction/">
+
+ Introduction
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Basics" href="./language/basics/">
+
+ Basics
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Packages" href="./language/packages/">
+
+ Packages
+</a>
+
+
+
+
+
+
+
+
+
+<a title="System Setup" href="./language/setup/">
+
+ System Setup
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Types" href="./language/types/">
+
+ Types
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Arrays" href="./language/arrays/">
+
+ Arrays
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Functions" href="./language/functions/">
+
+ Functions
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Foreign Function Interface" href="./language/foreignfunctioninterface/">
+
+ Foreign Function Interface
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Events" href="./language/events/">
+
+ Events
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Exceptions" href="./language/exceptions/">
+
+ Exceptions
+</a>
+
+
+
+
+ </ul>
+
+</li>
+
+
+
+<li>
+
+ <span class="section">Platforms</span>
+ <ul>
+
+
+
+
+
+
+<a title="XDK110" href="./platforms/xdk110/">
+
+ XDK110
+</a>
+
+
+
+
+ </ul>
+
+</li>
+
+
+ </ul>
+
+
+
+ </div>
+ </div>
+ </div>
+</nav>
+
+ </div>
+
+ <article class="article">
+ <div class="wrapper">
+ <div style="width:100%; text-align:center">
+ <img src="images/mita.svg" height="200">
+</div>
+
+<p>Eclipse Mita is a programming language that is focused on making Internet-Of-Things things easier to program, especially for developers without an embedded development background.
+It aims to increase programmer productivity, enables fast exploration of use-cases and tries to make you feel right at home on an embedded device.</p>
+<div class="highlight"><pre class="chroma"><code class="language-Typescript" data-lang="Typescript"><span class="kr">package</span> <span class="nx">demo</span><span class="p">;</span>
+<span class="kr">import</span> <span class="nx">platforms</span><span class="p">.</span><span class="nx">xdk110</span><span class="p">;</span>
+
+<span class="nx">setup</span> <span class="nx">smartphone</span> : <span class="kt">BLE</span> <span class="p">{</span>
+ <span class="nx">deviceName</span> <span class="o">=</span> <span class="s2">"HelloWorld"</span><span class="p">;</span>
+ <span class="kd">var</span> <span class="nx">shockDetected</span> <span class="o">=</span> <span class="nx">bool_characteristic</span><span class="p">(</span><span class="nx">UUID</span><span class="o">=</span><span class="mh">0xCAFE</span><span class="p">);</span>
+<span class="p">}</span>
+
+<span class="nx">every</span> <span class="nx">accelerometer</span><span class="p">.</span><span class="nx">activity</span> <span class="p">{</span>
+ <span class="k">if</span><span class="p">(</span><span class="nx">accelerometer</span><span class="p">.</span><span class="nx">magnitude</span><span class="p">.</span><span class="nx">read</span><span class="p">()</span> <span class="o">></span> <span class="mi">5000</span><span class="p">)</span> <span class="p">{</span>
+ <span class="nx">smartphone</span><span class="p">.</span><span class="nx">shockDetected</span><span class="p">.</span><span class="nx">write</span><span class="p">(</span><span class="kc">true</span><span class="p">);</span>
+ <span class="p">}</span>
+<span class="p">}</span></code></pre></div>
+<p>These ten lines above implement a Bluetooth-enabled shock detector. In Mita you don’t have to setup things on your system, everything ships with sensible defaults. You can directly react to events generated by sensors, connectivity (e.g. Bluetooth or WLAN) and time itself.
+Its syntax was designed to make you feel right at home.</p>
+
+ </div>
+ </article>
+
+ <div class="results" role="status" aria-live="polite">
+ <div class="scrollable">
+ <div class="wrapper">
+ <div class="meta"></div>
+ <div class="list"></div>
+ </div>
+ </div>
+ </div>
+</main>
+
+ <script>
+
+ var base_url = '';
+ var repo_id = '';
+
+ </script>
+
+ <script src="./javascripts/application.js"></script>
+
+
+ <script>
+ /* Add headers to scrollspy */
+ var headers = document.getElementsByTagName("h2");
+ var scrollspy = document.getElementById('scrollspy');
+
+ if(scrollspy) {
+ if(headers.length > 0) {
+ for(var i = 0; i < headers.length; i++) {
+ var li = document.createElement("li");
+ li.setAttribute("class", "anchor");
+
+ var a = document.createElement("a");
+ a.setAttribute("href", "#" + headers[i].id);
+ a.setAttribute("title", headers[i].innerHTML);
+ a.innerHTML = headers[i].innerHTML;
+
+ li.appendChild(a)
+ scrollspy.appendChild(li);
+ }
+ } else {
+ scrollspy.parentElement.removeChild(scrollspy)
+ }
+
+
+ /* Add permanent link next to the headers */
+ var headers = document.querySelectorAll("h1, h2, h3, h4, h5, h6");
+
+ for(var i = 0; i < headers.length; i++) {
+ var a = document.createElement("a");
+ a.setAttribute("class", "headerlink");
+ a.setAttribute("href", "#" + headers[i].id);
+ a.setAttribute("title", "Permanent link")
+ a.innerHTML = "#";
+ headers[i].appendChild(a);
+ }
+ }
+ </script>
+
+
+
+ <script src="//cdnjs.cloudflare.com/ajax/libs/highlight.js/9.8.0/highlight.min.js"></script>
+ <script>hljs.initHighlightingOnLoad();</script>
+ </body>
+</html>
diff --git a/index.php b/index.php
deleted file mode 100644
index 72ba4c6..0000000
--- a/index.php
+++ /dev/null
@@ -1 +0,0 @@
-<?php header('Location: http://eclipse.org/projects/project.php?id=iot.mita'); ?>
\ No newline at end of file
diff --git a/index.xml b/index.xml
new file mode 100644
index 0000000..7a38fb5
--- /dev/null
+++ b/index.xml
@@ -0,0 +1,156 @@
+<?xml version="1.0" encoding="utf-8" standalone="yes" ?>
+<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom">
+ <channel>
+ <title>Eclipse Mita</title>
+ <link>/</link>
+ <description>Recent content on Eclipse Mita</description>
+ <generator>Hugo -- gohugo.io</generator>
+ <language>en-us</language>
+ <lastBuildDate>Tue, 18 Jul 2017 14:18:49 +0200</lastBuildDate>
+
+ <atom:link href="/index.xml" rel="self" type="application/rss+xml" />
+
+
+ <item>
+ <title>Introduction</title>
+ <link>/language/introduction/</link>
+ <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+
+ <guid>/language/introduction/</guid>
+ <description>Mita is a programming language that is focused on making Internet-Of-Things things easier to program, especially for developers without embedded development background. Its language design and feature-set are meant to make anyone coming from a world of Javascript, Typescript, Java, Swift or Go feel right at home. Compared to C you do not have to care about allocating memory, strings behave naturally, as do arrays. Featuring powerful abstractions and a model-driven system configuration approach we can often tell at compile time if something will not work.</description>
+ </item>
+
+ <item>
+ <title>Basics</title>
+ <link>/language/basics/</link>
+ <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+
+ <guid>/language/basics/</guid>
+ <description>Variables By default, variables in Mita are immutable, which helps us optimize the generated code. However, you can always choose to make variables mutable if you need it. When a variable is immutable, its value has to be set during declaration and cannot be changed afterwards. The following code snippet illustrates the idea (we&rsquo;ve omitted the package and import statements for brevity):
+fn main() { let x = 42; println(`The value of x is ${x}`); x = 64; println(`The value of x is now ${x}`); } When you save this code, you will see an error message Assignment to constant not allowed.</description>
+ </item>
+
+ <item>
+ <title>Packages</title>
+ <link>/language/packages/</link>
+ <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+
+ <guid>/language/packages/</guid>
+ <description>In Mita code is organized in packages, which serve multiple purposes:
+ Divide the namespace: Mita programs have one global namespace per .x file. Unlike Java for example, there are no means to qualify the name of an element. Packages are used to keep this namespace clean. Only things which are explicitly imported from other packages are visible in that namespace. See Importing Packages for more details. Group code: packages are a formidable way to group code which conceptually belongs together.</description>
+ </item>
+
+ <item>
+ <title>System Setup</title>
+ <link>/language/setup/</link>
+ <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+
+ <guid>/language/setup/</guid>
+ <description>System resources have properties which we can configure. For example, an accelerometer has an acceleration range, a filter bandwidth and some power modes which we can change. If we wanted to use Bluetooth for communication we would have to set up the GATT characteristics, device name and advertising interval. If we wanted to connect to a WLAN network, we would have to configure the network name and a preshared key.</description>
+ </item>
+
+ <item>
+ <title>Frequently Asked Questions</title>
+ <link>/faq/</link>
+ <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+
+ <guid>/faq/</guid>
+ <description>Who is builds Mita? BCDS
+Why would you invent a new programming language? Because nothing that was out there was suitable.</description>
+ </item>
+
+ <item>
+ <title>Types</title>
+ <link>/language/types/</link>
+ <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+
+ <guid>/language/types/</guid>
+ <description>Primitive Types We have already seen the basic data types supported by Mita. Primitive types are also called scalar types in other languages, as they contain a single value. Complex types on the other hand represent more than a single value, or are defined by the programmer. There is one type where that distinction is not as clear as it may sound: strings.
+Strings In C there are no strings, but only arrays of characters and some conventions.</description>
+ </item>
+
+ <item>
+ <title>Arrays</title>
+ <link>/language/arrays/</link>
+ <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+
+ <guid>/language/arrays/</guid>
+ <description>Arrays are a fixed-size sequence of objects. In Mita, arrays can hold any type:
+var array1 : array&lt;int32&gt;; struct vec2d { var x : int32; var y : int32; } let array2 : array&lt;vec2d&gt;; Initialization There are multiple ways to initialize and fill arrays:
+let array1 : array&lt;int32&gt; = new array&lt;int32&gt;(size = 10); let array2 : array&lt;int32&gt; = [1,2,3,4]; Length Mita arrays know how long arrays are, unlike C arrays.</description>
+ </item>
+
+ <item>
+ <title>Functions</title>
+ <link>/language/functions/</link>
+ <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+
+ <guid>/language/functions/</guid>
+ <description>Functions play an important role in Mita. They give the language a modern feel through features that go beyond what C has to offer, such as polymorphism and extension methods.
+You have already seen the fn keyword, which allows you to declare new functions. Alternatively you can use function instead of fn if that suits your style better. By convention in Mita functions are named in camel case style. In camel case, words are separated by capital letters and for functions we start with a lower-case one.</description>
+ </item>
+
+ <item>
+ <title>XDK110</title>
+ <link>/platforms/xdk110/</link>
+ <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+
+ <guid>/platforms/xdk110/</guid>
+ <description>The Bosch Cross Domain Development Kit (XDK) is a programmable sensor device for building IoT applications. It contains a wide range of sensors and means of connectivity, is extensible using its extension bus. Due to its versatility it also serves as reference platform for Mita.
+To learn more about the XDK head over to http://xdk.io.
+Sensor: environment (BME280) Configuration Items Name Description optional power_mode : BME280_PowerMode Defaults to BME280_PowerMode.</description>
+ </item>
+
+ <item>
+ <title>Foreign Function Interface</title>
+ <link>/language/foreignfunctioninterface/</link>
+ <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+
+ <guid>/language/foreignfunctioninterface/</guid>
+ <description>Mita transpiles to C code, i.e. the compiler produces C code rather than a binary executable. This begs the question if we can call existing C code from within Mita programs. Such integration of the &ldquo;target language&rdquo; is referred to as foreign function interface (or FFI in short) because the functions we wish to call from within Mita are defined in a foreign language: C. Other languages sport similar concepts, for example TypeScript supports declarations which allow you to use code written in JavaScript (the language TypeScript compiles to).</description>
+ </item>
+
+ <item>
+ <title>Events</title>
+ <link>/language/events/</link>
+ <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+
+ <guid>/language/events/</guid>
+ <description>System resources and time define events. All events can be handled using the every keyword.
+every accelerometer.any_motion { } every 60 seconds { } Time comes in different resolutions:
+ milliseconds seconds minutes hours Most platforms can only define a limited amount of timers. Therefore the number of time event handlers is limited by that amount. Furthermore, since time is a limited resource, especially on embedded devices, events can be handled multiple times.</description>
+ </item>
+
+ <item>
+ <title>Exceptions</title>
+ <link>/language/exceptions/</link>
+ <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+
+ <guid>/language/exceptions/</guid>
+ <description>Exceptions Exceptions are special types defined by the exception keyword:
+exception FooException; Exceptions can be thrown, which returns control flow to the caller. If the exception is not caught by the caller it propagates further. If the exception is never caught it causes a system reset.
+throw FooException; Exceptions can be caught with the familiar try...catch syntax:
+try { throw FooException; } catch(FooException) { println(&#34;Caught FooException&#34;); } Exceptions are implicit, meaning that functions do not have to (and cannot) declare the exceptions they might throw.</description>
+ </item>
+
+ <item>
+ <title>Download</title>
+ <link>/download/</link>
+ <pubDate>Tue, 18 Jul 2017 14:18:49 +0200</pubDate>
+
+ <guid>/download/</guid>
+ <description>TBD</description>
+ </item>
+
+ <item>
+ <title>Concepts</title>
+ <link>/concepts/</link>
+ <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+
+ <guid>/concepts/</guid>
+ <description>Platform TLDR; A platform is the thing you are writing programs for.
+Platforms describe the thing that you are writing software for; this thing is literally the piece of hardware and software platform running on it. You do not have create that platform. Platforms consist of something you can configure (configuration items), something you can read from at runtime (modalities), something you can send and receive data through (signals) and something you can react to (events).</description>
+ </item>
+
+ </channel>
+</rss>
\ No newline at end of file
diff --git a/index_for_custom_site.php b/index_for_custom_site.php
deleted file mode 100644
index a3739bb..0000000
--- a/index_for_custom_site.php
+++ /dev/null
@@ -1,66 +0,0 @@
-<?php
-/*******************************************************************************
- * Copyright (c) 2014 Eclipse Foundation and others.
- * All rights reserved. This program and the accompanying materials
- * are made available under the terms of the Eclipse Public License v1.0
- * which accompanies this distribution, and is available at
- * http://eclipse.org/legal/epl-v10.html
- *
- * Contributors:
- * Christopher Guindon (Eclipse Foundation) - Initial implementation
- *******************************************************************************/
-
- require_once($_SERVER['DOCUMENT_ROOT'] . "/eclipse.org-common/system/app.class.php");
- require_once($_SERVER['DOCUMENT_ROOT'] . "/eclipse.org-common/system/nav.class.php");
- require_once($_SERVER['DOCUMENT_ROOT'] . "/eclipse.org-common/system/menu.class.php");
-
- $App = new App();
- $Nav = new Nav();
- $Menu = new Menu();
-
- # Shared variables/configs for all pages of your website.
- require_once('_projectCommon.php');
-
- # Begin: page-specific settings. Change these.
- $pageTitle = "Starterkit Template";
- $pageKeywords = "Add maximal 20 keywords and seperate them from each other by a comma en a space.";
- $pageAuthor = "Christopher Guindon";
-
- # Initialize custom solstice $variables.
- $variables = array();
-
- # Add classes to <body>. (String)
- $variables['body_classes'] = '';
-
- # Insert custom HTML in the breadcrumb region. (String)
- $variables['breadcrumbs_html'] = "";
-
- # Hide the breadcrumbs. (Bool)
- $variables['hide_breadcrumbs'] = FALSE;
-
- # Insert HTML before the left nav. (String)
- $variables['leftnav_html'] = '';
-
- # Update the main container class (String)
- $variables['main_container_classes'] = 'container';
-
- # Insert HTML after opening the main content container, before the left sidebar. (String)
- $variables['main_container_html'] = '';
-
- # Set Solstice theme variables. (Array)
- $App->setThemeVariables($variables);
-
- # Place your html content in a file called content/en_pagename.php
- ob_start();
- include("content/en_" . $App->getScriptName());
- $html = ob_get_clean();
-
- # Insert extra html before closing </head> tag.
- //$App->AddExtraHtmlHeader('<link rel="stylesheet" type="text/css" href="style.css" media="screen" />');
-
- # Insert script/html before closing </body> tag.
- //$App->AddExtraJSFooter('<script type="text/javascript" src="script.min.js"></script>');
-
- # Generate the web page
- $App->generatePage($theme, $Menu, $Nav, $pageAuthor, $pageKeywords, $pageTitle, $html);
-
diff --git a/javascripts/application.js b/javascripts/application.js
new file mode 100644
index 0000000..1199f2e
--- /dev/null
+++ b/javascripts/application.js
@@ -0,0 +1 @@
+function pegasus(t,e){return e=new XMLHttpRequest,e.open("GET",t),t=[],e.onreadystatechange=e.then=function(n,o,i,r){if(n&&n.call&&(t=[,n,o]),4==e.readyState&&(i=t[0|e.status/200])){try{r=JSON.parse(e.responseText)}catch(s){r=null}i(r,e)}},e.send(),e}if("document"in self&&("classList"in document.createElement("_")?!function(){"use strict";var t=document.createElement("_");if(t.classList.add("c1","c2"),!t.classList.contains("c2")){var e=function(t){var e=DOMTokenList.prototype[t];DOMTokenList.prototype[t]=function(t){var n,o=arguments.length;for(n=0;o>n;n++)t=arguments[n],e.call(this,t)}};e("add"),e("remove")}if(t.classList.toggle("c3",!1),t.classList.contains("c3")){var n=DOMTokenList.prototype.toggle;DOMTokenList.prototype.toggle=function(t,e){return 1 in arguments&&!this.contains(t)==!e?e:n.call(this,t)}}t=null}():!function(t){"use strict";if("Element"in t){var e="classList",n="prototype",o=t.Element[n],i=Object,r=String[n].trim||function(){return this.replace(/^\s+|\s+$/g,"")},s=Array[n].indexOf||function(t){for(var e=0,n=this.length;n>e;e++)if(e in this&&this[e]===t)return e;return-1},a=function(t,e){this.name=t,this.code=DOMException[t],this.message=e},c=function(t,e){if(""===e)throw new a("SYNTAX_ERR","An invalid or illegal string was specified");if(/\s/.test(e))throw new a("INVALID_CHARACTER_ERR","String contains an invalid character");return s.call(t,e)},l=function(t){for(var e=r.call(t.getAttribute("class")||""),n=e?e.split(/\s+/):[],o=0,i=n.length;i>o;o++)this.push(n[o]);this._updateClassName=function(){t.setAttribute("class",this.toString())}},u=l[n]=[],d=function(){return new l(this)};if(a[n]=Error[n],u.item=function(t){return this[t]||null},u.contains=function(t){return t+="",-1!==c(this,t)},u.add=function(){var t,e=arguments,n=0,o=e.length,i=!1;do t=e[n]+"",-1===c(this,t)&&(this.push(t),i=!0);while(++n<o);i&&this._updateClassName()},u.remove=function(){var t,e,n=arguments,o=0,i=n.length,r=!1;do for(t=n[o]+"",e=c(this,t);-1!==e;)this.splice(e,1),r=!0,e=c(this,t);while(++o<i);r&&this._updateClassName()},u.toggle=function(t,e){t+="";var n=this.contains(t),o=n?e!==!0&&"remove":e!==!1&&"add";return o&&this[o](t),e===!0||e===!1?e:!n},u.toString=function(){return this.join(" ")},i.defineProperty){var h={get:d,enumerable:!0,configurable:!0};try{i.defineProperty(o,e,h)}catch(f){-2146823252===f.number&&(h.enumerable=!1,i.defineProperty(o,e,h))}}else i[n].__defineGetter__&&o.__defineGetter__(e,d)}}(self)),function(){"use strict";function t(e,o){function i(t,e){return function(){return t.apply(e,arguments)}}var r;if(o=o||{},this.trackingClick=!1,this.trackingClickStart=0,this.targetElement=null,this.touchStartX=0,this.touchStartY=0,this.lastTouchIdentifier=0,this.touchBoundary=o.touchBoundary||10,this.layer=e,this.tapDelay=o.tapDelay||200,this.tapTimeout=o.tapTimeout||700,!t.notNeeded(e)){for(var s=["onMouse","onClick","onTouchStart","onTouchMove","onTouchEnd","onTouchCancel"],a=this,c=0,l=s.length;l>c;c++)a[s[c]]=i(a[s[c]],a);n&&(e.addEventListener("mouseover",this.onMouse,!0),e.addEventListener("mousedown",this.onMouse,!0),e.addEventListener("mouseup",this.onMouse,!0)),e.addEventListener("click",this.onClick,!0),e.addEventListener("touchstart",this.onTouchStart,!1),e.addEventListener("touchmove",this.onTouchMove,!1),e.addEventListener("touchend",this.onTouchEnd,!1),e.addEventListener("touchcancel",this.onTouchCancel,!1),Event.prototype.stopImmediatePropagation||(e.removeEventListener=function(t,n,o){var i=Node.prototype.removeEventListener;"click"===t?i.call(e,t,n.hijacked||n,o):i.call(e,t,n,o)},e.addEventListener=function(t,n,o){var i=Node.prototype.addEventListener;"click"===t?i.call(e,t,n.hijacked||(n.hijacked=function(t){t.propagationStopped||n(t)}),o):i.call(e,t,n,o)}),"function"==typeof e.onclick&&(r=e.onclick,e.addEventListener("click",function(t){r(t)},!1),e.onclick=null)}}var e=navigator.userAgent.indexOf("Windows Phone")>=0,n=navigator.userAgent.indexOf("Android")>0&&!e,o=/iP(ad|hone|od)/.test(navigator.userAgent)&&!e,i=o&&/OS 4_\d(_\d)?/.test(navigator.userAgent),r=o&&/OS [6-7]_\d/.test(navigator.userAgent),s=navigator.userAgent.indexOf("BB10")>0;t.prototype.needsClick=function(t){switch(t.nodeName.toLowerCase()){case"button":case"select":case"textarea":if(t.disabled)return!0;break;case"input":if(o&&"file"===t.type||t.disabled)return!0;break;case"label":case"iframe":case"video":return!0}return/\bneedsclick\b/.test(t.className)},t.prototype.needsFocus=function(t){switch(t.nodeName.toLowerCase()){case"textarea":return!0;case"select":return!n;case"input":switch(t.type){case"button":case"checkbox":case"file":case"image":case"radio":case"submit":return!1}return!t.disabled&&!t.readOnly;default:return/\bneedsfocus\b/.test(t.className)}},t.prototype.sendClick=function(t,e){var n,o;document.activeElement&&document.activeElement!==t&&document.activeElement.blur(),o=e.changedTouches[0],n=document.createEvent("MouseEvents"),n.initMouseEvent(this.determineEventType(t),!0,!0,window,1,o.screenX,o.screenY,o.clientX,o.clientY,!1,!1,!1,!1,0,null),n.forwardedTouchEvent=!0,t.dispatchEvent(n)},t.prototype.determineEventType=function(t){return n&&"select"===t.tagName.toLowerCase()?"mousedown":"click"},t.prototype.focus=function(t){var e;o&&t.setSelectionRange&&0!==t.type.indexOf("date")&&"time"!==t.type&&"month"!==t.type?(e=t.value.length,t.setSelectionRange(e,e)):t.focus()},t.prototype.updateScrollParent=function(t){var e,n;if(e=t.fastClickScrollParent,!e||!e.contains(t)){n=t;do{if(n.scrollHeight>n.offsetHeight){e=n,t.fastClickScrollParent=n;break}n=n.parentElement}while(n)}e&&(e.fastClickLastScrollTop=e.scrollTop)},t.prototype.getTargetElementFromEventTarget=function(t){return t.nodeType===Node.TEXT_NODE?t.parentNode:t},t.prototype.onTouchStart=function(t){var e,n,r;if(t.targetTouches.length>1)return!0;if(e=this.getTargetElementFromEventTarget(t.target),n=t.targetTouches[0],o){if(r=window.getSelection(),r.rangeCount&&!r.isCollapsed)return!0;if(!i){if(n.identifier&&n.identifier===this.lastTouchIdentifier)return t.preventDefault(),!1;this.lastTouchIdentifier=n.identifier,this.updateScrollParent(e)}}return this.trackingClick=!0,this.trackingClickStart=t.timeStamp,this.targetElement=e,this.touchStartX=n.pageX,this.touchStartY=n.pageY,t.timeStamp-this.lastClickTime<this.tapDelay&&t.preventDefault(),!0},t.prototype.touchHasMoved=function(t){var e=t.changedTouches[0],n=this.touchBoundary;return Math.abs(e.pageX-this.touchStartX)>n||Math.abs(e.pageY-this.touchStartY)>n?!0:!1},t.prototype.onTouchMove=function(t){return this.trackingClick?((this.targetElement!==this.getTargetElementFromEventTarget(t.target)||this.touchHasMoved(t))&&(this.trackingClick=!1,this.targetElement=null),!0):!0},t.prototype.findControl=function(t){return void 0!==t.control?t.control:t.htmlFor?document.getElementById(t.htmlFor):t.querySelector("button, input:not([type=hidden]), keygen, meter, output, progress, select, textarea")},t.prototype.onTouchEnd=function(t){var e,s,a,c,l,u=this.targetElement;if(!this.trackingClick)return!0;if(t.timeStamp-this.lastClickTime<this.tapDelay)return this.cancelNextClick=!0,!0;if(t.timeStamp-this.trackingClickStart>this.tapTimeout)return!0;if(this.cancelNextClick=!1,this.lastClickTime=t.timeStamp,s=this.trackingClickStart,this.trackingClick=!1,this.trackingClickStart=0,r&&(l=t.changedTouches[0],u=document.elementFromPoint(l.pageX-window.pageXOffset,l.pageY-window.pageYOffset)||u,u.fastClickScrollParent=this.targetElement.fastClickScrollParent),a=u.tagName.toLowerCase(),"label"===a){if(e=this.findControl(u)){if(this.focus(u),n)return!1;u=e}}else if(this.needsFocus(u))return t.timeStamp-s>100||o&&window.top!==window&&"input"===a?(this.targetElement=null,!1):(this.focus(u),this.sendClick(u,t),o&&"select"===a||(this.targetElement=null,t.preventDefault()),!1);return o&&!i&&(c=u.fastClickScrollParent,c&&c.fastClickLastScrollTop!==c.scrollTop)?!0:(this.needsClick(u)||(t.preventDefault(),this.sendClick(u,t)),!1)},t.prototype.onTouchCancel=function(){this.trackingClick=!1,this.targetElement=null},t.prototype.onMouse=function(t){return this.targetElement?t.forwardedTouchEvent?!0:t.cancelable&&(!this.needsClick(this.targetElement)||this.cancelNextClick)?(t.stopImmediatePropagation?t.stopImmediatePropagation():t.propagationStopped=!0,t.stopPropagation(),t.preventDefault(),!1):!0:!0},t.prototype.onClick=function(t){var e;return this.trackingClick?(this.targetElement=null,this.trackingClick=!1,!0):"submit"===t.target.type&&0===t.detail?!0:(e=this.onMouse(t),e||(this.targetElement=null),e)},t.prototype.destroy=function(){var t=this.layer;n&&(t.removeEventListener("mouseover",this.onMouse,!0),t.removeEventListener("mousedown",this.onMouse,!0),t.removeEventListener("mouseup",this.onMouse,!0)),t.removeEventListener("click",this.onClick,!0),t.removeEventListener("touchstart",this.onTouchStart,!1),t.removeEventListener("touchmove",this.onTouchMove,!1),t.removeEventListener("touchend",this.onTouchEnd,!1),t.removeEventListener("touchcancel",this.onTouchCancel,!1)},t.notNeeded=function(t){var e,o,i,r;if("undefined"==typeof window.ontouchstart)return!0;if(o=+(/Chrome\/([0-9]+)/.exec(navigator.userAgent)||[,0])[1]){if(!n)return!0;if(e=document.querySelector("meta[name=viewport]")){if(-1!==e.content.indexOf("user-scalable=no"))return!0;if(o>31&&document.documentElement.scrollWidth<=window.outerWidth)return!0}}if(s&&(i=navigator.userAgent.match(/Version\/([0-9]*)\.([0-9]*)/),i[1]>=10&&i[2]>=3&&(e=document.querySelector("meta[name=viewport]")))){if(-1!==e.content.indexOf("user-scalable=no"))return!0;if(document.documentElement.scrollWidth<=window.outerWidth)return!0}return"none"===t.style.msTouchAction||"manipulation"===t.style.touchAction?!0:(r=+(/Firefox\/([0-9]+)/.exec(navigator.userAgent)||[,0])[1],r>=27&&(e=document.querySelector("meta[name=viewport]"),e&&(-1!==e.content.indexOf("user-scalable=no")||document.documentElement.scrollWidth<=window.outerWidth))?!0:"none"===t.style.touchAction||"manipulation"===t.style.touchAction?!0:!1)},t.attach=function(e,n){return new t(e,n)},"function"==typeof define&&"object"==typeof define.amd&&define.amd?define(function(){return t}):"undefined"!=typeof module&&module.exports?(module.exports=t.attach,module.exports.FastClick=t):window.FastClick=t}(),function(){var t=function(e){var n=new t.Index;return n.pipeline.add(t.trimmer,t.stopWordFilter,t.stemmer),e&&e.call(n,n),n};t.version="0.6.0",t.utils={},t.utils.warn=function(t){return function(e){t.console&&console.warn&&console.warn(e)}}(this),t.utils.asString=function(t){return void 0===t||null===t?"":t.toString()},t.EventEmitter=function(){this.events={}},t.EventEmitter.prototype.addListener=function(){var t=Array.prototype.slice.call(arguments),e=t.pop(),n=t;if("function"!=typeof e)throw new TypeError("last argument must be a function");n.forEach(function(t){this.hasHandler(t)||(this.events[t]=[]),this.events[t].push(e)},this)},t.EventEmitter.prototype.removeListener=function(t,e){if(this.hasHandler(t)){var n=this.events[t].indexOf(e);this.events[t].splice(n,1),this.events[t].length||delete this.events[t]}},t.EventEmitter.prototype.emit=function(t){if(this.hasHandler(t)){var e=Array.prototype.slice.call(arguments,1);this.events[t].forEach(function(t){t.apply(void 0,e)})}},t.EventEmitter.prototype.hasHandler=function(t){return t in this.events},t.tokenizer=function(e){return arguments.length&&null!=e&&void 0!=e?Array.isArray(e)?e.map(function(e){return t.utils.asString(e).toLowerCase()}):e.toString().trim().toLowerCase().split(t.tokenizer.seperator):[]},t.tokenizer.seperator=/[\s\-]+/,t.Pipeline=function(){this._stack=[]},t.Pipeline.registeredFunctions={},t.Pipeline.registerFunction=function(e,n){n in this.registeredFunctions&&t.utils.warn("Overwriting existing registered function: "+n),e.label=n,t.Pipeline.registeredFunctions[e.label]=e},t.Pipeline.warnIfFunctionNotRegistered=function(e){var n=e.label&&e.label in this.registeredFunctions;n||t.utils.warn("Function is not registered with pipeline. This may cause problems when serialising the index.\n",e)},t.Pipeline.load=function(e){var n=new t.Pipeline;return e.forEach(function(e){var o=t.Pipeline.registeredFunctions[e];if(!o)throw new Error("Cannot load un-registered function: "+e);n.add(o)}),n},t.Pipeline.prototype.add=function(){var e=Array.prototype.slice.call(arguments);e.forEach(function(e){t.Pipeline.warnIfFunctionNotRegistered(e),this._stack.push(e)},this)},t.Pipeline.prototype.after=function(e,n){t.Pipeline.warnIfFunctionNotRegistered(n);var o=this._stack.indexOf(e);if(-1==o)throw new Error("Cannot find existingFn");o+=1,this._stack.splice(o,0,n)},t.Pipeline.prototype.before=function(e,n){t.Pipeline.warnIfFunctionNotRegistered(n);var o=this._stack.indexOf(e);if(-1==o)throw new Error("Cannot find existingFn");this._stack.splice(o,0,n)},t.Pipeline.prototype.remove=function(t){var e=this._stack.indexOf(t);-1!=e&&this._stack.splice(e,1)},t.Pipeline.prototype.run=function(t){for(var e=[],n=t.length,o=this._stack.length,i=0;n>i;i++){for(var r=t[i],s=0;o>s&&(r=this._stack[s](r,i,t),void 0!==r&&""!==r);s++);void 0!==r&&""!==r&&e.push(r)}return e},t.Pipeline.prototype.reset=function(){this._stack=[]},t.Pipeline.prototype.toJSON=function(){return this._stack.map(function(e){return t.Pipeline.warnIfFunctionNotRegistered(e),e.label})},t.Vector=function(){this._magnitude=null,this.list=void 0,this.length=0},t.Vector.Node=function(t,e,n){this.idx=t,this.val=e,this.next=n},t.Vector.prototype.insert=function(e,n){this._magnitude=void 0;var o=this.list;if(!o)return this.list=new t.Vector.Node(e,n,o),this.length++;if(e<o.idx)return this.list=new t.Vector.Node(e,n,o),this.length++;for(var i=o,r=o.next;void 0!=r;){if(e<r.idx)return i.next=new t.Vector.Node(e,n,r),this.length++;i=r,r=r.next}return i.next=new t.Vector.Node(e,n,r),this.length++},t.Vector.prototype.magnitude=function(){if(this._magnitude)return this._magnitude;for(var t,e=this.list,n=0;e;)t=e.val,n+=t*t,e=e.next;return this._magnitude=Math.sqrt(n)},t.Vector.prototype.dot=function(t){for(var e=this.list,n=t.list,o=0;e&&n;)e.idx<n.idx?e=e.next:e.idx>n.idx?n=n.next:(o+=e.val*n.val,e=e.next,n=n.next);return o},t.Vector.prototype.similarity=function(t){return this.dot(t)/(this.magnitude()*t.magnitude())},t.SortedSet=function(){this.length=0,this.elements=[]},t.SortedSet.load=function(t){var e=new this;return e.elements=t,e.length=t.length,e},t.SortedSet.prototype.add=function(){var t,e;for(t=0;t<arguments.length;t++)e=arguments[t],~this.indexOf(e)||this.elements.splice(this.locationFor(e),0,e);this.length=this.elements.length},t.SortedSet.prototype.toArray=function(){return this.elements.slice()},t.SortedSet.prototype.map=function(t,e){return this.elements.map(t,e)},t.SortedSet.prototype.forEach=function(t,e){return this.elements.forEach(t,e)},t.SortedSet.prototype.indexOf=function(t){for(var e=0,n=this.elements.length,o=n-e,i=e+Math.floor(o/2),r=this.elements[i];o>1;){if(r===t)return i;t>r&&(e=i),r>t&&(n=i),o=n-e,i=e+Math.floor(o/2),r=this.elements[i]}return r===t?i:-1},t.SortedSet.prototype.locationFor=function(t){for(var e=0,n=this.elements.length,o=n-e,i=e+Math.floor(o/2),r=this.elements[i];o>1;)t>r&&(e=i),r>t&&(n=i),o=n-e,i=e+Math.floor(o/2),r=this.elements[i];return r>t?i:t>r?i+1:void 0},t.SortedSet.prototype.intersect=function(e){for(var n=new t.SortedSet,o=0,i=0,r=this.length,s=e.length,a=this.elements,c=e.elements;;){if(o>r-1||i>s-1)break;a[o]!==c[i]?a[o]<c[i]?o++:a[o]>c[i]&&i++:(n.add(a[o]),o++,i++)}return n},t.SortedSet.prototype.clone=function(){var e=new t.SortedSet;return e.elements=this.toArray(),e.length=e.elements.length,e},t.SortedSet.prototype.union=function(t){var e,n,o;return this.length>=t.length?(e=this,n=t):(e=t,n=this),o=e.clone(),o.add.apply(o,n.toArray()),o},t.SortedSet.prototype.toJSON=function(){return this.toArray()},t.Index=function(){this._fields=[],this._ref="id",this.pipeline=new t.Pipeline,this.documentStore=new t.Store,this.tokenStore=new t.TokenStore,this.corpusTokens=new t.SortedSet,this.eventEmitter=new t.EventEmitter,this._idfCache={},this.on("add","remove","update",function(){this._idfCache={}}.bind(this))},t.Index.prototype.on=function(){var t=Array.prototype.slice.call(arguments);return this.eventEmitter.addListener.apply(this.eventEmitter,t)},t.Index.prototype.off=function(t,e){return this.eventEmitter.removeListener(t,e)},t.Index.load=function(e){e.version!==t.version&&t.utils.warn("version mismatch: current "+t.version+" importing "+e.version);var n=new this;return n._fields=e.fields,n._ref=e.ref,n.documentStore=t.Store.load(e.documentStore),n.tokenStore=t.TokenStore.load(e.tokenStore),n.corpusTokens=t.SortedSet.load(e.corpusTokens),n.pipeline=t.Pipeline.load(e.pipeline),n},t.Index.prototype.field=function(t,e){var e=e||{},n={name:t,boost:e.boost||1};return this._fields.push(n),this},t.Index.prototype.ref=function(t){return this._ref=t,this},t.Index.prototype.add=function(e,n){var o={},i=new t.SortedSet,r=e[this._ref],n=void 0===n?!0:n;this._fields.forEach(function(n){var r=this.pipeline.run(t.tokenizer(e[n.name]));o[n.name]=r,t.SortedSet.prototype.add.apply(i,r)},this),this.documentStore.set(r,i),t.SortedSet.prototype.add.apply(this.corpusTokens,i.toArray());for(var s=0;s<i.length;s++){var a=i.elements[s],c=this._fields.reduce(function(t,e){var n=o[e.name].length;if(!n)return t;var i=o[e.name].filter(function(t){return t===a}).length;return t+i/n*e.boost},0);this.tokenStore.add(a,{ref:r,tf:c})}n&&this.eventEmitter.emit("add",e,this)},t.Index.prototype.remove=function(t,e){var n=t[this._ref],e=void 0===e?!0:e;if(this.documentStore.has(n)){var o=this.documentStore.get(n);this.documentStore.remove(n),o.forEach(function(t){this.tokenStore.remove(t,n)},this),e&&this.eventEmitter.emit("remove",t,this)}},t.Index.prototype.update=function(t,e){var e=void 0===e?!0:e;this.remove(t,!1),this.add(t,!1),e&&this.eventEmitter.emit("update",t,this)},t.Index.prototype.idf=function(t){var e="@"+t;if(Object.prototype.hasOwnProperty.call(this._idfCache,e))return this._idfCache[e];var n=this.tokenStore.count(t),o=1;return n>0&&(o=1+Math.log(this.documentStore.length/n)),this._idfCache[e]=o},t.Index.prototype.search=function(e){var n=this.pipeline.run(t.tokenizer(e)),o=new t.Vector,i=[],r=this._fields.reduce(function(t,e){return t+e.boost},0),s=n.some(function(t){return this.tokenStore.has(t)},this);if(!s)return[];n.forEach(function(e,n,s){var a=1/s.length*this._fields.length*r,c=this,l=this.tokenStore.expand(e).reduce(function(n,i){var r=c.corpusTokens.indexOf(i),s=c.idf(i),l=1,u=new t.SortedSet;if(i!==e){var d=Math.max(3,i.length-e.length);l=1/Math.log(d)}r>-1&&o.insert(r,a*s*l);for(var h=c.tokenStore.get(i),f=Object.keys(h),p=f.length,m=0;p>m;m++)u.add(h[f[m]].ref);return n.union(u)},new t.SortedSet);i.push(l)},this);var a=i.reduce(function(t,e){return t.intersect(e)});return a.map(function(t){return{ref:t,score:o.similarity(this.documentVector(t))}},this).sort(function(t,e){return e.score-t.score})},t.Index.prototype.documentVector=function(e){for(var n=this.documentStore.get(e),o=n.length,i=new t.Vector,r=0;o>r;r++){var s=n.elements[r],a=this.tokenStore.get(s)[e].tf,c=this.idf(s);i.insert(this.corpusTokens.indexOf(s),a*c)}return i},t.Index.prototype.toJSON=function(){return{version:t.version,fields:this._fields,ref:this._ref,documentStore:this.documentStore.toJSON(),tokenStore:this.tokenStore.toJSON(),corpusTokens:this.corpusTokens.toJSON(),pipeline:this.pipeline.toJSON()}},t.Index.prototype.use=function(t){var e=Array.prototype.slice.call(arguments,1);e.unshift(this),t.apply(this,e)},t.Store=function(){this.store={},this.length=0},t.Store.load=function(e){var n=new this;return n.length=e.length,n.store=Object.keys(e.store).reduce(function(n,o){return n[o]=t.SortedSet.load(e.store[o]),n},{}),n},t.Store.prototype.set=function(t,e){this.has(t)||this.length++,this.store[t]=e},t.Store.prototype.get=function(t){return this.store[t]},t.Store.prototype.has=function(t){return t in this.store},t.Store.prototype.remove=function(t){this.has(t)&&(delete this.store[t],this.length--)},t.Store.prototype.toJSON=function(){return{store:this.store,length:this.length}},t.stemmer=function(){var t={ational:"ate",tional:"tion",enci:"ence",anci:"ance",izer:"ize",bli:"ble",alli:"al",entli:"ent",eli:"e",ousli:"ous",ization:"ize",ation:"ate",ator:"ate",alism:"al",iveness:"ive",fulness:"ful",ousness:"ous",aliti:"al",iviti:"ive",biliti:"ble",logi:"log"},e={icate:"ic",ative:"",alize:"al",iciti:"ic",ical:"ic",ful:"",ness:""},n="[^aeiou]",o="[aeiouy]",i=n+"[^aeiouy]*",r=o+"[aeiou]*",s="^("+i+")?"+r+i,a="^("+i+")?"+r+i+"("+r+")?$",c="^("+i+")?"+r+i+r+i,l="^("+i+")?"+o,u=new RegExp(s),d=new RegExp(c),h=new RegExp(a),f=new RegExp(l),p=/^(.+?)(ss|i)es$/,m=/^(.+?)([^s])s$/,v=/^(.+?)eed$/,g=/^(.+?)(ed|ing)$/,y=/.$/,w=/(at|bl|iz)$/,S=new RegExp("([^aeiouylsz])\\1$"),k=new RegExp("^"+i+o+"[^aeiouwxy]$"),E=/^(.+?[^aeiou])y$/,x=/^(.+?)(ational|tional|enci|anci|izer|bli|alli|entli|eli|ousli|ization|ation|ator|alism|iveness|fulness|ousness|aliti|iviti|biliti|logi)$/,b=/^(.+?)(icate|ative|alize|iciti|ical|ful|ness)$/,T=/^(.+?)(al|ance|ence|er|ic|able|ible|ant|ement|ment|ent|ou|ism|ate|iti|ous|ive|ize)$/,C=/^(.+?)(s|t)(ion)$/,L=/^(.+?)e$/,_=/ll$/,A=new RegExp("^"+i+o+"[^aeiouwxy]$"),O=function(n){var o,i,r,s,a,c,l;if(n.length<3)return n;if(r=n.substr(0,1),"y"==r&&(n=r.toUpperCase()+n.substr(1)),s=p,a=m,s.test(n)?n=n.replace(s,"$1$2"):a.test(n)&&(n=n.replace(a,"$1$2")),s=v,a=g,s.test(n)){var O=s.exec(n);s=u,s.test(O[1])&&(s=y,n=n.replace(s,""))}else if(a.test(n)){var O=a.exec(n);o=O[1],a=f,a.test(o)&&(n=o,a=w,c=S,l=k,a.test(n)?n+="e":c.test(n)?(s=y,n=n.replace(s,"")):l.test(n)&&(n+="e"))}if(s=E,s.test(n)){var O=s.exec(n);o=O[1],n=o+"i"}if(s=x,s.test(n)){var O=s.exec(n);o=O[1],i=O[2],s=u,s.test(o)&&(n=o+t[i])}if(s=b,s.test(n)){var O=s.exec(n);o=O[1],i=O[2],s=u,s.test(o)&&(n=o+e[i])}if(s=T,a=C,s.test(n)){var O=s.exec(n);o=O[1],s=d,s.test(o)&&(n=o)}else if(a.test(n)){var O=a.exec(n);o=O[1]+O[2],a=d,a.test(o)&&(n=o)}if(s=L,s.test(n)){var O=s.exec(n);o=O[1],s=d,a=h,c=A,(s.test(o)||a.test(o)&&!c.test(o))&&(n=o)}return s=_,a=d,s.test(n)&&a.test(n)&&(s=y,n=n.replace(s,"")),"y"==r&&(n=r.toLowerCase()+n.substr(1)),n};return O}(),t.Pipeline.registerFunction(t.stemmer,"stemmer"),t.generateStopWordFilter=function(t){var e=t.reduce(function(t,e){return t[e]=e,t},{});return function(t){return t&&e[t]!==t?t:void 0}},t.stopWordFilter=t.generateStopWordFilter(["a","able","about","across","after","all","almost","also","am","among","an","and","any","are","as","at","be","because","been","but","by","can","cannot","could","dear","did","do","does","either","else","ever","every","for","from","get","got","had","has","have","he","her","hers","him","his","how","however","i","if","in","into","is","it","its","just","least","let","like","likely","may","me","might","most","must","my","neither","no","nor","not","of","off","often","on","only","or","other","our","own","rather","said","say","says","she","should","since","so","some","than","that","the","their","them","then","there","these","they","this","tis","to","too","twas","us","wants","was","we","were","what","when","where","which","while","who","whom","why","will","with","would","yet","you","your"]),t.Pipeline.registerFunction(t.stopWordFilter,"stopWordFilter"),t.trimmer=function(t){return t.replace(/^\W+/,"").replace(/\W+$/,"")},t.Pipeline.registerFunction(t.trimmer,"trimmer"),t.TokenStore=function(){this.root={docs:{}},this.length=0},t.TokenStore.load=function(t){var e=new this;return e.root=t.root,e.length=t.length,e},t.TokenStore.prototype.add=function(t,e,n){var n=n||this.root,o=t.charAt(0),i=t.slice(1);return o in n||(n[o]={docs:{}}),0===i.length?(n[o].docs[e.ref]=e,void(this.length+=1)):this.add(i,e,n[o])},t.TokenStore.prototype.has=function(t){if(!t)return!1;for(var e=this.root,n=0;n<t.length;n++){if(!e[t.charAt(n)])return!1;e=e[t.charAt(n)]}return!0},t.TokenStore.prototype.getNode=function(t){if(!t)return{};for(var e=this.root,n=0;n<t.length;n++){if(!e[t.charAt(n)])return{};e=e[t.charAt(n)]}return e},t.TokenStore.prototype.get=function(t,e){return this.getNode(t,e).docs||{}},t.TokenStore.prototype.count=function(t,e){return Object.keys(this.get(t,e)).length},t.TokenStore.prototype.remove=function(t,e){if(t){for(var n=this.root,o=0;o<t.length;o++){if(!(t.charAt(o)in n))return;n=n[t.charAt(o)]}delete n.docs[e]}},t.TokenStore.prototype.expand=function(t,e){var n=this.getNode(t),o=n.docs||{},e=e||[];return Object.keys(o).length&&e.push(t),Object.keys(n).forEach(function(n){"docs"!==n&&e.concat(this.expand(t+n,e))},this),e},t.TokenStore.prototype.toJSON=function(){return{root:this.root,length:this.length}},function(t,e){"function"==typeof define&&define.amd?define(e):"object"==typeof exports?module.exports=e():t.lunr=e()}(this,function(){return t})}(),String.prototype.truncate=function(t){if(this.length>t){for(;" "!=this[t]&&--t>0;);return this.substring(0,t)+"…"}return this},HTMLElement.prototype.wrap=function(t){t.length||(t=[t]);for(var e=t.length-1;e>=0;e--){var n=e>0?this.cloneNode(!0):this,o=t[e],i=o.parentNode,r=o.nextSibling;n.appendChild(o),r?i.insertBefore(n,r):i.appendChild(n)}},document.addEventListener("DOMContentLoaded",function(){"use strict";Modernizr.addTest("ios",function(){return!!navigator.userAgent.match(/(iPad|iPhone|iPod)/g)}),Modernizr.addTest("standalone",function(){return!!navigator.standalone}),FastClick.attach(document.body);var t=document.getElementById("toggle-search"),e=(document.getElementById("reset-search"),document.querySelector(".drawer")),n=document.querySelectorAll(".anchor"),o=document.querySelector(".search .field"),i=document.querySelector(".query"),r=document.querySelector(".results .meta");Array.prototype.forEach.call(n,function(t){t.querySelector("a").addEventListener("click",function(){document.getElementById("toggle-drawer").checked=!1,document.body.classList.remove("toggle-drawer")})});var s=window.pageYOffset,a=function(){var t=window.pageYOffset+window.innerHeight,n=Math.max(0,window.innerHeight-e.offsetHeight);t>document.body.clientHeight-(96-n)?"absolute"!=e.style.position&&(e.style.position="absolute",e.style.top=null,e.style.bottom=0):e.offsetHeight<window.innerHeight?"fixed"!=e.style.position&&(e.style.position="fixed",e.style.top=0,e.style.bottom=null):"fixed"!=e.style.position?t>e.offsetTop+e.offsetHeight?(e.style.position="fixed",e.style.top=null,e.style.bottom="-96px"):window.pageYOffset<e.offsetTop&&(e.style.position="fixed",e.style.top=0,e.style.bottom=null):window.pageYOffset>s?e.style.top&&(e.style.position="absolute",e.style.top=Math.max(0,s)+"px",e.style.bottom=null):e.style.bottom&&(e.style.position="absolute",e.style.top=t-e.offsetHeight+"px",e.style.bottom=null),s=Math.max(0,window.pageYOffset)},c=function(){var t=document.querySelector(".main");window.removeEventListener("scroll",a),matchMedia("only screen and (max-width: 959px)").matches?(e.style.position=null,e.style.top=null,e.style.bottom=null):e.offsetHeight+96<t.offsetHeight&&(window.addEventListener("scroll",a),a())};Modernizr.ios||(window.addEventListener("resize",c),c());var l=function(){pegasus(base_url+"/mkdocs/search_index.json").then(function(e,n){var o=lunr(function(){this.field("title",{boost:10}),this.field("text"),this.ref("location")}),s={};e.docs.map(function(t){t.location=base_url+t.location,s[t.location]=t,o.add(t)}),i.addEventListener("keyup",function(){for(var e=document.querySelector(".results .list");e.firstChild;)e.removeChild(e.firstChild);var n=document.querySelector(".bar.search");if(!i.value.length){for(;r.firstChild;)r.removeChild(r.firstChild);return void n.classList.remove("non-empty")}n.classList.add("non-empty");var a=o.search(i.value);a.map(function(n){var o=s[n.ref],i=document.createElement("article");i.classList.add("result");var r=document.createElement("h1");r.innerHTML=o.title,i.appendChild(r);var a=document.createElement("a");a.href=o.location,a.appendChild(i);var c=document.createElement("span");c.innerHTML=a.href.split("#")[0],i.appendChild(c);var l=a.href.split("#");l[0]==document.location.href.split("#")[0]&&a.addEventListener("click",function(e){if(document.body.classList.remove("toggle-search"),document.body.classList.remove("locked"),t.checked=!1,!matchMedia("only screen and (min-width: 960px)").matches&&(e.preventDefault(),e.stopPropagation(),1!=l.length)){var n=document.getElementById(l[1]);n&&setTimeout(function(){n.scrollIntoView&&n.scrollIntoView()||window.scrollTo(0,n.offsetTop)},100)}}),e.appendChild(a)});var c=document.createElement("strong");for(c.innerHTML=a.length+" search result"+(1!=a.length?"s":"");r.firstChild;)r.removeChild(r.firstChild);r.appendChild(c)})},function(t,e){console.error(t,e.status)}),t.removeEventListener("click",l)};t.addEventListener("click",l);var u=0;t.addEventListener("click",function(t){var e=document.body.classList,n=!matchMedia("only screen and (min-width: 960px)").matches;e.contains("locked")?(e.remove("locked"),n&&setTimeout(function(){window.scrollTo(0,u)},100)):(u=window.scrollY,n&&setTimeout(function(){window.scrollTo(0,0)},400),setTimeout(function(){this.checked&&(n&&e.add("locked"),setTimeout(function(){i.focus()},200))}.bind(this),450))}),o.addEventListener("touchstart",function(){i.focus()}),window.addEventListener("keyup",function(e){var n=e.keyCode||e.which;27==n&&(i.blur(),document.body.classList.remove("toggle-search"),document.body.classList.remove("locked"),t.checked=!1)});var d=document.getElementById("reset-search");d.addEventListener("click",function(){for(var t=document.querySelector(".results .list");t.firstChild;)t.removeChild(t.firstChild);var e=document.querySelector(".bar.search");e.classList.remove("non-empty"),r.innerHTML="",i.value="",i.focus()});var h=document.querySelectorAll("h2");h=Array.prototype.map.call(h,function(t){return t.offsetTop});var f=null;document.addEventListener("scroll",function(){for(var t=window.scrollY+window.innerHeight/3,e=h.length-1,o=0;e>o;o++)t<h[o+1]&&(e=o);e!=f&&(f=e,Array.prototype.forEach.call(n,function(t,e){var n=t.querySelector("a");(e!=f||n.classList.add("current"))&&n.classList.remove("current")}))});var p=document.querySelectorAll(".n + .p");Array.prototype.forEach.call(p,function(t){var e=t.innerText||t.textContent;e&&"("==e[0]&&t.previousSibling.classList.add("f")});var m=document.querySelectorAll("table");if(Array.prototype.forEach.call(m,function(t){var e=document.createElement("div");e.classList.add("data"),e.wrap(t)}),Modernizr.ios){var v=document.querySelectorAll(".scrollable, .standalone .article");Array.prototype.forEach.call(v,function(t){t.addEventListener("touchstart",function(){var t=this.scrollTop;0==t?this.scrollTop=1:t+this.offsetHeight==this.scrollHeight&&(this.scrollTop=t-1)})})}var g=document.querySelectorAll(".project, .overlay, .header");Array.prototype.forEach.call(g,function(t){t.addEventListener("touchmove",function(t){t.preventDefault()})});var y=document.querySelectorAll(".toggle");Array.prototype.forEach.call(y,function(t){t.addEventListener("click",function(){document.body.classList.toggle(this.id)})}),repo_id&&pegasus("https://api.github.com/repos/"+repo_id).then(function(t,e){var n=t.stargazers_count;n>1e4?n=(n/1e3).toFixed(0)+"k":n>1e3&&(n=(n/1e3).toFixed(1)+"k");var o=document.querySelector(".repo-stars .count");o.innerHTML=n},function(t,e){console.error(t,e.status)})}),"standalone"in window.navigator&&window.navigator.standalone){var node,remotes=!1;document.addEventListener("click",function(t){for(node=t.target;"A"!==node.nodeName&&"HTML"!==node.nodeName;)node=node.parentNode;"href"in node&&-1!==node.href.indexOf("http")&&(-1!==node.href.indexOf(document.location.host)||remotes)&&(t.preventDefault(),document.location.href=node.href)},!1)}
\ No newline at end of file
diff --git a/javascripts/modernizr.js b/javascripts/modernizr.js
new file mode 100644
index 0000000..e82c909
--- /dev/null
+++ b/javascripts/modernizr.js
@@ -0,0 +1 @@
+!function(e,t,n){function r(e,t){return typeof e===t}function i(){var e,t,n,i,o,a,s;for(var l in x)if(x.hasOwnProperty(l)){if(e=[],t=x[l],t.name&&(e.push(t.name.toLowerCase()),t.options&&t.options.aliases&&t.options.aliases.length))for(n=0;n<t.options.aliases.length;n++)e.push(t.options.aliases[n].toLowerCase());for(i=r(t.fn,"function")?t.fn():t.fn,o=0;o<e.length;o++)a=e[o],s=a.split("."),1===s.length?S[s[0]]=i:(!S[s[0]]||S[s[0]]instanceof Boolean||(S[s[0]]=new Boolean(S[s[0]])),S[s[0]][s[1]]=i),w.push((i?"":"no-")+s.join("-"))}}function o(e){var t=C.className,n=S._config.classPrefix||"";if(T&&(t=t.baseVal),S._config.enableJSClass){var r=new RegExp("(^|\\s)"+n+"no-js(\\s|$)");t=t.replace(r,"$1"+n+"js$2")}S._config.enableClasses&&(t+=" "+n+e.join(" "+n),T?C.className.baseVal=t:C.className=t)}function a(e,t){if("object"==typeof e)for(var n in e)b(e,n)&&a(n,e[n]);else{e=e.toLowerCase();var r=e.split("."),i=S[r[0]];if(2==r.length&&(i=i[r[1]]),"undefined"!=typeof i)return S;t="function"==typeof t?t():t,1==r.length?S[r[0]]=t:(!S[r[0]]||S[r[0]]instanceof Boolean||(S[r[0]]=new Boolean(S[r[0]])),S[r[0]][r[1]]=t),o([(t&&0!=t?"":"no-")+r.join("-")]),S._trigger(e,t)}return S}function s(e,t){return function(){return e.apply(t,arguments)}}function l(e,t){return!!~(""+e).indexOf(t)}function u(){return"function"!=typeof t.createElement?t.createElement(arguments[0]):T?t.createElementNS.call(t,"http://www.w3.org/2000/svg",arguments[0]):t.createElement.apply(t,arguments)}function c(){var e=t.body;return e||(e=u(T?"svg":"body"),e.fake=!0),e}function f(e,n,r,i){var o,a,s,l,f="modernizr",d=u("div"),p=c();if(parseInt(r,10))for(;r--;)s=u("div"),s.id=i?i[r]:f+(r+1),d.appendChild(s);return o=u("style"),o.type="text/css",o.id="s"+f,(p.fake?p:d).appendChild(o),p.appendChild(d),o.styleSheet?o.styleSheet.cssText=e:o.appendChild(t.createTextNode(e)),d.id=f,p.fake&&(p.style.background="",p.style.overflow="hidden",l=C.style.overflow,C.style.overflow="hidden",C.appendChild(p)),a=n(d,e),p.fake?(p.parentNode.removeChild(p),C.style.overflow=l,C.offsetHeight):d.parentNode.removeChild(d),!!a}function d(e){return e.replace(/([A-Z])/g,function(e,t){return"-"+t.toLowerCase()}).replace(/^ms-/,"-ms-")}function p(t,r){var i=t.length;if("CSS"in e&&"supports"in e.CSS){for(;i--;)if(e.CSS.supports(d(t[i]),r))return!0;return!1}if("CSSSupportsRule"in e){for(var o=[];i--;)o.push("("+d(t[i])+":"+r+")");return o=o.join(" or "),f("@supports ("+o+") { #modernizr { position: absolute; } }",function(e){return"absolute"==getComputedStyle(e,null).position})}return n}function m(e){return e.replace(/([a-z])-([a-z])/g,function(e,t,n){return t+n.toUpperCase()}).replace(/^-/,"")}function h(e,t,i,o){function a(){c&&(delete _.style,delete _.modElem)}if(o=r(o,"undefined")?!1:o,!r(i,"undefined")){var s=p(e,i);if(!r(s,"undefined"))return s}for(var c,f,d,h,g,v=["modernizr","tspan"];!_.style;)c=!0,_.modElem=u(v.shift()),_.style=_.modElem.style;for(d=e.length,f=0;d>f;f++)if(h=e[f],g=_.style[h],l(h,"-")&&(h=m(h)),_.style[h]!==n){if(o||r(i,"undefined"))return a(),"pfx"==t?h:!0;try{_.style[h]=i}catch(y){}if(_.style[h]!=g)return a(),"pfx"==t?h:!0}return a(),!1}function g(e,t,n){var i;for(var o in e)if(e[o]in t)return n===!1?e[o]:(i=t[e[o]],r(i,"function")?s(i,n||t):i);return!1}function v(e,t,n,i,o){var a=e.charAt(0).toUpperCase()+e.slice(1),s=(e+" "+P.join(a+" ")+a).split(" ");return r(t,"string")||r(t,"undefined")?h(s,t,i,o):(s=(e+" "+A.join(a+" ")+a).split(" "),g(s,t,n))}function y(e,t,r){return v(e,n,n,t,r)}var x=[],E={_version:"3.3.1",_config:{classPrefix:"",enableClasses:!0,enableJSClass:!0,usePrefixes:!0},_q:[],on:function(e,t){var n=this;setTimeout(function(){t(n[e])},0)},addTest:function(e,t,n){x.push({name:e,fn:t,options:n})},addAsyncTest:function(e){x.push({name:null,fn:e})}},S=function(){};S.prototype=E,S=new S;var b,w=[],C=t.documentElement,T="svg"===C.nodeName.toLowerCase();!function(){var e={}.hasOwnProperty;b=r(e,"undefined")||r(e.call,"undefined")?function(e,t){return t in e&&r(e.constructor.prototype[t],"undefined")}:function(t,n){return e.call(t,n)}}(),E._l={},E.on=function(e,t){this._l[e]||(this._l[e]=[]),this._l[e].push(t),S.hasOwnProperty(e)&&setTimeout(function(){S._trigger(e,S[e])},0)},E._trigger=function(e,t){if(this._l[e]){var n=this._l[e];setTimeout(function(){var e,r;for(e=0;e<n.length;e++)(r=n[e])(t)},0),delete this._l[e]}},S._q.push(function(){E.addTest=a});T||!function(e,t){function n(e,t){var n=e.createElement("p"),r=e.getElementsByTagName("head")[0]||e.documentElement;return n.innerHTML="x<style>"+t+"</style>",r.insertBefore(n.lastChild,r.firstChild)}function r(){var e=C.elements;return"string"==typeof e?e.split(" "):e}function i(e,t){var n=C.elements;"string"!=typeof n&&(n=n.join(" ")),"string"!=typeof e&&(e=e.join(" ")),C.elements=n+" "+e,u(t)}function o(e){var t=w[e[S]];return t||(t={},b++,e[S]=b,w[b]=t),t}function a(e,n,r){if(n||(n=t),g)return n.createElement(e);r||(r=o(n));var i;return i=r.cache[e]?r.cache[e].cloneNode():E.test(e)?(r.cache[e]=r.createElem(e)).cloneNode():r.createElem(e),!i.canHaveChildren||x.test(e)||i.tagUrn?i:r.frag.appendChild(i)}function s(e,n){if(e||(e=t),g)return e.createDocumentFragment();n=n||o(e);for(var i=n.frag.cloneNode(),a=0,s=r(),l=s.length;l>a;a++)i.createElement(s[a]);return i}function l(e,t){t.cache||(t.cache={},t.createElem=e.createElement,t.createFrag=e.createDocumentFragment,t.frag=t.createFrag()),e.createElement=function(n){return C.shivMethods?a(n,e,t):t.createElem(n)},e.createDocumentFragment=Function("h,f","return function(){var n=f.cloneNode(),c=n.createElement;h.shivMethods&&("+r().join().replace(/[\w\-:]+/g,function(e){return t.createElem(e),t.frag.createElement(e),'c("'+e+'")'})+");return n}")(C,t.frag)}function u(e){e||(e=t);var r=o(e);return!C.shivCSS||h||r.hasCSS||(r.hasCSS=!!n(e,"article,aside,dialog,figcaption,figure,footer,header,hgroup,main,nav,section{display:block}mark{background:#FF0;color:#000}template{display:none}")),g||l(e,r),e}function c(e){for(var t,n=e.getElementsByTagName("*"),i=n.length,o=RegExp("^(?:"+r().join("|")+")$","i"),a=[];i--;)t=n[i],o.test(t.nodeName)&&a.push(t.applyElement(f(t)));return a}function f(e){for(var t,n=e.attributes,r=n.length,i=e.ownerDocument.createElement(N+":"+e.nodeName);r--;)t=n[r],t.specified&&i.setAttribute(t.nodeName,t.nodeValue);return i.style.cssText=e.style.cssText,i}function d(e){for(var t,n=e.split("{"),i=n.length,o=RegExp("(^|[\\s,>+~])("+r().join("|")+")(?=[[\\s,>+~#.:]|$)","gi"),a="$1"+N+"\\:$2";i--;)t=n[i]=n[i].split("}"),t[t.length-1]=t[t.length-1].replace(o,a),n[i]=t.join("}");return n.join("{")}function p(e){for(var t=e.length;t--;)e[t].removeNode()}function m(e){function t(){clearTimeout(a._removeSheetTimer),r&&r.removeNode(!0),r=null}var r,i,a=o(e),s=e.namespaces,l=e.parentWindow;return!_||e.printShived?e:("undefined"==typeof s[N]&&s.add(N),l.attachEvent("onbeforeprint",function(){t();for(var o,a,s,l=e.styleSheets,u=[],f=l.length,p=Array(f);f--;)p[f]=l[f];for(;s=p.pop();)if(!s.disabled&&T.test(s.media)){try{o=s.imports,a=o.length}catch(m){a=0}for(f=0;a>f;f++)p.push(o[f]);try{u.push(s.cssText)}catch(m){}}u=d(u.reverse().join("")),i=c(e),r=n(e,u)}),l.attachEvent("onafterprint",function(){p(i),clearTimeout(a._removeSheetTimer),a._removeSheetTimer=setTimeout(t,500)}),e.printShived=!0,e)}var h,g,v="3.7.3",y=e.html5||{},x=/^<|^(?:button|map|select|textarea|object|iframe|option|optgroup)$/i,E=/^(?:a|b|code|div|fieldset|h1|h2|h3|h4|h5|h6|i|label|li|ol|p|q|span|strong|style|table|tbody|td|th|tr|ul)$/i,S="_html5shiv",b=0,w={};!function(){try{var e=t.createElement("a");e.innerHTML="<xyz></xyz>",h="hidden"in e,g=1==e.childNodes.length||function(){t.createElement("a");var e=t.createDocumentFragment();return"undefined"==typeof e.cloneNode||"undefined"==typeof e.createDocumentFragment||"undefined"==typeof e.createElement}()}catch(n){h=!0,g=!0}}();var C={elements:y.elements||"abbr article aside audio bdi canvas data datalist details dialog figcaption figure footer header hgroup main mark meter nav output picture progress section summary template time video",version:v,shivCSS:y.shivCSS!==!1,supportsUnknownElements:g,shivMethods:y.shivMethods!==!1,type:"default",shivDocument:u,createElement:a,createDocumentFragment:s,addElements:i};e.html5=C,u(t);var T=/^$|\b(?:all|print)\b/,N="html5shiv",_=!g&&function(){var n=t.documentElement;return!("undefined"==typeof t.namespaces||"undefined"==typeof t.parentWindow||"undefined"==typeof n.applyElement||"undefined"==typeof n.removeNode||"undefined"==typeof e.attachEvent)}();C.type+=" print",C.shivPrint=m,m(t),"object"==typeof module&&module.exports&&(module.exports=C)}("undefined"!=typeof e?e:this,t);var N={elem:u("modernizr")};S._q.push(function(){delete N.elem});var _={style:N.elem.style};S._q.unshift(function(){delete _.style});var z=(E.testProp=function(e,t,r){return h([e],n,t,r)},function(){function e(e,t){var i;return e?(t&&"string"!=typeof t||(t=u(t||"div")),e="on"+e,i=e in t,!i&&r&&(t.setAttribute||(t=u("div")),t.setAttribute(e,""),i="function"==typeof t[e],t[e]!==n&&(t[e]=n),t.removeAttribute(e)),i):!1}var r=!("onblur"in t.documentElement);return e}());E.hasEvent=z,S.addTest("inputsearchevent",z("search"));var k=E.testStyles=f,$=function(){var e=navigator.userAgent,t=e.match(/applewebkit\/([0-9]+)/gi)&&parseFloat(RegExp.$1),n=e.match(/w(eb)?osbrowser/gi),r=e.match(/windows phone/gi)&&e.match(/iemobile\/([0-9])+/gi)&&parseFloat(RegExp.$1)>=9,i=533>t&&e.match(/android/gi);return n||i||r}();$?S.addTest("fontface",!1):k('@font-face {font-family:"font";src:url("https://")}',function(e,n){var r=t.getElementById("smodernizr"),i=r.sheet||r.styleSheet,o=i?i.cssRules&&i.cssRules[0]?i.cssRules[0].cssText:i.cssText||"":"",a=/src/i.test(o)&&0===o.indexOf(n.split(" ")[0]);S.addTest("fontface",a)});var j="Moz O ms Webkit",P=E._config.usePrefixes?j.split(" "):[];E._cssomPrefixes=P;var A=E._config.usePrefixes?j.toLowerCase().split(" "):[];E._domPrefixes=A,E.testAllProps=v,E.testAllProps=y;var R="CSS"in e&&"supports"in e.CSS,F="supportsCSS"in e;S.addTest("supports",R||F),S.addTest("csstransforms3d",function(){var e=!!y("perspective","1px",!0),t=S._config.usePrefixes;if(e&&(!t||"webkitPerspective"in C.style)){var n,r="#modernizr{width:0;height:0}";S.supports?n="@supports (perspective: 1px)":(n="@media (transform-3d)",t&&(n+=",(-webkit-transform-3d)")),n+="{#modernizr{width:7px;height:18px;margin:0;padding:0;border:0}}",k(r+n,function(t){e=7===t.offsetWidth&&18===t.offsetHeight})}return e}),S.addTest("json","JSON"in e&&"parse"in JSON&&"stringify"in JSON),S.addTest("checked",function(){return k("#modernizr {position:absolute} #modernizr input {margin-left:10px} #modernizr :checked {margin-left:20px;display:block}",function(e){var t=u("input");return t.setAttribute("type","checkbox"),t.setAttribute("checked","checked"),e.appendChild(t),20===t.offsetLeft})}),S.addTest("target",function(){var t=e.document;if(!("querySelectorAll"in t))return!1;try{return t.querySelectorAll(":target"),!0}catch(n){return!1}}),S.addTest("contains",r(String.prototype.contains,"function")),i(),o(w),delete E.addTest,delete E.addAsyncTest;for(var M=0;M<S._q.length;M++)S._q[M]();e.Modernizr=S}(window,document),function(e){"use strict";e.matchMedia=e.matchMedia||function(e,t){var n,r=e.documentElement,i=r.firstElementChild||r.firstChild,o=e.createElement("body"),a=e.createElement("div");return a.id="mq-test-1",a.style.cssText="position:absolute;top:-100em",o.style.background="none",o.appendChild(a),function(e){return a.innerHTML='­<style media="'+e+'"> #mq-test-1 { width: 42px; }</style>',r.insertBefore(o,i),n=42===a.offsetWidth,r.removeChild(o),{matches:n,media:e}}}(e.document)}(this),function(e){"use strict";function t(){E(!0)}var n={};e.respond=n,n.update=function(){};var r=[],i=function(){var t=!1;try{t=new e.XMLHttpRequest}catch(n){t=new e.ActiveXObject("Microsoft.XMLHTTP")}return function(){return t}}(),o=function(e,t){var n=i();n&&(n.open("GET",e,!0),n.onreadystatechange=function(){4!==n.readyState||200!==n.status&&304!==n.status||t(n.responseText)},4!==n.readyState&&n.send(null))};if(n.ajax=o,n.queue=r,n.regex={media:/@media[^\{]+\{([^\{\}]*\{[^\}\{]*\})+/gi,keyframes:/@(?:\-(?:o|moz|webkit)\-)?keyframes[^\{]+\{(?:[^\{\}]*\{[^\}\{]*\})+[^\}]*\}/gi,urls:/(url\()['"]?([^\/\)'"][^:\)'"]+)['"]?(\))/g,findStyles:/@media *([^\{]+)\{([\S\s]+?)$/,only:/(only\s+)?([a-zA-Z]+)\s?/,minw:/\([\s]*min\-width\s*:[\s]*([\s]*[0-9\.]+)(px|em)[\s]*\)/,maxw:/\([\s]*max\-width\s*:[\s]*([\s]*[0-9\.]+)(px|em)[\s]*\)/},n.mediaQueriesSupported=e.matchMedia&&null!==e.matchMedia("only all")&&e.matchMedia("only all").matches,!n.mediaQueriesSupported){var a,s,l,u=e.document,c=u.documentElement,f=[],d=[],p=[],m={},h=30,g=u.getElementsByTagName("head")[0]||c,v=u.getElementsByTagName("base")[0],y=g.getElementsByTagName("link"),x=function(){var e,t=u.createElement("div"),n=u.body,r=c.style.fontSize,i=n&&n.style.fontSize,o=!1;return t.style.cssText="position:absolute;font-size:1em;width:1em",n||(n=o=u.createElement("body"),n.style.background="none"),c.style.fontSize="100%",n.style.fontSize="100%",n.appendChild(t),o&&c.insertBefore(n,c.firstChild),e=t.offsetWidth,o?c.removeChild(n):n.removeChild(t),c.style.fontSize=r,i&&(n.style.fontSize=i),e=l=parseFloat(e)},E=function(t){var n="clientWidth",r=c[n],i="CSS1Compat"===u.compatMode&&r||u.body[n]||r,o={},m=y[y.length-1],v=(new Date).getTime();if(t&&a&&h>v-a)return e.clearTimeout(s),void(s=e.setTimeout(E,h));a=v;for(var S in f)if(f.hasOwnProperty(S)){var b=f[S],w=b.minw,C=b.maxw,T=null===w,N=null===C,_="em";w&&(w=parseFloat(w)*(w.indexOf(_)>-1?l||x():1)),C&&(C=parseFloat(C)*(C.indexOf(_)>-1?l||x():1)),b.hasquery&&(T&&N||!(T||i>=w)||!(N||C>=i))||(o[b.media]||(o[b.media]=[]),o[b.media].push(d[b.rules]))}for(var z in p)p.hasOwnProperty(z)&&p[z]&&p[z].parentNode===g&&g.removeChild(p[z]);p.length=0;for(var k in o)if(o.hasOwnProperty(k)){var $=u.createElement("style"),j=o[k].join("\n");$.type="text/css",$.media=k,g.insertBefore($,m.nextSibling),$.styleSheet?$.styleSheet.cssText=j:$.appendChild(u.createTextNode(j)),p.push($)}},S=function(e,t,r){var i=e.replace(n.regex.keyframes,"").match(n.regex.media),o=i&&i.length||0;t=t.substring(0,t.lastIndexOf("/"));var a=function(e){return e.replace(n.regex.urls,"$1"+t+"$2$3")},s=!o&&r;t.length&&(t+="/"),s&&(o=1);for(var l=0;o>l;l++){var u,c,p,m;s?(u=r,d.push(a(e))):(u=i[l].match(n.regex.findStyles)&&RegExp.$1,d.push(RegExp.$2&&a(RegExp.$2))),p=u.split(","),m=p.length;for(var h=0;m>h;h++)c=p[h],f.push({media:c.split("(")[0].match(n.regex.only)&&RegExp.$2||"all",rules:d.length-1,hasquery:c.indexOf("(")>-1,minw:c.match(n.regex.minw)&&parseFloat(RegExp.$1)+(RegExp.$2||""),maxw:c.match(n.regex.maxw)&&parseFloat(RegExp.$1)+(RegExp.$2||"")})}E()},b=function(){if(r.length){var t=r.shift();o(t.href,function(n){S(n,t.href,t.media),m[t.href]=!0,e.setTimeout(function(){b()},0)})}},w=function(){for(var t=0;t<y.length;t++){var n=y[t],i=n.href,o=n.media,a=n.rel&&"stylesheet"===n.rel.toLowerCase();i&&a&&!m[i]&&(n.styleSheet&&n.styleSheet.rawCssText?(S(n.styleSheet.rawCssText,i,o),m[i]=!0):(!/^([a-zA-Z:]*\/\/)/.test(i)&&!v||i.replace(RegExp.$1,"").split("/")[0]===e.location.host)&&("//"===i.substring(0,2)&&(i=e.location.protocol+i),r.push({href:i,media:o})))}b()};w(),n.update=w,n.getEmValue=x,e.addEventListener?e.addEventListener("resize",t,!1):e.attachEvent&&e.attachEvent("onresize",t)}}(this);
\ No newline at end of file
diff --git a/language/arrays/index.html b/language/arrays/index.html
new file mode 100644
index 0000000..426d5cf
--- /dev/null
+++ b/language/arrays/index.html
@@ -0,0 +1,558 @@
+<!DOCTYPE html>
+
+
+
+
+ <html class="no-js">
+
+ <head lang="en-us">
+ <meta charset="utf-8">
+ <meta name="viewport" content="width=device-width,user-scalable=no,initial-scale=1,maximum-scale=1">
+ <meta http-equiv="X-UA-Compatible" content="IE=10" />
+ <title>Arrays - Eclipse Mita</title>
+ <meta name="generator" content="Hugo 0.42.1" />
+
+
+ <meta name="description" content="The documentation of Eclipse Mita.">
+
+ <link rel="canonical" href="../../language/arrays/">
+
+
+ <meta property="og:url" content="/language/arrays/">
+ <meta property="og:title" content="Eclipse Mita">
+ <meta property="og:image" content="/images/mita.svg">
+ <meta name="apple-mobile-web-app-title" content="Eclipse Mita">
+ <meta name="apple-mobile-web-app-capable" content="yes">
+ <meta name="apple-mobile-web-app-status-bar-style" content="black-translucent">
+
+ <link rel="shortcut icon" type="image/x-icon" href="../../images/favicon.ico">
+ <link rel="icon" type="image/x-icon" href="../../images/favicon.ico">
+
+ <style>
+ @font-face {
+ font-family: 'Icon';
+ src: url('/fonts/icon.eot');
+ src: url('/fonts/icon.eot')
+ format('embedded-opentype'),
+ url('/fonts/icon.woff')
+ format('woff'),
+ url('/fonts/icon.ttf')
+ format('truetype'),
+ url('/fonts/icon.svg')
+ format('svg');
+ font-weight: normal;
+ font-style: normal;
+ }
+ </style>
+
+ <link rel="stylesheet" href="../../stylesheets/application.css">
+ <link rel="stylesheet" href="../../stylesheets/temporary.css">
+ <link rel="stylesheet" href="../../stylesheets/palettes.css">
+ <link rel="stylesheet" href="../../stylesheets/highlight/highlight.css">
+
+
+
+
+ <link rel="stylesheet" href="//fonts.googleapis.com/css?family=Ubuntu:400,700|Ubuntu+Mono">
+ <style>
+ body, input {
+ font-family: 'Ubuntu', Helvetica, Arial, sans-serif;
+ }
+ pre, code {
+ font-family: 'Ubuntu Mono', 'Courier New', 'Courier', monospace;
+ }
+ </style>
+
+
+ <link rel="stylesheet" href="../../css/custom.css">
+
+ <script src="../../javascripts/modernizr.js"></script>
+
+
+
+ </head>
+ <body class="palette-primary-blue-grey palette-accent-light-blue">
+
+
+
+
+<div class="backdrop">
+ <div class="backdrop-paper"></div>
+</div>
+
+<input class="toggle" type="checkbox" id="toggle-drawer">
+<input class="toggle" type="checkbox" id="toggle-search">
+<label class="toggle-button overlay" for="toggle-drawer"></label>
+
+<header class="header">
+ <nav aria-label="Header">
+ <div class="bar default">
+ <div class="button button-menu" role="button" aria-label="Menu">
+ <label class="toggle-button icon icon-menu" for="toggle-drawer">
+ <span></span>
+ </label>
+ </div>
+ <div class="stretch">
+ <div class="title">
+ Arrays
+ </div>
+ </div>
+
+
+ <div class="button button-twitter" role="button" aria-label="Twitter">
+ <a href="https://twitter.com/eclipse_mita" title="@eclipse_mita on Twitter" target="_blank" class="toggle-button icon icon-twitter"></a>
+ </div>
+
+
+
+ <div class="button button-github" role="button" aria-label="GitHub">
+ <a href="https://github.com/eclipse/mita" title="@eclipse/mita on GitHub" target="_blank" class="toggle-button icon icon-github"></a>
+ </div>
+
+
+
+ </div>
+ <div class="bar search">
+ <div class="button button-close" role="button" aria-label="Close">
+ <label class="toggle-button icon icon-back" for="toggle-search"></label>
+ </div>
+ <div class="stretch">
+ <div class="field">
+ <input class="query" type="text" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck>
+ </div>
+ </div>
+ <div class="button button-reset" role="button" aria-label="Search">
+ <button class="toggle-button icon icon-close" id="reset-search"></button>
+ </div>
+ </div>
+</nav>
+</header>
+
+<main class="main">
+ <div class="drawer">
+ <nav aria-label="Navigation">
+ <a href="../../" class="project">
+ <div class="banner">
+
+ <div class="logo">
+ <img src="../../images/mita.svg">
+ </div>
+
+ <div class="name">
+ <strong>Eclipse Mita </strong>
+
+ </div>
+ </div>
+ </a>
+
+ <div class="scrollable">
+ <div class="wrapper">
+
+
+ <div class="toc">
+
+ <ul>
+
+
+
+
+
+<li>
+
+
+
+
+
+<a title="Download" href="http://github.com/eclipse/mita">
+
+ Download
+</a>
+
+
+
+
+</li>
+
+
+
+<li>
+
+
+
+
+
+<a title="Concepts" href="../../concepts/">
+
+ Concepts
+</a>
+
+
+
+
+</li>
+
+
+
+<li>
+
+ <span class="section">Language</span>
+ <ul>
+
+
+
+
+
+
+<a title="Introduction" href="../../language/introduction/">
+
+ Introduction
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Basics" href="../../language/basics/">
+
+ Basics
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Packages" href="../../language/packages/">
+
+ Packages
+</a>
+
+
+
+
+
+
+
+
+
+<a title="System Setup" href="../../language/setup/">
+
+ System Setup
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Types" href="../../language/types/">
+
+ Types
+</a>
+
+
+
+
+
+
+
+
+
+<a class="current" title="Arrays" href="../../language/arrays/">
+
+ Arrays
+</a>
+
+
+<ul id="scrollspy">
+</ul>
+
+
+
+
+
+
+
+
+<a title="Functions" href="../../language/functions/">
+
+ Functions
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Foreign Function Interface" href="../../language/foreignfunctioninterface/">
+
+ Foreign Function Interface
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Events" href="../../language/events/">
+
+ Events
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Exceptions" href="../../language/exceptions/">
+
+ Exceptions
+</a>
+
+
+
+
+ </ul>
+
+</li>
+
+
+
+<li>
+
+ <span class="section">Platforms</span>
+ <ul>
+
+
+
+
+
+
+<a title="XDK110" href="../../platforms/xdk110/">
+
+ XDK110
+</a>
+
+
+
+
+ </ul>
+
+</li>
+
+
+ </ul>
+
+
+
+ </div>
+ </div>
+ </div>
+</nav>
+
+ </div>
+
+ <article class="article">
+ <div class="wrapper">
+ <h1>Arrays </h1>
+
+
+
+<p>Arrays are a fixed-size sequence of objects. In Mita, arrays can hold any type:</p>
+<div class="highlight"><pre class="chroma"><code class="language-TypeScript" data-lang="TypeScript"><span class="kd">var</span> <span class="nx">array1</span> : <span class="kt">array</span><span class="o"><</span><span class="nx">int32</span><span class="o">></span><span class="p">;</span>
+
+<span class="nx">struct</span> <span class="nx">vec2d</span> <span class="p">{</span>
+ <span class="kd">var</span> <span class="nx">x</span> : <span class="kt">int32</span><span class="p">;</span>
+ <span class="kd">var</span> <span class="nx">y</span> : <span class="kt">int32</span><span class="p">;</span>
+<span class="p">}</span>
+<span class="kd">let</span> <span class="nx">array2</span> : <span class="kt">array</span><span class="o"><</span><span class="nx">vec2d</span><span class="o">></span><span class="p">;</span></code></pre></div>
+<h2 id="initialization">Initialization</h2>
+
+<p>There are multiple ways to initialize and fill arrays:</p>
+<div class="highlight"><pre class="chroma"><code class="language-TypeScript" data-lang="TypeScript"><span class="kd">let</span> <span class="nx">array1</span> : <span class="kt">array</span><span class="o"><</span><span class="nx">int32</span><span class="o">></span> <span class="o">=</span> <span class="k">new</span> <span class="nx">array</span><span class="o"><</span><span class="nx">int32</span><span class="o">></span><span class="p">(</span><span class="nx">size</span> <span class="o">=</span> <span class="mi">10</span><span class="p">);</span>
+<span class="kd">let</span> <span class="nx">array2</span> : <span class="kt">array</span><span class="o"><</span><span class="nx">int32</span><span class="o">></span> <span class="o">=</span> <span class="p">[</span><span class="mi">1</span><span class="p">,</span><span class="mi">2</span><span class="p">,</span><span class="mi">3</span><span class="p">,</span><span class="mi">4</span><span class="p">];</span></code></pre></div>
+<h2 id="length">Length</h2>
+
+<p>Mita arrays know how long arrays are, unlike C arrays. This allows you to do a lot of things with arrays without knowing their size.</p>
+<div class="highlight"><pre class="chroma"><code class="language-TypeScript" data-lang="TypeScript"><span class="nx">fn</span> <span class="nx">sum</span><span class="p">(</span><span class="nx">a</span> : <span class="kt">array</span><span class="o"><</span><span class="nx">int32</span><span class="o">></span><span class="p">)</span> <span class="p">{</span>
+ <span class="kd">var</span> <span class="nx">result</span> <span class="o">=</span> <span class="mi">0</span><span class="p">;</span>
+ <span class="k">for</span><span class="p">(</span><span class="kd">var</span> <span class="nx">i</span> <span class="o">=</span> <span class="mi">0</span><span class="p">;</span> <span class="nx">i</span> <span class="o"><</span> <span class="nx">a</span><span class="p">.</span><span class="nx">length</span><span class="p">();</span> <span class="nx">i</span><span class="o">++</span><span class="p">)</span> <span class="p">{</span>
+ <span class="nx">result</span> <span class="o">+=</span> <span class="nx">a</span><span class="p">[</span><span class="nx">i</span><span class="p">];</span>
+ <span class="p">}</span>
+ <span class="k">return</span> <span class="nx">result</span><span class="p">;</span>
+<span class="p">}</span></code></pre></div>
+<p>The only exception to that is returning arrays. While we try hard to do <a href="../../concepts/#element-size-inference">element size inference</a>, in some cases we fail to correctly infer the size of your array and inform you about it. In that case you need to manually specify the array length:</p>
+<div class="highlight"><pre class="chroma"><code class="language-TypeScript" data-lang="TypeScript"><span class="nx">fn</span> <span class="nx">returnsArray</span><span class="p">()</span><span class="o">:</span> <span class="nx">array</span><span class="o"><</span><span class="nx">int32</span><span class="o">></span> <span class="p">{</span>
+ <span class="kd">let</span> <span class="nx">array1</span> <span class="o">=</span> <span class="k">new</span> <span class="nx">array</span><span class="o"><</span><span class="nx">int32</span><span class="o">></span><span class="p">(</span><span class="nx">size</span> <span class="o">=</span> <span class="mi">10</span><span class="p">);</span>
+ <span class="k">return</span> <span class="nx">array1</span><span class="p">;</span>
+<span class="p">}</span></code></pre></div>
+<h2 id="access">Access</h2>
+
+<p>You access arrays using the familiar square brackets <code>[]</code>:</p>
+<div class="highlight"><pre class="chroma"><code class="language-TypeScript" data-lang="TypeScript"><span class="kd">let</span> <span class="nx">array1</span> <span class="o">=</span> <span class="p">[</span><span class="mi">1</span><span class="p">,</span><span class="mi">2</span><span class="p">,</span><span class="mi">3</span><span class="p">,</span><span class="mi">4</span><span class="p">,</span><span class="mi">5</span><span class="p">];</span>
+<span class="kd">let</span> <span class="nx">v1</span> <span class="o">=</span> <span class="nx">array1</span><span class="p">[</span><span class="mi">1</span><span class="p">];</span>
+<span class="nx">array1</span><span class="p">[</span><span class="mi">2</span><span class="p">]</span> <span class="o">=</span> <span class="nx">v1</span><span class="p">;</span></code></pre></div>
+<h2 id="slices">Slices</h2>
+
+<div class="admonition warning">
+<p class="admonition-title">Copy by value</p>
+<p>Everything is copy by value!</p>
+</div>
+
+<p>If you only need to take some parts of your array, you can use slices. A slice of an array is a <strong>copy</strong> of part of the array. For example, in the following code, <code>array2</code> contains the values <code>[2, 3]</code>:</p>
+<div class="highlight"><pre class="chroma"><code class="language-TypeScript" data-lang="TypeScript"><span class="kd">let</span> <span class="nx">array1</span> <span class="o">=</span> <span class="p">[</span><span class="mi">1</span><span class="p">,</span><span class="mi">2</span><span class="p">,</span><span class="mi">3</span><span class="p">,</span><span class="mi">4</span><span class="p">,</span><span class="mi">5</span><span class="p">];</span>
+<span class="kd">let</span> <span class="nx">array2</span> <span class="o">=</span> <span class="nx">array1</span><span class="p">[</span><span class="nx">1</span>:<span class="kt">3</span><span class="p">];</span></code></pre></div>
+<p>You can leave out the upper or lower bound of the slice, or both.</p>
+
+<h2 id="bounds-checks">Bounds checks</h2>
+
+<p>Whenever you access parts of an array, be it by direct access or slices, we need to do a bounds check. In many cases this doesn’t impart any runtime impact, since we can infer the bounds statically. If we can’t, we generate bounds checks and throw an <code>IndexOutOfBoundsException</code> on failure. See <a href="../../language/exceptions/">Exceptions</a> for more info.</p>
+
+
+ <aside class="copyright" role="note">
+
+ © 2018 The Eclipse Mita Project –
+
+ Documentation built with
+ <a href="https://www.gohugo.io" target="_blank">Hugo</a>
+ using the
+ <a href="http://github.com/digitalcraftsman/hugo-material-docs" target="_blank">Material</a> theme.
+ </aside>
+
+ <footer class="footer">
+
+
+<nav class="pagination" aria-label="Footer">
+ <div class="previous">
+
+ <a href="../../language/types/" title="Types">
+ <span class="direction">
+ Previous
+ </span>
+ <div class="page">
+ <div class="button button-previous" role="button" aria-label="Previous">
+ <i class="icon icon-back"></i>
+ </div>
+ <div class="stretch">
+ <div class="title">
+ Types
+ </div>
+ </div>
+ </div>
+ </a>
+
+ </div>
+
+ <div class="next">
+
+ <a href="../../language/functions/" title="Functions">
+ <span class="direction">
+ Next
+ </span>
+ <div class="page">
+ <div class="stretch">
+ <div class="title">
+ Functions
+ </div>
+ </div>
+ <div class="button button-next" role="button" aria-label="Next">
+ <i class="icon icon-forward"></i>
+ </div>
+ </div>
+ </a>
+
+ </div>
+</nav>
+
+
+
+
+
+ </footer>
+ </div>
+ </article>
+
+ <div class="results" role="status" aria-live="polite">
+ <div class="scrollable">
+ <div class="wrapper">
+ <div class="meta"></div>
+ <div class="list"></div>
+ </div>
+ </div>
+ </div>
+</main>
+
+ <script>
+
+ var base_url = '';
+ var repo_id = '';
+
+ </script>
+
+ <script src="../../javascripts/application.js"></script>
+
+
+ <script>
+ /* Add headers to scrollspy */
+ var headers = document.getElementsByTagName("h2");
+ var scrollspy = document.getElementById('scrollspy');
+
+ if(scrollspy) {
+ if(headers.length > 0) {
+ for(var i = 0; i < headers.length; i++) {
+ var li = document.createElement("li");
+ li.setAttribute("class", "anchor");
+
+ var a = document.createElement("a");
+ a.setAttribute("href", "#" + headers[i].id);
+ a.setAttribute("title", headers[i].innerHTML);
+ a.innerHTML = headers[i].innerHTML;
+
+ li.appendChild(a)
+ scrollspy.appendChild(li);
+ }
+ } else {
+ scrollspy.parentElement.removeChild(scrollspy)
+ }
+
+
+ /* Add permanent link next to the headers */
+ var headers = document.querySelectorAll("h1, h2, h3, h4, h5, h6");
+
+ for(var i = 0; i < headers.length; i++) {
+ var a = document.createElement("a");
+ a.setAttribute("class", "headerlink");
+ a.setAttribute("href", "#" + headers[i].id);
+ a.setAttribute("title", "Permanent link")
+ a.innerHTML = "#";
+ headers[i].appendChild(a);
+ }
+ }
+ </script>
+
+
+
+ <script src="//cdnjs.cloudflare.com/ajax/libs/highlight.js/9.8.0/highlight.min.js"></script>
+ <script>hljs.initHighlightingOnLoad();</script>
+ </body>
+</html>
+
diff --git a/language/basics/index.html b/language/basics/index.html
new file mode 100644
index 0000000..107de4f
--- /dev/null
+++ b/language/basics/index.html
@@ -0,0 +1,676 @@
+<!DOCTYPE html>
+
+
+
+
+ <html class="no-js">
+
+ <head lang="en-us">
+ <meta charset="utf-8">
+ <meta name="viewport" content="width=device-width,user-scalable=no,initial-scale=1,maximum-scale=1">
+ <meta http-equiv="X-UA-Compatible" content="IE=10" />
+ <title>Basics - Eclipse Mita</title>
+ <meta name="generator" content="Hugo 0.42.1" />
+
+
+ <meta name="description" content="The documentation of Eclipse Mita.">
+
+ <link rel="canonical" href="../../language/basics/">
+
+
+ <meta property="og:url" content="/language/basics/">
+ <meta property="og:title" content="Eclipse Mita">
+ <meta property="og:image" content="/images/mita.svg">
+ <meta name="apple-mobile-web-app-title" content="Eclipse Mita">
+ <meta name="apple-mobile-web-app-capable" content="yes">
+ <meta name="apple-mobile-web-app-status-bar-style" content="black-translucent">
+
+ <link rel="shortcut icon" type="image/x-icon" href="../../images/favicon.ico">
+ <link rel="icon" type="image/x-icon" href="../../images/favicon.ico">
+
+ <style>
+ @font-face {
+ font-family: 'Icon';
+ src: url('/fonts/icon.eot');
+ src: url('/fonts/icon.eot')
+ format('embedded-opentype'),
+ url('/fonts/icon.woff')
+ format('woff'),
+ url('/fonts/icon.ttf')
+ format('truetype'),
+ url('/fonts/icon.svg')
+ format('svg');
+ font-weight: normal;
+ font-style: normal;
+ }
+ </style>
+
+ <link rel="stylesheet" href="../../stylesheets/application.css">
+ <link rel="stylesheet" href="../../stylesheets/temporary.css">
+ <link rel="stylesheet" href="../../stylesheets/palettes.css">
+ <link rel="stylesheet" href="../../stylesheets/highlight/highlight.css">
+
+
+
+
+ <link rel="stylesheet" href="//fonts.googleapis.com/css?family=Ubuntu:400,700|Ubuntu+Mono">
+ <style>
+ body, input {
+ font-family: 'Ubuntu', Helvetica, Arial, sans-serif;
+ }
+ pre, code {
+ font-family: 'Ubuntu Mono', 'Courier New', 'Courier', monospace;
+ }
+ </style>
+
+
+ <link rel="stylesheet" href="../../css/custom.css">
+
+ <script src="../../javascripts/modernizr.js"></script>
+
+
+
+ </head>
+ <body class="palette-primary-blue-grey palette-accent-light-blue">
+
+
+
+
+<div class="backdrop">
+ <div class="backdrop-paper"></div>
+</div>
+
+<input class="toggle" type="checkbox" id="toggle-drawer">
+<input class="toggle" type="checkbox" id="toggle-search">
+<label class="toggle-button overlay" for="toggle-drawer"></label>
+
+<header class="header">
+ <nav aria-label="Header">
+ <div class="bar default">
+ <div class="button button-menu" role="button" aria-label="Menu">
+ <label class="toggle-button icon icon-menu" for="toggle-drawer">
+ <span></span>
+ </label>
+ </div>
+ <div class="stretch">
+ <div class="title">
+ Basics
+ </div>
+ </div>
+
+
+ <div class="button button-twitter" role="button" aria-label="Twitter">
+ <a href="https://twitter.com/eclipse_mita" title="@eclipse_mita on Twitter" target="_blank" class="toggle-button icon icon-twitter"></a>
+ </div>
+
+
+
+ <div class="button button-github" role="button" aria-label="GitHub">
+ <a href="https://github.com/eclipse/mita" title="@eclipse/mita on GitHub" target="_blank" class="toggle-button icon icon-github"></a>
+ </div>
+
+
+
+ </div>
+ <div class="bar search">
+ <div class="button button-close" role="button" aria-label="Close">
+ <label class="toggle-button icon icon-back" for="toggle-search"></label>
+ </div>
+ <div class="stretch">
+ <div class="field">
+ <input class="query" type="text" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck>
+ </div>
+ </div>
+ <div class="button button-reset" role="button" aria-label="Search">
+ <button class="toggle-button icon icon-close" id="reset-search"></button>
+ </div>
+ </div>
+</nav>
+</header>
+
+<main class="main">
+ <div class="drawer">
+ <nav aria-label="Navigation">
+ <a href="../../" class="project">
+ <div class="banner">
+
+ <div class="logo">
+ <img src="../../images/mita.svg">
+ </div>
+
+ <div class="name">
+ <strong>Eclipse Mita </strong>
+
+ </div>
+ </div>
+ </a>
+
+ <div class="scrollable">
+ <div class="wrapper">
+
+
+ <div class="toc">
+
+ <ul>
+
+
+
+
+
+<li>
+
+
+
+
+
+<a title="Download" href="http://github.com/eclipse/mita">
+
+ Download
+</a>
+
+
+
+
+</li>
+
+
+
+<li>
+
+
+
+
+
+<a title="Concepts" href="../../concepts/">
+
+ Concepts
+</a>
+
+
+
+
+</li>
+
+
+
+<li>
+
+ <span class="section">Language</span>
+ <ul>
+
+
+
+
+
+
+<a title="Introduction" href="../../language/introduction/">
+
+ Introduction
+</a>
+
+
+
+
+
+
+
+
+
+<a class="current" title="Basics" href="../../language/basics/">
+
+ Basics
+</a>
+
+
+<ul id="scrollspy">
+</ul>
+
+
+
+
+
+
+
+
+<a title="Packages" href="../../language/packages/">
+
+ Packages
+</a>
+
+
+
+
+
+
+
+
+
+<a title="System Setup" href="../../language/setup/">
+
+ System Setup
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Types" href="../../language/types/">
+
+ Types
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Arrays" href="../../language/arrays/">
+
+ Arrays
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Functions" href="../../language/functions/">
+
+ Functions
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Foreign Function Interface" href="../../language/foreignfunctioninterface/">
+
+ Foreign Function Interface
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Events" href="../../language/events/">
+
+ Events
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Exceptions" href="../../language/exceptions/">
+
+ Exceptions
+</a>
+
+
+
+
+ </ul>
+
+</li>
+
+
+
+<li>
+
+ <span class="section">Platforms</span>
+ <ul>
+
+
+
+
+
+
+<a title="XDK110" href="../../platforms/xdk110/">
+
+ XDK110
+</a>
+
+
+
+
+ </ul>
+
+</li>
+
+
+ </ul>
+
+
+
+ </div>
+ </div>
+ </div>
+</nav>
+
+ </div>
+
+ <article class="article">
+ <div class="wrapper">
+ <h1>Basics </h1>
+
+
+
+<h2 id="variables">Variables</h2>
+
+<p>By default, variables in Mita are immutable, which helps us optimize the generated code.
+However, you can always choose to make variables mutable if you need it.
+When a variable is immutable, its value has to be set during declaration and cannot be changed afterwards.
+The following code snippet illustrates the idea (we’ve omitted the package and import statements for brevity):</p>
+<div class="highlight"><pre class="chroma"><code class="language-TypeScript" data-lang="TypeScript"><span class="nx">fn</span> <span class="nx">main() {</span>
+ <span class="kd">let</span> <span class="nx">x</span> <span class="o">=</span> <span class="mi">42</span><span class="p">;</span>
+ <span class="nx">println</span><span class="p">(</span><span class="sb">`The value of x is </span><span class="si">${</span><span class="nx">x</span><span class="si">}</span><span class="sb">`</span><span class="p">);</span>
+
+ <span class="nx">x</span> <span class="o">=</span> <span class="mi">64</span><span class="p">;</span>
+ <span class="nx">println</span><span class="p">(</span><span class="sb">`The value of x is now </span><span class="si">${</span><span class="nx">x</span><span class="si">}</span><span class="sb">`</span><span class="p">);</span>
+<span class="p">}</span></code></pre></div>
+<p>When you save this code, you will see an error message <code>Assignment to constant not allowed.</code> at the <code>x = 64</code> statement.
+That’s the compiler enforcing the immutability of <code>x</code>.</p>
+
+<p><img src="immutableAssignmentError.png" alt="Error assigning to constant" /></p>
+
+<p>To make variables mutable, use the <code>var</code> keyword. Then, you can re-assign a value to the variable after it was declared.
+For example</p>
+<div class="highlight"><pre class="chroma"><code class="language-TypeScript" data-lang="TypeScript"><span class="kd">var</span> <span class="nx">x</span> <span class="o">=</span> <span class="mi">42</span><span class="p">;</span>
+<span class="nx">x</span> <span class="o">=</span> <span class="mi">64</span><span class="p">;</span></code></pre></div>
+<p>does not produce any compiler errors, unlike the example above. Because we wrote <code>var</code> instead of <code>let</code>, <code>x</code> became mutable and thus could be re-assigned to a different value.</p>
+
+<div class="admonition note">
+<p class="admonition-title">Tip: be immutable where you can</p>
+<p>Using mutable variables instead of immutable ones can lead to less efficient code being generated.
+Thus, as a rule of thumb use immutable variables where you can.</p>
+</div>
+
+<h3 id="types-and-type-inference">Types and Type Inference</h3>
+
+<p>Until now we have never had to write the type of the variables we declared.
+Mita supports <em>type inference</em> so that you, the developer, does not have to tell the compiler things it already knows.
+However, there are times when we are unable to infer the type of a variable, for example when it is not initialized, or the compiler gets the type wrong.
+In those cases you can explicitly tell the compiler what type a variable should have. For example:</p>
+<div class="highlight"><pre class="chroma"><code class="language-TypeScript" data-lang="TypeScript"><span class="kd">let</span> <span class="nx">x</span> : <span class="kt">uint8</span> <span class="o">=</span> <span class="mi">20</span><span class="p">;</span> <span class="c1">// x is forced to be uint8, compared to the otherwise inferred int32
+</span><span class="c1"></span><span class="kd">var</span> <span class="nx">y</span> : <span class="kt">int16</span><span class="p">;</span> <span class="err">// y does not have an explicit initialization, so we need to explicitly denote the type.</span></code></pre></div>
+<p>This syntax for specifying types is consistent throughout the language. You can use it to specify the types of function parameters, the return type of a function or the types of structure members.</p>
+
+<h3 id="scoping-and-shadowing">Scoping and Shadowing</h3>
+
+<p>In Mita variables are block scoped and there is no shadowing within the same block. This is unlike languages like Rust or Haskell, for example, where one would be able to re-use the same name in multiple variable declarations.
+The following is not legal Mita code, the compiler will complain that it <code>Cannot redeclare variable 'x'</code>.</p>
+<div class="highlight"><pre class="chroma"><code class="language-TypeScript" data-lang="TypeScript"><span class="nx">fn</span> <span class="nx">main() {</span>
+ <span class="kd">let</span> <span class="nx">x</span> <span class="o">=</span> <span class="mi">42</span><span class="p">;</span>
+ <span class="kd">let</span> <span class="nx">x</span> <span class="o">=</span> <span class="nx">x</span> <span class="o">*</span> <span class="mi">2</span><span class="p">;</span> <span class="c1">// Compiler error: Cannot redeclare variable 'x'
+</span><span class="c1"></span> <span class="kd">let</span> <span class="nx">x</span> <span class="o">=</span> <span class="nx">x</span> <span class="o">*</span> <span class="mi">3</span><span class="p">;</span> <span class="c1">// Compiler error: Cannot redeclare variable 'x'
+</span><span class="c1"></span><span class="p">}</span></code></pre></div>
+<p>However, in a new block one can shadow a variable declared outside that block. The following code, for example, works just fine as it takes the <code>x</code> declared outside the <em>if block</em>, multiplies it by two and stores it in a <em>new immutable variable</em> also named x.</p>
+<div class="highlight"><pre class="chroma"><code class="language-TypeScript" data-lang="TypeScript"><span class="nx">fn</span> <span class="nx">main() {</span>
+ <span class="kd">let</span> <span class="nx">x</span> <span class="o">=</span> <span class="mi">42</span><span class="p">;</span>
+
+ <span class="k">if</span><span class="p">(</span><span class="kc">true</span><span class="p">)</span> <span class="p">{</span>
+ <span class="kd">let</span> <span class="nx">x</span> <span class="o">=</span> <span class="nx">x</span> <span class="o">*</span> <span class="mi">2</span><span class="p">;</span>
+ <span class="nx">println</span><span class="p">(</span><span class="sb">`x in block equals </span><span class="si">${</span><span class="nx">x</span><span class="si">}</span><span class="sb">`</span><span class="p">);</span> <span class="c1">// Output: x in block equals 84
+</span><span class="c1"></span> <span class="p">}</span>
+
+ <span class="nx">println</span><span class="p">(</span><span class="sb">`x outside block equals </span><span class="si">${</span><span class="nx">x</span><span class="si">}</span><span class="sb">`</span><span class="p">);</span> <span class="c1">// Output: x outside block equals 42
+</span><span class="c1"></span><span class="p">}</span></code></pre></div>
+<h2 id="primitive-data-types">Primitive Data Types</h2>
+
+<p><a href="#types-and-type-inference">Previously</a> we have seen that Mita is a statically typed language, meaning that every expression in Mita has a data type, fixed at compile time.
+We distinguish between primitive and complex data types. Primitive data types consist of a single value, such as a number or a flag (other <a href="https://doc.rust-lang.org/book/second-edition/ch03-02-data-types.html">languages</a> call those <em>scalar data types</em>).
+Mita has three groups of primitive data types: integer, float and boolean.</p>
+
+<h3 id="integer">Integer</h3>
+
+<p>An integer is a “whole number”, i.e. one without a fraction. We already used integers in the previous section, specifically the <code>uint8</code> and <code>int16</code> types.
+All integer types prefixed with a <code>u</code> are <em>unsigned</em> types, meaning that they store positive values only but have a wider range than their signed counterparts.
+The number at the end of the type indicates their <em>width</em> in bits, that is how large a number they can store.</p>
+
+<table>
+<thead>
+<tr>
+<th>Width</th>
+<th>Signed</th>
+<th>Unsigned</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td>8 bit</td>
+<td><code>int8</code></td>
+<td><code>uint8</code></td>
+</tr>
+
+<tr>
+<td>16 bit</td>
+<td><code>int16</code></td>
+<td><code>uint16</code></td>
+</tr>
+
+<tr>
+<td>32 bit</td>
+<td><code>int32</code></td>
+<td><code>uint32</code></td>
+</tr>
+</tbody>
+</table>
+
+<p>Each signed type can store values from -2<sup>(n-1)</sup> to 2<sup>(n-1)</sup> - 1, unsigned types can store values ranging from 0 to 2<sup>n</sup> - 1, where <code>n</code> is the width of the data type. For example, <code>uint8</code> can store integers up to 2<sup>8</sup>-1 = 255.</p>
+
+<p>You can write integer literals either in decimal form (e.g. <code>42</code>) or in hexadecimal form (<code>0xFF</code>). If you don’t specify a type explicitly the compiler will infer the concrete data type based on first use. For example:</p>
+<div class="highlight"><pre class="chroma"><code class="language-TypeScript" data-lang="TypeScript"><span class="nx">fn</span> <span class="nx">addOne</span><span class="p">(</span><span class="nx">x</span> : <span class="kt">int16</span><span class="p">)</span> <span class="p">{</span>
+ <span class="k">return</span> <span class="nx">x</span> <span class="o">+</span> <span class="mi">1</span><span class="p">;</span>
+<span class="p">}</span>
+
+<span class="nx">fn</span> <span class="nx">main() {</span>
+ <span class="kd">let</span> <span class="nx">y</span> <span class="o">=</span> <span class="nx">addOne</span><span class="p">(</span><span class="mi">42</span><span class="p">);</span> <span class="c1">// 42 is infered as int16
+</span><span class="c1"></span><span class="p">}</span></code></pre></div>
+<h3 id="floating-point">Floating Point</h3>
+
+<p>Mita supports a 32 bit wide single precision <code>float</code> datatype and a 64 bit wide double precision <code>double</code> floating point number type.
+By default floating point literals (e.g. <code>1.0</code>) are inferred as single precision <code>float</code>.</p>
+
+<h3 id="boolean">Boolean</h3>
+
+<p>Like in most other programming languages Mita supports a boolean type with two possible values: <code>true</code> and <code>false</code>. The boolean type in Mita is called <code>bool</code>. For example:</p>
+<div class="highlight"><pre class="chroma"><code class="language-TypeScript" data-lang="TypeScript"><span class="nx">fn</span> <span class="nx">main() {</span>
+ <span class="kd">let</span> <span class="nx">isTrue</span> <span class="o">=</span> <span class="kc">true</span><span class="p">;</span>
+ <span class="kd">let</span> <span class="nx">falseByDefault</span> : <span class="kt">bool</span><span class="p">;</span> <span class="c1">// with explicit type, bool defaults to false.
+</span><span class="c1"></span>
+ <span class="k">if</span><span class="p">(</span><span class="nx">isTrue</span><span class="p">)</span> <span class="p">{</span>
+ <span class="nx">println</span><span class="p">(</span><span class="s2">"It is true!"</span><span class="p">);</span>
+ <span class="p">}</span>
+<span class="p">}</span></code></pre></div>
+<h3 id="operations-on-primitive-types">Operations on Primitive Types</h3>
+
+<p>Mita supports a range of operations on primitive values. These operations are supported on operands of the same type, or compatible smaller types (e.g. <code>int32 + int16</code>). No worries though, the compiler will tell you what’s allowed and what isn’t.</p>
+
+<ul>
+<li>multiplication: <code>*</code></li>
+<li>addition: <code>+</code></li>
+<li>subtraction: <code>-</code></li>
+<li>division: <code>/</code></li>
+<li>bit-wise negation: <code>~</code></li>
+<li>bit-shift left: <code><<</code></li>
+<li>bit-shift right: <code>>></code></li>
+<li>logical negation (bool only): <code>!</code></li>
+</ul>
+
+<h3 id="complex-types">Complex Types</h3>
+
+<p>Complex data types (such as strings or structures) need more elaboration than a single section could encompass. Head over to the <a href="../../language/types/">types section</a> to find out more.</p>
+
+<h2 id="control-structures">Control Structures</h2>
+
+<p>Code can branch using if statements</p>
+<div class="highlight"><pre class="chroma"><code class="language-TypeScript" data-lang="TypeScript"><span class="kd">let</span> <span class="nx">foo</span> <span class="o">=</span> <span class="mi">10</span><span class="p">;</span>
+<span class="k">if</span><span class="p">(</span><span class="nx">foo</span> <span class="o">>=</span> <span class="mi">15</span><span class="p">)</span> <span class="p">{</span>
+ <span class="nx">println</span><span class="p">(</span><span class="s2">"That's high"</span><span class="p">);</span>
+<span class="p">}</span> <span class="k">else</span> <span class="k">if</span><span class="p">(</span><span class="nx">foo</span> <span class="o">>=</span> <span class="mi">10</span><span class="p">)</span> <span class="p">{</span>
+ <span class="nx">println</span><span class="p">(</span><span class="s2">"That's less high"</span><span class="p">);</span>
+<span class="p">}</span> <span class="k">else</span> <span class="p">{</span>
+ <span class="nx">println</span><span class="p">(</span><span class="s2">"That's not high"</span><span class="p">);</span>
+<span class="p">}</span></code></pre></div>
+<p>If-conditions must be boolean</p>
+<div class="highlight"><pre class="chroma"><code class="language-TypeScript" data-lang="TypeScript"><span class="k">if</span><span class="p">(</span><span class="nx">foo</span><span class="p">)</span> <span class="p">{</span> <span class="p">}</span> <span class="cm">/* compiler error: Incompatible types int32 and boolean. */</span></code></pre></div>
+<p>Curly brackets for blocks are required</p>
+<div class="highlight"><pre class="chroma"><code class="language-TypeScript" data-lang="TypeScript"><span class="k">if</span><span class="p">(</span><span class="kc">true</span><span class="p">)</span> <span class="nx">printf</span><span class="p">(</span><span class="s2">"Foo"</span><span class="p">);</span> <span class="cm">/* syntax error: Missing { */</span></code></pre></div>
+<p>Traditional for loops are supported</p>
+<div class="highlight"><pre class="chroma"><code class="language-TypeScript" data-lang="TypeScript"><span class="k">for</span><span class="p">(</span><span class="kd">var</span> <span class="nx">i</span> <span class="o">=</span> <span class="mi">0</span><span class="p">;</span> <span class="nx">i</span> <span class="o"><</span> <span class="mi">10</span><span class="p">;</span> <span class="nx">i</span><span class="o">++</span><span class="p">)</span> <span class="p">{</span> <span class="p">}</span></code></pre></div>
+<p>Traditional while loops are supported</p>
+<div class="highlight"><pre class="chroma"><code class="language-TypeScript" data-lang="TypeScript"><span class="k">while</span><span class="p">(</span><span class="kc">true</span><span class="p">)</span> <span class="p">{</span> <span class="p">}</span></code></pre></div>
+<p>Do-while loops are supported</p>
+<div class="highlight"><pre class="chroma"><code class="language-TypeScript" data-lang="TypeScript"><span class="k">do</span> <span class="p">{</span> <span class="p">}</span> <span class="k">while</span><span class="p">(</span><span class="kc">true</span><span class="p">)</span></code></pre></div>
+
+ <aside class="copyright" role="note">
+
+ © 2018 The Eclipse Mita Project –
+
+ Documentation built with
+ <a href="https://www.gohugo.io" target="_blank">Hugo</a>
+ using the
+ <a href="http://github.com/digitalcraftsman/hugo-material-docs" target="_blank">Material</a> theme.
+ </aside>
+
+ <footer class="footer">
+
+
+<nav class="pagination" aria-label="Footer">
+ <div class="previous">
+
+ <a href="../../language/introduction/" title="Introduction">
+ <span class="direction">
+ Previous
+ </span>
+ <div class="page">
+ <div class="button button-previous" role="button" aria-label="Previous">
+ <i class="icon icon-back"></i>
+ </div>
+ <div class="stretch">
+ <div class="title">
+ Introduction
+ </div>
+ </div>
+ </div>
+ </a>
+
+ </div>
+
+ <div class="next">
+
+ <a href="../../language/packages/" title="Packages">
+ <span class="direction">
+ Next
+ </span>
+ <div class="page">
+ <div class="stretch">
+ <div class="title">
+ Packages
+ </div>
+ </div>
+ <div class="button button-next" role="button" aria-label="Next">
+ <i class="icon icon-forward"></i>
+ </div>
+ </div>
+ </a>
+
+ </div>
+</nav>
+
+
+
+
+
+ </footer>
+ </div>
+ </article>
+
+ <div class="results" role="status" aria-live="polite">
+ <div class="scrollable">
+ <div class="wrapper">
+ <div class="meta"></div>
+ <div class="list"></div>
+ </div>
+ </div>
+ </div>
+</main>
+
+ <script>
+
+ var base_url = '';
+ var repo_id = '';
+
+ </script>
+
+ <script src="../../javascripts/application.js"></script>
+
+
+ <script>
+ /* Add headers to scrollspy */
+ var headers = document.getElementsByTagName("h2");
+ var scrollspy = document.getElementById('scrollspy');
+
+ if(scrollspy) {
+ if(headers.length > 0) {
+ for(var i = 0; i < headers.length; i++) {
+ var li = document.createElement("li");
+ li.setAttribute("class", "anchor");
+
+ var a = document.createElement("a");
+ a.setAttribute("href", "#" + headers[i].id);
+ a.setAttribute("title", headers[i].innerHTML);
+ a.innerHTML = headers[i].innerHTML;
+
+ li.appendChild(a)
+ scrollspy.appendChild(li);
+ }
+ } else {
+ scrollspy.parentElement.removeChild(scrollspy)
+ }
+
+
+ /* Add permanent link next to the headers */
+ var headers = document.querySelectorAll("h1, h2, h3, h4, h5, h6");
+
+ for(var i = 0; i < headers.length; i++) {
+ var a = document.createElement("a");
+ a.setAttribute("class", "headerlink");
+ a.setAttribute("href", "#" + headers[i].id);
+ a.setAttribute("title", "Permanent link")
+ a.innerHTML = "#";
+ headers[i].appendChild(a);
+ }
+ }
+ </script>
+
+
+
+ <script src="//cdnjs.cloudflare.com/ajax/libs/highlight.js/9.8.0/highlight.min.js"></script>
+ <script>hljs.initHighlightingOnLoad();</script>
+ </body>
+</html>
+
diff --git a/language/events/index.html b/language/events/index.html
new file mode 100644
index 0000000..e0610de
--- /dev/null
+++ b/language/events/index.html
@@ -0,0 +1,528 @@
+<!DOCTYPE html>
+
+
+
+
+ <html class="no-js">
+
+ <head lang="en-us">
+ <meta charset="utf-8">
+ <meta name="viewport" content="width=device-width,user-scalable=no,initial-scale=1,maximum-scale=1">
+ <meta http-equiv="X-UA-Compatible" content="IE=10" />
+ <title>Events - Eclipse Mita</title>
+ <meta name="generator" content="Hugo 0.42.1" />
+
+
+ <meta name="description" content="The documentation of Eclipse Mita.">
+
+ <link rel="canonical" href="../../language/events/">
+
+
+ <meta property="og:url" content="/language/events/">
+ <meta property="og:title" content="Eclipse Mita">
+ <meta property="og:image" content="/images/mita.svg">
+ <meta name="apple-mobile-web-app-title" content="Eclipse Mita">
+ <meta name="apple-mobile-web-app-capable" content="yes">
+ <meta name="apple-mobile-web-app-status-bar-style" content="black-translucent">
+
+ <link rel="shortcut icon" type="image/x-icon" href="../../images/favicon.ico">
+ <link rel="icon" type="image/x-icon" href="../../images/favicon.ico">
+
+ <style>
+ @font-face {
+ font-family: 'Icon';
+ src: url('/fonts/icon.eot');
+ src: url('/fonts/icon.eot')
+ format('embedded-opentype'),
+ url('/fonts/icon.woff')
+ format('woff'),
+ url('/fonts/icon.ttf')
+ format('truetype'),
+ url('/fonts/icon.svg')
+ format('svg');
+ font-weight: normal;
+ font-style: normal;
+ }
+ </style>
+
+ <link rel="stylesheet" href="../../stylesheets/application.css">
+ <link rel="stylesheet" href="../../stylesheets/temporary.css">
+ <link rel="stylesheet" href="../../stylesheets/palettes.css">
+ <link rel="stylesheet" href="../../stylesheets/highlight/highlight.css">
+
+
+
+
+ <link rel="stylesheet" href="//fonts.googleapis.com/css?family=Ubuntu:400,700|Ubuntu+Mono">
+ <style>
+ body, input {
+ font-family: 'Ubuntu', Helvetica, Arial, sans-serif;
+ }
+ pre, code {
+ font-family: 'Ubuntu Mono', 'Courier New', 'Courier', monospace;
+ }
+ </style>
+
+
+ <link rel="stylesheet" href="../../css/custom.css">
+
+ <script src="../../javascripts/modernizr.js"></script>
+
+
+
+ </head>
+ <body class="palette-primary-blue-grey palette-accent-light-blue">
+
+
+
+
+<div class="backdrop">
+ <div class="backdrop-paper"></div>
+</div>
+
+<input class="toggle" type="checkbox" id="toggle-drawer">
+<input class="toggle" type="checkbox" id="toggle-search">
+<label class="toggle-button overlay" for="toggle-drawer"></label>
+
+<header class="header">
+ <nav aria-label="Header">
+ <div class="bar default">
+ <div class="button button-menu" role="button" aria-label="Menu">
+ <label class="toggle-button icon icon-menu" for="toggle-drawer">
+ <span></span>
+ </label>
+ </div>
+ <div class="stretch">
+ <div class="title">
+ Events
+ </div>
+ </div>
+
+
+ <div class="button button-twitter" role="button" aria-label="Twitter">
+ <a href="https://twitter.com/eclipse_mita" title="@eclipse_mita on Twitter" target="_blank" class="toggle-button icon icon-twitter"></a>
+ </div>
+
+
+
+ <div class="button button-github" role="button" aria-label="GitHub">
+ <a href="https://github.com/eclipse/mita" title="@eclipse/mita on GitHub" target="_blank" class="toggle-button icon icon-github"></a>
+ </div>
+
+
+
+ </div>
+ <div class="bar search">
+ <div class="button button-close" role="button" aria-label="Close">
+ <label class="toggle-button icon icon-back" for="toggle-search"></label>
+ </div>
+ <div class="stretch">
+ <div class="field">
+ <input class="query" type="text" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck>
+ </div>
+ </div>
+ <div class="button button-reset" role="button" aria-label="Search">
+ <button class="toggle-button icon icon-close" id="reset-search"></button>
+ </div>
+ </div>
+</nav>
+</header>
+
+<main class="main">
+ <div class="drawer">
+ <nav aria-label="Navigation">
+ <a href="../../" class="project">
+ <div class="banner">
+
+ <div class="logo">
+ <img src="../../images/mita.svg">
+ </div>
+
+ <div class="name">
+ <strong>Eclipse Mita </strong>
+
+ </div>
+ </div>
+ </a>
+
+ <div class="scrollable">
+ <div class="wrapper">
+
+
+ <div class="toc">
+
+ <ul>
+
+
+
+
+
+<li>
+
+
+
+
+
+<a title="Download" href="http://github.com/eclipse/mita">
+
+ Download
+</a>
+
+
+
+
+</li>
+
+
+
+<li>
+
+
+
+
+
+<a title="Concepts" href="../../concepts/">
+
+ Concepts
+</a>
+
+
+
+
+</li>
+
+
+
+<li>
+
+ <span class="section">Language</span>
+ <ul>
+
+
+
+
+
+
+<a title="Introduction" href="../../language/introduction/">
+
+ Introduction
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Basics" href="../../language/basics/">
+
+ Basics
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Packages" href="../../language/packages/">
+
+ Packages
+</a>
+
+
+
+
+
+
+
+
+
+<a title="System Setup" href="../../language/setup/">
+
+ System Setup
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Types" href="../../language/types/">
+
+ Types
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Arrays" href="../../language/arrays/">
+
+ Arrays
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Functions" href="../../language/functions/">
+
+ Functions
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Foreign Function Interface" href="../../language/foreignfunctioninterface/">
+
+ Foreign Function Interface
+</a>
+
+
+
+
+
+
+
+
+
+<a class="current" title="Events" href="../../language/events/">
+
+ Events
+</a>
+
+
+<ul id="scrollspy">
+</ul>
+
+
+
+
+
+
+
+
+<a title="Exceptions" href="../../language/exceptions/">
+
+ Exceptions
+</a>
+
+
+
+
+ </ul>
+
+</li>
+
+
+
+<li>
+
+ <span class="section">Platforms</span>
+ <ul>
+
+
+
+
+
+
+<a title="XDK110" href="../../platforms/xdk110/">
+
+ XDK110
+</a>
+
+
+
+
+ </ul>
+
+</li>
+
+
+ </ul>
+
+
+
+ </div>
+ </div>
+ </div>
+</nav>
+
+ </div>
+
+ <article class="article">
+ <div class="wrapper">
+ <h1>Events </h1>
+
+ <p>System resources and time define events. All events can be handled using the <code>every</code> keyword.</p>
+<div class="highlight"><pre class="chroma"><code class="language-TypeScript" data-lang="TypeScript"><span class="nx">every</span> <span class="nx">accelerometer</span><span class="p">.</span><span class="nx">any_motion</span> <span class="p">{</span> <span class="p">}</span>
+<span class="nx">every</span> <span class="mi">60</span> <span class="nx">seconds</span> <span class="p">{</span> <span class="p">}</span></code></pre></div>
+<p>Time comes in different resolutions:</p>
+
+<ul>
+<li><code>milliseconds</code></li>
+<li><code>seconds</code></li>
+<li><code>minutes</code></li>
+<li><code>hours</code></li>
+</ul>
+
+<p>Most platforms can only define a limited amount of timers. Therefore the number of time event handlers is limited by that amount.
+Furthermore, since time is a limited resource, especially on embedded devices, events can be handled multiple times.
+Event handlers will be executed in the order they appear in the source code.</p>
+<div class="highlight"><pre class="chroma"><code class="language-TypeScript" data-lang="TypeScript"><span class="kd">var</span> <span class="nx">foo</span> <span class="o">=</span> <span class="mi">0</span><span class="p">;</span>
+<span class="nx">every</span> <span class="nx">accelerometer</span><span class="p">.</span><span class="nx">any_motion</span> <span class="p">{</span>
+ <span class="nx">foo</span> <span class="o">=</span> <span class="mi">1</span><span class="p">;</span>
+<span class="p">}</span>
+<span class="nx">every</span> <span class="nx">accelerometer</span><span class="p">.</span><span class="nx">any_motion</span> <span class="p">{</span>
+ <span class="nx">foo</span> <span class="o">=</span> <span class="mi">2</span><span class="p">;</span>
+<span class="p">}</span> </code></pre></div>
+
+ <aside class="copyright" role="note">
+
+ © 2018 The Eclipse Mita Project –
+
+ Documentation built with
+ <a href="https://www.gohugo.io" target="_blank">Hugo</a>
+ using the
+ <a href="http://github.com/digitalcraftsman/hugo-material-docs" target="_blank">Material</a> theme.
+ </aside>
+
+ <footer class="footer">
+
+
+<nav class="pagination" aria-label="Footer">
+ <div class="previous">
+
+ <a href="../../language/foreignfunctioninterface/" title="Foreign Function Interface">
+ <span class="direction">
+ Previous
+ </span>
+ <div class="page">
+ <div class="button button-previous" role="button" aria-label="Previous">
+ <i class="icon icon-back"></i>
+ </div>
+ <div class="stretch">
+ <div class="title">
+ Foreign Function Interface
+ </div>
+ </div>
+ </div>
+ </a>
+
+ </div>
+
+ <div class="next">
+
+ <a href="../../language/exceptions/" title="Exceptions">
+ <span class="direction">
+ Next
+ </span>
+ <div class="page">
+ <div class="stretch">
+ <div class="title">
+ Exceptions
+ </div>
+ </div>
+ <div class="button button-next" role="button" aria-label="Next">
+ <i class="icon icon-forward"></i>
+ </div>
+ </div>
+ </a>
+
+ </div>
+</nav>
+
+
+
+
+
+ </footer>
+ </div>
+ </article>
+
+ <div class="results" role="status" aria-live="polite">
+ <div class="scrollable">
+ <div class="wrapper">
+ <div class="meta"></div>
+ <div class="list"></div>
+ </div>
+ </div>
+ </div>
+</main>
+
+ <script>
+
+ var base_url = '';
+ var repo_id = '';
+
+ </script>
+
+ <script src="../../javascripts/application.js"></script>
+
+
+ <script>
+ /* Add headers to scrollspy */
+ var headers = document.getElementsByTagName("h2");
+ var scrollspy = document.getElementById('scrollspy');
+
+ if(scrollspy) {
+ if(headers.length > 0) {
+ for(var i = 0; i < headers.length; i++) {
+ var li = document.createElement("li");
+ li.setAttribute("class", "anchor");
+
+ var a = document.createElement("a");
+ a.setAttribute("href", "#" + headers[i].id);
+ a.setAttribute("title", headers[i].innerHTML);
+ a.innerHTML = headers[i].innerHTML;
+
+ li.appendChild(a)
+ scrollspy.appendChild(li);
+ }
+ } else {
+ scrollspy.parentElement.removeChild(scrollspy)
+ }
+
+
+ /* Add permanent link next to the headers */
+ var headers = document.querySelectorAll("h1, h2, h3, h4, h5, h6");
+
+ for(var i = 0; i < headers.length; i++) {
+ var a = document.createElement("a");
+ a.setAttribute("class", "headerlink");
+ a.setAttribute("href", "#" + headers[i].id);
+ a.setAttribute("title", "Permanent link")
+ a.innerHTML = "#";
+ headers[i].appendChild(a);
+ }
+ }
+ </script>
+
+
+
+ <script src="//cdnjs.cloudflare.com/ajax/libs/highlight.js/9.8.0/highlight.min.js"></script>
+ <script>hljs.initHighlightingOnLoad();</script>
+ </body>
+</html>
+
diff --git a/language/exceptions/index.html b/language/exceptions/index.html
new file mode 100644
index 0000000..9210215
--- /dev/null
+++ b/language/exceptions/index.html
@@ -0,0 +1,548 @@
+<!DOCTYPE html>
+
+
+
+
+ <html class="no-js">
+
+ <head lang="en-us">
+ <meta charset="utf-8">
+ <meta name="viewport" content="width=device-width,user-scalable=no,initial-scale=1,maximum-scale=1">
+ <meta http-equiv="X-UA-Compatible" content="IE=10" />
+ <title>Exceptions - Eclipse Mita</title>
+ <meta name="generator" content="Hugo 0.42.1" />
+
+
+ <meta name="description" content="The documentation of Eclipse Mita.">
+
+ <link rel="canonical" href="../../language/exceptions/">
+
+
+ <meta property="og:url" content="/language/exceptions/">
+ <meta property="og:title" content="Eclipse Mita">
+ <meta property="og:image" content="/images/mita.svg">
+ <meta name="apple-mobile-web-app-title" content="Eclipse Mita">
+ <meta name="apple-mobile-web-app-capable" content="yes">
+ <meta name="apple-mobile-web-app-status-bar-style" content="black-translucent">
+
+ <link rel="shortcut icon" type="image/x-icon" href="../../images/favicon.ico">
+ <link rel="icon" type="image/x-icon" href="../../images/favicon.ico">
+
+ <style>
+ @font-face {
+ font-family: 'Icon';
+ src: url('/fonts/icon.eot');
+ src: url('/fonts/icon.eot')
+ format('embedded-opentype'),
+ url('/fonts/icon.woff')
+ format('woff'),
+ url('/fonts/icon.ttf')
+ format('truetype'),
+ url('/fonts/icon.svg')
+ format('svg');
+ font-weight: normal;
+ font-style: normal;
+ }
+ </style>
+
+ <link rel="stylesheet" href="../../stylesheets/application.css">
+ <link rel="stylesheet" href="../../stylesheets/temporary.css">
+ <link rel="stylesheet" href="../../stylesheets/palettes.css">
+ <link rel="stylesheet" href="../../stylesheets/highlight/highlight.css">
+
+
+
+
+ <link rel="stylesheet" href="//fonts.googleapis.com/css?family=Ubuntu:400,700|Ubuntu+Mono">
+ <style>
+ body, input {
+ font-family: 'Ubuntu', Helvetica, Arial, sans-serif;
+ }
+ pre, code {
+ font-family: 'Ubuntu Mono', 'Courier New', 'Courier', monospace;
+ }
+ </style>
+
+
+ <link rel="stylesheet" href="../../css/custom.css">
+
+ <script src="../../javascripts/modernizr.js"></script>
+
+
+
+ </head>
+ <body class="palette-primary-blue-grey palette-accent-light-blue">
+
+
+
+
+<div class="backdrop">
+ <div class="backdrop-paper"></div>
+</div>
+
+<input class="toggle" type="checkbox" id="toggle-drawer">
+<input class="toggle" type="checkbox" id="toggle-search">
+<label class="toggle-button overlay" for="toggle-drawer"></label>
+
+<header class="header">
+ <nav aria-label="Header">
+ <div class="bar default">
+ <div class="button button-menu" role="button" aria-label="Menu">
+ <label class="toggle-button icon icon-menu" for="toggle-drawer">
+ <span></span>
+ </label>
+ </div>
+ <div class="stretch">
+ <div class="title">
+ Exceptions
+ </div>
+ </div>
+
+
+ <div class="button button-twitter" role="button" aria-label="Twitter">
+ <a href="https://twitter.com/eclipse_mita" title="@eclipse_mita on Twitter" target="_blank" class="toggle-button icon icon-twitter"></a>
+ </div>
+
+
+
+ <div class="button button-github" role="button" aria-label="GitHub">
+ <a href="https://github.com/eclipse/mita" title="@eclipse/mita on GitHub" target="_blank" class="toggle-button icon icon-github"></a>
+ </div>
+
+
+
+ </div>
+ <div class="bar search">
+ <div class="button button-close" role="button" aria-label="Close">
+ <label class="toggle-button icon icon-back" for="toggle-search"></label>
+ </div>
+ <div class="stretch">
+ <div class="field">
+ <input class="query" type="text" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck>
+ </div>
+ </div>
+ <div class="button button-reset" role="button" aria-label="Search">
+ <button class="toggle-button icon icon-close" id="reset-search"></button>
+ </div>
+ </div>
+</nav>
+</header>
+
+<main class="main">
+ <div class="drawer">
+ <nav aria-label="Navigation">
+ <a href="../../" class="project">
+ <div class="banner">
+
+ <div class="logo">
+ <img src="../../images/mita.svg">
+ </div>
+
+ <div class="name">
+ <strong>Eclipse Mita </strong>
+
+ </div>
+ </div>
+ </a>
+
+ <div class="scrollable">
+ <div class="wrapper">
+
+
+ <div class="toc">
+
+ <ul>
+
+
+
+
+
+<li>
+
+
+
+
+
+<a title="Download" href="http://github.com/eclipse/mita">
+
+ Download
+</a>
+
+
+
+
+</li>
+
+
+
+<li>
+
+
+
+
+
+<a title="Concepts" href="../../concepts/">
+
+ Concepts
+</a>
+
+
+
+
+</li>
+
+
+
+<li>
+
+ <span class="section">Language</span>
+ <ul>
+
+
+
+
+
+
+<a title="Introduction" href="../../language/introduction/">
+
+ Introduction
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Basics" href="../../language/basics/">
+
+ Basics
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Packages" href="../../language/packages/">
+
+ Packages
+</a>
+
+
+
+
+
+
+
+
+
+<a title="System Setup" href="../../language/setup/">
+
+ System Setup
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Types" href="../../language/types/">
+
+ Types
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Arrays" href="../../language/arrays/">
+
+ Arrays
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Functions" href="../../language/functions/">
+
+ Functions
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Foreign Function Interface" href="../../language/foreignfunctioninterface/">
+
+ Foreign Function Interface
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Events" href="../../language/events/">
+
+ Events
+</a>
+
+
+
+
+
+
+
+
+
+<a class="current" title="Exceptions" href="../../language/exceptions/">
+
+ Exceptions
+</a>
+
+
+<ul id="scrollspy">
+</ul>
+
+
+
+ </ul>
+
+</li>
+
+
+
+<li>
+
+ <span class="section">Platforms</span>
+ <ul>
+
+
+
+
+
+
+<a title="XDK110" href="../../platforms/xdk110/">
+
+ XDK110
+</a>
+
+
+
+
+ </ul>
+
+</li>
+
+
+ </ul>
+
+
+
+ </div>
+ </div>
+ </div>
+</nav>
+
+ </div>
+
+ <article class="article">
+ <div class="wrapper">
+ <h1>Exceptions </h1>
+
+
+
+<h2 id="exceptions">Exceptions</h2>
+
+<p>Exceptions are special types defined by the exception keyword:</p>
+<div class="highlight"><pre class="chroma"><code class="language-TypeScript" data-lang="TypeScript"><span class="nx">exception</span> <span class="nx">FooException</span><span class="p">;</span></code></pre></div>
+<p>Exceptions can be thrown, which returns control flow to the caller. If the exception is not caught by the caller it propagates further. If the exception is never caught it causes a system reset.</p>
+<div class="highlight"><pre class="chroma"><code class="language-TypeScript" data-lang="TypeScript"><span class="k">throw</span> <span class="nx">FooException</span><span class="p">;</span></code></pre></div>
+<p>Exceptions can be caught with the familiar <code>try...catch</code> syntax:</p>
+<div class="highlight"><pre class="chroma"><code class="language-TypeScript" data-lang="TypeScript"><span class="k">try</span> <span class="p">{</span>
+ <span class="k">throw</span> <span class="nx">FooException</span><span class="p">;</span>
+<span class="p">}</span> <span class="k">catch</span><span class="p">(</span><span class="nx">FooException</span><span class="p">)</span> <span class="p">{</span>
+ <span class="nx">println</span><span class="p">(</span><span class="s2">"Caught FooException"</span><span class="p">);</span>
+<span class="p">}</span></code></pre></div>
+<p>Exceptions are implicit, meaning that functions do not have to (and cannot) declare the exceptions they might throw.</p>
+<div class="highlight"><pre class="chroma"><code class="language-TypeScript" data-lang="TypeScript"><span class="nx">fn</span> <span class="nx">doSomething() {</span>
+ <span class="k">throw</span> <span class="nx">FooException</span><span class="p">;</span>
+<span class="p">}</span></code></pre></div>
+<p>Similarly to other languages you can also have a <code>finally</code> block for cleanup:</p>
+<div class="highlight"><pre class="chroma"><code class="language-TypeScript" data-lang="TypeScript"><span class="k">try</span> <span class="p">{</span>
+ <span class="k">throw</span> <span class="nx">FooException</span><span class="p">;</span>
+<span class="p">}</span> <span class="k">catch</span><span class="p">(</span><span class="nx">FooException</span><span class="p">)</span> <span class="p">{</span>
+ <span class="nx">println</span><span class="p">(</span><span class="s2">"Caught FooException"</span><span class="p">);</span>
+<span class="p">}</span> <span class="k">finally</span> <span class="p">{</span>
+ <span class="nx">println</span><span class="p">(</span><span class="s2">"In finally"</span><span class="p">);</span>
+<span class="p">}</span>
+<span class="cm">/* prints:
+</span><span class="cm">Caught FooException
+</span><span class="cm">In finally
+</span><span class="cm">*/</span></code></pre></div>
+<p>If you want to have a “catch all”, you can catch just <code>Exception</code>, which is a kind-of “supertype” of all other exceptions:</p>
+
+<pre><code>TypeScript
+try {
+ throw FooException;
+} catch(Exception) {
+ println("Caught something");
+}
+</code></pre>
+
+<p>You can nest <code>try/catch/finally</code> within each other freely.</p>
+
+
+ <aside class="copyright" role="note">
+
+ © 2018 The Eclipse Mita Project –
+
+ Documentation built with
+ <a href="https://www.gohugo.io" target="_blank">Hugo</a>
+ using the
+ <a href="http://github.com/digitalcraftsman/hugo-material-docs" target="_blank">Material</a> theme.
+ </aside>
+
+ <footer class="footer">
+
+
+<nav class="pagination" aria-label="Footer">
+ <div class="previous">
+
+ <a href="../../language/events/" title="Events">
+ <span class="direction">
+ Previous
+ </span>
+ <div class="page">
+ <div class="button button-previous" role="button" aria-label="Previous">
+ <i class="icon icon-back"></i>
+ </div>
+ <div class="stretch">
+ <div class="title">
+ Events
+ </div>
+ </div>
+ </div>
+ </a>
+
+ </div>
+
+ <div class="next">
+
+ <a href="../../download/" title="Download">
+ <span class="direction">
+ Next
+ </span>
+ <div class="page">
+ <div class="stretch">
+ <div class="title">
+ Download
+ </div>
+ </div>
+ <div class="button button-next" role="button" aria-label="Next">
+ <i class="icon icon-forward"></i>
+ </div>
+ </div>
+ </a>
+
+ </div>
+</nav>
+
+
+
+
+
+ </footer>
+ </div>
+ </article>
+
+ <div class="results" role="status" aria-live="polite">
+ <div class="scrollable">
+ <div class="wrapper">
+ <div class="meta"></div>
+ <div class="list"></div>
+ </div>
+ </div>
+ </div>
+</main>
+
+ <script>
+
+ var base_url = '';
+ var repo_id = '';
+
+ </script>
+
+ <script src="../../javascripts/application.js"></script>
+
+
+ <script>
+ /* Add headers to scrollspy */
+ var headers = document.getElementsByTagName("h2");
+ var scrollspy = document.getElementById('scrollspy');
+
+ if(scrollspy) {
+ if(headers.length > 0) {
+ for(var i = 0; i < headers.length; i++) {
+ var li = document.createElement("li");
+ li.setAttribute("class", "anchor");
+
+ var a = document.createElement("a");
+ a.setAttribute("href", "#" + headers[i].id);
+ a.setAttribute("title", headers[i].innerHTML);
+ a.innerHTML = headers[i].innerHTML;
+
+ li.appendChild(a)
+ scrollspy.appendChild(li);
+ }
+ } else {
+ scrollspy.parentElement.removeChild(scrollspy)
+ }
+
+
+ /* Add permanent link next to the headers */
+ var headers = document.querySelectorAll("h1, h2, h3, h4, h5, h6");
+
+ for(var i = 0; i < headers.length; i++) {
+ var a = document.createElement("a");
+ a.setAttribute("class", "headerlink");
+ a.setAttribute("href", "#" + headers[i].id);
+ a.setAttribute("title", "Permanent link")
+ a.innerHTML = "#";
+ headers[i].appendChild(a);
+ }
+ }
+ </script>
+
+
+
+ <script src="//cdnjs.cloudflare.com/ajax/libs/highlight.js/9.8.0/highlight.min.js"></script>
+ <script>hljs.initHighlightingOnLoad();</script>
+ </body>
+</html>
+
diff --git a/language/ffiExample.png b/language/ffiExample.png
new file mode 100644
index 0000000..eaed298
--- /dev/null
+++ b/language/ffiExample.png
Binary files differ
diff --git a/language/foreignfunctioninterface/index.html b/language/foreignfunctioninterface/index.html
new file mode 100644
index 0000000..2809a28
--- /dev/null
+++ b/language/foreignfunctioninterface/index.html
@@ -0,0 +1,593 @@
+<!DOCTYPE html>
+
+
+
+
+ <html class="no-js">
+
+ <head lang="en-us">
+ <meta charset="utf-8">
+ <meta name="viewport" content="width=device-width,user-scalable=no,initial-scale=1,maximum-scale=1">
+ <meta http-equiv="X-UA-Compatible" content="IE=10" />
+ <title>Foreign Function Interface - Eclipse Mita</title>
+ <meta name="generator" content="Hugo 0.42.1" />
+
+
+ <meta name="description" content="The documentation of Eclipse Mita.">
+
+ <link rel="canonical" href="../../language/foreignfunctioninterface/">
+
+
+ <meta property="og:url" content="/language/foreignfunctioninterface/">
+ <meta property="og:title" content="Eclipse Mita">
+ <meta property="og:image" content="/images/mita.svg">
+ <meta name="apple-mobile-web-app-title" content="Eclipse Mita">
+ <meta name="apple-mobile-web-app-capable" content="yes">
+ <meta name="apple-mobile-web-app-status-bar-style" content="black-translucent">
+
+ <link rel="shortcut icon" type="image/x-icon" href="../../images/favicon.ico">
+ <link rel="icon" type="image/x-icon" href="../../images/favicon.ico">
+
+ <style>
+ @font-face {
+ font-family: 'Icon';
+ src: url('/fonts/icon.eot');
+ src: url('/fonts/icon.eot')
+ format('embedded-opentype'),
+ url('/fonts/icon.woff')
+ format('woff'),
+ url('/fonts/icon.ttf')
+ format('truetype'),
+ url('/fonts/icon.svg')
+ format('svg');
+ font-weight: normal;
+ font-style: normal;
+ }
+ </style>
+
+ <link rel="stylesheet" href="../../stylesheets/application.css">
+ <link rel="stylesheet" href="../../stylesheets/temporary.css">
+ <link rel="stylesheet" href="../../stylesheets/palettes.css">
+ <link rel="stylesheet" href="../../stylesheets/highlight/highlight.css">
+
+
+
+
+ <link rel="stylesheet" href="//fonts.googleapis.com/css?family=Ubuntu:400,700|Ubuntu+Mono">
+ <style>
+ body, input {
+ font-family: 'Ubuntu', Helvetica, Arial, sans-serif;
+ }
+ pre, code {
+ font-family: 'Ubuntu Mono', 'Courier New', 'Courier', monospace;
+ }
+ </style>
+
+
+ <link rel="stylesheet" href="../../css/custom.css">
+
+ <script src="../../javascripts/modernizr.js"></script>
+
+
+
+ </head>
+ <body class="palette-primary-blue-grey palette-accent-light-blue">
+
+
+
+
+<div class="backdrop">
+ <div class="backdrop-paper"></div>
+</div>
+
+<input class="toggle" type="checkbox" id="toggle-drawer">
+<input class="toggle" type="checkbox" id="toggle-search">
+<label class="toggle-button overlay" for="toggle-drawer"></label>
+
+<header class="header">
+ <nav aria-label="Header">
+ <div class="bar default">
+ <div class="button button-menu" role="button" aria-label="Menu">
+ <label class="toggle-button icon icon-menu" for="toggle-drawer">
+ <span></span>
+ </label>
+ </div>
+ <div class="stretch">
+ <div class="title">
+ Foreign Function Interface
+ </div>
+ </div>
+
+
+ <div class="button button-twitter" role="button" aria-label="Twitter">
+ <a href="https://twitter.com/eclipse_mita" title="@eclipse_mita on Twitter" target="_blank" class="toggle-button icon icon-twitter"></a>
+ </div>
+
+
+
+ <div class="button button-github" role="button" aria-label="GitHub">
+ <a href="https://github.com/eclipse/mita" title="@eclipse/mita on GitHub" target="_blank" class="toggle-button icon icon-github"></a>
+ </div>
+
+
+
+ </div>
+ <div class="bar search">
+ <div class="button button-close" role="button" aria-label="Close">
+ <label class="toggle-button icon icon-back" for="toggle-search"></label>
+ </div>
+ <div class="stretch">
+ <div class="field">
+ <input class="query" type="text" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck>
+ </div>
+ </div>
+ <div class="button button-reset" role="button" aria-label="Search">
+ <button class="toggle-button icon icon-close" id="reset-search"></button>
+ </div>
+ </div>
+</nav>
+</header>
+
+<main class="main">
+ <div class="drawer">
+ <nav aria-label="Navigation">
+ <a href="../../" class="project">
+ <div class="banner">
+
+ <div class="logo">
+ <img src="../../images/mita.svg">
+ </div>
+
+ <div class="name">
+ <strong>Eclipse Mita </strong>
+
+ </div>
+ </div>
+ </a>
+
+ <div class="scrollable">
+ <div class="wrapper">
+
+
+ <div class="toc">
+
+ <ul>
+
+
+
+
+
+<li>
+
+
+
+
+
+<a title="Download" href="http://github.com/eclipse/mita">
+
+ Download
+</a>
+
+
+
+
+</li>
+
+
+
+<li>
+
+
+
+
+
+<a title="Concepts" href="../../concepts/">
+
+ Concepts
+</a>
+
+
+
+
+</li>
+
+
+
+<li>
+
+ <span class="section">Language</span>
+ <ul>
+
+
+
+
+
+
+<a title="Introduction" href="../../language/introduction/">
+
+ Introduction
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Basics" href="../../language/basics/">
+
+ Basics
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Packages" href="../../language/packages/">
+
+ Packages
+</a>
+
+
+
+
+
+
+
+
+
+<a title="System Setup" href="../../language/setup/">
+
+ System Setup
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Types" href="../../language/types/">
+
+ Types
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Arrays" href="../../language/arrays/">
+
+ Arrays
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Functions" href="../../language/functions/">
+
+ Functions
+</a>
+
+
+
+
+
+
+
+
+
+<a class="current" title="Foreign Function Interface" href="../../language/foreignfunctioninterface/">
+
+ Foreign Function Interface
+</a>
+
+
+<ul id="scrollspy">
+</ul>
+
+
+
+
+
+
+
+
+<a title="Events" href="../../language/events/">
+
+ Events
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Exceptions" href="../../language/exceptions/">
+
+ Exceptions
+</a>
+
+
+
+
+ </ul>
+
+</li>
+
+
+
+<li>
+
+ <span class="section">Platforms</span>
+ <ul>
+
+
+
+
+
+
+<a title="XDK110" href="../../platforms/xdk110/">
+
+ XDK110
+</a>
+
+
+
+
+ </ul>
+
+</li>
+
+
+ </ul>
+
+
+
+ </div>
+ </div>
+ </div>
+</nav>
+
+ </div>
+
+ <article class="article">
+ <div class="wrapper">
+ <h1>Foreign Function Interface </h1>
+
+
+
+<p>Mita transpiles to C code, i.e. the compiler produces C code rather than a binary executable.
+This begs the question if we can call existing C code from within Mita programs.
+Such integration of the “target language” is referred to as <em>foreign function interface</em> (or <em>FFI</em> in short) because the functions we wish to call from within Mita are defined in a foreign language: C.
+Other languages sport similar concepts, for example <em>TypeScript</em> supports <a href="https://basarat.gitbooks.io/typescript/docs/types/ambient/d.ts.html">declarations</a> which allow you to use code written in JavaScript (the language TypeScript compiles to).</p>
+
+<p>Calling native C functions is useful if we want to re-use existing libraries, or for the things which are easier to express in C than they are to express in Mita.
+Suppose you wanted to connect a new sensor to your device and the sensor came with a driver library written in C.
+Using the foreign function interface you can integrate and use that driver library from within Mita.</p>
+
+<h2 id="native-functions">Native Functions</h2>
+
+<p>To make a function written in native C known to Mita you have to declare them in an Mita file, e.g.:</p>
+<div class="highlight"><pre class="chroma"><code class="language-TypeScript" data-lang="TypeScript"><span class="kr">native</span> <span class="nx">unchecked</span> <span class="nx">fn</span> <span class="nx">abs</span><span class="p">(</span><span class="nx">n</span> : <span class="kt">int32</span><span class="p">)</span> <span class="o">:</span> <span class="nx">int32</span>
+ <span class="nx">header</span> <span class="s2">"math.h"</span><span class="p">;</span></code></pre></div>
+<p>The header which we have named during the declaration of the native function will be automatically included in the generated C code where necessary.
+With the <code>abs</code> function declared like that we can use it just like a regular Mita function.</p>
+<div class="highlight"><pre class="chroma"><code class="language-TypeScript" data-lang="TypeScript"><span class="kr">package</span> <span class="nx">main</span><span class="p">;</span>
+<span class="kr">import</span> <span class="nx">platforms</span><span class="p">.</span><span class="nx">xdk110</span><span class="p">;</span>
+
+<span class="nx">every</span> <span class="mi">1</span> <span class="nx">second</span> <span class="p">{</span>
+ <span class="kd">let</span> <span class="nx">xAxisAcceleration</span> <span class="o">=</span> <span class="nx">acc</span>
+ <span class="nx">println</span><span class="p">(</span><span class="sb">`Absolute X axis acceleration: </span><span class="si">${</span><span class="nx">abs</span><span class="p">(</span><span class="nx">accelerometer</span><span class="p">.</span><span class="nx">x_axis</span><span class="p">.</span><span class="nx">read</span><span class="p">())</span><span class="si">}</span><span class="sb">`</span><span class="p">);</span>
+<span class="p">}</span></code></pre></div>
+<h2 id="unchecked-vs-checked">Unchecked vs Checked</h2>
+
+<p>Notice the <code>unchecked</code> keyword in the example above.
+Mita supports exceptions which map to special return values in the generated C code.
+The <code>unchecked</code> keyword and its counterpart <code>checked</code> tell the compiler if it should use the Mita calling convention which handles exceptions, or the C calling convention where the return value is not used for exceptions.</p>
+
+<p>Let’s look at both calling conventions in detail. For both calling conventions we will see the Mita declaration and the corresponding C header that the compiler expects.</p>
+
+<h3 id="unchecked">Unchecked</h3>
+<div class="highlight"><pre class="chroma"><code class="language-TypeScript" data-lang="TypeScript"><span class="kr">native</span> <span class="nx">unchecked</span> <span class="nx">fn</span> <span class="nx">foobar</span><span class="p">(</span><span class="nx">n</span> : <span class="kt">int32</span><span class="p">)</span> <span class="o">:</span> <span class="nx">int32</span>
+ <span class="nx">header</span> <span class="s2">"unfoobar.h"</span><span class="p">;</span>
+
+<span class="kr">native</span> <span class="nx">unchecked</span> <span class="nx">fn</span> <span class="nx">foobarWithRef</span><span class="p">(</span><span class="nx">ref</span> <span class="o">:</span> <span class="o">&</span><span class="nx">int32</span><span class="p">)</span> <span class="o">:</span> <span class="nx">int32</span>
+ <span class="nx">header</span> <span class="s2">"unfoobar.h"</span><span class="p">;</span>
+
+<span class="kr">native</span> <span class="nx">unchecked</span> <span class="nx">fn</span> <span class="nx">foobarVoid</span><span class="p">(</span><span class="nx">n</span> : <span class="kt">int32</span><span class="p">)</span> <span class="o">:</span> <span class="k">void</span>
+ <span class="nx">header</span> <span class="s2">"unfoobar.h"</span><span class="p">;</span></code></pre></div>
+<p>expects <code>unfoobar.h</code> to look something like</p>
+<div class="highlight"><pre class="chroma"><code class="language-C" data-lang="C"><span class="cp">#include</span> <span class="cpf"><stdint.h></span><span class="cp">
+</span><span class="cp"></span>
+<span class="n">int32_t</span> <span class="nf">foobar</span><span class="p">(</span><span class="n">int32_t</span> <span class="n">n</span><span class="p">);</span>
+
+<span class="n">int32_t</span> <span class="nf">foobarWithRef</span><span class="p">(</span><span class="n">int32_t</span><span class="o">*</span> <span class="n">ref</span><span class="p">);</span>
+
+<span class="kt">void</span> <span class="nf">foobarVoid</span><span class="p">(</span><span class="n">int32_t</span> <span class="n">n</span><span class="p">);</span></code></pre></div>
+<h3 id="checked">Checked</h3>
+<div class="highlight"><pre class="chroma"><code class="language-TypeScript" data-lang="TypeScript"><span class="kr">native</span> <span class="nx">checked</span> <span class="nx">fn</span> <span class="nx">foobar</span><span class="p">(</span><span class="nx">n</span> : <span class="kt">int32</span><span class="p">)</span> <span class="o">:</span> <span class="nx">int32</span>
+ <span class="nx">header</span> <span class="s2">"foobar.h"</span><span class="p">;</span>
+
+<span class="kr">native</span> <span class="nx">checked</span> <span class="nx">fn</span> <span class="nx">foobarWithRef</span><span class="p">(</span><span class="nx">ref</span> <span class="o">:</span> <span class="o">&</span><span class="nx">int32</span><span class="p">)</span> <span class="o">:</span> <span class="nx">int32</span>
+ <span class="nx">header</span> <span class="s2">"foobar.h"</span><span class="p">;</span>
+
+<span class="kr">native</span> <span class="nx">checked</span> <span class="nx">fn</span> <span class="nx">foobarVoid</span><span class="p">(</span><span class="nx">n</span> : <span class="kt">int32</span><span class="p">)</span> <span class="o">:</span> <span class="k">void</span>
+ <span class="nx">header</span> <span class="s2">"foobar.h"</span><span class="p">;</span></code></pre></div>
+<p>expects <code>foobar.h</code> to look something like</p>
+<div class="highlight"><pre class="chroma"><code class="language-C" data-lang="C"><span class="cp">#include</span> <span class="cpf"><BCDS_Basics.h></span><span class="cp">
+</span><span class="cp">#include</span> <span class="cpf"><BCDS_Retcode.h></span><span class="cp">
+</span><span class="cp">#include</span> <span class="cpf"><stdint.h></span><span class="cp">
+</span><span class="cp"></span>
+<span class="n">Retcode_T</span> <span class="nf">foobar</span><span class="p">(</span><span class="n">int32_t</span><span class="o">*</span> <span class="n">result</span><span class="p">,</span> <span class="n">int32_t</span> <span class="n">n</span><span class="p">);</span>
+
+<span class="n">Retcode_T</span> <span class="nf">foobarWithRef</span><span class="p">(</span><span class="n">int32_t</span><span class="o">*</span> <span class="n">result</span><span class="p">,</span> <span class="n">int32_t</span><span class="o">*</span> <span class="n">ref</span><span class="p">);</span>
+
+<span class="n">Retcode_T</span> <span class="nf">foobarVoid</span><span class="p">(</span><span class="kt">void</span><span class="o">*</span> <span class="n">result</span><span class="p">,</span> <span class="n">int32_t</span><span class="o">*</span> <span class="n">ref</span><span class="p">);</span></code></pre></div>
+<p>The <code>Retcode_T</code> and <code>BCDS_*</code> includes are specific to the <a href="../../platforms/xdk110/">XDK110 platform</a>.
+Other platforms will use a different type to express error codes.</p>
+
+<h2 id="custom-c-file-include">Custom C file include</h2>
+
+<p>The Makefile of an Mita project is automatically generated. The compiler will include all C files and header in your project in that
+Makefile. This way you can mix C and Mita code within the same project.
+For example you could have a custom header and corresponding implementation in your project, and an Mita file which declares them.</p>
+
+<p><img src="ffiExample.png" alt="Using custom C code" /></p>
+
+<h2 id="pitfalls">Pitfalls</h2>
+
+<p>In order to support all features of Mita, we sometimes have to generate code which does not directly map to a “native C API”.
+Arrays are a good example: each array type in Mita gets its corresponding C type. For example <code>array<int32></code> turns into an <code>array_int32</code> structure and not <code>int32_t[]</code> as one could expect.</p>
+
+<p>Whenever you cannot import an existing API directly using <code>unchecked</code> native functions, you could write a wrapper in C using custom C file includes described above.</p>
+
+
+ <aside class="copyright" role="note">
+
+ © 2018 The Eclipse Mita Project –
+
+ Documentation built with
+ <a href="https://www.gohugo.io" target="_blank">Hugo</a>
+ using the
+ <a href="http://github.com/digitalcraftsman/hugo-material-docs" target="_blank">Material</a> theme.
+ </aside>
+
+ <footer class="footer">
+
+
+<nav class="pagination" aria-label="Footer">
+ <div class="previous">
+
+ <a href="../../platforms/xdk110/" title="XDK110">
+ <span class="direction">
+ Previous
+ </span>
+ <div class="page">
+ <div class="button button-previous" role="button" aria-label="Previous">
+ <i class="icon icon-back"></i>
+ </div>
+ <div class="stretch">
+ <div class="title">
+ XDK110
+ </div>
+ </div>
+ </div>
+ </a>
+
+ </div>
+
+ <div class="next">
+
+ <a href="../../language/events/" title="Events">
+ <span class="direction">
+ Next
+ </span>
+ <div class="page">
+ <div class="stretch">
+ <div class="title">
+ Events
+ </div>
+ </div>
+ <div class="button button-next" role="button" aria-label="Next">
+ <i class="icon icon-forward"></i>
+ </div>
+ </div>
+ </a>
+
+ </div>
+</nav>
+
+
+
+
+
+ </footer>
+ </div>
+ </article>
+
+ <div class="results" role="status" aria-live="polite">
+ <div class="scrollable">
+ <div class="wrapper">
+ <div class="meta"></div>
+ <div class="list"></div>
+ </div>
+ </div>
+ </div>
+</main>
+
+ <script>
+
+ var base_url = '';
+ var repo_id = '';
+
+ </script>
+
+ <script src="../../javascripts/application.js"></script>
+
+
+ <script>
+ /* Add headers to scrollspy */
+ var headers = document.getElementsByTagName("h2");
+ var scrollspy = document.getElementById('scrollspy');
+
+ if(scrollspy) {
+ if(headers.length > 0) {
+ for(var i = 0; i < headers.length; i++) {
+ var li = document.createElement("li");
+ li.setAttribute("class", "anchor");
+
+ var a = document.createElement("a");
+ a.setAttribute("href", "#" + headers[i].id);
+ a.setAttribute("title", headers[i].innerHTML);
+ a.innerHTML = headers[i].innerHTML;
+
+ li.appendChild(a)
+ scrollspy.appendChild(li);
+ }
+ } else {
+ scrollspy.parentElement.removeChild(scrollspy)
+ }
+
+
+ /* Add permanent link next to the headers */
+ var headers = document.querySelectorAll("h1, h2, h3, h4, h5, h6");
+
+ for(var i = 0; i < headers.length; i++) {
+ var a = document.createElement("a");
+ a.setAttribute("class", "headerlink");
+ a.setAttribute("href", "#" + headers[i].id);
+ a.setAttribute("title", "Permanent link")
+ a.innerHTML = "#";
+ headers[i].appendChild(a);
+ }
+ }
+ </script>
+
+
+
+ <script src="//cdnjs.cloudflare.com/ajax/libs/highlight.js/9.8.0/highlight.min.js"></script>
+ <script>hljs.initHighlightingOnLoad();</script>
+ </body>
+</html>
+
diff --git a/language/functions/index.html b/language/functions/index.html
new file mode 100644
index 0000000..1a92aa5
--- /dev/null
+++ b/language/functions/index.html
@@ -0,0 +1,591 @@
+<!DOCTYPE html>
+
+
+
+
+ <html class="no-js">
+
+ <head lang="en-us">
+ <meta charset="utf-8">
+ <meta name="viewport" content="width=device-width,user-scalable=no,initial-scale=1,maximum-scale=1">
+ <meta http-equiv="X-UA-Compatible" content="IE=10" />
+ <title>Functions - Eclipse Mita</title>
+ <meta name="generator" content="Hugo 0.42.1" />
+
+
+ <meta name="description" content="The documentation of Eclipse Mita.">
+
+ <link rel="canonical" href="../../language/functions/">
+
+
+ <meta property="og:url" content="/language/functions/">
+ <meta property="og:title" content="Eclipse Mita">
+ <meta property="og:image" content="/images/mita.svg">
+ <meta name="apple-mobile-web-app-title" content="Eclipse Mita">
+ <meta name="apple-mobile-web-app-capable" content="yes">
+ <meta name="apple-mobile-web-app-status-bar-style" content="black-translucent">
+
+ <link rel="shortcut icon" type="image/x-icon" href="../../images/favicon.ico">
+ <link rel="icon" type="image/x-icon" href="../../images/favicon.ico">
+
+ <style>
+ @font-face {
+ font-family: 'Icon';
+ src: url('/fonts/icon.eot');
+ src: url('/fonts/icon.eot')
+ format('embedded-opentype'),
+ url('/fonts/icon.woff')
+ format('woff'),
+ url('/fonts/icon.ttf')
+ format('truetype'),
+ url('/fonts/icon.svg')
+ format('svg');
+ font-weight: normal;
+ font-style: normal;
+ }
+ </style>
+
+ <link rel="stylesheet" href="../../stylesheets/application.css">
+ <link rel="stylesheet" href="../../stylesheets/temporary.css">
+ <link rel="stylesheet" href="../../stylesheets/palettes.css">
+ <link rel="stylesheet" href="../../stylesheets/highlight/highlight.css">
+
+
+
+
+ <link rel="stylesheet" href="//fonts.googleapis.com/css?family=Ubuntu:400,700|Ubuntu+Mono">
+ <style>
+ body, input {
+ font-family: 'Ubuntu', Helvetica, Arial, sans-serif;
+ }
+ pre, code {
+ font-family: 'Ubuntu Mono', 'Courier New', 'Courier', monospace;
+ }
+ </style>
+
+
+ <link rel="stylesheet" href="../../css/custom.css">
+
+ <script src="../../javascripts/modernizr.js"></script>
+
+
+
+ </head>
+ <body class="palette-primary-blue-grey palette-accent-light-blue">
+
+
+
+
+<div class="backdrop">
+ <div class="backdrop-paper"></div>
+</div>
+
+<input class="toggle" type="checkbox" id="toggle-drawer">
+<input class="toggle" type="checkbox" id="toggle-search">
+<label class="toggle-button overlay" for="toggle-drawer"></label>
+
+<header class="header">
+ <nav aria-label="Header">
+ <div class="bar default">
+ <div class="button button-menu" role="button" aria-label="Menu">
+ <label class="toggle-button icon icon-menu" for="toggle-drawer">
+ <span></span>
+ </label>
+ </div>
+ <div class="stretch">
+ <div class="title">
+ Functions
+ </div>
+ </div>
+
+
+ <div class="button button-twitter" role="button" aria-label="Twitter">
+ <a href="https://twitter.com/eclipse_mita" title="@eclipse_mita on Twitter" target="_blank" class="toggle-button icon icon-twitter"></a>
+ </div>
+
+
+
+ <div class="button button-github" role="button" aria-label="GitHub">
+ <a href="https://github.com/eclipse/mita" title="@eclipse/mita on GitHub" target="_blank" class="toggle-button icon icon-github"></a>
+ </div>
+
+
+
+ </div>
+ <div class="bar search">
+ <div class="button button-close" role="button" aria-label="Close">
+ <label class="toggle-button icon icon-back" for="toggle-search"></label>
+ </div>
+ <div class="stretch">
+ <div class="field">
+ <input class="query" type="text" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck>
+ </div>
+ </div>
+ <div class="button button-reset" role="button" aria-label="Search">
+ <button class="toggle-button icon icon-close" id="reset-search"></button>
+ </div>
+ </div>
+</nav>
+</header>
+
+<main class="main">
+ <div class="drawer">
+ <nav aria-label="Navigation">
+ <a href="../../" class="project">
+ <div class="banner">
+
+ <div class="logo">
+ <img src="../../images/mita.svg">
+ </div>
+
+ <div class="name">
+ <strong>Eclipse Mita </strong>
+
+ </div>
+ </div>
+ </a>
+
+ <div class="scrollable">
+ <div class="wrapper">
+
+
+ <div class="toc">
+
+ <ul>
+
+
+
+
+
+<li>
+
+
+
+
+
+<a title="Download" href="http://github.com/eclipse/mita">
+
+ Download
+</a>
+
+
+
+
+</li>
+
+
+
+<li>
+
+
+
+
+
+<a title="Concepts" href="../../concepts/">
+
+ Concepts
+</a>
+
+
+
+
+</li>
+
+
+
+<li>
+
+ <span class="section">Language</span>
+ <ul>
+
+
+
+
+
+
+<a title="Introduction" href="../../language/introduction/">
+
+ Introduction
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Basics" href="../../language/basics/">
+
+ Basics
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Packages" href="../../language/packages/">
+
+ Packages
+</a>
+
+
+
+
+
+
+
+
+
+<a title="System Setup" href="../../language/setup/">
+
+ System Setup
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Types" href="../../language/types/">
+
+ Types
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Arrays" href="../../language/arrays/">
+
+ Arrays
+</a>
+
+
+
+
+
+
+
+
+
+<a class="current" title="Functions" href="../../language/functions/">
+
+ Functions
+</a>
+
+
+<ul id="scrollspy">
+</ul>
+
+
+
+
+
+
+
+
+<a title="Foreign Function Interface" href="../../language/foreignfunctioninterface/">
+
+ Foreign Function Interface
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Events" href="../../language/events/">
+
+ Events
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Exceptions" href="../../language/exceptions/">
+
+ Exceptions
+</a>
+
+
+
+
+ </ul>
+
+</li>
+
+
+
+<li>
+
+ <span class="section">Platforms</span>
+ <ul>
+
+
+
+
+
+
+<a title="XDK110" href="../../platforms/xdk110/">
+
+ XDK110
+</a>
+
+
+
+
+ </ul>
+
+</li>
+
+
+ </ul>
+
+
+
+ </div>
+ </div>
+ </div>
+</nav>
+
+ </div>
+
+ <article class="article">
+ <div class="wrapper">
+ <h1>Functions </h1>
+
+
+
+<p>Functions play an important role in Mita.
+They give the language a modern feel through features that go beyond what C has to offer, such as <a href="#polymorphism">polymorphism</a> and <a href="#extension-methods">extension methods</a>.</p>
+
+<p>You have already seen the <code>fn</code> keyword, which allows you to declare new functions. Alternatively you can use <code>function</code> instead of <code>fn</code> if that suits your style better.
+By convention in Mita functions are named in <code>camel case</code> style. In <code>camel case</code>, words are separated by capital letters and for functions we start with a lower-case one.
+Here is an example that contains function definitions:</p>
+<div class="highlight"><pre class="chroma"><code class="language-TypeScript" data-lang="TypeScript"><span class="nx">fn</span> <span class="nx">helloWorld() {</span>
+ <span class="k">return</span> <span class="s2">"hello world"</span><span class="p">;</span>
+<span class="p">}</span>
+
+<span class="kd">function</span> <span class="nx">addOne</span><span class="p">(</span><span class="nx">x</span> : <span class="kt">int32</span><span class="p">)</span> <span class="o">:</span> <span class="nx">int32</span> <span class="p">{</span>
+ <span class="k">return</span> <span class="nx">x</span> <span class="o">+</span> <span class="mi">1</span><span class="p">;</span>
+<span class="p">}</span></code></pre></div>
+<h2 id="return-values">Return Values</h2>
+
+<p>All functions have a return type. If a function does not return any value, its type is <code>void</code>.
+If you don’t explicitly specify a return type, the compiler will infer the common type of all <code>return</code> statements.</p>
+<div class="highlight"><pre class="chroma"><code class="language-TypeScript" data-lang="TypeScript"><span class="c1">// The compiler will infer bool as return type
+</span><span class="c1"></span><span class="nx">fn</span> <span class="nx">isEvent</span><span class="p">(</span><span class="nx">x</span> : <span class="kt">int32</span><span class="p">)</span> <span class="p">{</span>
+ <span class="k">if</span><span class="p">(</span><span class="nx">x</span> <span class="o">%</span> <span class="mi">2</span> <span class="o">==</span> <span class="mi">0</span><span class="p">)</span> <span class="p">{</span>
+ <span class="k">return</span> <span class="kc">true</span><span class="p">;</span>
+ <span class="p">}</span> <span class="k">else</span> <span class="p">{</span>
+ <span class="k">return</span> <span class="kc">false</span><span class="p">;</span>
+ <span class="p">}</span>
+<span class="p">}</span>
+
+<span class="nx">fn</span> <span class="nx">giveAnotherOne</span><span class="p">()</span> <span class="o">:</span> <span class="nx">uint32</span> <span class="p">{</span>
+ <span class="k">return</span> <span class="mi">1</span><span class="p">;</span>
+<span class="p">}</span></code></pre></div>
+<h2 id="polymorphism">Polymorphism</h2>
+
+<p>Functions can share the same name as long as the types of their parameters differ.
+This concept is referred to as <code>polymorphism</code> and is useful to enable different behavior depending on the type of input.
+Suppose you wanted to serialize structures to JSON messages. Because of polymorphism you can write the following code:</p>
+<div class="highlight"><pre class="chroma"><code class="language-TypeScript" data-lang="TypeScript"><span class="kr">package</span> <span class="nx">main</span><span class="p">;</span>
+<span class="kr">import</span> <span class="nx">platforms</span><span class="p">.</span><span class="nx">xdk110</span><span class="p">;</span>
+
+<span class="nx">struct</span> <span class="nx">AccelData</span> <span class="p">{</span>
+ <span class="kd">var</span> <span class="nx">x</span> : <span class="kt">int32</span><span class="p">;</span>
+ <span class="kd">var</span> <span class="nx">y</span> : <span class="kt">int32</span><span class="p">;</span>
+<span class="p">}</span>
+<span class="nx">struct</span> <span class="nx">EnvData</span> <span class="p">{</span>
+ <span class="kd">var</span> <span class="nx">temp</span> : <span class="kt">int32</span><span class="p">;</span>
+<span class="p">}</span>
+
+<span class="nx">fn</span> <span class="nx">toJSON</span><span class="p">(</span><span class="nx">data</span> : <span class="kt">AccelData</span><span class="p">)</span> <span class="p">{</span>
+ <span class="k">return</span> <span class="sb">`{ "x": </span><span class="si">${</span><span class="nx">data</span><span class="p">.</span><span class="nx">x</span><span class="si">}</span><span class="sb">, "y": </span><span class="si">${</span><span class="nx">data</span><span class="p">.</span><span class="nx">y</span><span class="si">}</span><span class="sb"> }`</span><span class="p">;</span>
+<span class="p">}</span>
+<span class="nx">fn</span> <span class="nx">toJSON</span><span class="p">(</span><span class="nx">data</span> : <span class="kt">EnvData</span><span class="p">)</span> <span class="p">{</span>
+ <span class="k">return</span> <span class="sb">`{ "temp": </span><span class="si">${</span><span class="nx">data</span><span class="p">.</span><span class="nx">temp</span><span class="si">}</span><span class="sb"> }`</span><span class="p">;</span>
+<span class="p">}</span>
+
+<span class="nx">every</span> <span class="mi">1</span> <span class="nx">second</span> <span class="p">{</span>
+ <span class="kd">let</span> <span class="nx">environmentalState</span> <span class="o">=</span> <span class="nx">EnvData</span><span class="p">(</span><span class="nx">temp</span> <span class="o">=</span> <span class="nx">environment</span><span class="p">.</span><span class="nx">temperature</span><span class="p">.</span><span class="nx">read</span><span class="p">());</span>
+ <span class="nx">println</span><span class="p">(</span><span class="nx">toJSON</span><span class="p">(</span><span class="nx">environmentalState</span><span class="p">));</span>
+<span class="p">}</span></code></pre></div>
+<p>Notice how we have two functions called <code>toJSON</code>. Depending on the type of the parameter they are called with, the compiler chooses
+one or the other function.</p>
+
+<h2 id="extension-methods">Extension Methods</h2>
+
+<p>In the example above we called the <code>toJSON</code> function how you would expect a function call to look like: <code>toJSON(environmentalState)</code>.
+Mita offers another style of calling functions which we refer to as <em>extension methods</em>: <code>environmentalState.toJSON()</code>.
+With this style you can write the first argument of the function on the left side and call the function “on that expression”.
+This gives the expression an object oriented look and feel, even though it is still just a plain old function call.</p>
+
+<p>Extension methods are very powerful when they are combined with polymorphism.
+Considering the example above we could write code that looks very object oriented, but without incurring its complexity:</p>
+<div class="highlight"><pre class="chroma"><code class="language-TypeScript" data-lang="TypeScript"><span class="nx">fn</span> <span class="nx">printState</span><span class="p">(</span><span class="nx">accel</span> : <span class="kt">AccelData</span><span class="p">,</span> <span class="nx">env</span> : <span class="kt">EnvData</span><span class="p">)</span> <span class="p">{</span>
+ <span class="nx">println</span><span class="p">(</span><span class="nx">accel</span><span class="p">.</span><span class="nx">toJSON</span><span class="p">());</span>
+ <span class="nx">println</span><span class="p">(</span><span class="nx">env</span><span class="p">.</span><span class="nx">toJSON</span><span class="p">());</span>
+<span class="p">}</span></code></pre></div>
+<p>Calling functions this way is not unique to Mita.
+<em>Go</em> supports a very similar concept (receivers), <em>C#</em> supports an extension method concept and <em>Xtend</em> even has the exact same concept.</p>
+
+<h2 id="named-parameters">Named Parameters</h2>
+
+<p>When invoking functions the parameters can be specified by position or name. The style of invocation must not be mixed. There are no optional parameters.</p>
+<div class="highlight"><pre class="chroma"><code class="language-TypeScript" data-lang="TypeScript"><span class="nx">foo</span><span class="p">(</span><span class="mi">1</span><span class="p">,</span> <span class="mi">2</span><span class="p">);</span>
+<span class="nx">foo</span><span class="p">(</span><span class="nx">x</span><span class="o">=</span><span class="mi">1</span><span class="p">,</span> <span class="nx">y</span><span class="o">=</span><span class="mi">2</span><span class="p">);</span>
+<span class="nx">foo</span><span class="p">(</span><span class="nx">x</span><span class="o">=</span><span class="mi">1</span><span class="p">,</span> <span class="nx">x</span><span class="o">=</span><span class="mi">2</span><span class="p">);</span> <span class="cm">/* compile error: parameter x has already been specified */</span>
+<span class="nx">foo</span><span class="p">(</span><span class="nx">x</span><span class="o">=</span><span class="mi">1</span><span class="p">,</span> <span class="mi">2</span><span class="p">);</span> <span class="cm">/* compile error: mixed positional and named parameters */</span>
+<span class="nx">foo</span><span class="p">(</span><span class="mi">1</span><span class="p">,</span> <span class="nx">y</span><span class="o">=</span><span class="mi">2</span><span class="p">);</span> <span class="cm">/* compile error: mixed positional and named parameters */</span></code></pre></div>
+
+ <aside class="copyright" role="note">
+
+ © 2018 The Eclipse Mita Project –
+
+ Documentation built with
+ <a href="https://www.gohugo.io" target="_blank">Hugo</a>
+ using the
+ <a href="http://github.com/digitalcraftsman/hugo-material-docs" target="_blank">Material</a> theme.
+ </aside>
+
+ <footer class="footer">
+
+
+<nav class="pagination" aria-label="Footer">
+ <div class="previous">
+
+ <a href="../../language/arrays/" title="Arrays">
+ <span class="direction">
+ Previous
+ </span>
+ <div class="page">
+ <div class="button button-previous" role="button" aria-label="Previous">
+ <i class="icon icon-back"></i>
+ </div>
+ <div class="stretch">
+ <div class="title">
+ Arrays
+ </div>
+ </div>
+ </div>
+ </a>
+
+ </div>
+
+ <div class="next">
+
+ <a href="../../platforms/xdk110/" title="XDK110">
+ <span class="direction">
+ Next
+ </span>
+ <div class="page">
+ <div class="stretch">
+ <div class="title">
+ XDK110
+ </div>
+ </div>
+ <div class="button button-next" role="button" aria-label="Next">
+ <i class="icon icon-forward"></i>
+ </div>
+ </div>
+ </a>
+
+ </div>
+</nav>
+
+
+
+
+
+ </footer>
+ </div>
+ </article>
+
+ <div class="results" role="status" aria-live="polite">
+ <div class="scrollable">
+ <div class="wrapper">
+ <div class="meta"></div>
+ <div class="list"></div>
+ </div>
+ </div>
+ </div>
+</main>
+
+ <script>
+
+ var base_url = '';
+ var repo_id = '';
+
+ </script>
+
+ <script src="../../javascripts/application.js"></script>
+
+
+ <script>
+ /* Add headers to scrollspy */
+ var headers = document.getElementsByTagName("h2");
+ var scrollspy = document.getElementById('scrollspy');
+
+ if(scrollspy) {
+ if(headers.length > 0) {
+ for(var i = 0; i < headers.length; i++) {
+ var li = document.createElement("li");
+ li.setAttribute("class", "anchor");
+
+ var a = document.createElement("a");
+ a.setAttribute("href", "#" + headers[i].id);
+ a.setAttribute("title", headers[i].innerHTML);
+ a.innerHTML = headers[i].innerHTML;
+
+ li.appendChild(a)
+ scrollspy.appendChild(li);
+ }
+ } else {
+ scrollspy.parentElement.removeChild(scrollspy)
+ }
+
+
+ /* Add permanent link next to the headers */
+ var headers = document.querySelectorAll("h1, h2, h3, h4, h5, h6");
+
+ for(var i = 0; i < headers.length; i++) {
+ var a = document.createElement("a");
+ a.setAttribute("class", "headerlink");
+ a.setAttribute("href", "#" + headers[i].id);
+ a.setAttribute("title", "Permanent link")
+ a.innerHTML = "#";
+ headers[i].appendChild(a);
+ }
+ }
+ </script>
+
+
+
+ <script src="//cdnjs.cloudflare.com/ajax/libs/highlight.js/9.8.0/highlight.min.js"></script>
+ <script>hljs.initHighlightingOnLoad();</script>
+ </body>
+</html>
+
diff --git a/language/immutableAssignmentError.png b/language/immutableAssignmentError.png
new file mode 100644
index 0000000..344f8b1
--- /dev/null
+++ b/language/immutableAssignmentError.png
Binary files differ
diff --git a/language/index.xml b/language/index.xml
new file mode 100644
index 0000000..f6c6b10
--- /dev/null
+++ b/language/index.xml
@@ -0,0 +1,115 @@
+<?xml version="1.0" encoding="utf-8" standalone="yes" ?>
+<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom">
+ <channel>
+ <title>Eclipse Mita</title>
+ <link>/language/</link>
+ <description>Recent content on Eclipse Mita</description>
+ <generator>Hugo -- gohugo.io</generator>
+ <language>en-us</language>
+
+ <atom:link href="/language/index.xml" rel="self" type="application/rss+xml" />
+
+
+ <item>
+ <title>Introduction</title>
+ <link>/language/introduction/</link>
+ <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+
+ <guid>/language/introduction/</guid>
+ <description>Mita is a programming language that is focused on making Internet-Of-Things things easier to program, especially for developers without embedded development background. Its language design and feature-set are meant to make anyone coming from a world of Javascript, Typescript, Java, Swift or Go feel right at home. Compared to C you do not have to care about allocating memory, strings behave naturally, as do arrays. Featuring powerful abstractions and a model-driven system configuration approach we can often tell at compile time if something will not work.</description>
+ </item>
+
+ <item>
+ <title>Basics</title>
+ <link>/language/basics/</link>
+ <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+
+ <guid>/language/basics/</guid>
+ <description>Variables By default, variables in Mita are immutable, which helps us optimize the generated code. However, you can always choose to make variables mutable if you need it. When a variable is immutable, its value has to be set during declaration and cannot be changed afterwards. The following code snippet illustrates the idea (we&rsquo;ve omitted the package and import statements for brevity):
+fn main() { let x = 42; println(`The value of x is ${x}`); x = 64; println(`The value of x is now ${x}`); } When you save this code, you will see an error message Assignment to constant not allowed.</description>
+ </item>
+
+ <item>
+ <title>Packages</title>
+ <link>/language/packages/</link>
+ <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+
+ <guid>/language/packages/</guid>
+ <description>In Mita code is organized in packages, which serve multiple purposes:
+ Divide the namespace: Mita programs have one global namespace per .x file. Unlike Java for example, there are no means to qualify the name of an element. Packages are used to keep this namespace clean. Only things which are explicitly imported from other packages are visible in that namespace. See Importing Packages for more details. Group code: packages are a formidable way to group code which conceptually belongs together.</description>
+ </item>
+
+ <item>
+ <title>System Setup</title>
+ <link>/language/setup/</link>
+ <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+
+ <guid>/language/setup/</guid>
+ <description>System resources have properties which we can configure. For example, an accelerometer has an acceleration range, a filter bandwidth and some power modes which we can change. If we wanted to use Bluetooth for communication we would have to set up the GATT characteristics, device name and advertising interval. If we wanted to connect to a WLAN network, we would have to configure the network name and a preshared key.</description>
+ </item>
+
+ <item>
+ <title>Types</title>
+ <link>/language/types/</link>
+ <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+
+ <guid>/language/types/</guid>
+ <description>Primitive Types We have already seen the basic data types supported by Mita. Primitive types are also called scalar types in other languages, as they contain a single value. Complex types on the other hand represent more than a single value, or are defined by the programmer. There is one type where that distinction is not as clear as it may sound: strings.
+Strings In C there are no strings, but only arrays of characters and some conventions.</description>
+ </item>
+
+ <item>
+ <title>Arrays</title>
+ <link>/language/arrays/</link>
+ <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+
+ <guid>/language/arrays/</guid>
+ <description>Arrays are a fixed-size sequence of objects. In Mita, arrays can hold any type:
+var array1 : array&lt;int32&gt;; struct vec2d { var x : int32; var y : int32; } let array2 : array&lt;vec2d&gt;; Initialization There are multiple ways to initialize and fill arrays:
+let array1 : array&lt;int32&gt; = new array&lt;int32&gt;(size = 10); let array2 : array&lt;int32&gt; = [1,2,3,4]; Length Mita arrays know how long arrays are, unlike C arrays.</description>
+ </item>
+
+ <item>
+ <title>Functions</title>
+ <link>/language/functions/</link>
+ <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+
+ <guid>/language/functions/</guid>
+ <description>Functions play an important role in Mita. They give the language a modern feel through features that go beyond what C has to offer, such as polymorphism and extension methods.
+You have already seen the fn keyword, which allows you to declare new functions. Alternatively you can use function instead of fn if that suits your style better. By convention in Mita functions are named in camel case style. In camel case, words are separated by capital letters and for functions we start with a lower-case one.</description>
+ </item>
+
+ <item>
+ <title>Foreign Function Interface</title>
+ <link>/language/foreignfunctioninterface/</link>
+ <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+
+ <guid>/language/foreignfunctioninterface/</guid>
+ <description>Mita transpiles to C code, i.e. the compiler produces C code rather than a binary executable. This begs the question if we can call existing C code from within Mita programs. Such integration of the &ldquo;target language&rdquo; is referred to as foreign function interface (or FFI in short) because the functions we wish to call from within Mita are defined in a foreign language: C. Other languages sport similar concepts, for example TypeScript supports declarations which allow you to use code written in JavaScript (the language TypeScript compiles to).</description>
+ </item>
+
+ <item>
+ <title>Events</title>
+ <link>/language/events/</link>
+ <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+
+ <guid>/language/events/</guid>
+ <description>System resources and time define events. All events can be handled using the every keyword.
+every accelerometer.any_motion { } every 60 seconds { } Time comes in different resolutions:
+ milliseconds seconds minutes hours Most platforms can only define a limited amount of timers. Therefore the number of time event handlers is limited by that amount. Furthermore, since time is a limited resource, especially on embedded devices, events can be handled multiple times.</description>
+ </item>
+
+ <item>
+ <title>Exceptions</title>
+ <link>/language/exceptions/</link>
+ <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+
+ <guid>/language/exceptions/</guid>
+ <description>Exceptions Exceptions are special types defined by the exception keyword:
+exception FooException; Exceptions can be thrown, which returns control flow to the caller. If the exception is not caught by the caller it propagates further. If the exception is never caught it causes a system reset.
+throw FooException; Exceptions can be caught with the familiar try...catch syntax:
+try { throw FooException; } catch(FooException) { println(&#34;Caught FooException&#34;); } Exceptions are implicit, meaning that functions do not have to (and cannot) declare the exceptions they might throw.</description>
+ </item>
+
+ </channel>
+</rss>
\ No newline at end of file
diff --git a/language/introduction/index.html b/language/introduction/index.html
new file mode 100644
index 0000000..37ad590
--- /dev/null
+++ b/language/introduction/index.html
@@ -0,0 +1,545 @@
+<!DOCTYPE html>
+
+
+
+
+ <html class="no-js">
+
+ <head lang="en-us">
+ <meta charset="utf-8">
+ <meta name="viewport" content="width=device-width,user-scalable=no,initial-scale=1,maximum-scale=1">
+ <meta http-equiv="X-UA-Compatible" content="IE=10" />
+ <title>Introduction - Eclipse Mita</title>
+ <meta name="generator" content="Hugo 0.42.1" />
+
+
+ <meta name="description" content="The documentation of Eclipse Mita.">
+
+ <link rel="canonical" href="../../language/introduction/">
+
+
+ <meta property="og:url" content="/language/introduction/">
+ <meta property="og:title" content="Eclipse Mita">
+ <meta property="og:image" content="/images/mita.svg">
+ <meta name="apple-mobile-web-app-title" content="Eclipse Mita">
+ <meta name="apple-mobile-web-app-capable" content="yes">
+ <meta name="apple-mobile-web-app-status-bar-style" content="black-translucent">
+
+ <link rel="shortcut icon" type="image/x-icon" href="../../images/favicon.ico">
+ <link rel="icon" type="image/x-icon" href="../../images/favicon.ico">
+
+ <style>
+ @font-face {
+ font-family: 'Icon';
+ src: url('/fonts/icon.eot');
+ src: url('/fonts/icon.eot')
+ format('embedded-opentype'),
+ url('/fonts/icon.woff')
+ format('woff'),
+ url('/fonts/icon.ttf')
+ format('truetype'),
+ url('/fonts/icon.svg')
+ format('svg');
+ font-weight: normal;
+ font-style: normal;
+ }
+ </style>
+
+ <link rel="stylesheet" href="../../stylesheets/application.css">
+ <link rel="stylesheet" href="../../stylesheets/temporary.css">
+ <link rel="stylesheet" href="../../stylesheets/palettes.css">
+ <link rel="stylesheet" href="../../stylesheets/highlight/highlight.css">
+
+
+
+
+ <link rel="stylesheet" href="//fonts.googleapis.com/css?family=Ubuntu:400,700|Ubuntu+Mono">
+ <style>
+ body, input {
+ font-family: 'Ubuntu', Helvetica, Arial, sans-serif;
+ }
+ pre, code {
+ font-family: 'Ubuntu Mono', 'Courier New', 'Courier', monospace;
+ }
+ </style>
+
+
+ <link rel="stylesheet" href="../../css/custom.css">
+
+ <script src="../../javascripts/modernizr.js"></script>
+
+
+
+ </head>
+ <body class="palette-primary-blue-grey palette-accent-light-blue">
+
+
+
+
+<div class="backdrop">
+ <div class="backdrop-paper"></div>
+</div>
+
+<input class="toggle" type="checkbox" id="toggle-drawer">
+<input class="toggle" type="checkbox" id="toggle-search">
+<label class="toggle-button overlay" for="toggle-drawer"></label>
+
+<header class="header">
+ <nav aria-label="Header">
+ <div class="bar default">
+ <div class="button button-menu" role="button" aria-label="Menu">
+ <label class="toggle-button icon icon-menu" for="toggle-drawer">
+ <span></span>
+ </label>
+ </div>
+ <div class="stretch">
+ <div class="title">
+ Introduction
+ </div>
+ </div>
+
+
+ <div class="button button-twitter" role="button" aria-label="Twitter">
+ <a href="https://twitter.com/eclipse_mita" title="@eclipse_mita on Twitter" target="_blank" class="toggle-button icon icon-twitter"></a>
+ </div>
+
+
+
+ <div class="button button-github" role="button" aria-label="GitHub">
+ <a href="https://github.com/eclipse/mita" title="@eclipse/mita on GitHub" target="_blank" class="toggle-button icon icon-github"></a>
+ </div>
+
+
+
+ </div>
+ <div class="bar search">
+ <div class="button button-close" role="button" aria-label="Close">
+ <label class="toggle-button icon icon-back" for="toggle-search"></label>
+ </div>
+ <div class="stretch">
+ <div class="field">
+ <input class="query" type="text" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck>
+ </div>
+ </div>
+ <div class="button button-reset" role="button" aria-label="Search">
+ <button class="toggle-button icon icon-close" id="reset-search"></button>
+ </div>
+ </div>
+</nav>
+</header>
+
+<main class="main">
+ <div class="drawer">
+ <nav aria-label="Navigation">
+ <a href="../../" class="project">
+ <div class="banner">
+
+ <div class="logo">
+ <img src="../../images/mita.svg">
+ </div>
+
+ <div class="name">
+ <strong>Eclipse Mita </strong>
+
+ </div>
+ </div>
+ </a>
+
+ <div class="scrollable">
+ <div class="wrapper">
+
+
+ <div class="toc">
+
+ <ul>
+
+
+
+
+
+<li>
+
+
+
+
+
+<a title="Download" href="http://github.com/eclipse/mita">
+
+ Download
+</a>
+
+
+
+
+</li>
+
+
+
+<li>
+
+
+
+
+
+<a title="Concepts" href="../../concepts/">
+
+ Concepts
+</a>
+
+
+
+
+</li>
+
+
+
+<li>
+
+ <span class="section">Language</span>
+ <ul>
+
+
+
+
+
+
+<a class="current" title="Introduction" href="../../language/introduction/">
+
+ Introduction
+</a>
+
+
+<ul id="scrollspy">
+</ul>
+
+
+
+
+
+
+
+
+<a title="Basics" href="../../language/basics/">
+
+ Basics
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Packages" href="../../language/packages/">
+
+ Packages
+</a>
+
+
+
+
+
+
+
+
+
+<a title="System Setup" href="../../language/setup/">
+
+ System Setup
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Types" href="../../language/types/">
+
+ Types
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Arrays" href="../../language/arrays/">
+
+ Arrays
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Functions" href="../../language/functions/">
+
+ Functions
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Foreign Function Interface" href="../../language/foreignfunctioninterface/">
+
+ Foreign Function Interface
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Events" href="../../language/events/">
+
+ Events
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Exceptions" href="../../language/exceptions/">
+
+ Exceptions
+</a>
+
+
+
+
+ </ul>
+
+</li>
+
+
+
+<li>
+
+ <span class="section">Platforms</span>
+ <ul>
+
+
+
+
+
+
+<a title="XDK110" href="../../platforms/xdk110/">
+
+ XDK110
+</a>
+
+
+
+
+ </ul>
+
+</li>
+
+
+ </ul>
+
+
+
+ </div>
+ </div>
+ </div>
+</nav>
+
+ </div>
+
+ <article class="article">
+ <div class="wrapper">
+ <h1>Introduction </h1>
+
+
+
+<p>Mita is a programming language that is focused on making Internet-Of-Things things easier to program, especially for developers without embedded development background.
+Its language design and feature-set are meant to make anyone coming from a world of Javascript, Typescript, Java, Swift or Go feel right at home.
+Compared to C you do not have to care about allocating memory, strings behave naturally, as do arrays.
+Featuring powerful abstractions and a model-driven system configuration approach we can often tell at compile time if something will not work.
+At the core of Mita is a platform model which describes what resources (think connectivity, sensors or low-level hardware interfaces) you have to work with.</p>
+
+<p>All Mita code compiles to C code. This is a very powerful feature.
+It allows developers to inspect the generated code, learn from it and when they hit that inevitable glass ceiling continue where they left off, but in C.
+Further, once you leave the prototyping phase or feel that you need more control over your system, you can always fall back to the C level and go from there.</p>
+
+<h2 id="anatomy-of-an-mita-program">Anatomy of an Mita program</h2>
+
+<p>Mita programs live in files ending with <code>.x</code>, for example <code>application.x</code>. Let’s have a look at an example which implements a simple Bluetooth enabled shock detector:</p>
+<div class="highlight"><pre class="chroma"><code class="language-TypeScript" data-lang="TypeScript"><span class="kr">package</span> <span class="nx">main</span><span class="p">;</span>
+
+<span class="kr">import</span> <span class="nx">platforms</span><span class="p">.</span><span class="nx">xdk110</span><span class="p">;</span>
+
+<span class="nx">setup</span> <span class="nx">smartphone</span> : <span class="kt">BLE</span> <span class="p">{</span>
+ <span class="nx">deviceName</span> <span class="o">=</span> <span class="s2">"HelloWorld"</span><span class="p">;</span>
+ <span class="kd">var</span> <span class="nx">shockDetected</span> <span class="o">=</span> <span class="nx">bool_characteristic</span><span class="p">(</span><span class="nx">UUID</span><span class="o">=</span><span class="mh">0xCAFE</span><span class="p">);</span>
+<span class="p">}</span>
+
+<span class="nx">every</span> <span class="nx">accelerometer</span><span class="p">.</span><span class="nx">activity</span> <span class="p">{</span>
+ <span class="k">if</span><span class="p">(</span><span class="nx">accelerometer</span><span class="p">.</span><span class="nx">magnitude</span><span class="p">.</span><span class="nx">read</span><span class="p">()</span> <span class="o">></span> <span class="mi">5000</span><span class="p">)</span> <span class="p">{</span>
+ <span class="nx">smartphone</span><span class="p">.</span><span class="nx">shockDetected</span><span class="p">.</span><span class="nx">write</span><span class="p">(</span><span class="kc">true</span><span class="p">);</span>
+ <span class="p">}</span>
+<span class="p">}</span></code></pre></div>
+<p>Now let’s go over this code and understand it bit by bit.</p>
+<div class="highlight"><pre class="chroma"><code class="language-TypeScript" data-lang="TypeScript"><span class="kr">package</span> <span class="nx">main</span><span class="p">;</span></code></pre></div>
+<p>All Mita code has a package associated with it, which means that the first line of any <code>.x</code> file is always a <em>package</em> statement which tells the compiler to which package the subsequent code belongs to.
+There is no fixed naming that you would need to adhere to, merely conventions. For example, the main application logic is typically located in a package named <em>main</em>. More details about packages can be found in the [language section].</p>
+<div class="highlight"><pre class="chroma"><code class="language-TypeScript" data-lang="TypeScript"><span class="kr">import</span> <span class="nx">platforms</span><span class="p">.</span><span class="nx">xdk110</span><span class="p">;</span></code></pre></div>
+<p>Much like packages are defined, they need to be imported so that they can be used. This import is a special one, and the only import that every <code>.x</code> file needs to have. It imports the platform for which we are writing our program.
+By convention platforms are located in the <em>platforms</em> package.</p>
+<div class="highlight"><pre class="chroma"><code class="language-TypeScript" data-lang="TypeScript"><span class="nx">setup</span> <span class="nx">smartphone</span> : <span class="kt">BLE</span> <span class="p">{</span>
+ <span class="p">...</span>
+<span class="p">}</span></code></pre></div>
+<p>Setup blocks configure the resources we have at our disposal, in this case a Bluetooth Low Energy connectivity. Which resources exist depends on the platform you have previously imported - not every hardware has the same radio or sensors installed, for example. The content of the setup block depends on the resource being set up. Whenever you are inside a setup block, you can use auto-complete (<code>Ctrl+Space</code>)
+to find out what you can configure or do next.</p>
+<div class="highlight"><pre class="chroma"><code class="language-TypeScript" data-lang="TypeScript"><span class="nx">every</span> <span class="nx">accelerometer</span><span class="p">.</span><span class="nx">activity</span> <span class="p">{</span>
+ <span class="p">...</span>
+<span class="p">}</span></code></pre></div>
+<p>Most of their time IoT devices spend sleeping in some low-power mode. Every now and then, triggered by time or some external event, they wake up do some sensing, computation and send data using wireless connectivity.
+Mita is an event based language which maps nicely to the way such IoT devices work. Using the <em>every</em> keyword we can react to events or time. Instead of <code>every accelerometer.activity { ... }</code> we could also write <code>every 100 milliseconds { ... }</code> which would simply execute every 100 milliseconds.</p>
+<div class="highlight"><pre class="chroma"><code class="language-TypeScript" data-lang="TypeScript"><span class="k">if</span><span class="p">(</span><span class="nx">accelerometer</span><span class="p">.</span><span class="nx">magnitude</span><span class="p">.</span><span class="nx">read</span><span class="p">()</span> <span class="o">></span> <span class="mi">5000</span><span class="p">)</span> <span class="p">{</span>
+ <span class="p">...</span>
+<span class="p">}</span></code></pre></div>
+<p>Sensor data and other resources providing data at runtime (we call them <em>modalities</em>) can be read at any time. We did not have to set up the accelerometer, the platform told the compiler that such a sensor exists and has a magnitude that can be read. Should you want to change the default values of the accelerometer after all, you can always use a <code>setup accelerometer { ... }</code> block to do that.</p>
+<div class="highlight"><pre class="chroma"><code class="language-TypeScript" data-lang="TypeScript"><span class="nx">smartphone</span><span class="p">.</span><span class="nx">shockDetected</span><span class="p">.</span><span class="nx">write</span><span class="p">(</span><span class="kc">true</span><span class="p">);</span></code></pre></div>
+<p>Earlier in the setup block for the Bluetooth Low Energy resource we configured a <a href="https://en.wikipedia.org/wiki/Bluetooth_Low_Energy#Software_model">BLE GATT characteristic</a>, which we named <code>shockDetected</code>. To send out data using Bluetooth all we need to do is to write to this characteristic using the built-in <code>write</code> function. All the nitty details of how to use the underlying Bluetooth stack are handled by the platform, not by you, the developer.</p>
+
+<p>That concludes our first tour of an Mita program. There is a lot more to learn though. The following sections give an overview of the basic concepts, followed by more in-depth chapters of specific language elements.</p>
+
+
+ <aside class="copyright" role="note">
+
+ © 2018 The Eclipse Mita Project –
+
+ Documentation built with
+ <a href="https://www.gohugo.io" target="_blank">Hugo</a>
+ using the
+ <a href="http://github.com/digitalcraftsman/hugo-material-docs" target="_blank">Material</a> theme.
+ </aside>
+
+ <footer class="footer">
+
+
+<nav class="pagination" aria-label="Footer">
+ <div class="previous">
+
+ </div>
+
+ <div class="next">
+
+ <a href="../../language/basics/" title="Basics">
+ <span class="direction">
+ Next
+ </span>
+ <div class="page">
+ <div class="stretch">
+ <div class="title">
+ Basics
+ </div>
+ </div>
+ <div class="button button-next" role="button" aria-label="Next">
+ <i class="icon icon-forward"></i>
+ </div>
+ </div>
+ </a>
+
+ </div>
+</nav>
+
+
+
+
+
+ </footer>
+ </div>
+ </article>
+
+ <div class="results" role="status" aria-live="polite">
+ <div class="scrollable">
+ <div class="wrapper">
+ <div class="meta"></div>
+ <div class="list"></div>
+ </div>
+ </div>
+ </div>
+</main>
+
+ <script>
+
+ var base_url = '';
+ var repo_id = '';
+
+ </script>
+
+ <script src="../../javascripts/application.js"></script>
+
+
+ <script>
+ /* Add headers to scrollspy */
+ var headers = document.getElementsByTagName("h2");
+ var scrollspy = document.getElementById('scrollspy');
+
+ if(scrollspy) {
+ if(headers.length > 0) {
+ for(var i = 0; i < headers.length; i++) {
+ var li = document.createElement("li");
+ li.setAttribute("class", "anchor");
+
+ var a = document.createElement("a");
+ a.setAttribute("href", "#" + headers[i].id);
+ a.setAttribute("title", headers[i].innerHTML);
+ a.innerHTML = headers[i].innerHTML;
+
+ li.appendChild(a)
+ scrollspy.appendChild(li);
+ }
+ } else {
+ scrollspy.parentElement.removeChild(scrollspy)
+ }
+
+
+ /* Add permanent link next to the headers */
+ var headers = document.querySelectorAll("h1, h2, h3, h4, h5, h6");
+
+ for(var i = 0; i < headers.length; i++) {
+ var a = document.createElement("a");
+ a.setAttribute("class", "headerlink");
+ a.setAttribute("href", "#" + headers[i].id);
+ a.setAttribute("title", "Permanent link")
+ a.innerHTML = "#";
+ headers[i].appendChild(a);
+ }
+ }
+ </script>
+
+
+
+ <script src="//cdnjs.cloudflare.com/ajax/libs/highlight.js/9.8.0/highlight.min.js"></script>
+ <script>hljs.initHighlightingOnLoad();</script>
+ </body>
+</html>
+
diff --git a/language/packages/index.html b/language/packages/index.html
new file mode 100644
index 0000000..4e1eaca
--- /dev/null
+++ b/language/packages/index.html
@@ -0,0 +1,584 @@
+<!DOCTYPE html>
+
+
+
+
+ <html class="no-js">
+
+ <head lang="en-us">
+ <meta charset="utf-8">
+ <meta name="viewport" content="width=device-width,user-scalable=no,initial-scale=1,maximum-scale=1">
+ <meta http-equiv="X-UA-Compatible" content="IE=10" />
+ <title>Packages - Eclipse Mita</title>
+ <meta name="generator" content="Hugo 0.42.1" />
+
+
+ <meta name="description" content="The documentation of Eclipse Mita.">
+
+ <link rel="canonical" href="../../language/packages/">
+
+
+ <meta property="og:url" content="/language/packages/">
+ <meta property="og:title" content="Eclipse Mita">
+ <meta property="og:image" content="/images/mita.svg">
+ <meta name="apple-mobile-web-app-title" content="Eclipse Mita">
+ <meta name="apple-mobile-web-app-capable" content="yes">
+ <meta name="apple-mobile-web-app-status-bar-style" content="black-translucent">
+
+ <link rel="shortcut icon" type="image/x-icon" href="../../images/favicon.ico">
+ <link rel="icon" type="image/x-icon" href="../../images/favicon.ico">
+
+ <style>
+ @font-face {
+ font-family: 'Icon';
+ src: url('/fonts/icon.eot');
+ src: url('/fonts/icon.eot')
+ format('embedded-opentype'),
+ url('/fonts/icon.woff')
+ format('woff'),
+ url('/fonts/icon.ttf')
+ format('truetype'),
+ url('/fonts/icon.svg')
+ format('svg');
+ font-weight: normal;
+ font-style: normal;
+ }
+ </style>
+
+ <link rel="stylesheet" href="../../stylesheets/application.css">
+ <link rel="stylesheet" href="../../stylesheets/temporary.css">
+ <link rel="stylesheet" href="../../stylesheets/palettes.css">
+ <link rel="stylesheet" href="../../stylesheets/highlight/highlight.css">
+
+
+
+
+ <link rel="stylesheet" href="//fonts.googleapis.com/css?family=Ubuntu:400,700|Ubuntu+Mono">
+ <style>
+ body, input {
+ font-family: 'Ubuntu', Helvetica, Arial, sans-serif;
+ }
+ pre, code {
+ font-family: 'Ubuntu Mono', 'Courier New', 'Courier', monospace;
+ }
+ </style>
+
+
+ <link rel="stylesheet" href="../../css/custom.css">
+
+ <script src="../../javascripts/modernizr.js"></script>
+
+
+
+ </head>
+ <body class="palette-primary-blue-grey palette-accent-light-blue">
+
+
+
+
+<div class="backdrop">
+ <div class="backdrop-paper"></div>
+</div>
+
+<input class="toggle" type="checkbox" id="toggle-drawer">
+<input class="toggle" type="checkbox" id="toggle-search">
+<label class="toggle-button overlay" for="toggle-drawer"></label>
+
+<header class="header">
+ <nav aria-label="Header">
+ <div class="bar default">
+ <div class="button button-menu" role="button" aria-label="Menu">
+ <label class="toggle-button icon icon-menu" for="toggle-drawer">
+ <span></span>
+ </label>
+ </div>
+ <div class="stretch">
+ <div class="title">
+ Packages
+ </div>
+ </div>
+
+
+ <div class="button button-twitter" role="button" aria-label="Twitter">
+ <a href="https://twitter.com/eclipse_mita" title="@eclipse_mita on Twitter" target="_blank" class="toggle-button icon icon-twitter"></a>
+ </div>
+
+
+
+ <div class="button button-github" role="button" aria-label="GitHub">
+ <a href="https://github.com/eclipse/mita" title="@eclipse/mita on GitHub" target="_blank" class="toggle-button icon icon-github"></a>
+ </div>
+
+
+
+ </div>
+ <div class="bar search">
+ <div class="button button-close" role="button" aria-label="Close">
+ <label class="toggle-button icon icon-back" for="toggle-search"></label>
+ </div>
+ <div class="stretch">
+ <div class="field">
+ <input class="query" type="text" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck>
+ </div>
+ </div>
+ <div class="button button-reset" role="button" aria-label="Search">
+ <button class="toggle-button icon icon-close" id="reset-search"></button>
+ </div>
+ </div>
+</nav>
+</header>
+
+<main class="main">
+ <div class="drawer">
+ <nav aria-label="Navigation">
+ <a href="../../" class="project">
+ <div class="banner">
+
+ <div class="logo">
+ <img src="../../images/mita.svg">
+ </div>
+
+ <div class="name">
+ <strong>Eclipse Mita </strong>
+
+ </div>
+ </div>
+ </a>
+
+ <div class="scrollable">
+ <div class="wrapper">
+
+
+ <div class="toc">
+
+ <ul>
+
+
+
+
+
+<li>
+
+
+
+
+
+<a title="Download" href="http://github.com/eclipse/mita">
+
+ Download
+</a>
+
+
+
+
+</li>
+
+
+
+<li>
+
+
+
+
+
+<a title="Concepts" href="../../concepts/">
+
+ Concepts
+</a>
+
+
+
+
+</li>
+
+
+
+<li>
+
+ <span class="section">Language</span>
+ <ul>
+
+
+
+
+
+
+<a title="Introduction" href="../../language/introduction/">
+
+ Introduction
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Basics" href="../../language/basics/">
+
+ Basics
+</a>
+
+
+
+
+
+
+
+
+
+<a class="current" title="Packages" href="../../language/packages/">
+
+ Packages
+</a>
+
+
+<ul id="scrollspy">
+</ul>
+
+
+
+
+
+
+
+
+<a title="System Setup" href="../../language/setup/">
+
+ System Setup
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Types" href="../../language/types/">
+
+ Types
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Arrays" href="../../language/arrays/">
+
+ Arrays
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Functions" href="../../language/functions/">
+
+ Functions
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Foreign Function Interface" href="../../language/foreignfunctioninterface/">
+
+ Foreign Function Interface
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Events" href="../../language/events/">
+
+ Events
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Exceptions" href="../../language/exceptions/">
+
+ Exceptions
+</a>
+
+
+
+
+ </ul>
+
+</li>
+
+
+
+<li>
+
+ <span class="section">Platforms</span>
+ <ul>
+
+
+
+
+
+
+<a title="XDK110" href="../../platforms/xdk110/">
+
+ XDK110
+</a>
+
+
+
+
+ </ul>
+
+</li>
+
+
+ </ul>
+
+
+
+ </div>
+ </div>
+ </div>
+</nav>
+
+ </div>
+
+ <article class="article">
+ <div class="wrapper">
+ <h1>Packages </h1>
+
+
+
+<p>In Mita code is organized in packages, which serve multiple purposes:</p>
+
+<ul>
+<li><strong>Divide the namespace</strong>: Mita programs have one global namespace per <code>.x</code> file. Unlike Java for example, there are no means to qualify the name of an element. Packages are used to keep this namespace clean. Only things which are explicitly imported from other packages are visible in that namespace. See <a href="#importing-packages">Importing Packages</a> for more details.</li>
+<li><strong>Group code</strong>: packages are a formidable way to group code which conceptually belongs together. Where other languages have modules or classes, Mita uses packages.</li>
+<li><strong>Hide information</strong>: in Mita visibility of functions, types and the likes is decided on a package level. There are only two levels of visibility: things are either visible outside a package or they are not. This is very similar to how NodeJS manages visibility (think <code>module.export</code>) or how Go does it (uppercase functions/structure members/types get exported). See <a href="#hiding-information-visibility">Hiding Information</a> for more details.</li>
+</ul>
+
+<p>All Mita code belongs to a particular package. Thus, the first line in every <code>.x</code> file is the <code>package</code> statement. The main application logic, for example, by convention is in the <code>main</code> package:</p>
+<div class="highlight"><pre class="chroma"><code class="language-TypeScript" data-lang="TypeScript"><span class="kr">package</span> <span class="nx">main</span><span class="p">;</span>
+
+<span class="p">...</span></code></pre></div>
+<h2 id="naming-conventions">Naming Conventions</h2>
+
+<p>Just now we have seen the first naming convention: the core application logic and system setup are in the <code>main</code> package.
+The platforms which we import – each Mita program needs to import a platform – are by convention found in the <code>platforms</code> package.
+The <a href="{{ < ref "/platforms/xdk110.md" > }}">XDK110 platform</a> for example is in the <code>platforms.xdk110</code> package.</p>
+
+<p>All in all you are free to name your packages however you like. The files which constitute your package content can be located wherever in the project. However, it is a good idea to replicate the logical package structure in folders. For example:</p>
+<div class="highlight"><pre class="chroma"><code class="language-Pre" data-lang="Pre"><span class="nx">algorithm</span><span class="o">/</span>
+ <span class="p">|</span><span class="o">-</span> <span class="nx">api</span><span class="p">.</span><span class="nx">x</span> <span class="kn">package</span> <span class="nx">algorithm</span>
+ <span class="p">|</span><span class="o">-</span> <span class="nx">statistics</span><span class="p">.</span><span class="nx">x</span> <span class="kn">package</span> <span class="nx">algorithm</span><span class="p">.</span><span class="nx">statistics</span>
+ <span class="err">\</span><span class="o">-</span> <span class="nx">structures</span><span class="p">.</span><span class="nx">x</span> <span class="kn">package</span> <span class="nx">algorithm</span><span class="p">.</span><span class="nx">structures</span>
+<span class="nx">main</span><span class="p">.</span><span class="nx">x</span> <span class="kn">package</span> <span class="nx">main</span></code></pre></div>
+<p>Notice how we use a dot <code>.</code> to indicate a sub-package relationship.
+This is merely a convention and has no influence on visibility or any other implication.</p>
+
+<h2 id="importing-packages">Importing Packages</h2>
+
+<p>Packages divide the namespace, which is the space in which the names of functions and types have to be unique.
+Within a package all type names and functions (save for <a href="{{ < ref "/platforms/xdk110.md" > }}">polymorphism</a>) have to be unique.
+When we import a package, we import all names from that namespace into our local program. Consider the following example:</p>
+<div class="highlight"><pre class="chroma"><code class="language-TypeScript" data-lang="TypeScript"><span class="c1">// file: mypackage.x
+</span><span class="c1"></span><span class="kr">package</span> <span class="nx">mypackage</span><span class="p">;</span>
+<span class="p">...</span>
+
+<span class="kr">export</span> <span class="nx">fn</span> <span class="nx">answerTheQuestion() {</span>
+ <span class="k">return</span> <span class="mi">42</span><span class="p">;</span>
+<span class="p">}</span>
+
+<span class="c1">// file: application.x
+</span><span class="c1"></span><span class="kr">package</span> <span class="nx">main</span><span class="p">;</span>
+<span class="kr">import</span> <span class="nx">mypackage</span><span class="p">;</span>
+
+<span class="nx">every</span> <span class="nx">XDK110</span><span class="p">.</span><span class="nx">startup</span> <span class="p">{</span>
+ <span class="nx">println</span><span class="p">(</span><span class="sb">`The answer: </span><span class="si">${</span><span class="nx">answerTheQuestion</span><span class="p">()</span><span class="si">}</span><span class="sb">`</span><span class="p">);</span>
+<span class="p">}</span></code></pre></div>
+<p>If it were not for the <code>import mypackage</code> statement, the <code>answerTheQuestion</code> function would not be visible in <code>application.x</code>.</p>
+
+<p>To import a package use the <code>import</code> statement. We have seen those in previous examples when we imported the platform, which is mandatory. Thus, every Mita program file must have at least one import: the platform import.
+For example:</p>
+<div class="highlight"><pre class="chroma"><code class="language-TypeScript" data-lang="TypeScript"><span class="kr">package</span> <span class="nx">main</span><span class="p">;</span>
+<span class="kr">import</span> <span class="nx">platforms</span><span class="p">.</span><span class="nx">xdk110</span><span class="p">;</span>
+
+<span class="p">...</span></code></pre></div>
+<p>You can shadow imported names within the current file. If in the example above <code>application.x</code> defined its own <code>answerTheQuestion()</code> function, all code within <code>application.x</code> would refer to that one instead of the imported function.</p>
+
+<h2 id="hiding-information-visibility">Hiding Information (Visibility)</h2>
+
+<p>By default nothing is visible outside a package, nothing is exported to the outside world. This way, if you want to make things available outside the package, that has to be a conscious decision. To do so, mark what you want to export with the <code>export</code> keyword. For example:</p>
+<div class="highlight"><pre class="chroma"><code class="language-TypeScript" data-lang="TypeScript"><span class="kr">package</span> <span class="nx">utility</span><span class="p">;</span>
+<span class="kr">import</span> <span class="nx">platforms</span><span class="p">.</span><span class="nx">xdk110</span><span class="p">;</span>
+
+<span class="nx">fn</span> <span class="nx">saturate</span><span class="p">(</span><span class="nx">config</span> : <span class="kt">PidController</span><span class="p">)</span> <span class="p">{</span>
+ <span class="p">...</span>
+<span class="p">}</span>
+
+<span class="kr">export</span> <span class="nx">fn</span> <span class="nx">control</span><span class="p">(</span><span class="nx">config</span> : <span class="kt">PidController</span><span class="p">,</span> <span class="nx">input</span> : <span class="kt">int32</span><span class="p">)</span> <span class="o">:</span> <span class="nx">int32</span> <span class="p">{</span>
+ <span class="p">...</span>
+ <span class="nx">saturate</span><span class="p">(</span><span class="nx">config</span><span class="p">);</span>
+ <span class="p">...</span>
+<span class="p">}</span></code></pre></div>
+<p>In this example, the <code>saturate</code> function is not visible outside the <code>utility</code> package, but the <code>control</code> function is because it is marked with the <code>export</code> keyword.
+This allows you to hide functions and types which are not meant for consumption outside of package and thus to provide a well defined API.
+The generated C code will respect your export choices and mark non-exported objects as <code>static</code> which is “C speak” for <em>visible only within the same file</em>.</p>
+
+
+ <aside class="copyright" role="note">
+
+ © 2018 The Eclipse Mita Project –
+
+ Documentation built with
+ <a href="https://www.gohugo.io" target="_blank">Hugo</a>
+ using the
+ <a href="http://github.com/digitalcraftsman/hugo-material-docs" target="_blank">Material</a> theme.
+ </aside>
+
+ <footer class="footer">
+
+
+<nav class="pagination" aria-label="Footer">
+ <div class="previous">
+
+ <a href="../../language/basics/" title="Basics">
+ <span class="direction">
+ Previous
+ </span>
+ <div class="page">
+ <div class="button button-previous" role="button" aria-label="Previous">
+ <i class="icon icon-back"></i>
+ </div>
+ <div class="stretch">
+ <div class="title">
+ Basics
+ </div>
+ </div>
+ </div>
+ </a>
+
+ </div>
+
+ <div class="next">
+
+ <a href="../../language/setup/" title="System Setup">
+ <span class="direction">
+ Next
+ </span>
+ <div class="page">
+ <div class="stretch">
+ <div class="title">
+ System Setup
+ </div>
+ </div>
+ <div class="button button-next" role="button" aria-label="Next">
+ <i class="icon icon-forward"></i>
+ </div>
+ </div>
+ </a>
+
+ </div>
+</nav>
+
+
+
+
+
+ </footer>
+ </div>
+ </article>
+
+ <div class="results" role="status" aria-live="polite">
+ <div class="scrollable">
+ <div class="wrapper">
+ <div class="meta"></div>
+ <div class="list"></div>
+ </div>
+ </div>
+ </div>
+</main>
+
+ <script>
+
+ var base_url = '';
+ var repo_id = '';
+
+ </script>
+
+ <script src="../../javascripts/application.js"></script>
+
+
+ <script>
+ /* Add headers to scrollspy */
+ var headers = document.getElementsByTagName("h2");
+ var scrollspy = document.getElementById('scrollspy');
+
+ if(scrollspy) {
+ if(headers.length > 0) {
+ for(var i = 0; i < headers.length; i++) {
+ var li = document.createElement("li");
+ li.setAttribute("class", "anchor");
+
+ var a = document.createElement("a");
+ a.setAttribute("href", "#" + headers[i].id);
+ a.setAttribute("title", headers[i].innerHTML);
+ a.innerHTML = headers[i].innerHTML;
+
+ li.appendChild(a)
+ scrollspy.appendChild(li);
+ }
+ } else {
+ scrollspy.parentElement.removeChild(scrollspy)
+ }
+
+
+ /* Add permanent link next to the headers */
+ var headers = document.querySelectorAll("h1, h2, h3, h4, h5, h6");
+
+ for(var i = 0; i < headers.length; i++) {
+ var a = document.createElement("a");
+ a.setAttribute("class", "headerlink");
+ a.setAttribute("href", "#" + headers[i].id);
+ a.setAttribute("title", "Permanent link")
+ a.innerHTML = "#";
+ headers[i].appendChild(a);
+ }
+ }
+ </script>
+
+
+
+ <script src="//cdnjs.cloudflare.com/ajax/libs/highlight.js/9.8.0/highlight.min.js"></script>
+ <script>hljs.initHighlightingOnLoad();</script>
+ </body>
+</html>
+
diff --git a/language/setup/index.html b/language/setup/index.html
new file mode 100644
index 0000000..c51187a
--- /dev/null
+++ b/language/setup/index.html
@@ -0,0 +1,602 @@
+<!DOCTYPE html>
+
+
+
+
+ <html class="no-js">
+
+ <head lang="en-us">
+ <meta charset="utf-8">
+ <meta name="viewport" content="width=device-width,user-scalable=no,initial-scale=1,maximum-scale=1">
+ <meta http-equiv="X-UA-Compatible" content="IE=10" />
+ <title>System Setup - Eclipse Mita</title>
+ <meta name="generator" content="Hugo 0.42.1" />
+
+
+ <meta name="description" content="The documentation of Eclipse Mita.">
+
+ <link rel="canonical" href="../../language/setup/">
+
+
+ <meta property="og:url" content="/language/setup/">
+ <meta property="og:title" content="Eclipse Mita">
+ <meta property="og:image" content="/images/mita.svg">
+ <meta name="apple-mobile-web-app-title" content="Eclipse Mita">
+ <meta name="apple-mobile-web-app-capable" content="yes">
+ <meta name="apple-mobile-web-app-status-bar-style" content="black-translucent">
+
+ <link rel="shortcut icon" type="image/x-icon" href="../../images/favicon.ico">
+ <link rel="icon" type="image/x-icon" href="../../images/favicon.ico">
+
+ <style>
+ @font-face {
+ font-family: 'Icon';
+ src: url('/fonts/icon.eot');
+ src: url('/fonts/icon.eot')
+ format('embedded-opentype'),
+ url('/fonts/icon.woff')
+ format('woff'),
+ url('/fonts/icon.ttf')
+ format('truetype'),
+ url('/fonts/icon.svg')
+ format('svg');
+ font-weight: normal;
+ font-style: normal;
+ }
+ </style>
+
+ <link rel="stylesheet" href="../../stylesheets/application.css">
+ <link rel="stylesheet" href="../../stylesheets/temporary.css">
+ <link rel="stylesheet" href="../../stylesheets/palettes.css">
+ <link rel="stylesheet" href="../../stylesheets/highlight/highlight.css">
+
+
+
+
+ <link rel="stylesheet" href="//fonts.googleapis.com/css?family=Ubuntu:400,700|Ubuntu+Mono">
+ <style>
+ body, input {
+ font-family: 'Ubuntu', Helvetica, Arial, sans-serif;
+ }
+ pre, code {
+ font-family: 'Ubuntu Mono', 'Courier New', 'Courier', monospace;
+ }
+ </style>
+
+
+ <link rel="stylesheet" href="../../css/custom.css">
+
+ <script src="../../javascripts/modernizr.js"></script>
+
+
+
+ </head>
+ <body class="palette-primary-blue-grey palette-accent-light-blue">
+
+
+
+
+<div class="backdrop">
+ <div class="backdrop-paper"></div>
+</div>
+
+<input class="toggle" type="checkbox" id="toggle-drawer">
+<input class="toggle" type="checkbox" id="toggle-search">
+<label class="toggle-button overlay" for="toggle-drawer"></label>
+
+<header class="header">
+ <nav aria-label="Header">
+ <div class="bar default">
+ <div class="button button-menu" role="button" aria-label="Menu">
+ <label class="toggle-button icon icon-menu" for="toggle-drawer">
+ <span></span>
+ </label>
+ </div>
+ <div class="stretch">
+ <div class="title">
+ System Setup
+ </div>
+ </div>
+
+
+ <div class="button button-twitter" role="button" aria-label="Twitter">
+ <a href="https://twitter.com/eclipse_mita" title="@eclipse_mita on Twitter" target="_blank" class="toggle-button icon icon-twitter"></a>
+ </div>
+
+
+
+ <div class="button button-github" role="button" aria-label="GitHub">
+ <a href="https://github.com/eclipse/mita" title="@eclipse/mita on GitHub" target="_blank" class="toggle-button icon icon-github"></a>
+ </div>
+
+
+
+ </div>
+ <div class="bar search">
+ <div class="button button-close" role="button" aria-label="Close">
+ <label class="toggle-button icon icon-back" for="toggle-search"></label>
+ </div>
+ <div class="stretch">
+ <div class="field">
+ <input class="query" type="text" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck>
+ </div>
+ </div>
+ <div class="button button-reset" role="button" aria-label="Search">
+ <button class="toggle-button icon icon-close" id="reset-search"></button>
+ </div>
+ </div>
+</nav>
+</header>
+
+<main class="main">
+ <div class="drawer">
+ <nav aria-label="Navigation">
+ <a href="../../" class="project">
+ <div class="banner">
+
+ <div class="logo">
+ <img src="../../images/mita.svg">
+ </div>
+
+ <div class="name">
+ <strong>Eclipse Mita </strong>
+
+ </div>
+ </div>
+ </a>
+
+ <div class="scrollable">
+ <div class="wrapper">
+
+
+ <div class="toc">
+
+ <ul>
+
+
+
+
+
+<li>
+
+
+
+
+
+<a title="Download" href="http://github.com/eclipse/mita">
+
+ Download
+</a>
+
+
+
+
+</li>
+
+
+
+<li>
+
+
+
+
+
+<a title="Concepts" href="../../concepts/">
+
+ Concepts
+</a>
+
+
+
+
+</li>
+
+
+
+<li>
+
+ <span class="section">Language</span>
+ <ul>
+
+
+
+
+
+
+<a title="Introduction" href="../../language/introduction/">
+
+ Introduction
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Basics" href="../../language/basics/">
+
+ Basics
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Packages" href="../../language/packages/">
+
+ Packages
+</a>
+
+
+
+
+
+
+
+
+
+<a class="current" title="System Setup" href="../../language/setup/">
+
+ System Setup
+</a>
+
+
+<ul id="scrollspy">
+</ul>
+
+
+
+
+
+
+
+
+<a title="Types" href="../../language/types/">
+
+ Types
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Arrays" href="../../language/arrays/">
+
+ Arrays
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Functions" href="../../language/functions/">
+
+ Functions
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Foreign Function Interface" href="../../language/foreignfunctioninterface/">
+
+ Foreign Function Interface
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Events" href="../../language/events/">
+
+ Events
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Exceptions" href="../../language/exceptions/">
+
+ Exceptions
+</a>
+
+
+
+
+ </ul>
+
+</li>
+
+
+
+<li>
+
+ <span class="section">Platforms</span>
+ <ul>
+
+
+
+
+
+
+<a title="XDK110" href="../../platforms/xdk110/">
+
+ XDK110
+</a>
+
+
+
+
+ </ul>
+
+</li>
+
+
+ </ul>
+
+
+
+ </div>
+ </div>
+ </div>
+</nav>
+
+ </div>
+
+ <article class="article">
+ <div class="wrapper">
+ <h1>System Setup </h1>
+
+
+
+<p>System resources have properties which we can configure.
+For example, an accelerometer has an acceleration range, a filter bandwidth and some power modes which we can change.
+If we wanted to use Bluetooth for communication we would have to set up the GATT characteristics, device name and advertising interval.
+If we wanted to connect to a WLAN network, we would have to configure the network name and a preshared key.</p>
+
+<h2 id="system-resource-instantiability">System Resource Instantiability</h2>
+
+<p>Some system resources (e.g. an HTTP client) can even be used multiple times, others can exist exactly once.
+If you try and set up a system resource multiple times, and the resource can only be setup once, the compiler will tell you.
+Let’s look at the three different types of <em>instantiability</em> that exist in Mita.</p>
+
+<h3 id="multiple">Multiple</h3>
+
+<p>Software system resources (e.g. application level protocol implementations - think HTTP or MQTT) can exist multiple times,
+thus you can <em>instantiate</em> them multiple times using the <code>setup</code> keyword. Let’s look at an HTTP client:</p>
+<div class="highlight"><pre class="chroma"><code class="language-TypeScript" data-lang="TypeScript"><span class="kr">package</span> <span class="nx">main</span><span class="p">;</span>
+<span class="kr">import</span> <span class="nx">platforms</span><span class="p">.</span><span class="nx">xdk110</span><span class="p">;</span>
+
+<span class="nx">setup</span> <span class="nx">sensorBackend</span> : <span class="kt">HttpRestClient</span> <span class="p">{</span>
+ <span class="p">...</span>
+<span class="p">}</span>
+
+<span class="nx">setup</span> <span class="nx">controlService</span> : <span class="kt">HttpRestClient</span> <span class="p">{</span>
+ <span class="p">...</span>
+<span class="p">}</span></code></pre></div>
+<p>The <code>HttpRestClient</code> can exist multiple times.
+To identify the instance of the system resource we want to use, we have to name that instance (here, <code>sensorBackend</code> and <code>controlService</code>).
+We will see in a moment what would be inside the setup blocks.</p>
+
+<h3 id="once">Once</h3>
+
+<p>Other system resources can only be set up once, but we want to give them a name so that we can refer to them later on.
+Connectivity is a prime example:</p>
+<div class="highlight"><pre class="chroma"><code class="language-TypeScript" data-lang="TypeScript"><span class="kr">package</span> <span class="nx">main</span><span class="p">;</span>
+<span class="kr">import</span> <span class="nx">platforms</span><span class="p">.</span><span class="nx">xdk110</span><span class="p">;</span>
+
+<span class="nx">setup</span> <span class="nx">devnet</span> : <span class="kt">WLAN</span> <span class="p">{</span>
+ <span class="p">...</span>
+<span class="p">}</span>
+
+<span class="nx">setup</span> <span class="nx">sensorBackend</span> : <span class="kt">HttpRestClient</span> <span class="p">{</span>
+ <span class="nx">transport</span> <span class="o">=</span> <span class="nx">devnet</span><span class="p">;</span>
+<span class="p">}</span></code></pre></div>
+<p>Here we configure the WLAN connectivity, and use it for HTTP client. For that to work we had to name the WLAN (<code>devnet</code> in this case).
+However, if we were to add a second WLAN setup block (e.g. <code>setup production : WLAN { }</code> the compiler would produce an error, as there can be only one WLAN configuration (there is only one WLAN chip on the device).</p>
+
+<h3 id="none">None</h3>
+
+<p>Uninstantiable system resources are things built into the platform which we can only configure, but we cannot name them.
+A typical example would be sensors. They are described by the platform, they can be configured, but renaming them does not make sense.
+For example:</p>
+<div class="highlight"><pre class="chroma"><code class="language-TypeScript" data-lang="TypeScript"><span class="kr">package</span> <span class="nx">main</span><span class="p">;</span>
+<span class="kr">import</span> <span class="nx">platforms</span><span class="p">.</span><span class="nx">xdk110</span><span class="p">;</span>
+
+<span class="nx">setup</span> <span class="nx">accelerometer</span> <span class="p">{</span>
+
+<span class="p">}</span></code></pre></div>
+<h2 id="configuration-items">Configuration Items</h2>
+
+<p>System resources can have properties which change their behavior and generally configure how they work.
+In Mita those things are called <em>configuration items</em>.
+Configuration items are defined by the platform and are there for you, the developer, to fill in if you need to.
+For example, a light sensor needs some time to “collect light”, i.e. to measure the current light intensity.
+In Mita that time becomes configurable through a <em>configuration item</em>:</p>
+<div class="highlight"><pre class="chroma"><code class="language-TypeScript" data-lang="TypeScript"><span class="kr">package</span> <span class="nx">main</span><span class="p">;</span>
+<span class="kr">import</span> <span class="nx">platforms</span><span class="p">.</span><span class="nx">xdk110</span><span class="p">;</span>
+
+<span class="nx">setup</span> <span class="nx">light</span> <span class="p">{</span>
+ <span class="nx">integration_time</span> <span class="o">=</span> <span class="nx">MS_12_5</span><span class="p">;</span>
+<span class="p">}</span></code></pre></div>
+<div class="admonition note">
+<p class="admonition-title">Use content assist to explore your options</p>
+<p>In every <code>setup</code> block you can always use content assist (<code>Ctrl + Space</code> on Windows and Linux, <code>Cmd + Space</code> on Mac) to explore what configuration items you have available.
+Don’t worry about using a “wrong value” either. Configuration items are strongly typed and the compiler is going to tell you if you request a configuration that doesn’t make sense.</p>
+</div>
+
+<h2 id="signal-instances">Signal Instances</h2>
+
+<p>Mita uses the concept of <a href="../../concepts/">signals and signal instances</a> to model input and output of the device.
+Each system resource defines which signals it has available, and what attributes those signals have.
+To learn which signals you can use, have a look at the platform reference or use auto-complete within the <code>setup</code> block.</p>
+<div class="highlight"><pre class="chroma"><code class="language-TypeScript" data-lang="TypeScript"><span class="kr">package</span> <span class="nx">main</span><span class="p">;</span>
+<span class="kr">import</span> <span class="nx">platforms</span><span class="p">.</span><span class="nx">xdk110</span><span class="p">;</span>
+
+<span class="nx">setup</span> <span class="nx">phone</span> : <span class="kt">BLE</span> <span class="p">{</span>
+ <span class="kd">var</span> <span class="nx">ping</span> <span class="o">=</span> <span class="nx">bool_characteristic</span><span class="p">(</span><span class="nx">UUID</span><span class="o">=</span><span class="mh">0xCAFE</span><span class="p">);</span>
+<span class="p">}</span></code></pre></div>
+<p>The example above configures the Bluetooth Low Energy (<code>BLE</code>) system resource available on the XDK. This system resource sports - amonst others - a <code>bool_characteristic</code> signal.
+We instantiate this signal and thereby create a BLE GATT characteristic with the <em>UUID</em> ending in <code>0xCAFE</code>. So that we can reference this <em>signal instance</em> in our code, we give it the name <code>ping</code>.</p>
+
+<p>In our code we can use the signal instances to read and write from them (which in the example would send a Bluetooth notification):</p>
+<div class="highlight"><pre class="chroma"><code class="language-TypeScript" data-lang="TypeScript"><span class="nx">every</span> <span class="mi">1</span> <span class="nx">second</span> <span class="p">{</span>
+ <span class="nx">phone</span><span class="p">.</span><span class="nx">ping</span><span class="p">.</span><span class="nx">write</span><span class="p">(</span><span class="kc">true</span><span class="p">);</span>
+<span class="p">}</span></code></pre></div>
+
+ <aside class="copyright" role="note">
+
+ © 2018 The Eclipse Mita Project –
+
+ Documentation built with
+ <a href="https://www.gohugo.io" target="_blank">Hugo</a>
+ using the
+ <a href="http://github.com/digitalcraftsman/hugo-material-docs" target="_blank">Material</a> theme.
+ </aside>
+
+ <footer class="footer">
+
+
+<nav class="pagination" aria-label="Footer">
+ <div class="previous">
+
+ <a href="../../language/packages/" title="Packages">
+ <span class="direction">
+ Previous
+ </span>
+ <div class="page">
+ <div class="button button-previous" role="button" aria-label="Previous">
+ <i class="icon icon-back"></i>
+ </div>
+ <div class="stretch">
+ <div class="title">
+ Packages
+ </div>
+ </div>
+ </div>
+ </a>
+
+ </div>
+
+ <div class="next">
+
+ <a href="../../faq/" title="Frequently Asked Questions">
+ <span class="direction">
+ Next
+ </span>
+ <div class="page">
+ <div class="stretch">
+ <div class="title">
+ Frequently Asked Questions
+ </div>
+ </div>
+ <div class="button button-next" role="button" aria-label="Next">
+ <i class="icon icon-forward"></i>
+ </div>
+ </div>
+ </a>
+
+ </div>
+</nav>
+
+
+
+
+
+ </footer>
+ </div>
+ </article>
+
+ <div class="results" role="status" aria-live="polite">
+ <div class="scrollable">
+ <div class="wrapper">
+ <div class="meta"></div>
+ <div class="list"></div>
+ </div>
+ </div>
+ </div>
+</main>
+
+ <script>
+
+ var base_url = '';
+ var repo_id = '';
+
+ </script>
+
+ <script src="../../javascripts/application.js"></script>
+
+
+ <script>
+ /* Add headers to scrollspy */
+ var headers = document.getElementsByTagName("h2");
+ var scrollspy = document.getElementById('scrollspy');
+
+ if(scrollspy) {
+ if(headers.length > 0) {
+ for(var i = 0; i < headers.length; i++) {
+ var li = document.createElement("li");
+ li.setAttribute("class", "anchor");
+
+ var a = document.createElement("a");
+ a.setAttribute("href", "#" + headers[i].id);
+ a.setAttribute("title", headers[i].innerHTML);
+ a.innerHTML = headers[i].innerHTML;
+
+ li.appendChild(a)
+ scrollspy.appendChild(li);
+ }
+ } else {
+ scrollspy.parentElement.removeChild(scrollspy)
+ }
+
+
+ /* Add permanent link next to the headers */
+ var headers = document.querySelectorAll("h1, h2, h3, h4, h5, h6");
+
+ for(var i = 0; i < headers.length; i++) {
+ var a = document.createElement("a");
+ a.setAttribute("class", "headerlink");
+ a.setAttribute("href", "#" + headers[i].id);
+ a.setAttribute("title", "Permanent link")
+ a.innerHTML = "#";
+ headers[i].appendChild(a);
+ }
+ }
+ </script>
+
+
+
+ <script src="//cdnjs.cloudflare.com/ajax/libs/highlight.js/9.8.0/highlight.min.js"></script>
+ <script>hljs.initHighlightingOnLoad();</script>
+ </body>
+</html>
+
diff --git a/language/types/index.html b/language/types/index.html
new file mode 100644
index 0000000..75de4e1
--- /dev/null
+++ b/language/types/index.html
@@ -0,0 +1,786 @@
+<!DOCTYPE html>
+
+
+
+
+ <html class="no-js">
+
+ <head lang="en-us">
+ <meta charset="utf-8">
+ <meta name="viewport" content="width=device-width,user-scalable=no,initial-scale=1,maximum-scale=1">
+ <meta http-equiv="X-UA-Compatible" content="IE=10" />
+ <title>Types - Eclipse Mita</title>
+ <meta name="generator" content="Hugo 0.42.1" />
+
+
+ <meta name="description" content="The documentation of Eclipse Mita.">
+
+ <link rel="canonical" href="../../language/types/">
+
+
+ <meta property="og:url" content="/language/types/">
+ <meta property="og:title" content="Eclipse Mita">
+ <meta property="og:image" content="/images/mita.svg">
+ <meta name="apple-mobile-web-app-title" content="Eclipse Mita">
+ <meta name="apple-mobile-web-app-capable" content="yes">
+ <meta name="apple-mobile-web-app-status-bar-style" content="black-translucent">
+
+ <link rel="shortcut icon" type="image/x-icon" href="../../images/favicon.ico">
+ <link rel="icon" type="image/x-icon" href="../../images/favicon.ico">
+
+ <style>
+ @font-face {
+ font-family: 'Icon';
+ src: url('/fonts/icon.eot');
+ src: url('/fonts/icon.eot')
+ format('embedded-opentype'),
+ url('/fonts/icon.woff')
+ format('woff'),
+ url('/fonts/icon.ttf')
+ format('truetype'),
+ url('/fonts/icon.svg')
+ format('svg');
+ font-weight: normal;
+ font-style: normal;
+ }
+ </style>
+
+ <link rel="stylesheet" href="../../stylesheets/application.css">
+ <link rel="stylesheet" href="../../stylesheets/temporary.css">
+ <link rel="stylesheet" href="../../stylesheets/palettes.css">
+ <link rel="stylesheet" href="../../stylesheets/highlight/highlight.css">
+
+
+
+
+ <link rel="stylesheet" href="//fonts.googleapis.com/css?family=Ubuntu:400,700|Ubuntu+Mono">
+ <style>
+ body, input {
+ font-family: 'Ubuntu', Helvetica, Arial, sans-serif;
+ }
+ pre, code {
+ font-family: 'Ubuntu Mono', 'Courier New', 'Courier', monospace;
+ }
+ </style>
+
+
+ <link rel="stylesheet" href="../../css/custom.css">
+
+ <script src="../../javascripts/modernizr.js"></script>
+
+
+
+ </head>
+ <body class="palette-primary-blue-grey palette-accent-light-blue">
+
+
+
+
+<div class="backdrop">
+ <div class="backdrop-paper"></div>
+</div>
+
+<input class="toggle" type="checkbox" id="toggle-drawer">
+<input class="toggle" type="checkbox" id="toggle-search">
+<label class="toggle-button overlay" for="toggle-drawer"></label>
+
+<header class="header">
+ <nav aria-label="Header">
+ <div class="bar default">
+ <div class="button button-menu" role="button" aria-label="Menu">
+ <label class="toggle-button icon icon-menu" for="toggle-drawer">
+ <span></span>
+ </label>
+ </div>
+ <div class="stretch">
+ <div class="title">
+ Types
+ </div>
+ </div>
+
+
+ <div class="button button-twitter" role="button" aria-label="Twitter">
+ <a href="https://twitter.com/eclipse_mita" title="@eclipse_mita on Twitter" target="_blank" class="toggle-button icon icon-twitter"></a>
+ </div>
+
+
+
+ <div class="button button-github" role="button" aria-label="GitHub">
+ <a href="https://github.com/eclipse/mita" title="@eclipse/mita on GitHub" target="_blank" class="toggle-button icon icon-github"></a>
+ </div>
+
+
+
+ </div>
+ <div class="bar search">
+ <div class="button button-close" role="button" aria-label="Close">
+ <label class="toggle-button icon icon-back" for="toggle-search"></label>
+ </div>
+ <div class="stretch">
+ <div class="field">
+ <input class="query" type="text" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck>
+ </div>
+ </div>
+ <div class="button button-reset" role="button" aria-label="Search">
+ <button class="toggle-button icon icon-close" id="reset-search"></button>
+ </div>
+ </div>
+</nav>
+</header>
+
+<main class="main">
+ <div class="drawer">
+ <nav aria-label="Navigation">
+ <a href="../../" class="project">
+ <div class="banner">
+
+ <div class="logo">
+ <img src="../../images/mita.svg">
+ </div>
+
+ <div class="name">
+ <strong>Eclipse Mita </strong>
+
+ </div>
+ </div>
+ </a>
+
+ <div class="scrollable">
+ <div class="wrapper">
+
+
+ <div class="toc">
+
+ <ul>
+
+
+
+
+
+<li>
+
+
+
+
+
+<a title="Download" href="http://github.com/eclipse/mita">
+
+ Download
+</a>
+
+
+
+
+</li>
+
+
+
+<li>
+
+
+
+
+
+<a title="Concepts" href="../../concepts/">
+
+ Concepts
+</a>
+
+
+
+
+</li>
+
+
+
+<li>
+
+ <span class="section">Language</span>
+ <ul>
+
+
+
+
+
+
+<a title="Introduction" href="../../language/introduction/">
+
+ Introduction
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Basics" href="../../language/basics/">
+
+ Basics
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Packages" href="../../language/packages/">
+
+ Packages
+</a>
+
+
+
+
+
+
+
+
+
+<a title="System Setup" href="../../language/setup/">
+
+ System Setup
+</a>
+
+
+
+
+
+
+
+
+
+<a class="current" title="Types" href="../../language/types/">
+
+ Types
+</a>
+
+
+<ul id="scrollspy">
+</ul>
+
+
+
+
+
+
+
+
+<a title="Arrays" href="../../language/arrays/">
+
+ Arrays
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Functions" href="../../language/functions/">
+
+ Functions
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Foreign Function Interface" href="../../language/foreignfunctioninterface/">
+
+ Foreign Function Interface
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Events" href="../../language/events/">
+
+ Events
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Exceptions" href="../../language/exceptions/">
+
+ Exceptions
+</a>
+
+
+
+
+ </ul>
+
+</li>
+
+
+
+<li>
+
+ <span class="section">Platforms</span>
+ <ul>
+
+
+
+
+
+
+<a title="XDK110" href="../../platforms/xdk110/">
+
+ XDK110
+</a>
+
+
+
+
+ </ul>
+
+</li>
+
+
+ </ul>
+
+
+
+ </div>
+ </div>
+ </div>
+</nav>
+
+ </div>
+
+ <article class="article">
+ <div class="wrapper">
+ <h1>Types </h1>
+
+
+
+<h2 id="primitive-types">Primitive Types</h2>
+
+<p>We have already seen the <a href="../../language/basics/#primitive-data-types">basic data types</a> supported by Mita.
+Primitive types are also called <em>scalar types</em> in other languages, as they contain a single value.
+Complex types on the other hand represent more than a single value, or are defined by the programmer.
+There is one type where that distinction is not as clear as it may sound: strings.</p>
+
+<h2 id="strings">Strings</h2>
+
+<p>In C there are no strings, but only arrays of characters and some conventions.
+There, strings are really non-scalar values as they consist of a list of individual bytes.
+You as a programmer will have to tell the compiler how much space you would like to reserve for your string.</p>
+
+<p>This is not how we think of strings nowadays.
+In Mita strings are first-class citizens, meaning that they feel like strings on other languages.
+You can simply initialize a variable with them, append them, pass them to a function and return them from one.
+Behind the scenes we use <a href="../../concepts/#element-size-inference">element size inference</a> to try and compute the worst-case length of a string at compile time and allocate enough space.</p>
+<div class="highlight"><pre class="chroma"><code class="language-TypeScript" data-lang="TypeScript"><span class="nx">fn</span> <span class="nx">stringDemo() {</span>
+ <span class="kd">var</span> <span class="nx">msg</span> <span class="o">=</span> <span class="s2">"Hello "</span><span class="p">;</span>
+ <span class="nx">msg</span> <span class="o">+=</span> <span class="s2">"World"</span><span class="p">;</span>
+
+ <span class="nx">println</span><span class="p">(</span><span class="nx">msg</span><span class="p">);</span>
+<span class="p">}</span></code></pre></div>
+<p>There are cases where we cannot infer the length of a string, for example when it’s modified within a loop.
+In such cases you will have to explicitly tell us how long your string can be in the worst-case:</p>
+<div class="highlight"><pre class="chroma"><code class="language-TypeScript" data-lang="TypeScript"><span class="kd">var</span> <span class="nx">msg</span> <span class="o">=</span> <span class="k">new</span> <span class="kt">string</span><span class="p">(</span><span class="mi">100</span><span class="p">);</span>
+<span class="k">for</span><span class="p">(</span><span class="kd">var</span> <span class="nx">i</span> <span class="o">=</span> <span class="mi">0</span><span class="p">;</span> <span class="nx">i</span> <span class="o"><</span> <span class="mi">5</span><span class="p">;</span> <span class="nx">i</span><span class="o">++</span><span class="p">)</span> <span class="p">{</span>
+ <span class="nx">msg</span> <span class="o">+=</span> <span class="sb">`</span><span class="si">${</span><span class="nx">i</span><span class="si">}</span><span class="sb"> `</span><span class="p">;</span>
+<span class="p">}</span>
+<span class="nx">println</span><span class="p">(</span><span class="nx">msg</span><span class="p">);</span></code></pre></div>
+<h2 id="enumerations">Enumerations</h2>
+
+<p>Enumerations are categorical values that we as programmers can define.
+An enumeration type groups a set of such categorical values.
+For example, if we wanted to describe a list of colors, we could define a color enumeration:</p>
+<div class="highlight"><pre class="chroma"><code class="language-TypeScript" data-lang="TypeScript"><span class="kr">enum</span> <span class="nx">Color</span> <span class="p">{</span>
+ <span class="nx">Red</span><span class="p">,</span>
+ <span class="nx">Green</span><span class="p">,</span>
+ <span class="nx">Blue</span>
+<span class="p">}</span></code></pre></div>
+<p>Compared to using integers for categorical values, enumerations provide type safety and a fixed set of values.
+Unlike C, however, integers and enumerations are not interchangeable in Mita.
+This is on purpose, as the loose interchangeability encourages bad coding style.</p>
+<div class="highlight"><pre class="chroma"><code class="language-TypeScript" data-lang="TypeScript"><span class="nx">Foo</span><span class="p">.</span><span class="nx">Bar</span> <span class="kr">as</span> <span class="nx">uint8</span> <span class="cm">/* compiler error: Types Foo and uint8_t are not compatible. */</span></code></pre></div>
+<h2 id="structures">Structures</h2>
+
+<p>Structures are custom, user-defined types for organizing data. Every structure member needs to be annotated with a type.</p>
+<div class="highlight"><pre class="chroma"><code class="language-TypeScript" data-lang="TypeScript"><span class="nx">struct</span> <span class="nx">Foo</span> <span class="p">{</span>
+ <span class="kd">var</span> <span class="nx">bar</span> : <span class="kt">uint32</span><span class="p">;</span>
+ <span class="kd">var</span> <span class="nx">foo</span> : <span class="kt">bool</span><span class="p">;</span>
+ <span class="kd">var</span> <span class="nx">baz</span><span class="p">;</span> <span class="cm">/* syntax error: Expected : not ; */</span>
+<span class="p">}</span></code></pre></div>
+<p>You can create structures by just calling them like a function with all of their members as parameters. Accessing structure members works the same as in other languages.</p>
+<div class="highlight"><pre class="chroma"><code class="language-TypeScript" data-lang="TypeScript"><span class="nx">struct</span> <span class="nx">vec2d</span> <span class="p">{</span>
+ <span class="kd">var</span> <span class="nx">x</span>: <span class="kt">int32</span><span class="p">;</span>
+ <span class="kd">var</span> <span class="nx">y</span>: <span class="kt">int32</span><span class="p">;</span>
+<span class="p">}</span>
+
+<span class="nx">fn</span> <span class="nx">incVec2d</span><span class="p">(</span><span class="nx">v</span>: <span class="kt">vec2d</span><span class="p">)</span> <span class="p">{</span>
+ <span class="kd">var</span> <span class="nx">w</span>: <span class="kt">vec2d</span><span class="p">;</span> <span class="cm">/* By default, all structure members are initialized with 0 */</span>
+ <span class="kd">var</span> <span class="nx">x</span> <span class="o">=</span> <span class="nx">v</span><span class="p">.</span><span class="nx">x</span><span class="p">;</span>
+ <span class="kd">var</span> <span class="nx">y</span> <span class="o">=</span> <span class="nx">v</span><span class="p">.</span><span class="nx">y</span><span class="p">;</span>
+ <span class="nx">w</span> <span class="o">=</span> <span class="nx">vec2d</span><span class="p">(</span><span class="nx">x</span> <span class="o">+</span> <span class="mi">1</span><span class="p">,</span> <span class="nx">y</span> <span class="o">+</span> <span class="mi">1</span><span class="p">);</span>
+ <span class="cm">/* as with other functions, you can provide arguments by name */</span>
+ <span class="nx">w</span> <span class="o">=</span> <span class="nx">vec2d</span><span class="p">(</span><span class="nx">x</span> <span class="o">=</span> <span class="nx">v</span><span class="p">.</span><span class="nx">x</span> <span class="o">+</span> <span class="mi">1</span><span class="p">,</span>
+ <span class="nx">y</span> <span class="o">=</span> <span class="nx">v</span><span class="p">.</span><span class="nx">y</span> <span class="o">+</span> <span class="mi">1</span><span class="p">);</span>
+ <span class="k">return</span> <span class="nx">w</span><span class="p">;</span>
+<span class="p">}</span></code></pre></div>
+<h2 id="sum-types">Sum Types</h2>
+
+<p>A generalization of enumerations and structures are <a href="https://en.wikipedia.org/wiki/Algebraic_data_type">sum types</a>. You might also know them by the name “tagged union” or “variadic type”.</p>
+
+<p>Lets say you want to write a function <code>deviceState</code> that tells you in which state your device is. It tells you whether it is standing still, moving or has detected a shock. Furthermore, some of these states should contain some more information:</p>
+
+<ul>
+<li>While moving you want to know in which directions you are accelerating</li>
+<li>When you detect a shock you also want to store how strong the shock was</li>
+<li>No further information is stored when standing still</li>
+</ul>
+
+<p>Sum types can exactly model this kind of information. In Mita you write the following:</p>
+<div class="highlight"><pre class="chroma"><code class="language-TypeScript" data-lang="TypeScript"><span class="nx">alt</span> <span class="nx">DeviceState</span> <span class="p">{</span>
+ <span class="nx">NoMotion</span>
+ <span class="o">|</span> <span class="nx">Movement</span><span class="o">:</span> <span class="p">{</span><span class="nx">accelerationX</span> : <span class="kt">int32</span><span class="p">,</span> <span class="nx">accelerationY</span> : <span class="kt">int32</span><span class="p">,</span> <span class="nx">accelerationZ</span> : <span class="kt">int32</span><span class="p">}</span>
+ <span class="o">|</span> <span class="nx">Shock</span>: <span class="kt">uint32</span>
+<span class="p">}</span></code></pre></div>
+<p>This declares a type <code>DeviceState</code> with three different constructors:</p>
+
+<ul>
+<li><code>DeviceState.NoMotion</code>, which takes no arguments</li>
+<li><code>DeviceState.Movement</code>, which has three named arguments, one for each axis</li>
+<li><code>DeviceState.Shock</code>, which has one named argument: the amplitude of the shock</li>
+</ul>
+
+<p>So your function <code>deviceState</code> looks like this:</p>
+<div class="highlight"><pre class="chroma"><code class="language-TypeScript" data-lang="TypeScript"><span class="nx">fn</span> <span class="nx">deviceState</span><span class="p">()</span> <span class="o">:</span> <span class="nx">DeviceState</span> <span class="p">{</span>
+ <span class="kd">var</span> <span class="nx">state</span> : <span class="kt">DeviceState</span><span class="p">;</span>
+
+ <span class="cm">/* detect shock or movement */</span>
+
+ <span class="k">if</span><span class="p">(</span><span class="nx">shockDetected</span><span class="p">)</span> <span class="p">{</span>
+ <span class="nx">state</span> <span class="o">=</span> <span class="nx">DeviceState</span><span class="p">.</span><span class="nx">Shock</span><span class="p">(</span><span class="nx">accelerometer</span><span class="p">.</span><span class="nx">magnitude</span><span class="p">.</span><span class="nx">read</span><span class="p">());</span>
+ <span class="p">}</span> <span class="k">else</span> <span class="k">if</span><span class="p">(</span><span class="nx">isMoving</span><span class="p">)</span> <span class="p">{</span>
+ <span class="nx">state</span> <span class="o">=</span> <span class="nx">DeviceState</span><span class="p">.</span><span class="nx">Movement</span><span class="p">(</span>
+ <span class="nx">accelerationX</span> <span class="o">=</span> <span class="nx">accelerometer</span><span class="p">.</span><span class="nx">x_axis</span><span class="p">.</span><span class="nx">read</span><span class="p">(),</span>
+ <span class="nx">accelerationY</span> <span class="o">=</span> <span class="nx">accelerometer</span><span class="p">.</span><span class="nx">y_axis</span><span class="p">.</span><span class="nx">read</span><span class="p">(),</span>
+ <span class="nx">accelerationZ</span> <span class="o">=</span> <span class="nx">accelerometer</span><span class="p">.</span><span class="nx">z_axis</span><span class="p">.</span><span class="nx">read</span><span class="p">());</span>
+ <span class="p">}</span> <span class="k">else</span> <span class="p">{</span>
+ <span class="nx">state</span> <span class="o">=</span> <span class="nx">DeviceState</span><span class="p">.</span><span class="nx">NoMotion</span><span class="p">();</span>
+ <span class="p">}</span>
+ <span class="k">return</span> <span class="nx">state</span><span class="p">;</span>
+<span class="p">}</span></code></pre></div>
+<p>Next, you need to access information stored in a sum type somehow. For this, Mita offers a construct similar to switch-cases you might know from other languages. There are two things you can do with a sum type:</p>
+
+<ul>
+<li>You can find out which alternative constructor you got</li>
+<li>You can find out what information is stored in it</li>
+</ul>
+
+<p>The first thing is just what enums do and looks like this:</p>
+
+<pre><code>var state : DeviceState = deviceState();
+
+where(state) {
+ is(DeviceState.NoMotion) {
+ println("Standing still.");
+ }
+ is(DeviceState.Movement) {
+ println("Device in motion.");
+ }
+ is(DeviceState.Shock) {
+ println("Shock detected!");
+ }
+}
+</code></pre>
+
+<p>To access data that comes with an alternative (e.g. <code>accelerationX</code> in <code>DeviceState.Movement</code>), you need to bind that data to variables:</p>
+
+<pre><code>var state : DeviceState = deviceState();
+
+where(state) {
+ is(DeviceState.NoMotion) {
+ println("Standing still.");
+ }
+ is(DeviceState.Movement -> x, y, z) {
+ println(`Device in motion: ${x} | ${y} | ${z}.`);
+ }
+ is(DeviceState.Shock -> intensity) {
+ println(`Shock detected: ${intensity}!`);
+ }
+}
+</code></pre>
+
+<p>You can reuse existing structures directly if they are the only value in one alternative. This makes your code more reusable. For example, instead of defining <code>DeviceState.Movement</code> with three parameters, you can reuse an existing struct <code>vec3d_t</code>:</p>
+<div class="highlight"><pre class="chroma"><code class="language-TypeScript" data-lang="TypeScript"><span class="nx">struct</span> <span class="nx">vec3d_t</span> <span class="p">{</span>
+ <span class="kd">var</span> <span class="nx">x</span> : <span class="kt">int32</span><span class="p">;</span>
+ <span class="kd">var</span> <span class="nx">y</span> : <span class="kt">int32</span><span class="p">;</span>
+ <span class="kd">var</span> <span class="nx">z</span> : <span class="kt">int32</span><span class="p">;</span>
+<span class="p">}</span>
+
+<span class="nx">alt</span> <span class="nx">DeviceState</span> <span class="p">{</span>
+ <span class="nx">NoMotion</span>
+ <span class="o">|</span> <span class="nx">Movement</span>: <span class="kt">vec3d_t</span>
+ <span class="o">|</span> <span class="nx">Shock</span>: <span class="kt">uint32</span>
+<span class="p">}</span></code></pre></div>
+<p>The code for <code>deviceState</code> changes slightly, since <code>vec3d_t</code>’s members have different names now. Constructing a <code>DeviceState.Movement</code> therefore looks like this:</p>
+<div class="highlight"><pre class="chroma"><code class="language-TypeScript" data-lang="TypeScript"><span class="nx">state</span> <span class="o">=</span> <span class="nx">DeviceState</span><span class="p">.</span><span class="nx">Movement</span><span class="p">(</span>
+ <span class="nx">x</span> <span class="o">=</span> <span class="nx">accelerometer</span><span class="p">.</span><span class="nx">x_axis</span><span class="p">.</span><span class="nx">read</span><span class="p">(),</span>
+ <span class="nx">y</span> <span class="o">=</span> <span class="nx">accelerometer</span><span class="p">.</span><span class="nx">y_axis</span><span class="p">.</span><span class="nx">read</span><span class="p">(),</span>
+ <span class="nx">z</span> <span class="o">=</span> <span class="nx">accelerometer</span><span class="p">.</span><span class="nx">z_axis</span><span class="p">.</span><span class="nx">read</span><span class="p">());</span></code></pre></div>
+<p>However you don’t need to pass in a member of the struct at all; it is “imported” to
+<code>DeviceState.Movement</code>. Binding data contained in the alternative works just as before as well.</p>
+
+<p>Some more things you can do are:</p>
+
+<ul>
+<li>You can directly bind the whole element that was matched. This is especially useful for embedded types, since you get a variable of the embedded type instead of the sum type. The syntax for this is:</li>
+</ul>
+<div class="highlight"><pre class="chroma"><code class="language-TypeScript" data-lang="TypeScript"><span class="nx">is</span><span class="p">(</span><span class="nx">v</span> : <span class="kt">DeviceState.Movement</span><span class="p">)</span> <span class="p">{</span>
+ <span class="cm">/* v has type vec3d_t here */</span>
+<span class="p">}</span></code></pre></div>
+<ul>
+<li>You can bind using named parameters, e.g. the <code>DeviceState.Movement</code> above has the named parameters <code>accelerationX</code>, <code>accelerationY</code> and <code>accelerationZ</code>. This looks like this:</li>
+</ul>
+<div class="highlight"><pre class="chroma"><code class="language-TypeScript" data-lang="TypeScript"><span class="nx">is</span><span class="p">(</span><span class="nx">DeviceState</span><span class="p">.</span><span class="nx">Movement</span> <span class="o">-></span>
+ <span class="nx">x</span> <span class="o">=</span> <span class="nx">vec3d</span><span class="p">.</span><span class="nx">accelerationX</span><span class="p">,</span>
+ <span class="nx">z</span> <span class="o">=</span> <span class="nx">vec3d</span><span class="p">.</span><span class="nx">accelerationZ</span><span class="p">,</span>
+ <span class="nx">y</span> <span class="o">=</span> <span class="nx">vec3d</span><span class="p">.</span><span class="nx">accelerationY</span><span class="p">)</span> <span class="p">{</span>
+ <span class="cm">/* Use a, b and c here */</span>
+<span class="p">}</span></code></pre></div>
+<ul>
+<li>You can supply a default case with <code>isother { ... }</code>.</li>
+</ul>
+
+<p>Matching happens in the order you specify.</p>
+
+<p>Here you can see a comprehensive example using all the available syntax:</p>
+<div class="highlight"><pre class="chroma"><code class="language-TypeScript" data-lang="TypeScript"><span class="nx">struct</span> <span class="nx">vec2d_t</span> <span class="p">{</span>
+ <span class="kd">var</span> <span class="nx">x</span> : <span class="kt">int32</span><span class="p">;</span>
+ <span class="kd">var</span> <span class="nx">y</span> : <span class="kt">int32</span><span class="p">;</span>
+<span class="p">}</span>
+
+<span class="nx">alt</span> <span class="nx">anyVec</span> <span class="p">{</span>
+ <span class="nx">vec0d</span> <span class="cm">/* singleton, like an enumeration value */</span>
+ <span class="o">|</span> <span class="nx">vec1d</span> : <span class="kt">int32</span>
+ <span class="o">|</span> <span class="nx">vec2d</span> : <span class="kt">vec2d_t</span> <span class="cm">/* embedded structure */</span>
+ <span class="o">|</span> <span class="nx">vec3d</span> <span class="o">:</span> <span class="p">{</span><span class="nx">x</span>: <span class="kt">int32</span><span class="p">,</span> <span class="nx">y</span>: <span class="kt">int32</span><span class="p">,</span> <span class="nx">z</span>: <span class="kt">int32</span><span class="p">}</span> <span class="cm">/* named members */</span>
+ <span class="o">|</span> <span class="nx">vec4d</span> : <span class="kt">int32</span><span class="p">,</span> <span class="nx">int32</span><span class="p">,</span> <span class="nx">int32</span><span class="p">,</span> <span class="nx">int32</span> <span class="cm">/* anonymous members */</span>
+<span class="p">}</span>
+
+<span class="nx">exception</span> <span class="nx">UnknownTypeException</span><span class="p">;</span>
+
+<span class="nx">fn</span> <span class="nx">incVecs</span><span class="p">(</span><span class="nx">a</span>: <span class="kt">anyVec</span><span class="p">)</span> <span class="p">{</span>
+ <span class="kd">var</span> <span class="nx">b</span> : <span class="kt">anyVec</span><span class="p">;</span>
+ <span class="nx">where</span><span class="p">(</span><span class="nx">a</span><span class="p">)</span> <span class="p">{</span>
+ <span class="nx">is</span><span class="p">(</span><span class="nx">anyVec</span><span class="p">.</span><span class="nx">vec0d</span><span class="p">)</span> <span class="p">{</span>
+ <span class="nx">b</span> <span class="o">=</span> <span class="nx">anyVec</span><span class="p">.</span><span class="nx">vec0d</span><span class="p">();</span>
+ <span class="p">}</span>
+ <span class="nx">is</span><span class="p">(</span><span class="nx">anyVec</span><span class="p">.</span><span class="nx">vec1d</span> <span class="o">-></span> <span class="nx">x</span><span class="p">)</span> <span class="p">{</span>
+ <span class="nx">b</span> <span class="o">=</span> <span class="nx">anyVec</span><span class="p">.</span><span class="nx">vec1d</span><span class="p">(</span><span class="nx">x</span> <span class="o">+</span> <span class="mi">1</span><span class="p">);</span>
+ <span class="p">}</span>
+ <span class="nx">is</span><span class="p">(</span><span class="nx">v</span>: <span class="kt">anyVec.vec2d</span><span class="p">)</span> <span class="p">{</span>
+ <span class="cm">/* v is of type vec2d_t */</span>
+ <span class="nx">b</span> <span class="o">=</span> <span class="nx">anyVec</span><span class="p">.</span><span class="nx">vec2d</span><span class="p">(</span><span class="nx">v</span><span class="p">.</span><span class="nx">x</span> <span class="o">+</span> <span class="mi">1</span><span class="p">,</span> <span class="nx">v</span><span class="p">.</span><span class="nx">y</span> <span class="o">+</span> <span class="mi">1</span><span class="p">);</span>
+ <span class="p">}</span>
+ <span class="nx">is</span><span class="p">(</span><span class="nx">anyVec</span><span class="p">.</span><span class="nx">vec3d</span> <span class="o">-></span> <span class="nx">x</span> <span class="o">=</span> <span class="nx">vec3d</span><span class="p">.</span><span class="nx">x</span><span class="p">,</span> <span class="nx">y</span> <span class="o">=</span> <span class="nx">vec3d</span><span class="p">.</span><span class="nx">y</span><span class="p">,</span> <span class="nx">z</span> <span class="o">=</span> <span class="nx">vec3d</span><span class="p">.</span><span class="nx">z</span><span class="p">)</span> <span class="p">{</span>
+ <span class="nx">b</span> <span class="o">=</span> <span class="nx">anyVec</span><span class="p">.</span><span class="nx">vec3d</span><span class="p">(</span><span class="nx">x</span> <span class="o">+</span> <span class="mi">1</span><span class="p">,</span> <span class="nx">y</span> <span class="o">+</span> <span class="mi">1</span><span class="p">,</span> <span class="nx">z</span> <span class="o">+</span> <span class="mi">1</span><span class="p">);</span>
+ <span class="p">}</span>
+ <span class="nx">is</span><span class="p">(</span><span class="nx">anyVec</span><span class="p">.</span><span class="nx">vec4d</span> <span class="o">-></span> <span class="nx">x</span><span class="p">,</span> <span class="nx">y</span><span class="p">,</span> <span class="nx">z</span><span class="p">,</span> <span class="nx">w</span><span class="p">)</span> <span class="p">{</span>
+ <span class="nx">b</span> <span class="o">=</span> <span class="nx">anyVec</span><span class="p">.</span><span class="nx">vec4d</span><span class="p">(</span><span class="nx">x</span> <span class="o">+</span> <span class="mi">1</span><span class="p">,</span> <span class="nx">y</span> <span class="o">+</span> <span class="mi">1</span><span class="p">,</span> <span class="nx">z</span> <span class="o">+</span> <span class="mi">1</span><span class="p">,</span> <span class="nx">w</span> <span class="o">+</span> <span class="mi">1</span><span class="p">);</span>
+ <span class="p">}</span>
+ <span class="cm">/* you can specify a default case */</span>
+ <span class="nx">isother</span> <span class="p">{</span>
+ <span class="k">throw</span> <span class="nx">UnknownTypeException</span><span class="p">;</span>
+ <span class="p">}</span>
+ <span class="p">}</span>
+ <span class="k">return</span> <span class="nx">b</span><span class="p">;</span>
+<span class="p">}</span></code></pre></div>
+<h2 id="optionals">Optionals</h2>
+
+<p>All types can be made optional using the <code>?</code> operator:</p>
+<div class="highlight"><pre class="chroma"><code class="language-TypeScript" data-lang="TypeScript"><span class="kd">let</span> <span class="nx">intOpt</span> : <span class="kt">uint32?</span><span class="p">;</span>
+<span class="nx">struct</span> <span class="nx">strct</span> <span class="p">{</span>
+ <span class="kd">var</span> <span class="nx">x</span> : <span class="kt">uint32</span><span class="p">;</span>
+<span class="p">}</span>
+<span class="kd">let</span> <span class="nx">structOpt</span> : <span class="kt">strct?</span><span class="p">;</span></code></pre></div>
+<p>Initializing can be done either by implicit upcasting in most cases, or by explicit construction using <code>some</code> and <code>none</code>:</p>
+<div class="highlight"><pre class="chroma"><code class="language-TypeScript" data-lang="TypeScript"><span class="kd">let</span> <span class="nx">x</span> : <span class="kt">uint32?</span> <span class="o">=</span> <span class="mi">1</span><span class="p">;</span>
+<span class="kd">let</span> <span class="nx">y</span> <span class="o">=</span> <span class="nx">some</span><span class="p">(</span><span class="mi">2</span><span class="p">);</span>
+<span class="kd">let</span> <span class="nx">z</span> : <span class="kt">int32?</span> <span class="o">=</span> <span class="nx">none</span><span class="p">();</span></code></pre></div>
+<p>To check if an optional contains a value you use the function <code>hasValue</code>. If an optional has a value you can get it with the function <code>value</code>:</p>
+<div class="highlight"><pre class="chroma"><code class="language-TypeScript" data-lang="TypeScript"><span class="kd">let</span> <span class="nx">foo</span> : <span class="kt">uint32?</span> <span class="o">=</span> <span class="mi">42</span><span class="p">;</span>
+<span class="k">if</span><span class="p">(</span><span class="nx">foo</span><span class="p">.</span><span class="nx">hasValue</span><span class="p">())</span> <span class="p">{</span>
+ <span class="nx">println</span><span class="p">(</span><span class="sb">`foo has value </span><span class="si">${</span><span class="nx">foo</span><span class="p">.</span><span class="nx">value</span><span class="p">()</span><span class="si">}</span><span class="sb">`</span><span class="p">);</span>
+<span class="p">}</span></code></pre></div>
+<h2 id="references">References</h2>
+
+<p>Since all assignment semantics are copy by value you need a way to specify you want to have another reference to some object. For this you can use references. Unlike C pointers, references may never refer to nothing. To emphasize this, their type is annotated with an ampersand <code>&</code> instead of an asterix <code>*</code>:</p>
+<div class="highlight"><pre class="chroma"><code class="language-TypeScript" data-lang="TypeScript"><span class="kd">var</span> <span class="nx">someInt</span> : <span class="kt">int32</span> <span class="o">=</span> <span class="mi">10</span><span class="p">;</span>
+<span class="kd">var</span> <span class="nx">refToSomeInt</span> <span class="o">:</span> <span class="o">&</span><span class="nx">int32</span> <span class="o">=</span> <span class="o">&</span><span class="nx">someInt</span><span class="p">;</span>
+<span class="o">*</span><span class="nx">refToSomeInt</span> <span class="o">=</span> <span class="mi">1</span><span class="p">;</span></code></pre></div>
+<p>You can reference references as well. However, you need to store every intermediate reference explicitly.</p>
+<div class="highlight"><pre class="chroma"><code class="language-TypeScript" data-lang="TypeScript"><span class="kd">var</span> <span class="nx">someInt</span> : <span class="kt">int32</span> <span class="o">=</span> <span class="mi">10</span><span class="p">;</span>
+<span class="kd">var</span> <span class="nx">refToSomeInt</span> <span class="o">:</span> <span class="o">&</span><span class="nx">int32</span> <span class="o">=</span> <span class="o">&</span><span class="nx">someInt</span><span class="p">;</span>
+<span class="kd">var</span> <span class="nx">doubleRef</span> <span class="o">:</span> <span class="o">&&</span><span class="nx">int32</span> <span class="o">=</span> <span class="o">&</span><span class="nx">refToSomeInt</span><span class="p">;</span>
+<span class="o">**</span><span class="nx">doubleRef</span> <span class="o">=</span> <span class="mi">1</span><span class="p">;</span></code></pre></div>
+<p>Since our language is heapless, there are some restrictions on how you can modify and pass references. The compiler forbids you from using them in some way that might lead to accessing invalid memory. These rules are as follows:</p>
+
+<ul>
+<li>You can always read contents of references</li>
+<li>You can never return references or anything that might contain references</li>
+<li>You can always pass references to another function</li>
+<li>You can always reference value types</li>
+<li>You can always modify values that are referenced (that is the base values that are referenced)</li>
+<li>You can do whatever you want to (contents of) values that you didn’t get by reference</li>
+<li>You can only modify your own referenced references</li>
+</ul>
+
+
+ <aside class="copyright" role="note">
+
+ © 2018 The Eclipse Mita Project –
+
+ Documentation built with
+ <a href="https://www.gohugo.io" target="_blank">Hugo</a>
+ using the
+ <a href="http://github.com/digitalcraftsman/hugo-material-docs" target="_blank">Material</a> theme.
+ </aside>
+
+ <footer class="footer">
+
+
+<nav class="pagination" aria-label="Footer">
+ <div class="previous">
+
+ <a href="../../faq/" title="Frequently Asked Questions">
+ <span class="direction">
+ Previous
+ </span>
+ <div class="page">
+ <div class="button button-previous" role="button" aria-label="Previous">
+ <i class="icon icon-back"></i>
+ </div>
+ <div class="stretch">
+ <div class="title">
+ Frequently Asked Questions
+ </div>
+ </div>
+ </div>
+ </a>
+
+ </div>
+
+ <div class="next">
+
+ <a href="../../language/arrays/" title="Arrays">
+ <span class="direction">
+ Next
+ </span>
+ <div class="page">
+ <div class="stretch">
+ <div class="title">
+ Arrays
+ </div>
+ </div>
+ <div class="button button-next" role="button" aria-label="Next">
+ <i class="icon icon-forward"></i>
+ </div>
+ </div>
+ </a>
+
+ </div>
+</nav>
+
+
+
+
+
+ </footer>
+ </div>
+ </article>
+
+ <div class="results" role="status" aria-live="polite">
+ <div class="scrollable">
+ <div class="wrapper">
+ <div class="meta"></div>
+ <div class="list"></div>
+ </div>
+ </div>
+ </div>
+</main>
+
+ <script>
+
+ var base_url = '';
+ var repo_id = '';
+
+ </script>
+
+ <script src="../../javascripts/application.js"></script>
+
+
+ <script>
+ /* Add headers to scrollspy */
+ var headers = document.getElementsByTagName("h2");
+ var scrollspy = document.getElementById('scrollspy');
+
+ if(scrollspy) {
+ if(headers.length > 0) {
+ for(var i = 0; i < headers.length; i++) {
+ var li = document.createElement("li");
+ li.setAttribute("class", "anchor");
+
+ var a = document.createElement("a");
+ a.setAttribute("href", "#" + headers[i].id);
+ a.setAttribute("title", headers[i].innerHTML);
+ a.innerHTML = headers[i].innerHTML;
+
+ li.appendChild(a)
+ scrollspy.appendChild(li);
+ }
+ } else {
+ scrollspy.parentElement.removeChild(scrollspy)
+ }
+
+
+ /* Add permanent link next to the headers */
+ var headers = document.querySelectorAll("h1, h2, h3, h4, h5, h6");
+
+ for(var i = 0; i < headers.length; i++) {
+ var a = document.createElement("a");
+ a.setAttribute("class", "headerlink");
+ a.setAttribute("href", "#" + headers[i].id);
+ a.setAttribute("title", "Permanent link")
+ a.innerHTML = "#";
+ headers[i].appendChild(a);
+ }
+ }
+ </script>
+
+
+
+ <script src="//cdnjs.cloudflare.com/ajax/libs/highlight.js/9.8.0/highlight.min.js"></script>
+ <script>hljs.initHighlightingOnLoad();</script>
+ </body>
+</html>
+
diff --git a/logo.png b/logo.png
new file mode 100644
index 0000000..fd8976a
--- /dev/null
+++ b/logo.png
Binary files differ
diff --git a/platforms/index.xml b/platforms/index.xml
new file mode 100644
index 0000000..f70b35d
--- /dev/null
+++ b/platforms/index.xml
@@ -0,0 +1,25 @@
+<?xml version="1.0" encoding="utf-8" standalone="yes" ?>
+<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom">
+ <channel>
+ <title>Platforms on Eclipse Mita</title>
+ <link>/platforms/</link>
+ <description>Recent content in Platforms on Eclipse Mita</description>
+ <generator>Hugo -- gohugo.io</generator>
+ <language>en-us</language>
+
+ <atom:link href="/platforms/index.xml" rel="self" type="application/rss+xml" />
+
+
+ <item>
+ <title>XDK110</title>
+ <link>/platforms/xdk110/</link>
+ <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+
+ <guid>/platforms/xdk110/</guid>
+ <description>The Bosch Cross Domain Development Kit (XDK) is a programmable sensor device for building IoT applications. It contains a wide range of sensors and means of connectivity, is extensible using its extension bus. Due to its versatility it also serves as reference platform for Mita.
+To learn more about the XDK head over to http://xdk.io.
+Sensor: environment (BME280) Configuration Items Name Description optional power_mode : BME280_PowerMode Defaults to BME280_PowerMode.</description>
+ </item>
+
+ </channel>
+</rss>
\ No newline at end of file
diff --git a/platforms/xdk110/index.html b/platforms/xdk110/index.html
new file mode 100644
index 0000000..3475c68
--- /dev/null
+++ b/platforms/xdk110/index.html
@@ -0,0 +1,1155 @@
+<!DOCTYPE html>
+
+
+
+
+ <html class="no-js">
+
+ <head lang="en-us">
+ <meta charset="utf-8">
+ <meta name="viewport" content="width=device-width,user-scalable=no,initial-scale=1,maximum-scale=1">
+ <meta http-equiv="X-UA-Compatible" content="IE=10" />
+ <title>XDK110 - Eclipse Mita</title>
+ <meta name="generator" content="Hugo 0.42.1" />
+
+
+ <meta name="description" content="The documentation of Eclipse Mita.">
+
+ <link rel="canonical" href="../../platforms/xdk110/">
+
+
+ <meta property="og:url" content="/platforms/xdk110/">
+ <meta property="og:title" content="Eclipse Mita">
+ <meta property="og:image" content="/images/mita.svg">
+ <meta name="apple-mobile-web-app-title" content="Eclipse Mita">
+ <meta name="apple-mobile-web-app-capable" content="yes">
+ <meta name="apple-mobile-web-app-status-bar-style" content="black-translucent">
+
+ <link rel="shortcut icon" type="image/x-icon" href="../../images/favicon.ico">
+ <link rel="icon" type="image/x-icon" href="../../images/favicon.ico">
+
+ <style>
+ @font-face {
+ font-family: 'Icon';
+ src: url('/fonts/icon.eot');
+ src: url('/fonts/icon.eot')
+ format('embedded-opentype'),
+ url('/fonts/icon.woff')
+ format('woff'),
+ url('/fonts/icon.ttf')
+ format('truetype'),
+ url('/fonts/icon.svg')
+ format('svg');
+ font-weight: normal;
+ font-style: normal;
+ }
+ </style>
+
+ <link rel="stylesheet" href="../../stylesheets/application.css">
+ <link rel="stylesheet" href="../../stylesheets/temporary.css">
+ <link rel="stylesheet" href="../../stylesheets/palettes.css">
+ <link rel="stylesheet" href="../../stylesheets/highlight/highlight.css">
+
+
+
+
+ <link rel="stylesheet" href="//fonts.googleapis.com/css?family=Ubuntu:400,700|Ubuntu+Mono">
+ <style>
+ body, input {
+ font-family: 'Ubuntu', Helvetica, Arial, sans-serif;
+ }
+ pre, code {
+ font-family: 'Ubuntu Mono', 'Courier New', 'Courier', monospace;
+ }
+ </style>
+
+
+ <link rel="stylesheet" href="../../css/custom.css">
+
+ <script src="../../javascripts/modernizr.js"></script>
+
+
+
+ </head>
+ <body class="palette-primary-blue-grey palette-accent-light-blue">
+
+
+
+
+<div class="backdrop">
+ <div class="backdrop-paper"></div>
+</div>
+
+<input class="toggle" type="checkbox" id="toggle-drawer">
+<input class="toggle" type="checkbox" id="toggle-search">
+<label class="toggle-button overlay" for="toggle-drawer"></label>
+
+<header class="header">
+ <nav aria-label="Header">
+ <div class="bar default">
+ <div class="button button-menu" role="button" aria-label="Menu">
+ <label class="toggle-button icon icon-menu" for="toggle-drawer">
+ <span></span>
+ </label>
+ </div>
+ <div class="stretch">
+ <div class="title">
+ XDK110
+ </div>
+ </div>
+
+
+ <div class="button button-twitter" role="button" aria-label="Twitter">
+ <a href="https://twitter.com/eclipse_mita" title="@eclipse_mita on Twitter" target="_blank" class="toggle-button icon icon-twitter"></a>
+ </div>
+
+
+
+ <div class="button button-github" role="button" aria-label="GitHub">
+ <a href="https://github.com/eclipse/mita" title="@eclipse/mita on GitHub" target="_blank" class="toggle-button icon icon-github"></a>
+ </div>
+
+
+
+ </div>
+ <div class="bar search">
+ <div class="button button-close" role="button" aria-label="Close">
+ <label class="toggle-button icon icon-back" for="toggle-search"></label>
+ </div>
+ <div class="stretch">
+ <div class="field">
+ <input class="query" type="text" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck>
+ </div>
+ </div>
+ <div class="button button-reset" role="button" aria-label="Search">
+ <button class="toggle-button icon icon-close" id="reset-search"></button>
+ </div>
+ </div>
+</nav>
+</header>
+
+<main class="main">
+ <div class="drawer">
+ <nav aria-label="Navigation">
+ <a href="../../" class="project">
+ <div class="banner">
+
+ <div class="logo">
+ <img src="../../images/mita.svg">
+ </div>
+
+ <div class="name">
+ <strong>Eclipse Mita </strong>
+
+ </div>
+ </div>
+ </a>
+
+ <div class="scrollable">
+ <div class="wrapper">
+
+
+ <div class="toc">
+
+ <ul>
+
+
+
+
+
+<li>
+
+
+
+
+
+<a title="Download" href="http://github.com/eclipse/mita">
+
+ Download
+</a>
+
+
+
+
+</li>
+
+
+
+<li>
+
+
+
+
+
+<a title="Concepts" href="../../concepts/">
+
+ Concepts
+</a>
+
+
+
+
+</li>
+
+
+
+<li>
+
+ <span class="section">Language</span>
+ <ul>
+
+
+
+
+
+
+<a title="Introduction" href="../../language/introduction/">
+
+ Introduction
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Basics" href="../../language/basics/">
+
+ Basics
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Packages" href="../../language/packages/">
+
+ Packages
+</a>
+
+
+
+
+
+
+
+
+
+<a title="System Setup" href="../../language/setup/">
+
+ System Setup
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Types" href="../../language/types/">
+
+ Types
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Arrays" href="../../language/arrays/">
+
+ Arrays
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Functions" href="../../language/functions/">
+
+ Functions
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Foreign Function Interface" href="../../language/foreignfunctioninterface/">
+
+ Foreign Function Interface
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Events" href="../../language/events/">
+
+ Events
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Exceptions" href="../../language/exceptions/">
+
+ Exceptions
+</a>
+
+
+
+
+ </ul>
+
+</li>
+
+
+
+<li>
+
+ <span class="section">Platforms</span>
+ <ul>
+
+
+
+
+
+
+<a class="current" title="XDK110" href="../../platforms/xdk110/">
+
+ XDK110
+</a>
+
+
+<ul id="scrollspy">
+</ul>
+
+
+
+ </ul>
+
+</li>
+
+
+ </ul>
+
+
+
+ </div>
+ </div>
+ </div>
+</nav>
+
+ </div>
+
+ <article class="article">
+ <div class="wrapper">
+ <h1>XDK110 </h1>
+
+
+
+<p>The Bosch Cross Domain Development Kit (XDK) is a programmable sensor device for building IoT applications.
+It contains a wide range of sensors and means of connectivity, is extensible using its extension bus.
+Due to its versatility it also serves as reference platform for Mita.</p>
+
+<p>To learn more about the XDK head over to <a href="http://xdk.io">http://xdk.io</a>.</p>
+
+<h2 id="sensor-environment-bme280">Sensor: environment (BME280)</h2>
+
+<h3 id="configuration-items">Configuration Items</h3>
+
+<table>
+ <thead>
+ <tr>
+ <td>Name</td>
+ <td>Description</td>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><div class="highlight"><pre><small>optional</small> <b>power_mode</b> : <span class="kt">BME280_PowerMode</span></pre></div></td>
+ <td>Defaults to <i>BME280_PowerMode.Normal</i>. The BME280 power mode</td>
+ </tr>
+ <tr>
+ <td><div class="highlight"><pre><small>optional</small> <b>standby_time</b> : <span class="kt">uint32</span></pre></div></td>
+ <td>The standby time used in normal mode in milliseconds.
+ Beware that the value supplied here will be clipped to the nearest valid value.</td>
+ </tr>
+ <tr>
+ <td><div class="highlight"><pre><small>optional</small> <b>temperature_oversampling</b> : <span class="kt">BME280_Oversampling</span></pre></div></td>
+ <td>Reduces noise in the temperature measurement by over sampling.
+ Higher over sampling settings reduce noise but increase measurement time and power consumption.</td>
+ </tr>
+ <tr>
+ <td><div class="highlight"><pre><small>optional</small> <b>pressure_oversampling</b> : <span class="kt">BME280_Oversampling</span></pre></div></td>
+ <td>Reduces noise in the pressure measurement by over sampling.
+ Higher over sampling settings reduce noise but increase measurement time and power consumption.</td>
+ </tr>
+ <tr>
+ <td><div class="highlight"><pre><small>optional</small> <b>humidity_oversampling</b> : <span class="kt">BME280_Oversampling</span></pre></div></td>
+ <td>Reduces noise in the humidity measurement by over sampling.
+ Higher over sampling settings reduce noise but increase measurement time and power consumption.</td>
+ </tr>
+ </tbody>
+</table>
+
+<h4 id="modalities">Modalities</h4>
+
+<table>
+ <thead>
+ <tr>
+ <td>Name</td>
+ <td>Description</td>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><div class="highlight"><pre><b>temperature</b> : <span class="kt">int32</span></pre></div></td>
+ <td>The temperature in milli-celcius</td>
+ </tr>
+ <tr>
+ <td><div class="highlight"><pre><b>pressure</b> : <span class="kt">uint32</span></pre></div></td>
+ <td>The pressure in pascal</td>
+ </tr>
+ <tr>
+ <td><div class="highlight"><pre><b>humidity</b> : <span class="kt">float</span></pre></div></td>
+ <td>The relative humidity as percentage</td>
+ </tr>
+ <tr>
+ <td><div class="highlight"><pre><b>humidity_fixed_point</b> : <span class="kt">uint32</span></pre></div></td>
+ <td>The relative humidity as percentage in Q22.10 integer format.
+ Divide this value by 1024 to get the percentage.</td>
+ </tr>
+ </tbody>
+</table>
+
+<h2 id="sensor-accelerometer-bma280">Sensor: accelerometer (BMA280)</h2>
+
+<h3 id="configuration-items-1">Configuration Items</h3>
+
+<table>
+ <thead>
+ <tr>
+ <td>Name</td>
+ <td>Description</td>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><div class="highlight"><pre><small>optional</small> <b>range</b> : <span class="kt">BMA280_Range</span></pre></div></td>
+ <td>Defaults to <i>BMA280_Range.Range_2G</i>. The range of acceleration we want to measure.</td>
+ </tr>
+ <tr>
+ <td><div class="highlight"><pre><small>optional</small> <b>bandwidth</b> : <span class="kt">BMA280_Bandwidth</span></pre></div></td>
+ <td>Defaults to <i>BMA280_Bandwidth.BW_500Hz</i>. The low-pass filter bandwidth used by the BMA.</td>
+ </tr>
+ <tr>
+ <td><div class="highlight"><pre><small>optional</small> <b>any_motion_threshold</b> : <span class="kt">uint32</span></pre></div></td>
+ <td>Defaults to <i>20</i>. The threshold of acceleration that has to be crossed before an any motion event is triggered.</td>
+ </tr>
+ <tr>
+ <td><div class="highlight"><pre><small>optional</small> <b>no_motion_threshold</b> : <span class="kt">uint32</span></pre></div></td>
+ <td>Defaults to <i>20</i>. The threshold of acceleration that must not be exceeded for a no motion event to be triggered.</td>
+ </tr>
+ </tbody>
+</table>
+
+<h4 id="modalities-1">Modalities</h4>
+
+<table>
+ <thead>
+ <tr>
+ <td>Name</td>
+ <td>Description</td>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><div class="highlight"><pre><b>x_axis</b> : <span class="kt">int32</span></pre></div></td>
+ <td>The X axis of the BMA280</td>
+ </tr>
+ <tr>
+ <td><div class="highlight"><pre><b>y_axis</b> : <span class="kt">int32</span></pre></div></td>
+ <td>The Y axis of the BMA280</td>
+ </tr>
+ <tr>
+ <td><div class="highlight"><pre><b>z_axis</b> : <span class="kt">int32</span></pre></div></td>
+ <td>The Z axis of the BMA280</td>
+ </tr>
+ <tr>
+ <td><div class="highlight"><pre><b>magnitude</b> : <span class="kt">uint32</span></pre></div></td>
+ <td>The L2 norm of the acceleration vector: sqrt(x^2 + y^2 + z^2)</td>
+ </tr>
+ </tbody>
+</table>
+
+<h4 id="events">Events</h4>
+
+<table>
+ <thead>
+ <tr>
+ <td>Name</td>
+ <td>Description</td>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><div class="highlight"><pre><b>any_motion</b></pre></div></td>
+ <td>The any motion event (also called activity) uses the change between two successive
+ acceleration measurements to detect changes in motion. An event is generated when this change
+ exceeds the any_motion_threshold.</td>
+ </tr>
+ <tr>
+ <td><div class="highlight"><pre><b>no_motion</b></pre></div></td>
+ <td>The no motion event (also called any inactivity) uses the change between two successive
+ acceleration measurements to detect changes in motion. An event is generated when this change
+ consecutively stays below the no_motion_threshold.</td>
+ </tr>
+ <tr>
+ <td><div class="highlight"><pre><b>low_g</b></pre></div></td>
+ <td></td>
+ </tr>
+ <tr>
+ <td><div class="highlight"><pre><b>high_g</b></pre></div></td>
+ <td></td>
+ </tr>
+ <tr>
+ <td><div class="highlight"><pre><b>single_tap</b></pre></div></td>
+ <td></td>
+ </tr>
+ <tr>
+ <td><div class="highlight"><pre><b>double_tap</b></pre></div></td>
+ <td></td>
+ </tr>
+ <tr>
+ <td><div class="highlight"><pre><b>flat</b></pre></div></td>
+ <td></td>
+ </tr>
+ <tr>
+ <td><div class="highlight"><pre><b>orientation</b></pre></div></td>
+ <td></td>
+ </tr>
+ <tr>
+ <td><div class="highlight"><pre><b>fifo_full</b></pre></div></td>
+ <td></td>
+ </tr>
+ <tr>
+ <td><div class="highlight"><pre><b>fifo_wml</b></pre></div></td>
+ <td></td>
+ </tr>
+ <tr>
+ <td><div class="highlight"><pre><b>new_data</b></pre></div></td>
+ <td>This event serves the asynchronous reading of data. It is generated after storing a new value
+ of z-axis acceleration data in the data register.</td>
+ </tr>
+ </tbody>
+</table>
+
+<h2 id="sensor-light-max44009">Sensor: light (MAX44009)</h2>
+
+<h3 id="configuration-items-2">Configuration Items</h3>
+
+<table>
+ <thead>
+ <tr>
+ <td>Name</td>
+ <td>Description</td>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><div class="highlight"><pre><small>optional</small> <b>manual_mode</b> : <span class="kt">bool</span></pre></div></td>
+ <td>Defaults to <i>false</i>. Enables the manual configuration of integration time and high brightness mode.
+ If set to false (default) the chip automatically selects those values.</td>
+ </tr>
+ <tr>
+ <td><div class="highlight"><pre><small>optional</small> <b>integration_time</b> : <span class="kt">MAX44009_IntegrationTime</span></pre></div></td>
+ <td>Defaults to <i>MAX44009_IntegrationTime.MS_800</i>. The integration time is the time the sensor collects light for. In automatic mode
+ (manual mode set to false) the chip automatically selects the integration time.
+
+ This configuration item is only used when manual_mode is set to true.</td>
+ </tr>
+ <tr>
+ <td><div class="highlight"><pre><small>optional</small> <b>high_brightness</b> : <span class="kt">bool</span></pre></div></td>
+ <td>Defaults to <i>false</i>. Set to true so that only 1/8 of the photo diode current goes to the ADC. This mode is used in
+ high-brightness situations to avoid saturation/clipping effects of the ADC.
+
+ This configuration item is only used when manual_mode is set to true.</td>
+ </tr>
+ <tr>
+ <td><div class="highlight"><pre><small>optional</small> <b>continuous_mode</b> : <span class="kt">bool</span></pre></div></td>
+ <td>Defaults to <i>false</i>. In default mode (false) the IC measures lux intensity only once every 800ms regardless
+ of integration time. This mode allows the part to operate at its lowest possible supply current.
+
+ In continuous mode (true) the IC continuously measures lux intensity. That is, as soon as one
+ reading is finished, a new one begins. If integration time is 6.25ms, readings are taken every 6.25ms.
+ If integration time is 800ms, readings are taken every 800ms. In this mode, the part consumes slightly
+ higher power than in the default mode.</td>
+ </tr>
+ </tbody>
+</table>
+
+<h4 id="modalities-2">Modalities</h4>
+
+<table>
+ <thead>
+ <tr>
+ <td>Name</td>
+ <td>Description</td>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><div class="highlight"><pre><b>intensity</b> : <span class="kt">uint32</span></pre></div></td>
+ <td>The light intensity in millilux.</td>
+ </tr>
+ </tbody>
+</table>
+
+<h2 id="sensor-button-one-button">Sensor: button_one (Button)</h2>
+
+<h4 id="modalities-3">Modalities</h4>
+
+<table>
+ <thead>
+ <tr>
+ <td>Name</td>
+ <td>Description</td>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><div class="highlight"><pre><b>is_pressed</b> : <span class="kt">bool</span></pre></div></td>
+ <td>True if the button is pressed in this very right moment. False otherwise.</td>
+ </tr>
+ </tbody>
+</table>
+
+<h4 id="events-1">Events</h4>
+
+<table>
+ <thead>
+ <tr>
+ <td>Name</td>
+ <td>Description</td>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><div class="highlight"><pre><b>pressed</b></pre></div></td>
+ <td>Fires after the button was pressed.</td>
+ </tr>
+ <tr>
+ <td><div class="highlight"><pre><b>released</b></pre></div></td>
+ <td>Fires after the button was released.</td>
+ </tr>
+ </tbody>
+</table>
+
+<h2 id="sensor-button-two-button">Sensor: button_two (Button)</h2>
+
+<h4 id="modalities-4">Modalities</h4>
+
+<table>
+ <thead>
+ <tr>
+ <td>Name</td>
+ <td>Description</td>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><div class="highlight"><pre><b>is_pressed</b> : <span class="kt">bool</span></pre></div></td>
+ <td>True if the button is pressed in this very right moment. False otherwise.</td>
+ </tr>
+ </tbody>
+</table>
+
+<h4 id="events-2">Events</h4>
+
+<table>
+ <thead>
+ <tr>
+ <td>Name</td>
+ <td>Description</td>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><div class="highlight"><pre><b>pressed</b></pre></div></td>
+ <td>Fires after the button was pressed.</td>
+ </tr>
+ <tr>
+ <td><div class="highlight"><pre><b>released</b></pre></div></td>
+ <td>Fires after the button was released.</td>
+ </tr>
+ </tbody>
+</table>
+
+<h2 id="connectivity-ble">Connectivity: BLE</h2>
+
+<p>BLE is Bluetooth Low Energy using GATT profiles.
+At the moment we only support slave mode where the XDK becomes a device that can be connected to (as compared to connecting to some other device).</p>
+
+<h3 id="configuration-items-3">Configuration Items</h3>
+
+<table>
+ <thead>
+ <tr>
+ <td>Name</td>
+ <td>Description</td>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><div class="highlight"><pre><small>optional</small> <b>deviceName</b> : <span class="kt">string</span></pre></div></td>
+ <td>The name of the device as advertised via GAP.</td>
+ </tr>
+ <tr>
+ <td><div class="highlight"><pre><small>optional</small> <b>serviceUid</b> : <span class="kt">uint32</span></pre></div></td>
+ <td>The last four bytes of the UUID of the GATT service we'll create.</td>
+ </tr>
+ <tr>
+ <td><div class="highlight"><pre><small>optional</small> <b>advertisingInterval</b> : <span class="kt">int16</span></pre></div></td>
+ <td>Defaults to <i>1000</i>. The advertising interval in milliseconds.</td>
+ </tr>
+ </tbody>
+</table>
+
+<h3 id="variable-configuration-items">Variable Configuration Items</h3>
+
+<table>
+ <thead>
+ <tr>
+ <td>Name</td>
+ <td>Description</td>
+ <td>Parameters</td>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><div class="highlight"><pre><b>bool_characteristic</b> : <span class="kt">bool</span></pre></div></td>
+ <td>Creates a boolean GATT characteristic.</td>
+ <td>
+ <ul>
+ <li>
+ <div class="highlight"><pre> <b>UUID</b> : <span class="kt">uint32</span></pre></div>
+ The last four bytes of the characteristic UUID. Defaults to the hash code of the VCI name.
+ </li>
+ </ul>
+ </td>
+ </tr>
+ <tr>
+ <td><div class="highlight"><pre><b>uint32_characteristic</b> : <span class="kt">uint32</span></pre></div></td>
+ <td>Creates an unsigned integer GATT characteristic.</td>
+ <td>
+ <ul>
+ <li>
+ <div class="highlight"><pre> <b>UUID</b> : <span class="kt">uint32</span></pre></div>
+ The last four bytes of the characteristic UUID. Defaults to the hash code of the VCI name.
+ </li>
+ </ul>
+ </td>
+ </tr>
+ <tr>
+ <td><div class="highlight"><pre><b>int32_characteristic</b> : <span class="kt">int32</span></pre></div></td>
+ <td>Creates a signed integer GATT characteristic.</td>
+ <td>
+ <ul>
+ <li>
+ <div class="highlight"><pre> <b>UUID</b> : <span class="kt">uint32</span></pre></div>
+ The last four bytes of the characteristic UUID. Defaults to the hash code of the VCI name.
+ </li>
+ </ul>
+ </td>
+ </tr>
+ </tbody>
+</table>
+
+<h2 id="connectivity-led">Connectivity: LED</h2>
+
+<p>Displays state using three differently colored LEDs on the device.</p>
+
+<h3 id="variable-configuration-items-1">Variable Configuration Items</h3>
+
+<table>
+ <thead>
+ <tr>
+ <td>Name</td>
+ <td>Description</td>
+ <td>Parameters</td>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><div class="highlight"><pre><b>light_up</b> : <span class="kt">bool</span></pre></div></td>
+ <td></td>
+ <td>
+ <ul>
+ <li>
+ <div class="highlight"><pre> <b>color</b> : <span class="kt">LedColor</span></pre></div>
+ </li>
+ </ul>
+ </td>
+ </tr>
+ </tbody>
+</table>
+
+<h2 id="connectivity-wlan">Connectivity: WLAN</h2>
+
+<p>Specifies the connection to a wireless wide-area network, also refered to as WiFi.</p>
+
+<h3 id="configuration-items-4">Configuration Items</h3>
+
+<table>
+ <thead>
+ <tr>
+ <td>Name</td>
+ <td>Description</td>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><div class="highlight"><pre><b>ssid</b> : <span class="kt">string</span></pre></div></td>
+ <td>The SSID of the WLAN network we want to connect to.</td>
+ </tr>
+ <tr>
+ <td><div class="highlight"><pre><b>psk</b> : <span class="kt">string</span></pre></div></td>
+ <td>The pre-shared key of the WLAN we're connecting to. Note that this
+ setting implies WPA2-PSK as authentication method. At this moment
+ the WLAN connectivity does not support enterprise WLAN.</td>
+ </tr>
+ <tr>
+ <td><div class="highlight"><pre><small>optional</small> <b>useDHCP</b> : <span class="kt">bool</span></pre></div></td>
+ <td>Defaults to <i>true</i>. If true we'll attempt to configure the wireless interface using DHCP and
+ all static settings will be ignored. If false, the static settings have to
+ be present.</td>
+ </tr>
+ <tr>
+ <td><div class="highlight"><pre><small>optional</small> <b>staticIP</b> : <span class="kt">string</span></pre></div></td>
+ <td>The static IP address to use. This field has to be in the number-dot
+ customary for IPv4 addresses (see IETF draft-main-ipaddr-text-rep-02).
+ If useDHCP is true this field is ignored. If useDHCP is false, this field
+ is mandatory.</td>
+ </tr>
+ <tr>
+ <td><div class="highlight"><pre><small>optional</small> <b>staticGW</b> : <span class="kt">string</span></pre></div></td>
+ <td>The IP address of the default gateway. This field has to be in the number-dot
+ customary for IPv4 addresses (see IETF draft-main-ipaddr-text-rep-02).
+ If useDHCP is true this field is ignored. If useDHCP is false, this field
+ is recommended.</td>
+ </tr>
+ <tr>
+ <td><div class="highlight"><pre><small>optional</small> <b>staticDNS</b> : <span class="kt">string</span></pre></div></td>
+ <td>The IP address of the default DNS server. This field has to be in the number-dot
+ customary for IPv4 addresses (see IETF draft-main-ipaddr-text-rep-02).
+ If useDHCP is true this field is ignored. If useDHCP is false, this field
+ is recommended.</td>
+ </tr>
+ <tr>
+ <td><div class="highlight"><pre><small>optional</small> <b>staticMask</b> : <span class="kt">string</span></pre></div></td>
+ <td>The IP address of the default Subnet Mask. This field has to be in the number-dot
+ customary for IPv4 addresses (see IETF draft-main-ipaddr-text-rep-02).
+ If useDHCP is true this field is ignored. If useDHCP is false, this field
+ is recommended.</td>
+ </tr>
+ </tbody>
+</table>
+
+<h2 id="connectivity-mqtt">Connectivity: MQTT</h2>
+
+<p>MQTT (Message Queuing Telemetry Transport) is an ISO standard (ISO/IEC PRF 20922) publish-subscribe-based messaging protocol.
+This MQTT connectivity requires WLAN to be setup as well.</p>
+
+<h3 id="configuration-items-5">Configuration Items</h3>
+
+<table>
+ <thead>
+ <tr>
+ <td>Name</td>
+ <td>Description</td>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><div class="highlight"><pre><b>transport</b> : <span class="kt">WLAN</span></pre></div></td>
+ <td>The underlying transport connectivity we use to send the data out. In the future we might also
+ support LoRa here.</td>
+ </tr>
+ <tr>
+ <td><div class="highlight"><pre><b>url</b> : <span class="kt">string</span></pre></div></td>
+ <td>The URL pointing to the MQTT broker, for example: mqtt://does-not.exist:8000</td>
+ </tr>
+ <tr>
+ <td><div class="highlight"><pre><b>clientId</b> : <span class="kt">string</span></pre></div></td>
+ <td>The client identifier (here: clientID) is a identifier of each MQTT client
+ connecting to a MQTT broker. It needs to be unique for the broker to
+ know the state of the client.</td>
+ </tr>
+ <tr>
+ <td><div class="highlight"><pre><small>optional</small> <b>cleanSession</b> : <span class="kt">bool</span></pre></div></td>
+ <td>Defaults to <i>false</i>. The clean session flag indicates to the broker whether the client wants
+ to establish a clean session or a persistent session where all
+ subscriptions and messages (QoS 1 & 2) are stored for the client.</td>
+ </tr>
+ <tr>
+ <td><div class="highlight"><pre><small>optional</small> <b>keepAliveInterval</b> : <span class="kt">uint32</span></pre></div></td>
+ <td>Defaults to <i>60</i>. The keep alive interval (in seconds) is the time the client commits to for
+ when sending regular pings to the broker. The broker responds to the
+ pings enabling both sides to determine if the other one is still alive and
+ reachable.</td>
+ </tr>
+ </tbody>
+</table>
+
+<h3 id="variable-configuration-items-2">Variable Configuration Items</h3>
+
+<table>
+ <thead>
+ <tr>
+ <td>Name</td>
+ <td>Description</td>
+ <td>Parameters</td>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><div class="highlight"><pre><b>topic</b> : <span class="kt">string</span></pre></div></td>
+ <td>Publishes a message to a particular topic.</td>
+ <td>
+ <ul>
+ <li>
+ <div class="highlight"><pre> <b>name</b> : <span class="kt">string</span></pre></div>
+ </li>
+ <li>
+ <div class="highlight"><pre><small>optional</small> <b>qos</b> : <span class="kt">uint32</span></pre></div>
+ </li>
+ </ul>
+ </td>
+ </tr>
+ </tbody>
+</table>
+
+<h2 id="connectivity-httprestclient">Connectivity: HttpRestClient</h2>
+
+<p>Implements an HTTP REST Client over WIFI</p>
+
+<h3 id="configuration-items-6">Configuration Items</h3>
+
+<table>
+ <thead>
+ <tr>
+ <td>Name</td>
+ <td>Description</td>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><div class="highlight"><pre><b>transport</b> : <span class="kt">WLAN</span></pre></div></td>
+ <td>The underlying transport connectivity we use to send the data out. In the future we might also
+ support LoRa here.</td>
+ </tr>
+ <tr>
+ <td><div class="highlight"><pre><b>endpointBase</b> : <span class="kt">string</span></pre></div></td>
+ <td>The part of the endpoint URL common to all requests, e.g. http://foobar.com/api/v1</td>
+ </tr>
+ <tr>
+ <td><div class="highlight"><pre><small>optional</small> <b>header</b> : <span class="kt">string</span></pre></div></td>
+ <td>A custom header which is added to each HTTP request. Example:
+ X-Auth: MySecretToken\nX-Version: 1.0</td>
+ </tr>
+ </tbody>
+</table>
+
+<h3 id="variable-configuration-items-3">Variable Configuration Items</h3>
+
+<table>
+ <thead>
+ <tr>
+ <td>Name</td>
+ <td>Description</td>
+ <td>Parameters</td>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><div class="highlight"><pre><b>resource</b> : <span class="kt">string</span></pre></div></td>
+ <td></td>
+ <td>
+ <ul>
+ <li>
+ <div class="highlight"><pre> <b>endpoint</b> : <span class="kt">string</span></pre></div>
+ </li>
+ <li>
+ <div class="highlight"><pre><small>optional</small> <b>contentType</b> : <span class="kt">string</span></pre></div>
+ </li>
+ <li>
+ <div class="highlight"><pre><small>optional</small> <b>writeMethod</b> : <span class="kt">HttpMethod</span></pre></div>
+ </li>
+ <li>
+ <div class="highlight"><pre><small>optional</small> <b>readMethod</b> : <span class="kt">HttpMethod</span></pre></div>
+ </li>
+ </ul>
+ </td>
+ </tr>
+ </tbody>
+</table>
+
+
+ <aside class="copyright" role="note">
+
+ © 2018 The Eclipse Mita Project –
+
+ Documentation built with
+ <a href="https://www.gohugo.io" target="_blank">Hugo</a>
+ using the
+ <a href="http://github.com/digitalcraftsman/hugo-material-docs" target="_blank">Material</a> theme.
+ </aside>
+
+ <footer class="footer">
+
+
+<nav class="pagination" aria-label="Footer">
+ <div class="previous">
+
+ <a href="../../language/functions/" title="Functions">
+ <span class="direction">
+ Previous
+ </span>
+ <div class="page">
+ <div class="button button-previous" role="button" aria-label="Previous">
+ <i class="icon icon-back"></i>
+ </div>
+ <div class="stretch">
+ <div class="title">
+ Functions
+ </div>
+ </div>
+ </div>
+ </a>
+
+ </div>
+
+ <div class="next">
+
+ <a href="../../language/foreignfunctioninterface/" title="Foreign Function Interface">
+ <span class="direction">
+ Next
+ </span>
+ <div class="page">
+ <div class="stretch">
+ <div class="title">
+ Foreign Function Interface
+ </div>
+ </div>
+ <div class="button button-next" role="button" aria-label="Next">
+ <i class="icon icon-forward"></i>
+ </div>
+ </div>
+ </a>
+
+ </div>
+</nav>
+
+
+
+
+
+ </footer>
+ </div>
+ </article>
+
+ <div class="results" role="status" aria-live="polite">
+ <div class="scrollable">
+ <div class="wrapper">
+ <div class="meta"></div>
+ <div class="list"></div>
+ </div>
+ </div>
+ </div>
+</main>
+
+ <script>
+
+ var base_url = '';
+ var repo_id = '';
+
+ </script>
+
+ <script src="../../javascripts/application.js"></script>
+
+
+ <script>
+ /* Add headers to scrollspy */
+ var headers = document.getElementsByTagName("h2");
+ var scrollspy = document.getElementById('scrollspy');
+
+ if(scrollspy) {
+ if(headers.length > 0) {
+ for(var i = 0; i < headers.length; i++) {
+ var li = document.createElement("li");
+ li.setAttribute("class", "anchor");
+
+ var a = document.createElement("a");
+ a.setAttribute("href", "#" + headers[i].id);
+ a.setAttribute("title", headers[i].innerHTML);
+ a.innerHTML = headers[i].innerHTML;
+
+ li.appendChild(a)
+ scrollspy.appendChild(li);
+ }
+ } else {
+ scrollspy.parentElement.removeChild(scrollspy)
+ }
+
+
+ /* Add permanent link next to the headers */
+ var headers = document.querySelectorAll("h1, h2, h3, h4, h5, h6");
+
+ for(var i = 0; i < headers.length; i++) {
+ var a = document.createElement("a");
+ a.setAttribute("class", "headerlink");
+ a.setAttribute("href", "#" + headers[i].id);
+ a.setAttribute("title", "Permanent link")
+ a.innerHTML = "#";
+ headers[i].appendChild(a);
+ }
+ }
+ </script>
+
+
+
+ <script src="//cdnjs.cloudflare.com/ajax/libs/highlight.js/9.8.0/highlight.min.js"></script>
+ <script>hljs.initHighlightingOnLoad();</script>
+ </body>
+</html>
+
diff --git a/sitemap.xml b/sitemap.xml
new file mode 100644
index 0000000..5ae6bcf
--- /dev/null
+++ b/sitemap.xml
@@ -0,0 +1,85 @@
+<?xml version="1.0" encoding="utf-8" standalone="yes" ?>
+<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"
+ xmlns:xhtml="http://www.w3.org/1999/xhtml">
+
+ <url>
+ <loc>/language/introduction/</loc>
+ </url>
+
+ <url>
+ <loc>/language/basics/</loc>
+ </url>
+
+ <url>
+ <loc>/language/packages/</loc>
+ </url>
+
+ <url>
+ <loc>/language/setup/</loc>
+ </url>
+
+ <url>
+ <loc>/faq/</loc>
+ </url>
+
+ <url>
+ <loc>/language/types/</loc>
+ </url>
+
+ <url>
+ <loc>/language/arrays/</loc>
+ </url>
+
+ <url>
+ <loc>/language/functions/</loc>
+ </url>
+
+ <url>
+ <loc>/platforms/</loc>
+ </url>
+
+ <url>
+ <loc>/platforms/xdk110/</loc>
+ </url>
+
+ <url>
+ <loc>/language/foreignfunctioninterface/</loc>
+ </url>
+
+ <url>
+ <loc>/language/events/</loc>
+ </url>
+
+ <url>
+ <loc>/language/exceptions/</loc>
+ </url>
+
+ <url>
+ <loc>/download/</loc>
+ <lastmod>2017-07-18T14:18:49+02:00</lastmod>
+ </url>
+
+ <url>
+ <loc>/language/</loc>
+ </url>
+
+ <url>
+ <loc>/categories/</loc>
+ <priority>0</priority>
+ </url>
+
+ <url>
+ <loc>/concepts/</loc>
+ </url>
+
+ <url>
+ <loc>/</loc>
+ <lastmod>2017-07-18T14:18:49+02:00</lastmod>
+ </url>
+
+ <url>
+ <loc>/tags/</loc>
+ <priority>0</priority>
+ </url>
+
+</urlset>
\ No newline at end of file
diff --git a/stylesheets/application.css b/stylesheets/application.css
new file mode 100644
index 0000000..162a0cf
--- /dev/null
+++ b/stylesheets/application.css
@@ -0,0 +1 @@
+html{box-sizing:border-box;-moz-box-sizing:border-box;-webkit-box-sizing:border-box}*,:after,:before{box-sizing:inherit;-moz-box-sizing:inherit;-webkit-box-sizing:inherit}html{font-size:62.5%;-webkit-text-size-adjust:none;-ms-text-size-adjust:none;text-size-adjust:none}a,abbr,acronym,address,applet,article,aside,audio,b,big,blockquote,body,canvas,caption,center,cite,code,dd,del,details,dfn,div,dl,dt,em,embed,fieldset,figcaption,figure,footer,form,h1,h2,h3,h4,h5,h6,header,hgroup,html,i,iframe,img,ins,kbd,label,legend,li,main,mark,menu,nav,object,ol,output,p,pre,q,ruby,s,samp,section,small,span,strike,strong,sub,summary,sup,table,tbody,td,tfoot,th,thead,time,tr,tt,u,ul,var,video{margin:0;padding:0;border:0}main{display:block}ul{list-style:none}table{border-collapse:collapse;border-spacing:0}td{text-align:left;font-weight:400;vertical-align:middle}button{outline:0;padding:0;background:transparent;border:none;font-size:inherit}input{-webkit-appearance:none;-moz-appearance:none;-ms-appearance:none;-o-appearance:none;appearance:none;outline:none;border:none}a{text-decoration:none;color:inherit}a,button,input,label{-webkit-tap-highlight-color:rgba(255,255,255,0);-webkit-tap-highlight-color:transparent}h1,h2,h3,h4,h5,h6{font-weight:inherit}pre{background:rgba(0,0,0,.05)}pre,pre code{color:rgba(0,0,0,.87)}.c,.c1,.cm,.o{color:rgba(0,0,0,.54)}.k,.kn{color:#a71d5d}.kd,.kt{color:#0086b3}.n.f,.nf{color:#795da3}.nx{color:#0086b3}.s,.s1{color:#183691}.bp,.mi{color:#9575cd}.icon{font-family:Icon;speak:none;font-style:normal;font-weight:400;font-variant:normal;text-transform:none;line-height:1;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.icon-search:before{content:"\e600"}.icon-back:before{content:"\e601"}.icon-link:before{content:"\e602"}.icon-close:before{content:"\e603"}.icon-menu:before{content:"\e604"}.icon-forward:before{content:"\e605"}.icon-twitter:before{content:"\e606"}.icon-github:before{content:"\e607"}.icon-download:before{content:"\e608"}.icon-star:before{content:"\e609"}.icon-warning:before{content:"\e610"}.icon-note:before{content:"\e611"}a{-webkit-transition:color .25s;transition:color .25s}.overlay{-webkit-transition:opacity .25s,width 0s .25s,height 0s .25s;transition:opacity .25s,width 0s .25s,height 0s .25s}#toggle-drawer:checked~.overlay,.toggle-drawer .overlay{-webkit-transition:opacity .25s,width 0s,height 0s;transition:opacity .25s,width 0s,height 0s}.js .header{-webkit-transition:background .6s,color .6s;transition:background .6s,color .6s}.js .header:before{-webkit-transition:background .6s;transition:background .6s}.button .icon{-webkit-transition:background .25s;transition:background .25s}body{color:rgba(0,0,0,.87)}@supports (-webkit-appearance:none){body{background:#e84e40}}.ios body{background:#fff}hr{border:0;border-top:1px solid rgba(0,0,0,.12)}.toggle-button{cursor:pointer;color:inherit}.backdrop,.backdrop-paper:after{background:#fff}.overlay{background:rgba(0,0,0,.54);opacity:0}#toggle-drawer:checked~.overlay,.toggle-drawer .overlay{opacity:1}.header{box-shadow:0 1.5px 3px rgba(0,0,0,.24),0 3px 8px rgba(0,0,0,.05);background:#e84e40;color:#fff}.ios.standalone .header:before{background:rgba(0,0,0,.12)}.bar .path{color:hsla(0,0%,100%,.7)}.button .icon{border-radius:100%}.button .icon:active{background:hsla(0,0%,100%,.12)}html{height:100%}body{position:relative;min-height:100%}hr{display:block;height:1px;padding:0;margin:0}.locked{height:100%;overflow:hidden}.scrollable{position:absolute;top:0;right:0;bottom:0;left:0;overflow:auto;-webkit-overflow-scrolling:touch}.scrollable .wrapper{height:100%}.ios .scrollable .wrapper{margin-bottom:2px}.toggle{display:none}.toggle-button{display:block}.backdrop{position:absolute;top:0;right:0;bottom:0;left:0;z-index:-1}.backdrop-paper{max-width:1200px;height:100%;margin-left:auto;margin-right:auto}.backdrop-paper:after{content:" ";display:block;height:100%;margin-left:262px}.overlay{width:0;height:0;z-index:3}.header,.overlay{position:fixed;top:0}.header{-webkit-user-select:none;-moz-user-select:none;-ms-user-select:none;user-select:none;left:0;z-index:2;height:56px;padding:4px;overflow:hidden}.ios.standalone .header{position:absolute}.bar{display:table;max-width:1184px;margin-left:auto;margin-right:auto}.bar a{display:block}.no-js .bar .button-search{display:none}.bar .path .icon:before{vertical-align:-1.5px}.button{display:table-cell;vertical-align:top;width:1%}.button button{margin:0;padding:0}.button button:active:before{position:relative;top:0;left:0}.button .icon{display:inline-block;font-size:24px;padding:8px;margin:4px}.stretch{display:table;table-layout:fixed;width:100%}.header .stretch{padding:0 20px}.stretch .title{display:table-cell;overflow:hidden;white-space:nowrap;text-overflow:ellipsis}.header .stretch .title{font-size:18px;padding:13px 0}.main{max-width:1200px;margin-left:auto;margin-right:auto}body,input{font-weight:400;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.no-fontface body,.no-fontface input,body,input{font-family:Helvetica Neue,Helvetica,Arial,sans-serif}.no-fontface code,.no-fontface kbd,.no-fontface pre,code,kbd,pre{font-family:Courier New,Courier,monospace}#toggle-drawer:checked~.main .drawer,.toggle-drawer .drawer{-webkit-transform:translateZ(0);transform:translateZ(0)}.no-csstransforms3d #toggle-drawer:checked~.main .drawer,.no-csstransforms3d .toggle-drawer .drawer{display:block}.project{-webkit-transition:none;transition:none}.project .logo img{-webkit-transition:box-shadow .4s;transition:box-shadow .4s}.repo a{-webkit-transition:box-shadow .4s,opacity .4s;transition:box-shadow .4s,opacity .4s}.drawer .toc a.current,.drawer .toc a:focus,.drawer .toc a:hover{color:#e84e40}.drawer .anchor a{border-left:2px solid #e84e40}.drawer .section{color:rgba(0,0,0,.54)}.ios.standalone .project:before{background:rgba(0,0,0,.12)}.project .logo img{background:#fff;border-radius:100%}.project:focus .logo img,.project:hover .logo img{box-shadow:0 4px 7px rgba(0,0,0,.23),0 8px 25px rgba(0,0,0,.05)}.repo a{background:#00bfa5;color:#fff;border-radius:3px}.repo a:focus,.repo a:hover{box-shadow:0 4px 7px rgba(0,0,0,.23),0 8px 25px rgba(0,0,0,.05);opacity:.8}.repo a .count{background:rgba(0,0,0,.26);color:#fff;border-radius:0 3px 3px 0}.repo a .count:before{border-width:15px 5px 15px 0;border-color:transparent rgba(0,0,0,.26);border-style:solid}.drawer{width:262px;font-size:13px;line-height:1em}.ios .drawer{overflow:scroll;-webkit-overflow-scrolling:touch}.drawer .toc li a{display:block;padding:14.5px 24px;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}.drawer .toc li.anchor a{margin-left:12px;padding:10px 24px 10px 12px}.drawer .toc li ul{margin-left:12px}.drawer .current+ul{margin-bottom:9px}.drawer .section{display:block;padding:14.5px 24px}.drawer .scrollable{top:104px;z-index:-1}.drawer .scrollable .wrapper{height:auto;min-height:100%}.drawer .scrollable .wrapper hr{margin:12px 0;margin-right:auto}.drawer .scrollable .wrapper .toc{margin:12px 0}.project{display:block}.project .banner{display:table;width:100%;height:104px;padding:20px}.project .logo{display:table-cell;width:64px;padding-right:12px}.project .logo img{display:block;width:64px;height:64px}.project .name{display:table-cell;padding-left:4px;font-size:14px;line-height:1.25em;vertical-align:middle}.project .logo+.name{font-size:12px}.repo{margin:24px 0;text-align:center}.repo li{display:inline-block;padding-right:12px;white-space:nowrap}.repo li:last-child{padding-right:0}.repo a{display:inline-block;padding:0 10px 0 6px;font-size:12px;line-height:30px;height:30px}.repo a .icon{font-size:18px;vertical-align:-3px}.repo a .count{display:inline-block;position:relative;padding:0 8px 0 4px;margin:0 -10px 0 8px;font-size:12px}.repo a .count:before{content:" ";display:block;position:absolute;top:0;left:-5px}.no-js .repo a .count{display:none}.drawer .toc li a{font-weight:700}.drawer .toc li.anchor a{font-weight:400}.drawer .section,.repo a{font-weight:700}.repo a{text-transform:uppercase}.repo a .count{text-transform:none;font-weight:700}pre span{-webkit-transition:color .25s;transition:color .25s}.copyright a{-webkit-transition:color .25s;transition:color .25s}.ios.standalone .article{background:-webkit-linear-gradient(top,#fff 50%,#e84e40 0);background:linear-gradient(180deg,#fff 50%,#e84e40 0)}.ios.standalone .article .wrapper{background:-webkit-linear-gradient(top,#fff 50%,#fff 0);background:linear-gradient(180deg,#fff 50%,#fff 0)}.article a,.article h1,.article h2{color:#e84e40}.article code{background:#eee}.article kbd{color:#555;background-color:#fcfcfc;border:1px solid #ccc;border-bottom-color:#bbb;border-radius:3px;box-shadow:inset 0 -1px 0 #bbb}.article h1{border-bottom:1px solid rgba(0,0,0,.12)}.article a{border-bottom:1px dotted}.article a:focus,.article a:hover{color:#00bfa5}.article .headerlink{color:rgba(0,0,0,.26);border:none}.article table{box-shadow:0 1.5px 3px rgba(0,0,0,.24),0 3px 8px rgba(0,0,0,.05);border-radius:3px}.article table th{background:#ee7a70;color:#fff}.article table td{border-top:1px solid rgba(0,0,0,.05)}.article blockquote{border-left:2px solid rgba(0,0,0,.54);color:rgba(0,0,0,.54)}.footer{background:#e84e40;color:#fff}.footer a{border:none}.copyright{color:rgba(0,0,0,.54)}.pagination a .button,.pagination a .title{color:#fff}.pagination .direction{color:hsla(0,0%,100%,.7)}.admonition{background:#29b6f6;color:#fff}.admonition pre{background:hsla(0,0%,100%,.3)}.admonition.warning{background:#e84e40}.admonition a,.admonition a:hover{color:#fff}.article{font-size:14px;line-height:1.7em}.article:after{content:" ";display:block;clear:both}.article .wrapper{padding:116px 16px 92px}.ios.standalone .article{position:absolute;top:56px;right:0;bottom:0;left:0;overflow:auto;-webkit-overflow-scrolling:touch}.ios.standalone .article .wrapper{position:relative;min-height:100%;padding-top:60px;margin-bottom:2px}.article h1{font-size:24px;line-height:1.333334em;padding:20px 0 42px}.article h2{font-size:20px;line-height:1.4em;padding-top:92px;margin-top:-56px}.ios.standalone .article h2{padding-top:36px;margin:0}.article h3,.article h4{font-size:14px;padding-top:76px;margin-top:-56px}.ios.standalone .article h3,.ios.standalone .article h4{padding-top:20px;margin-top:0}.article .headerlink{float:right;margin-left:20px;font-size:14px}h1 .article .headerlink{display:none}.article ol,.article p,.article ul{margin-top:1.5em}.article li,.article li ol,.article li ul{margin-top:.75em}.article li{margin-left:18px}.article li p{display:inline}.article ul>li:before{content:"\e602";display:block;float:left;font-family:Icon;font-size:16px;width:1.2em;margin-left:-1.2em;vertical-align:-.1em}.article p>code{white-space:nowrap;padding:2px 4px}.article kbd{display:inline-block;padding:3px 5px;line-height:10px}.article hr{margin-top:1.5em}.article img{max-width:100%}.article pre{padding:16px;margin:1.5em -16px 0;line-height:1.5em;overflow:auto;-webkit-overflow-scrolling:touch}.article table{margin:3em 0 1.5em;font-size:13px;overflow:hidden}.no-js .article table{display:inline-block;max-width:100%;overflow:auto;-webkit-overflow-scrolling:touch}.article table th{min-width:100px;font-size:12px;text-align:left}.article table td,.article table th{padding:12px 16px;vertical-align:top}.article blockquote{padding-left:16px}.article .data{margin:1.5em -16px;padding:1.5em 0;overflow:auto;-webkit-overflow-scrolling:touch;text-align:center}.article .data table{display:inline-block;margin:0 16px;text-align:left}.footer{position:absolute;bottom:0;left:0;right:0;padding:0 4px}.copyright{margin:1.5em 0}.pagination{max-width:1184px;height:92px;padding:4px 0;margin-left:auto;margin-right:auto;overflow:hidden}.pagination a{display:block;height:100%}.pagination .next,.pagination .previous{position:relative;float:left;height:100%}.pagination .previous{width:25%}.pagination .previous .direction,.pagination .previous .stretch{display:none}.pagination .next{width:75%;text-align:right}.pagination .page{display:table;position:absolute;bottom:4px}.pagination .direction{display:block;position:absolute;bottom:40px;width:100%;font-size:15px;line-height:20px;padding:0 52px}.pagination .stretch{padding:0 4px}.pagination .stretch .title{font-size:18px;padding:11px 0 13px}.admonition{margin:20px -16px 0;padding:20px 16px}.admonition>:first-child{margin-top:0}.admonition .admonition-title{font-size:20px}.admonition .admonition-title:before{content:"\e611";display:block;float:left;font-family:Icon;font-size:24px;vertical-align:-.1em;margin-right:5px}.admonition.warning .admonition-title:before{content:"\e610"}.article h3{font-weight:700}.article h4{font-weight:400;font-style:italic}.article h2 a,.article h3 a,.article h4 a,.article h5 a,.article h6 a{font-weight:400;font-style:normal}.bar{-webkit-transform:translateZ(0);transform:translateZ(0);-webkit-transition:opacity .2s cubic-bezier(.75,0,.25,1),-webkit-transform .4s cubic-bezier(.75,0,.25,1);transition:opacity .2s cubic-bezier(.75,0,.25,1),-webkit-transform .4s cubic-bezier(.75,0,.25,1);transition:opacity .2s cubic-bezier(.75,0,.25,1),transform .4s cubic-bezier(.75,0,.25,1);transition:opacity .2s cubic-bezier(.75,0,.25,1),transform .4s cubic-bezier(.75,0,.25,1),-webkit-transform .4s cubic-bezier(.75,0,.25,1)}#toggle-search:checked~.header .bar,.toggle-search .bar{-webkit-transform:translate3d(0,-56px,0);transform:translate3d(0,-56px,0)}.bar.search .button-reset{-webkit-transform:scale(.5);transform:scale(.5);-webkit-transition:opacity .4s cubic-bezier(.1,.7,.1,1),-webkit-transform .4s cubic-bezier(.1,.7,.1,1);transition:opacity .4s cubic-bezier(.1,.7,.1,1),-webkit-transform .4s cubic-bezier(.1,.7,.1,1);transition:opacity .4s cubic-bezier(.1,.7,.1,1),transform .4s cubic-bezier(.1,.7,.1,1);transition:opacity .4s cubic-bezier(.1,.7,.1,1),transform .4s cubic-bezier(.1,.7,.1,1),-webkit-transform .4s cubic-bezier(.1,.7,.1,1);opacity:0}.bar.search.non-empty .button-reset{-webkit-transform:scale(1);transform:scale(1);opacity:1}.results{-webkit-transition:opacity .3s .1s,width 0s .4s,height 0s .4s;transition:opacity .3s .1s,width 0s .4s,height 0s .4s}#toggle-search:checked~.main .results,.toggle-search .results{-webkit-transition:opacity .4s,width 0s,height 0s;transition:opacity .4s,width 0s,height 0s}.results .list a{-webkit-transition:background .25s;transition:background .25s}.no-csstransforms3d .bar.default{display:table}.no-csstransforms3d .bar.search{display:none;margin-top:0}.no-csstransforms3d #toggle-search:checked~.header .bar.default,.no-csstransforms3d .toggle-search .bar.default{display:none}.no-csstransforms3d #toggle-search:checked~.header .bar.search,.no-csstransforms3d .toggle-search .bar.search{display:table}.bar.search{opacity:0}.bar.search .query{background:transparent;color:rgba(0,0,0,.87)}.bar.search .query::-webkit-input-placeholder{color:rgba(0,0,0,.26)}.bar.search .query:-moz-placeholder,.bar.search .query::-moz-placeholder{color:rgba(0,0,0,.26)}.bar.search .query:-ms-input-placeholder{color:rgba(0,0,0,.26)}.bar.search .button .icon:active{background:rgba(0,0,0,.12)}.results{box-shadow:0 4px 7px rgba(0,0,0,.23),0 8px 25px rgba(0,0,0,.05);background:#fff;color:rgba(0,0,0,.87);opacity:0}#toggle-search:checked~.main .results,.toggle-search .results{opacity:1}.results .meta{background:#e84e40;color:#fff}.results .list a{border-bottom:1px solid rgba(0,0,0,.12)}.results .list a:last-child{border-bottom:none}.results .list a:active{background:rgba(0,0,0,.12)}.result span{color:rgba(0,0,0,.54)}#toggle-search:checked~.header,.toggle-search .header{background:#fff;color:rgba(0,0,0,.54)}#toggle-search:checked~.header:before,.toggle-search .header:before{background:rgba(0,0,0,.54)}#toggle-search:checked~.header .bar.default,.toggle-search .header .bar.default{opacity:0}#toggle-search:checked~.header .bar.search,.toggle-search .header .bar.search{opacity:1}.bar.search{margin-top:8px}.bar.search .query{font-size:18px;padding:13px 0;margin:0;width:100%;height:48px}.bar.search .query::-ms-clear{display:none}.results{position:fixed;top:0;left:0;width:0;height:100%;z-index:1;overflow-y:scroll;-webkit-overflow-scrolling:touch}.results .scrollable{top:56px}#toggle-search:checked~.main .results,.toggle-search .results{width:100%;overflow-y:visible}.results .meta{font-weight:700}.results .meta strong{display:block;font-size:11px;max-width:1200px;margin-left:auto;margin-right:auto;padding:16px}.results .list a{display:block}.result{max-width:1200px;margin-left:auto;margin-right:auto;padding:12px 16px 16px}.result h1{line-height:24px}.result h1,.result span{text-overflow:ellipsis;white-space:nowrap;overflow:hidden}.result span{font-size:12px}.no-csstransforms3d .results{display:none}.no-csstransforms3d #toggle-search:checked~.main .results,.no-csstransforms3d .toggle-search .results{display:block;overflow:auto}.meta{text-transform:uppercase;font-weight:700}@media only screen and (min-width:960px){.backdrop{background:#f2f2f2}.backdrop-paper:after{box-shadow:0 1.5px 3px rgba(0,0,0,.24),0 3px 8px rgba(0,0,0,.05)}.button-menu{display:none}.drawer{float:left;height:auto;margin-bottom:96px;padding-top:80px}.drawer,.drawer .scrollable{position:static}.article{margin-left:262px}.footer{z-index:4}.copyright{margin-bottom:64px}.results{height:auto;top:64px}.results .scrollable{position:static;max-height:413px}}@media only screen and (max-width:959px){#toggle-drawer:checked~.overlay,.toggle-drawer .overlay{width:100%;height:100%}.drawer{-webkit-transform:translate3d(-262px,0,0);transform:translate3d(-262px,0,0);-webkit-transition:-webkit-transform .25s cubic-bezier(.4,0,.2,1);transition:-webkit-transform .25s cubic-bezier(.4,0,.2,1);transition:transform .25s cubic-bezier(.4,0,.2,1);transition:transform .25s cubic-bezier(.4,0,.2,1),-webkit-transform .25s cubic-bezier(.4,0,.2,1)}.no-csstransforms3d .drawer{display:none}.drawer{background:#fff}.project{box-shadow:0 1.5px 3px rgba(0,0,0,.24),0 3px 8px rgba(0,0,0,.05);background:#e84e40;color:#fff}.drawer{position:fixed;z-index:4}#toggle-search:checked~.main .results,.drawer,.toggle-search .results{height:100%}}@media only screen and (min-width:720px){.header{height:64px;padding:8px}.header .stretch{padding:0 16px}.header .stretch .title{font-size:20px;padding:12px 0}.project .name{margin:26px 0 0 5px}.article .wrapper{padding:128px 24px 96px}.article .data{margin:1.5em -24px}.article .data table{margin:0 24px}.article h2{padding-top:100px;margin-top:-64px}.ios.standalone .article h2{padding-top:28px;margin-top:8px}.article h3,.article h4{padding-top:84px;margin-top:-64px}.ios.standalone .article h3,.ios.standalone .article h4{padding-top:20px;margin-top:0}.article pre{padding:1.5em 24px;margin:1.5em -24px 0}.footer{padding:0 8px}.pagination{height:96px;padding:8px 0}.pagination .direction{padding:0 56px;bottom:40px}.pagination .stretch{padding:0 8px}.admonition{margin:20px -24px 0;padding:20px 24px}.bar.search .query{font-size:20px;padding:12px 0}.results .scrollable{top:64px}.results .meta strong{padding:16px 24px}.result{padding:16px 24px 20px}}@media only screen and (min-width:1200px){.header{width:100%}.drawer .scrollable .wrapper hr{width:48px}}@media only screen and (orientation:portrait){.ios.standalone .header{height:76px;padding-top:24px}.ios.standalone .header:before{content:" ";position:absolute;top:0;left:0;z-index:3;width:100%;height:20px}.ios.standalone .drawer .scrollable{top:124px}.ios.standalone .project{padding-top:20px}.ios.standalone .project:before{content:" ";position:absolute;top:0;left:0;z-index:3;width:100%;height:20px}.ios.standalone .article{position:absolute;top:76px;right:0;bottom:0;left:0}.ios.standalone .results .scrollable{top:76px}}@media only screen and (orientation:portrait) and (min-width:720px){.ios.standalone .header{height:84px;padding-top:28px}.ios.standalone .results .scrollable{top:84px}}@media only screen and (max-width:719px){.bar .path{display:none}}@media only screen and (max-width:479px){.button-github,.button-twitter{display:none}}@media only screen and (min-width:720px) and (max-width:959px){.header .stretch{padding:0 24px}}@media only screen and (min-width:480px){.pagination .next,.pagination .previous{width:50%}.pagination .previous .direction{display:block}.pagination .previous .stretch{display:table}}@media print{.drawer,.footer,.header,.headerlink{display:none}.article .wrapper{padding-top:0}.article pre,.article pre *{color:rgba(0,0,0,.87)!important}.article pre{border:1px solid rgba(0,0,0,.12)}.article table{border-radius:none;box-shadow:none}.article table th{color:#e84e40}}
diff --git a/stylesheets/highlight/highlight.css b/stylesheets/highlight/highlight.css
new file mode 100644
index 0000000..2475d12
--- /dev/null
+++ b/stylesheets/highlight/highlight.css
@@ -0,0 +1,105 @@
+/*
+ * overwrite the current primary color of the
+ * theme that is used as fallback in codeblocks
+ */
+.article pre code {
+ color: rgba(0, 0, 0, 0.8) !important;
+}
+
+
+/*
+ HIGHLIGHT.JS THEME
+
+ tweaked version of the Github theme
+*/
+
+.hljs {
+display:block;
+overflow-x:auto;
+}
+
+.hljs-comment,
+.hljs-quote {
+color:#998;
+font-style:italic;
+}
+
+.hljs-keyword,
+.hljs-selector-tag,
+.hljs-subst {
+color:#333;
+font-weight:700;
+}
+
+.hljs-number,
+.hljs-literal,
+.hljs-variable,
+.hljs-template-variable,
+.hljs-tag .hljs-attr {
+color:teal;
+}
+
+.hljs-string,
+.hljs-doctag {
+color:#d14;
+}
+
+.hljs-title,
+.hljs-section,
+.hljs-selector-id {
+color:#900;
+font-weight:700;
+}
+
+.hljs-subst {
+font-weight:400;
+}
+
+.hljs-type,
+.hljs-class .hljs-title {
+color:#458;
+font-weight:700;
+}
+
+.hljs-tag,
+.hljs-name,
+.hljs-attribute {
+color:navy;
+font-weight:400;
+}
+
+.hljs-regexp,
+.hljs-link {
+color:#009926;
+}
+
+.hljs-symbol,
+.hljs-bullet {
+color:#990073;
+}
+
+.hljs-built_in,
+.hljs-builtin-name {
+color:#0086b3;
+}
+
+.hljs-meta {
+color:#999;
+font-weight:700;
+}
+
+.hljs-deletion {
+background:#fdd;
+}
+
+.hljs-addition {
+background:#dfd;
+}
+
+.hljs-emphasis {
+font-style:italic;
+}
+
+.hljs-strong {
+font-weight:700;
+}
diff --git a/stylesheets/palettes.css b/stylesheets/palettes.css
new file mode 100644
index 0000000..97440f5
--- /dev/null
+++ b/stylesheets/palettes.css
@@ -0,0 +1 @@
+@supports (-webkit-appearance:none){.palette-primary-red{background:#e84e40}}.palette-primary-red .footer,.palette-primary-red .header{background:#e84e40}.palette-primary-red .drawer .toc a.current,.palette-primary-red .drawer .toc a:focus,.palette-primary-red .drawer .toc a:hover{color:#e84e40}.palette-primary-red .drawer .anchor a{border-left:2px solid #e84e40}.ios.standalone .palette-primary-red .article{background:-webkit-linear-gradient(top,#fff 50%,#e84e40 0);background:linear-gradient(180deg,#fff 50%,#e84e40 0)}.palette-primary-red .article a,.palette-primary-red .article code,.palette-primary-red .article h1,.palette-primary-red .article h2{color:#e84e40}.palette-primary-red .article .headerlink{color:rgba(0,0,0,.26)}.palette-primary-red .article table th{background:#ee7a70}.palette-primary-red .results .meta{background:#e84e40}@supports (-webkit-appearance:none){.palette-primary-pink{background:#e91e63}}.palette-primary-pink .footer,.palette-primary-pink .header{background:#e91e63}.palette-primary-pink .drawer .toc a.current,.palette-primary-pink .drawer .toc a:focus,.palette-primary-pink .drawer .toc a:hover{color:#e91e63}.palette-primary-pink .drawer .anchor a{border-left:2px solid #e91e63}.ios.standalone .palette-primary-pink .article{background:-webkit-linear-gradient(top,#fff 50%,#e91e63 0);background:linear-gradient(180deg,#fff 50%,#e91e63 0)}.palette-primary-pink .article a,.palette-primary-pink .article code,.palette-primary-pink .article h1,.palette-primary-pink .article h2{color:#e91e63}.palette-primary-pink .article .headerlink{color:rgba(0,0,0,.26)}.palette-primary-pink .article table th{background:#ef568a}.palette-primary-pink .results .meta{background:#e91e63}@supports (-webkit-appearance:none){.palette-primary-purple{background:#ab47bc}}.palette-primary-purple .footer,.palette-primary-purple .header{background:#ab47bc}.palette-primary-purple .drawer .toc a.current,.palette-primary-purple .drawer .toc a:focus,.palette-primary-purple .drawer .toc a:hover{color:#ab47bc}.palette-primary-purple .drawer .anchor a{border-left:2px solid #ab47bc}.ios.standalone .palette-primary-purple .article{background:-webkit-linear-gradient(top,#fff 50%,#ab47bc 0);background:linear-gradient(180deg,#fff 50%,#ab47bc 0)}.palette-primary-purple .article a,.palette-primary-purple .article code,.palette-primary-purple .article h1,.palette-primary-purple .article h2{color:#ab47bc}.palette-primary-purple .article .headerlink{color:rgba(0,0,0,.26)}.palette-primary-purple .article table th{background:#c075cd}.palette-primary-purple .results .meta{background:#ab47bc}@supports (-webkit-appearance:none){.palette-primary-deep-purple{background:#7e57c2}}.palette-primary-deep-purple .footer,.palette-primary-deep-purple .header{background:#7e57c2}.palette-primary-deep-purple .drawer .toc a.current,.palette-primary-deep-purple .drawer .toc a:focus,.palette-primary-deep-purple .drawer .toc a:hover{color:#7e57c2}.palette-primary-deep-purple .drawer .anchor a{border-left:2px solid #7e57c2}.ios.standalone .palette-primary-deep-purple .article{background:-webkit-linear-gradient(top,#fff 50%,#7e57c2 0);background:linear-gradient(180deg,#fff 50%,#7e57c2 0)}.palette-primary-deep-purple .article a,.palette-primary-deep-purple .article code,.palette-primary-deep-purple .article h1,.palette-primary-deep-purple .article h2{color:#7e57c2}.palette-primary-deep-purple .article .headerlink{color:rgba(0,0,0,.26)}.palette-primary-deep-purple .article table th{background:#9e81d1}.palette-primary-deep-purple .results .meta{background:#7e57c2}@supports (-webkit-appearance:none){.palette-primary-indigo{background:#3f51b5}}.palette-primary-indigo .footer,.palette-primary-indigo .header{background:#3f51b5}.palette-primary-indigo .drawer .toc a.current,.palette-primary-indigo .drawer .toc a:focus,.palette-primary-indigo .drawer .toc a:hover{color:#3f51b5}.palette-primary-indigo .drawer .anchor a{border-left:2px solid #3f51b5}.ios.standalone .palette-primary-indigo .article{background:-webkit-linear-gradient(top,#fff 50%,#3f51b5 0);background:linear-gradient(180deg,#fff 50%,#3f51b5 0)}.palette-primary-indigo .article a,.palette-primary-indigo .article code,.palette-primary-indigo .article h1,.palette-primary-indigo .article h2{color:#3f51b5}.palette-primary-indigo .article .headerlink{color:rgba(0,0,0,.26)}.palette-primary-indigo .article table th{background:#6f7dc8}.palette-primary-indigo .results .meta{background:#3f51b5}@supports (-webkit-appearance:none){.palette-primary-blue{background:#5677fc}}.palette-primary-blue .footer,.palette-primary-blue .header{background:#5677fc}.palette-primary-blue .drawer .toc a.current,.palette-primary-blue .drawer .toc a:focus,.palette-primary-blue .drawer .toc a:hover{color:#5677fc}.palette-primary-blue .drawer .anchor a{border-left:2px solid #5677fc}.ios.standalone .palette-primary-blue .article{background:-webkit-linear-gradient(top,#fff 50%,#5677fc 0);background:linear-gradient(180deg,#fff 50%,#5677fc 0)}.palette-primary-blue .article a,.palette-primary-blue .article code,.palette-primary-blue .article h1,.palette-primary-blue .article h2{color:#5677fc}.palette-primary-blue .article .headerlink{color:rgba(0,0,0,.26)}.palette-primary-blue .article table th{background:#8099fd}.palette-primary-blue .results .meta{background:#5677fc}@supports (-webkit-appearance:none){.palette-primary-light-blue{background:#03a9f4}}.palette-primary-light-blue .footer,.palette-primary-light-blue .header{background:#03a9f4}.palette-primary-light-blue .drawer .toc a.current,.palette-primary-light-blue .drawer .toc a:focus,.palette-primary-light-blue .drawer .toc a:hover{color:#03a9f4}.palette-primary-light-blue .drawer .anchor a{border-left:2px solid #03a9f4}.ios.standalone .palette-primary-light-blue .article{background:-webkit-linear-gradient(top,#fff 50%,#03a9f4 0);background:linear-gradient(180deg,#fff 50%,#03a9f4 0)}.palette-primary-light-blue .article a,.palette-primary-light-blue .article code,.palette-primary-light-blue .article h1,.palette-primary-light-blue .article h2{color:#03a9f4}.palette-primary-light-blue .article .headerlink{color:rgba(0,0,0,.26)}.palette-primary-light-blue .article table th{background:#42bff7}.palette-primary-light-blue .results .meta{background:#03a9f4}@supports (-webkit-appearance:none){.palette-primary-cyan{background:#00bcd4}}.palette-primary-cyan .footer,.palette-primary-cyan .header{background:#00bcd4}.palette-primary-cyan .drawer .toc a.current,.palette-primary-cyan .drawer .toc a:focus,.palette-primary-cyan .drawer .toc a:hover{color:#00bcd4}.palette-primary-cyan .drawer .anchor a{border-left:2px solid #00bcd4}.ios.standalone .palette-primary-cyan .article{background:-webkit-linear-gradient(top,#fff 50%,#00bcd4 0);background:linear-gradient(180deg,#fff 50%,#00bcd4 0)}.palette-primary-cyan .article a,.palette-primary-cyan .article code,.palette-primary-cyan .article h1,.palette-primary-cyan .article h2{color:#00bcd4}.palette-primary-cyan .article .headerlink{color:rgba(0,0,0,.26)}.palette-primary-cyan .article table th{background:#40cddf}.palette-primary-cyan .results .meta{background:#00bcd4}@supports (-webkit-appearance:none){.palette-primary-teal{background:#009688}}.palette-primary-teal .footer,.palette-primary-teal .header{background:#009688}.palette-primary-teal .drawer .toc a.current,.palette-primary-teal .drawer .toc a:focus,.palette-primary-teal .drawer .toc a:hover{color:#009688}.palette-primary-teal .drawer .anchor a{border-left:2px solid #009688}.ios.standalone .palette-primary-teal .article{background:-webkit-linear-gradient(top,#fff 50%,#009688 0);background:linear-gradient(180deg,#fff 50%,#009688 0)}.palette-primary-teal .article a,.palette-primary-teal .article code,.palette-primary-teal .article h1,.palette-primary-teal .article h2{color:#009688}.palette-primary-teal .article .headerlink{color:rgba(0,0,0,.26)}.palette-primary-teal .article table th{background:#40b0a6}.palette-primary-teal .results .meta{background:#009688}@supports (-webkit-appearance:none){.palette-primary-green{background:#259b24}}.palette-primary-green .footer,.palette-primary-green .header{background:#259b24}.palette-primary-green .drawer .toc a.current,.palette-primary-green .drawer .toc a:focus,.palette-primary-green .drawer .toc a:hover{color:#259b24}.palette-primary-green .drawer .anchor a{border-left:2px solid #259b24}.ios.standalone .palette-primary-green .article{background:-webkit-linear-gradient(top,#fff 50%,#259b24 0);background:linear-gradient(180deg,#fff 50%,#259b24 0)}.palette-primary-green .article a,.palette-primary-green .article code,.palette-primary-green .article h1,.palette-primary-green .article h2{color:#259b24}.palette-primary-green .article .headerlink{color:rgba(0,0,0,.26)}.palette-primary-green .article table th{background:#5cb45b}.palette-primary-green .results .meta{background:#259b24}@supports (-webkit-appearance:none){.palette-primary-light-green{background:#7cb342}}.palette-primary-light-green .footer,.palette-primary-light-green .header{background:#7cb342}.palette-primary-light-green .drawer .toc a.current,.palette-primary-light-green .drawer .toc a:focus,.palette-primary-light-green .drawer .toc a:hover{color:#7cb342}.palette-primary-light-green .drawer .anchor a{border-left:2px solid #7cb342}.ios.standalone .palette-primary-light-green .article{background:-webkit-linear-gradient(top,#fff 50%,#7cb342 0);background:linear-gradient(180deg,#fff 50%,#7cb342 0)}.palette-primary-light-green .article a,.palette-primary-light-green .article code,.palette-primary-light-green .article h1,.palette-primary-light-green .article h2{color:#7cb342}.palette-primary-light-green .article .headerlink{color:rgba(0,0,0,.26)}.palette-primary-light-green .article table th{background:#9dc671}.palette-primary-light-green .results .meta{background:#7cb342}@supports (-webkit-appearance:none){.palette-primary-lime{background:#c0ca33}}.palette-primary-lime .footer,.palette-primary-lime .header{background:#c0ca33}.palette-primary-lime .drawer .toc a.current,.palette-primary-lime .drawer .toc a:focus,.palette-primary-lime .drawer .toc a:hover{color:#c0ca33}.palette-primary-lime .drawer .anchor a{border-left:2px solid #c0ca33}.ios.standalone .palette-primary-lime .article{background:-webkit-linear-gradient(top,#fff 50%,#c0ca33 0);background:linear-gradient(180deg,#fff 50%,#c0ca33 0)}.palette-primary-lime .article a,.palette-primary-lime .article code,.palette-primary-lime .article h1,.palette-primary-lime .article h2{color:#c0ca33}.palette-primary-lime .article .headerlink{color:rgba(0,0,0,.26)}.palette-primary-lime .article table th{background:#d0d766}.palette-primary-lime .results .meta{background:#c0ca33}@supports (-webkit-appearance:none){.palette-primary-yellow{background:#f9a825}}.palette-primary-yellow .footer,.palette-primary-yellow .header{background:#f9a825}.palette-primary-yellow .drawer .toc a.current,.palette-primary-yellow .drawer .toc a:focus,.palette-primary-yellow .drawer .toc a:hover{color:#f9a825}.palette-primary-yellow .drawer .anchor a{border-left:2px solid #f9a825}.ios.standalone .palette-primary-yellow .article{background:-webkit-linear-gradient(top,#fff 50%,#f9a825 0);background:linear-gradient(180deg,#fff 50%,#f9a825 0)}.palette-primary-yellow .article a,.palette-primary-yellow .article code,.palette-primary-yellow .article h1,.palette-primary-yellow .article h2{color:#f9a825}.palette-primary-yellow .article .headerlink{color:rgba(0,0,0,.26)}.palette-primary-yellow .article table th{background:#fbbe5c}.palette-primary-yellow .results .meta{background:#f9a825}@supports (-webkit-appearance:none){.palette-primary-amber{background:#ffb300}}.palette-primary-amber .footer,.palette-primary-amber .header{background:#ffb300}.palette-primary-amber .drawer .toc a.current,.palette-primary-amber .drawer .toc a:focus,.palette-primary-amber .drawer .toc a:hover{color:#ffb300}.palette-primary-amber .drawer .anchor a{border-left:2px solid #ffb300}.ios.standalone .palette-primary-amber .article{background:-webkit-linear-gradient(top,#fff 50%,#ffb300 0);background:linear-gradient(180deg,#fff 50%,#ffb300 0)}.palette-primary-amber .article a,.palette-primary-amber .article code,.palette-primary-amber .article h1,.palette-primary-amber .article h2{color:#ffb300}.palette-primary-amber .article .headerlink{color:rgba(0,0,0,.26)}.palette-primary-amber .article table th{background:#ffc640}.palette-primary-amber .results .meta{background:#ffb300}@supports (-webkit-appearance:none){.palette-primary-orange{background:#fb8c00}}.palette-primary-orange .footer,.palette-primary-orange .header{background:#fb8c00}.palette-primary-orange .drawer .toc a.current,.palette-primary-orange .drawer .toc a:focus,.palette-primary-orange .drawer .toc a:hover{color:#fb8c00}.palette-primary-orange .drawer .anchor a{border-left:2px solid #fb8c00}.ios.standalone .palette-primary-orange .article{background:-webkit-linear-gradient(top,#fff 50%,#fb8c00 0);background:linear-gradient(180deg,#fff 50%,#fb8c00 0)}.palette-primary-orange .article a,.palette-primary-orange .article code,.palette-primary-orange .article h1,.palette-primary-orange .article h2{color:#fb8c00}.palette-primary-orange .article .headerlink{color:rgba(0,0,0,.26)}.palette-primary-orange .article table th{background:#fca940}.palette-primary-orange .results .meta{background:#fb8c00}@supports (-webkit-appearance:none){.palette-primary-deep-orange{background:#ff7043}}.palette-primary-deep-orange .footer,.palette-primary-deep-orange .header{background:#ff7043}.palette-primary-deep-orange .drawer .toc a.current,.palette-primary-deep-orange .drawer .toc a:focus,.palette-primary-deep-orange .drawer .toc a:hover{color:#ff7043}.palette-primary-deep-orange .drawer .anchor a{border-left:2px solid #ff7043}.ios.standalone .palette-primary-deep-orange .article{background:-webkit-linear-gradient(top,#fff 50%,#ff7043 0);background:linear-gradient(180deg,#fff 50%,#ff7043 0)}.palette-primary-deep-orange .article a,.palette-primary-deep-orange .article code,.palette-primary-deep-orange .article h1,.palette-primary-deep-orange .article h2{color:#ff7043}.palette-primary-deep-orange .article .headerlink{color:rgba(0,0,0,.26)}.palette-primary-deep-orange .article table th{background:#ff9472}.palette-primary-deep-orange .results .meta{background:#ff7043}@supports (-webkit-appearance:none){.palette-primary-brown{background:#795548}}.palette-primary-brown .footer,.palette-primary-brown .header{background:#795548}.palette-primary-brown .drawer .toc a.current,.palette-primary-brown .drawer .toc a:focus,.palette-primary-brown .drawer .toc a:hover{color:#795548}.palette-primary-brown .drawer .anchor a{border-left:2px solid #795548}.ios.standalone .palette-primary-brown .article{background:-webkit-linear-gradient(top,#fff 50%,#795548 0);background:linear-gradient(180deg,#fff 50%,#795548 0)}.palette-primary-brown .article a,.palette-primary-brown .article code,.palette-primary-brown .article h1,.palette-primary-brown .article h2{color:#795548}.palette-primary-brown .article .headerlink{color:rgba(0,0,0,.26)}.palette-primary-brown .article table th{background:#9b8076}.palette-primary-brown .results .meta{background:#795548}@supports (-webkit-appearance:none){.palette-primary-grey{background:#757575}}.palette-primary-grey .footer,.palette-primary-grey .header{background:#757575}.palette-primary-grey .drawer .toc a.current,.palette-primary-grey .drawer .toc a:focus,.palette-primary-grey .drawer .toc a:hover{color:#757575}.palette-primary-grey .drawer .anchor a{border-left:2px solid #757575}.ios.standalone .palette-primary-grey .article{background:-webkit-linear-gradient(top,#fff 50%,#757575 0);background:linear-gradient(180deg,#fff 50%,#757575 0)}.palette-primary-grey .article a,.palette-primary-grey .article code,.palette-primary-grey .article h1,.palette-primary-grey .article h2{color:#757575}.palette-primary-grey .article .headerlink{color:rgba(0,0,0,.26)}.palette-primary-grey .article table th{background:#989898}.palette-primary-grey .results .meta{background:#757575}@supports (-webkit-appearance:none){.palette-primary-blue-grey{background:#546e7a}}.palette-primary-blue-grey .footer,.palette-primary-blue-grey .header{background:#546e7a}.palette-primary-blue-grey .drawer .toc a.current,.palette-primary-blue-grey .drawer .toc a:focus,.palette-primary-blue-grey .drawer .toc a:hover{color:#546e7a}.palette-primary-blue-grey .drawer .anchor a{border-left:2px solid #546e7a}.ios.standalone .palette-primary-blue-grey .article{background:-webkit-linear-gradient(top,#fff 50%,#546e7a 0);background:linear-gradient(180deg,#fff 50%,#546e7a 0)}.palette-primary-blue-grey .article a,.palette-primary-blue-grey .article code,.palette-primary-blue-grey .article h1,.palette-primary-blue-grey .article h2{color:#546e7a}.palette-primary-blue-grey .article .headerlink{color:rgba(0,0,0,.26)}.palette-primary-blue-grey .article table th{background:#7f929b}.palette-primary-blue-grey .results .meta{background:#546e7a}.palette-accent-red .article a:focus,.palette-accent-red .article a:hover{color:#ff2d6f}.palette-accent-red .repo a{background:#ff2d6f}.palette-accent-pink .article a:focus,.palette-accent-pink .article a:hover{color:#f50057}.palette-accent-pink .repo a{background:#f50057}.palette-accent-purple .article a:focus,.palette-accent-purple .article a:hover{color:#e040fb}.palette-accent-purple .repo a{background:#e040fb}.palette-accent-deep-purple .article a:focus,.palette-accent-deep-purple .article a:hover{color:#7c4dff}.palette-accent-deep-purple .repo a{background:#7c4dff}.palette-accent-indigo .article a:focus,.palette-accent-indigo .article a:hover{color:#536dfe}.palette-accent-indigo .repo a{background:#536dfe}.palette-accent-blue .article a:focus,.palette-accent-blue .article a:hover{color:#6889ff}.palette-accent-blue .repo a{background:#6889ff}.palette-accent-light-blue .article a:focus,.palette-accent-light-blue .article a:hover{color:#0091ea}.palette-accent-light-blue .repo a{background:#0091ea}.palette-accent-cyan .article a:focus,.palette-accent-cyan .article a:hover{color:#00b8d4}.palette-accent-cyan .repo a{background:#00b8d4}.palette-accent-teal .article a:focus,.palette-accent-teal .article a:hover{color:#00bfa5}.palette-accent-teal .repo a{background:#00bfa5}.palette-accent-green .article a:focus,.palette-accent-green .article a:hover{color:#12c700}.palette-accent-green .repo a{background:#12c700}.palette-accent-light-green .article a:focus,.palette-accent-light-green .article a:hover{color:#64dd17}.palette-accent-light-green .repo a{background:#64dd17}.palette-accent-lime .article a:focus,.palette-accent-lime .article a:hover{color:#aeea00}.palette-accent-lime .repo a{background:#aeea00}.palette-accent-yellow .article a:focus,.palette-accent-yellow .article a:hover{color:#ffd600}.palette-accent-yellow .repo a{background:#ffd600}.palette-accent-amber .article a:focus,.palette-accent-amber .article a:hover{color:#ffab00}.palette-accent-amber .repo a{background:#ffab00}.palette-accent-orange .article a:focus,.palette-accent-orange .article a:hover{color:#ff9100}.palette-accent-orange .repo a{background:#ff9100}.palette-accent-deep-orange .article a:focus,.palette-accent-deep-orange .article a:hover{color:#ff6e40}.palette-accent-deep-orange .repo a{background:#ff6e40}@media only screen and (max-width:959px){.palette-primary-red .project{background:#e84e40}.palette-primary-pink .project{background:#e91e63}.palette-primary-purple .project{background:#ab47bc}.palette-primary-deep-purple .project{background:#7e57c2}.palette-primary-indigo .project{background:#3f51b5}.palette-primary-blue .project{background:#5677fc}.palette-primary-light-blue .project{background:#03a9f4}.palette-primary-cyan .project{background:#00bcd4}.palette-primary-teal .project{background:#009688}.palette-primary-green .project{background:#259b24}.palette-primary-light-green .project{background:#7cb342}.palette-primary-lime .project{background:#c0ca33}.palette-primary-yellow .project{background:#f9a825}.palette-primary-amber .project{background:#ffb300}.palette-primary-orange .project{background:#fb8c00}.palette-primary-deep-orange .project{background:#ff7043}.palette-primary-brown .project{background:#795548}.palette-primary-grey .project{background:#757575}.palette-primary-blue-grey .project{background:#546e7a}}
diff --git a/stylesheets/temporary.css b/stylesheets/temporary.css
new file mode 100644
index 0000000..25530e6
--- /dev/null
+++ b/stylesheets/temporary.css
@@ -0,0 +1,11 @@
+/* This file only exists (temporarily) until the
+ custom styling can be replaced with the
+ implementation of the upstream project.
+*/
+
+blockquote {
+ padding: 0 20px;
+ margin: 0 0 20px;
+ font-size: inherit;
+ border-left: 5px solid #eee;
+}
diff --git a/tags/index.xml b/tags/index.xml
new file mode 100644
index 0000000..2f40bcd
--- /dev/null
+++ b/tags/index.xml
@@ -0,0 +1,14 @@
+<?xml version="1.0" encoding="utf-8" standalone="yes" ?>
+<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom">
+ <channel>
+ <title>Tags on Eclipse Mita</title>
+ <link>/tags/</link>
+ <description>Recent content in Tags on Eclipse Mita</description>
+ <generator>Hugo -- gohugo.io</generator>
+ <language>en-us</language>
+
+ <atom:link href="/tags/index.xml" rel="self" type="application/rss+xml" />
+
+
+ </channel>
+</rss>
\ No newline at end of file
