--- Games-Sokoban/Sokoban.pm	2010/05/12 20:49:08	1.11
+++ Games-Sokoban/Sokoban.pm	2010/05/12 20:55:30	1.12
@@ -154,6 +154,11 @@
 
 =item $text = $level->as_text
 
+Returns the level in xsb/text format - every row of the level is one line
+ended by a newline, e.g.:
+
+   "###\n# #\n###\n"
+
 =cut
 
 sub as_text {
@@ -210,6 +215,11 @@
 
 =item @lines = $level->as_lines
 
+Returns the level as a list of rows, each row is a text representation of
+the respective level row, e.g.:
+
+   ("###", "# #", "###")
+
 =cut
 
 sub as_lines {
@@ -220,6 +230,10 @@
 
 http://www.sokobano.de/wiki/index.php?title=Level_format
 
+Example:
+
+   "3#|# #|3#"
+
 =cut
 
 sub as_rle {