More asm docs

Author: vslutov

docs/assembler.md

@@ -10,34 +10,36 @@
 Для использования языка ассемблера нужно использовать
 директиву `.asm` вместо директивы `.code`.
 
-- `modelmachine asm FILENAME` - ассемблировать файл
-- `modelmachine run FILENAME` - ассемблировать и выполнить файл
-- `modelmachine debug FILENAME` - ассемблировать и отладить файл
+- `modelmachine asm FILENAME` - ассемблировать файл;
+- `modelmachine run FILENAME` - выполнить ассемблерный файл;
+- `modelmachine debug FILENAME` - отладить ассемблерный файл,
+  отладчик выводит исходный текст программы на ассемблере
+  рядом с текущим состоянием памяти;
 
 Ассемблер нечувствителен к регистру.
+В том числе метки нечувствительны к регистру.
 Директивы ассемблера начинаются с точки.
 
-Доступные директивы верхниего уровня:
+Директивы верхнего уровня:
 
 - `.cpu` - задает модель машины;
 - `.input`, `.output` - могут принимать не только адрес, но и метку;
   в остальном работают так же, как для машинных кодов;
 - `.enter` - работает так же, как для машинных кодов;
-- `.code` - обчные секции машинного кода разрешены;
-- `.asm` - секция кода программы;
+- `.asm` - секция кода на ассемблере;
+- `.code` - секции машинного кода также разрешены;
 
-Внутри секции asm находится код программы на языке ассемблера, он состоит из:
+В секции `.asm` находится код программы на языке ассемблера, он состоит из:
 
 - `op r1, label[r2]` - код операции с использоваем регистров (от `r0` до `rf`)
   и меток;
-    - расчет относительных адресов для команд условного перехода в `mm-0`
-      происходит автоматически;
+    - расчет адресов происходит автоматически;
     - `.imm(10)` - при необходимости можно всесто метки-операнда записать число
       директивой `.imm`;
 - `label: ` - объявление метки; имя метки состоит из латинских букв, цифр,
  `_` и `.`, начинается не с цифры;
 - `.label` - локальная метка;
-- `.word список_чисел` - список чисел в памяти как есть, каждое
+- `.word список_чисел` - список чисел в памяти, каждое
   число занимает столько ячеек, сколько требуется для арифметической операции
   на данной машине;