source: trunk/testsuite/cui/doxygen.mak@ 8710

Last change on this file since 8710 was 8710, checked in by bird, 23 years ago

Initial coding.

File size: 8.1 KB
Line 
1# $Id: doxygen.mak,v 1.1 2002-06-19 01:59:27 bird Exp $
2
3#
4# This script contains the testcases for Doxygen version 1.2.16
5#
6# Note! We doesn't include any MAKE_INCLUDE_PROCESS file.
7#
8
9# Include the setup.mak and testsuite.tools.mk.
10PATH_ROOT = ..\..
11!include $(PATH_ROOT)\$(BUILD_SETUP_MAK)
12!include $(PATH_MAKE)\testsuite.tools.mk
13
14# Testsuite config for the process include.
15TARGET_MODE = TESTCASE
16TARGET_NAME = doxygen
17MAKEFILE = $(TARGET_NAME).mak
18
19# Include the process rulez.
20!include $(MAKE_INCLUDE_PROCESS)
21
22
23
24#
25# These are the files which should be installed in order to run doxygen.
26#
27DOXYGEN = $(PATH_ROOT)\testsuite\bin\doxygen.exe
28BIN_FILES =\
29 $(DOXYGEN)
30
31
32#
33# Main rule, this runs all the other rulez.
34#
35testcase: testcase-banner \
36 $(BIN_FILES) \
37 testcase-help \
38 testcase-kFileFormatBase
39 @$(ECHO) + Completed DoxyGen v1.2.16! $(CLRRST)
40
41testcase-banner:
42 @$(ECHO) + Running testcases for DoxyGen v1.2.16! $(CLRRST)
43
44
45
46#
47# This testcase checks the --help output.
48# BUGBUG: why doesn't DOXYGEN.EXE output an absolute path?
49#
50testcase-help: testcase-help-banner $(PATH_TARGET)\doxygen.help.stdout
51 -1 $(TS_PEC) $(DOXYGEN) --help > $(PATH_TARGET)\stdout 2> $(PATH_TARGET)\stderr
52 $(TS_TEST_FILE_Z) $(PATH_TARGET)\stderr
53 $(TS_TEST_FILE_NZ) $(PATH_TARGET)\stdout
54 $(TS_SED) "s/ [.][.].*\\doxygen.exe/ DOXYGEN.EXE/I" $(PATH_TARGET)\stdout | $(TS_CMP) - $(PATH_TARGET)\doxygen.help.stdout
55 @$(ECHO) ++ help done!$(CLRRST)
56
57testcase-help-banner:
58 @$(ECHO) ++ help$(CLRRST)
59
60# This is the output of testcase-help
61$(PATH_TARGET)\doxygen.help.stdout: $(MAKEFILE)
62 @$(TOOL_ECHO) Creating$(CLRRST) <<$@
63Doxygen version 1.2.16
64Copyright Dimitri van Heesch 1997-2002
65
66You can use doxygen in a number of ways:
67
681) Use doxygen to generate a template configuration file:
69 DOXYGEN.EXE [-s] -g [configName]
70
71 If - is used for configName doxygen will write to standard output.
72
732) Use doxygen to update an old configuration file:
74 DOXYGEN.EXE [-s] -u [configName]
75
763) Use doxygen to generate documentation using an existing configuration file:
77 DOXYGEN.EXE [configName]
78
79 If - is used for configName doxygen will read from standard input.
80
814) Use doxygen to generate a template style sheet file for RTF, HTML or Latex.
82 RTF: DOXYGEN.EXE -w rtf styleSheetFile
83 HTML: DOXYGEN.EXE -w html headerFile footerFile styleSheetFile [configFile]
84 LaTeX: DOXYGEN.EXE -w latex headerFile styleSheetFile [configFile]
85
865) Use doxygen to generate an rtf extensions file
87 RTF: DOXYGEN.EXE -e rtf extensionsFile
88
89If -s is specified the comments in the config file will be omitted.
90If configName is omitted `Doxyfile' will be used as a default.
91
92<<KEEP
93
94
95
96#
97# Testcase where we try to run doxygen on tools/common/kFileFormatBase.[cpp|h].
98#
99testcase-kFileFormatBase: testcase-kFileFormatBase-banner \
100 $(PATH_TARGET)\kFileFormatBase.conf \
101 $(PATH_TARGET)\kFileFormatBase.stdout \
102 $(PATH_TARGET)\kFileFormatBase.html.dir \
103 $(PATH_TARGET)\kFileFormatBase.latex.dir
104 $(TS_PEC) $(DOXYGEN) $(PATH_TARGET)\kFileFormatBase.conf 2> $(PATH_TARGET)\stderr2 | $(TS_TEE) $(PATH_TARGET)\stdout2
105 $(TS_SED) "s/Read .* bytes/Read x bytes/" $(PATH_TARGET)\stdout2 \
106 | $(TS_SED) "s/Preprocessing .*[\/\\]kFile/Preprocessing kFile/" \
107 | $(TS_SED) "s/Parsing file .*[\/\\]kFile/Parsing file kFile/" \
108 | $(TS_CMP) - $(PATH_TARGET)\kFileFormatBase.stdout
109 $(TS_TEST_FILE_Z) $(PATH_TARGET)\kFileFormatBase.stderr2
110 $(TS_DIR_B) $(PATH_TARGET)\html | $(TS_SED) "s/.*\\//g" | $(TS_CMP) - $(PATH_TARGET)\kFileFormatBase.html.dir
111 $(TS_DIR_B) $(PATH_TARGET)\latex | $(TS_SED) "s/.*\\//g" | $(TS_CMP) - $(PATH_TARGET)\kFileFormatBase.latex.dir
112 $(TS_TEST_FILE_NZ) $(PATH_TARGET)\rtf\refman.rtf
113 $(TS_TEST_DIR) $(PATH_TARGET)\man\man3
114 $(TS_TEST_FILE_NZ) $(PATH_TARGET)\man\man3\kFileFormatBase.3
115 @$(ECHO) * kFileFormatBase done!$(CLRRST)
116
117testcase-kFileFormatBase-banner:
118 @$(ECHO) * kFileFormatBase$(CLRRST)
119
120
121$(PATH_TARGET)\kFileFormatBase.conf: $(MAKEFILE)
122 @$(TOOL_ECHO) Creating$(CLRRST) <<$@
123# Doxyfile 1.2.16
124PROJECT_NAME = Odin32Testsuite-kFileFormatBase
125INPUT = $(PATH_ROOT)\tools\common\kFileFormatBase.h $(PATH_ROOT)\tools\common\kFileFormatBase.cpp
126GENERATE_HTML = YES
127HTML_OUTPUT = $(PATH_TARGET)\html
128GENERATE_HTMLHELP = YES
129GENERATE_CHI = YES
130GENERATE_TREEVIEW = YES
131# INCLUDE_PATH = $(PATH_ROOT)\tools\common - doesn't work.
132GENERATE_LATEX = YES
133LATEX_OUTPUT = $(PATH_TARGET)\latex
134GENERATE_XML = NO
135# XML_OUTPUT = $(PATH_TARGET)\xml - doesn't work
136GENERATE_MAN = YES
137MAN_OUTPUT = $(PATH_TARGET)\man
138GENERATE_RTF = YES
139RTF_OUTPUT = $(PATH_TARGET)\rtf
140SEARCHENGINE = NO
141<<KEEP
142
143# stdout
144$(PATH_TARGET)\kFileFormatBase.stdout: $(MAKEFILE)
145 @$(TOOL_ECHO) Creating$(CLRRST) <<$@
146Searching for include files...
147Searching for example files...
148Searching for images...
149Searching for dot files...
150Searching for files to exclude
151Reading input files...
152Reading tag files
153Preprocessing kFileFormatBase.h...
154Preprocessing kFileFormatBase.cpp...
155Read x bytes
156Parsing input...
157Parsing file kFileFormatBase.h...
158Parsing file kFileFormatBase.cpp...
159Freeing input...
160Building group list...
161Building namespace list...
162Building file list...
163Building class list...
164Building example list...
165Searching for documented variables...
166Building member list...
167Searching for friends...
168Searching for documented defines...
169Computing template instances...
170Creating members for template instances...
171Computing class relations...
172Searching for enumerations...
173Searching for member function documentation...
174Building page list...
175Search for main page...
176Sorting lists...
177Freeing entry tree
178Determining which enums are documented
179Computing member relations...
180Building full member lists recursively...
181Adding members to member groups.
182Computing member references...
183Inheriting documentation...
184Adding source references...
185Adding todo/test/bug list items...
186Counting data structures...
187Generating disk names...
188Resolving user defined references...
189Generating index page...
190Generating file index...
191Generating example documentation...
192Generating file sources...
193Generating code for file kFileFormatBase.h...
194Generating file documentation...
195Generating class documentation...
196Generating annotated compound index...
197Generating hierarchical class index...
198Generating member index...
199Generating docs for compound kFileFormatBase...
200Generating page documentation...
201Generating group documentation...
202Generating namespace index...
203Generating group index...
204Generating example index...
205Generating file member index...
206Generating namespace member index...
207Generating page index...
208Generating graph info page...
209Generating search index...
210Generating style sheet...
211Combining RTF output...
212<<KEEP
213
214# html files created
215$(PATH_TARGET)\kFileFormatBase.html.dir: $(MAKEFILE)
216 @$(TOOL_ECHO) Creating$(CLRRST) <<$@
217annotated.html
218classkFileFormatBase-members.html
219classkFileFormatBase.html
220doxygen.css
221doxygen.png
222files.html
223ftv2blank.png
224ftv2doc.png
225ftv2folderclosed.png
226ftv2folderopen.png
227ftv2lastnode.png
228ftv2link.png
229ftv2mlastnode.png
230ftv2mnode.png
231ftv2node.png
232ftv2plastnode.png
233ftv2pnode.png
234ftv2vertline.png
235functions.html
236index.hhc
237index.hhk
238index.hhp
239index.html
240kFileFormatBase_8h-source.html
241main.html
242tree.html
243tree.js
244treeview.js
245<<KEEP
246
247# latex files created
248$(PATH_TARGET)\kFileFormatBase.latex.dir: $(MAKEFILE)
249 @$(TOOL_ECHO) Creating$(CLRRST) <<$@
250annotated.tex
251classkFileFormatBase.tex
252doxygen.sty
253Makefile
254refman.tex
255<<KEEP
256
257
258
259#
260# Clean rule
261#
262clean:
263 $(TOOL_RM) *.log $(PATH_TARGET)\html\* $(PATH_TARGET)\latex\* $(PATH_TARGET)\man\man3\*
264 $(TOOL_RM) $(PATH_TARGET)\rtf\* $(PATH_TARGET)\xml\*
265 -$(TOOL_RMDIR) $(PATH_TARGET)\html 2> nul
266 -$(TOOL_RMDIR) $(PATH_TARGET)\latex 2> nul
267 -$(TOOL_RMDIR) $(PATH_TARGET)\man\man3 2> nul
268 -$(TOOL_RMDIR) $(PATH_TARGET)\man 2> nul
269 -$(TOOL_RMDIR) $(PATH_TARGET)\rtf 2> nul
270 -$(TOOL_RMDIR) $(PATH_TARGET)\xml 2> nul
271 -$(TOOL_RM) $(PATH_TARGET)\*
272
Note: See TracBrowser for help on using the repository browser.