From d2ff7eb62a892202e86c310a11cff830b63b6ee1 Mon Sep 17 00:00:00 2001
From: Al Stone <ahs3@redhat.com>
Date: Wed, 8 Aug 2018 17:10:53 -0600
Subject: [PATCH] Add man page for acpiexamples.  Closes BZ#1611145.

Signed-off-by: Al Stone <ahs3@redhat.com>
---
 acpica-tools.spec | 23 ++++++++++++++++------
 acpiexamples.1    | 49 +++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 66 insertions(+), 6 deletions(-)
 create mode 100644 acpiexamples.1

diff --git a/acpica-tools.spec b/acpica-tools.spec
index 001e332..eedb239 100644
--- a/acpica-tools.spec
+++ b/acpica-tools.spec
@@ -1,6 +1,6 @@
 Name:           acpica-tools
 Version:        20180629
-Release:        2%{?dist}
+Release:        3%{?dist}
 Summary:        ACPICA tools for the development and debug of ACPI tables
 
 Group:          Development/Languages
@@ -18,10 +18,11 @@ Source7:        acpihelp.1
 Source8:        acpinames.1
 Source9:        acpisrc.1
 Source10:       acpixtract.1
-Source11:       badcode.asl.result
-Source12:       grammar.asl.result
-Source13:       run-misc-tests.sh
-Source14:       COPYING
+Source11:       acpiexamples.1
+Source12:       badcode.asl.result
+Source13:       grammar.asl.result
+Source14:       run-misc-tests.sh
+Source15:       COPYING
 
 Patch0:         big-endian.patch
 Patch1:         unaligned.patch
@@ -178,7 +179,11 @@ install -pD generate/unix/bin*/* %{buildroot}%{_bindir}/
 
 # Install the man pages
 mkdir -p %{buildroot}%{_mandir}/man1
-install -pDm 0644 -p -D *.1 %{buildroot}%{_mandir}/man1/
+install -pDm 0644 *.1 %{buildroot}%{_mandir}/man1/
+
+# Install the examples source code
+mkdir -p %{buildroot}%{_docdir}/acpica-tools/examples
+install -pDm 0644 source/tools/examples/* %{buildroot}%{_docdir}/acpica-tools/examples/
 
 %check
 cd tests
@@ -228,9 +233,15 @@ fi
 %doc README.Fedora COPYING
 %{_bindir}/*
 %{_mandir}/*/*
+%{_docdir}/*/*
 
 
 %changelog
+* Wed Aug 8 2018 Al Stone <ahs3@redhat.com> - 20180629-3
+- Add in man page for acpiexamples.  So that the man page makes some sense,
+  also copy the source code used for acpiexamples to the doc directory for
+  this package.  Closes BZ#1611145.
+
 * Thu Jul 12 2018 Fedora Release Engineering <releng@fedoraproject.org> - 20180629-2
 - Rebuilt for https://fedoraproject.org/wiki/Fedora_29_Mass_Rebuild
 
diff --git a/acpiexamples.1 b/acpiexamples.1
new file mode 100644
index 0000000..a48aad6
--- /dev/null
+++ b/acpiexamples.1
@@ -0,0 +1,49 @@
+.\" First parameter, NAME, should be all caps
+.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
+.\" other parameters are allowed: see man(7), man(1)
+.TH ACPIEXAMPLES 1 "August 8, 2018"
+.\" Please adjust this date whenever revising the manpage.
+.\"
+.\" Some roff macros, for reference:
+.\" .nh        disable hyphenation
+.\" .hy        enable hyphenation
+.\" .ad l      left justify
+.\" .ad b      justify to both left and right margins
+.\" .nf        disable filling
+.\" .fi        enable filling
+.\" .br        insert line break
+.\" .sp <n>    insert n+1 empty lines
+.\" for manpage-specific macros, see man(7)
+.SH NAME
+acpiexamples \- program showing what the code examples actually do
+.SH SYNOPSIS
+.B acpiexamples
+
+.SH DESCRIPTION
+This manual page briefly documents the
+.B acpiexamples
+command. This command has no options available.
+.PP
+.\" TeX users may be more comfortable with the \fB<whatever>\fP and
+.\" \fI<whatever>\fP escape sequences to invode bold face and italics, 
+.\" respectively.
+.B acpiexamples
+prints out the results of various calls using the ACPICA source code,
+showing what happens when the calls are made.  These results are from
+building and running the code provided in the
+/usr/share/doc/acpica-tools/examples directory that illustrate the
+proper sequencing of calls and how to make them.
+.PP
+Much more detailed documentation about ACPICA may be found at
+http://www.acpica.org/documentation/.
+
+.SH OPTIONS
+
+.PP
+None
+
+.SH AUTHOR
+acpiexamples was written by Robert Moore <robert.moore@intel.com>.
+.PP
+This manual page was written by Al Stone <ahs3@redhat.com> for the
+Fedora project (but may be used by others).