adding namespace descriptions

docs/reference.md

@@ -8,9 +8,9 @@ input.onButtonPressed(Button.A, () => {});
 led.plot(0,0);
 radio.sendNumber(0);
 music.playTone(music.noteFrequency(Note.C), music.beat(BeatFraction.Whole));
-game.createSprite();
+game.createSprite(2,2);
 pins.digitalReadPin(DigitalPin.P0);
-serial.WriteLine("Hello!")
+serial.writeLine("Hello!");
 control.inBackground(() => {});
 ```
 

libs/microbit/control.cpp

@@ -113,6 +113,9 @@ enum EventBusValue {
     MES_REMOTE_CONTROL_EVT_VOLUMEUP_ = MES_REMOTE_CONTROL_EVT_VOLUMEUP,
 };
 
+/**
+* Runtime and event utilities.
+*/
 //% weight=1 color="#333333"
 namespace control {
     void fiberDone(void *a)

libs/microbit/game.ts

@@ -18,6 +18,9 @@ enum LedSpriteProperty {
     Blink
 }
 
+/**
+ * A single-LED sprite game engine
+ */
 //% color=176 weight=32
 namespace game {
     var _score: number = 0;

libs/microbit/images.cpp

@@ -1,5 +1,8 @@
 #include "ksbit.h"
 
+/**
+* Creation, manipulation and display of LED images.
+*/
 //% color=45 weight=31
 namespace images {
     /**

libs/microbit/input.ts

@@ -1,3 +1,6 @@
+/**
+ * Events and data from sensors
+ */
 //% color=300 weight=99
 namespace input {
     /**

libs/microbit/led.ts

@@ -1,3 +1,6 @@
+/**
+ * Control of the LED screen.
+ */
 //% color=3 weight=35
 namespace led {
 

libs/microbit/music.ts

@@ -74,6 +74,9 @@ enum BeatFraction {
     Sixteenth = 16
 }
 
+/**
+ * Generation of music tones through pin ``P0``.
+ */
 //% color=52 weight=33
 namespace music {
     var beatsPerMinute: number = 120;

libs/microbit/pins.ts

@@ -1,3 +1,6 @@
+/**
+ * Control currents in Pins for analog/digital signals, servos, i2c, ...
+ */
 //% color=351 weight=30
 namespace pins {
     /**

libs/microbit/serial.ts

@@ -1,3 +1,6 @@
+/**
+ * Reading and writing data over a serial connection.
+ */
 //% weight=2 color=30
 namespace serial {
     /**

libs/microbit/shims.d.ts

@@ -1,7 +1,9 @@
 // Auto-generated. Do not edit.
 
 
-
+    /**
+     * Creation, manipulation and display of LED images.
+     */
     //% color=45 weight=31
 declare namespace images {
 
@@ -265,7 +267,9 @@ declare namespace input {
 }
 
 
-
+    /**
+     * Runtime and event utilities.
+     */
     //% weight=1 color="#333333"
 declare namespace control {