mirror of
https://github.com/projectacrn/acrn-hypervisor.git
synced 2025-10-02 06:47:06 +00:00
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:
committed by
David Kinder
parent
b96d23a68f
commit
0e317d56bf
@@ -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()
|
||||
|
||||
|
Reference in New Issue
Block a user