ShellPkg: Clarify the description of acpiview option '-s'

BZ: https://bugzilla.tianocore.org/show_bug.cgi?id=1153

The '-s' option of 'acpiview' do not support multiply invcation options.
So clarify it for users.
Modify the help decription for UefiShellAcpiViewCommandLib which the
description is equal or over 80 column. If the line include equal or over
80 characters. The display engine would display a blank line for those
equal 80 characters or a extra line with few words for those over 80
character. So it is better to keep each line less than 80 characters.

Cc: Jaben Carsey <jaben.carsey@intel.com>
Cc: Ray Ni <ray.ni@intel.com>
Cc: Liming Gao <liming.gao@intel.com>
Signed-off-by: Zhichao Gao <zhichao.gao@intel.com>
Reviewed-by: Jaben Carsey <jaben.carsey@intel.com>
This commit is contained in:
Zhichao Gao
2019-02-21 13:19:43 +08:00
committed by Liming Gao
parent 6d70ade90c
commit e0fd9ece26

View File

@ -35,7 +35,8 @@
".SH OPTIONS\r\n" ".SH OPTIONS\r\n"
" \r\n" " \r\n"
" -l - Display list of installed ACPI Tables.\r\n" " -l - Display list of installed ACPI Tables.\r\n"
" -s - Display only the specified AcpiTable type.\r\n" " -s - Display only the specified AcpiTable type and only support single\r\n"
" invocation option.\r\n"
" AcpiTable : The required ACPI Table type.\r\n" " AcpiTable : The required ACPI Table type.\r\n"
" -d - Generate a binary file dump of the specified AcpiTable.\r\n" " -d - Generate a binary file dump of the specified AcpiTable.\r\n"
" -c - Consistency checking (enabled by default).\r\n" " -c - Consistency checking (enabled by default).\r\n"
@ -48,21 +49,21 @@
".SH DESCRIPTION\r\n" ".SH DESCRIPTION\r\n"
" \r\n" " \r\n"
" This program is provided to allow examination of ACPI table values from the\r\n" " This program is provided to allow examination of ACPI table values from the\r\n"
" UEFI Shell. This can help with investigations, especially at that stage where\r\n" " UEFI Shell. This can help with investigations, especially at that stage\r\n"
" the tables are not enabling an OS to boot.\r\n" " where the tables are not enabling an OS to boot.\r\n"
" The program is not exhaustive, and only encapsulates detailed knowledge of a\r\n" " The program is not exhaustive, and only encapsulates detailed knowledge of a\r\n"
" limited number of table types.\r\n" " limited number of table types.\r\n"
" \r\n" " \r\n"
" Default behaviour is to display the content of all tables installed.\r\n" " Default behaviour is to display the content of all tables installed.\r\n"
" 'Known' table types (listed in NOTES below) will be parsed and displayed\r\n" " 'Known' table types (listed in NOTES below) will be parsed and displayed\r\n"
" with descriptions and field values. Where appropriate a degree of consistency\r\n" " with descriptions and field values. Where appropriate a degree of\r\n"
" checking is done and errors may be reported in the output.\r\n" " consistency checking is done and errors may be reported in the output.\r\n"
" Other table types will be displayed as an array of Hexadecimal bytes.\r\n" " Other table types will be displayed as an array of Hexadecimal bytes.\r\n"
" \r\n" " \r\n"
" To facilitate debugging, the -s and -d options can be used to generate a\r\n" " To facilitate debugging, the -s and -d options can be used to generate a\r\n"
" binary file image of a table that can be copied elsewhere for investigation\r\n" " binary file image of a table that can be copied elsewhere for investigation\r\n"
" using tools such as those provided by acpica.org. This is especially relevant\r\n" " using tools such as those provided by acpica.org. This is especially\r\n"
" for AML type tables like DSDT and SSDT.\r\n" " relevant for AML type tables like DSDT and SSDT.\r\n"
" \r\n" " \r\n"
"NOTES:\r\n" "NOTES:\r\n"
" 1. The AcpiTable parameter can match any installed table type.\r\n" " 1. The AcpiTable parameter can match any installed table type.\r\n"
@ -71,7 +72,8 @@
" 2. -s option supports to display the specified AcpiTable type that is present\r\n" " 2. -s option supports to display the specified AcpiTable type that is present\r\n"
" in the system. For normal type AcpiTable, it would display the data of the\r\n" " in the system. For normal type AcpiTable, it would display the data of the\r\n"
" AcpiTable and AcpiTable header. The following type may contain header type\r\n" " AcpiTable and AcpiTable header. The following type may contain header type\r\n"
" other than AcpiTable header. The actual header can refer to the ACPI spec 6.2\r\n" " other than AcpiTable header. The actual header can refer to the ACPI spec\r\n"
" 6.2\r\n"
" Extra A. Particular types:\r\n" " Extra A. Particular types:\r\n"
" APIC - Multiple APIC Description Table (MADT)\r\n" " APIC - Multiple APIC Description Table (MADT)\r\n"
" BGRT - Boot Graphics Resource Table\r\n" " BGRT - Boot Graphics Resource Table\r\n"
@ -95,9 +97,9 @@
" Interface Specification' Version 6.2 Errata A, [September 2017]\r\n" " Interface Specification' Version 6.2 Errata A, [September 2017]\r\n"
" (http://www.uefi.org/sites/default/files/resources/ACPI%206_2_A_Sept29.pdf)\r\n" " (http://www.uefi.org/sites/default/files/resources/ACPI%206_2_A_Sept29.pdf)\r\n"
" \r\n" " \r\n"
" NOTE: The nature of the ACPI standard means that almost all tables in 6.1 will\r\n" " NOTE: The nature of the ACPI standard means that almost all tables in 6.1\r\n"
" be 'backwards compatible' with prior version of the specification in\r\n" " will be 'backwards compatible' with prior version of the specification\r\n"
" terms of structure, so formatted output should be correct. The main\r\n" " in terms of structure, so formatted output should be correct. The main\r\n"
" exception will be that previously 'reserved' fields will be reported\r\n" " exception will be that previously 'reserved' fields will be reported\r\n"
" with new names, where they have been added in later versions of the\r\n" " with new names, where they have been added in later versions of the\r\n"
" specification.\r\n" " specification.\r\n"