doc: clean up PDF generation for ACRN docs

PRs #5945 and #5949 introduced fixes to the doc building process to
support PDF generation of the documentation set.  This PR refines the
doc build process, cleaning up the Makefile, adding display of tool
version information, and updates the doc building documentation to
include additional dependencies needed for building the PDF and
instructions for how to build the PDF.  The latexpdf make target is
provided to just run the latex and PDF producing process that depends on
the HTML artifacts from a make html run.  A new make pdf target is
provided that combines the two steps into one.

A new know-issues pattern file is added that verifies the expected
output from the latexpdf process is returned, as it can't be completely
eliminated without losing potential error messages that need to be
resolved.

Signed-off-by: David B. Kinder <david.b.kinder@intel.com>
This commit is contained in:
David B. Kinder
2021-04-23 15:26:53 -07:00
committed by David Kinder
parent b96d23a68f
commit 0e317d56bf
6 changed files with 130 additions and 22 deletions

View File

@@ -24,7 +24,7 @@ class color:
END = '\033[0m'
# Check all requirements listed in requirements.txt and print out version installed (if any)
print ("Listing versions of doc build dependencies found on your system...\n")
print ("doc build tool versions found on your system...\n")
rf = open(os.path.join(sys.path[0], "requirements.txt"),"r")
@@ -35,7 +35,7 @@ for reqs in pkg_resources.parse_requirements(rf):
except:
print (color.RED + color.BOLD + reqs.project_name + " is missing." + color.END +
" (Hint: install all dependencies with " + color.YELLOW +
"\"pip3 install --user -r requirements.txt\"" + color.END + ")")
"\"pip3 install --user -r scripts/requirements.txt\"" + color.END + ")")
rf.close()