Small help text fixes, to make it more consistent and accurate.

Temporarily remove -l option from 'expr' command (at Sean's request).

llvm-svn: 113298

lldb/source/Commands/CommandObjectApropos.cpp

@@ -28,7 +28,7 @@ using namespace lldb_private;
 
 CommandObjectApropos::CommandObjectApropos () :
     CommandObject ("apropos",
-                     "Finds a list of debugger commands related to a particular word/subject.",
+                     "Find a list of debugger commands related to a particular word/subject.",
                      "apropos <search-word>")
 {
 }

lldb/source/Commands/CommandObjectBreakpoint.cpp

@@ -504,7 +504,7 @@ CommandObjectBreakpointSet::Execute
 
 CommandObjectMultiwordBreakpoint::CommandObjectMultiwordBreakpoint (CommandInterpreter &interpreter) :
     CommandObjectMultiword ("breakpoint",
-                              "A set of commands for operating on breakpoints.",
+                              "A set of commands for operating on breakpoints. Also see regexp-break.",
                               "breakpoint <command> [<command-options>]")
 {
     bool status;

lldb/source/Commands/CommandObjectCommands.cpp

@@ -424,7 +424,7 @@ public:
 
 CommandObjectMultiwordCommands::CommandObjectMultiwordCommands (CommandInterpreter &interpreter) :
     CommandObjectMultiword ("commands",
-                            "Commands for managing the command interpreters commands",
+                            "A set of commands for managing or customizing the debugger commands.",
                             "commands <subcommand> [<subcommand-options>]")
 {
     LoadSubCommand (interpreter, "source",   CommandObjectSP (new CommandObjectCommandsSource ()));

lldb/source/Commands/CommandObjectDisassemble.cpp

@@ -143,7 +143,7 @@ CommandObjectDisassemble::CommandOptions::g_option_table[] =
 
 CommandObjectDisassemble::CommandObjectDisassemble () :
     CommandObject ("disassemble",
-                     "Disassemble bytes in the current function or anywhere in the inferior program.",
+                     "Disassemble bytes in the current function, or elsewhere in the executable program as specified by the user.",
                      "disassemble [<cmd-options>]")
 {
 }

lldb/source/Commands/CommandObjectExpression.cpp

@@ -55,12 +55,12 @@ CommandObjectExpression::CommandOptions::SetOptionValue (int option_idx, const c
 
     switch (short_option)
     {
-    case 'l':
+      //case 'l':
-        if (language.SetLanguageFromCString (option_arg) == false)
+      //if (language.SetLanguageFromCString (option_arg) == false)
-        {
+      //{
-            error.SetErrorStringWithFormat("Invalid language option argument '%s'.\n", option_arg);
+      //    error.SetErrorStringWithFormat("Invalid language option argument '%s'.\n", option_arg);
-        }
+      //}
-        break;
+      //break;
 
     case 'g':
         debug = true;
@@ -82,7 +82,7 @@ void
 CommandObjectExpression::CommandOptions::ResetOptionValues ()
 {
     Options::ResetOptionValues();
-    language.Clear();
+    //language.Clear();
     debug = false;
     format = eFormatDefault;
     show_types = true;
@@ -98,7 +98,7 @@ CommandObjectExpression::CommandOptions::GetDefinitions ()
 CommandObjectExpression::CommandObjectExpression () :
     CommandObject (
             "expression",
-            "Evaluate a C expression in the current program context, using variables currently in scope.",
+            "Evaluate an Objective-C++ expression in the current program context, using variables currently in scope.",
             "expression [<cmd-options>] <expr>"),
     m_expr_line_count (0),
     m_expr_lines ()
@@ -347,7 +347,7 @@ CommandObjectExpression::ExecuteRawCommandString
 lldb::OptionDefinition
 CommandObjectExpression::CommandOptions::g_option_table[] =
 {
-{ LLDB_OPT_SET_ALL, false, "language",   'l', required_argument, NULL, 0, "[c|c++|objc|objc++]",          "Sets the language to use when parsing the expression."},
+  //{ LLDB_OPT_SET_ALL, false, "language",   'l', required_argument, NULL, 0, "[c|c++|objc|objc++]",          "Sets the language to use when parsing the expression."},
 { LLDB_OPT_SET_ALL, false, "format",     'f', required_argument, NULL, 0, "[ [bool|b] | [bin] | [char|c] | [oct|o] | [dec|i|d|u] | [hex|x] | [float|f] | [cstr|s] ]",  "Specify the format that the expression output should use."},
 { LLDB_OPT_SET_ALL, false, "debug",      'g', no_argument,       NULL, 0, NULL,                           "Enable verbose debug logging of the expression parsing and evaluation."},
 { LLDB_OPT_SET_ALL, false, "use-ir",     'i', no_argument,       NULL, 0, NULL,                           "[Temporary] Instructs the expression evaluator to use IR instead of ASTs."},

lldb/source/Commands/CommandObjectExpression.h

@@ -46,7 +46,7 @@ public:
         // Options table: Required for subclasses of Options.
 
         static lldb::OptionDefinition g_option_table[];
-        Language  language;
+        //Language  language;
         lldb::Encoding  encoding;
         lldb::Format    format;
         bool        debug;

lldb/source/Commands/CommandObjectFile.cpp

@@ -87,7 +87,7 @@ CommandObjectFile::CommandOptions::ResetOptionValues ()
 
 CommandObjectFile::CommandObjectFile() :
     CommandObject ("file",
-                   "Sets the file to be used as the main executable by the debugger.",
+                   "Set the file to be used as the main executable by the debugger.",
                    "file [<cmd-options>] <filename>")
 {
 }

lldb/source/Commands/CommandObjectHelp.cpp

@@ -27,7 +27,7 @@ using namespace lldb_private;
 
 CommandObjectHelp::CommandObjectHelp () :
     CommandObject ("help",
-                   "Shows a list of all debugger commands, or give details about specific commands.",
+                   "Show a list of all debugger commands, or give details about specific commands.",
                    "help [<cmd-name>]")
 {
 }

lldb/source/Commands/CommandObjectImage.cpp

@@ -1554,8 +1554,8 @@ CommandObjectImageLookup::CommandOptions::g_option_table[] =
 //----------------------------------------------------------------------
 CommandObjectImage::CommandObjectImage(CommandInterpreter &interpreter) :
     CommandObjectMultiword ("image",
-                            "Access information for one or more executable images.",
+                            "A set of commands for accessing information for one or more executable images.",
-                            "image [dump|list] ...")
+                            "image <sub-command> ...")
 {
     LoadSubCommand (interpreter, "dump",    CommandObjectSP (new CommandObjectImageDump (interpreter)));
     LoadSubCommand (interpreter, "list",    CommandObjectSP (new CommandObjectImageList ()));

lldb/source/Commands/CommandObjectMemory.cpp

@@ -678,7 +678,7 @@ CommandObjectMemoryWrite::CommandOptions::g_option_table[] =
 
 CommandObjectMemory::CommandObjectMemory (CommandInterpreter &interpreter) :
     CommandObjectMultiword ("memory",
-                            "A set of commands for operating on a memory.",
+                            "A set of commands for operating on memory.",
                             "memory <subcommand> [<subcommand-options>]")
 {
     LoadSubCommand (interpreter, "read",  CommandObjectSP (new CommandObjectMemoryRead ()));

lldb/source/Commands/CommandObjectQuit.cpp

@@ -24,7 +24,7 @@ using namespace lldb_private;
 //-------------------------------------------------------------------------
 
 CommandObjectQuit::CommandObjectQuit () :
-    CommandObject ("quit", "Quits out of the LLDB debugger.", "quit")
+    CommandObject ("quit", "Quit out of the LLDB debugger.", "quit")
 {
 }
 

lldb/source/Commands/CommandObjectRegister.cpp

@@ -220,7 +220,7 @@ public:
 //----------------------------------------------------------------------
 CommandObjectRegister::CommandObjectRegister(CommandInterpreter &interpreter) :
     CommandObjectMultiword ("register",
-                            "Access thread registers.",
+                            "A set of commands to access thread registers.",
                             "register [read|write] ...")
 {
     LoadSubCommand (interpreter, "read",  CommandObjectSP (new CommandObjectRegisterRead ()));

lldb/source/Commands/CommandObjectSource.cpp

@@ -575,7 +575,7 @@ CommandObjectSourceList::CommandOptions::g_option_table[] =
 
 CommandObjectMultiwordSource::CommandObjectMultiwordSource (CommandInterpreter &interpreter) :
     CommandObjectMultiword ("source",
-                            "Commands for accessing source file information",
+                            "A set of commands for accessing source file information",
                             "source <subcommand> [<subcommand-options>]")
 {
     LoadSubCommand (interpreter, "info",   CommandObjectSP (new CommandObjectSourceInfo ()));

lldb/source/Commands/CommandObjectThread.cpp

@@ -332,7 +332,7 @@ public:
 
     CommandObjectThreadBacktrace () :
         CommandObject ("thread backtrace",
-                       "Shows the stack for one or more threads.  If no threads are specified, shows the currently selected thread.  \nUse the thread-index \"all\" to see all threads.",
+                       "Shows the stack for one or more threads.  If no threads are specified, shows the currently selected thread.  Use the thread-index \"all\" to see all threads.",
                        "thread backtrace [<thread-index>] ...",
                        eFlagProcessMustBeLaunched | eFlagProcessMustBePaused),
         m_options()
@@ -1378,7 +1378,7 @@ public:
 
 CommandObjectMultiwordThread::CommandObjectMultiwordThread (CommandInterpreter &interpreter) :
     CommandObjectMultiword ("thread",
-                            "A set of commands for operating on one or more thread within a running process.",
+                            "A set of commands for operating on one or more threads within a running process.",
                             "thread <subcommand> [<subcommand-options>]")
 {
     LoadSubCommand (interpreter, "backtrace",  CommandObjectSP (new CommandObjectThreadBacktrace ()));

lldb/source/Interpreter/CommandInterpreter.cpp

@@ -167,7 +167,7 @@ CommandInterpreter::LoadCommandDictionary ()
 
     std::auto_ptr<CommandObjectRegexCommand>
     break_regex_cmd_ap(new CommandObjectRegexCommand ("regexp-break",
-                                                      "Smart breakpoint command (using regular expressions).",
+                                                      "Set a breakpoint using a regular expression to specify the location.",
                                                       "regexp-break [<file>:<line>]\nregexp-break [<address>]\nregexp-break <...>", 2));
     if (break_regex_cmd_ap.get())
     {

lldb/source/Interpreter/CommandObjectScript.cpp

@@ -29,8 +29,8 @@ using namespace lldb_private;
 
 CommandObjectScript::CommandObjectScript (ScriptLanguage script_lang) :
     CommandObject ("script",
-                   "Passes an expression to the script interpreter for evaluation and returns the results. Drops user into the interactive interpreter if no expressions are given.",
+                   "Pass an expression to the script interpreter for evaluation and return the results. Drop into the interactive interpreter if no expression is given.",
-                   "script [<script-expressions-for-evaluation>]"),
+                   "script [<script-expression-for-evaluation>]"),
     m_script_lang (script_lang),
     m_interpreter_ap ()
 {