Add Sphinx LaTeX output

Author: derobins

cmake/AISDocumentation.cmake

@@ -69,7 +69,7 @@ if(AIS_BUILD_DOCS)
     add_custom_target(doc
         # Step 1: Run Doxygen to produce XML for Breathe
         COMMAND "${DOXYGEN_EXECUTABLE}" "${AIS_DOXYFILE}"
-        # Step 2: Run Sphinx, injecting the Doxygen paths via environment
+        # Step 2: Run Sphinx (html), injecting the Doxygen paths via environment
         COMMAND
             ${CMAKE_COMMAND} -E env
                 "DOXYFILE_PATH=${AIS_DOXYFILE}"
@@ -81,6 +81,18 @@ if(AIS_BUILD_DOCS)
                 "${HIPFILE_ROOT_PATH}/docs"
                 "${AIS_SPHINX_BUILD_DIR}"
                 -v
+        # Step 3: Run Sphinx (LaTeX), injecting the Doxygen paths via environment
+        COMMAND
+            ${CMAKE_COMMAND} -E env
+                "DOXYFILE_PATH=${AIS_DOXYFILE}"
+                "DOXYGEN_ROOT=${AIS_DOC_PATH}/doxygen"
+                "DOXYGEN_XML_DIR=${AIS_DOXYGEN_XML_DIR}"
+            "${Python3_EXECUTABLE}" -m sphinx
+                -b latex
+                -c "${AIS_DOC_PATH}/sphinx"
+                "${HIPFILE_ROOT_PATH}/docs"
+                "${AIS_SPHINX_BUILD_DIR}"
+                -v
         WORKING_DIRECTORY "${AIS_DOC_PATH}"
         COMMENT "Generating hipFile API documentation with Doxygen + Sphinx (rocm_docs)"
         VERBATIM

docs/README.md

@@ -57,9 +57,13 @@ directory:
         └── html
 ```
 
-To generate a pdf, navigate to doxygen/latex and run `make pdf` to
+To generate a pdf for the API docs, navigate to `doxygen/latex` and run `make pdf` to
 generate a pdf named `refman.pdf`.
 
+To generate a pdf for the Sphinx docs, navigate to `sphinx/html` and run `make` in
+the directory. This will generate a pdf named `rocshmem.pdf` (we are stealing their
+configs until `rocm-docs-core` is updated).
+
 ## Adding to the Documentation
 
 ### API Documentation (Doxygen)