doc: $fmt

Author: hugeping

doc/stead3-en.md

@@ -3337,6 +3337,17 @@ require a more flexible output control, you can do the following:
   the expense module 'sprite';
 - Use another engine, because most likely you use INSTEAD for other purposes.
 
+### Substitution $fmt
+
+There is a more convenient way to insert formatting and layout into text.
+To do this, you can use the $fmt substitution. For example:
+
+    p "{$fmt b|Boom!"};
+    p "{$fmt tab 50% centre|}{$fmt b|{$fmt nb|Hello, world!}}"
+
+As you can see from the example, you can use the formatting and layout functions
+as $fmt templates and place them directly in the text.
+
 ## Constructors and inheritance
 
 __Caution!__

doc/stead3-ru.md

@@ -172,7 +172,7 @@ main3.lua означает, что вы пишите игру на STEAD3!) Др
 модулях будет рассказано отдельно.
 
     require "fmt" -- некоторые функции форматирования
-	fmt.para = true -- включить режим параграфов (отступы)
+    fmt.para = true -- включить режим параграфов (отступы)
 
 Кроме того, обычно стоит определить обработчики по умолчанию:
 game.act, game.use, game.inv, о которых также будет рассказано ниже.
@@ -3534,6 +3534,18 @@ room {
   разными шрифтами за счёт модуля 'sprite';
 - Использовать другой движок, так как скорее всего вы используете INSTEAD не по назначению.
 
+### Подстановка $fmt
+
+Существует более удобный способ вставлять в текст форматирование и оформление.
+Для этого можно воспользоваться подстановкой $fmt. Например:
+
+    p "{$fmt b|Бум!};
+    p "{$fmt tab 50% center|}{$fmt b|{$fmt nb|Привет, мир!}}"
+
+Как видно из примера, вы можете использовать функции форматирования и оформления
+в виде подстоновок $fmt и размещать их прямо в тексте.
+
+
 ## Конструкторы и наследование
 
 __Внимание!__