Fixed Doxygen required version to 1.8.7

Doxygen 1.8.6 and lower do not have the \\htmlonly[block] directive
which fixes a multitude of problems in the rendering of the docs. In
Doxygen 1.8.7 the list of understood HTML entities was greatly
increased. I tested earlier versions and many little issues returned.
This commit is contained in:
Mark Griffiths 2014-09-04 12:07:07 +01:00
parent fb792c60cd
commit 1b4c85eb69
2 changed files with 7 additions and 2 deletions

View file

@ -146,7 +146,7 @@ AS_IF([test x$local_gettext != xno],
# Build/clean the documentation only if Doxygen is available
#
doxygen_minimum=1.8
doxygen_minimum=1.8.7
AC_ARG_WITH(
doxygen,

View file

@ -1,6 +1,6 @@
# Formatting guide for fish docs
The fish documentation has been updated to support Doxygen 1.8+, and while the main benefit of this change is extensive Markdown support, the addition of a fish lexicon and syntax filter, combined with semantic markup rules allows for automatic formatting enhancements across the HTML user_docs, the developer docs and the man pages.
The fish documentation has been updated to support Doxygen 1.8.7+, and while the main benefit of this change is extensive Markdown support, the addition of a fish lexicon and syntax filter, combined with semantic markup rules allows for automatic formatting enhancements across the HTML user_docs, the developer docs and the man pages.
Initially my motivation was to fix a problem with long options ([Issue #1557](https://github.com/fish-shell/fish-shell/issues/1557) on GitHub), but as I worked on fixing the issue I realised there was an opportunity to simplify, reinforce and clarify the current documentation, hopefully making further contribution easier and cleaner, while allowing the documentation examples to presented more clearly with less author effort.
@ -199,8 +199,13 @@ Some useful Unicode/HTML5 entities:
### Doxygen
- Tested on Ubuntu 14.04 with Doxygen 1.8.8, built from source.
- Tested on Mac OS X 10.9 with Homebrew install Doxygen 1.8.7 and 1.8.8.
Doxygen 1.8.6 and lower do not have the \\htmlonly[block] directive which fixes a multitude of problems in the rendering of the docs. In Doxygen 1.8.7 the list of understood HTML entities was greatly increased. I tested earlier versions and many little issues returned.
As fish ships with pre-built documentation, I don't see this as an issue.
### Updated Configure/Makefile
- Tested on Ubuntu 14.04, CentOS 6.5 and Mac OS X 10.9.