clarify gui/launcher docs, code comments

myk002 · myk002 · commit d7b64afc9fdc · 2022-09-14T17:13:08.000-07:00
diff --git a/docs/gui/launcher.rst b/docs/gui/launcher.rst
@@ -38,28 +38,30 @@ the dialog immediately so you can get back to the game, use
 :kbd:`Shift`:kbd:`Enter` or hold down the :kbd:`Shift` key and click on the
 ``run`` button instead. The dialog also closes automatically if you run a
 command that brings up a new GUI screen. In any case, the command output will
-also be written to the DFHack terminal console.
+also be written to the DFHack terminal console if you need to find it later.
 
 Autocomplete
 ------------
 
 As you type, autocomplete options for DFHack commands appear in the right
 column. If the first word of what you've typed matches a valid command, then the
 autocomplete options will also include commands that have similar functionality
-to the one that you've named. Click on an autocomplete option to select it or
-cycle through them with :kbd:`Tab` or :kbd:`Shift`:kbd:`Tab`.
+to the one that you've named. Click on an autocomplete list option to select it
+or cycle through them with :kbd:`Tab` and :kbd:`Shift`:kbd:`Tab`.
 
 Context-sensitive help
 ----------------------
 
 When you start ``gui/launcher`` without parameters, it shows some useful
-information in the help area about how to get started.
+information in the help area about how to get started with browsing DFHack tools
+by their category `tags`.
 
 Once you have typed (or autocompleted) a word that matches a valid command, the
 help area shows the help for that command, including usage instructions and
-examples. You can scroll the help text by clicking on the scrollbar or with
-:kbd:`PgUp` and :kbd:`PgDn`. You can also scroll line by line with
-:kbd:`Ctrl`:kbd:`Up` and :kbd:`Ctrl`:kbd:`Down`.
+examples. You can scroll the help text by half-pages by clicking on the
+scrollbar or with :kbd:`PgUp` and :kbd:`PgDn`. You can also scroll line by line
+with :kbd:`Ctrl`:kbd:`Up` and :kbd:`Ctrl`:kbd:`Down`, or by clicking on the
+scrollbar arrows.
 
 Command history
 ---------------
diff --git a/gui/launcher.lua b/gui/launcher.lua
@@ -307,6 +307,7 @@ end
 --
 HelpPanel = defclass(HelpPanel, widgets.Panel)
 
+-- this text is intentionally unwrapped so the in-UI wrapping can do the job
 local DEFAULT_HELP_TEXT = [[Welcome to DFHack!
 
 Type a command to see its help text here. Hit ENTER to run the command, or Shift-ENTER to run the command and close this dialog. The dialog also closes automatically if you run a command that shows a new GUI screen.
