From nobody@FreeBSD.org  Sat Jun 16 15:04:20 2012
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 02E2A106566C
	for <freebsd-gnats-submit@FreeBSD.org>; Sat, 16 Jun 2012 15:04:20 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from red.freebsd.org (red.freebsd.org [IPv6:2001:4f8:fff6::22])
	by mx1.freebsd.org (Postfix) with ESMTP id E21278FC21
	for <freebsd-gnats-submit@FreeBSD.org>; Sat, 16 Jun 2012 15:04:19 +0000 (UTC)
Received: from red.freebsd.org (localhost [127.0.0.1])
	by red.freebsd.org (8.14.4/8.14.4) with ESMTP id q5GF4Jgc093693
	for <freebsd-gnats-submit@FreeBSD.org>; Sat, 16 Jun 2012 15:04:19 GMT
	(envelope-from nobody@red.freebsd.org)
Received: (from nobody@localhost)
	by red.freebsd.org (8.14.4/8.14.4/Submit) id q5GF4JgX093692;
	Sat, 16 Jun 2012 15:04:19 GMT
	(envelope-from nobody)
Message-Id: <201206161504.q5GF4JgX093692@red.freebsd.org>
Date: Sat, 16 Jun 2012 15:04:19 GMT
From: Chris Whitehouse <cwhiteh@onetel.com>
To: freebsd-gnats-submit@FreeBSD.org
Subject: [patch] iasl(8) man page is out of date
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>Number:         169158
>Category:       docs
>Synopsis:       [patch] iasl(8) man page is out of date
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:
>Keywords:
>Date-Required:
>Class:          update
>Submitter-Id:   current-users
>Arrival-Date:   Sat Jun 16 15:10:06 UTC 2012
>Closed-Date:
>Last-Modified:
>Originator:     Chris Whitehouse
>Release:        9.0-RELEASE
>Organization:
n/a
>Environment:
FreeBSD muji64 9.0-RELEASE FreeBSD 9.0-RELEASE #0: Tue Jan  3 07:46:30 UTC 2012     root@farrell.cse.buffalo.edu:/usr/obj/usr/src/sys/GENERIC  amd64
>Description:
Man page for iasl(8) is missing options that are present in /usr/sbin/iasl

/usr/sbin/iasl is:

$FreeBSD: release/9.0.0/usr.sbin/acpi/iasl/iasl.8 179153 2008-05-20 12:07:02Z rpaulo $
>How-To-Repeat:
Run command
# iasl -h

Compare output to
# man 8 iasl.
>Fix:
Attached patch.

Note I've corrected the options and updated the version of the compiler to 4.0a.

Some things to check because I don't know enough:

-T: Is Sig the correct term?
-da: Is the format in the Synopsis right (table,table,...) , is the format in the options list right (f1,f2)
-e: same as -da

Apart from updating the version of the compiler I haven't changed the description, it might not be correct any more.



Patch attached with submission follows:

--- /usr/src/usr.sbin/acpi/iasl/iasl.8	2012-06-16 12:33:21.000000000 +0100
+++ iasl.8	2012-06-16 15:22:53.000000000 +0100
@@ -35,12 +35,19 @@
 .Nd Intel ACPI compiler/decompiler
 .Sh SYNOPSIS
 .Nm
-.Op Fl 2cefghl
+.Op Fl 2fghlnz
+.Op Fl @ Ar file
+.Op Fl I Ar dir
+.Op Fl T Ar Sig
 .Op Fl b Ar type
+.Op Fl cr
 .Op Fl d Ar file
+.Op Fl da Ar table,table,...
 .Op Fl dc Ar file
+.Op Fl e Ar table,table,...
 .Op Fl hc
 .Op Fl hr
+.Op Fl ht
 .Op Fl i Ar type
 .Op Fl ln
 .Op Fl ls
@@ -50,14 +57,17 @@
 .Op Fl on
 .Op Fl ot
 .Op Fl p Ar prefix
+.Op Fl r Ar Revision
 .Op Fl s Ar type
 .Op Fl t Ar type
