-
Notifications
You must be signed in to change notification settings - Fork 1.3k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Generating doxygen's documentation in CHM format
Until now the chm format of the doxygen documentation was generated by a separate script, this is now integrated in the CMake procedure. - option -Dbuild_doc_chm to enable the possibility to generate the CHM documentation (only works for windows) - procedure is as follows - generate the base documentation for the CHM output - copy the documentation of the examples to the tree with the base CHM output (cannot use it from its default place due to the fact that in the next face the first page of the CHM file will be wrong - add the html, png, css and gif files of the examples to the so called hhp file (has to happen during runtime, hence a small python script, created inline so there is no extra file in the source tree) - create the resulting doxygen_manual.chm Some improvements during the process - the html files of the examples are added so that the full documentation of the examples is accessible and not just the top pages of the examples - keep the index terms of base chm file (mostly the commands and configuration parameters) - see to it that the doxygen logo is copied by doxygen and not by means of cmake
- Loading branch information
1 parent
09c263e
commit 46ecf6b
Showing
4 changed files
with
81 additions
and
14 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,20 @@ | ||
# | ||
# Copyright (C) 1997-2019 by Dimitri van Heesch. | ||
# | ||
# Permission to use, copy, modify, and distribute this software and its | ||
# documentation under the terms of the GNU General Public License is hereby | ||
# granted. No representations are made about the suitability of this software | ||
# for any purpose. It is provided "as is" without express or implied warranty. | ||
# See the GNU General Public License for more details. | ||
# | ||
# Documents produced by Doxygen are derivative works derived from the | ||
# input used in their production; they are not affected by this license. | ||
|
||
@INCLUDE = Doxyfile | ||
GENERATE_LATEX = NO | ||
HTML_OUTPUT = chm | ||
GENERATE_HTMLHELP = YES | ||
GENERATE_TREEVIEW = NO | ||
HHC_LOCATION = "$(HTML_HELP_COMPILER)" | ||
CHM_FILE = index.chm | ||
BINARY_TOC = YES |