Improve documentation/help choise of words.

[plomrogue2] / rogue_chat_curses.py

diff --git a/rogue_chat_curses.py b/rogue_chat_curses.py
index b498ce0b17ca1bb3ab080884af7d1a148a6e3063..49eb01a9d6217e04808366c90a4e624433979072 100755 (executable)
--- a/rogue_chat_curses.py
+++ b/rogue_chat_curses.py
@@ -14,34 +14,34 @@ from plomrogue.errors import BrokenSocketConnection
 mode_helps = {
     'play': {
         'short': 'play',
-        'long': 'This mode allows you to interact with the map.'
+        'long': 'This mode allows you to interact with the map in various ways.'
     },
     'study': {
         'short': 'study',
-        'long': 'This mode allows you to study the map and its tiles in detail.  Move the question mark over a tile, and the right half of the screen will show detailed information on it.'},
+        'long': 'This mode allows you to study the map and its tiles in detail.  Move the question mark over a tile, and the right half of the screen will show detailed information on it.  Toggle the map view to show or hide different information layers.'},
     'edit': {
         'short': 'map edit',
-        'long': 'This mode allows you to change the map in various ways.'
+        'long': 'This mode allows you to change the map in various ways.  Individual map tiles are shown together with their "protection characters".  You can edit a tile if you set the map edit password that matches its protection character.  The character "." marks the absence of protection:  Such tiles can always be edited.'
     },
     'write': {
-        'short': 'terrain write',
+        'short': 'change terrain',
         'long': 'This mode allows you to change the map tile you currently stand on (if your map editing password authorizes you so).  Just enter any printable ASCII character to imprint it on the ground below you.'
     },
     'control_pw_type': {
-        'short': 'change tiles control password',
-        'long': 'This mode is the first of two steps to change the password for a tile control character.  First enter the tile control character for which you want to change the password.'
+        'short': 'change protection character password',
+        'long': 'This mode is the first of two steps to change the password for a tile protection character.  First enter the tile protection character for which you want to change the password.'
     },
     'control_pw_pw': {
         'short': 'change tiles control password',
-        'long': 'This mode is the second of two steps to change the password for a tile control character.  Enter the new password for the tile control character you chose.'
+        'long': 'This mode is the second of two steps to change the password for a tile protection character.  Enter the new password for the tile protection character you chose.'
     },
     'control_tile_type': {
         'short': 'change tiles control',
-        'long': 'This mode is the first of two steps to change tile control areas on the map.  First enter the tile control character you want to write.'
+        'long': 'This mode is the first of two steps to change tile protection areas on the map.  First enter the tile tile protection character you want to write.'
     },
     'control_tile_draw': {
         'short': 'change tiles control',
-        'long': 'This mode is the second of two steps to change tile control areas on the map.  Toggle tile control drawing on, then move cursor around the map to draw selected tile control character.'
+        'long': 'This mode is the second of two steps to change tile protection areas on the map.  Toggle tile protection drawing on/off and move the ?? cursor around the map to draw the selected tile protection character.'
     },
     'annotate': {
         'short': 'annotate tile',
@@ -57,7 +57,7 @@ mode_helps = {
     },
     'login': {
         'short': 'login',
-        'long': 'Pick your player name.'
+        'long': 'Enter your player name.'
     },
     'waiting_for_server': {
         'short': 'waiting for server response',
@@ -68,7 +68,7 @@ mode_helps = {
         'long': 'Waiting for a server response.'
     },
     'password': {
-        'short': 'map edit password',
+        'short': 'set map edit password',
         'long': 'This mode allows you to change the password that you send to authorize yourself for editing password-protected map tiles.  Hit return to confirm and leave.'
     },
     'admin_enter': {
@@ -742,18 +742,18 @@ class TUI:
                 if 'PICK_UP' in self.game.tasks:
                     content += "[%s] – pick up thing\n" % self.keys['take_thing']
                 if 'DROP' in self.game.tasks:
-                    content += "[%s] – drop picked-up thing\n" % self.keys['drop_thing']
-                content += '[%s] – teleport to other space\n' % self.keys['teleport']
+                    content += "[%s] – drop thing\n" % self.keys['drop_thing']
+                content += '[%s] – teleport\n' % self.keys['teleport']
                 content += '\n'
             elif self.mode.name == 'study':
                 content += 'Available actions:\n'
                 content += '[%s] – move question mark\n' % ','.join(self.movement_keys)
-                content += '[%s] – toggle view between anything, terrain, and annotations\n' % self.keys['toggle_map_mode']
+                content += '[%s] – toggle map view\n' % self.keys['toggle_map_mode']
                 content += '\n'
             elif self.mode.name == 'edit':
                 content += "Available actions:\n"
                 if 'FLATTEN_SURROUNDINGS' in self.game.tasks:
-                    content += "[%s] – flatten player's surroundings\n" % self.keys['flatten']
+                    content += "[%s] – flatten surroundings\n" % self.keys['flatten']
                 content += '\n'
             elif self.mode.name == 'control_tile_draw':
                 content += "Available actions:\n"