docs

doc/writing_games-en.txt

@@ -325,7 +325,7 @@ knife = obj {
 	inv = 'Sharp!',
 	tak = 'I took the knife!',
 	use = function(s, w)
-		if w ~= 'tabl'
+		if w ~= 'tabl' then
 			return 'I don\'t want to cut this.', false
 		else
 			return 'You incise your initials on the table.';
@@ -362,7 +362,7 @@ Commands:^
 };
 </code>
 As we can see, the object keeps the reference to the current player ('pl') and some parameters. For example at the start of your game you can set the encoding the following way:
-<code> game.codepage="UTF-8"; </code>
+<code>game.codepage="UTF-8"; </code>
 
 The support of arbitrary encodings is present in every UNIX version of the interpreter and in windows versions from 0.7.7.
 
@@ -469,11 +469,11 @@ end
 
 move(o, w) — moves an object from the current scene to another:
 
-<code>	move('mycat','inmycar');</code>
+<code>move('mycat','inmycar');</code>
 
 If you want to move an object from an arbitrary scene, you'll have to delete it from the original scene with the “del” method. To create objects, that move in complex ways, you'll have to write a method that would save the object's position in the object itself and delete it from the original scene. You can set the initial position (room) as the third parameter of “move”.
 
-<code>    move('mycat','inmycar', 'forest'); </code>
+<code>move('mycat','inmycar', 'forest'); </code>
 
 From version 0.8 there is a “movef” function similar to “move”, but adding the object to the start of the list.
 
