1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
|
From 15c005679a25f6838f5c880eee42e7dacab31476 Mon Sep 17 00:00:00 2001
From: "A. Maitland Bottoms" <bottoms@debian.org>
Date: Mon, 31 Aug 2020 18:50:56 -0400
Subject: [PATCH 04/11] doxygen pdf
Generate PDF documentation as part of build.
---
host/docs/CMakeLists.txt | 4 +++-
host/docs/Doxyfile.in | 4 ++--
2 files changed, 5 insertions(+), 3 deletions(-)
--- a/host/docs/CMakeLists.txt
+++ b/host/docs/CMakeLists.txt
@@ -103,8 +103,32 @@
#make the doxygen generation a built-time dependency
add_custom_target(doxygen_docs ALL DEPENDS ${CMAKE_CURRENT_BINARY_DIR_DOXYGEN})
- UHD_INSTALL(DIRECTORY ${CMAKE_CURRENT_BINARY_DIR_DOXYGEN} DESTINATION ${PKG_DOC_DIR} COMPONENT ${DOXYGEN_DEP_COMPONENT})
-endif(ENABLE_MANUAL_OR_DOXYGEN)
+ UHD_INSTALL(DIRECTORY ${CMAKE_CURRENT_BINARY_DIR_DOXYGEN}/html DESTINATION ${PKG_DOC_DIR} COMPONENT ${DOXYGEN_DEP_COMPONENT})
+
+ if(ENABLE_LATEX_DOCS)
+ find_package(LATEX COMPONENTS PDFLATEX)
+ add_custom_command(
+ COMMENT "Generate PDF"
+ WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/doxygen/latex
+ DEPENDS doxygen_docs
+ COMMAND ${PDFLATEX_COMPILER} refman.tex
+ # || ${PDFLATEX_COMPILER} refman.tex || ${PDFLATEX_COMPILER} refman.tex || true
+ # ${DVIPDF_CONVERTER} ${CMAKE_CURRENT_BINARY_DIR}/latex/refman.dvi COMMAND
+ # /usr/bin/dvipdf refman.dvi
+ # COMMAND cp -p refman.pdf USRP_Hardware_Driver_and_USRP_Manual-4.9.0.0.pdf
+ OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/doxygen/latex/refman.pdf)
+ add_custom_target(doxygen_pdf ALL
+ DEPENDS doxygen_docs ${CMAKE_CURRENT_BINARY_DIR}/doxygen/latex/refman.pdf)
+ set_target_properties(doxygen_pdf PROPERTIES ADDITIONAL_CLEAN_FILES
+ "${CMAKE_CURRENT_BINARY_DIR}/doxygen/latex")
+
+ UHD_INSTALL(FILES ${CMAKE_CURRENT_BINARY_DIR_DOXYGEN}/latex/refman.pdf DESTINATION ${PKG_DOC_DIR} COMPONENT ${DOXYGEN_DEP_COMPONENT})
+ #install(
+ # FILES
+ # ${CMAKE_CURRENT_BINARY_DIR}/doxygen/latex/refman.pdf
+ # DESTINATION ${CMAKE_INSTALL_DOCDIR})
+ endif()
+endif()
########################################################################
# List of man page sources
--- a/host/docs/Doxyfile.in
+++ b/host/docs/Doxyfile.in
@@ -772,7 +772,7 @@
# messages are off.
# The default value is: NO.
-QUIET = YES
+QUIET = NO
# The WARNINGS tag can be used to turn on/off the warning messages that are
# generated to standard error (stderr) by doxygen. If WARNINGS is set to YES
@@ -1720,7 +1720,7 @@
# If the GENERATE_LATEX tag is set to YES, doxygen will generate LaTeX output.
# The default value is: YES.
-GENERATE_LATEX = NO
+GENERATE_LATEX = YES
# The LATEX_OUTPUT tag is used to specify where the LaTeX docs will be put. If a
# relative path is entered the value of OUTPUT_DIRECTORY will be put in front of
@@ -1782,7 +1782,7 @@
# The default value is: a4.
# This tag requires that the tag GENERATE_LATEX is set to YES.
-PAPER_TYPE = a4
+PAPER_TYPE = letter
# The EXTRA_PACKAGES tag can be used to specify one or more LaTeX package names
# that should be included in the LaTeX output. The package can be specified just
@@ -1794,7 +1794,7 @@
# If left blank no extra packages will be included.
# This tag requires that the tag GENERATE_LATEX is set to YES.
-EXTRA_PACKAGES =
+EXTRA_PACKAGES = {amsmath} {pmboxdraw}
# The LATEX_HEADER tag can be used to specify a personal LaTeX header for the
# generated LaTeX document. The header should contain everything until the first
|
