[tor-commits] [tor/master] Doxygen: stop producing LaTeX.

[nickm at torproject.org]

commit 593acfabb3a074602aee4f93ef07c7aa22379f7e
Author: Nick Mathewson <nickm at torproject.org>
Date:   Wed Oct 16 09:56:31 2019 -0400

    Doxygen: stop producing LaTeX.
    
    Running doxygen with latex gave us all manner of unicode issues,
    slowed down the "make doxygen" target by a lot, and added several
    latex dependencies... all to produce a 4000-page reference manual
    which is probably not what anybody wanted.
    
    Closes ticket 32099.
---
 Doxyfile.in         | 2 +-
 Makefile.am         | 5 +++--
 changes/ticket32099 | 4 ++++
 3 files changed, 8 insertions(+), 3 deletions(-)

diff --git a/Doxyfile.in b/Doxyfile.in
index d242b2e15..8e39e0f16 100644
--- a/Doxyfile.in
+++ b/Doxyfile.in
@@ -1645,7 +1645,7 @@ EXTRA_SEARCH_MAPPINGS  =
 # If the GENERATE_LATEX tag is set to YES, doxygen will generate LaTeX output.
 # The default value is: YES.
 
-GENERATE_LATEX         = YES
+GENERATE_LATEX         = NO
 
 # 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
diff --git a/Makefile.am b/Makefile.am
index 485324fc7..f0d960efe 100644
--- a/Makefile.am
+++ b/Makefile.am
@@ -236,8 +236,9 @@ dist-rpm: dist-gzip
 	echo "RPM build finished";						\
 	#end of dist-rpm
 
-doxygen:
-	doxygen && cd doc/doxygen/latex && make
+.PHONY: doxygen
+doxygen: Doxyfile
+	doxygen
 
 test: all
 	$(top_builddir)/src/test/test
diff --git a/changes/ticket32099 b/changes/ticket32099
new file mode 100644
index 000000000..7a111df6b
--- /dev/null
+++ b/changes/ticket32099
@@ -0,0 +1,4 @@
+  o Removed features:
+    - Our Doxygen configuration no longer generates LaTeX output.  The
+      reference manual produced by doing this was over 4000 pages long,
+      and generally unusable.  Closes ticket 32099.