[lldb] Fix some spelling and grammatical issues in Commands/Options.td (#156121)

Fixes whitespace, spelling and grammatical issues in the command
options. I also formatted the affected options with clang-format and
reflowed the description where necessary.
This commit is contained in:
Jonas Devlieghere
2025-08-29 16:12:35 -07:00
committed by GitHub
parent da7ce52680
commit 781d2d0c45

View File

@@ -250,9 +250,12 @@ let Command = "breakpoint delete" in {
def breakpoint_delete_dummy_breakpoints : Option<"dummy-breakpoints", "D">,
Group<1>, Desc<"Delete Dummy breakpoints - i.e. breakpoints set before a "
"file is provided, which prime new targets.">;
def breakpoint_delete_disabled : Option<"disabled", "d">, Group<1>,
Desc<"Delete all breakpoints which are currently disabled. When using the disabled option "
"any breakpoints listed on the command line are EXCLUDED from deletion.">;
def breakpoint_delete_disabled
: Option<"disabled", "d">,
Group<1>,
Desc<"Delete all breakpoints which are currently disabled. When using "
"the disabled option any breakpoints listed on the command line "
"are EXCLUDED from deletion.">;
}
let Command = "breakpoint name" in {
@@ -342,8 +345,10 @@ let Command = "disassemble" in {
Desc<"Override the CPU for disassembling.">;
def disassemble_options_features : Option<"features", "Y">, Arg<"CPUFeatures">,
Desc<"Specify additional CPU features for disassembling.">;
def disassemble_options_arch : Option<"arch", "A">, Arg<"Architecture">,
Desc<"Specify the architecture to use from cross disassembly.">;
def disassemble_options_arch
: Option<"arch", "A">,
Arg<"Architecture">,
Desc<"Specify the architecture to use for cross disassembly.">;
def disassemble_options_start_address : Option<"start-address", "s">,
Groups<[1,2]>, Arg<"AddressOrExpression">, Required,
Desc<"Address at which to start disassembling.">;
@@ -448,13 +453,17 @@ let Command = "frame recognizer add" in {
Desc<"Give the name of a Python class to use for this frame recognizer.">;
def frame_recognizer_regex : Option<"regex", "x">,
Desc<"Function name and module name are actually regular expressions.">;
def frame_recognizer_first_instruction_only : Option<"first-instruction-only", "f">, Arg<"Boolean">,
Desc<"If true, only apply this recognizer to frames whose PC currently points to the "
"first instruction of the specified function. If false, the recognizer "
"will always be applied, regardless of the current position within the specified function. The "
"implementer should keep in mind that some features, e.g. accessing function argument "
"values via $arg<N>, are not guaranteed to work reliably in this case, so extra care must "
"be taken to make the recognizer operate correctly. Defaults to true.">;
def frame_recognizer_first_instruction_only
: Option<"first-instruction-only", "f">,
Arg<"Boolean">,
Desc<"If true, only apply this recognizer to frames whose PC currently "
"points to the first instruction of the specified function. If "
"false, the recognizer will always be applied, regardless of the "
"current position within the specified function. The implementer "
"should keep in mind that some features, e.g., accessing function "
"argument values via $arg<N>, are not guaranteed to work reliably "
"in this case, so extra care must be taken to make the recognizer "
"operate correctly. Defaults to true.">;
}
let Command = "history" in {
@@ -672,9 +681,10 @@ let Command = "platform process list" in {
def platform_process_list_show_args : Option<"show-args", "A">,
GroupRange<1, 6>,
Desc<"Show process arguments instead of the process executable basename.">;
def platform_process_list_all_users: Option<"all-users", "x">,
GroupRange<1,6>,
Desc<"Show processes matching all user IDs.">;
def platform_process_list_all_users
: Option<"all-users", "x">,
GroupRange<1, 6>,
Desc<"Show processes matching all user IDs.">;
def platform_process_list_verbose : Option<"verbose", "v">, GroupRange<1, 6>,
Desc<"Enable verbose output.">;
}
@@ -926,8 +936,11 @@ let Command = "source list" in {
"indicate valid places to set source level breakpoints.">;
def source_list_file : Option<"file", "f">, Group<1>, Arg<"Filename">,
Completion<"SourceFile">, Desc<"The file from which to display source.">;
def source_list_line : Option<"line", "l">, Group<1>, Arg<"LineNum">,
Desc<"The line number at which to start the display source.">;
def source_list_line
: Option<"line", "l">,
Group<1>,
Arg<"LineNum">,
Desc<"The line number at which to start displaying source.">;
def source_list_name : Option<"name", "n">, Group<2>, Arg<"Symbol">,
Completion<"Symbol">,
Desc<"The name of a function whose source to display.">;
@@ -1089,12 +1102,14 @@ let Command = "target stop hook add" in {
def target_stop_hook_add_auto_continue : Option<"auto-continue", "G">,
Arg<"Boolean">, Desc<"The stop-hook will auto-continue after running its"
" commands.">;
def target_stop_hook_add_at_initial_stop : Option<"at-initial-stop", "I">,
Arg<"Boolean">, Desc<"Whether the stop-hook will trigger when lldb "
"initially gains control of the process. For a process launch, this "
"initial stop may happen very early on - before the loader has run. You "
"can use this option if you do not want some stop-hooks to run then. "
"Defaults to true.">;
def target_stop_hook_add_at_initial_stop
: Option<"at-initial-stop", "I">,
Arg<"Boolean">,
Desc<"Whether the stop-hook will trigger when lldb "
"initially gains control of the process. For a process launch, "
"this initial stop may happen very early on - before the loader "
"has run. You can use this option if you do not want some "
"stop-hooks to run then. Defaults to true.">;
}
let Command = "thread backtrace" in {
@@ -1120,12 +1135,16 @@ let Command = "thread step scope" in {
def thread_step_scope_count : Option<"count", "c">, Group<1>, Arg<"Count">,
Desc<"How many times to perform the stepping operation - currently only "
"supported for step-inst and next-inst.">;
def thread_step_scope_end_linenumber : Option<"end-linenumber", "e">,
Group<1>, Arg<"LineNum">, Desc<"The line at which to stop stepping - "
"defaults to the next line and only supported for step-in and step-over."
" You can also pass the string 'block' to step to the end of the current"
" block. This is particularly use in conjunction with --step-target to"
" step through a complex calling sequence.">;
def thread_step_scope_end_linenumber
: Option<"end-linenumber", "e">,
Group<1>,
Arg<"LineNum">,
Desc<"The line at which to stop stepping - "
"defaults to the next line and only supported for step-in and "
"step-over. You can also pass the string 'block' to step to the "
"end of the current block. This is particularly useful in "
"conjunction with --step-target to step through a complex calling "
"sequence.">;
def thread_step_scope_run_mode : Option<"run-mode", "m">, Group<1>,
EnumArg<"RunMode">, Desc<"Determine how to run other "
"threads while stepping the current thread.">;
@@ -1170,9 +1189,13 @@ let Command = "thread jump" in {
Completion<"SourceFile">, Desc<"Specifies the source file to jump to.">;
def thread_jump_line : Option<"line", "l">, Group<1>, Arg<"LineNum">,
Required, Desc<"Specifies the line number to jump to.">;
def thread_jump_by : Option<"by", "b">, Group<2>, Arg<"Offset">, Required,
Desc<"Jumps by a relative line offset from the current line,"
"can be a positive or negative offset">;
def thread_jump_by
: Option<"by", "b">,
Group<2>,
Arg<"Offset">,
Required,
Desc<"Jumps by a relative line offset from the current line, "
"can be a positive or negative offset.">;
def thread_jump_address : Option<"address", "a">, Group<3>,
Arg<"AddressOrExpression">, Required, Desc<"Jumps to a specific address.">;
def thread_jump_force : Option<"force", "r">, Groups<[1,2,3]>,
@@ -1394,8 +1417,10 @@ let Command = "type category enable" in {
}
let Command = "type category disable" in {
def type_category_disable_language : Option<"language", "l">, Arg<"Language">,
Desc<"Enable the category for this language.">;
def type_category_disable_language
: Option<"language", "l">,
Arg<"Language">,
Desc<"Disable the category for this language.">;
}
let Command = "type filter add" in {