From: Azat Khuzhin <azat@libevent.org>
Date: Wed, 16 Sep 2020 05:10:11 +0000 (+0300)
Subject: Generate only real man pages with doxygen (MAN_LINKS=NO)
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=9b270c5e02e47d372ad53e773f98668890b33e9f;p=libevent

Generate only real man pages with doxygen (MAN_LINKS=NO)

WIth MAN_LINKS=YES doxygen will generate ton's of man pages for each
field, function and so on, but it will not contain anything useful
except for link to another man page (header).

So to avoid man pages clashing, disable MAN_LINKS, and this will
generate man pages only for explicitly documented parts.

But even after this we have pretty non-unique man pages names:

    $ find install/ -name '*.3'
    install/share/man/man3/util.h.3
    ...

Looks like we should add prefix for each of them...
But let's see if there will be a problem.

Fixes: #1097
---

diff --git a/Doxyfile b/Doxyfile
index aef64c55..486ab669 100644
--- a/Doxyfile
+++ b/Doxyfile
@@ -189,7 +189,7 @@ MAN_EXTENSION          = .3
 # only source the real man page, but without them the man command 
 # would be unable to find the correct page. The default is NO.
 
-MAN_LINKS              = YES
+MAN_LINKS              = NO
 
 #---------------------------------------------------------------------------
 # Configuration options related to the preprocessor