@@ -591,7 +591,7 @@ You can pass from one dialog to another, organizing hierarchic dialogs.
 You can also hide some phrases when initializing the dialog and show them under certain conditions.
 <code>
 facectrl = dlg {
-        nam = 'фэйсконтроль',
+	nam = 'facecontrol',
 	dsc = 'I see an unpleasant face of a fat guard.',
 	obj = {
 		[1] = phr('“I came to the Belin's lecture...”', 
@@ -649,7 +649,7 @@ There is a modification of “vobj” object — “vway”. It creates a refere
 You can dynamically fill the scene with “vobj” and “vway” objects. Use methods “add” and “del”. For example:
 
 <code>
-	home.objs:add(vway("next", "{Next}.", 'next_room');
+	home.objs:add(vway("next", "{Next}.", 'next_room'));
 -- some code here
 	home.objs:del("next");
 </code>
@@ -877,6 +877,7 @@ If you use “goto” from the “exit” handler, you get stack overflow, becau
 exit = function(s, t)
 	if t == 'dialog' then return; end
 	return goto('dialog');
+end
 </code>
 
 From version 0.9.1 this is done by stead engine.
@@ -937,11 +938,11 @@ You can create a game with several characters and switch between them from time
 ==== Using the first parameter of a handler ====
 Code example.
 <code>
-knife = obj {
+stone = obj {
 	nam = 'stone',
 	dsc = 'There is a {stone} at the edge.',
 	act = function()
-                objs():del('knife');
+		objs():del('stone');
 		return 'I pushed the stone, it fell and flew down...';
 	end
 </code>
@@ -962,7 +963,7 @@ You can write your own music player, creating it from a live object, e.g:
 -- plays tracks in random order, starting from 2-nd
 tracks = {"mus/astro2.mod", "mus/aws_chas.xm", "mus/dmageofd.xm", "mus/doomsday.s3m"}
 mplayer = obj {
-        nam = 'плеер',
+	nam = 'media player',
 	life = function(s)
 		local n = get_music();
 		local v = get_music_loop();
@@ -1175,6 +1176,8 @@ end
 </code>
 ''pn()'' function adds line feed to the text and outputs the result to the buffer. ''p()'' does almost the same thing but adds a space instead of line feed.
 
+There is a function ''pr()'' in versions 1.1.6 and later, that does not add anything at end of output. 
+
 To clear the buffer you can use ''pclr()''. To return the status of the action along with the text, use ''pget()''.
 <code>
 use = function(s, w)

doc/writing_games.txt

@@ -323,7 +323,7 @@ knife = obj {
 	inv = 'Острый!',
 	tak = 'Я взял нож!',
 	use = function(s, w)
-		if w ~= 'tabl'
+		if w ~= 'tabl' then
 			return 'Не хочу это резать.', false
 		else
 			return 'Вы вырезаете на столе свои инициалы.';
@@ -465,19 +465,19 @@ end
 </code>
 move(o, w) -- переносит объект из текущей сцены в другую:
 
-<code>	move('mycat','inmycar');</code>
+<code>move('mycat','inmycar');</code>
 
 Если вы хотите перенести объект из произвольной сцены, вам придется удалить его из старой сцены с помощью метода del. Для создания сложно перемещающихся объектов, вам придется написать свой метод, который будет сохранять текущую позицию объекта в самом объекте и делать удаление объекта из старой сцены. Вы можете указать исходную позицию (комнату) объекта в качестве третьего параметра move.
 
-<code>    move('mycat','inmycar', 'forest'); </code>
+<code>move('mycat','inmycar', 'forest'); </code>
 
 Начиная с версии 0.8 присутствует также функция movef, аналогичная move, но добавляющая объект в начало списка.
 
 seen(o) -- если объект присутствует в текущей сцене:
 <code>
-	if seen('mycat') then
+if seen('mycat') then
 	move('mycat','inmycar');
-	end
+end
 </code>
 Начиная с 0.8.6 -- необязательный второй параметр -- сцена.
 
@@ -644,8 +644,8 @@ sside = room {
 Вы можете динамически заполнять сцену объектами vobj или vway с помощью методов add и del. Например:
 
 <code>
-	home.objs:add(vway("next", "{Дальше}.", 'next_room');
+	home.objs:add(vway("next", "{Дальше}.", 'next_room'));
--- some code here
+	-- здесь какой-нибудь код
 	home.objs:del("next");
 </code>
 
@@ -664,11 +664,11 @@ mycat = obj {
 	nam = 'Барсик',
 	lf = {
 		[1] = 'Барсик шевелится у меня за пазухой.',
-                [2] = 'Барсик выглядывает из за пазухи.',
+		[2] = 'Барсик выглядывает из-за пазухи.',
 		[3] = 'Барсик мурлычит у меня за пазухой.',
 		[4] = 'Барсик дрожит у меня за пазухой.',
 		[5] = 'Я чувствую тепло Барсика у себя за пазухой.',
-                [6] = 'Барсик высовывает голову из за пазухи и осматривает местность.',
+		[6] = 'Барсик высовывает голову из-за пазухи и осматривает местность.',
 	},
 	life = function(s)
 		local r = rnd(6);
@@ -863,6 +863,7 @@ inv():add('status');
 exit = function(s, t)
 	if t == 'dialog' then return; end
 	return goto('dialog');
+end
 </code>
 Начиная с версии 0.9.1 движок сам разрывает рекурсию.
 
@@ -922,11 +923,11 @@ doencfile("game");
 ==== Использование первого параметра обработчика ====
 Пример кода.
 <code>
-knife = obj {
+stone = obj {
 	nam = 'камень',
 	dsc = 'На краю лежит {камень}.',
 	act = function()
-                objs():del('knife');
+		objs():del('stone');
 		return 'Я толкнул камень, он сорвался и улетел вниз...';
 	end
 </code>
@@ -938,6 +939,7 @@ knife = obj {
 		return 'Я толкнул камень, он сорвался и улетел вниз...';
 	end
 </code>
+
 ==== Использование set_music ====
 Вы можете использовать set_music для проигрывания звуков, задавая второй параметр -- счетчик циклов проигрывания звукового файла.
 
@@ -1004,6 +1006,7 @@ horse = obj {
 };
 lifeon('horse');
 </code>
+
 ==== Таймер ====
 Начиная с версии 1.1.0 в instead появлилась возможность использовать таймер. (Только в графической версии интерпретатора.)
 
@@ -1067,7 +1070,7 @@ main = room {
  
 input.click(s, pressed, mb, x, y, px, py) -- обработчик клика мыши; pressed -- нажатие или отжатие. mb -- номер кнопки (1  - левая), x и y -- координаты клика относительно левого верхнего угла. px и py присутствуют, если клик произошел в области картинки сцены и содержит координаты клика относительно левого верхнего угла картинки. 
 
-Обработчик может вернуть команду интерфейса stead, в этом случае клик не будет обработана интерпретатором.
+Обработчик может вернуть команду интерфейса stead, в этом случае клик не будет обработан интерпретатором.
 
 Например:
 <code>
@@ -1158,6 +1161,8 @@ end
 </code>
 Функция pn() выполняет вывод текста в буфер, дополняя его переводом строки. Функция p() дополняет вывод пробелом.
 
+Начиная с версии 1.1.6 существует функция pr(), которая не выполняет дополнение вывода.
+
 Для очистки буфера, используйте pclr(). Если вам нужно вернуть статус действия, используйте pget().
 <code>
 use = function(s, w)