ShellPkg: Clarify the description of acpiview option '-s'
authorZhichao Gao <zhichao.gao@intel.com>
Thu, 21 Feb 2019 05:19:43 +0000 (13:19 +0800)
committerLiming Gao <liming.gao@intel.com>
Thu, 11 Apr 2019 06:45:33 +0000 (14:45 +0800)
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>
ShellPkg/Library/UefiShellAcpiViewCommandLib/UefiShellAcpiViewCommandLib.uni

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