Update the configuration files for Doxygen 1.7.3

[Peter Kovacs]

[c48431d887e3] contains the updated files.

[Peter Kovacs]

Note that Doxygen 1.7.3 creates a top header for the doc pages on which the project name, project version and an optional project brief text is displayed. I set this brief text to "An open source C++ graph library", but it can be modified.

[Alpar Juttner]

Won't these changes prohibit using earlier versions of Doxygen?

[Peter Kovacs]

I don't think so, because only new key-value pairs are added and nothing is removed. Previous updates did not cause such problems.

[Peter Kovacs]

... but I'm not completely sure.

[Alpar Juttner]

Replying to kpeter:

Note that Doxygen 1.7.3 creates a top header for the doc pages on which the project name, project version and an optional project brief text is displayed. I set this brief text to "An open source C++ graph library", but it can be modified.

Doxygen 1.7.3 introduces the header containing the project name and version on the top of each page. This is

• Ugly (a combination of a HUGE and a Big font size, in front of a background inconsistent with the other parts of the page.
• Uncomfortable (is reduces the useful part of the screen)
• Completely unnecessary.

This brief text (and perhaps the logo, which could also be added) adds one more line to the div, though it is at least more reasonably sized.

So, I would go into the other direction and remove this header completely if possible.

[Alpar Juttner]

You also removed this:

#--------------------------------------------------------------------------- 
# Configuration::additions related to the search engine    
#--------------------------------------------------------------------------- 
SEARCHENGINE           = NO

Instead, I have just tried to use

SEARCHENGINE           = YES

and this works perfectly, even when you open the generated files locally in your browser. (It puts a search box into the top right corner). I think it is a really useful feature so I suggest turning it on.

[Alpar Juttner]

Btw. the doc generation has been customizable since [481496e6d71f]. Currently only one doxygen option (SOURCE_BROWSER) is exported to cmake, but we may consider adding more.

[Peter Kovacs]

I'm not against removing this new header, but note that it is the only place where the project version number is displayed. (Previous versions of Doxygen put it to the main page.)

Anyway, I did not find an option to remove this header, which is quite annoying. However, we could hide it by modifying the CSS stlye sheets.

[Peter Kovacs]

Replying to alpar:

You also removed this:
SEARCHENGINE = NO

It was not removed, just moved to another group (according to the latest template file).

Instead, I have just tried to use
SEARCHENGINE = YES
and this works perfectly, even when you open the generated files locally in your browser. (It puts a search box into the top right corner). I think it is a really useful feature so I suggest turning it on.

I agree.

[Peter Kovacs]

I attached another patch [f53a7730501e], which does not contain project brief text and enables the search system.

[Alpar Juttner]

I rebased your patch as [021e232acda2] and put [d3b041452dd8] on top of is. This latter patch hides the standard Doxygen header completely, but adds the version string to the title of the main doc page.

These two changesets are merged into branches 1.1, 1.2 and main.

[Peter Kovacs]

I like this solution. Thanks.