Merge pull request #108 from tseykovets/doc_corrections

Documentation corrections

doc/stead3-en.md

@@ -201,10 +201,11 @@ game engine will call init() first, and then call start().
 
 The graphic interpreter looks for available games in the directory games. The
 Unix version of the interpreter in addition, the catalog scans also games in
-the directory ~/.instead/games. Windows version: Documents and
-Settings/USER/Local Settings/Application Data/instead/games. In Windows -
-standalone-Unix-version of the game are searched in the directory
-./appdata/games, if it exists.
+the directory ~/.instead/games. Windows version: %LOCALAPPDATA%\instead\games
+(below Vista:
+Documents and Settings\USER\Local Settings\Application Data\instead\games).
+In Windows and standalone-Unix version of the game are searched in the
+directory ./appdata/games, if it exists.
 
 In some assemblies, INSTEAD (in Windows, in Linux if the project is built with
 gtk etc.), you can open the game in any way from the menu "Choice of
@@ -4315,9 +4316,9 @@ scr.gfx.h = 500 ; -- replace it one parameter
 ```
 
 > The interpreter searches for themes in the "themes" directory. Unix version
-> in addition to this directory, scan also the directory ~/.instead/themes/
-> Windows version -- Documents and Settings/USER/Local
-> Settings/Application Data/instead/themes
+> in addition to this directory, scan also the directory ~/.instead/themes/.
+> Windows version: %LOCALAPPDATA%\instead\themes (below Vista:
+> Documents and Settings\USER\Local Settings\Application Data\instead\themes).
 
 In addition, the new version INSTEAD support multiple those in one game.
 Allowing the player via the standard menu INSTEAD choose a suitable

doc/stead3-ru.md

@@ -214,10 +214,11 @@ _Инициализацию_ игры следует описывать в фу
 
 
 Графический интерпретатор ищет доступные игры в каталоге
-games. Unix-версия интерпретатора кроме этого каталога просматривает
+games. Unix-версия интерпретатора, кроме этого каталога, просматривает
 также игры в каталоге ~/.instead/games. Windows-версия:
-%LOCALAPPDATA%\instead\games.  В
-Windows- и standalone-Unix-версии игры ищутся в каталоге
+%LOCALAPPDATA%\instead\games (ниже Vista:
+Documents and Settings\USER\Local Settings\Application Data\instead\games).
+В Windows- и standalone-Unix-версии игры ищутся в каталоге
 ./appdata/games, если он существует.
 
 В некоторых сборках INSTEAD (в Windows, в Linux если проект собран с
@@ -1057,7 +1058,7 @@ apple 'xxx' (10) -- создали переменную xxx у объекта ap
 
 ### Локальные переменные
 
-Кроме переменных объекта вы можете использовать локальные и глобальные
+Кроме переменных объекта, вы можете использовать локальные и глобальные
 переменные.
 
 Локальные переменные создаются с помощью служебного слова local:
@@ -1152,7 +1153,7 @@ global 'global_var' (1)
 
 Глобальные переменные всегда попадают в файл-сохранение.
 
-Кроме глобальных переменных вы можете задавать константы. Синтаксис
+Кроме глобальных переменных, вы можете задавать константы. Синтаксис
 аналогичен глобальным переменным:
 
 ```
@@ -1257,7 +1258,7 @@ end
 другие обработчики, о которых будет рассказано дальше, для которых
 описанное поведение точно такое же.
 
-На самом деле, кроме 'game.act' и 'act' -- атрибута объекта существует
+На самом деле, кроме 'game.act' и 'act' атрибутов объекта, существует
 обработчик 'onact' у объекта game, который может прервать выполнение
 обработчика 'act'.
 
@@ -1470,7 +1471,7 @@ room {
     if std.nameof(f) == 'main' then
 
 
-Как видим на примере onexit, эти обработчики, кроме строки могут
+Как видим на примере onexit, эти обработчики, кроме строки, могут
 возвращать булевое значение статуса. Аналогично обработчику onact, мы
 может отменить переход, вернув false из onexit/onenter.
 
@@ -2673,7 +2674,7 @@ closed / disabled и так далее...
 
 Но лучше это делать в самом диалоге, например, в enter.
 
-Кроме того есть метод :reset, который сбрасывает стек переходов и
+Кроме того, есть метод :reset, который сбрасывает стек переходов и
 устанавливает стартовую фразу, например:
 
 ```
@@ -4573,10 +4574,10 @@ include = book ; -- использовать тему Книга
 scr.gfx.h = 500 ; -- заменить в ней один параметр
 ```
 
-> Интерпретатор выполняет поиск тем в каталоге themes. Unix версия
-> кроме этого каталога, просматривает также каталог ~/.instead/themes/
-> Windows версия -- Documents and Settings/USER/Local
-> Settings/Application Data/instead/themes
+> Интерпретатор выполняет поиск тем в каталоге themes. Unix-версия,
+> кроме этого каталога, просматривает также каталог ~/.instead/themes/.
+> Windows-версия: %LOCALAPPDATA%\instead\themes (ниже Vista:
+> Documents and Settings\USER\Local Settings\Application Data\instead\themes).
 
 Кроме этого, новые версии INSTEAD поддерживают механизм множественных
 тем в одной игре. Давая возможность игроку через стандартное меню