+.Op Fl va
 .Op Fl vi
 .Op Fl vo
 .Op Fl vr
 .Op Fl vs
-.Op Fl x Ar level
+.Op Fl vt
 .Op Fl w Ar level
+.Op Fl x Ar level
 .Ar input-file
 .Sh DESCRIPTION
 The
@@ -69,8 +79,7 @@
 include:
 .Bl -bullet -offset indent
 .It
-Full support for the ACPI 3.0b Specification including ASL grammar
-elements and operators.
+Supports ACPI Specification Revision 4.0a
 .It
 Extensive compiler syntax and semantic error checking, especially in
 the area of control methods.
@@ -85,22 +94,28 @@
 .Bl -tag -width indent
 .It Fl 2
 Emit ACPI 2.0 compatible ASL code.
+.It Fl @ Ar file
+Specify command file.
+.It Fl I Ar dir
+Specify additional include directory.
+.It Fl T Sm Cm Sig | All | * Sm
+Create table template file(s) for Sig.
 .It Fl b Sm Cm p | t | b Sm
 Create compiler debug/trace file
 .Pq Pa *.txt .
 Types: Parse/Tree/Both.
-.It Fl c
-Parse only, no output generation.
+.It Fl cr
+Disable Resource Descriptor error checking.
 .It Fl d Ar file
-Disassemble AML to ASL source code file
+Disassemble or decode binary ACPI table to file
 .Pq Pa *.dsl .
+.It Fl da Sm Cm f1 , f2 Sm
+Disassemble multiple tables from single namespace.
 .It Fl dc Ar file
 Disassemble AML and immediately compile it.
 (Obtain DSDT from current system if no input file.)
-.It Fl e
-Generate
-.Fn External
-statements for unresolved symbols.
+.It Fl e Sm Cm f1 , f2 Sm
+Include ACPI table(s) for external symbol resolution.
 .It Fl f
 Ignore errors, force creation of AML output file(s).
 .It Fl g
@@ -112,6 +127,8 @@
 Display operators allowed in constant expressions.
 .It Fl hr
 Display ACPI reserved method names.
+.It Fl ht
+Display currently supported ACPI table names.
 .It Fl i Sm Cm a | c Sm
 Create assembler or C include file
 .Pa ( *.inc
@@ -126,6 +143,8 @@
 .It Fl ls
 Create combined source file (expanded includes)
 .Pq Pa *.src .
+.It Fl n
+Parse only, no output generation.
 .It Fl oa
 Disable all optimizations (compatibility mode).
 .It Fl of
@@ -137,16 +156,19 @@
 .It Fl ot
 Display compile times.
 .It Fl p Ar prefix
-Specify filename prefix for all output files (including
-.Pa .aml ) .
+Specify path/filename prefix for all output files.
+.It Fl r Ar Revision
+Override table header Revision (1-255).
 .It Fl s Sm Cm a | c Sm
 Create AML in assembler or C source file
 .Pa ( *.asm
 or
 .Pa *.c ) .
-.It Fl t Ar a|c
-Create AML in assembler or C hex table
+.It Fl t Sm Cm a | c | s Sm
+Create AML in assembler, C, or ASL hex table
 .Pq Pa *.hex .
+.It Fl va
+Disable all errors and warnings (summary only).
 .It Fl vi
 Less verbose errors and warnings for use with IDEs.
 .It Fl vo
@@ -155,10 +177,14 @@
 Disable remarks.
 .It Fl vs
 Disable signon.
+.It Fl vt
+Create verbose templates (full disassembly).
+.It Fl w Sm Cm 1 | 2 | 3 Sm
+Set warning reporting level.
 .It Fl x Ar level
 Set debug level for trace output.
-.It Fl w Ar level
-Set warning level.
+.It Fl z
+Do not insert new compiler ID for DataTables.
 .El
 .Sh SEE ALSO
 .Xr acpi 4 ,


>Release-Note:
>Audit-Trail:
>Unformatted:
